4. Software Installation

• Install the Arduino IDE version 1.8.19 or 2.x from https://www.arduino.cc/en/software.

• Connect your ESPxx via USB, in Tools Menu set Serial Monitor in your IDE to: 115200 Baud

• Allow the port for OTA (default: Port 8266 or 3232) in the Desktop Firewall of your IDE PC

• Install these required libraries in your Arduino IDE or the IDE of your choise

  • ESP8266WiFi https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WiFi
  • ESP8266WebServer https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer
  • LittleFS file system https://github.com/esp8266/Arduino/tree/master/libraries/LittleFS
  • ArduinoOTA by Juraj Andrassy https://github.com/jandrassy/ArduinoOTA
  • ArduinoJson by Benoît Blanchon https://github.com/bblanchon/ArduinoJson
  • U8g2lib 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

-> In case I missed a library/tool or didn't name you as the owner let me know so I can fix it.

For ESP32 controllers there is a small adjustment of the library 'EspMQTTClient' required. In the folder 'C:\Users\Your_Username\Documents\Arduino\libraries\EspMQTTClient\src' in the file 'EspMQTTClient.h' add this line: '#include <WiFi.h>' as per below example.

...
#else // for ESP32

#include <WiFi.h>
#include <WiFiClient.h>
#include <WebServer.h>
#include <ESPmDNS.h>
#include "ESP32HTTPUpdateServer.h"
...

• Chose the constructor for your display resolution in RocMQTTdisplay.ino ~line 82. Default is 128x32 pixel. Optional 128x64, 64x48, 96x16. Only one constructor can be used per controller.

• Compile and Upload the RocMQTTdisplay.ino sketch to the controller.

• Preconfigure 'rmdsec.txt' in the 'data' folder with your WIFI SSID and WIFI Password before uploading it to the controller. I did not include a captive portal for Wifi settings as it's not comfortable to run this procedure for many controllers. Also the Wemos D1 mini has just an emulated EEPROM where the secrets are typically stored. So using the file upload to the file system is nearly the same.

• Important: Upload all files from the 'data' folder from within the Arduino IDE with these tools:

Arduino IDE 1.8.19

• ESP8266 'Tools / ESP8266 LittleFS Data Upload'
  If this option is not available in your IDE install the plugin from here: Arduino ESP8266 LittleFS Filesystem Uploader
  Do NOT use ‘Tools/ESP8266 Sketch Data Upload’, it will not work. It was for the SPIFFS file system which is deprecated for ESP8266.

• ESP32 'Tools / ESP32 Sketch Data Upload'
  If this option is not available in your IDE install the plugin from here: Arduino ESP32 filesystem uploader

Arduino IDE 2.2.1 or higher

• Press Ctrl + Shift + P in the IDE and choose 'Upload LittleFS to Pico/ESP8266/ESP32'
  If this option is not available in your IDE install the plugin from here: Arduino LittleFS Upload