xref: /linux/Documentation/devicetree/bindings/pinctrl/ingenic,pinctrl.yaml (revision 9ff17e6bdaa50892dd9bdb1b116cb71b73dd711a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pinctrl/ingenic,pinctrl.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Ingenic SoCs pin controller
8
9description: >
10  Please refer to pinctrl-bindings.txt in this directory for details of the
11  common pinctrl bindings used by client devices, including the meaning of the
12  phrase "pin configuration node".
13
14  For the Ingenic SoCs, pin control is tightly bound with GPIO ports. All pins
15  may be used as GPIOs, multiplexed device functions are configured within the
16  GPIO port configuration registers and it is typical to refer to pins using the
17  naming scheme "PxN" where x is a character identifying the GPIO port with
18  which the pin is associated and N is an integer from 0 to 31 identifying the
19  pin within that GPIO port. For example PA0 is the first pin in GPIO port A,
20  and PB31 is the last pin in GPIO port B. The JZ4730, the JZ4740, the JZ4725B,
21  the X1000 and the X1830 contains 4 GPIO ports, PA to PD, for a total of 128
22  pins. The X2000 and the X2100 contains 5 GPIO ports, PA to PE, for a total of
23  160 pins. The JZ4750, the JZ4755 the JZ4760, the JZ4770 and the JZ4780 contains
24  6 GPIO ports, PA to PF, for a total of 192 pins. The JZ4775 contains 7 GPIO
25  ports, PA to PG, for a total of 224 pins.
26
27maintainers:
28  - Paul Cercueil <paul@crapouillou.net>
29
30properties:
31  compatible:
32    oneOf:
33      - enum:
34          - ingenic,jz4730-pinctrl
35          - ingenic,jz4740-pinctrl
36          - ingenic,jz4725b-pinctrl
37          - ingenic,jz4750-pinctrl
38          - ingenic,jz4755-pinctrl
39          - ingenic,jz4760-pinctrl
40          - ingenic,jz4770-pinctrl
41          - ingenic,jz4775-pinctrl
42          - ingenic,jz4780-pinctrl
43          - ingenic,x1000-pinctrl
44          - ingenic,x1500-pinctrl
45          - ingenic,x1830-pinctrl
46          - ingenic,x2000-pinctrl
47          - ingenic,x2100-pinctrl
48      - items:
49          - const: ingenic,jz4760b-pinctrl
50          - const: ingenic,jz4760-pinctrl
51      - items:
52          - const: ingenic,x1000e-pinctrl
53          - const: ingenic,x1000-pinctrl
54      - items:
55          - const: ingenic,x2000e-pinctrl
56          - const: ingenic,x2000-pinctrl
57
58  reg:
59    maxItems: 1
60
61  "#address-cells":
62    const: 1
63
64  "#size-cells":
65    const: 0
66
67patternProperties:
68  "^gpio@[0-9]$":
69    type: object
70    properties:
71      compatible:
72        enum:
73          - ingenic,jz4730-gpio
74          - ingenic,jz4740-gpio
75          - ingenic,jz4725b-gpio
76          - ingenic,jz4750-gpio
77          - ingenic,jz4755-gpio
78          - ingenic,jz4760-gpio
79          - ingenic,jz4770-gpio
80          - ingenic,jz4775-gpio
81          - ingenic,jz4780-gpio
82          - ingenic,x1000-gpio
83          - ingenic,x1500-gpio
84          - ingenic,x1830-gpio
85          - ingenic,x2000-gpio
86          - ingenic,x2100-gpio
87
88      reg:
89        items:
90          - description: The GPIO bank number
91
92      gpio-controller: true
93
94      "#gpio-cells":
95        const: 2
96
97      gpio-ranges:
98        maxItems: 1
99
100      interrupt-controller: true
101
102      "#interrupt-cells":
103        const: 2
104        description:
105          Refer to ../interrupt-controller/interrupts.txt for more details.
106
107      interrupts:
108        maxItems: 1
109
110    required:
111      - compatible
112      - reg
113      - gpio-controller
114      - "#gpio-cells"
115      - interrupts
116      - interrupt-controller
117      - "#interrupt-cells"
118
119    additionalProperties: false
120
121allOf:
122  - $ref: pinctrl.yaml#
123
124required:
125  - compatible
126  - reg
127  - "#address-cells"
128  - "#size-cells"
129
130additionalProperties:
131  anyOf:
132    - type: object
133      allOf:
134        - $ref: pincfg-node.yaml#
135        - $ref: pinmux-node.yaml#
136
137      properties:
138        phandle: true
139        function: true
140        groups: true
141        pins: true
142        bias-disable: true
143        bias-pull-up: true
144        bias-pull-down: true
145        output-low: true
146        output-high: true
147      additionalProperties: false
148
149    - type: object
150      properties:
151        phandle: true
152      additionalProperties:
153        type: object
154        allOf:
155          - $ref: pincfg-node.yaml#
156          - $ref: pinmux-node.yaml#
157
158        properties:
159          phandle: true
160          function: true
161          groups: true
162          pins: true
163          bias-disable: true
164          bias-pull-up: true
165          bias-pull-down: true
166          output-low: true
167          output-high: true
168        additionalProperties: false
169
170examples:
171  - |
172    pinctrl@10010000 {
173      compatible = "ingenic,jz4770-pinctrl";
174      reg = <0x10010000 0x600>;
175
176      #address-cells = <1>;
177      #size-cells = <0>;
178
179      gpio@0 {
180        compatible = "ingenic,jz4770-gpio";
181        reg = <0>;
182
183        gpio-controller;
184        gpio-ranges = <&pinctrl 0 0 32>;
185        #gpio-cells = <2>;
186
187        interrupt-controller;
188        #interrupt-cells = <2>;
189
190        interrupt-parent = <&intc>;
191        interrupts = <17>;
192      };
193    };
194