Skip to content

6. Configuration

Chris edited this page Jun 21, 2024 · 44 revisions

Initial Setup

  • Preconfigure 'rmdsec.txt' in the data folder with your WIFI SSID and WIFI Password

{"WIFI_SSID":"Your WIFI SSID","WIFI_PW":"Your WIFI Password","OTA_PW":"","OTA_HASH":"","MQTT_USER":"","MQTT_PW":""}

  • Launch the web based configuration in a browser via
    'http://yourControllerWIFIdevicename' default is 'http://NewRMDcontroller'
    or
    'http://your.controller.IP.address'

    https doesn't work!


Main Page
Most changes are effective immediately when you press the Save button on the following pages. Some settings require a restart of the controller.
New version will be shown, when a new release on GitHub is available.
For future development planning some data (chip model, flash memory size, MAC, display resolution, number of connected displays, RMD version) about the used hardware will be transmitted to a webserver of the author via an included statistics function, when the start page is loaded.

Config Home


Access Settings
Add your WiFi SSID and password to the 'rmdsec.txt' file in the data folder before uploading the data folder to the controller.

Config Secrets


Configuration

Important: You must enter the IP-Adress of your MQTT Broker here. Typically it's the IP-Adress of the device the MQTT broker is installed on, e.g. a Raspberry Pi.
Also set the number of displays connected to your controller (1-8), default: 2

Config

If you plan to run more than 8 displays you need a second or more controllers. For better maintenance have a unique Wifi Devicename for each controller, e.g. RocMQTTdisplayC01, RocMQTTdisplayC02, ...

Display IDs can be e.g. D01 for Display 1. The Display ID is the unique address to send a message to a specific display. For scalability Controller 1 can have D01...D08, Controller 2 can have D09...D16, ... If you need more than 100 displays (D00...D99) you can name the next 100 displays A00...A99, and so on. To reduce the displays you have to address separately you can also use the same ID for more that one display. In that case all displays with the same ID will behave like one display and show also the same content.

Setup One Display, One Controller, no Multiplexer

  • Connect the display directly to the controller. SCL-D1, SDA-D2 for wiring see Wiki / 3. Wiring
  • I2C Multiplexer address: 0
  • Number of connected displays: 1
  • Save configuration and restart the controller

Screenshot Display 1 - when set to 1 it will take a screenshot of display 1 when you click on Save. The picture will be sent to the serial monitor of the Arduino IDE. The screenshot is in XBM format which can be converted with image programs like Gimp to other formats like jpg or bmp.

Config


Template settings for Fonts and Logos
ID, Width, Height can be changed here. Fonts and the Logos are read only at the moment, this will change in future versions. You can change them in the code in template.h

Config Template


Template settings for content fields
In Templates you can define which data is show on a display and where it's positioned and how the text is formatted. So you just include the template ID in your MQTT message sent from the model train software. Here you can change the templates T0 - T9. Most changes are effective immediately when you Save the template. Download the template to edit it in a separate editor, share it with others or simply for backup. The download is in JSON format.

Config Templates Config Templates

With the Import function you can import a template. It must be in a valid JSON format. Roc-MQTT-Display can hold 10 templates, each template has a unique template ID, TPLID (T0, T1, ..., T9). Make sure to enter the correct TPLID in the JSON template before importing it. It will replace the existing template.

Config Templates


Backup Configuration

  • Configuration - Configuration/Download saves the configuration in rmdcfg.txt
  • Fonts&Logos - Fonts,Logos/Download saves the font and logo settings in rmdtpl.txt
  • Templates - Templates/Download saves the selected template in rmdtpl0x.txt

How To - Configure Side A / Side B displays

coming soon

How To - Change field positions

coming soon

How To - Create a new logo

coming soon