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    type: object
51    additionalProperties: true
52    properties:
53      compatible:
54        contains:
55          enum:
56            - aspeed,ast2400-pinctrl
57            - aspeed,ast2500-pinctrl
58            - aspeed,ast2600-pinctrl
59
60    required:
61      - compatible
62
63  '^interrupt-controller@[0-9a-f]+$':
64    description: See Documentation/devicetree/bindings/interrupt-controller/aspeed,ast2xxx-scu-ic.txt
65    type: object
66
67  '^silicon-id@[0-9a-f]+$':
68    description: Unique hardware silicon identifiers within the SoC
69    type: object
70    additionalProperties: false
71
72    properties:
73      compatible:
74        items:
75          - enum:
76              - aspeed,ast2400-silicon-id
77              - aspeed,ast2500-silicon-id
78              - aspeed,ast2600-silicon-id
79          - const: aspeed,silicon-id
80
81      reg:
82        description:
83          The reg should be the unique silicon id register, and not backwards
84          compatible one in eg. the 2600.
85        minItems: 1
86        items:
87          - description: silicon id information registers
88          - description: unique chip id registers
89
90required:
91  - compatible
92  - reg
93  - ranges
94  - '#address-cells'
95  - '#size-cells'
96  - '#clock-cells'
97  - '#reset-cells'
98
99additionalProperties: false
100
101examples:
102  - |
103    syscon@1e6e2000 {
104        compatible = "aspeed,ast2400-scu", "syscon", "simple-mfd";
105        reg = <0x1e6e2000 0x1a8>;
106        #clock-cells = <1>;
107        #reset-cells = <1>;
108
109        #address-cells = <1>;
110        #size-cells = <1>;
111        ranges = <0x0 0x1e6e2000 0x1000>;
112
113        silicon-id@7c {
114            compatible = "aspeed,ast2500-silicon-id", "aspeed,silicon-id";
115            reg = <0x7c 0x4>, <0x150 0x8>;
116        };
117    };
118...
119