IQ substrate monitor¶
Use the IQ monitor to check whether samples are reaching a browser decoder. You can run it on a quiet frequency. Its counters and power readings come from the sample stream, so you do not need a recognizable broadcast.
Input and pipeline¶
The manifest accepts complex IQ at 12 kS/s, 48 kS/s, 192 kS/s, 512 kS/s, and 1,488,375/2 S/s. Its preferred occupied bandwidth is 12 kHz. It can therefore exercise both trivial and nontrivial rational resampling paths.
flowchart TB
CU8[Receiver CU8] --> FLOAT[Complex float conversion]
FLOAT --> MIX[VFO translation]
MIX --> RESAMPLE[WASM rational channelizer]
RESAMPLE --> ABI[Diagnostic WASM module]
ABI --> STATS[Sample count, I/Q means and power]
STATS --> WORKER[Browser decoder worker]
TIME[Capture clock and continuity counters] --> WORKER
WORKER --> EVENT[Telemetry in the decoder workspace]
Validation and outputs¶
An advancing module sample count confirms the WASM module processed input. Check the worker's dropped-chunk, gap and reset counts alongside it to see whether that input was continuous. The worker also reports the input rate and bandwidth, mean and peak power, and the mean I and Q values. These telemetry events carry no protocol validation.
Replay¶
Replay uses the same channelizer and worker. Gaps reset state; source-time rates remain distinct from wall-clock replay speed. This decoder is an important control for checking deterministic sample/time mapping.
Tests¶
decoderFoundation.test.ts, decoderClock.test.ts,
decoderContinuity.test.ts, decoderInputQueue.test.ts,
decoderChannelizer.test.ts, and wasmDecoderChannelizer.test.ts cover the
common path. decoderArtifact.test.ts loads built artifacts and verifies ABI
behavior.