tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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 };