merbanan/rtl_433
Rtl 433
This project is a software-defined radio signal decoder and protocol analyzer designed to translate raw radio transmissions from ISM bands into human-readable data. It functions as a tool for capturing radio samples, analyzing pulse timings, and decoding signals from wireless devices.
The system acts as a data bridge, converting decoded radio signals into JSON format for publication to MQTT brokers or exposure via Prometheus-compatible endpoints. It also serves as a signal capture tool capable of recording raw radio samples and demodulated pulses to files for offline analysis and simulated playback.
The software covers a broad range of capabilities, including hardware integration through standardized APIs for receiver tuning, signal processing via noise filtering and multi-frequency polling, and data integration for streaming to time-series databases. It further provides tools for radio protocol analysis by calculating pulse and gap distributions to identify unknown transmission patterns.
Hardware and decoder settings are managed through persistent file-based configuration.
Features
- Wireless Protocol Decoders - Translates raw radio transmissions from ISM bands into human-readable data using software defined radio hardware.
- Radio Signal Decoders - Translates raw radio transmissions from ISM bands into human-readable data using software-defined radio hardware.
- Hardware Abstraction Layers - Interfaces with varied radio hardware through a standardized layer to manage frequency tuning and gain settings.
- Hardware Interface Standardizations - Uses a standardized API to abstract hardware control across different software-defined radio brands.
- Pulse Demodulators - Converts raw radio samples into a sequence of timed pulses and gaps for protocol analysis.
- Frequency Tuning - Provides precise adjustment of receiver frequencies and gain to optimize the capture of radio signals.
- Radio Signal Analysis - Analyzes pulse timings and signal patterns to identify and decode unknown radio transmission protocols.
- Pulse Distribution Analysis - rtlsdr-decoder summarizes the duration of pulses, gaps, and periods to identify unknown transmission patterns.
- Signal Noise Filtering - Uses squelch and autolevel settings to remove background noise and isolate radio transmissions.
- Software Defined Radios - Connects and tunes software defined radio receivers to capture radio signals across various frequencies and bands.
- Protocol Analyzers - Analyzes pulse timings and signal distributions to identify and decode unknown radio transmission patterns.
- Radio - Translates decoded radio signals into JSON format for publication to MQTT brokers.
- Signal Pattern Matchers - Matches demodulated pulse sequences against a library of known device signatures to extract human-readable data.
- MQTT Connectors - Converts decoded signal data to JSON and sends it to an MQTT broker for system integration.
- Time-Series Data Forwarding - Relays decoded radio signals to time-series databases or monitoring systems for long-term storage and visualization.
- IQ Sample Captures - Records raw in-phase and quadrature radio samples from SDR hardware to storage for analysis.
- Pulse Timing Analysis - Summarizes the duration of pulses, gaps, and periods to identify unknown transmission patterns.
- Frequency Scanners - Implements a system to cycle through a list of frequencies to monitor multiple radio bands sequentially.
- Frequency Scanning and Monitoring - rtlsdr-decoder hops between a list of different radio frequencies at set intervals to monitor multiple bands.
- Wireless Signal Recorders - Captures raw radio samples to files for offline analysis, testing, and simulated playback.
- Signal Capture and Replay - Records raw radio samples and demodulated pulses to files for offline analysis and playback.
- Signal Replayers - Reads recorded data files to simulate radio receptions instead of listening to live airwaves.
- Wireless Sensor Monitors - Collects data from wireless sensors and exports it to MQTT brokers or databases for home automation.
- Radio Data Exporters - Routes decoded signal information to various external sinks like MQTT, JSON-RPC, or time-series databases.
- IQ Sample Replays - Feeds recorded raw I/Q signal data back through the decoding pipeline to simulate live radio receptions.
- Prometheus-Formatted HTTP Endpoints - Exposes decoded radio metrics via a Prometheus-formatted HTTP endpoint for remote observation.
