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,mt8183-pinctrl.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Mediatek MT8183 Pin Controller Device Tree Bindings
8
9 maintainers:
10 - Sean Wang <sean.wang@kernel.org>
11
12 description: |+
13 The MediaTek's MT8183 Pin controller is used to control SoC pins.
14
15 properties:
16 compatible:
17 const: mediatek,mt8183-pinctrl
18
19 reg:
20 minItems: 10
21 maxItems: 10
22
23 reg-names:
24 items:
25 - const: iocfg0
26 - const: iocfg1
27 - const: iocfg2
28 - const: iocfg3
29 - const: iocfg4
30 - const: iocfg5
31 - const: iocfg6
32 - const: iocfg7
33 - const: iocfg8
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
59 allOf:
60 - $ref: "pinctrl.yaml#"
61
62 required:
63 - compatible
64 - reg
65 - gpio-controller
66 - "#gpio-cells"
67 - gpio-ranges
68
69 patternProperties:
70 '-[0-9]+$':
71 type: object
72 additionalProperties: false
73 patternProperties:
74 'pins':
75 type: object
76 additionalProperties: false
77 description: |
78 A pinctrl node should contain at least one subnodes representing the
79 pinctrl groups available on the machine. Each subnode will list the
80 pins it needs, and how they should be configured, with regard to muxer
81 configuration, pullups, drive strength, input enable/disable and input
82 schmitt.
83 $ref: "/schemas/pinctrl/pincfg-node.yaml"
84
85 properties:
86 pinmux:
87 description:
88 integer array, represents gpio pin number and mux setting.
89 Supported pin number and mux varies for different SoCs, and are
90 defined as macros in <soc>-pinfunc.h directly.
91
92 bias-disable: true
93
94 bias-pull-up: true
95
96 bias-pull-down: true
97
98 input-enable: true
99
100 input-disable: true
101
102 output-low: true
103
104 output-high: true
105
106 input-schmitt-enable: true
107
108 input-schmitt-disable: true
109
110 drive-strength:
111 enum: [2, 4, 6, 8, 10, 12, 14, 16]
112
113 mediatek,drive-strength-adv:
114 description: |
115 Describe the specific driving setup property.
116 For I2C pins, the existing generic driving setup can only support
117 2/4/6/8/10/12/14/16mA driving. But in specific driving setup, they
118 can support 0.125/0.25/0.5/1mA adjustment. If we enable specific
119 driving setup, the existing generic setup will be disabled.
120 The specific driving setup is controlled by E1E0EN.
121 When E1=0/E0=0, the strength is 0.125mA.
122 When E1=0/E0=1, the strength is 0.25mA.
123 When E1=1/E0=0, the strength is 0.5mA.
124 When E1=1/E0=1, the strength is 1mA.
125 EN is used to enable or disable the specific driving setup.
126 Valid arguments are described as below:
127 0: (E1, E0, EN) = (0, 0, 0)
128 1: (E1, E0, EN) = (0, 0, 1)
129 2: (E1, E0, EN) = (0, 1, 0)
130 3: (E1, E0, EN) = (0, 1, 1)
131 4: (E1, E0, EN) = (1, 0, 0)
132 5: (E1, E0, EN) = (1, 0, 1)
133 6: (E1, E0, EN) = (1, 1, 0)
134 7: (E1, E0, EN) = (1, 1, 1)
135 So the valid arguments are from 0 to 7.
136 $ref: /schemas/types.yaml#/definitions/uint32
137 enum: [0, 1, 2, 3, 4, 5, 6, 7]
138
139 mediatek,pull-up-adv:
140 description: |
141 Pull up setings for 2 pull resistors, R0 and R1. User can
142 configure those special pins. Valid arguments are described as below:
143 0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
144 1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
145 2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
146 3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
147 $ref: /schemas/types.yaml#/definitions/uint32
148 enum: [0, 1, 2, 3]
149
150 mediatek,pull-down-adv:
151 description: |
152 Pull down settings for 2 pull resistors, R0 and R1. User can
153 configure those special pins. Valid arguments are described as below:
154 0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
155 1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
156 2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
157 3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
158 $ref: /schemas/types.yaml#/definitions/uint32
159 enum: [0, 1, 2, 3]
160
161 mediatek,tdsel:
162 description: |
163 An integer describing the steps for output level shifter duty
164 cycle when asserted (high pulse width adjustment). Valid arguments
165 are from 0 to 15.
166 $ref: /schemas/types.yaml#/definitions/uint32
167
168 mediatek,rdsel:
169 description: |
170 An integer describing the steps for input level shifter duty cycle
171 when asserted (high pulse width adjustment). Valid arguments are
172 from 0 to 63.
173 $ref: /schemas/types.yaml#/definitions/uint32
174
175 required:
176 - pinmux
177
178 additionalProperties: false
179
180 examples:
181 - |
182 #include <dt-bindings/interrupt-controller/irq.h>
183 #include <dt-bindings/interrupt-controller/arm-gic.h>
184 #include <dt-bindings/pinctrl/mt8183-pinfunc.h>
185
186 soc {
187 #address-cells = <2>;
188 #size-cells = <2>;
189
190 pio: pinctrl@10005000 {
191 compatible = "mediatek,mt8183-pinctrl";
192 reg = <0 0x10005000 0 0x1000>,
193 <0 0x11f20000 0 0x1000>,
194 <0 0x11e80000 0 0x1000>,
195 <0 0x11e70000 0 0x1000>,
196 <0 0x11e90000 0 0x1000>,
197 <0 0x11d30000 0 0x1000>,
198 <0 0x11d20000 0 0x1000>,
199 <0 0x11c50000 0 0x1000>,
200 <0 0x11f30000 0 0x1000>,
201 <0 0x1000b000 0 0x1000>;
202 reg-names = "iocfg0", "iocfg1", "iocfg2",
203 "iocfg3", "iocfg4", "iocfg5",
204 "iocfg6", "iocfg7", "iocfg8",
205 "eint";
206 gpio-controller;
207 #gpio-cells = <2>;
208 gpio-ranges = <&pio 0 0 192>;
209 interrupt-controller;
210 interrupts = <GIC_SPI 177 IRQ_TYPE_LEVEL_HIGH>;
211 #interrupt-cells = <2>;
212
213 i2c0_pins_a: i2c-0 {
214 pins1 {
215 pinmux = <PINMUX_GPIO48__FUNC_SCL5>,
216 <PINMUX_GPIO49__FUNC_SDA5>;
217 mediatek,pull-up-adv = <3>;
218 mediatek,drive-strength-adv = <7>;
219 };
220 };
221
222 i2c1_pins_a: i2c-1 {
223 pins {
224 pinmux = <PINMUX_GPIO50__FUNC_SCL3>,
225 <PINMUX_GPIO51__FUNC_SDA3>;
226 mediatek,pull-down-adv = <2>;
227 mediatek,drive-strength-adv = <4>;
228 };
229 };
230 };
231 };
Cache object: f9569d80ac7bf81313b2d1b46900e224
|