134 lines
4.0 KiB
YAML
134 lines
4.0 KiB
YAML
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||
|
|
# Copyright (c) 2020, Silicon Laboratories, Inc.
|
||
|
|
%YAML 1.2
|
||
|
|
---
|
||
|
|
|
||
|
|
$id: http://devicetree.org/schemas/net/wireless/silabs,wfx.yaml#
|
||
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||
|
|
|
||
|
|
title: Silicon Labs WFxxx devicetree bindings
|
||
|
|
|
||
|
|
maintainers:
|
||
|
|
- Jérôme Pouiller <jerome.pouiller@silabs.com>
|
||
|
|
|
||
|
|
description: >
|
||
|
|
Support for the Wifi chip WFxxx from Silicon Labs. Currently, the only device
|
||
|
|
from the WFxxx series is the WF200 described here:
|
||
|
|
https://www.silabs.com/documents/public/data-sheets/wf200-datasheet.pdf
|
||
|
|
|
||
|
|
The WF200 can be connected via SPI or via SDIO.
|
||
|
|
|
||
|
|
For SDIO:
|
||
|
|
|
||
|
|
Declaring the WFxxx chip in device tree is mandatory (usually, the VID/PID is
|
||
|
|
sufficient for the SDIO devices).
|
||
|
|
|
||
|
|
It is recommended to declare a mmc-pwrseq on SDIO host above WFx. Without
|
||
|
|
it, you may encounter issues during reboot. The mmc-pwrseq should be
|
||
|
|
compatible with mmc-pwrseq-simple. Please consult
|
||
|
|
Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.yaml for more
|
||
|
|
information.
|
||
|
|
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
items:
|
||
|
|
- enum:
|
||
|
|
- prt,prtt1c-wfm200 # Protonic PRTT1C Board
|
||
|
|
- silabs,brd4001a # WGM160P Evaluation Board
|
||
|
|
- silabs,brd8022a # WF200 Evaluation Board
|
||
|
|
- silabs,brd8023a # WFM200 Evaluation Board
|
||
|
|
- const: silabs,wf200 # Chip alone without antenna
|
||
|
|
|
||
|
|
reg:
|
||
|
|
description:
|
||
|
|
When used on SDIO bus, <reg> must be set to 1. When used on SPI bus, it is
|
||
|
|
the chip select address of the device as defined in the SPI devices
|
||
|
|
bindings.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
interrupts:
|
||
|
|
description: The interrupt line. Should be IRQ_TYPE_EDGE_RISING. When SPI is
|
||
|
|
used, this property is required. When SDIO is used, the "in-band"
|
||
|
|
interrupt provided by the SDIO bus is used unless an interrupt is defined
|
||
|
|
in the Device Tree.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
reset-gpios:
|
||
|
|
description: (SPI only) Phandle of gpio that will be used to reset chip
|
||
|
|
during probe. Without this property, you may encounter issues with warm
|
||
|
|
boot.
|
||
|
|
|
||
|
|
For SDIO, the reset gpio should declared using a mmc-pwrseq.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
wakeup-gpios:
|
||
|
|
description: Phandle of gpio that will be used to wake-up chip. Without this
|
||
|
|
property, driver will disable most of power saving features.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
silabs,antenna-config-file:
|
||
|
|
$ref: /schemas/types.yaml#/definitions/string
|
||
|
|
description: Use an alternative file for antenna configuration (aka
|
||
|
|
"Platform Data Set" in Silabs jargon). Default depends of "compatible"
|
||
|
|
string. For "silabs,wf200", the default is 'wf200.pds'.
|
||
|
|
|
||
|
|
local-mac-address: true
|
||
|
|
|
||
|
|
mac-address: true
|
||
|
|
|
||
|
|
required:
|
||
|
|
- compatible
|
||
|
|
- reg
|
||
|
|
|
||
|
|
allOf:
|
||
|
|
- $ref: /schemas/spi/spi-peripheral-props.yaml#
|
||
|
|
|
||
|
|
unevaluatedProperties: false
|
||
|
|
|
||
|
|
examples:
|
||
|
|
- |
|
||
|
|
#include <dt-bindings/gpio/gpio.h>
|
||
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
||
|
|
|
||
|
|
spi {
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
|
||
|
|
wifi@0 {
|
||
|
|
compatible = "silabs,brd8022a", "silabs,wf200";
|
||
|
|
pinctrl-names = "default";
|
||
|
|
pinctrl-0 = <&wfx_irq &wfx_gpios>;
|
||
|
|
reg = <0>;
|
||
|
|
interrupts-extended = <&gpio 16 IRQ_TYPE_EDGE_RISING>;
|
||
|
|
wakeup-gpios = <&gpio 12 GPIO_ACTIVE_HIGH>;
|
||
|
|
reset-gpios = <&gpio 13 GPIO_ACTIVE_LOW>;
|
||
|
|
spi-max-frequency = <42000000>;
|
||
|
|
};
|
||
|
|
};
|
||
|
|
|
||
|
|
- |
|
||
|
|
#include <dt-bindings/gpio/gpio.h>
|
||
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
||
|
|
|
||
|
|
wfx_pwrseq: wfx_pwrseq {
|
||
|
|
compatible = "mmc-pwrseq-simple";
|
||
|
|
pinctrl-names = "default";
|
||
|
|
pinctrl-0 = <&wfx_reset>;
|
||
|
|
reset-gpios = <&gpio 13 GPIO_ACTIVE_LOW>;
|
||
|
|
};
|
||
|
|
|
||
|
|
mmc {
|
||
|
|
mmc-pwrseq = <&wfx_pwrseq>;
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
|
||
|
|
wifi@1 {
|
||
|
|
compatible = "silabs,brd8022a", "silabs,wf200";
|
||
|
|
pinctrl-names = "default";
|
||
|
|
pinctrl-0 = <&wfx_wakeup>;
|
||
|
|
reg = <1>;
|
||
|
|
wakeup-gpios = <&gpio 12 GPIO_ACTIVE_HIGH>;
|
||
|
|
};
|
||
|
|
};
|
||
|
|
...
|