Skip to content

docs: update chipset status; track CLAUDE.md#47

Merged
josephnef merged 1 commit into
masterfrom
docs/chipset-status-update
May 26, 2026
Merged

docs: update chipset status; track CLAUDE.md#47
josephnef merged 1 commit into
masterfrom
docs/chipset-status-update

Conversation

@josephnef
Copy link
Copy Markdown
Collaborator

README.md and CLAUDE.md were both stale on the supported-chipsets front. Updating both.

What changes

README.md

  • Lead paragraph: drops the "8811 WIP / 8814 RX-only / 8821 not supported" framing.
  • Hardware landscape table:
    • 8811AU → Supported (rides 8812 code path with RFType=RF_TYPE_1T1R selected from REG_SYS_CFG bit 27)
    • 8814AU → RX + flaky TX (TX validated on fresh-chip single-cell runs but degrades to LIBUSB_ERROR_IO after virsh USB passthrough cycles)
    • 8821AU → Supported (proper 8821-specific init flow now on master, Android hotplug confirmed end-to-end)
  • Demo env vars: adds DEVOURER_VID and DEVOURER_USB_QUIET (both demos); adds the WiFiDriverTxDemo-only radiotap-encoding knobs DEVOURER_TX_{MCS,LDPC,STBC,BW,VHT,VHT_MCS,VHT_NSS}.
  • New Testing subsection: short pointer to tests/regress.py covering the three matrix modes (--full-matrix, --encoding-matrix, --sniffer-iface) plus the kernel-TX LDPC/STBC strip caveat.

CLAUDE.md (newly tracked)

Was previously untracked. Committing it now so future contributors and Claude Code sessions inherit the same project understanding.

Content updates mirror the README:

  • Lead-paragraph chipset status reflects current master.
  • The "8814AU TX broken" hardware gotcha is reframed to the post-passthrough degradation pattern that current matrix runs actually reproduce.
  • Regression-testing section gains the --full-matrix / --encoding-matrix / --sniffer-iface modes and the kernel-TX strip caveat.
  • Demo env-vars section gains the WiFiDriverTxDemo radiotap knobs.

What this PR doesn't touch

  • No code changes; pure docs.
  • No new images / assets.
  • No changes to tests/README.md — it's already current as of recent test-infrastructure PRs.

🤖 Generated with Claude Code

README.md and CLAUDE.md were both stale on the supported-chipsets
front. Updating both:

- Lead paragraph: drops "8811 WIP / 8814 RX-only / 8821 not supported"
  framing.
- Hardware landscape table: 8811AU now "Supported" (rides 8812 code
  path with RFType=1T1R via REG_SYS_CFG bit 27); 8814AU now "RX +
  flaky TX" — TX validated on fresh-chip single-cell runs but
  degrades to LIBUSB_ERROR_IO after virsh USB passthrough cycles;
  8821AU now "Supported" — proper 8821-specific init flow on master,
  Android hotplug confirmed end-to-end.
- Demo env vars: adds DEVOURER_VID and DEVOURER_USB_QUIET (common to
  both demos); adds the WiFiDriverTxDemo-only radiotap-encoding knobs
  DEVOURER_TX_{MCS,LDPC,STBC,BW,VHT,VHT_MCS,VHT_NSS}.
- New "Testing" subsection: brief pointer to tests/regress.py with
  the three matrix modes and the kernel-TX LDPC/STBC strip caveat.
- CLAUDE.md: same lead-para fix; updates the "8814AU TX broken"
  gotcha to reflect the post-passthrough degradation pattern; adds
  the specialised --full-matrix / --encoding-matrix / --sniffer-iface
  modes to the regression-testing section; adds the txdemo env-var
  knobs to the env-vars section.

CLAUDE.md was previously untracked — committing it now so future
contributors and Claude Code sessions inherit the same project
understanding.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@josephnef josephnef merged commit 208f067 into master May 26, 2026
5 checks passed
@josephnef josephnef deleted the docs/chipset-status-update branch May 26, 2026 07:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant