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