How gercap/gr-ofdm_tools works
This repository is a collection of GNU Radio SDR tools, not one end-to-end application. A typical user runs a radio or sensing flow: sample streams are processed into OFDM communications or spectrum observations, which may then be visualized, logged, or used by cognitive-radio control. The graph preserves the README’s sensing, cognitive-radio, remote-processing, dynamic-access, plotting, and communications capabilities. Several core modules are indexed but not excerpted, so their internal calls are omitted; dashed edges mark documented capabilities whose wiring is not shown.
Main entry points: ofdm_cr_tools.py OFDM CR tools · cognitive_engine_mac.py Cognitive MAC · spectrum_sensor.py Spectrum sensor · flanck_detector.py Flanck detector
Components 27
Radio and OFDM
- OFDM radio
python/ofdm_radio_hier.py - Sync radio
python/sync_radio_hier.py - OFDM TX/RX
python/ofdm_tx_rx_hier.py - TX/RX modules
python/ofdm_txrx_modules.py - OFDM CR tools
python/ofdm_cr_tools.py - Chat blocks
python/chat_blocks.py - Payload source
python/payload_source.py - Payload sink
python/payload_sink.py
Spectrum sensing
- Spectrum sensor
python/spectrum_sensor.py - Sensor v1
python/spectrum_sensor_v1.py - Sensor v2
python/spectrum_sensor_v2.py - Flanck detector
python/flanck_detector.py - Coherence detector
python/coherence_detector.py - Multichannel scanner
python/multichannel_scanner.py - Spectrum sweeper
python/spectrum_sweeper.py
Cognitive control
- Cognitive MAC
python/cognitive_engine_mac.py
Remote processing
- Local FFT worker
python/local_worker.py - ASCII remote client
python/remote_client.py - Qt remote client
python/remote_client_qt.py - WebSocket server
sdr_webserver/sdr_webserver_ws.py - Local hardware gateway
sdr_webserver/local_hw_gateway.py - Remote monitor
sdr_webserver/remote_monitor.py
Visualization and tools
- ASCII plotting
python/ascii_plot.py - Spectrum logger
python/spectrum_logger.py - PSD logger
python/psd_logger.py - Gnuplot output
python/ascii_gnuplot.py
Other components
- SDR user
Connections 28
- SDR user → OFDM radio: runs radio
- SDR user → Spectrum sensor: runs sensing
- SDR user → Cognitive MAC: uses cognitive radio
- SDR user → Local FFT worker: uses remote processing
- SDR user → ASCII plotting: views plots
- Cognitive MAC → Spectrum sensor: receives sensing data
python/cognitive_engine_mac.py - Cognitive MAC → OFDM radio: publishes radio PDUs
python/cognitive_engine_mac.py - Cognitive MAC → Sync radio: publishes sync PDUs
python/cognitive_engine_mac.py - Spectrum sensor → OFDM CR tools: uses analysis tools
python/spectrum_sensor.py - Sensor v1 → OFDM CR tools: uses analysis tools
python/spectrum_sensor_v1.py - Sensor v2 → OFDM CR tools: uses analysis tools
python/spectrum_sensor_v2.py - Flanck detector → OFDM CR tools: uses analysis tools
python/flanck_detector.py - Coherence detector → OFDM CR tools: uses analysis tools
python/coherence_detector.py - Multichannel scanner → OFDM CR tools: uses analysis tools
python/multichannel_scanner.py - ASCII remote client → ASCII plotting: renders FFT data
python/remote_client.py - SDR user → OFDM TX/RX: uses OFDM links
- SDR user → Chat blocks: uses communications
- SDR user → Multichannel scanner: uses spectrum sensing
- SDR user → Flanck detector: uses spectrum sensing
- SDR user → Coherence detector: uses spectrum sensing
- SDR user → Spectrum sweeper: uses spectrum sensing
- SDR user → Qt remote client: uses remote processing
- SDR user → WebSocket server: uses remote processing
- SDR user → Local hardware gateway: uses remote processing
- SDR user → Remote monitor: uses remote processing
- SDR user → Spectrum logger: logs observations
- SDR user → PSD logger: logs observations
- SDR user → Gnuplot output: plots data