Concepts
2 minute read
The rr-devices do not work on its own. It needs a number of components:
- Rocrail® setup to use mqtt
- an mqtt broker
- WiFi
Rocrail
You get Rocrail from https://wiki.rocrail.net/doku.php?id=start. In Rocrail, open a plan then goto “File->Rocrail properties…”.

Rocrail Properties: fill in the MQTT Service properties
Screenshot: Rocrail
Probably save the plan and restart Rocrail to make the settings take effect.
MQTT broker
Any mqtt broker will do, the most used one is mosquitto, it you do not want to use a Username and Password, uncomment, or add a line in mosquitto.conf containing:
allow_anonymous true
The default listen port is 1883, if you change this, you should use this port number in any configuration, in Rocrail and any device you want to use with this mqtt broker. After all the changes (re)start mosquitto!
WiFi
As the remote is not on a wire, WiFi is needed, WPA2 should be enabled to make connection to the rr-devices.
Typical setup
In a typical setup you probably have Rocrail and mosquitto running on the same machine. You have an access point/wireless router somewhere that routes all the network traffic.
The layout is connected to the Rocrail server, or through WiFi.
Why a http server? The software can be updated using OTA, but also through an http server. At the moment during startup a firmware and configuration check is done, but it is optional.