Skip to content

docs: adaptive-link building blocks — motion sensing, interference mitigation, named knobs#180

Merged
josephnef merged 1 commit into
masterfrom
doc-building-blocks-expand
Jul 5, 2026
Merged

docs: adaptive-link building blocks — motion sensing, interference mitigation, named knobs#180
josephnef merged 1 commit into
masterfrom
doc-building-blocks-expand

Conversation

@josephnef

Copy link
Copy Markdown
Collaborator

A review of this week's merged PRs surfaced building blocks that already exist in
the tree but weren't captured in docs/adaptive-link-building-blocks.md. This
adds them, keeping the doc's conceptual + reference tone (knobs as hooks).

  • Motion / presence sensing (Add WiFiSenseDemo: Wi-Fi motion sensing from beamforming reports #176 WiFiSenseDemo — from the self-sounded
    beamforming report) — a new environment sensor class. It is the signal that
    drives the fade-state receive-chain lever the doc already discusses.
  • Interference-mitigation actuators — the narrowband notch (DEVOURER_RX_NBI)
    and the per-tone de-weighting mask (DEVOURER_RX_CSI_MASK) — the act half
    paired with the per-tone localizer's sense half, closing that loop (the doc
    previously had only the sensor).
  • Named the concrete knobs behind existing lever rows: the RX-path mask
    (DEVOURER_RX_PATHS), the hopping / fast-retune channel lever
    (DEVOURER_HOP_*), the 5/10 MHz narrowband re-clock, and the per-layer FEC
    ladder (DEVOURER_SVC_LADDER / fused-fec.md).

Consistency pass: all links + tool paths resolve; terminology matches the related
docs; cross-links added to pseudo-preamble-puncturing.md and
beamforming-victim-sensing.md. Also fixed the README cont-TX entry, which
implied the carrier feeds the probe — the probe uses a decoupled beacon feed.

Docs only; no code change.

🤖 Generated with Claude Code

Expand the adaptive-link building-blocks catalog with primitives that already
exist in the tree but weren't named:

- Motion / presence sensing (from the self-sounded beamforming report, the
  WiFiSenseDemo readout) — a new "environment" sensor class; it is the signal
  that drives the fade-state receive-chain lever the doc already discusses.
- Interference-mitigation actuators — the narrowband notch (DEVOURER_RX_NBI) and
  the per-tone de-weighting mask (DEVOURER_RX_CSI_MASK) — the act half paired
  with the per-tone localizer's sense half, closing that loop.
- Name the concrete knobs behind existing lever rows: the RX-path mask
  (DEVOURER_RX_PATHS), the hopping / fast-retune channel lever (DEVOURER_HOP_*),
  the 5/10 MHz narrowband re-clock, and the per-layer FEC ladder
  (DEVOURER_SVC_LADDER, fused-fec.md).

Also fix the README cont-TX entry, which implied the carrier feeds the probe;
the probe uses a decoupled beacon feed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@josephnef josephnef merged commit 4df2a3b into master Jul 5, 2026
15 checks passed
@josephnef josephnef deleted the doc-building-blocks-expand branch July 5, 2026 16:56
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