From 4e722a959150e4dde87736a3dffbd9e65ecd560e Mon Sep 17 00:00:00 2001 From: AI Dev Date: Sat, 14 Nov 2026 13:21:34 +0000 Subject: [PATCH 1/2] wifi-xm530: what the image ships for XM711, without mac80211, and the ATBM6032 is another chip --- en/wifi-xm530.md | 79 +++++++++++++++++++++++++++++++++++++----------- 1 file changed, 61 insertions(+), 18 deletions(-) diff --git a/en/wifi-xm530.md b/en/wifi-xm530.md index a8607beb..7d484090 100644 --- a/en/wifi-xm530.md +++ b/en/wifi-xm530.md @@ -4,27 +4,47 @@ 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. With the module powered, the +USB ID tells you: + +```sh +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 +sleep 3 +cat /sys/bus/usb/devices/*/idVendor /sys/bus/usb/devices/*/idProduct +``` + +`value=` is the power GPIO. 96 is what the boards seen so far use; the +factory firmware's own `wifi_pdn` line shows yours. + +### 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` +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. -```bash +Then, in `/etc/network/interfaces`: + +``` auto eth2 iface eth2 inet dhcp pre-up wifi xm711 @@ -33,3 +53,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. From 691bc120dab420c4158f63434c16eb4506389606 Mon Sep 17 00:00:00 2001 From: AI Dev Date: Sat, 14 Nov 2026 13:24:08 +0000 Subject: [PATCH 2/2] wifi-xm530: the power GPIO before the probe, and USB IDs in pairs --- en/wifi-xm530.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/en/wifi-xm530.md b/en/wifi-xm530.md index 7d484090..b67b74ed 100644 --- a/en/wifi-xm530.md +++ b/en/wifi-xm530.md @@ -10,19 +10,26 @@ 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. With the module powered, the -USB ID tells you: +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=96 +insmod /lib/modules/3.10.103+/xiongmai/wifi_pdn.ko value=$PDN sleep 3 -cat /sys/bus/usb/devices/*/idVendor /sys/bus/usb/devices/*/idProduct +for d in /sys/bus/usb/devices/*; do + [ -f "$d/idVendor" ] && echo "$(cat "$d/idVendor"):$(cat "$d/idProduct")" +done ``` -`value=` is the power GPIO. 96 is what the boards seen so far use; the -factory firmware's own `wifi_pdn` line shows yours. +`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 @@ -36,6 +43,10 @@ factory firmware. wifi xm711 ``` +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. + 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`,