mediatek,mt8188-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,mt8188-pinctrl.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: MediaTek MT8188 Pin Controller
  8
  9maintainers:
 10  - Hui Liu <hui.liu@mediatek.com>
 11
 12description:
 13  The MediaTek's MT8188 Pin controller is used to control SoC pins.
 14
 15properties:
 16  compatible:
 17    const: mediatek,mt8188-pinctrl
 18
 19  gpio-controller: true
 20
 21  '#gpio-cells':
 22    description:
 23      Number of cells in GPIO specifier, should be two. The first cell is the
 24      pin number, the second cell is used to specify optional parameters which
 25      are defined in <dt-bindings/gpio/gpio.h>.
 26    const: 2
 27
 28  gpio-ranges:
 29    maxItems: 1
 30
 31  gpio-line-names: true
 32
 33  reg:
 34    items:
 35      - description: gpio registers base address
 36      - description: rm group io configuration registers base address
 37      - description: lt group io configuration registers base address
 38      - description: lm group io configuration registers base address
 39      - description: rt group io configuration registers base address
 40      - description: eint registers base address
 41
 42  reg-names:
 43    items:
 44      - const: iocfg0
 45      - const: iocfg_rm
 46      - const: iocfg_lt
 47      - const: iocfg_lm
 48      - const: iocfg_rt
 49      - const: eint
 50
 51  interrupt-controller: true
 52
 53  '#interrupt-cells':
 54    const: 2
 55
 56  interrupts:
 57    description: The interrupt outputs to sysirq.
 58    maxItems: 1
 59
 60  mediatek,rsel-resistance-in-si-unit:
 61    type: boolean
 62    description:
 63      We provide two methods to select the resistance for I2C when pull up or
 64      pull down. The first is by RSEL definition value, another one is by
 65      resistance value(ohm). This flag is used to identify if the method is
 66      resistance(si unit) value.
 67
 68# PIN CONFIGURATION NODES
 69patternProperties:
 70  '-pins$':
 71    type: object
 72    additionalProperties: false
 73
 74    patternProperties:
 75      '^pins':
 76        type: object
 77        $ref: /schemas/pinctrl/pincfg-node.yaml
 78        additionalProperties: false
 79        description:
 80          A pinctrl node should contain at least one subnode representing the
 81          pinctrl groups available on the machine. Each subnode will list the
 82          pins it needs, and how they should be configured, with regard to muxer
 83          configuration, pullups, drive strength, input enable/disable and input
 84          schmitt.
 85
 86        properties:
 87          pinmux:
 88            description:
 89              Integer array, represents gpio pin number and mux setting.
 90              Supported pin number and mux varies for different SoCs, and are
 91              defined as macros in dt-bindings/pinctrl/mediatek,mt8188-pinfunc.h
 92              directly, for this SoC.
 93
 94          drive-strength:
 95            enum: [2, 4, 6, 8, 10, 12, 14, 16]
 96
 97          drive-strength-microamp:
 98            enum: [125, 250, 500, 1000]
 99
100          bias-pull-down:
101            oneOf:
102              - type: boolean
103              - enum: [100, 101, 102, 103]
104                description: mt8188 pull down PUPD/R0/R1 type define value.
105              - enum: [200, 201, 202, 203, 204, 205, 206, 207]
106                description: mt8188 pull down RSEL type define value.
107              - enum: [75000, 5000]
108                description: mt8188 pull down RSEL type si unit value(ohm).
109            description: |
110              For pull down type is normal, it doesn't need add RSEL & R1R0
111              define and resistance value.
112              For pull down type is PUPD/R0/R1 type, it can add R1R0 define to
113              set different resistance. It can support "MTK_PUPD_SET_R1R0_00" &
114              "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" &
115              "MTK_PUPD_SET_R1R0_11" define in mt8188.
116              For pull down type is RSEL, it can add RSEL define & resistance
117              value(ohm) to set different resistance by identifying property
118              "mediatek,rsel-resistance-in-si-unit". It can support
119              "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001" &
120              "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011" &
121              "MTK_PULL_SET_RSEL_100" & "MTK_PULL_SET_RSEL_101" &
122              "MTK_PULL_SET_RSEL_110" & "MTK_PULL_SET_RSEL_111" define in
123              mt8188. It can also support resistance value(ohm) "75000" & "5000"
124              in mt8188.
125
126          bias-pull-up:
127            oneOf:
128              - type: boolean
129              - enum: [100, 101, 102, 103]
130                description: mt8188 pull up PUPD/R0/R1 type define value.
131              - enum: [200, 201, 202, 203, 204, 205, 206, 207]
132                description: mt8188 pull up RSEL type define value.
133              - enum: [1000, 1500, 2000, 3000, 4000, 5000, 10000, 75000]
134                description: mt8188 pull up RSEL type si unit value(ohm).
135            description: |
136              For pull up type is normal, it don't need add RSEL & R1R0 define
137              and resistance value.
138              For pull up type is PUPD/R0/R1 type, it can add R1R0 define to set
139              different resistance. It can support "MTK_PUPD_SET_R1R0_00" &
140              "MTK_PUPD_SET_R1R0_01" & "MTK_PUPD_SET_R1R0_10" &
141              "MTK_PUPD_SET_R1R0_11" define in mt8188.
142              For pull up type is RSEL, it can add RSEL define & resistance
143              value(ohm) to set different resistance by identifying property
144              "mediatek,rsel-resistance-in-si-unit". It can support
145              "MTK_PULL_SET_RSEL_000" & "MTK_PULL_SET_RSEL_001" &
146              "MTK_PULL_SET_RSEL_010" & "MTK_PULL_SET_RSEL_011" &
147              "MTK_PULL_SET_RSEL_100" & "MTK_PULL_SET_RSEL_101" &
148              "MTK_PULL_SET_RSEL_110" & "MTK_PULL_SET_RSEL_111" define in
149              mt8188. It can also support resistance value(ohm) "1000" & "1500"
150              & "2000" & "3000" & "4000" & "5000" & "10000" & "75000" in mt8188.
151
152          bias-disable: true
153
154          output-high: true
155
156          output-low: true
157
158          input-enable: true
159
160          input-disable: true
161
162          input-schmitt-enable: true
163
164          input-schmitt-disable: true
165
166        required:
167          - pinmux
168
169required:
170  - compatible
171  - reg
172  - interrupts
173  - interrupt-controller
174  - '#interrupt-cells'
175  - gpio-controller
176  - '#gpio-cells'
177  - gpio-ranges
178
179additionalProperties: false
180
181examples:
182  - |
183    #include <dt-bindings/pinctrl/mediatek,mt8188-pinfunc.h>
184    #include <dt-bindings/interrupt-controller/arm-gic.h>
185
186    pio: pinctrl@10005000 {
187        compatible = "mediatek,mt8188-pinctrl";
188        reg = <0x10005000 0x1000>,
189              <0x11c00000 0x1000>,
190              <0x11e10000 0x1000>,
191              <0x11e20000 0x1000>,
192              <0x11ea0000 0x1000>,
193              <0x1000b000 0x1000>;
194        reg-names = "iocfg0", "iocfg_rm",
195                    "iocfg_lt", "iocfg_lm", "iocfg_rt",
196                    "eint";
197        gpio-controller;
198        #gpio-cells = <2>;
199        gpio-ranges = <&pio 0 0 176>;
200        interrupt-controller;
201        interrupts = <GIC_SPI 225 IRQ_TYPE_LEVEL_HIGH 0>;
202        #interrupt-cells = <2>;
203
204        pio-pins {
205            pins {
206                pinmux = <PINMUX_GPIO0__FUNC_B_GPIO0>;
207                output-low;
208            };
209        };
210
211        spi0-pins {
212            pins-spi {
213                pinmux = <PINMUX_GPIO75__FUNC_O_SPIM1_CSB>,
214                         <PINMUX_GPIO76__FUNC_O_SPIM1_CLK>,
215                         <PINMUX_GPIO77__FUNC_B0_SPIM1_MOSI>;
216                drive-strength = <6>;
217            };
218            pins-spi-mi {
219                pinmux = <PINMUX_GPIO78__FUNC_B0_SPIM1_MISO>;
220                bias-pull-down = <MTK_PUPD_SET_R1R0_10>;
221            };
222        };
223
224        i2c0-pins {
225            pins {
226                pinmux = <PINMUX_GPIO55__FUNC_B1_SCL0>,
227                         <PINMUX_GPIO56__FUNC_B1_SDA0>;
228                bias-disable;
229                drive-strength-microamp = <1000>;
230            };
231        };
232    };