xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/aspeed,ast2x00-scu.yaml (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/aspeed,ast2x00-scu.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Aspeed System Control Unit
8
9description:
10  The Aspeed System Control Unit manages the global behaviour of the SoC,
11  configuring elements such as clocks, pinmux, and reset.
12
13maintainers:
14  - Joel Stanley <joel@jms.id.au>
15  - Andrew Jeffery <andrew@aj.id.au>
16
17properties:
18  compatible:
19    items:
20      - enum:
21          - aspeed,ast2400-scu
22          - aspeed,ast2500-scu
23          - aspeed,ast2600-scu
24      - const: syscon
25      - const: simple-mfd
26
27  reg:
28    maxItems: 1
29
30  ranges: true
31
32  '#address-cells':
33    const: 1
34
35  '#size-cells':
36    const: 1
37
38  '#clock-cells':
39    const: 1
40
41  '#reset-cells':
42    const: 1
43
44patternProperties:
45  '^p2a-control@[0-9a-f]+$':
46    description: See Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt
47    type: object
48
49  '^pinctrl(@[0-9a-f]+)?$':
50    oneOf:
51      - $ref: /schemas/pinctrl/aspeed,ast2400-pinctrl.yaml
52      - $ref: /schemas/pinctrl/aspeed,ast2500-pinctrl.yaml
53      - $ref: /schemas/pinctrl/aspeed,ast2600-pinctrl.yaml
54
55  '^interrupt-controller@[0-9a-f]+$':
56    description: See Documentation/devicetree/bindings/interrupt-controller/aspeed,ast2xxx-scu-ic.txt
57    type: object
58
59  '^silicon-id@[0-9a-f]+$':
60    description: Unique hardware silicon identifiers within the SoC
61    type: object
62    additionalProperties: false
63
64    properties:
65      compatible:
66        items:
67          - enum:
68              - aspeed,ast2400-silicon-id
69              - aspeed,ast2500-silicon-id
70              - aspeed,ast2600-silicon-id
71          - const: aspeed,silicon-id
72
73      reg:
74        description:
75          The reg should be the unique silicon id register, and not backwards
76          compatible one in eg. the 2600.
77        minItems: 1
78        items:
79          - description: silicon id information registers
80          - description: unique chip id registers
81
82required:
83  - compatible
84  - reg
85  - ranges
86  - '#address-cells'
87  - '#size-cells'
88  - '#clock-cells'
89  - '#reset-cells'
90
91additionalProperties: false
92
93examples:
94  - |
95    syscon@1e6e2000 {
96        compatible = "aspeed,ast2400-scu", "syscon", "simple-mfd";
97        reg = <0x1e6e2000 0x1a8>;
98        #clock-cells = <1>;
99        #reset-cells = <1>;
100
101        #address-cells = <1>;
102        #size-cells = <1>;
103        ranges = <0x0 0x1e6e2000 0x1000>;
104
105        silicon-id@7c {
106            compatible = "aspeed,ast2500-silicon-id", "aspeed,silicon-id";
107            reg = <0x7c 0x4>, <0x150 0x8>;
108        };
109    };
110...
111