xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/allwinner,sun8i-a23-prcm.yaml (revision 911f0260390e18cf85f3dbf2c719b593efdc1e3c) 
1# SPDX-License-Identifier: GPL-2.0+
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/allwinner,sun8i-a23-prcm.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A23 PRCM Device Tree Bindings
8
9maintainers:
10  - Chen-Yu Tsai <wens@csie.org>
11  - Maxime Ripard <mripard@kernel.org>
12
13deprecated: true
14
15properties:
16  compatible:
17    const: allwinner,sun8i-a23-prcm
18
19  reg:
20    maxItems: 1
21
22patternProperties:
23  "^.*(clk|rst|codec).*$":
24    type: object
25
26    properties:
27      compatible:
28        enum:
29          - fixed-factor-clock
30          - allwinner,sun8i-a23-apb0-clk
31          - allwinner,sun8i-a23-apb0-gates-clk
32          - allwinner,sun6i-a31-clock-reset
33          - allwinner,sun8i-a23-codec-analog
34
35    required:
36      - compatible
37
38    allOf:
39      - if:
40          properties:
41            compatible:
42              contains:
43                const: allwinner,sun8i-a23-apb0-clk
44
45        then:
46          properties:
47            "#clock-cells":
48              const: 0
49
50            # Already checked in the main schema
51            compatible: true
52
53            clocks:
54              maxItems: 1
55
56            clock-output-names:
57              maxItems: 1
58
59            phandle: true
60
61          required:
62            - "#clock-cells"
63            - compatible
64            - clocks
65            - clock-output-names
66
67          additionalProperties: false
68
69      - if:
70          properties:
71            compatible:
72              contains:
73                const: allwinner,sun8i-a23-apb0-gates-clk
74
75        then:
76          properties:
77            "#clock-cells":
78              const: 1
79              description: >
80                This additional argument passed to that clock is the
81                offset of the bit controlling this particular gate in
82                the register.
83
84            # Already checked in the main schema
85            compatible: true
86
87            clocks:
88              maxItems: 1
89
90            clock-output-names:
91              minItems: 1
92              maxItems: 32
93
94            phandle: true
95
96          required:
97            - "#clock-cells"
98            - compatible
99            - clocks
100            - clock-output-names
101
102          additionalProperties: false
103
104      - if:
105          properties:
106            compatible:
107              contains:
108                const: allwinner,sun6i-a31-clock-reset
109
110        then:
111          properties:
112            "#reset-cells":
113              const: 1
114
115            # Already checked in the main schema
116            compatible: true
117
118            phandle: true
119
120          required:
121            - "#reset-cells"
122            - compatible
123
124          additionalProperties: false
125
126      - if:
127          properties:
128            compatible:
129              contains:
130                const: allwinner,sun8i-a23-codec-analog
131
132        then:
133          properties:
134            # Already checked in the main schema
135            compatible: true
136
137            phandle: true
138
139          required:
140            - compatible
141
142          additionalProperties: false
143
144required:
145  - compatible
146  - reg
147
148additionalProperties: false
149
150examples:
151  - |
152    prcm@1f01400 {
153        compatible = "allwinner,sun8i-a23-prcm";
154        reg = <0x01f01400 0x200>;
155
156        ar100: ar100_clk {
157            compatible = "fixed-factor-clock";
158            #clock-cells = <0>;
159            clock-div = <1>;
160            clock-mult = <1>;
161            clocks = <&osc24M>;
162            clock-output-names = "ar100";
163        };
164
165        ahb0: ahb0_clk {
166            compatible = "fixed-factor-clock";
167            #clock-cells = <0>;
168            clock-div = <1>;
169            clock-mult = <1>;
170            clocks = <&ar100>;
171            clock-output-names = "ahb0";
172        };
173
174        apb0: apb0_clk {
175            compatible = "allwinner,sun8i-a23-apb0-clk";
176            #clock-cells = <0>;
177            clocks = <&ahb0>;
178            clock-output-names = "apb0";
179        };
180
181        apb0_gates: apb0_gates_clk {
182            compatible = "allwinner,sun8i-a23-apb0-gates-clk";
183            #clock-cells = <1>;
184            clocks = <&apb0>;
185            clock-output-names = "apb0_pio", "apb0_timer",
186                                 "apb0_rsb", "apb0_uart",
187                                 "apb0_i2c";
188        };
189
190        apb0_rst: apb0_rst {
191            compatible = "allwinner,sun6i-a31-clock-reset";
192            #reset-cells = <1>;
193        };
194
195        codec_analog: codec-analog {
196            compatible = "allwinner,sun8i-a23-codec-analog";
197        };
198    };
199
200...
201