drivers/staging/wfx/Documentation/devicetree/bindings/net/wireless/siliabs,wfx.txt

   1 The WFxxx chip series can be connected via SPI or via SDIO.
   2
   3 SPI
   4 ---
   5
   6 You have to declare the WFxxx chip in your device tree.
   7
   8 Required properties:
   9  - compatible: Should be "silabs,wf200"
  10  - reg: Chip select address of device
  11  - spi-max-frequency: Maximum SPI clocking speed of device in Hz
  12  - interrupts-extended: Should contain interrupt line (interrupt-parent +
  13    interrupt can also been used). Trigger should be `IRQ_TYPE_EDGE_RISING`.
  14
  15 Optional properties:
  16  - reset-gpios: phandle of gpio that will be used to reset chip during probe.
  17    Without this property, you may encounter issues with warm boot.
  18    (Legacy: when compatible == "silabs,wfx-spi", the gpio is inverted.)
  19
  20 Please consult Documentation/devicetree/bindings/spi/spi-bus.txt for optional
  21 SPI connection related properties,
  22
  23 Example:
  24
  25 &spi1 {
  26         wfx {
  27                 compatible = "silabs,wf200";
  28                 pinctrl-names = "default";
  29                 pinctrl-0 = <&wfx_irq &wfx_gpios>;
  30                 interrupts-extended = <&gpio 16 IRQ_TYPE_EDGE_RISING>;
  31                 wakeup-gpios = <&gpio 12 GPIO_ACTIVE_HIGH>;
  32                 reset-gpios = <&gpio 13 GPIO_ACTIVE_LOW>;
  33                 reg = <0>;
  34                 spi-max-frequency = <42000000>;
  35         };
  36 };
  37
  38
  39 SDIO
  40 ----
  41
  42 The driver is able to detect a WFxxx chip on SDIO bus by matching its Vendor ID
  43 and Product ID. However, driver will only provide limited features in this
  44 case. Thus declaring WFxxx chip in device tree is strongly recommended (and may
  45 become mandatory in the future).
  46
  47 Required properties:
  48  - compatible: Should be "silabs,wf200"
  49  - reg: Should be 1
  50
  51 In addition, it is recommended to declare a mmc-pwrseq on SDIO host above WFx.
  52 Without it, you may encounter issues with warm boot. mmc-pwrseq should be
  53 compatible with mmc-pwrseq-simple. Please consult
  54 Documentation/devicetree/bindings/mmc/mmc-pwrseq-simple.txt for more
  55 information.
  56
  57 Example:
  58
  59 / {
  60         wfx_pwrseq: wfx_pwrseq {
  61                 compatible = "mmc-pwrseq-simple";
  62                 pinctrl-names = "default";
  63                 pinctrl-0 = <&wfx_reset>;
  64                 reset-gpios = <&gpio 13 GPIO_ACTIVE_LOW>;
  65         };
  66 };
  67
  68 &mmc1 {
  69         mmc-pwrseq = <&wfx_pwrseq>;
  70         #address-size = <1>;
  71         #size = <0>;
  72
  73         mmc@1 {
  74                 compatible = "silabs,wf200";
  75                 reg = <1>;
  76                 pinctrl-names = "default";
  77                 pinctrl-0 = <&wfx_wakeup>;
  78                 wakeup-gpios = <&gpio 12 GPIO_ACTIVE_HIGH>;
  79         };
  80 };
  81
  82 Note that #address-size and #size shoud already be defined in node mmc1, but it
  83 is rarely the case.
  84
  85 Common properties
  86 -----------------
  87
  88 Some properties are recognized either by SPI and SDIO versions:
  89  - wakeup-gpios: phandle of gpio that will be used to wake-up chip. Without
  90    this property, driver will disable most of power saving features.
  91  - config-file: Use an alternative file as PDS. Default is `wf200.pds`. Only
  92    necessary for development/debug purpose.
  93
  94 WFx driver also supports `mac-address` and `local-mac-address` as described in
  95 Documentation/devicetree/bindings/net/ethernet.txt
  96