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