Merge greybus driver tree into 4.8-rc6
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / wireless / marvell-sd8xxx.txt
1 Marvell 8897/8997 (sd8897/sd8997) SDIO devices
2 ------
3
4 This node provides properties for controlling the marvell sdio wireless device.
5 The node is expected to be specified as a child node to the SDIO controller that
6 connects the device to the system.
7
8 Required properties:
9
10   - compatible : should be one of the following:
11         * "marvell,sd8897"
12         * "marvell,sd8997"
13
14 Optional properties:
15
16   - marvell,caldata* : A series of properties with marvell,caldata prefix,
17                       represent calibration data downloaded to the device during
18                       initialization. This is an array of unsigned 8-bit values.
19                       the properties should follow below property name and
20                       corresponding array length:
21         "marvell,caldata-txpwrlimit-2g" (length = 566).
22         "marvell,caldata-txpwrlimit-5g-sub0" (length = 502).
23         "marvell,caldata-txpwrlimit-5g-sub1" (length = 688).
24         "marvell,caldata-txpwrlimit-5g-sub2" (length = 750).
25         "marvell,caldata-txpwrlimit-5g-sub3" (length = 502).
26   - marvell,wakeup-pin : a wakeup pin number of wifi chip which will be configured
27                       to firmware. Firmware will wakeup the host using this pin
28                       during suspend/resume.
29   - interrupt-parent: phandle of the parent interrupt controller
30   - interrupts : interrupt pin number to the cpu. driver will request an irq based on
31                  this interrupt number. during system suspend, the irq will be enabled
32                  so that the wifi chip can wakeup host platform under certain condition.
33                  during system resume, the irq will be disabled to make sure
34                  unnecessary interrupt is not received.
35
36 Example:
37
38 Tx power limit calibration data is configured in below example.
39 The calibration data is an array of unsigned values, the length
40 can vary between hw versions.
41 IRQ pin 38 is used as system wakeup source interrupt. wakeup pin 3 is configured
42 so that firmware can wakeup host using this device side pin.
43
44 &mmc3 {
45         status = "okay";
46         vmmc-supply = <&wlan_en_reg>;
47         bus-width = <4>;
48         cap-power-off-card;
49         keep-power-in-suspend;
50
51         #address-cells = <1>;
52         #size-cells = <0>;
53         mwifiex: wifi@1 {
54                 compatible = "marvell,sd8897";
55                 reg = <1>;
56                 interrupt-parent = <&pio>;
57                 interrupts = <38 IRQ_TYPE_LEVEL_LOW>;
58
59                 marvell,caldata_00_txpwrlimit_2g_cfg_set = /bits/ 8 <
60         0x01 0x00 0x06 0x00 0x08 0x02 0x89 0x01>;
61                 marvell,wakeup-pin = <3>;
62         };
63 };