bindings/pinctrl/ingenic,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/ingenic,pinctrl.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Ingenic SoCs pin controller
   8
   9 description: >
  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
  27 maintainers:
  28   - Paul Cercueil <paul@crapouillou.net>
  29
  30 properties:
  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
  67 patternProperties:
  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
 121 allOf:
 122   - $ref: pinctrl.yaml#
 123
 124 required:
 125   - compatible
 126   - reg
 127   - "#address-cells"
 128   - "#size-cells"
 129
 130 additionalProperties:
 131   anyOf:
 132     - type: object
 133       allOf:
 134         - $ref: pincfg-node.yaml#
 135         - $ref: pinmux-node.yaml#
 136
 137       properties:
 138         function: true
 139         groups: true
 140         pins: true
 141         bias-disable: true
 142         bias-pull-up: true
 143         bias-pull-down: true
 144         output-low: true
 145         output-high: true
 146       additionalProperties: false
 147
 148     - type: object
 149       additionalProperties:
 150         type: object
 151         allOf:
 152           - $ref: pincfg-node.yaml#
 153           - $ref: pinmux-node.yaml#
 154
 155         properties:
 156           function: true
 157           groups: true
 158           pins: true
 159           bias-disable: true
 160           bias-pull-up: true
 161           bias-pull-down: true
 162           output-low: true
 163           output-high: true
 164         additionalProperties: false
 165
 166 examples:
 167   - |
 168     pinctrl@10010000 {
 169       compatible = "ingenic,jz4770-pinctrl";
 170       reg = <0x10010000 0x600>;
 171
 172       #address-cells = <1>;
 173       #size-cells = <0>;
 174
 175       gpio@0 {
 176         compatible = "ingenic,jz4770-gpio";
 177         reg = <0>;
 178
 179         gpio-controller;
 180         gpio-ranges = <&pinctrl 0 0 32>;
 181         #gpio-cells = <2>;
 182
 183         interrupt-controller;
 184         #interrupt-cells = <2>;
 185
 186         interrupt-parent = <&intc>;
 187         interrupts = <17>;
 188       };
 189     };