162306a36Sopenharmony_ci# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
262306a36Sopenharmony_ci%YAML 1.2
362306a36Sopenharmony_ci---
462306a36Sopenharmony_ci$id: http://devicetree.org/schemas/pinctrl/mediatek,mt8195-pinctrl.yaml#
562306a36Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
662306a36Sopenharmony_ci
762306a36Sopenharmony_cititle: MediaTek MT8195 Pin Controller
862306a36Sopenharmony_ci
962306a36Sopenharmony_cimaintainers:
1062306a36Sopenharmony_ci  - Sean Wang <sean.wang@mediatek.com>
1162306a36Sopenharmony_ci
1262306a36Sopenharmony_cidescription:
1362306a36Sopenharmony_ci  The MediaTek's MT8195 Pin controller is used to control SoC pins.
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ciproperties:
1662306a36Sopenharmony_ci  compatible:
1762306a36Sopenharmony_ci    const: mediatek,mt8195-pinctrl
1862306a36Sopenharmony_ci
1962306a36Sopenharmony_ci  gpio-controller: true
2062306a36Sopenharmony_ci
2162306a36Sopenharmony_ci  '#gpio-cells':
2262306a36Sopenharmony_ci    description:
2362306a36Sopenharmony_ci      Number of cells in GPIO specifier. Since the generic GPIO binding is used,
2462306a36Sopenharmony_ci      the amount of cells must be specified as 2. See the below mentioned gpio
2562306a36Sopenharmony_ci      binding representation for description of particular cells.
2662306a36Sopenharmony_ci    const: 2
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci  gpio-ranges:
2962306a36Sopenharmony_ci    description: GPIO valid number range.
3062306a36Sopenharmony_ci    maxItems: 1
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ci  gpio-line-names: true
3362306a36Sopenharmony_ci
3462306a36Sopenharmony_ci  reg:
3562306a36Sopenharmony_ci    description:
3662306a36Sopenharmony_ci      Physical address base for GPIO base registers. There are 8 GPIO physical
3762306a36Sopenharmony_ci      address base in mt8195.
3862306a36Sopenharmony_ci    maxItems: 8
3962306a36Sopenharmony_ci
4062306a36Sopenharmony_ci  reg-names:
4162306a36Sopenharmony_ci    description:
4262306a36Sopenharmony_ci      GPIO base register names.
4362306a36Sopenharmony_ci    maxItems: 8
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci  interrupt-controller: true
4662306a36Sopenharmony_ci
4762306a36Sopenharmony_ci  '#interrupt-cells':
4862306a36Sopenharmony_ci    const: 2
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_ci  interrupts:
5162306a36Sopenharmony_ci    description: The interrupt outputs to sysirq.
5262306a36Sopenharmony_ci    maxItems: 1
5362306a36Sopenharmony_ci
5462306a36Sopenharmony_ci  mediatek,rsel-resistance-in-si-unit:
5562306a36Sopenharmony_ci    type: boolean
5662306a36Sopenharmony_ci    description:
5762306a36Sopenharmony_ci      Identifying i2c pins pull up/down type which is RSEL. It can support RSEL
5862306a36Sopenharmony_ci      define or si unit value(ohm) to set different resistance.
5962306a36Sopenharmony_ci
6062306a36Sopenharmony_ci# PIN CONFIGURATION NODES
6162306a36Sopenharmony_cipatternProperties:
6262306a36Sopenharmony_ci  '-pins$':
6362306a36Sopenharmony_ci    type: object
6462306a36Sopenharmony_ci    additionalProperties: false
6562306a36Sopenharmony_ci    patternProperties:
6662306a36Sopenharmony_ci      '^pins':
6762306a36Sopenharmony_ci        type: object
6862306a36Sopenharmony_ci        additionalProperties: false
6962306a36Sopenharmony_ci        description: |
7062306a36Sopenharmony_ci          A pinctrl node should contain at least one subnodes representing the
7162306a36Sopenharmony_ci          pinctrl groups available on the machine. Each subnode will list the
7262306a36Sopenharmony_ci          pins it needs, and how they should be configured, with regard to muxer
7362306a36Sopenharmony_ci          configuration, pullups, drive strength, input enable/disable and input
7462306a36Sopenharmony_ci          schmitt.
7562306a36Sopenharmony_ci          An example of using macro:
7662306a36Sopenharmony_ci          pincontroller {
7762306a36Sopenharmony_ci            /* GPIO0 set as multifunction GPIO0 */
7862306a36Sopenharmony_ci            gpio-pins {
7962306a36Sopenharmony_ci              pins {
8062306a36Sopenharmony_ci                pinmux = <PINMUX_GPIO0__FUNC_GPIO0>;
8162306a36Sopenharmony_ci              }
8262306a36Sopenharmony_ci            };
8362306a36Sopenharmony_ci            /* GPIO8 set as multifunction SDA0 */
8462306a36Sopenharmony_ci            i2c0-pins {
8562306a36Sopenharmony_ci              pins {
8662306a36Sopenharmony_ci                pinmux = <PINMUX_GPIO8__FUNC_SDA0>;
8762306a36Sopenharmony_ci              }
8862306a36Sopenharmony_ci            };
8962306a36Sopenharmony_ci          };
9062306a36Sopenharmony_ci        $ref: pinmux-node.yaml
9162306a36Sopenharmony_ci
9262306a36Sopenharmony_ci        properties:
9362306a36Sopenharmony_ci          pinmux:
9462306a36Sopenharmony_ci            description:
9562306a36Sopenharmony_ci              Integer array, represents gpio pin number and mux setting.
9662306a36Sopenharmony_ci              Supported pin number and mux varies for different SoCs, and are
9762306a36Sopenharmony_ci              defined as macros in dt-bindings/pinctrl/<soc>-pinfunc.h directly.
9862306a36Sopenharmony_ci
9962306a36Sopenharmony_ci          drive-strength:
10062306a36Sopenharmony_ci            enum: [2, 4, 6, 8, 10, 12, 14, 16]
10162306a36Sopenharmony_ci
10262306a36Sopenharmony_ci          drive-strength-microamp:
10362306a36Sopenharmony_ci            enum: [125, 250, 500, 1000]
10462306a36Sopenharmony_ci
10562306a36Sopenharmony_ci          bias-pull-down:
10662306a36Sopenharmony_ci            oneOf:
10762306a36Sopenharmony_ci              - type: boolean
10862306a36Sopenharmony_ci              - enum: [100, 101, 102, 103]
10962306a36Sopenharmony_ci                description: mt8195 pull down PUPD/R0/R1 type define value.
11062306a36Sopenharmony_ci              - enum: [200, 201, 202, 203, 204, 205, 206, 207]
11162306a36Sopenharmony_ci                description: mt8195 pull down RSEL type define value.
11262306a36Sopenharmony_ci              - enum: [75000, 5000]
11362306a36Sopenharmony_ci                description: mt8195 pull down RSEL type si unit value(ohm).
11462306a36Sopenharmony_ci            description: |
11562306a36Sopenharmony_ci              For pull down type is normal, it don't need add RSEL & R1R0 define
11662306a36Sopenharmony_ci              and resistance value.
11762306a36Sopenharmony_ci              For pull down type is PUPD/R0/R1 type, it can add R1R0 define to
11862306a36Sopenharmony_ci              set different resistance. It can support "MTK_PUPD_SET_R1R0_00" &
11962306a36Sopenharmony_ci              "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" &
12062306a36Sopenharmony_ci              "MTK_PUPD_SET_R1R0_11" define in mt8195.
12162306a36Sopenharmony_ci              For pull down type is RSEL, it can add RSEL define & resistance
12262306a36Sopenharmony_ci              value(ohm) to set different resistance by identifying property
12362306a36Sopenharmony_ci              "mediatek,rsel-resistance-in-si-unit".
12462306a36Sopenharmony_ci              It can support "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001"
12562306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011"
12662306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_100" & "MTK_PULL_SET_RSEL_101"
12762306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_110" & "MTK_PULL_SET_RSEL_111"
12862306a36Sopenharmony_ci              define in mt8195. It can also support resistance value(ohm)
12962306a36Sopenharmony_ci              "75000" & "5000" in mt8195.
13062306a36Sopenharmony_ci
13162306a36Sopenharmony_ci              An example of using RSEL define:
13262306a36Sopenharmony_ci              pincontroller {
13362306a36Sopenharmony_ci                i2c0_pin {
13462306a36Sopenharmony_ci                  pins {
13562306a36Sopenharmony_ci                    pinmux = <PINMUX_GPIO8__FUNC_SDA0>;
13662306a36Sopenharmony_ci                    bias-pull-down = <MTK_PULL_SET_RSEL_001>;
13762306a36Sopenharmony_ci                  }
13862306a36Sopenharmony_ci                };
13962306a36Sopenharmony_ci              };
14062306a36Sopenharmony_ci              An example of using si unit resistance value(ohm):
14162306a36Sopenharmony_ci              &pio {
14262306a36Sopenharmony_ci                mediatek,rsel-resistance-in-si-unit;
14362306a36Sopenharmony_ci              }
14462306a36Sopenharmony_ci              pincontroller {
14562306a36Sopenharmony_ci                i2c0_pin {
14662306a36Sopenharmony_ci                  pins {
14762306a36Sopenharmony_ci                    pinmux = <PINMUX_GPIO8__FUNC_SDA0>;
14862306a36Sopenharmony_ci                    bias-pull-down = <75000>;
14962306a36Sopenharmony_ci                  }
15062306a36Sopenharmony_ci                };
15162306a36Sopenharmony_ci              };
15262306a36Sopenharmony_ci
15362306a36Sopenharmony_ci          bias-pull-up:
15462306a36Sopenharmony_ci            oneOf:
15562306a36Sopenharmony_ci              - type: boolean
15662306a36Sopenharmony_ci              - enum: [100, 101, 102, 103]
15762306a36Sopenharmony_ci                description: mt8195 pull up PUPD/R0/R1 type define value.
15862306a36Sopenharmony_ci              - enum: [200, 201, 202, 203, 204, 205, 206, 207]
15962306a36Sopenharmony_ci                description: mt8195 pull up RSEL type define value.
16062306a36Sopenharmony_ci              - enum: [1000, 1500, 2000, 3000, 4000, 5000, 10000, 75000]
16162306a36Sopenharmony_ci                description: mt8195 pull up RSEL type si unit value(ohm).
16262306a36Sopenharmony_ci            description: |
16362306a36Sopenharmony_ci              For pull up type is normal, it don't need add RSEL & R1R0 define
16462306a36Sopenharmony_ci              and resistance value.
16562306a36Sopenharmony_ci              For pull up type is PUPD/R0/R1 type, it can add R1R0 define to
16662306a36Sopenharmony_ci              set different resistance. It can support "MTK_PUPD_SET_R1R0_00" &
16762306a36Sopenharmony_ci              "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" &
16862306a36Sopenharmony_ci              "MTK_PUPD_SET_R1R0_11" define in mt8195.
16962306a36Sopenharmony_ci              For pull up type is RSEL, it can add RSEL define & resistance
17062306a36Sopenharmony_ci              value(ohm) to set different resistance by identifying property
17162306a36Sopenharmony_ci              "mediatek,rsel-resistance-in-si-unit".
17262306a36Sopenharmony_ci              It can support "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001"
17362306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011"
17462306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_100" & "MTK_PULL_SET_RSEL_101"
17562306a36Sopenharmony_ci              & "MTK_PULL_SET_RSEL_110" & "MTK_PULL_SET_RSEL_111"
17662306a36Sopenharmony_ci              define in mt8195. It can also support resistance value(ohm) "1000"
17762306a36Sopenharmony_ci              & "1500" & "2000" & "3000" & "4000" & "5000" & "10000" & "75000"
17862306a36Sopenharmony_ci              in mt8195.
17962306a36Sopenharmony_ci              An example of using RSEL define:
18062306a36Sopenharmony_ci              pincontroller {
18162306a36Sopenharmony_ci                i2c0-pins {
18262306a36Sopenharmony_ci                  pins {
18362306a36Sopenharmony_ci                    pinmux = <PINMUX_GPIO8__FUNC_SDA0>;
18462306a36Sopenharmony_ci                    bias-pull-up = <MTK_PULL_SET_RSEL_001>;
18562306a36Sopenharmony_ci                  }
18662306a36Sopenharmony_ci                };
18762306a36Sopenharmony_ci              };
18862306a36Sopenharmony_ci              An example of using si unit resistance value(ohm):
18962306a36Sopenharmony_ci              &pio {
19062306a36Sopenharmony_ci                mediatek,rsel-resistance-in-si-unit;
19162306a36Sopenharmony_ci              }
19262306a36Sopenharmony_ci              pincontroller {
19362306a36Sopenharmony_ci                i2c0-pins {
19462306a36Sopenharmony_ci                  pins {
19562306a36Sopenharmony_ci                    pinmux = <PINMUX_GPIO8__FUNC_SDA0>;
19662306a36Sopenharmony_ci                    bias-pull-up = <1000>;
19762306a36Sopenharmony_ci                  }
19862306a36Sopenharmony_ci                };
19962306a36Sopenharmony_ci              };
20062306a36Sopenharmony_ci
20162306a36Sopenharmony_ci          bias-disable: true
20262306a36Sopenharmony_ci
20362306a36Sopenharmony_ci          output-high: true
20462306a36Sopenharmony_ci
20562306a36Sopenharmony_ci          output-low: true
20662306a36Sopenharmony_ci
20762306a36Sopenharmony_ci          input-enable: true
20862306a36Sopenharmony_ci
20962306a36Sopenharmony_ci          input-disable: true
21062306a36Sopenharmony_ci
21162306a36Sopenharmony_ci          input-schmitt-enable: true
21262306a36Sopenharmony_ci
21362306a36Sopenharmony_ci          input-schmitt-disable: true
21462306a36Sopenharmony_ci
21562306a36Sopenharmony_ci        required:
21662306a36Sopenharmony_ci          - pinmux
21762306a36Sopenharmony_ci
21862306a36Sopenharmony_ciallOf:
21962306a36Sopenharmony_ci  - $ref: pinctrl.yaml#
22062306a36Sopenharmony_ci
22162306a36Sopenharmony_cirequired:
22262306a36Sopenharmony_ci  - compatible
22362306a36Sopenharmony_ci  - reg
22462306a36Sopenharmony_ci  - interrupts
22562306a36Sopenharmony_ci  - interrupt-controller
22662306a36Sopenharmony_ci  - '#interrupt-cells'
22762306a36Sopenharmony_ci  - gpio-controller
22862306a36Sopenharmony_ci  - '#gpio-cells'
22962306a36Sopenharmony_ci  - gpio-ranges
23062306a36Sopenharmony_ci
23162306a36Sopenharmony_ciadditionalProperties: false
23262306a36Sopenharmony_ci
23362306a36Sopenharmony_ciexamples:
23462306a36Sopenharmony_ci  - |
23562306a36Sopenharmony_ci    #include <dt-bindings/pinctrl/mt8195-pinfunc.h>
23662306a36Sopenharmony_ci    #include <dt-bindings/interrupt-controller/arm-gic.h>
23762306a36Sopenharmony_ci    #
23862306a36Sopenharmony_ci    pio: pinctrl@10005000 {
23962306a36Sopenharmony_ci      compatible = "mediatek,mt8195-pinctrl";
24062306a36Sopenharmony_ci      reg = <0x10005000 0x1000>,
24162306a36Sopenharmony_ci            <0x11d10000 0x1000>,
24262306a36Sopenharmony_ci            <0x11d30000 0x1000>,
24362306a36Sopenharmony_ci            <0x11d40000 0x1000>,
24462306a36Sopenharmony_ci            <0x11e20000 0x1000>,
24562306a36Sopenharmony_ci            <0x11eb0000 0x1000>,
24662306a36Sopenharmony_ci            <0x11f40000 0x1000>,
24762306a36Sopenharmony_ci            <0x1000b000 0x1000>;
24862306a36Sopenharmony_ci      reg-names = "iocfg0", "iocfg_bm", "iocfg_bl",
24962306a36Sopenharmony_ci                  "iocfg_br", "iocfg_lm", "iocfg_rb",
25062306a36Sopenharmony_ci                  "iocfg_tl", "eint";
25162306a36Sopenharmony_ci      gpio-controller;
25262306a36Sopenharmony_ci      #gpio-cells = <2>;
25362306a36Sopenharmony_ci      gpio-ranges = <&pio 0 0 144>;
25462306a36Sopenharmony_ci      interrupt-controller;
25562306a36Sopenharmony_ci      interrupts = <GIC_SPI 225 IRQ_TYPE_LEVEL_HIGH 0>;
25662306a36Sopenharmony_ci      #interrupt-cells = <2>;
25762306a36Sopenharmony_ci
25862306a36Sopenharmony_ci      pio-pins {
25962306a36Sopenharmony_ci        pins {
26062306a36Sopenharmony_ci          pinmux = <PINMUX_GPIO0__FUNC_GPIO0>;
26162306a36Sopenharmony_ci          output-low;
26262306a36Sopenharmony_ci        };
26362306a36Sopenharmony_ci      };
26462306a36Sopenharmony_ci
26562306a36Sopenharmony_ci      spi0-pins {
26662306a36Sopenharmony_ci        pins-spi {
26762306a36Sopenharmony_ci          pinmux = <PINMUX_GPIO132__FUNC_SPIM0_CSB>,
26862306a36Sopenharmony_ci                   <PINMUX_GPIO134__FUNC_SPIM0_MO>,
26962306a36Sopenharmony_ci                   <PINMUX_GPIO133__FUNC_SPIM0_CLK>;
27062306a36Sopenharmony_ci          bias-disable;
27162306a36Sopenharmony_ci        };
27262306a36Sopenharmony_ci        pins-spi-mi {
27362306a36Sopenharmony_ci          pinmux = <PINMUX_GPIO135__FUNC_SPIM0_MI>;
27462306a36Sopenharmony_ci          bias-pull-down;
27562306a36Sopenharmony_ci        };
27662306a36Sopenharmony_ci      };
27762306a36Sopenharmony_ci
27862306a36Sopenharmony_ci      i2c0-pins {
27962306a36Sopenharmony_ci        pins {
28062306a36Sopenharmony_ci          pinmux = <PINMUX_GPIO8__FUNC_SDA0>,
28162306a36Sopenharmony_ci                   <PINMUX_GPIO9__FUNC_SCL0>;
28262306a36Sopenharmony_ci          bias-disable;
28362306a36Sopenharmony_ci          drive-strength-microamp = <1000>;
28462306a36Sopenharmony_ci        };
28562306a36Sopenharmony_ci      };
28662306a36Sopenharmony_ci    };
287