target/linux/bmips/patches-5.10/404-Documentation-add-BCM6362-pincontroller-binding-docu.patch

   1 From 1c839f287a008023b3b3ae7d892b4d25e3d224ad Mon Sep 17 00:00:00 2001
   2 From: =?UTF-8?q?=C3=81lvaro=20Fern=C3=A1ndez=20Rojas?= <noltari@gmail.com>
   3 Date: Wed, 27 Jul 2016 11:36:18 +0200
   4 Subject: [PATCH 05/12] Documentation: add BCM6362 pincontroller binding
   5  documentation
   6 MIME-Version: 1.0
   7 Content-Type: text/plain; charset=UTF-8
   8 Content-Transfer-Encoding: 8bit
   9
  10 Add binding documentation for the pincontrol core found in BCM6362 SoCs.
  11
  12 Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>
  13 Signed-off-by: Jonas Gorski <jonas.gorski@gmail.com>
  14 ---
  15  .../pinctrl/brcm,bcm6362-pinctrl.yaml         | 240 ++++++++++++++++++
  16  1 file changed, 240 insertions(+)
  17  create mode 100644 Documentation/devicetree/bindings/pinctrl/brcm,bcm6362-pinctrl.yaml
  18
  19 --- /dev/null
  20 +++ b/Documentation/devicetree/bindings/pinctrl/brcm,bcm6362-pinctrl.yaml
  21 @@ -0,0 +1,240 @@
  22 +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
  23 +%YAML 1.2
  24 +---
  25 +$id: http://devicetree.org/schemas/pinctrl/brcm,bcm6362-pinctrl.yaml#
  26 +$schema: http://devicetree.org/meta-schemas/core.yaml#
  27 +
  28 +title: Broadcom BCM6362 pin controller
  29 +
  30 +maintainers:
  31 +  - Álvaro Fernández Rojas <noltari@gmail.com>
  32 +  - Jonas Gorski <jonas.gorski@gmail.com>
  33 +
  34 +description: |+
  35 +  The pin controller node should be the child of a syscon node.
  36 +
  37 +  Refer to the the bindings described in
  38 +  Documentation/devicetree/bindings/mfd/syscon.yaml
  39 +
  40 +properties:
  41 +  compatible:
  42 +    const: brcm,bcm6362-pinctrl
  43 +
  44 +  gpio-controller: true
  45 +
  46 +  '#gpio-cells':
  47 +    description:
  48 +      Specifies the pin number and flags, as defined in
  49 +      include/dt-bindings/gpio/gpio.h
  50 +    const: 2
  51 +
  52 +  interrupts-extended:
  53 +    description:
  54 +      One interrupt per each of the 4 GPIO ports supported by the controller,
  55 +      sorted by port number ascending order.
  56 +    minItems: 4
  57 +    maxItems: 4
  58 +
  59 +patternProperties:
  60 +  '^.*$':
  61 +    if:
  62 +      type: object
  63 +    then:
  64 +      properties:
  65 +        function:
  66 +          $ref: "/schemas/types.yaml#/definitions/string"
  67 +          enum: [ usb_device_led, sys_irq, serial_led_clk, serial_led_data,
  68 +                  robosw_led_data, robosw_led_clk, robosw_led0, robosw_led1,
  69 +                  inet_led, spi_cs2, spi_cs3, ntr_pulse, uart1_scts,
  70 +                  uart1_srts, uart1_sdin, uart1_sdout, adsl_spi_miso,
  71 +                  adsl_spi_mosi, adsl_spi_clk, adsl_spi_cs, ephy0_led,
  72 +                  ephy1_led, ephy2_led, ephy3_led, ext_irq0, ext_irq1,
  73 +                  ext_irq2, ext_irq3, nand ]
  74 +
  75 +        pins:
  76 +          $ref: "/schemas/types.yaml#/definitions/string"
  77 +          enum: [ gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7,
  78 +                  gpio8, gpio9, gpio10, gpio11, gpio12, gpio13, gpio14,
  79 +                  gpio15, gpio16, gpio17, gpio18, gpio19, gpio20, gpio21,
  80 +                  gpio22, gpio23, gpio24, gpio25, gpio26, gpio27, nand_grp ]
  81 +
  82 +required:
  83 +  - compatible
  84 +  - gpio-controller
  85 +  - '#gpio-cells'
  86 +
  87 +additionalProperties: false
  88 +
  89 +examples:
  90 +  - |
  91 +    gpio@10000080 {
  92 +      compatible = "syscon", "simple-mfd";
  93 +      reg = <0x10000080 0x80>;
  94 +
  95 +      pinctrl: pinctrl {
  96 +        compatible = "brcm,bcm6362-pinctrl";
  97 +
  98 +        gpio-controller;
  99 +        #gpio-cells = <2>;
 100 +
 101 +        interrupts-extended = <&ext_intc 0 0>,
 102 +                              <&ext_intc 1 0>,
 103 +                              <&ext_intc 2 0>,
 104 +                              <&ext_intc 3 0>;
 105 +        interrupt-names = "gpio24",
 106 +                          "gpio25",
 107 +                          "gpio26",
 108 +                          "gpio27";
 109 +
 110 +        pinctrl_usb_device_led: usb_device_led {
 111 +          function = "usb_device_led";
 112 +          pins = "gpio0";
 113 +        };
 114 +
 115 +        pinctrl_sys_irq: sys_irq {
 116 +          function = "sys_irq";
 117 +          pins = "gpio1";
 118 +        };
 119 +
 120 +        pinctrl_serial_led: serial_led {
 121 +          pinctrl_serial_led_clk: serial_led_clk {
 122 +            function = "serial_led_clk";
 123 +            pins = "gpio2";
 124 +          };
 125 +
 126 +          pinctrl_serial_led_data: serial_led_data {
 127 +            function = "serial_led_data";
 128 +            pins = "gpio3";
 129 +          };
 130 +        };
 131 +
 132 +        pinctrl_robosw_led_data: robosw_led_data {
 133 +          function = "robosw_led_data";
 134 +          pins = "gpio4";
 135 +        };
 136 +
 137 +        pinctrl_robosw_led_clk: robosw_led_clk {
 138 +          function = "robosw_led_clk";
 139 +          pins = "gpio5";
 140 +        };
 141 +
 142 +        pinctrl_robosw_led0: robosw_led0 {
 143 +          function = "robosw_led0";
 144 +          pins = "gpio6";
 145 +        };
 146 +
 147 +        pinctrl_robosw_led1: robosw_led1 {
 148 +          function = "robosw_led1";
 149 +          pins = "gpio7";
 150 +        };
 151 +
 152 +        pinctrl_inet_led: inet_led {
 153 +          function = "inet_led";
 154 +          pins = "gpio8";
 155 +        };
 156 +
 157 +        pinctrl_spi_cs2: spi_cs2 {
 158 +          function = "spi_cs2";
 159 +          pins = "gpio9";
 160 +        };
 161 +
 162 +        pinctrl_spi_cs3: spi_cs3 {
 163 +          function = "spi_cs3";
 164 +          pins = "gpio10";
 165 +        };
 166 +
 167 +        pinctrl_ntr_pulse: ntr_pulse {
 168 +          function = "ntr_pulse";
 169 +          pins = "gpio11";
 170 +        };
 171 +
 172 +        pinctrl_uart1_scts: uart1_scts {
 173 +          function = "uart1_scts";
 174 +          pins = "gpio12";
 175 +        };
 176 +
 177 +        pinctrl_uart1_srts: uart1_srts {
 178 +          function = "uart1_srts";
 179 +          pins = "gpio13";
 180 +        };
 181 +
 182 +        pinctrl_uart1: uart1 {
 183 +          pinctrl_uart1_sdin: uart1_sdin {
 184 +            function = "uart1_sdin";
 185 +            pins = "gpio14";
 186 +          };
 187 +
 188 +          pinctrl_uart1_sdout: uart1_sdout {
 189 +            function = "uart1_sdout";
 190 +            pins = "gpio15";
 191 +          };
 192 +        };
 193 +
 194 +        pinctrl_adsl_spi: adsl_spi {
 195 +          pinctrl_adsl_spi_miso: adsl_spi_miso {
 196 +            function = "adsl_spi_miso";
 197 +            pins = "gpio16";
 198 +          };
 199 +
 200 +          pinctrl_adsl_spi_mosi: adsl_spi_mosi {
 201 +            function = "adsl_spi_mosi";
 202 +            pins = "gpio17";
 203 +          };
 204 +
 205 +          pinctrl_adsl_spi_clk: adsl_spi_clk {
 206 +            function = "adsl_spi_clk";
 207 +            pins = "gpio18";
 208 +          };
 209 +
 210 +          pinctrl_adsl_spi_cs: adsl_spi_cs {
 211 +            function = "adsl_spi_cs";
 212 +            pins = "gpio19";
 213 +          };
 214 +        };
 215 +
 216 +        pinctrl_ephy0_led: ephy0_led {
 217 +          function = "ephy0_led";
 218 +          pins = "gpio20";
 219 +        };
 220 +
 221 +        pinctrl_ephy1_led: ephy1_led {
 222 +          function = "ephy1_led";
 223 +          pins = "gpio21";
 224 +        };
 225 +
 226 +        pinctrl_ephy2_led: ephy2_led {
 227 +          function = "ephy2_led";
 228 +          pins = "gpio22";
 229 +        };
 230 +
 231 +        pinctrl_ephy3_led: ephy3_led {
 232 +          function = "ephy3_led";
 233 +          pins = "gpio23";
 234 +        };
 235 +
 236 +        pinctrl_ext_irq0: ext_irq0 {
 237 +          function = "ext_irq0";
 238 +          pins = "gpio24";
 239 +        };
 240 +
 241 +        pinctrl_ext_irq1: ext_irq1 {
 242 +          function = "ext_irq1";
 243 +          pins = "gpio25";
 244 +        };
 245 +
 246 +        pinctrl_ext_irq2: ext_irq2 {
 247 +          function = "ext_irq2";
 248 +          pins = "gpio26";
 249 +        };
 250 +
 251 +        pinctrl_ext_irq3: ext_irq3 {
 252 +          function = "ext_irq3";
 253 +          pins = "gpio27";
 254 +        };
 255 +
 256 +        pinctrl_nand: nand {
 257 +          function = "nand";
 258 +          group = "nand_grp";
 259 +        };
 260 +      };
 261 +    };