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,mt7986-pinctrl.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Mediatek MT7986 Pin Controller Device Tree Bindings
8
9maintainers:
10  - Sean Wang <sean.wang@kernel.org>
11
12description: |+
13  The MediaTek's MT7986 Pin controller is used to control SoC pins.
14
15properties:
16  compatible:
17    enum:
18      - mediatek,mt7986a-pinctrl
19      - mediatek,mt7986b-pinctrl
20
21  reg:
22    minItems: 8
23    maxItems: 8
24
25  reg-names:
26    items:
27      - const: gpio
28      - const: iocfg_rt
29      - const: iocfg_rb
30      - const: iocfg_lt
31      - const: iocfg_lb
32      - const: iocfg_tr
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
42      binding is used, the amount of cells must be specified as 2. See the below
43      mentioned gpio binding representation for description of particular cells.
44
45  gpio-ranges:
46    minItems: 1
47    maxItems: 5
48    description: |
49      GPIO valid number range.
50
51  interrupt-controller: true
52
53  interrupts:
54    maxItems: 1
55
56  "#interrupt-cells":
57    const: 2
58
59allOf:
60  - $ref: "pinctrl.yaml#"
61
62required:
63  - compatible
64  - reg
65  - reg-names
66  - gpio-controller
67  - "#gpio-cells"
68
69patternProperties:
70  '-pins$':
71    type: object
72    additionalProperties: false
73
74    patternProperties:
75      '.*mux.*':
76        type: object
77        additionalProperties: false
78        description: |
79          pinmux configuration nodes.
80
81          The following table shows the effective values of "group", "function"
82          properties and chip pinout pins
83
84          groups	    function    pins (in pin#)
85          ---------------------------------------------------------------------
86          "watchdog"        "watchdog"  0
87          "wifi_led"        "led"       1, 2
88          "i2c"             "i2c"       3, 4
89          "uart1_0"         "uart"      7, 8, 9, 10
90          "pcie_clk"        "pcie"      9
91          "pcie_wake"       "pcie"      10
92          "spi1_0"          "spi"       11, 12, 13, 14
93          "pwm1_1"          "pwm"       20,
94          "pwm0"            "pwm"       21,
95          "pwm1_0"          "pwm"       22,
96          "snfi"            "flash"     23, 24, 25, 26, 27, 28
97          "spi1_2"          "spi"       29, 30, 31, 32
98          "emmc_45"         "emmc"      22, 23, 24, 25, 26, 27, 28, 29, 30,
99                                        31, 32
100          "spi1_1"          "spi"       23, 24, 25, 26
101          "uart1_2"         "uart"      29, 30, 31, 32
102          "uart1_1"         "uart"      23, 24, 25, 26
103          "uart2_0"         "uart"      29, 30, 31, 32
104          "spi0"            "spi"       33, 34, 35, 36
105          "spi0_wp_hold"    "spi"       37, 38
106          "uart1_3_rx_tx"   "uart"      35, 36
107          "uart1_3_cts_rts" "uart"      37, 38
108          "uart2_1"         "uart"      33, 34, 35, 36
109          "spi1_3"          "spi"       33, 34, 35, 36
110          "uart0"           "uart"      39, 40
111          "pcie_pereset"    "pcie"      41
112          "uart1"           "uart"      42, 43, 44, 45
113          "uart2"           "uart"      46, 47, 48, 49
114          "emmc_51"         "emmc"      50, 51, 52, 53, 54, 55, 56, 57, 57,
115                                        59, 60, 61
116          "pcm"             "audio"     62, 63, 64, 65
117          "i2s"             "audio"     62, 63, 64, 65
118          "switch_int"      "eth"       66
119          "mdc_mdio"        "eth"       67
120
121        $ref: "/schemas/pinctrl/pinmux-node.yaml"
122        properties:
123          function:
124            description: |
125              A string containing the name of the function to mux to the group.
126              There is no "audio", "pcie" functions on mt7986b, you can only use
127              those functions on mt7986a.
128            enum: [audio, emmc, eth, i2c, led, flash, pcie, pwm, spi, uart,
129                   watchdog, wifi]
130          groups:
131            description: |
132              An array of strings. Each string contains the name of a group.
133              There is no "pcie_pereset", "uart1", "uart2" "emmc_51", "pcm",
134              and "i2s" groups on mt7986b, you can only use those groups on
135              mt7986a.
136        required:
137          - function
138          - groups
139
140        allOf:
141          - if:
142              properties:
143                function:
144                  const: audio
145            then:
146              properties:
147                groups:
148                  enum: [pcm, i2s]
149          - if:
150              properties:
151                function:
152                  const: emmc
153            then:
154              properties:
155                groups:
156                  enum: [emmc, emmc_rst]
157          - if:
158              properties:
159                function:
160                  const: eth
161            then:
162              properties:
163                groups:
164                  enum: [switch_int, mdc_mdio]
165          - if:
166              properties:
167                function:
168                  const: i2c
169            then:
170              properties:
171                groups:
172                  enum: [i2c]
173          - if:
174              properties:
175                function:
176                  const: led
177            then:
178              properties:
179                groups:
180                  enum: [wifi_led]
181          - if:
182              properties:
183                function:
184                  const: flash
185            then:
186              properties:
187                groups:
188                  enum: [snfi]
189          - if:
190              properties:
191                function:
192                  const: pcie
193            then:
194              properties:
195                groups:
196                  enum: [pcie_clk, pcie_wake, pcie_pereset]
197          - if:
198              properties:
199                function:
200                  const: pwm
201            then:
202              properties:
203                groups:
204                  enum: [pwm0, pwm1_0, pwm1_1]
205          - if:
206              properties:
207                function:
208                  const: spi
209            then:
210              properties:
211                groups:
212                  enum: [spi0, spi0_wp_hold, spi1_0, spi1_1, spi1_2, spi1_3]
213          - if:
214              properties:
215                function:
216                  const: uart
217            then:
218              properties:
219                groups:
220                  enum: [uart1_0, uart1_1, uart1_2, uart1_3_rx_tx,
221                         uart1_3_cts_rts, uart2_0, uart2_1, uart0, uart1, uart2]
222          - if:
223              properties:
224                function:
225                  const: watchdog
226            then:
227              properties:
228                groups:
229                  enum: [watchdog]
230          - if:
231              properties:
232                function:
233                  const: wifi
234            then:
235              properties:
236                groups:
237                  enum: [wf_2g, wf_5g, wf_dbdc]
238      '.*conf.*':
239        type: object
240        additionalProperties: false
241        description: |
242          pinconf configuration nodes.
243        $ref: "/schemas/pinctrl/pincfg-node.yaml"
244
245        properties:
246          pins:
247            description: |
248              An array of strings. Each string contains the name of a pin.
249              There is no PIN 41 to PIN 65 above on mt7686b, you can only use
250              those pins on mt7986a.
251            enum: [SYS_WATCHDOG, WF2G_LED, WF5G_LED, I2C_SCL, I2C_SDA, GPIO_0,
252                   GPIO_1, GPIO_2, GPIO_3, GPIO_4, GPIO_5, GPIO_6, GPIO_7,
253                   GPIO_8, GPIO_9, GPIO_10, GPIO_11, GPIO_12, GPIO_13, GPIO_14,
254                   GPIO_15, PWM0, PWM1, SPI0_CLK, SPI0_MOSI, SPI0_MISO, SPI0_CS,
255                   SPI0_HOLD, SPI0_WP, SPI1_CLK, SPI1_MOSI, SPI1_MISO, SPI1_CS,
256                   SPI2_CLK, SPI2_MOSI, SPI2_MISO, SPI2_CS, SPI2_HOLD, SPI2_WP,
257                   UART0_RXD, UART0_TXD, PCIE_PERESET_N, UART1_RXD, UART1_TXD,
258                   UART1_CTS, UART1_RTS, UART2_RXD, UART2_TXD, UART2_CTS,
259                   UART2_RTS, EMMC_DATA_0, EMMC_DATA_1, EMMC_DATA_2,
260                   EMMC_DATA_3, EMMC_DATA_4, EMMC_DATA_5, EMMC_DATA_6,
261                   EMMC_DATA_7, EMMC_CMD, EMMC_CK, EMMC_DSL, EMMC_RSTB, PCM_DTX,
262                   PCM_DRX, PCM_CLK, PCM_FS, MT7531_INT, SMI_MDC, SMI_MDIO,
263                   WF0_DIG_RESETB, WF0_CBA_RESETB, WF0_XO_REQ, WF0_TOP_CLK,
264                   WF0_TOP_DATA, WF0_HB1, WF0_HB2, WF0_HB3, WF0_HB4, WF0_HB0,
265                   WF0_HB0_B, WF0_HB5, WF0_HB6, WF0_HB7, WF0_HB8, WF0_HB9,
266                   WF0_HB10, WF1_DIG_RESETB, WF1_CBA_RESETB, WF1_XO_REQ,
267                   WF1_TOP_CLK, WF1_TOP_DATA, WF1_HB1, WF1_HB2, WF1_HB3,
268                   WF1_HB4, WF1_HB0, WF1_HB0_B, WF1_HB5, WF1_HB6, WF1_HB7,
269                   WF1_HB8]
270
271          bias-disable: true
272
273          bias-pull-up: true
274
275          bias-pull-down: true
276
277          input-enable: true
278
279          input-disable: true
280
281          output-enable: true
282
283          output-low: true
284
285          output-high: true
286
287          input-schmitt-enable: true
288
289          input-schmitt-disable: true
290
291          drive-strength:
292            enum: [2, 4, 6, 8, 10, 12, 14, 16]
293
294          mediatek,pull-up-adv:
295            description: |
296              Valid arguments for 'mediatek,pull-up-adv' are '0', '1', '2', '3'
297              Pull up setings for 2 pull resistors, R0 and R1. Valid arguments
298              are described as below:
299              0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
300              1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
301              2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
302              3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
303            $ref: /schemas/types.yaml#/definitions/uint32
304            enum: [0, 1, 2, 3]
305
306          mediatek,pull-down-adv:
307            description: |
308              Valid arguments for 'mediatek,pull-up-adv' are '0', '1', '2', '3'
309              Pull down setings for 2 pull resistors, R0 and R1. Valid arguments
310              are described as below:
311              0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
312              1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
313              2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
314              3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
315            $ref: /schemas/types.yaml#/definitions/uint32
316            enum: [0, 1, 2, 3]
317
318        required:
319          - pins
320
321additionalProperties: false
322
323examples:
324  - |
325    #include <dt-bindings/interrupt-controller/irq.h>
326    #include <dt-bindings/interrupt-controller/arm-gic.h>
327
328    soc {
329      #address-cells = <2>;
330      #size-cells = <2>;
331      pio: pinctrl@1001f000 {
332        compatible = "mediatek,mt7986a-pinctrl";
333        reg = <0 0x1001f000 0 0x1000>,
334              <0 0x11c30000 0 0x1000>,
335              <0 0x11c40000 0 0x1000>,
336              <0 0x11e20000 0 0x1000>,
337              <0 0x11e30000 0 0x1000>,
338              <0 0x11f00000 0 0x1000>,
339              <0 0x11f10000 0 0x1000>,
340              <0 0x1000b000 0 0x1000>;
341        reg-names = "gpio", "iocfg_rt", "iocfg_rb", "iocfg_lt",
342                    "iocfg_lb", "iocfg_tr", "iocfg_tl", "eint";
343        gpio-controller;
344        #gpio-cells = <2>;
345        gpio-ranges = <&pio 0 0 100>;
346        interrupt-controller;
347        interrupts = <GIC_SPI 225 IRQ_TYPE_LEVEL_HIGH>;
348        interrupt-parent = <&gic>;
349        #interrupt-cells = <2>;
350
351        uart1_pins: uart1-pins {
352          mux {
353            function = "uart";
354            groups = "uart1";
355          };
356        };
357
358        uart2_pins: uart2-pins {
359          mux {
360            function = "uart";
361            groups = "uart2";
362          };
363        };
364
365      };
366    };
367