From: Zhirun Liu 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 Signed-off-by: Zhirun Liu Signed-off-by: Yanli Yang --- .../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 + - Dijia Xu + - Chunqiu Liu + +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 + #include + + 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,.*":