1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/pinctrl/xlnx,zynqmp-pinctrl.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Xilinx ZynqMP Pinctrl
8
9 maintainers:
10 - Sai Krishna Potthuri <sai.krishna.potthuri@amd.com>
11
12 description: |
13 Please refer to pinctrl-bindings.txt in this directory for details of the
14 common pinctrl bindings used by client devices, including the meaning of the
15 phrase "pin configuration node".
16
17 ZynqMP's pin configuration nodes act as a container for an arbitrary number of
18 subnodes. Each of these subnodes represents some desired configuration for a
19 pin, a group, or a list of pins or groups. This configuration can include the
20 mux function to select on those pin(s)/group(s), and various pin configuration
21 parameters, such as pull-up, slew rate, etc.
22
23 Each configuration node can consist of multiple nodes describing the pinmux and
24 pinconf options. Those nodes can be pinmux nodes or pinconf nodes.
25
26 The name of each subnode is not important; all subnodes should be enumerated
27 and processed purely based on their content.
28
29 properties:
30 compatible:
31 const: xlnx,zynqmp-pinctrl
32
33 patternProperties:
34 '^(.*-)?(default|gpio-grp)$':
35 type: object
36 patternProperties:
37 '^mux':
38 type: object
39 description:
40 Pinctrl node's client devices use subnodes for pin muxes,
41 which in turn use below standard properties.
42 $ref: pinmux-node.yaml#
43
44 properties:
45 pins:
46 description:
47 List of pins to select (either this or "groups" must be specified)
48 items:
49 pattern: '^MIO([0-9]|[1-6][0-9]|7[0-7])$'
50
51 groups:
52 description:
53 List of groups to select (either this or "pins" must be
54 specified), available groups for this subnode.
55 items:
56 anyOf:
57 - pattern: '^MIO([0-9]|[1-6][0-9]|7[0-7])$'
58 - enum: [ethernet0_0_grp, ethernet1_0_grp, ethernet2_0_grp,
59 ethernet3_0_grp, gemtsu0_0_grp, gemtsu0_1_grp,
60 gemtsu0_2_grp, mdio0_0_grp, mdio1_0_grp,
61 mdio1_1_grp, mdio2_0_grp, mdio3_0_grp,
62 qspi0_0_grp, qspi_ss_0_grp, qspi_fbclk_0_grp,
63 spi0_0_grp, spi0_ss_0_grp, spi0_ss_1_grp,
64 spi0_ss_2_grp, spi0_1_grp, spi0_ss_3_grp,
65 spi0_ss_4_grp, spi0_ss_5_grp, spi0_2_grp,
66 spi0_ss_6_grp, spi0_ss_7_grp, spi0_ss_8_grp,
67 spi0_3_grp, spi0_ss_9_grp, spi0_ss_10_grp,
68 spi0_ss_11_grp, spi0_4_grp, spi0_ss_12_grp,
69 spi0_ss_13_grp, spi0_ss_14_grp, spi0_5_grp,
70 spi0_ss_15_grp, spi0_ss_16_grp, spi0_ss_17_grp,
71 spi1_0_grp, spi1_ss_0_grp, spi1_ss_1_grp,
72 spi1_ss_2_grp, spi1_1_grp, spi1_ss_3_grp,
73 spi1_ss_4_grp, spi1_ss_5_grp, spi1_2_grp,
74 spi1_ss_6_grp, spi1_ss_7_grp, spi1_ss_8_grp,
75 spi1_3_grp, spi1_ss_9_grp, spi1_ss_10_grp,
76 spi1_ss_11_grp, spi1_4_grp, spi1_ss_12_grp,
77 spi1_ss_13_grp, spi1_ss_14_grp, spi1_5_grp,
78 spi1_ss_15_grp, spi1_ss_16_grp, spi1_ss_17_grp,
79 sdio0_0_grp, sdio0_1_grp, sdio0_2_grp,
80 sdio0_3_grp, sdio0_4_grp, sdio0_5_grp,
81 sdio0_6_grp, sdio0_7_grp, sdio0_8_grp,
82 sdio0_9_grp, sdio0_10_grp, sdio0_11_grp,
83 sdio0_12_grp, sdio0_13_grp, sdio0_14_grp,
84 sdio0_15_grp, sdio0_16_grp, sdio0_17_grp,
85 sdio0_18_grp, sdio0_19_grp, sdio0_20_grp,
86 sdio0_21_grp, sdio0_22_grp, sdio0_23_grp,
87 sdio0_24_grp, sdio0_25_grp, sdio0_26_grp,
88 sdio0_27_grp, sdio0_28_grp, sdio0_29_grp,
89 sdio0_30_grp, sdio0_31_grp, sdio0_32_grp,
90 sdio0_pc_0_grp, sdio0_cd_0_grp, sdio0_wp_0_grp,
91 sdio0_pc_1_grp, sdio0_cd_1_grp, sdio0_wp_1_grp,
92 sdio0_pc_2_grp, sdio0_cd_2_grp, sdio0_wp_2_grp,
93 sdio1_0_grp, sdio1_1_grp, sdio1_2_grp,
94 sdio1_3_grp, sdio1_4_grp, sdio1_5_grp,
95 sdio1_6_grp, sdio1_7_grp, sdio1_8_grp,
96 sdio1_9_grp, sdio1_10_grp, sdio1_11_grp,
97 sdio1_12_grp, sdio1_13_grp, sdio1_14_grp,
98 sdio1_15_grp, sdio1_pc_0_grp, sdio1_cd_0_grp,
99 sdio1_wp_0_grp, sdio1_pc_1_grp, sdio1_cd_1_grp,
100 sdio1_wp_1_grp, nand0_0_grp, nand0_ce_0_grp,
101 nand0_rb_0_grp, nand0_dqs_0_grp, nand0_ce_1_grp,
102 nand0_rb_1_grp, nand0_dqs_1_grp, can0_0_grp,
103 can0_1_grp, can0_2_grp, can0_3_grp,
104 can0_4_grp, can0_5_grp, can0_6_grp,
105 can0_7_grp, can0_8_grp, can0_9_grp,
106 can0_10_grp, can0_11_grp, can0_12_grp,
107 can0_13_grp, can0_14_grp, can0_15_grp,
108 can0_16_grp, can0_17_grp, can0_18_grp,
109 can1_0_grp, can1_1_grp, can1_2_grp,
110 can1_3_grp, can1_4_grp, can1_5_grp,
111 can1_6_grp, can1_7_grp, can1_8_grp,
112 can1_9_grp, can1_10_grp, can1_11_grp,
113 can1_12_grp, can1_13_grp, can1_14_grp,
114 can1_15_grp, can1_16_grp, can1_17_grp,
115 can1_18_grp, can1_19_grp, uart0_0_grp,
116 uart0_1_grp, uart0_2_grp, uart0_3_grp,
117 uart0_4_grp, uart0_5_grp, uart0_6_grp,
118 uart0_7_grp, uart0_8_grp, uart0_9_grp,
119 uart0_10_grp, uart0_11_grp, uart0_12_grp,
120 uart0_13_grp, uart0_14_grp, uart0_15_grp,
121 uart0_16_grp, uart0_17_grp, uart0_18_grp,
122 uart1_0_grp, uart1_1_grp, uart1_2_grp,
123 uart1_3_grp, uart1_4_grp, uart1_5_grp,
124 uart1_6_grp, uart1_7_grp, uart1_8_grp,
125 uart1_9_grp, uart1_10_grp, uart1_11_grp,
126 uart1_12_grp, uart1_13_grp, uart1_14_grp,
127 uart1_15_grp, uart1_16_grp, uart1_17_grp,
128 uart1_18_grp, i2c0_0_grp, i2c0_1_grp,
129 i2c0_2_grp, i2c0_3_grp, i2c0_4_grp,
130 i2c0_5_grp, i2c0_6_grp, i2c0_7_grp,
131 i2c0_8_grp, i2c0_9_grp, i2c0_10_grp,
132 i2c0_11_grp, i2c0_12_grp, i2c0_13_grp,
133 i2c0_14_grp, i2c0_15_grp, i2c0_16_grp,
134 i2c0_17_grp, i2c0_18_grp, i2c1_0_grp,
135 i2c1_1_grp, i2c1_2_grp, i2c1_3_grp,
136 i2c1_4_grp, i2c1_5_grp, i2c1_6_grp,
137 i2c1_7_grp, i2c1_8_grp, i2c1_9_grp,
138 i2c1_10_grp, i2c1_11_grp, i2c1_12_grp,
139 i2c1_13_grp, i2c1_14_grp, i2c1_15_grp,
140 i2c1_16_grp, i2c1_17_grp, i2c1_18_grp,
141 i2c1_19_grp, ttc0_clk_0_grp, ttc0_wav_0_grp,
142 ttc0_clk_1_grp, ttc0_wav_1_grp, ttc0_clk_2_grp,
143 ttc0_wav_2_grp, ttc0_clk_3_grp, ttc0_wav_3_grp,
144 ttc0_clk_4_grp, ttc0_wav_4_grp, ttc0_clk_5_grp,
145 ttc0_wav_5_grp, ttc0_clk_6_grp, ttc0_wav_6_grp,
146 ttc0_clk_7_grp, ttc0_wav_7_grp, ttc0_clk_8_grp,
147 ttc0_wav_8_grp, ttc1_clk_0_grp, ttc1_wav_0_grp,
148 ttc1_clk_1_grp, ttc1_wav_1_grp, ttc1_clk_2_grp,
149 ttc1_wav_2_grp, ttc1_clk_3_grp, ttc1_wav_3_grp,
150 ttc1_clk_4_grp, ttc1_wav_4_grp, ttc1_clk_5_grp,
151 ttc1_wav_5_grp, ttc1_clk_6_grp, ttc1_wav_6_grp,
152 ttc1_clk_7_grp, ttc1_wav_7_grp, ttc1_clk_8_grp,
153 ttc1_wav_8_grp, ttc2_clk_0_grp, ttc2_wav_0_grp,
154 ttc2_clk_1_grp, ttc2_wav_1_grp, ttc2_clk_2_grp,
155 ttc2_wav_2_grp, ttc2_clk_3_grp, ttc2_wav_3_grp,
156 ttc2_clk_4_grp, ttc2_wav_4_grp, ttc2_clk_5_grp,
157 ttc2_wav_5_grp, ttc2_clk_6_grp, ttc2_wav_6_grp,
158 ttc2_clk_7_grp, ttc2_wav_7_grp, ttc2_clk_8_grp,
159 ttc2_wav_8_grp, ttc3_clk_0_grp, ttc3_wav_0_grp,
160 ttc3_clk_1_grp, ttc3_wav_1_grp, ttc3_clk_2_grp,
161 ttc3_wav_2_grp, ttc3_clk_3_grp, ttc3_wav_3_grp,
162 ttc3_clk_4_grp, ttc3_wav_4_grp, ttc3_clk_5_grp,
163 ttc3_wav_5_grp, ttc3_clk_6_grp, ttc3_wav_6_grp,
164 ttc3_clk_7_grp, ttc3_wav_7_grp, ttc3_clk_8_grp,
165 ttc3_wav_8_grp, swdt0_clk_0_grp, swdt0_rst_0_grp,
166 swdt0_clk_1_grp, swdt0_rst_1_grp, swdt0_clk_2_grp,
167 swdt0_rst_2_grp, swdt0_clk_3_grp, swdt0_rst_3_grp,
168 swdt0_clk_4_grp, swdt0_rst_4_grp, swdt0_clk_5_grp,
169 swdt0_rst_5_grp, swdt0_clk_6_grp, swdt0_rst_6_grp,
170 swdt0_clk_7_grp, swdt0_rst_7_grp, swdt0_clk_8_grp,
171 swdt0_rst_8_grp, swdt0_clk_9_grp, swdt0_rst_9_grp,
172 swdt0_clk_10_grp, swdt0_rst_10_grp, swdt0_clk_11_grp,
173 swdt0_rst_11_grp, swdt0_clk_12_grp, swdt0_rst_12_grp,
174 swdt1_clk_0_grp, swdt1_rst_0_grp, swdt1_clk_1_grp,
175 swdt1_rst_1_grp, swdt1_clk_2_grp, swdt1_rst_2_grp,
176 swdt1_clk_3_grp, swdt1_rst_3_grp, swdt1_clk_4_grp,
177 swdt1_rst_4_grp, swdt1_clk_5_grp, swdt1_rst_5_grp,
178 swdt1_clk_6_grp, swdt1_rst_6_grp, swdt1_clk_7_grp,
179 swdt1_rst_7_grp, swdt1_clk_8_grp, swdt1_rst_8_grp,
180 swdt1_clk_9_grp, swdt1_rst_9_grp, swdt1_clk_10_grp,
181 swdt1_rst_10_grp, swdt1_clk_11_grp, swdt1_rst_11_grp,
182 swdt1_clk_12_grp, swdt1_rst_12_grp, gpio0_0_grp,
183 gpio0_1_grp, gpio0_2_grp, gpio0_3_grp,
184 gpio0_4_grp, gpio0_5_grp, gpio0_6_grp,
185 gpio0_7_grp, gpio0_8_grp, gpio0_9_grp,
186 gpio0_10_grp, gpio0_11_grp, gpio0_12_grp,
187 gpio0_13_grp, gpio0_14_grp, gpio0_15_grp,
188 gpio0_16_grp, gpio0_17_grp, gpio0_18_grp,
189 gpio0_19_grp, gpio0_20_grp, gpio0_21_grp,
190 gpio0_22_grp, gpio0_23_grp, gpio0_24_grp,
191 gpio0_25_grp, gpio0_26_grp, gpio0_27_grp,
192 gpio0_28_grp, gpio0_29_grp, gpio0_30_grp,
193 gpio0_31_grp, gpio0_32_grp, gpio0_33_grp,
194 gpio0_34_grp, gpio0_35_grp, gpio0_36_grp,
195 gpio0_37_grp, gpio0_38_grp, gpio0_39_grp,
196 gpio0_40_grp, gpio0_41_grp, gpio0_42_grp,
197 gpio0_43_grp, gpio0_44_grp, gpio0_45_grp,
198 gpio0_46_grp, gpio0_47_grp, gpio0_48_grp,
199 gpio0_49_grp, gpio0_50_grp, gpio0_51_grp,
200 gpio0_52_grp, gpio0_53_grp, gpio0_54_grp,
201 gpio0_55_grp, gpio0_56_grp, gpio0_57_grp,
202 gpio0_58_grp, gpio0_59_grp, gpio0_60_grp,
203 gpio0_61_grp, gpio0_62_grp, gpio0_63_grp,
204 gpio0_64_grp, gpio0_65_grp, gpio0_66_grp,
205 gpio0_67_grp, gpio0_68_grp, gpio0_69_grp,
206 gpio0_70_grp, gpio0_71_grp, gpio0_72_grp,
207 gpio0_73_grp, gpio0_74_grp, gpio0_75_grp,
208 gpio0_76_grp, gpio0_77_grp, usb0_0_grp,
209 usb1_0_grp, pmu0_0_grp, pmu0_1_grp,
210 pmu0_2_grp, pmu0_3_grp, pmu0_4_grp,
211 pmu0_5_grp, pmu0_6_grp, pmu0_7_grp,
212 pmu0_8_grp, pmu0_9_grp, pmu0_10_grp,
213 pmu0_11_grp, pcie0_0_grp, pcie0_1_grp,
214 pcie0_2_grp, pcie0_3_grp, pcie0_4_grp,
215 pcie0_5_grp, pcie0_6_grp, pcie0_7_grp,
216 csu0_0_grp, csu0_1_grp, csu0_2_grp,
217 csu0_3_grp, csu0_4_grp, csu0_5_grp,
218 csu0_6_grp, csu0_7_grp, csu0_8_grp,
219 csu0_9_grp, csu0_10_grp, csu0_11_grp,
220 dpaux0_0_grp, dpaux0_1_grp, dpaux0_2_grp,
221 dpaux0_3_grp, pjtag0_0_grp, pjtag0_1_grp,
222 pjtag0_2_grp, pjtag0_3_grp, pjtag0_4_grp,
223 pjtag0_5_grp, trace0_0_grp, trace0_clk_0_grp,
224 trace0_1_grp, trace0_clk_1_grp, trace0_2_grp,
225 trace0_clk_2_grp, testscan0_0_grp]
226 maxItems: 78
227
228 function:
229 description:
230 Specify the alternative function to be configured for the
231 given pin groups.
232 enum: [ethernet0, ethernet1, ethernet2, ethernet3, gemtsu0, usb0, usb1, mdio0,
233 mdio1, mdio2, mdio3, qspi0, qspi_fbclk, qspi_ss, spi0, spi1, spi0_ss,
234 spi1_ss, sdio0, sdio0_pc, sdio0_wp, sdio0_cd, sdio1, sdio1_pc, sdio1_wp,
235 sdio1_cd, nand0, nand0_ce, nand0_rb, nand0_dqs, can0, can1, uart0, uart1,
236 i2c0, i2c1, ttc0_clk, ttc0_wav, ttc1_clk, ttc1_wav, ttc2_clk, ttc2_wav,
237 ttc3_clk, ttc3_wav, swdt0_clk, swdt0_rst, swdt1_clk, swdt1_rst, gpio0, pmu0,
238 pcie0, csu0, dpaux0, pjtag0, trace0, trace0_clk, testscan0]
239
240 required:
241 - function
242
243 oneOf:
244 - required: [ groups ]
245 - required: [ pins ]
246
247 additionalProperties: false
248
249 '^conf':
250 type: object
251 description:
252 Pinctrl node's client devices use subnodes for pin configurations,
253 which in turn use the standard properties below.
254 $ref: pincfg-node.yaml#
255
256 properties:
257 groups:
258 description:
259 List of pin groups as mentioned above.
260
261 pins:
262 description:
263 List of pin names to select in this subnode.
264 items:
265 pattern: '^MIO([0-9]|[1-6][0-9]|7[0-7])$'
266 maxItems: 78
267
268 bias-pull-up: true
269
270 bias-pull-down: true
271
272 bias-disable: true
273
274 input-schmitt-enable: true
275
276 input-schmitt-disable: true
277
278 bias-high-impedance: true
279
280 low-power-enable: true
281
282 low-power-disable: true
283
284 slew-rate:
285 enum: [0, 1]
286
287 output-enable:
288 description:
289 This will internally disable the tri-state for MIO pins.
290
291 drive-strength:
292 description:
293 Selects the drive strength for MIO pins, in mA.
294 enum: [2, 4, 8, 12]
295
296 power-source:
297 enum: [0, 1]
298
299 oneOf:
300 - required: [ groups ]
301 - required: [ pins ]
302
303 additionalProperties: false
304
305 additionalProperties: false
306
307 allOf:
308 - $ref: pinctrl.yaml#
309
310 required:
311 - compatible
312
313 additionalProperties: false
314
315 examples:
316 - |
317 #include <dt-bindings/pinctrl/pinctrl-zynqmp.h>
318 zynqmp_firmware: zynqmp-firmware {
319 pinctrl0: pinctrl {
320 compatible = "xlnx,zynqmp-pinctrl";
321
322 pinctrl_uart1_default: uart1-default {
323 mux {
324 groups = "uart0_4_grp", "uart0_5_grp";
325 function = "uart0";
326 };
327
328 conf {
329 groups = "uart0_4_grp";
330 slew-rate = <SLEW_RATE_SLOW>;
331 power-source = <IO_STANDARD_LVCMOS18>;
332 };
333
334 conf-rx {
335 pins = "MIO18";
336 bias-pull-up;
337 };
338
339 conf-tx {
340 pins = "MIO19";
341 bias-disable;
342 input-schmitt-disable;
343 };
344 };
345 };
346 };
347
348 uart1 {
349 pinctrl-names = "default";
350 pinctrl-0 = <&pinctrl_uart1_default>;
351 };
352
353 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.