How j-mazz/rf-detector works
rfdet is a streaming RF-energy observation tool: users configure a mock, raw SC16 replay, or optional SoapySDR capture, then receive frequency-band event records and operational health. The documented analysis path is continuous FFT-based detection; events are emitted as begin/update/end records, with bounded pipeline resources and loss accounting. The graph preserves the named runtime modules and README capabilities, but source excerpts cover only CLI orchestration, so internal module-to-module calls are shown only where documented rather than inferred from module names.
Main entry points: pipeline.cppm Pipeline System · main.cpp CLI Orchestrator · acquire.cppm Source Adapters · output.cppm CSV Events
Components 17
Input Sources
- Source Adapters
src/rf/acquire.cppm - Soapy Adapter
src/rf/soapy.cppm
Signal Analysis
- Signal Windows
src/rf/signal.cppm - FFT Analysis
src/rf/fft.cppm - Band Detector
src/rf/dsp.cppm - SIMD Kernels
src/rf/simd.cppm - Core Utilities
src/rf/core.cppm
Pipeline Runtime
- Pipeline System
src/rf/pipeline.cppm - Fixed Pools
src/rf/memory.cppm - Stage State
src/rf/runtime.cppm - CLI Orchestrator
src/main.cpp
Events and Health
- CSV Events
src/rf/output.cppm - Health Monitor
src/rf/health.cppm
Other components
- CLI User
- SC16 Capture
- SDR Receiver
- Event CSV
Connections 19
- CLI User → CLI Orchestrator: configures run
src/main.cpp - SC16 Capture → Source Adapters: replayed as samples
README.md - SDR Receiver → Soapy Adapter: provides samples
- CLI Orchestrator → Source Adapters: selects source
src/main.cpp - CLI Orchestrator → Soapy Adapter: selects device
src/main.cpp - CLI Orchestrator → Pipeline System: constructs and initializes
src/main.cpp - CLI Orchestrator → CSV Events: configures callback
src/main.cpp - CLI Orchestrator → Health Monitor: reports status
src/main.cpp - Source Adapters → Pipeline System: feeds capture
- Pipeline System → Signal Windows: analyzes windows
README.md - Signal Windows → FFT Analysis: transforms samples
README.md - FFT Analysis → Band Detector: supports detection
README.md - Band Detector → SIMD Kernels: uses kernels
- Pipeline System → Fixed Pools: uses fixed pools
README.md - Pipeline System → Stage State: updates counters
- Pipeline System → CSV Events: dispatches events
README.md - CSV Events → Event CSV: writes records
- Health Monitor → Stage State: observes status
README.md - Pipeline System → Core Utilities: uses utilities