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-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 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