[PATCH v2 1/2] dt-bindings: gpio: add gpio-aggregator binding

[James Hilliard]

Document the gpio-aggregator virtual GPIO controller with a dedicated
schema and compatible string.

Also extend the GPIO AGGREGATOR MAINTAINERS entry to cover the new
binding file.

Signed-off-by: James Hilliard <james.hilliard1@xxxxxxxxx>
---
Changes v1 -> v2:
  - Add MAINTAINERS entry for the new binding file
  - Rewrite binding description without "this binding" wording
    (suggested by Krzysztof Kozlowski)
  - Drop unrelated consumer node from the example
    (suggested by Krzysztof Kozlowski)
  - Add gpio-line-names usage to the example to show named aggregated
    lines
---
 .../bindings/gpio/gpio-aggregator.yaml        | 54 +++++++++++++++++++
 MAINTAINERS                                   |  1 +
 2 files changed, 55 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/gpio/gpio-aggregator.yaml

diff --git a/Documentation/devicetree/bindings/gpio/gpio-aggregator.yaml b/Documentation/devicetree/bindings/gpio/gpio-aggregator.yaml
new file mode 100644
index 000000000000..e7df266a3d8f
--- /dev/null
+++ b/Documentation/devicetree/bindings/gpio/gpio-aggregator.yaml
@@ -0,0 +1,54 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/gpio/gpio-aggregator.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: GPIO aggregator controller
+
+maintainers:
+  - Alexander Stein <linux@xxxxxxxxxxxxxxx>
+
+description:
+  GPIO aggregator forwards selected GPIO lines from one or more GPIO
+  controllers and exposes them as a virtual GPIO controller.
+
+properties:
+  compatible:
+    const: gpio-aggregator
+
+  "#gpio-cells":
+    description: Specifies the line offset and GPIO flags.
+    const: 2
+
+  gpios:
+    description: Array of GPIOs to aggregate
+    minItems: 1
+    maxItems: 32
+
+  gpio-controller: true
+
+  gpio-line-names:
+    minItems: 1
+    maxItems: 32
+
+required:
+  - compatible
+  - "#gpio-cells"
+  - gpio-controller
+  - gpios
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+
+    gpio_agg: gpio-aggregator {
+        compatible = "gpio-aggregator";
+        #gpio-cells = <2>;
+        gpio-controller;
+        gpios = <&gpio0 3 GPIO_ACTIVE_LOW>,
+                <&gpio3 1 GPIO_ACTIVE_HIGH>;
+        gpio-line-names = "modem-reset", "modem-enable";
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index 13b291d801bc..e1bf9a37f87f 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -10789,6 +10789,7 @@ M:	Geert Uytterhoeven <geert+renesas@xxxxxxxxx>
 L:	linux-gpio@xxxxxxxxxxxxxxx
 S:	Supported
 F:	Documentation/admin-guide/gpio/gpio-aggregator.rst
+F:	Documentation/devicetree/bindings/gpio/gpio-aggregator.yaml
 F:	drivers/gpio/gpio-aggregator.c
 
 GPIO IR Transmitter
-- 
2.43.0