[PATCH 1/3] dt-bindings: gpio: Add support for ATCGPIO100 GPIO controller
From: CL Wang
Date: Sun Nov 15 2026 - 23:09:55 EST
Document devicetree bindings for the Andes ATCGPIO100 GPIO controller.
ATCGPIO100 is the name of the IP, which is integrated in the Andes AE350
platform and in SoCs such as Qilai. As in the ATCSPI200 SPI controller
binding, the compatibles follow the platform and SoC rather than the IP
name: andestech,ae350-gpio is the fallback, and an SoC that integrates
the IP adds its own compatible, such as andestech,qilai-gpio, in front
of it. Drivers can then match on the fallback and still add SoC-specific
handling later.
The controller has up to 32 lines, and ngpios gives the number of lines
implemented. The debounce logic can run from either of two clocks: pclk,
the APB bus clock, which is required, or extclk, an optional external
clock that allows longer debounce periods. The interrupt is optional, as
the controller also works as a plain GPIO controller without it.
Signed-off-by: CL Wang <cl634@xxxxxxxxxxxxx>
---
.../bindings/gpio/andestech,ae350-gpio.yaml | 92 +++++++++++++++++++
1 file changed, 92 insertions(+)
create mode 100644 Documentation/devicetree/bindings/gpio/andestech,ae350-gpio.yaml
diff --git a/Documentation/devicetree/bindings/gpio/andestech,ae350-gpio.yaml b/Documentation/devicetree/bindings/gpio/andestech,ae350-gpio.yaml
new file mode 100644
index 000000000000..01badd2a1342
--- /dev/null
+++ b/Documentation/devicetree/bindings/gpio/andestech,ae350-gpio.yaml
@@ -0,0 +1,92 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/gpio/andestech,ae350-gpio.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Andes ATCGPIO100 GPIO controller on AE350 platform
+
+maintainers:
+ - CL Wang <cl634@xxxxxxxxxxxxx>
+
+properties:
+ compatible:
+ oneOf:
+ - items:
+ - enum:
+ - andestech,qilai-gpio
+ - const: andestech,ae350-gpio
+ - const: andestech,ae350-gpio
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ interrupt-controller: true
+
+ "#interrupt-cells":
+ const: 2
+
+ gpio-controller: true
+
+ "#gpio-cells":
+ const: 2
+
+ ngpios:
+ minimum: 1
+ maximum: 32
+
+ gpio-line-names:
+ minItems: 1
+ maxItems: 32
+
+ clocks:
+ minItems: 1
+ items:
+ - description: APB bus clock
+ - description: External clock for debounce
+
+ clock-names:
+ minItems: 1
+ items:
+ - const: pclk
+ - const: extclk
+
+patternProperties:
+ "^.+-hog(-[0-9]+)?$":
+ type: object
+ required:
+ - gpio-hog
+
+required:
+ - compatible
+ - reg
+ - gpio-controller
+ - "#gpio-cells"
+ - clocks
+ - clock-names
+
+additionalProperties: false
+
+dependencies:
+ interrupt-controller: [ interrupts, "#interrupt-cells" ]
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ gpio@f0700000 {
+ compatible = "andestech,ae350-gpio";
+ reg = <0xf0700000 0x100>;
+ interrupts = <7 IRQ_TYPE_LEVEL_HIGH>;
+ interrupt-parent = <&plic>;
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ gpio-controller;
+ #gpio-cells = <2>;
+ ngpios = <32>;
+ clocks = <&pclk>, <&extclk>;
+ clock-names = "pclk", "extclk";
+ };
--
2.34.1