[PATCH wireless-next v5 1/4] dt-bindings: net: wireless: Add AIC8800D80 SDIO Wi-Fi

From: Yanli Yang

Date: Mon Nov 16 2026 - 02:23:54 EST


From: Zhirun Liu <zhirunliu@xxxxxxxxxxx>

Document the SDIO function used by AIC8800D80 and AIC8800D80N Wi-Fi
and register the aicsemi vendor prefix.

Describe the shared compatible, function number and optional host-wakeup
interrupt and device-wakeup GPIO. Chip selection uses the SDIO vendor
and device IDs. Power supplies and enable sequencing are described on
the MMC host through vmmc-supply and mmc-pwrseq.

Include an example for an SDIO function with both wake-up lines.

Signed-off-by: Chunqiu Liu <chunqiuliu@xxxxxxxxxxx>
Signed-off-by: Zhirun Liu <zhirunliu@xxxxxxxxxxx>
Signed-off-by: Yanli Yang <yanli.yang@xxxxxxxxxx>
---
.../net/wireless/aicsemi,aic8800d80-fmac.yaml | 78 +++++++++++++++++++
.../devicetree/bindings/vendor-prefixes.yaml | 2 +
2 files changed, 80 insertions(+)
create mode 100644 Documentation/devicetree/bindings/net/wireless/aicsemi,aic8800d80-fmac.yaml

diff --git a/Documentation/devicetree/bindings/net/wireless/aicsemi,aic8800d80-fmac.yaml b/Documentation/devicetree/bindings/net/wireless/aicsemi,aic8800d80-fmac.yaml
new file mode 100644
index 000000000000..f9ad3cd6e07c
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/wireless/aicsemi,aic8800d80-fmac.yaml
@@ -0,0 +1,78 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/wireless/aicsemi,aic8800d80-fmac.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AICSemi AIC8800D80 and AIC8800D80N SDIO Wi-Fi
+
+maintainers:
+ - Zhirun Liu <zhirunliu@xxxxxxxxxxx>
+ - Dijia Xu <dijiaxu@xxxxxxxxxxx>
+ - Chunqiu Liu <chunqiuliu@xxxxxxxxxxx>
+
+description:
+ The AIC8800D80 and AIC8800D80N are Wi-Fi and Bluetooth combo chips.
+ Wi-Fi is attached over SDIO and the chip variant is identified through
+ the SDIO vendor and device IDs. Both chips use the aicsemi,aic8800d80-fmac
+ compatible and the same device tree properties defined here.
+ The node describes SDIO function 1 and its optional out-of-band wake-up
+ lines, and is a child of the MMC host controller node. The chip supply
+ and enable line are described on the MMC host controller through
+ vmmc-supply and mmc-pwrseq.
+
+allOf:
+ - $ref: ieee80211.yaml#
+
+properties:
+ compatible:
+ const: aicsemi,aic8800d80-fmac
+
+ reg:
+ description: SDIO function number of the Wi-Fi function
+ const: 1
+
+ interrupts:
+ maxItems: 1
+ description:
+ Interrupt connected to the WIFI_WAKE_HOST pin of the chip, raised by
+ the chip when it has data for a sleeping host and used to wake up the
+ host from system suspend.
+
+ interrupt-names:
+ items:
+ - const: host-wakeup
+
+ device-wakeup-gpios:
+ maxItems: 1
+ description:
+ GPIO connected to the HOST_WAKE_WIFI pin of the chip, asserted while
+ the host needs the chip awake.
+
+required:
+ - compatible
+ - reg
+
+dependencies:
+ interrupt-names: [ interrupts ]
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/gpio/gpio.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ mmc {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ wifi@1 {
+ compatible = "aicsemi,aic8800d80-fmac";
+ reg = <1>;
+ interrupt-parent = <&gpio1>;
+ interrupts = <18 IRQ_TYPE_LEVEL_HIGH>;
+ interrupt-names = "host-wakeup";
+ device-wakeup-gpios = <&gpio1 18 GPIO_ACTIVE_HIGH>;
+ };
+ };
diff --git a/Documentation/devicetree/bindings/vendor-prefixes.yaml b/Documentation/devicetree/bindings/vendor-prefixes.yaml
index 539aa1c89ce7..e7c849197dd3 100644
--- a/Documentation/devicetree/bindings/vendor-prefixes.yaml
+++ b/Documentation/devicetree/bindings/vendor-prefixes.yaml
@@ -76,6 +76,8 @@ patternProperties:
description: Aeroflex Gaisler AB
"^aesop,.*":
description: AESOP Embedded Forum
+ "^aicsemi,.*":
+ description: AIC Semiconductor Co., Ltd.
"^airoha,.*":
description: Airoha
"^al,.*":