Skip to content

docs: 8852C quirks — the frame-free NHM floor is 2.4 GHz-only (fw DIG)#309

Merged
josephnef merged 1 commit into
masterfrom
kestrel-8852c-quirks-doc
Jul 19, 2026
Merged

docs: 8852C quirks — the frame-free NHM floor is 2.4 GHz-only (fw DIG)#309
josephnef merged 1 commit into
masterfrom
kestrel-8852c-quirks-doc

Conversation

@josephnef

Copy link
Copy Markdown
Collaborator

What

New docs/8852c-quirks.md (styled after docs/8822e-quirks.md) for the Kestrel C8852C behavioural quirks beyond the _V1 register-bank moves. First entry documents the fw-DIG NHM limitation, plus a one-line pointer from CLAUDE.md's Kestrel section.

The entry

The active/frame-free NHM absolute noise floor (DEVOURER_RX_NOISE_FLOORRxEnergy.abs_noise_floor_dbm) is 2.4 GHz-only on the 8852C:

  • On 5 GHz it reads correctly for ~1.5 s after a channel tune, then locks ~24 dB high (bimodal, not a fixed offset).
  • Root cause: the on-chip firmware DIG settles the CCK PD lower-bound (0x4b74[30]=0, no-link "max sensitivity") ~1.5–2 s post-tune, which biases the NHM's shared dccl/CCA measurement reference. It is not an RX gain change — the LNA/RXBB IGI registers stay constant, and the per-packet physts RSSI is unaffected (so the passive floor stays accurate on both bands).
  • Why it's the fw: devourer runs no halbb DIG loop; forcing the bit back doesn't hold (the fw re-clears it within the ~100 ms measurement window). RX decodes normally either way.
  • Mitigation: GetRxEnergy band-gates the NHM to 2.4 GHz + a −60…−105 plausibility guard; 5 GHz uses the passive rssi−snr floor.
  • Residual cost: no frame-free floor on a silent 5 GHz channel (the one case the passive floor can't cover).
  • Reproducer included, plus the shipped tests/kestrel_nhm_2g_onair.sh.

Docs-only; current-state (no changelog/issue refs in the doc).

🤖 Generated with Claude Code

… (fw DIG)

New docs/8852c-quirks.md (styled after 8822e-quirks.md) documenting the Kestrel
C8852C behavioural quirks beyond the _V1 bank moves. First entry: the active
NHM absolute noise floor is 2.4 GHz-only. On 5 GHz it reads correctly for ~1.5 s
after a channel tune, then the firmware DIG settles the CCK PD lower-bound
(0x4b74[30]=0, no-link max sensitivity) and biases the NHM's dccl/CCA
measurement reference ~24 dB high — not an RX gain change (the LNA/RXBB IGI
registers stay constant; the per-packet physts RSSI is unaffected, so the
passive floor stays accurate). devourer band-gates the NHM to 2.4 GHz; 5 GHz
uses the passive rssi-snr floor. Includes the reproducer and the residual cost.

Referenced from CLAUDE.md's Kestrel section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@josephnef
josephnef merged commit 06be403 into master Jul 19, 2026
18 checks passed
@josephnef
josephnef deleted the kestrel-8852c-quirks-doc branch July 19, 2026 07:51
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