Firmware Upload Step-by-Step

About

Mattzobricks Core Development Member Max has written this beginner’s step-by-step guide to upload the firmware for the Arduino-based MattzoControllers (MLC, MTC4PF, MTC4PU).

The guide is valid for firmware version 0.5 and 0.5.1.

WARNING: the instructions will not be accurate for firmware versions below and above that.

Step-by-step Guide

Follow these steps to upload the firmware on your first MattzoController:

1. Arduino IDE
   1.1 install Arduino IDE (https://www.arduino.cc/en/software)
   1.2 start IDE
   I (optional): Notepad ++ (https://notepad-plus-plus.org/downloads)
2. Firmware
   2.1 Firmware download (https://mattzobricks.com/de/controllers/firmware-history-and-roadmap)
3. Customize MattzoController_Network_Configuration.h according to your network settings
   3.1 SSID
   3.2 PSK
   3.3 MQTT IP
   3.4 OTA_PASSWORD (recommended)
4. USB Driver for ESPs
   4.1 download drivers here: https://42project.net/treiber-fuer-den-ch340g-seriell-zu-usb-adapter-oft-auf-arduino-uno-r3-boards-verbaut/
   4.2 install the drivers (othervise a connection to your ESP trough a COM port won’t work)
5. Arduino IDE Boards
   Addiational Ressource: https://arduino-esp8266.readthedocs.io/en/3.0.2/installing.html#boards-manager
   5.1.1 Add additional Board Manager URL (ESP8266): https://arduino.esp8266.com/stable/package_esp8266com_index.json (comma seperated)
   5.1.2 Tools -> Board * -> Boardmanager -> ESP8266 by ESP8266 Community -> Version 2.7.4 only (04.02.2022)
   5.1.3 Review your board settings
   5.2.1 Add additional Board Manager URL (ESP32): https://dl.espressif.com/dl/package_esp32_index.json (comma seperated)
   5.2.2 Tools -> Board * -> Boardmanager -> ESP32 Arduino -> Tested version: 1.0.4 (04.02.2022)
   5.2.3 Review your board settings
6. Arduino IDE Libraries
   Addiational Ressource: https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries
   6.1 EEPROM (built in)
   6.2 PubSubClient (PubSubClient by Nick O’Leary – tested with version 2.8.0)
   6.3 Arduino OTA (ArduinoOTA by Juraj Andrassy – tested with version 1.0.7)
   Addiational Ressource – Importing a .zip Library: https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries
   6.4 TinyXML2 (https://github.com/leethomason/tinyxml2 – verify tinyxml2-master trough “Menu -> Sketch -> Include Library)
   6.5 Syslog (https://github.com/arcao/Syslog – verify syslog-master trough “Menu -> Sketch -> Include Library)
   6.6 MattzoBricks (please finde detailed instructions here: https://mattzobricks.com/de/controllers/firmware-history-and-roadmap -> Code Structure)

After installation and configuration, you should be able to upload the MattzoBricks firmware to the MattzoController.

Pictures and Screenshots