1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/pinctrl/pinctrl-mt8186.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Mediatek MT8186 Pin Controller 8 9maintainers: 10 - Sean Wang <sean.wang@mediatek.com> 11 12description: | 13 The Mediatek's Pin controller is used to control SoC pins. 14 15properties: 16 compatible: 17 const: mediatek,mt8186-pinctrl 18 19 gpio-controller: true 20 21 '#gpio-cells': 22 description: | 23 Number of cells in GPIO specifier. Since the generic GPIO binding is used, 24 the amount of cells must be specified as 2. See the below 25 mentioned gpio binding representation for description of particular cells. 26 const: 2 27 28 gpio-ranges: 29 maxItems: 1 30 31 reg: 32 description: | 33 Physical address base for gpio base registers. There are 8 different GPIO 34 physical address base in mt8186. 35 maxItems: 8 36 37 reg-names: 38 description: | 39 Gpio base register names. 40 items: 41 - const: iocfg0 42 - const: iocfg_bm 43 - const: iocfg_bl 44 - const: iocfg_br 45 - const: iocfg_lm 46 - const: iocfg_rb 47 - const: iocfg_tl 48 - const: eint 49 50 interrupt-controller: true 51 52 '#interrupt-cells': 53 const: 2 54 55 interrupts: 56 description: The interrupt outputs to sysirq 57 maxItems: 1 58 59 mediatek,rsel-resistance-in-si-unit: 60 type: boolean 61 description: | 62 Identifying i2c pins pull up/down type which is RSEL. It can support 63 RSEL define or si unit value(ohm) to set different resistance. 64 65# PIN CONFIGURATION NODES 66patternProperties: 67 '-pins$': 68 type: object 69 additionalProperties: false 70 patternProperties: 71 '^pins': 72 type: object 73 additionalProperties: false 74 description: | 75 A pinctrl node should contain at least one subnodes representing the 76 pinctrl groups available on the machine. Each subnode will list the 77 pins it needs, and how they should be configured, with regard to muxer 78 configuration, pullups, drive strength, input enable/disable and 79 input schmitt. 80 An example of using macro: 81 pincontroller { 82 /* GPIO0 set as multifunction GPIO0 */ 83 gpio-pins { 84 pins { 85 pinmux = <PINMUX_GPIO0__FUNC_GPIO0>; 86 } 87 }; 88 /* GPIO128 set as multifunction SDA0 */ 89 i2c0-pins { 90 pins { 91 pinmux = <PINMUX_GPIO128__FUNC_SDA0>; 92 } 93 }; 94 }; 95 $ref: "pinmux-node.yaml" 96 97 properties: 98 pinmux: 99 description: | 100 Integer array, represents gpio pin number and mux setting. 101 Supported pin number and mux varies for different SoCs, and are 102 defined as macros in dt-bindings/pinctrl/<soc>-pinfunc.h 103 directly. 104 105 drive-strength: 106 enum: [2, 4, 6, 8, 10, 12, 14, 16] 107 108 mediatek,drive-strength-adv: 109 description: | 110 Describe the specific driving setup property. 111 For I2C pins, the existing generic driving setup can only support 112 2/4/6/8/10/12/14/16mA driving. But in specific driving setup, they 113 can support 0.125/0.25/0.5/1mA adjustment. If we enable specific 114 driving setup, the existing generic setup will be disabled. 115 The specific driving setup is controlled by E1E0EN. 116 When E1=0/E0=0, the strength is 0.125mA. 117 When E1=0/E0=1, the strength is 0.25mA. 118 When E1=1/E0=0, the strength is 0.5mA. 119 When E1=1/E0=1, the strength is 1mA. 120 EN is used to enable or disable the specific driving setup. 121 Valid arguments are described as below: 122 0: (E1, E0, EN) = (0, 0, 0) 123 1: (E1, E0, EN) = (0, 0, 1) 124 2: (E1, E0, EN) = (0, 1, 0) 125 3: (E1, E0, EN) = (0, 1, 1) 126 4: (E1, E0, EN) = (1, 0, 0) 127 5: (E1, E0, EN) = (1, 0, 1) 128 6: (E1, E0, EN) = (1, 1, 0) 129 7: (E1, E0, EN) = (1, 1, 1) 130 So the valid arguments are from 0 to 7. 131 $ref: /schemas/types.yaml#/definitions/uint32 132 enum: [0, 1, 2, 3, 4, 5, 6, 7] 133 134 bias-pull-down: 135 oneOf: 136 - type: boolean 137 - enum: [100, 101, 102, 103] 138 description: mt8186 pull down PUPD/R0/R1 type define value. 139 - enum: [200, 201, 202, 203] 140 description: mt8186 pull down RSEL type define value. 141 - enum: [75000, 5000] 142 description: mt8186 pull down RSEL type si unit value(ohm). 143 description: | 144 For pull down type is normal, it don't need add RSEL & R1R0 define 145 and resistance value. 146 For pull down type is PUPD/R0/R1 type, it can add R1R0 define to 147 set different resistance. It can support "MTK_PUPD_SET_R1R0_00" & 148 "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" & 149 "MTK_PUPD_SET_R1R0_11" define in mt8186. 150 For pull down type is RSEL, it can add RSEL define & resistance 151 value(ohm) to set different resistance by identifying property 152 "mediatek,rsel-resistance-in-si-unit". 153 It can support "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001" 154 & "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011" 155 define in mt8186. It can also support resistance value(ohm) 156 "75000" & "5000" in mt8186. 157 An example of using RSEL define: 158 pincontroller { 159 i2c0_pin { 160 pins { 161 pinmux = <PINMUX_GPIO128__FUNC_SDA0>; 162 bias-pull-down = <MTK_PULL_SET_RSEL_001>; 163 } 164 }; 165 }; 166 An example of using si unit resistance value(ohm): 167 &pio { 168 mediatek,rsel-resistance-in-si-unit; 169 } 170 pincontroller { 171 i2c0_pin { 172 pins { 173 pinmux = <PINMUX_GPIO128__FUNC_SDA0>; 174 bias-pull-down = <75000>; 175 } 176 }; 177 }; 178 179 bias-pull-up: 180 oneOf: 181 - type: boolean 182 - enum: [100, 101, 102, 103] 183 description: mt8186 pull up PUPD/R0/R1 type define value. 184 - enum: [200, 201, 202, 203] 185 description: mt8186 pull up RSEL type define value. 186 - enum: [1000, 5000, 10000, 75000] 187 description: mt8186 pull up RSEL type si unit value(ohm). 188 description: | 189 For pull up type is normal, it don't need add RSEL & R1R0 define 190 and resistance value. 191 For pull up type is PUPD/R0/R1 type, it can add R1R0 define to 192 set different resistance. It can support "MTK_PUPD_SET_R1R0_00" & 193 "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" & 194 "MTK_PUPD_SET_R1R0_11" define in mt8186. 195 For pull up type is RSEL, it can add RSEL define & resistance 196 value(ohm) to set different resistance by identifying property 197 "mediatek,rsel-resistance-in-si-unit". 198 It can support "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001" 199 & "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011" 200 define in mt8186. It can also support resistance value(ohm) 201 "1000" & "5000" & "10000" & "75000" in mt8186. 202 An example of using si unit resistance value(ohm): 203 &pio { 204 mediatek,rsel-resistance-in-si-unit; 205 } 206 pincontroller { 207 i2c0-pins { 208 pins { 209 pinmux = <PINMUX_GPIO128__FUNC_SDA0>; 210 bias-pull-up = <1000>; 211 } 212 }; 213 }; 214 215 bias-disable: true 216 217 output-high: true 218 219 output-low: true 220 221 input-enable: true 222 223 input-disable: true 224 225 input-schmitt-enable: true 226 227 input-schmitt-disable: true 228 229 required: 230 - pinmux 231 232required: 233 - compatible 234 - reg 235 - interrupts 236 - interrupt-controller 237 - '#interrupt-cells' 238 - gpio-controller 239 - '#gpio-cells' 240 - gpio-ranges 241 242additionalProperties: false 243 244examples: 245 - | 246 #include <dt-bindings/pinctrl/mt8186-pinfunc.h> 247 #include <dt-bindings/interrupt-controller/arm-gic.h> 248 249 pio: pinctrl@10005000 { 250 compatible = "mediatek,mt8186-pinctrl"; 251 reg = <0x10005000 0x1000>, 252 <0x10002000 0x0200>, 253 <0x10002200 0x0200>, 254 <0x10002400 0x0200>, 255 <0x10002600 0x0200>, 256 <0x10002A00 0x0200>, 257 <0x10002c00 0x0200>, 258 <0x1000b000 0x1000>; 259 reg-names = "iocfg0", "iocfg_bm", "iocfg_bl", 260 "iocfg_br", "iocfg_lm", "iocfg_rb", 261 "iocfg_tl", "eint"; 262 gpio-controller; 263 #gpio-cells = <2>; 264 gpio-ranges = <&pio 0 0 185>; 265 interrupt-controller; 266 interrupts = <GIC_SPI 186 IRQ_TYPE_LEVEL_HIGH 0>; 267 #interrupt-cells = <2>; 268 269 pio-pins { 270 pins { 271 pinmux = <PINMUX_GPIO0__FUNC_GPIO0>; 272 output-low; 273 }; 274 }; 275 276 spi0-pins { 277 pins-spi { 278 pinmux = <PINMUX_GPIO0__FUNC_SPI0_CLK_B>, 279 <PINMUX_GPIO1__FUNC_SPI0_CSB_B>, 280 <PINMUX_GPIO2__FUNC_SPI0_MO_B>; 281 bias-disable; 282 }; 283 pins-spi-mi { 284 pinmux = <PINMUX_GPIO3__FUNC_SPI0_MI_B>; 285 bias-pull-down; 286 }; 287 }; 288 289 i2c0-pins { 290 pins { 291 pinmux = <PINMUX_GPIO127__FUNC_SCL0>, 292 <PINMUX_GPIO128__FUNC_SDA0>; 293 bias-pull-up = <MTK_PULL_SET_RSEL_001>; 294 mediatek,drive-strength-adv = <7>; 295 }; 296 }; 297 }; 298