Rflink with mqtt V2 : enhanced and minimized
Some years ago, I built a custom shield for an arduino mega running Rflink. The purpose was to
provide Rflink MQTT messages over ethernet. I recently built a new version which is more compact and with additional features.
I replaced the arduino nano by a Wemos D1 mini (esp8266). I also used an arduino mega pro, which is smaller than the orignal one. The 433Mhz hardware has been changed to by SRX 882 and STX882 as the provide a better range than RXB6 and XD-FST FS1000A.
Main features are :
- Provides Rflink messages as json encoded payload over MQTT (like previous version)
- OTA updates of the Wemos D1 mini
- Leds indicators for Wifi, Mqtt, message in, message out and http connections
- Simple http interface to view Rflink and Mqtt messages
EDIT on 03.01.2023 : The First version was using SoftwareSerial on D1 and D2 to communicate with RFlink. But at 57600 bauds, from time to time some serial characters were lost and / or trashed. So I updated the code and the hardware to use SoftwareSerial for serial debugging and the hardware serial port is now used for the Rflink communication through D7 and D8 (using the swap() functionn). I updated the text of this post, but not the photos.
The updated source code is available on github : https://github.com/jit06/RflinkToJsonMqtt
The new 3d enclosure can be found on Thingiverse : https://www.thingiverse.com/thing:5415688
Hardware build
Used parts
- Arduino mega Pro : rflink works only on Mega hardware
- Wemos D1 mini : any esp8266 should do the trick
- SRX882 and STX882 kit with antennas : any other combinaison supported by Rflink will work
- Multicolor LEDs breadboard found on ebay
- Some wires / solder / soldering iron
Wiring tables
| SRX882 | Arduino Mega Pro | Comments |
|---|---|---|
| VCC | 3v3 | power for SRX882 |
| GND | GND | ground |
| Data | D19 | as seen on rflink instructions |
| STX882 | Arduino Mega Pro | Comments |
|---|---|---|
| VCC | 3v3 | linked with SRX882 |
| GND | GND | linked with SRX882 |
| Data | D14 | as seen on rflink instructions |
| Wemos D1 mini | Arduino Mega Pro | Comments |
|---|---|---|
| 5V | Voltage regulator pin | see below |
| GND | GND | ground |
| D7 | TX | serial connection (EDIT – was connected to D1 in the previous version) |
| D8 | RX | serial connection (EDIT – was connected to D2 in the previous version) |
| Wemos D1 mini | Leds breadboard | Comments |
|---|---|---|
| D0 | Led 1 – blue | Wifi signal : blink while trying to connect, stay on if connected |
| D1 | Led 2 – green | Mqtt server connection : blink while trying to connect, stay on if connected (was connected to D5 in the previous version) |
| D2 | Led 3 – Yellow | Blink when RF message is received (EDIT – was connected to D6 in the previous version) |
| D5 | Led 4 – orange | Blink when RF order is sent |
| D6 | Led 5 – Red | Stay on if there is at least one HTTP client. Blink while updating esp8266 through OTA (EDIT – was connected to D8 in the previous version) |
Build steps
No real complexity here : I mainly followed the rflink documentation and put in common some VCC and GND connections. Through, note that the ESP8266 is powered via one of the Arduino Pro voltage regulator. The Wemos D1 accepts to be powered through the 5v pin only if the voltage is between 4.3 and 4.6v.
Wiring ground and vcc in common for SRX 882 + STX882 :
Wiring the two RF modules to the Arduino board
Adding leds module to Wemos D1 mini and wiring to Arduino as a Serial reader / writer. Basicaly, the Wemos use the hardware serial interface swapped on D7 and D8 (EDIT – in the previous version, it was using SoftwareSerial on D1 and D2) to communicate with the standard serial pins of the Arduino Mega
3D printed enclosure
The enclosure I made have been printed on a Anycubic I3 Mega in PLA. It tooks around 2 hours. The sources of the model (Freecad 0.19) are available on Thingiverse together the STL files.
The enclosure is a bit tight so everything can be fixed without any skrew, by simply pushing it gently:
Software part
The original code as been modified in several ways :
- Adapted to run on ESP8266 with Wifi instead of Ethernet shield
- Added Leds handling
- HTTP server to show RF activity using websocket connections
- OTA update from Arduino IDE
- Refactored the main sketch to separate functionnalities in different files
The source code is available on my github and can be compiled with Arduino IDE (check Readme.md to install the dependencies).
Usage Example with OpenHab 3
Since the previous article in 2017, I upgraded from Openhab 2 to OpenHab 3 which has a new way to handle messages.
Here is 2 examples of how I use my rflink2mqtt gateway.
Using Oregon OS-THGR228-N-THGR122
- Create a channel with mqtt state topic : “rflink/Oregon_TempHygro/2DD1” (your ID will be different)
- Create an item for each properties, link them to the channel, use JSONPATH profile with the following expression :
- $.BAT for battery status
- $.HUM for humidity
- $.TEMP for temperature
Controlling a Chacon IO switch
- Create a channel configured like the following :
- MQTT state Topic : empty
- MQTT Command Topic : “rflink/Order”
- Custom On/Open Value : “10;NewKaku;0000800;1;ON;” (your id will be different)
- Custom Off/Closed Value: “10;NewKaku;0000800;1;OFF;” (your id will be different)
- Link a switch Item to your channel
As you can see, the gateway allows to write rflink orders directly to mqtt channel “rflink/Order” : the string is passed to Rflink.