sdr-recv
Record W1700K IQ samples from the host stream ring
TLDR
SYNOPSIS
sdr-recv [--seconds S] [--out PATH] [options]
DESCRIPTION
sdr-recv records the W1700K IQ stream as w1700k-stream serves it: complex int16 on the radio's 14-bit scale (full scale 8192), I then Q, corrected for decimation roll-off where the service applies flatten. It follows one run in slot order and stops when --seconds elapse after the first slice, after --idle-ms without a new slice, when the run ends, or when --wait expires with no stream.With --out, PATH holds every slice of 2048 samples. A lost slice is written as zeros so sample time stays true; firmware events (no samples) are omitted. PATH.json and the last stdout line report the run, first slice, slice/sample/event/loss/overrun counts, which slices the correction produced, and why it stopped.Build with a C11 compiler (`make` in `host/recv` writes `build/sdr-recv`). Licensed GPL-2.0-only.
PARAMETERS
--stream NAME
w1700k-stream shared-memory object (default `/w1700k-stream`).--seconds S
Stop S seconds after the first slice (default 10).--idle-ms I
Stop after I ms without a new slice (default 1000).--wait S
Give up if no stream comes within S seconds (default 120).--out PATH
Write samples to PATH. Without it, count only.--capacity-mib M
With --out: memory for the recording, allocated up front (default 4096).--report S
Progress line every S seconds (default 10).
CAVEATS
Needs w1700k-stream running. Overruns are slots the ring overwrote before they were read (also zeros in the file). Export integrity (spare bits, stale slices) is checked by the stream service, which counts it. A long recording at 320 Msps is large; --capacity-mib is allocated up front.The binary is built from the W1700K SDR tree; it is not a typical distro package.
HISTORY
Part of W1700K SDR (host recorder under `host/recv`). It is the file-oriented consumer of the shared IQ ring, alongside the spectrum server.
SEE ALSO
w1700k(1), w1700k-stream(1), w1700k-spectrum(1), rtl_sdr(1)
