Skip to content

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.