Bindings/pinctrl/mediatek,mt7981-pinctrl.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/pinctrl/mediatek,mt7981-pinctrl.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: MediaTek MT7981 Pin Controller
   8
   9 maintainers:
  10   - Daniel Golle <daniel@makrotopia.org>
  11
  12 description:
  13   The MediaTek's MT7981 Pin controller is used to control SoC pins.
  14
  15 properties:
  16   compatible:
  17     enum:
  18       - mediatek,mt7981-pinctrl
  19
  20   reg:
  21     minItems: 9
  22     maxItems: 9
  23
  24   reg-names:
  25     items:
  26       - const: gpio
  27       - const: iocfg_rt
  28       - const: iocfg_rm
  29       - const: iocfg_rb
  30       - const: iocfg_lb
  31       - const: iocfg_bl
  32       - const: iocfg_tm
  33       - const: iocfg_tl
  34       - const: eint
  35
  36   gpio-controller: true
  37
  38   "#gpio-cells":
  39     const: 2
  40     description:
  41       Number of cells in GPIO specifier. Since the generic GPIO binding is used,
  42       the amount of cells must be specified as 2. See the below mentioned gpio
  43       binding representation for description of particular cells.
  44
  45   gpio-ranges:
  46     minItems: 1
  47     maxItems: 5
  48     description: GPIO valid number range.
  49
  50   interrupt-controller: true
  51
  52   interrupts:
  53     maxItems: 1
  54
  55   "#interrupt-cells":
  56     const: 2
  57
  58 allOf:
  59   - $ref: pinctrl.yaml#
  60
  61 required:
  62   - compatible
  63   - reg
  64   - reg-names
  65   - gpio-controller
  66   - "#gpio-cells"
  67
  68 patternProperties:
  69   '-pins$':
  70     type: object
  71     additionalProperties: false
  72
  73     patternProperties:
  74       '^.*mux.*$':
  75         type: object
  76         additionalProperties: false
  77         description: |
  78           pinmux configuration nodes.
  79
  80           The following table shows the effective values of "group", "function"
  81           properties and chip pinout pins
  82
  83           groups                 function    pins (in pin#)
  84           ---------------------------------------------------------------------
  85           "wa_aice1"             "wa_aice"   0, 1
  86           "wa_aice2"             "wa_aice"   0, 1
  87           "wm_uart_0"            "uart"      0, 1
  88           "dfd"                  "dfd"       0, 1, 4, 5
  89           "watchdog"             "watchdog"  2
  90           "pcie_pereset"         "pcie"      3
  91           "jtag"                 "jtag"      4, 5, 6, 7, 8
  92           "wm_jtag_0"            "jtag"      4, 5, 6, 7, 8
  93           "wo0_jtag_0"           "jtag"      9, 10, 11, 12, 13
  94           "uart2_0"              "uart"      4, 5, 6, 7
  95           "gbe_led0"             "led"       8
  96           "pta_ext_0"            "pta"       4, 5, 6
  97           "pwm2"                 "pwm"       7
  98           "net_wo0_uart_txd_0"   "uart"      8
  99           "spi1_0"               "spi"       4, 5, 6, 7
 100           "i2c0_0"               "i2c"       6, 7
 101           "dfd_ntrst"            "dfd"       8
 102           "wm_aice1"             "wa_aice"   9, 10
 103           "pwm0_0"               "pwm"       13
 104           "pwm0_1"               "pwm"       15
 105           "pwm1_0"               "pwm"       14
 106           "pwm1_1"               "pwm"       15
 107           "net_wo0_uart_txd_1"   "uart"      14
 108           "net_wo0_uart_txd_2"   "uart"      15
 109           "gbe_led1"             "led"       13
 110           "pcm"                  "pcm"       9, 10, 11, 12, 13, 25
 111           "watchdog1"            "watchdog"  13
 112           "udi"                  "udi"       9, 10, 11, 12, 13
 113           "drv_vbus"             "usb"       14
 114           "emmc_45"              "flash"     15, 16, 17, 18, 19, 20, 21, 22, 23,
 115                                              24, 25
 116
 117           "snfi"                 "flash"     16, 17, 18, 19, 20, 21
 118           "spi0"                 "spi"       16, 17, 18, 19
 119           "spi0_wp_hold"         "spi"       20, 21
 120           "spi1_1"               "spi"       22, 23, 24, 25
 121           "spi2"                 "spi"       26, 27, 28, 29
 122           "spi2_wp_hold"         "spi"       30, 31
 123           "uart1_0"              "uart"      16, 17, 18, 19
 124           "uart1_1"              "uart"      26, 27, 28, 29
 125           "uart2_1"              "uart"      22, 23, 24, 25
 126           "pta_ext_1"            "pta"       22, 23, 24
 127           "wm_aurt_1"            "uart"      20, 21
 128           "wm_aurt_2"            "uart"      30, 31
 129           "wm_jtag_1"            "jtag"      20, 21, 22, 23, 24
 130           "wo0_jtag_1"           "jtag"      25, 26, 27, 28, 29
 131           "wa_aice3"             "wa_aice"   28, 20
 132           "wm_aice2"             "wa_aice"   30, 31
 133           "i2c0_1"               "i2c"       30, 31
 134           "u2_phy_i2c"           "i2c"       30, 31
 135           "uart0"                "uart"      32, 33
 136           "sgmii1_phy_i2c"       "i2c"       32, 33
 137           "u3_phy_i2c"           "i2c"       32, 33
 138           "sgmii0_phy_i2c"       "i2c"       32, 33
 139           "pcie_clk"             "pcie"      34
 140           "pcie_wake"            "pcie"      35
 141           "i2c0_2"               "i2c"       36, 37
 142           "smi_mdc_mdio"         "eth"       36, 37
 143           "gbe_ext_mdc_mdio"     "eth"       36, 37
 144           "wf0_mode1"            "eth"       40, 41, 42, 43, 44, 45, 46, 47, 48,
 145                                              49, 50, 51, 52, 53, 54, 55, 56
 146
 147           "wf0_mode3"            "eth"       45, 46, 47, 48, 49, 51
 148           "wf2g_led0"            "led"       30
 149           "wf2g_led1"            "led"       34
 150           "wf5g_led0"            "led"       31
 151           "wf5g_led1"            "led"       35
 152           "mt7531_int"           "eth"       38
 153           "ant_sel"              "ant"       14, 15, 16, 17, 18, 19, 20, 21, 22,
 154                                              23, 24, 25, 34, 35
 155
 156         $ref: /schemas/pinctrl/pinmux-node.yaml
 157         properties:
 158           function:
 159             description:
 160               A string containing the name of the function to mux to the group.
 161             enum: [wa_aice, dfd, jtag, pta, pcm, udi, usb, ant, eth, i2c, led,
 162                    pwm, spi, uart, watchdog, flash, pcie]
 163           groups:
 164             description:
 165               An array of strings. Each string contains the name of a group.
 166
 167         required:
 168           - function
 169           - groups
 170
 171         allOf:
 172           - if:
 173               properties:
 174                 function:
 175                   const: wa_aice
 176             then:
 177               properties:
 178                 groups:
 179                   enum: [wa_aice1, wa_aice2, wm_aice1_1, wa_aice3, wm_aice1_2]
 180           - if:
 181               properties:
 182                 function:
 183                   const: dfd
 184             then:
 185               properties:
 186                 groups:
 187                   enum: [dfd, dfd_ntrst]
 188           - if:
 189               properties:
 190                 function:
 191                   const: jtag
 192             then:
 193               properties:
 194                 groups:
 195                   enum: [jtag, wm_jtag_0, wo0_jtag_0, wo0_jtag_1, wm_jtag_1]
 196           - if:
 197               properties:
 198                 function:
 199                   const: pta
 200             then:
 201               properties:
 202                 groups:
 203                   enum: [pta_ext_0, pta_ext_1]
 204           - if:
 205               properties:
 206                 function:
 207                   const: pcm
 208             then:
 209               properties:
 210                 groups:
 211                   enum: [pcm]
 212           - if:
 213               properties:
 214                 function:
 215                   const: udi
 216             then:
 217               properties:
 218                 groups:
 219                   enum: [udi]
 220           - if:
 221               properties:
 222                 function:
 223                   const: usb
 224             then:
 225               properties:
 226                 groups:
 227                   enum: [drv_vbus]
 228           - if:
 229               properties:
 230                 function:
 231                   const: ant
 232             then:
 233               properties:
 234                 groups:
 235                   enum: [ant_sel]
 236           - if:
 237               properties:
 238                 function:
 239                   const: eth
 240             then:
 241               properties:
 242                 groups:
 243                   enum: [smi_mdc_mdio, gbe_ext_mdc_mdio, wf0_mode1, wf0_mode3,
 244                          mt7531_int]
 245           - if:
 246               properties:
 247                 function:
 248                   const: i2c
 249             then:
 250               properties:
 251                 groups:
 252                   enum: [i2c0_0, i2c0_1, u2_phy_i2c, sgmii1_phy_i2c, u3_phy_i2c,
 253                          sgmii0_phy_i2c, i2c0_2]
 254           - if:
 255               properties:
 256                 function:
 257                   const: led
 258             then:
 259               properties:
 260                 groups:
 261                   enum: [gbe_led0, gbe_led1, wf2g_led0, wf2g_led1, wf5g_led0,
 262                          wf5g_led1]
 263           - if:
 264               properties:
 265                 function:
 266                   const: pwm
 267             then:
 268               properties:
 269                 groups:
 270                   items:
 271                     enum: [pwm2, pwm0_0, pwm0_1, pwm1_0, pwm1_1]
 272                   maxItems: 3
 273           - if:
 274               properties:
 275                 function:
 276                   const: spi
 277             then:
 278               properties:
 279                 groups:
 280                   items:
 281                     enum: [spi1_0, spi0, spi0_wp_hold, spi1_1, spi2,
 282                            spi2_wp_hold]
 283                   maxItems: 4
 284           - if:
 285               properties:
 286                 function:
 287                   const: uart
 288             then:
 289               properties:
 290                 groups:
 291                   items:
 292                     enum: [wm_uart_0, uart2_0, net_wo0_uart_txd_0,
 293                            net_wo0_uart_txd_1, net_wo0_uart_txd_2, uart1_0,
 294                            uart1_1, uart2_1, wm_aurt_1, wm_aurt_2, uart0]
 295           - if:
 296               properties:
 297                 function:
 298                   const: watchdog
 299             then:
 300               properties:
 301                 groups:
 302                   enum: [watchdog]
 303           - if:
 304               properties:
 305                 function:
 306                   const: flash
 307             then:
 308               properties:
 309                 groups:
 310                   items:
 311                     enum: [emmc_45, snfi]
 312                   maxItems: 1
 313           - if:
 314               properties:
 315                 function:
 316                   const: pcie
 317             then:
 318               properties:
 319                 groups:
 320                   items:
 321                     enum: [pcie_clk, pcie_wake, pcie_pereset]
 322                   maxItems: 3
 323
 324       '^.*conf.*$':
 325         type: object
 326         additionalProperties: false
 327         description: pinconf configuration nodes.
 328         $ref: /schemas/pinctrl/pincfg-node.yaml
 329
 330         properties:
 331           pins:
 332             description:
 333               An array of strings. Each string contains the name of a pin.
 334             items:
 335               enum: [GPIO_WPS, GPIO_RESET, SYS_WATCHDOG, PCIE_PERESET_N,
 336                      JTAG_JTDO, JTAG_JTDI, JTAG_JTMS, JTAG_JTCLK, JTAG_JTRST_N,
 337                      WO_JTAG_JTDO, WO_JTAG_JTDI, WO_JTAG_JTMS, WO_JTAG_JTCLK,
 338                      WO_JTAG_JTRST_N, USB_VBUS, PWM0, SPI0_CLK, SPI0_MOSI,
 339                      SPI0_MISO, SPI0_CS, SPI0_HOLD, SPI0_WP, SPI1_CLK,
 340                      SPI1_MOSI, SPI1_MISO, SPI1_CS, SPI2_CLK, SPI2_MOSI,
 341                      SPI2_MISO, SPI2_CS, SPI2_HOLD, SPI2_WP, UART0_RXD,
 342                      UART0_TXD, PCIE_CLK_REQ, PCIE_WAKE_N, SMI_MDC, SMI_MDIO,
 343                      GBE_INT, GBE_RESET, WF_DIG_RESETB, WF_CBA_RESETB,
 344                      WF_XO_REQ, WF_TOP_CLK, WF_TOP_DATA, WF_HB1, WF_HB2, WF_HB3,
 345                      WF_HB4, WF_HB0, WF_HB0_B, WF_HB5, WF_HB6, WF_HB7, WF_HB8,
 346                      WF_HB9, WF_HB10]
 347             maxItems: 57
 348
 349           bias-disable: true
 350
 351           bias-pull-up:
 352             oneOf:
 353               - type: boolean
 354                 description: normal pull up.
 355               - enum: [100, 101, 102, 103]
 356                 description:
 357                   PUPD/R1/R0 pull down type. See MTK_PUPD_SET_R1R0 defines in
 358                   dt-bindings/pinctrl/mt65xx.h.
 359
 360           bias-pull-down:
 361             oneOf:
 362               - type: boolean
 363                 description: normal pull down.
 364               - enum: [100, 101, 102, 103]
 365                 description:
 366                   PUPD/R1/R0 pull down type. See MTK_PUPD_SET_R1R0 defines in
 367                   dt-bindings/pinctrl/mt65xx.h.
 368
 369           input-enable: true
 370
 371           input-disable: true
 372
 373           output-enable: true
 374
 375           output-low: true
 376
 377           output-high: true
 378
 379           input-schmitt-enable: true
 380
 381           input-schmitt-disable: true
 382
 383           drive-strength:
 384             enum: [2, 4, 6, 8, 10, 12, 14, 16]
 385
 386           mediatek,pull-up-adv:
 387             description: |
 388               Valid arguments for 'mediatek,pull-up-adv' are '0', '1', '2', '3'
 389               Pull up settings for 2 pull resistors, R0 and R1. Valid arguments
 390               are described as below:
 391               0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
 392               1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
 393               2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
 394               3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
 395             $ref: /schemas/types.yaml#/definitions/uint32
 396             enum: [0, 1, 2, 3]
 397
 398           mediatek,pull-down-adv:
 399             description: |
 400               Valid arguments for 'mediatek,pull-up-adv' are '0', '1', '2', '3'
 401               Pull down settings for 2 pull resistors, R0 and R1. Valid arguments
 402               are described as below:
 403               0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
 404               1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
 405               2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
 406               3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
 407             $ref: /schemas/types.yaml#/definitions/uint32
 408             enum: [0, 1, 2, 3]
 409
 410         required:
 411           - pins
 412
 413 additionalProperties: false
 414
 415 examples:
 416   - |
 417     #include <dt-bindings/interrupt-controller/irq.h>
 418     #include <dt-bindings/interrupt-controller/arm-gic.h>
 419     #include <dt-bindings/pinctrl/mt65xx.h>
 420
 421     soc {
 422       #address-cells = <2>;
 423       #size-cells = <2>;
 424       pio: pinctrl@11d00000 {
 425         compatible = "mediatek,mt7981-pinctrl";
 426         reg = <0 0x11d00000 0 0x1000>,
 427               <0 0x11c00000 0 0x1000>,
 428               <0 0x11c10000 0 0x1000>,
 429               <0 0x11d20000 0 0x1000>,
 430               <0 0x11e00000 0 0x1000>,
 431               <0 0x11e20000 0 0x1000>,
 432               <0 0x11f00000 0 0x1000>,
 433               <0 0x11f10000 0 0x1000>,
 434               <0 0x1000b000 0 0x1000>;
 435         reg-names = "gpio", "iocfg_rt", "iocfg_rm",
 436                     "iocfg_rb", "iocfg_lb", "iocfg_bl",
 437                     "iocfg_tm", "iocfg_tl", "eint";
 438         gpio-controller;
 439         #gpio-cells = <2>;
 440         gpio-ranges = <&pio 0 0 56>;
 441         interrupt-controller;
 442         interrupts = <GIC_SPI 225 IRQ_TYPE_LEVEL_HIGH>;
 443         interrupt-parent = <&gic>;
 444         #interrupt-cells = <2>;
 445
 446         mdio_pins: mdio-pins {
 447           mux {
 448             function = "eth";
 449             groups = "smi_mdc_mdio";
 450           };
 451         };
 452
 453         spi0_flash_pins: spi0-pins {
 454           mux {
 455             function = "spi";
 456             groups = "spi0", "spi0_wp_hold";
 457           };
 458
 459           conf-pu {
 460             pins = "SPI0_CS", "SPI0_HOLD", "SPI0_WP";
 461             drive-strength = <MTK_DRIVE_8mA>;
 462             bias-pull-up = <MTK_PUPD_SET_R1R0_11>;
 463           };
 464
 465           conf-pd {
 466             pins = "SPI0_CLK", "SPI0_MOSI", "SPI0_MISO";
 467             drive-strength = <MTK_DRIVE_8mA>;
 468             bias-pull-down = <MTK_PUPD_SET_R1R0_11>;
 469           };
 470         };
 471
 472         pcie_pins: pcie-pins {
 473           mux {
 474             function = "pcie";
 475             groups = "pcie_clk", "pcie_wake", "pcie_pereset";
 476           };
 477         };
 478
 479       };
 480     };