Skip to content

docs: update README chip-status to reflect per-band TX/RX state #60

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
josephnef merged 1 commit into from
May 30, 2026
Merged

docs: update README chip-status to reflect per-band TX/RX state #60

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
18 changes: 9 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
The Realtek 11ac driver that simply devours its competitors.

Devourer is a userspace re-implementation of Realtek's RTL88xxAU Wi-Fi
driver (Jaguar family: RTL8812AU + RTL8821AU shipping, RTL8811AU
supported via the 8812 code path, RTL8814AU RX solid + TX validated on
fresh-chip runs), speaking to the chip directly through libusb. No
driver (Jaguar family: RTL8812AU shipping on both bands, RTL8821AU
shipping at 2.4 GHz, RTL8811AU supported via the 8812 code path,
RTL8814AU RX-only), speaking to the chip directly through libusb. No
kernel module, no `rtl8812au` DKMS tree — just a C++20 static library
(`WiFiDriver`) plus two demo executables for RX and TX. It is the
OpenIPC project's driver of choice for long-range video links built on
Expand All @@ -21,12 +21,12 @@ register-table layout, firmware-download plumbing, and
family; chip-specific EEPROM handling, firmware blobs, and RF tables are
layered on top.

| Part | RF / streams | Status | Notes |
| -------------- | --------------- | ------------- | ------------------------------------------- |
| **RTL8812AU** | 2T2R | Supported | VID/PID `0bda:8812`; reference part |
| **RTL8811AU** | 1T1R | Supported | 1T1R cut of 8812 silicon; rides 8812 code path with `RFType=RF_TYPE_1T1R` selected from `REG_SYS_CFG` bit 27 |
| **RTL8814AU** | 4T4R, 3-SS max | RX + flaky TX | VID/PID `0bda:8813`; 2-SS effective on USB-2; TX works on fresh-chip single-cell runs but degrades to `LIBUSB_ERROR_IO` after virsh USB passthrough cycles |
| **RTL8821AU** | 1T1R AC + BT | Supported | OEM-rebadged as TP-Link Archer T2U Plus (`2357:0120`) etc; Android hotplug works end-to-end |
| Part | RF / streams | 2.4 GHz | 5 GHz | Notes |
| -------------- | --------------- | ------------- | ------------- | ------------------------------------------- |
| **RTL8812AU** | 2T2R | TX + RX | TX + RX | VID/PID `0bda:8812`; reference part |
| **RTL8811AU** | 1T1R | TX + RX | TX + RX | 1T1R cut of 8812 silicon; rides 8812 code path with `RFType=RF_TYPE_1T1R` selected from `REG_SYS_CFG` bit 27 |
| **RTL8814AU** | 4T4R, 3-SS max | RX only | RX only | VID/PID `0bda:8813`; 2-SS effective on USB-2. TX submits succeed on the bulk pipe but nothing reaches the air at any band — see issue #36 |
| **RTL8821AU** | 1T1R AC + BT | TX + RX | RX only | OEM-rebadged as TP-Link Archer T2U Plus (`2357:0120`) etc; Android hotplug works end-to-end. 5 GHz TX needs the per-channel IQK calibration ported from upstream `halrf_iqk_8821a_ce.c` — see issue #59 |

Successor families (`Jaguar2` / `Jaguar+` — 8812BU, 8822BU/BE, etc., and
the later `Kestrel` 11ax generation) are **out of scope**: they share
Expand Down
Loading