XR819 open firmware
On this page
Open firmware for the XRadio XR819 Wi-Fi chip, written in Rust, and a reference manual for the hardware it drives.
The XR819 is the 2.4 GHz 802.11b/g/n radio on boards such as the Orange Pi Zero. A patched version of Linux’s cw1200 driver talks to it over SDIO. This firmware runs on the chip’s ARM966E-S core in place of the vendor image: it owns packet memory, queues frames for the MAC, runs CCMP through the AES engine and drives the PHY.
- Build and installBuild the three firmware files and install them for the patched
cw1200driver. - Hardware referenceMemory map, register blocks with bit layouts, descriptor formats and host messages.
- OperationBoot, bring-up, receive, transmit, encryption and sleep, step by step.
- Lab notesBoard test reports, then measurements and open questions.
Status
On an Orange Pi Zero with the patched driver, the firmware associates as a WPA2-PSK station, runs as a WPA2 access point, and survives repeated driver unbind and bind, with the SDIO interrupt or a GPIO interrupt. Single-stream TCP runs at about 15 to 26 Mbit/s as a station, and a 10-minute traffic soak logged no errors. One board has been tested, over SDIO only; the board test reports list the exact kernel and firmware revisions.
About this manual
Tables and bit diagrams of the typed register blocks are generated from the firmware’s Rust declarations, so they always match the code that runs; the sparse MAC and PHY windows are maintained by hand from the code. Everything else states how it was established; Reading this reference explains the conventions, the register index finds any named register by name or address, and the search box, or /, searches every page.