Appendix
Sources
On this page
Paths are relative to the repository root. The Rust sources are the primary record: register layouts, bit fields and doc comments in them generate the tables in this manual.
In this repository
| Source | Path | Provides |
|---|---|---|
| Platform module | src/platform.rs |
System, clock, timer and platform register blocks; start-up sequences |
| Interrupts | src/interrupts.rs |
Interrupt controller layout and sources; the IRQ handler |
| Host interface | src/hif.rs |
Descriptor format, ring depth, status bits, reclaim order |
| Receive path | src/radio.rs |
FIFO slot header and trailer, resynchronization |
| Main loop | src/firmware.rs, src/activity.rs |
Pass order, sleep timeout, linger |
| Power save | src/power_save.rs, src/phy/mod.rs |
Station power save, receiver doze |
| A-MPDU | src/tx/aggregate.rs, src/tx/ampdu.rs |
Aggregate command streams, BlockAck resolution |
| MAC | src/mac.rs |
Mode words, response slots, slot timings, descriptor templates |
| TX pipes | src/tx/pipe.rs, src/tx/event.rs |
Ring layout, GO, event and scheduler words |
| AES/CCMP | src/crypto/engine.rs, src/crypto/mod.rs |
Command order, AAD masks, the start-up self-test |
| Packet RAM | src/packet_ram.rs, link-main-low.x |
Object layout, address encoders |
| Loader | src/loader.rs, src/download.rs, src/init_data.rs |
The 41 register writes, the PHY tables, the download protocol |
| Image packer | xtask/src/image.rs |
Container records built from the ELF |
Outside this repository
The analysis notes are not published. Function names on the vendor cross-reference, such as mac_irq_handler, are annotations, not vendor symbols.
The vendor image, its container boundaries and the 41 register writes were verified byte for byte against the vendor fw_xr819.bin of 130,628 bytes, SHA-256 3e2462d476c9dfcb907cda1ba81d0a6d1bbee5e3207bdc1911ec5042d96fdfca.