Troubleshooting

No observable output

Build stages and subscriptions before calling the sampler's start action once. Check direct reads and reader-side errors.

Stream silently stops

The sampler catches exceptions and exits. Instrument the reader and callbacks; observable OnError alone may not reveal the failure.

Samples change after callback

Copy reused memory inside the callback before storing or scheduling it.

Sample duration or FFT spacing is wrong

Distinguish scalar values from IQ pairs; use the actual device sample rate.

Tail of a block looks stale

The sampler publishes a full buffer even after a short read. Handle incomplete blocks in the reader adapter.

AM estimate is wrong or non-finite

Feed FFT coefficients to GetAm; verify carrier/DC reference, bin alignment, and component order.

Simulation runs faster than expected

The simulator generates samples on demand and does not pace wall-clock time.

Negative DDM where a positive value was expected

GetDdm computes first minus second. Match the simulator type and application subtraction order.

ADS-B parser produces no messages

Verify interleaved magnitude input to the detector, half-bit decisions, preamble, sample rate, CRC behavior, and registered factories.

Native library fails to load

Match OS and architecture; install the vendor runtime and its dependent libraries.

UI freezes or callbacks are slow

Callbacks normally execute in the acquisition path. Copy data before scheduling UI or long-running work.