1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pinctrl/allwinner,sun4i-a10-pinctrl.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A10 Pin Controller Device Tree Bindings
8
9maintainers:
10  - Chen-Yu Tsai <wens@csie.org>
11  - Maxime Ripard <mripard@kernel.org>
12
13properties:
14  "#gpio-cells":
15    const: 3
16    description:
17      GPIO consumers must use three arguments, first the number of the
18      bank, then the pin number inside that bank, and finally the GPIO
19      flags.
20
21  "#interrupt-cells":
22    const: 3
23    description:
24      Interrupts consumers must use three arguments, first the number
25      of the bank, then the pin number inside that bank, and finally
26      the interrupts flags.
27
28  compatible:
29    enum:
30      - allwinner,sun4i-a10-pinctrl
31      - allwinner,sun5i-a10s-pinctrl
32      - allwinner,sun5i-a13-pinctrl
33      - allwinner,sun6i-a31-pinctrl
34      - allwinner,sun6i-a31-r-pinctrl
35      - allwinner,sun6i-a31s-pinctrl
36      - allwinner,sun7i-a20-pinctrl
37      - allwinner,sun8i-a23-pinctrl
38      - allwinner,sun8i-a23-r-pinctrl
39      - allwinner,sun8i-a33-pinctrl
40      - allwinner,sun8i-a83t-pinctrl
41      - allwinner,sun8i-a83t-r-pinctrl
42      - allwinner,sun8i-h3-pinctrl
43      - allwinner,sun8i-h3-r-pinctrl
44      - allwinner,sun8i-r40-pinctrl
45      - allwinner,sun8i-v3-pinctrl
46      - allwinner,sun8i-v3s-pinctrl
47      - allwinner,sun9i-a80-pinctrl
48      - allwinner,sun9i-a80-r-pinctrl
49      - allwinner,sun20i-d1-pinctrl
50      - allwinner,sun50i-a64-pinctrl
51      - allwinner,sun50i-a64-r-pinctrl
52      - allwinner,sun50i-a100-pinctrl
53      - allwinner,sun50i-a100-r-pinctrl
54      - allwinner,sun50i-h5-pinctrl
55      - allwinner,sun50i-h6-pinctrl
56      - allwinner,sun50i-h6-r-pinctrl
57      - allwinner,sun50i-h616-pinctrl
58      - allwinner,sun50i-h616-r-pinctrl
59      - allwinner,suniv-f1c100s-pinctrl
60      - nextthing,gr8-pinctrl
61
62  reg:
63    maxItems: 1
64
65  interrupts:
66    minItems: 1
67    maxItems: 8
68    description:
69      One interrupt per external interrupt bank supported on the
70      controller, sorted by bank number ascending order.
71
72  clocks:
73    items:
74      - description: Bus Clock
75      - description: High Frequency Oscillator
76      - description: Low Frequency Oscillator
77
78  clock-names:
79    items:
80      - const: apb
81      - const: hosc
82      - const: losc
83
84  gpio-controller: true
85  interrupt-controller: true
86  gpio-line-names: true
87
88  input-debounce:
89    description:
90      Debouncing periods in microseconds, one period per interrupt
91      bank found in the controller
92    $ref: /schemas/types.yaml#/definitions/uint32-array
93    minItems: 1
94    maxItems: 8
95
96patternProperties:
97  # It's pretty scary, but the basic idea is that:
98  #   - One node name can start with either s- or r- for PRCM nodes,
99  #   - Then, the name itself can be any repetition of <string>- (to
100  #     accomodate with nodes like uart4-rts-cts-pins), where each
101  #     string can be either starting with 'p' but in a string longer
102  #     than 3, or something that doesn't start with 'p',
103  #   - Then, the bank name is optional and will be between pa and pg,
104  #     pl or pm. Some pins groups that have several options will have
105  #     the pin numbers then,
106  #   - Finally, the name will end with either -pin or pins.
107
108  "^([rs]-)?(([a-z0-9]{3,}|[a-oq-z][a-z0-9]*?)?-)+?(p[a-ilm][0-9]*?-)??pins?$":
109    type: object
110
111    properties:
112      pins: true
113      function: true
114      bias-disable: true
115      bias-pull-up: true
116      bias-pull-down: true
117
118      drive-strength:
119        $ref: /schemas/types.yaml#/definitions/uint32
120        enum: [10, 20, 30, 40]
121
122    required:
123      - pins
124      - function
125
126    additionalProperties: false
127
128  "^vcc-p[a-ilm]-supply$":
129    description:
130      Power supplies for pin banks.
131
132required:
133  - "#gpio-cells"
134  - compatible
135  - reg
136  - clocks
137  - clock-names
138  - gpio-controller
139
140allOf:
141  # FIXME: We should have the pin bank supplies here, but not a lot of
142  # boards are defining it at the moment so it would generate a lot of
143  # warnings.
144
145  - $ref: "pinctrl.yaml#"
146  - if:
147      not:
148        properties:
149          compatible:
150            enum:
151              - allwinner,sun50i-h616-r-pinctrl
152
153    then:
154      required:
155        - "#interrupt-cells"
156        - interrupts
157        - interrupt-controller
158
159  - if:
160      properties:
161        compatible:
162          enum:
163            - allwinner,sun50i-h616-pinctrl
164
165    then:
166      properties:
167        interrupts:
168          minItems: 8
169
170  - if:
171      properties:
172        compatible:
173          enum:
174            - allwinner,sun50i-a100-pinctrl
175
176    then:
177      properties:
178        interrupts:
179          minItems: 7
180          maxItems: 7
181
182  - if:
183      properties:
184        compatible:
185          enum:
186            - allwinner,sun20i-d1-pinctrl
187
188    then:
189      properties:
190        interrupts:
191          minItems: 6
192          maxItems: 6
193
194  - if:
195      properties:
196        compatible:
197          enum:
198            - allwinner,sun9i-a80-pinctrl
199
200    then:
201      properties:
202        interrupts:
203          minItems: 5
204          maxItems: 5
205
206  - if:
207      properties:
208        compatible:
209          enum:
210            - allwinner,sun6i-a31-pinctrl
211            - allwinner,sun6i-a31s-pinctrl
212            - allwinner,sun50i-h6-pinctrl
213
214    then:
215      properties:
216        interrupts:
217          minItems: 4
218          maxItems: 4
219
220  - if:
221      properties:
222        compatible:
223          enum:
224            - allwinner,sun8i-a23-pinctrl
225            - allwinner,sun8i-a83t-pinctrl
226            - allwinner,sun50i-a64-pinctrl
227            - allwinner,sun50i-h5-pinctrl
228            - allwinner,suniv-f1c100s-pinctrl
229
230    then:
231      properties:
232        interrupts:
233          minItems: 3
234          maxItems: 3
235
236  - if:
237      properties:
238        compatible:
239          enum:
240            - allwinner,sun6i-a31-r-pinctrl
241            - allwinner,sun8i-a33-pinctrl
242            - allwinner,sun8i-h3-pinctrl
243            - allwinner,sun8i-v3-pinctrl
244            - allwinner,sun8i-v3s-pinctrl
245            - allwinner,sun9i-a80-r-pinctrl
246            - allwinner,sun50i-h6-r-pinctrl
247
248    then:
249      properties:
250        interrupts:
251          minItems: 2
252          maxItems: 2
253
254  - if:
255      properties:
256        compatible:
257          enum:
258            - allwinner,sun4i-a10-pinctrl
259            - allwinner,sun5i-a10s-pinctrl
260            - allwinner,sun5i-a13-pinctrl
261            - allwinner,sun7i-a20-pinctrl
262            - allwinner,sun8i-a23-r-pinctrl
263            - allwinner,sun8i-a83t-r-pinctrl
264            - allwinner,sun8i-h3-r-pinctrl
265            - allwinner,sun8i-r40-pinctrl
266            - allwinner,sun50i-a64-r-pinctrl
267            - allwinner,sun50i-a100-r-pinctrl
268            - nextthing,gr8-pinctrl
269
270    then:
271      properties:
272        interrupts:
273          minItems: 1
274          maxItems: 1
275
276additionalProperties: false
277
278examples:
279  - |
280    #include <dt-bindings/clock/sun5i-ccu.h>
281
282    pio: pinctrl@1c20800 {
283        compatible = "allwinner,sun5i-a13-pinctrl";
284        reg = <0x01c20800 0x400>;
285        interrupts = <28>;
286        clocks = <&ccu CLK_APB0_PIO>, <&osc24M>, <&osc32k>;
287        clock-names = "apb", "hosc", "losc";
288        gpio-controller;
289        interrupt-controller;
290        #interrupt-cells = <3>;
291        #gpio-cells = <3>;
292
293        uart1_pe_pins: uart1-pe-pins {
294            pins = "PE10", "PE11";
295            function = "uart1";
296        };
297
298        uart1_pg_pins: uart1-pg-pins {
299            pins = "PG3", "PG4";
300            function = "uart1";
301        };
302    };
303