RFLink 433MHz
WiFi Gateway
ESP32-C3 based IoT device bridging 433MHz radio signals from sensors and remotes to home automation platforms. Follow this guide for assembly and configuration.
Two Operating Modes
This gateway supports two distinct operating modes. Pick the one that fits your home automation setup â you can switch between them at any time.
đ Mode 1 â USB Native
Connect the gateway with a USB-C cable directly to your Home Assistant / Domoticz / Jeedom host. The device appears as a standard serial port and streams RFLink text protocol (20;XX;... frames).
đ Jump to USB setup
đ¶ Mode 2 â WiFi + MQTT
The gateway connects to your WiFi network and publishes decoded RF frames to an MQTT broker. No USB cable to the server needed â place the device where RF reception is best.
Contents & Requirements
đŠ In the Box
- Gateway module
ESP32-C3 + RFM69HW, preflashed with the latest firmware - 433MHz spring antenna
Soldered or screwed onto the antenna pad - Black plastic case (optional)
đ ïž You Will Need
- USB-C cable â not included
- 5V USB power source
Phone charger, PC port, or power bank - Smartphone or computer with WiFi
- MQTT broker
e.g. Mosquitto â for WiFi mode only - Home automation server
Home Assistant, Domoticz, or Jeedom
Hardware Setup & Power
Connect the Antenna
Solder or screw the 433MHz spring antenna onto the PCB antenna pad before powering the device. The antenna should stand vertically for best reception.
Power the Device via USB-C
Plug a USB-C cable between the gateway and a 5V power source. The device boots in 2â3 seconds.
USB Connection to Home Automation Host
Connect the gateway with USB-C to the machine running your home automation server. The device exposes a virtual serial port streaming RFLink text frames (20;XX;...).
đ Find the Serial Port
After plugging the cable, the device appears as:
- Linux:
/dev/ttyACM0or/dev/serial/by-id/usb-Espressif_* - Windows:
COM3,COM4⊠- macOS:
/dev/tty.usbserial-*
/dev/serial/by-id/... rather than /dev/ttyACMx â the by-id path is stable across reboots and USB re-plugs.đ Integration Guides
Domoticz â RFLink Gateway USB
Setup â Hardware â add RFLink Gateway USB, select the serial port, give it a name, click Add.
Home Assistant â RFLink Integration
Add to configuration.yaml:rflink:
port: /dev/serial/by-id/usb-xxxx
Jeedom â RFLink Plugin
Install the official RFLink plugin, select the serial port, enable the daemon.
WiFi & Portal Configuration
Connect to the Gateway WiFi
On first boot (or if the configured network is unreachable), the gateway opens a temporary WiFi Access Point. From your phone or PC, scan for networks and connect.
Open the Configuration Portal
Open a web browser and navigate to http://192.168.4.1. The captive portal should open automatically on most phones.
Username:
rflink32 â Password: 433mhzChange it after first login.
Configure Your Home WiFi
In the portal, open the WiFi tab. Enter your home network's SSID and password, then save. The device reboots and joins your LAN.
âïž RFLink Configuration
MQTT & Home Automation
Configure the MQTT Broker
Open the MQTT tab in the portal and enter your broker's connection details. The gateway will publish all decoded RF frames as MQTT messages.
Integrate With Your Home Automation
Once MQTT is connected, your home automation platform can auto-discover devices or subscribe to the configured topics.
đ§ Domoticz â Detailed Setup
| 1 | Install Mosquitto (or any MQTT broker) on the same machine as Domoticz. |
| 2 | Go to Setup â Hardware in Domoticz. |
| 3 | Add hardware of type "MQTT Client Gateway with LAN interface". |
| 4 | Set remote address = IP of your broker, port = 1883 (or 8883 for TLS), username/password if required. |
| 5 | Enable "Accept new Hardware Devices" in Settings. Devices appear automatically as soon as they transmit. |
â Full guide on Domoticz MQTT Wiki
Home Assistant
MQTT integration â topic rflink/#
Domoticz
MQTT Client Gateway (see above)
Jeedom
jMQTT plugin + RFLink plugin
Supported RF Protocols (433 MHz)
The gateway decodes 50+ RX protocols and transmits 20+ TX protocols. Here are the main device categories supported:
đ Switches & Dimmers
đĄïž Weather & Sensors
đ Doorbells
đš Security & Alarms
đ„ Smoke Detectors
đȘ Motorized Devices
đĄ Other
Updates & Troubleshooting
âïž OTA Firmware Updates
Update the firmware directly from the web portal â no USB needed.
- Download the latest
.binfrom the GitHub releases page - Open the OTA tab in the web portal
- Upload the .bin file and click Update
- Wait for the device to reboot (~10 seconds)
đ ïž Troubleshooting
| Problem | Solution |
|---|---|
| Can't find RFLink-AP | Power-cycle the device, wait 20s, then scan again |
| WiFi not connecting | Check SSID/password â 2.4 GHz only |
| No MQTT data | Verify broker IP, port and credentials; test with MQTT Explorer |
| Weak RF reception | Relocate device away from PC/router; ensure antenna is vertical |
| Unknown protocol | Enable Plugin 254 (signal analysis) in the RF tab |
| USB port not detected | Check the cable (data-capable), try another port, install CH340/CP210x drivers if needed |