docs: complete the visual RF primer — TX pipeline, sounding, diversity, hopping#183
Merged
Conversation
…y, hopping Add the remaining four animated diagrams and weave all eight into a logically ordered visual course in docs/rf-primer.md (subcarrier → hopping link): - TX pipeline (tools/tx_pipeline_gif.py) — bits → scramble → FEC → interleave → QAM → IFFT → cyclic prefix → RF; how a packet becomes a waveform. - Beamforming self-sounding sequence (tools/bf_sequence_gif.py) — NDPA → NDP → measure H(k) → CSI report between two adapters; the source of the waterfall, the interference localizer, and the motion sensor. - Antenna diversity / MRC (tools/mrc_diversity_gif.py) — two fading antennas, correlated when still (combining barely helps) vs decorrelated under motion (combining fills the fades); why chain count is a fade-state lever. - Frequency hopping (tools/hop_pattern_gif.py) — a time–frequency view of the TX spreading across the band, escaping a parked interferer; hopping as a frequency-diversity interleaver for the outer FEC. All in the shared DEVOURER live-monitor style (tools/monitor_style.py). README updated to point at the eight-part primer. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- ofdm_anatomy: the frequency-offset caption and the legend row overlapped; give the legend its own row below the caption. - bf_sequence: the "air gap" label overlapped the readout panel; move it to the far left of the air gap, clear of the flying packet and the panel. - mrc_diversity: deep fades drew below the plot box; clamp the trace to the grid. - tx_pipeline: the QAM-stage caption overlapped the constellation points; move it below them and label the constellation. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Completes the visual RF primer (#182) with the remaining four animated diagrams,
woven into a single logically-ordered course in
docs/rf-primer.md— a newcomercan read from a single subcarrier all the way to a hopping, diversity-combined
link.
The primer now runs 1–8 in order: channel → modulation → TX pipeline → on-air →
receiver → sounding → diversity → hopping. All in the shared DEVOURER live-monitor
style (
tools/monitor_style.py); each regenerates from its owntools/*_gif.py.README points at the eight-part primer.
Docs/tooling only; GIFs 161 KB–978 KB (all ≤ the existing waterfall).
🤖 Generated with Claude Code