Skip to content

Commit

Permalink
dt: bindings: Add binding for ESP8089 wifi chips
Browse files Browse the repository at this point in the history
The ESP8089 chips can mostly be enumerated via their sdio interface,
but they are clocked by an external crystal which may differ from one
board to the other.

This commit adds a binding for the sdio child node for these chips,
allowing to specify the external crystal type (for now, this binding
could be be extended with e.g. OOB irq support later).

The Android driver for this chip uses a text file with key,value pairs
which gets loaded as firmware to pass this info to the firmware.
The "esp,crystal_26M_en" name is chosen to match the crystal_26M_en
key-name in that text file.

Note that at this point there only is an out of tree driver for this
hardware, there is no clear timeline / path for merging this. Still
I believe it would be good to specify the binding for this in tree
now, so that any future migration to an in tree driver will not cause
compatiblity issues.

Cc: Icenowy Zheng <icenowy@aosc.xyz>
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
Signed-off-by: Rob Herring <robh@kernel.org>
  • Loading branch information
Hans de Goede authored and Rob Herring committed Aug 30, 2016
1 parent 9cbbae2 commit d305910
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions Documentation/devicetree/bindings/net/wireless/esp,esp8089.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
Espressif ESP8089 wireless SDIO devices

This node provides properties for controlling the ESP8089 wireless device.
The node is expected to be specified as a child node to the SDIO controller
that connects the device to the system.

Required properties:

- compatible : Should be "esp,esp8089".

Optional properties:
- esp,crystal-26M-en: Integer value for the crystal_26M_en firmware parameter

Example:

&mmc1 {
#address-cells = <1>;
#size-cells = <0>;

vmmc-supply = <&reg_dldo1>;
mmc-pwrseq = <&wifi_pwrseq>;
bus-width = <4>;
non-removable;
status = "okay";

esp8089: sdio_wifi@1 {
compatible = "esp,esp8089";
reg = <1>;
esp,crystal-26M-en = <2>;
};
};

0 comments on commit d305910

Please sign in to comment.