Concepts

How are the rr-devices related to Rocrail® and what is needed!

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.

/images/concepts/typical_network.svg

A typical Rocrail network setup

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.