8. Schnellstart Anleitung deutsch

Roc-MQTT-Display Schnellstart Anleitung

A quickstart guide in German language.
Dies ist nur eine Kurzanleitung, alle Details stehen im Wiki https://github.com/chrisweather/RocMQTTdisplay/wiki

Benötigte Hardware

• 1x Lolin/Wemos D1 mini (4MB flash memory) oder Lolin/Wemos D1 mini pro (16MB) oder einen Nachbau mit ESP8266 Chip mit mind. 4 MB. ESP32 basierte Controller funktionieren derzeit nicht!
• 1x I2C Multiplexer TCA9548A
• 1-8 OLED Displays 0.91“ 128x32 I2C mit (oder alternativ 128x64, 64x48, 96x16)

Benötigte Software und Konfiguration

• Installiere die aktuellste Arduino Entwicklungsumgebung (IDE) von https://www.arduino.cc/en/software
  Wird benötigt um die Roc-MQTT-Display Software zu kompilieren und auf den Controller zu übertragen.

In der Arduino IDE

• Datei / Voreinstellungen / Bordverwalter URL - folgende Zeile eintragen bzw. ergänzen:
  https://arduino.esp8266.com/stable/package_esp8266com_index.json

• Werkzeuge / Board / Boardverwalter
  esp8266 suchen und installieren

• Werkzeuge / Board
  "LOLIN(WEMOS) D1 R2 & mini" auswählen
  Falls ein anderes ESP8266 board verwendet wird bitte entsprechend anpassen.

• Werkzeuge / Bibliotheken verwalten...
  Dort die folgenden Bibliotheken suchen und installieren:

  • ArduinoOTA by Juraj Andrassy https://github.com/jandrassy/ArduinoOTA
  • ArduinoJson by Benoît Blanchon https://github.com/bblanchon/ArduinoJson
  • U8g2 by Oliver Kraus https://github.com/olikraus/u8g2
  • EspMQTTClient by Patrick Lapointe https://github.com/plapointe6/EspMQTTClient
  • TaskScheduler by Anatoli Arkhipenko https://github.com/arkhipenko/TaskScheduler

LittleFS-PlugIn
Um Dateien in das Dateisystem des Controllers zu übertragen muss folgendes Tool installiert werden: https://github.com/earlephilhower/arduino-esp8266littlefs-plugin Derzeit aktuelle Version: https://github.com/earlephilhower/arduino-esp8266littlefs-plugin/releases/download/2.6.0/ESP8266LittleFS-2.6.0.zip

Im Arduino\sketchbook Ordner einen Ordner "tools" anlegen und das .zip darin entpacken. Arduino IDE beenden und neu starten.

Arduino IDE / Werkzeuge
Ein neuer Eintrag "ESP8266 LittleFS Data Upload" ist dazugekommen. Wird dieser Eintrag ausgewählt wird der gesamte Inhalt des Ordners Arduino\sketchbook\RocMQTTDisplay\data auf den Controller kopiert.

Roc-MQTT-Display herunterladen
https://github.com/chrisweather/RocMQTTdisplay
Code (grüner Button)
Download ZIP

Zip entpacken in den Arduino\sketchbook Ordner

Die Ordnerstruktur sieht dann idealerweise wie folgt aus, ggfs. anpassen:

Arduino\sketchbook\RocMQTTdisplay\

• RocMQTTdisplay.ino
• config.h
• template.h
• web.h

Arduino\sketchbook\RocMQTTdisplay\data\

• 404.htm
• congig.htm
• index.htm
• sec.htm
• tpl1.htm
• tpl2head.htm
• tpl2body.htm
• tpl2imp.htm
• rmd.css
• rmdcfg.txt - Konfigurationsdatei mit den Standardeinstellungen
• rmdsec.txt - Login Daten für Wifi, OTA, MQTT
• rmdtpl.txt
• rmdtpl00.txt - Template T0
• rmdtpl01.txt - Template T1
• rmdtpl02.txt - Template T2
• rmdtpl03.txt - Template T3
• rmdtpl04.txt - Template T4
• rmdtpl05.txt - Template T5
• rmdtpl06.txt - Template T6
• rmdtpl07.txt - Template T7
• rmdtpl08.txt - Template T8
• rmdtpl09.txt - Template T9

Arduino\sketchbook\RocMQTTdisplay\templates\

• Template-Sammlung für diverse Displaygrößen
• Templates können über die Template Import Funktion im- bzw. exportiert werden.

WLAN Verbindung einrichten
Im Ordner Arduino\sketchbook\RocMQTTdisplay\data
die Datei rmdsec.txt mit einem Texteditor öffnen (Notepad++ wird empfohlen, https://notepad-plus-plus.org/) und den eigenen WLAN Namen (SSID) und das WLAN Passwort eintragen und speichern.

Ggfs. auch die Datei rmdcfg.txt anpassen, z.B. bereits hier die IP-Adresse des MQTT Brokers eintragen

Arduino IDE / Datei / Öffnen...
im Arduino\sketchbook\RocMQTTdisplay Ordner die Datei RocMQTTdisplay.ino öffnen

• ESP8266 controller per USB Kabel an den PC anschließen

Arduino IDE / Werkzeuge / Port
den entsprechenden Port auswählen an dem der ESP8266 am PC angeschlossen ist.

Arduino IDE / Werkzeuge / Serieller Monitor
115200 Baud auswählen

Arduino IDE / Sketch / Hochladen auswählen
Roc-MQTT-Display wird jetzt kompiliert und auf den Controller geladen.

http://rocmqttdisplayc01 im Browser aufrufen
Der Webserver mit der Konfigurationsseite des Controllers wird aufgerufen. In Configuration / "MQTT broker IP-address" die IP Adresse Deines MQTT Brokers eintragen. Hast Du keinen geht es hier weiter: https://mosquitto.org/download/
Ich empfehle einen MQTT Broker auf einem Raspberry Pi zu installieren.

Anzahl verbundener Display einstellen (Number of connected displays)

• Speichern mit Save
• Home
• Restart

Beim Start zeigt der Serielle Monitor an was gerade geladen wird.

Jetzt noch einen Sender für Display Inhalte einrichten, z.B. Rocrail oder Node-Red.
Beispiele unter https://github.com/chrisweather/RocMQTTdisplay/tree/main/demo

Der Controller kann ab jetzt an einem USB Netzteil statt am PC betrieben werden. Die Konfiguration ist weiterhin unter http://rocmqttdisplayc01 erreichbar und Updates der Software oder Dateien aus dem data Ordner können per Over The Air (OTA) Updates aus der Arduino IDE übertragen werden. Arduino IDE / Werkzeuge / Port, hier kann der Controller jetzt anhand seines Namens ausgewählt werden.

Fertig.
Viel Spaß!