xref: /freebsd/sys/contrib/device-tree/Bindings/pinctrl/mediatek,mt6779-pinctrl.yaml (revision 5e3190f700637fcfc1a52daeaa4a031fdd2557c7)
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,mt6779-pinctrl.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek MT6779 Pin Controller
8
9maintainers:
10  - Andy Teng <andy.teng@mediatek.com>
11  - Sean Wang <sean.wang@kernel.org>
12
13description:
14  The MediaTek pin controller on MT6779 is used to control pin functions, pull
15  up/down resistance and drive strength options.
16
17properties:
18  compatible:
19    enum:
20      - mediatek,mt6779-pinctrl
21      - mediatek,mt6797-pinctrl
22
23  reg:
24    description: Physical addresses for GPIO base(s) and EINT registers.
25
26  reg-names: true
27
28  gpio-controller: true
29
30  "#gpio-cells":
31    const: 2
32    description:
33      Number of cells in GPIO specifier. Since the generic GPIO binding is used,
34      the amount of cells must be specified as 2. See the below mentioned gpio
35      binding representation for description of particular cells.
36
37  gpio-ranges:
38    minItems: 1
39    maxItems: 5
40    description:
41      GPIO valid number range.
42
43  interrupt-controller: true
44
45  interrupts:
46    maxItems: 1
47    description:
48      Specifies the summary IRQ.
49
50  "#interrupt-cells":
51    const: 2
52
53required:
54  - compatible
55  - reg
56  - reg-names
57  - gpio-controller
58  - "#gpio-cells"
59
60allOf:
61  - $ref: pinctrl.yaml#
62  - if:
63      properties:
64        compatible:
65          contains:
66            const: mediatek,mt6779-pinctrl
67    then:
68      properties:
69        reg:
70          minItems: 9
71          maxItems: 9
72
73        reg-names:
74          items:
75            - const: gpio
76            - const: iocfg_rm
77            - const: iocfg_br
78            - const: iocfg_lm
79            - const: iocfg_lb
80            - const: iocfg_rt
81            - const: iocfg_lt
82            - const: iocfg_tl
83            - const: eint
84  - if:
85      properties:
86        compatible:
87          contains:
88            const: mediatek,mt6797-pinctrl
89    then:
90      properties:
91        reg:
92          minItems: 5
93          maxItems: 5
94
95        reg-names:
96          items:
97            - const: gpio
98            - const: iocfgl
99            - const: iocfgb
100            - const: iocfgr
101            - const: iocfgt
102  - if:
103      properties:
104        reg-names:
105          contains:
106            const: eint
107    then:
108      required:
109        - interrupts
110        - interrupt-controller
111        - "#interrupt-cells"
112
113patternProperties:
114  '-[0-9]*$':
115    type: object
116    additionalProperties: false
117
118    patternProperties:
119      '-pins*$':
120        type: object
121        description:
122          A pinctrl node should contain at least one subnodes representing the
123          pinctrl groups available on the machine. Each subnode will list the
124          pins it needs, and how they should be configured, with regard to muxer
125          configuration, pullups, drive strength, input enable/disable and input
126          schmitt.
127        $ref: /schemas/pinctrl/pincfg-node.yaml
128
129        properties:
130          pinmux:
131            description:
132              Integer array, represents gpio pin number and mux setting.
133              Supported pin number and mux varies for different SoCs, and are
134              defined as macros in dt-bindings/pinctrl/<soc>-pinfunc.h directly.
135
136          bias-disable: true
137
138          bias-pull-up: true
139
140          bias-pull-down: true
141
142          input-enable: true
143
144          input-disable: true
145
146          output-low: true
147
148          output-high: true
149
150          input-schmitt-enable: true
151
152          input-schmitt-disable: true
153
154          drive-strength:
155            enum: [2, 4, 8, 12, 16]
156
157          slew-rate:
158            enum: [0, 1]
159
160          mediatek,pull-up-adv:
161            description: |
162              Pull up setings for 2 pull resistors, R0 and R1. User can
163              configure those special pins. Valid arguments are described as
164              below:
165              0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
166              1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
167              2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
168              3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
169            $ref: /schemas/types.yaml#/definitions/uint32
170            enum: [0, 1, 2, 3]
171
172          mediatek,pull-down-adv:
173            description: |
174              Pull down settings for 2 pull resistors, R0 and R1. User can
175              configure those special pins. Valid arguments are described as
176              below:
177              0: (R1, R0) = (0, 0) which means R1 disabled and R0 disabled.
178              1: (R1, R0) = (0, 1) which means R1 disabled and R0 enabled.
179              2: (R1, R0) = (1, 0) which means R1 enabled and R0 disabled.
180              3: (R1, R0) = (1, 1) which means R1 enabled and R0 enabled.
181            $ref: /schemas/types.yaml#/definitions/uint32
182            enum: [0, 1, 2, 3]
183
184        required:
185          - pinmux
186
187        additionalProperties: false
188
189additionalProperties: false
190
191examples:
192  - |
193    #include <dt-bindings/interrupt-controller/irq.h>
194    #include <dt-bindings/interrupt-controller/arm-gic.h>
195    #include <dt-bindings/pinctrl/mt6779-pinfunc.h>
196
197    soc {
198        #address-cells = <2>;
199        #size-cells = <2>;
200
201        pio: pinctrl@10005000 {
202            compatible = "mediatek,mt6779-pinctrl";
203            reg = <0 0x10005000 0 0x1000>,
204                <0 0x11c20000 0 0x1000>,
205                <0 0x11d10000 0 0x1000>,
206                <0 0x11e20000 0 0x1000>,
207                <0 0x11e70000 0 0x1000>,
208                <0 0x11ea0000 0 0x1000>,
209                <0 0x11f20000 0 0x1000>,
210                <0 0x11f30000 0 0x1000>,
211                <0 0x1000b000 0 0x1000>;
212            reg-names = "gpio", "iocfg_rm",
213              "iocfg_br", "iocfg_lm",
214              "iocfg_lb", "iocfg_rt",
215              "iocfg_lt", "iocfg_tl",
216              "eint";
217            gpio-controller;
218            #gpio-cells = <2>;
219            gpio-ranges = <&pio 0 0 210>;
220            interrupt-controller;
221            #interrupt-cells = <2>;
222            interrupts = <GIC_SPI 204 IRQ_TYPE_LEVEL_HIGH>;
223
224            mmc0_pins_default: mmc0-0 {
225                cmd-dat-pins {
226                    pinmux = <PINMUX_GPIO168__FUNC_MSDC0_DAT0>,
227                        <PINMUX_GPIO172__FUNC_MSDC0_DAT1>,
228                        <PINMUX_GPIO169__FUNC_MSDC0_DAT2>,
229                        <PINMUX_GPIO177__FUNC_MSDC0_DAT3>,
230                        <PINMUX_GPIO170__FUNC_MSDC0_DAT4>,
231                        <PINMUX_GPIO173__FUNC_MSDC0_DAT5>,
232                        <PINMUX_GPIO171__FUNC_MSDC0_DAT6>,
233                        <PINMUX_GPIO174__FUNC_MSDC0_DAT7>,
234                        <PINMUX_GPIO167__FUNC_MSDC0_CMD>;
235                    input-enable;
236                    mediatek,pull-up-adv = <1>;
237                };
238                clk-pins {
239                    pinmux = <PINMUX_GPIO176__FUNC_MSDC0_CLK>;
240                    mediatek,pull-down-adv = <2>;
241                };
242                rst-pins {
243                    pinmux = <PINMUX_GPIO178__FUNC_MSDC0_RSTB>;
244                    mediatek,pull-up-adv = <0>;
245                };
246            };
247        };
248
249        mmc0 {
250           pinctrl-0 = <&mmc0_pins_default>;
251           pinctrl-names = "default";
252        };
253    };
254