xref: /freebsd/sys/contrib/device-tree/Bindings/pinctrl/allwinner,sun55i-a523-pinctrl.yaml (revision 8ccc0d235c226d84112561d453c49904398d085c) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pinctrl/allwinner,sun55i-a523-pinctrl.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A523 Pin Controller
8
9maintainers:
10  - Andre Przywara <andre.przywara@arm.com>
11
12properties:
13  "#gpio-cells":
14    const: 3
15    description:
16      GPIO consumers must use three arguments, first the number of the
17      bank, then the pin number inside that bank, and finally the GPIO
18      flags.
19
20  "#interrupt-cells":
21    const: 3
22    description:
23      Interrupts consumers must use three arguments, first the number
24      of the bank, then the pin number inside that bank, and finally
25      the interrupts flags.
26
27  compatible:
28    enum:
29      - allwinner,sun55i-a523-pinctrl
30      - allwinner,sun55i-a523-r-pinctrl
31
32  reg:
33    maxItems: 1
34
35  interrupts:
36    minItems: 2
37    maxItems: 10
38    description:
39      One interrupt per external interrupt bank supported on the
40      controller, sorted by bank number ascending order.
41
42  clocks:
43    items:
44      - description: Bus Clock
45      - description: High Frequency Oscillator
46      - description: Low Frequency Oscillator
47
48  clock-names:
49    items:
50      - const: apb
51      - const: hosc
52      - const: losc
53
54  gpio-controller: true
55  interrupt-controller: true
56  gpio-line-names: true
57
58  input-debounce:
59    description:
60      Debouncing periods in microseconds, one period per interrupt
61      bank found in the controller
62    $ref: /schemas/types.yaml#/definitions/uint32-array
63    minItems: 2
64    maxItems: 10
65
66patternProperties:
67  # It's pretty scary, but the basic idea is that:
68  #   - One node name can start with either s- or r- for PRCM nodes,
69  #   - Then, the name itself can be any repetition of <string>- (to
70  #     accommodate with nodes like uart4-rts-cts-pins), where each
71  #     string can be either starting with 'p' but in a string longer
72  #     than 3, or something that doesn't start with 'p',
73  #   - Then, the bank name is optional and will be between pa and pm.
74  #     Some pins groups that have several options will have the pin
75  #     numbers then,
76  #   - Finally, the name will end with either -pin or pins.
77
78  "^([rs]-)?(([a-z0-9]{3,}|[a-oq-z][a-z0-9]*?)?-)+?(p[a-m][0-9]*?-)??pins?$":
79    type: object
80
81    properties:
82      pins: true
83      function: true
84      bias-disable: true
85      bias-pull-up: true
86      bias-pull-down: true
87
88      drive-strength:
89        $ref: /schemas/types.yaml#/definitions/uint32
90        enum: [10, 20, 30, 40]
91
92      allwinner,pinmux:
93        $ref: /schemas/types.yaml#/definitions/uint32-array
94        description:
95          Pinmux selector value, for each pin. Almost every time this value
96          is the same for all pins, so any array shorter than the number of
97          pins will repeat the last value, to allow just specifying a single
98          cell, for all cells.
99
100    required:
101      - pins
102      - allwinner,pinmux
103      - function
104
105    additionalProperties: false
106
107  "^vcc-p[a-m]-supply$":
108    description:
109      Power supplies for pin banks.
110
111required:
112  - "#gpio-cells"
113  - compatible
114  - reg
115  - clocks
116  - clock-names
117  - gpio-controller
118  - "#interrupt-cells"
119  - interrupts
120  - interrupt-controller
121
122allOf:
123  - $ref: pinctrl.yaml#
124  - if:
125      properties:
126        compatible:
127          enum:
128            - allwinner,sun55i-a523-pinctrl
129
130    then:
131      properties:
132        interrupts:
133          minItems: 10
134          maxItems: 10
135
136  - if:
137      properties:
138        compatible:
139          enum:
140            - allwinner,sun55i-a523-r-pinctrl
141
142    then:
143      properties:
144        interrupts:
145          minItems: 2
146          maxItems: 2
147
148additionalProperties: false
149
150examples:
151  - |
152    r_pio: pinctrl@7022000 {
153        compatible = "allwinner,sun55i-a523-r-pinctrl";
154        reg = <0x7022000 0x800>;
155        interrupts = <0 159 4>, <0 161 4>;
156        clocks = <&r_ccu 1>, <&osc24M>, <&osc32k>;
157        clock-names = "apb", "hosc", "losc";
158        gpio-controller;
159        #gpio-cells = <3>;
160        interrupt-controller;
161        #interrupt-cells = <3>;
162
163        r_i2c_pins: r-i2c-pins {
164            pins = "PL0", "PL1";
165            allwinner,pinmux = <2>;
166            function = "r_i2c0";
167            bias-pull-up;
168        };
169
170        r_spi_pins: r-spi-pins {
171            pins = "PL11" ,"PL12", "PL13";
172            allwinner,pinmux = <6>;
173            function = "r_spi";
174        };
175    };
176