Setup Instructions

Select MQTT as your communication module if you would like to use direct communication using different topics with an MQTT broker.

Note: When using 'native' MQTT, all elements of the various hats will use a different set of topics and no longer react to LocoNet or LLC commands.

Click Save and Restart to make your choice permanent.

After rebooting, the web page will display an additional tab labeled MQTT Configuration. Click the tab to open the MQTT configuration page.

Set the server settings (IP address, port number, user name and password) according to your MQTT broker of choice.

Note: By default, settings for a public MQTT broker (either test.mosquitto.org or broker.hivemq.com) are preinstalled. This is a good setting for just an initial test. If you plan on using an MQTT broker on a regular basis, it is recommended to set up a local broker within your Wifi network. A good solution with plenty of support on YouTube is a Raspberry Pi using Mosquitto.

Set a node name to your liking. This should be a unique name, so no other IoTT Stick should use the same name. If you click the Add MAC Address option, this is automatically ensured as the used name includes the unique MAC address of the Stick.

Note that the LocoNet and DCC topics will not be used when in 'native' MQTT mode. The ping function using the ping topic will still work if activated.

Click Save and Restart to make your settings permanent.

You now can go to the setup page of the selected hat. If it supports direct MQTT communication it will have additional lines for setup of the used topics.