dt-bindings: gpio: Convert snps,dw-apb-gpio to DT schema

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/gpio/snps,dw-apb-gpio.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Synopsys DesignWare APB GPIO controller

description: |

  Synopsys DesignWare GPIO controllers have a configurable number of ports,

  each of which are intended to be represented as child nodes with the generic

  GPIO-controller properties as desribed in this bindings file.

maintainers:

  - Hoan Tran <hoan@os.amperecomputing.com>

properties:

  $nodename:

    pattern: "^gpio@[0-9a-f]+$"

  compatible:

    const: snps,dw-apb-gpio

  "#address-cells":

    const: 1

  "#size-cells":

    const: 0

  reg:

    maxItems: 1

  clocks:

    items:

      - description: APB interface clock source

  clock-names:

    items:

      - const: bus

  resets:

    maxItems: 1

patternProperties:

  "^gpio-(port|controller)@[0-9a-f]+$":

    type: object

    properties:

      compatible:

        const: snps,dw-apb-gpio-port

      reg:

        maxItems: 1

      gpio-controller: true

      '#gpio-cells':

        const: 2

      snps,nr-gpios:

        description: The number of GPIO pins exported by the port.

        default: 32

        allOf:

          - $ref: /schemas/types.yaml#/definitions/uint32

          - minimum: 1

            maximum: 32

      interrupts:

        description: |

          The interrupts to the parent controller raised when GPIOs generate

          the interrupts. If the controller provides one combined interrupt

          for all GPIOs, specify a single interrupt. If the controller provides

          one interrupt for each GPIO, provide a list of interrupts that

          correspond to each of the GPIO pins.

        minItems: 1

        maxItems: 32

      interrupt-controller: true

      '#interrupt-cells':

        const: 2

    required:

      - compatible

      - reg

      - gpio-controller

      - '#gpio-cells'

    dependencies:

      interrupt-controller: [ interrupts ]

    additionalProperties: false

additionalProperties: false

required:

  - compatible

  - reg

  - "#address-cells"

  - "#size-cells"

examples:

  - |

    gpio: gpio@20000 {

      compatible = "snps,dw-apb-gpio";

      reg = <0x20000 0x1000>;

      #address-cells = <1>;

      #size-cells = <0>;

      porta: gpio-port@0 {

        compatible = "snps,dw-apb-gpio-port";

        reg = <0>;

        gpio-controller;

        #gpio-cells = <2>;

        snps,nr-gpios = <8>;

        interrupt-controller;

        #interrupt-cells = <2>;

        interrupt-parent = <&vic1>;

        interrupts = <0>;

      };

      portb: gpio-port@1 {

        compatible = "snps,dw-apb-gpio-port";

        reg = <1>;

        gpio-controller;

        #gpio-cells = <2>;

        snps,nr-gpios = <8>;

      };

    };

...

* Synopsys DesignWare APB GPIO controller

Required properties:

- compatible : Should contain "snps,dw-apb-gpio"

- reg : Address and length of the register set for the device.

- #address-cells : should be 1 (for addressing port subnodes).

- #size-cells : should be 0 (port subnodes).

The GPIO controller has a configurable number of ports, each of which are

represented as child nodes with the following properties:

Required properties:

- compatible : "snps,dw-apb-gpio-port"

- gpio-controller : Marks the device node as a gpio controller.

- #gpio-cells : Should be two.  The first cell is the pin number and

  the second cell is used to specify the gpio polarity:

      0 = active high

      1 = active low

- reg : The integer port index of the port, a single cell.

Optional properties:

- interrupt-controller : The first port may be configured to be an interrupt

controller.

- #interrupt-cells : Specifies the number of cells needed to encode an

  interrupt.  Shall be set to 2.  The first cell defines the interrupt number,

  the second encodes the triger flags encoded as described in

  Documentation/devicetree/bindings/interrupt-controller/interrupts.txt

- interrupts : The interrupts to the parent controller raised when GPIOs

  generate the interrupts. If the controller provides one combined interrupt

  for all GPIOs, specify a single interrupt. If the controller provides one

  interrupt for each GPIO, provide a list of interrupts that correspond to each

  of the GPIO pins. When specifying multiple interrupts, if any are unconnected,

  use the interrupts-extended property to specify the interrupts and set the

  interrupt controller handle for unused interrupts to 0.

- snps,nr-gpios : The number of pins in the port, a single cell.

- resets : Reset line for the controller.

Example:

gpio: gpio@20000 {

	compatible = "snps,dw-apb-gpio";

	reg = <0x20000 0x1000>;

	#address-cells = <1>;

	#size-cells = <0>;

	porta: gpio@0 {

		compatible = "snps,dw-apb-gpio-port";

		gpio-controller;

		#gpio-cells = <2>;

		snps,nr-gpios = <8>;

		reg = <0>;

		interrupt-controller;

		#interrupt-cells = <2>;

		interrupt-parent = <&vic1>;

		interrupts = <0>;

	};

	portb: gpio@1 {

		compatible = "snps,dw-apb-gpio-port";

		gpio-controller;

		#gpio-cells = <2>;

		snps,nr-gpios = <8>;

		reg = <1>;

	};

};