RFX-mod

RFX-mod
Name	RFX-mod
Released	2004
Latest release	3.8.9
Programming language	C, C++
Operating system	Linux, Windows, macOS
License	GNU General Public License
Website	(project site)

RFX-mod is an open-source protocol decoder and controller for radio-frequency devices used in home automation and remote sensing. It translates between wireless transceivers and software by implementing modulation, encoding, and packet handling for a variety of legacy and contemporary devices. RFX-mod serves as a middleware bridge for applications that integrate with hardware such as USB transceivers, microcontrollers, and home-automation hubs.

Overview

RFX-mod provides device-level interoperability for transceivers by implementing signal demodulation, packet parsing, and command generation. Projects and organizations like OpenWrt, Home Assistant, Domoticz, OpenHAB, and Homegear frequently integrate RFX-mod to support 433 MHz and 868 MHz devices from vendors including X10 (industry), Somfy, Oregon Scientific, Velleman, and Xiaomi. RFX-mod supports multiple physical interfaces such as USB, GPIO (General Purpose Input/Output), and serial adapters used by platforms like Raspberry Pi, BeagleBone, and Arduino. Popular hardware that relies on RFX-mod includes the RFXtrx433 transceiver, generic 433/868 MHz modules, and SDR dongles used by projects like RTL-SDR.

Development and History

Development of RFX-mod began in the early 2000s amid growing demand for bridging proprietary remote controls and open-source automation software. The project evolved through contributions from maintainers associated with communities around SourceForge, GitHub, and vendor-specific forums such as Domoticz forum and Home Assistant Community. Influences and collaborations arose from adjacent projects including LIRC, pilight, rtl_433, and OpenMotics. Major milestones included adding support for additional modulation schemes, expanding the library of device protocols, and creating cross-platform bindings for integration with home-automation ecosystems including ioBroker and FHEM.

Architecture and Components

RFX-mod is organized into modular layers: hardware abstraction, demodulators/modulators, protocol parsers, and API bindings. The hardware abstraction layer interfaces with USB devices and GPIO through drivers used by Linux kernel, libusb, and platform-specific subsystems on Windows and macOS. Demodulator modules implement signal handling for amplitude-shift keying, frequency-shift keying, and on-off keying employed by vendors including Velleman, Oregon Scientific, and Somfy. Protocol parsers decode vendor frames into normalized events and commands for systems such as Home Assistant and OpenHAB. API bindings expose messaging through IPC, sockets, and plugin interfaces consumed by automation platforms like Node-RED, MQTT, and Zigbee2MQTT bridges. The codebase is predominantly written in C and C++ with build systems using CMake and autotools.

Installation and Configuration

RFX-mod can be installed from source repositories hosted on platforms like GitHub or via distribution packages maintained by projects such as Debian and Arch Linux. Installation prerequisites often include toolchains provided by GCC, development headers for libusb, and utilities from make. Configuration uses YAML, INI, or JSON files consumed by frontends including Home Assistant and OpenHAB; users define device mappings, interface selection (for USB or GPIO), and protocol filters. On single-board computers such as Raspberry Pi, kernel modules and udev rules are commonly adjusted to grant access to transceivers. Integration with message buses like MQTT and event systems in Home Assistant typically requires configuring credentials, topics, and discovery parameters.

Features and Functionality

RFX-mod implements a comprehensive set of features: multi-protocol decoding, packet replay/transmit, device discovery, and signal logging. It supports a catalogue of remote-control protocols from manufacturers like X10 (industry), Somfy, Oregon Scientific, Velleman, LaCrosse Technology, and Fine Offset. Advanced features include adaptive thresholding for noisy RF environments, timing jitter compensation, and rolling-code handling for supported motor and shutter controllers used by suppliers such as Somfy. Integration points enable event publishing to MQTT, direct control through Home Assistant automations, and scripting support via Python bindings. Diagnostic tools include protocol analyzers, waveform capture compatible with Audacity and SDR toolchains such as gqrx.

Security and Privacy Considerations

Using RFX-mod in domestic and industrial deployments raises concerns around replay attacks, unauthorized remote actuation, and eavesdropping. Many supported devices from vendors like Somfy and X10 (industry) historically lack strong cryptographic protections, making them vulnerable to signal capture and retransmission; mitigation strategies include using devices with rolling codes certified by standards bodies and employing network-level access controls from platforms like Home Assistant and OpenHAB. Secure deployment best practices advise isolating radio interfaces on segmented networks, using authenticated brokers such as Mosquitto with TLS, and applying firmware updates from vendor repositories and community-maintained releases hosted on GitHub or SourceForge.

Community and Support

RFX-mod maintains an active ecosystem supported by contributors across forums, repositories, and chat platforms including GitHub, Stack Overflow, Reddit, and vendor forums for hardware like RFXtrx433. Community resources include protocol libraries, device definition repositories, and integration guides created by projects such as Home Assistant Community, Domoticz forum, and OpenHAB community. Commercial support and hardware-compatible products are available from vendors like RFXCOM and integrators offering consulting for installations in residential and commercial settings. Users commonly contribute new protocol parsers, bug fixes, and device definitions through pull requests and issue trackers hosted on GitHub.

Category:Wireless communication software