Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 72 additions & 18 deletions en/wifi-xm530.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,58 @@
Wi-Fi for XM530 based devices
-----------------------------

Save this script as `/usr/sbin/wifi`

```bash
#!/bin/sh

WIFI=$1

if [ "$WIFI" = "xm711" ]; then
insmod /lib/modules/3.10.103+/xiongmai/dwc_common_port_lib.ko
insmod /lib/modules/3.10.103+/xiongmai/dwc_otg.ko
insmod /lib/modules/3.10.103+/xiongmai/wifi_pdn.ko value=96
insmod /lib/modules/3.10.103+/xiongmai/compat.ko
insmod /lib/modules/3.10.103+/kernel/net/wireless/cfg80211.ko # grab from original firmware
insmod /lib/modules/3.10.103+/kernel/net/mac80211/mac80211.ko
insmod /lib/modules/3.10.103+/xiongmai/xm711.ko
fi
This page is for the first-generation XM530 and XM550 (`ipcinfo -c` says
`xm530` or `xm550`; the image is `xm530_lite`). XM530V200, XM533 and XM535
boards use a different image and their own profiles in `/etc/wireless/usb`.

The Wi-Fi on these boards is a USB module behind the SoC's USB host
(`dwc_otg`), powered through a GPIO by `wifi_pdn`. Find out which chip
yours is before following anything below.

First the power GPIO: it is `wifi_pdn`'s `value=`, and the factory
firmware's own `insmod wifi_pdn.ko value=…` line shows it for your board.
96 is what the boards seen so far use; put yours in place of `$PDN` if it
differs. With the module powered, its USB ID tells you the chip:

```sh
PDN=96
insmod /lib/modules/3.10.103+/xiongmai/dwc_common_port_lib.ko
insmod /lib/modules/3.10.103+/xiongmai/dwc_otg.ko
insmod /lib/modules/3.10.103+/xiongmai/wifi_pdn.ko value=$PDN
sleep 3
for d in /sys/bus/usb/devices/*; do
[ -f "$d/idVendor" ] && echo "$(cat "$d/idVendor"):$(cat "$d/idProduct")"
done
```

`1d6b:0002` is the USB host itself; the other line is the Wi-Fi module.
No second line means the module is not powered: check `$PDN`.

### XM711

The `xm530_lite` image ships everything this module needs: the vendor
driver (`xm711.ko`, `compat.ko`), the vendor's backported `cfg80211.ko`
at `/lib/modules/3.10.103+/kernel/net/wireless/`, and the script that
loads them in order, `/usr/bin/wifi`. Nothing has to be copied from the
factory firmware.

```sh
wifi xm711
```

Save these settings to `/etc/network/interfaces`
The script powers the module with `wifi_pdn value=96`. On a board whose
factory firmware uses another value, edit `value=` in `/usr/bin/wifi`; the
edit lands in the overlay, so `sysupgrade -n` (or `firstboot`) undoes it.

```bash
Do not load `mac80211.ko` as well. The XM711 driver does not use it, and
the kernel's `mac80211` cannot load against the backported `cfg80211`:
it fails with `Unknown symbol __cfg80211_send_disassoc`,
`cfg80211_send_rx_auth` and so on. Earlier versions of this page loaded
it.

Then, in `/etc/network/interfaces`:

```
auto eth2
iface eth2 inet dhcp
pre-up wifi xm711
Expand All @@ -33,3 +64,26 @@ iface eth2 inet dhcp
pre-up (sleep 3; wpa_supplicant -B -Dnl80211 -ieth2 -c/tmp/wpa_supplicant.conf)
post-down killall -q wpa_supplicant
```

### AltoBeam ATBM6032 (`007a:8888`, sold as XM713G)

None of the above applies: this is a different chip, and `xm711.ko`
does not drive it. The stock `xm530_lite` image has no driver for it and
no profile in `/etc/wireless/usb`, so setting `wlandev` to a module name
such as `atbm603x_wifi_usb` loads nothing (`wlandev` takes a profile
name).

The factory `xm713g.ko` is built against the stock kernel's `cfg80211`
with wireless extensions (`CONFIG_CFG80211_WEXT`), which is why it also
needs the factory `cfg80211.ko`. OpenIPC does not ship either.

Support with OpenIPC's own driver is in progress:
[OpenIPC/firmware#2316](https://github.com/OpenIPC/firmware/pull/2316)
adds the `atbm603x-xm530` profile (USB host, then `wifi_pdn` from the
`wifipdn` variable, then the driver), and
[OpenIPC/builder#130](https://github.com/OpenIPC/builder/pull/130) is a
device image that sets it up. Builds made before
[OpenIPC/firmware#2854](https://github.com/OpenIPC/firmware/pull/2854)
could not load that driver at all: its build left it out of `modules.dep`.
See [OpenIPC/firmware#2853](https://github.com/OpenIPC/firmware/issues/2853)
for a board with this chip.