Vorab
Inzwischen gibt es auch eine Möglichkeit, die Firmware direkt im Webbrowser von GitHub zu aktualisieren: 📗 Firmware-Update direkt von GitHub. Voraussetzung dafür ist, dass du eine Firmware installiert hast, die mind. vom 10.7.2026 ist.
Einführung
Das Einrichten von Platformio samt des Managements mit git ist nicht ganz trivial. Wer sich das sparen möchte, kann fertige Firmwares auch runterladen und über ESPuinos Webinterface flashen. Da dann jedoch für’s Debugging keine serielle Konsole mehr vorhanden ist, könnte Webterminal helfen. Im Normalfall sollte es dabei jedoch keine Probleme geben.
Firmware-Repository
Zum Ablegen/Archivieren der Firmwares habe ich ein eigenes Repository angelegt: ESPuino-Firmware. Mit jedem Commit, der in ESPuino in den Branches master und dev gemacht wird, werden dort, sofern der Bauprozess erfolgreich war, Firmwares hochgeladen.
Beispiel mit Commit-ID d0c093d aus dem master-Branch:
Das landet dann in ESPuino-Firmware im dev-Unterverzeichnis und die Commit-ID ist Teil der dortigen Commit-Message:
Brauchst du eine ältere Firmware, so klickst du rechts oben auf „History“.
Unterstützte HALs
Unterstützt werden aktuell folgende HALs / Plattformen (wobei ttgo_t8 und lolin_d32_pro vermutlich mittelfristig entfallen werden):
- lolin_d32_pro
- lolin_d32_pro_sdmmc_pe
- complete
Gebaut/Kompiliert wird mit den ESPuino-Standardeinstellungen (und Port-Expander wenn nötig), so dass sich in Summe aus der Kombinatorik (Stand 05/2026) acht unterschiedliche Firmwares ergeben.
Das Firmware-Repository ist nach Branches unterteilt. D.h. Commits aus Master und dev sind auch dort getrennt.
Wie kommt die Firmware auf den ESPuino?
Alle Boards, die ich ausliefere, sind bereits vorgeflasht mit Autoerkennung für den RFID-Reader. ESPuino lässt sich also starten (auch ohne passenden RFID-Reader) und du kannst das Webinterface erreichen. Zum Aktualisieren der Firmware kannst du dir diese entweder bei GitHub runterladen und über das Webinterface flashen. Oder du nutzt die Komfortfunktion, die seit dem 10.7.2026 im dev-Branch verfügbar ist: 📗 Firmware-Update direkt von GitHub.
Nach dem Auswählen des zuvor runtergeladenen Firmware-Files klickst du auf Absenden. Das Ganze dauert ungefähr eine Minute und ESPuino sollte im Anschluss neu starten.
Achte UNBEDINGT darauf, die passende Firmware zu flashen. Für >90 % aller ESPuino-User sind nur die nachfolgenden HALs von Relevanz:
- mini4L (mit LFP-Develboard oder Lolin D32 pro): lolin_d32_pro_sdmmc_pe
- ESPuino-miniD32 (mit LFP-Develboard oder Lolin D32 pro): lolin_d32_pro_sdmmc_pe
- Complete: complete
Beachtest du das nicht und flashst die falsche Firmware, so startet dein ESPuino ggf. nicht mehr und die Hardware kann sogar Schaden nehmen. Das gilt allerdings auch beim Kompilieren über Platformio und ist insofern keine Neuigkeit/Besonderheit.
Was mache ich, wenn ich spezielle Compile-Flags benötige?
Brauchst du Support für spezielle Features, die nicht über das Webinterface konfigurierbar sind, so musst du dir Firmware leider weiterhin selbst kompilieren. Es sind allerdings auch schon viele Optionen im Webinterface vorhanden, für die entsprechend keine Firmware extra kompiliert werden muss. Wir arbeiten daran, weitere umzuziehen.
Klicke im Webinterface auf „Allgemein“: Dort findest du einerseits einige Optionen, die bereits jetzt über das Webinterface konfigurierbar sind:
Andererseits gibt es dort auch erweiterte Einstellungen, mit denen man Neopixel-Einstellungen und das dyn. Button-Layout konfigurieren kann. Auch die Drehrichtung des Drehencoders kann man dort umkehren. Suche dafür nach „Erweiterte Einstellungen“ und blende sie ein:
Was mache ich, wenn mein HAL nicht dabei ist?
- Aufgrund Speichermangels mussten verschiedene HALs leider abgekündigt werden, da kein PSRAM vorhanden ist. Hier ist es leider notwendig, auf die Complete zu wechseln.
- A1S besitzt PSRAM, wurde jedoch mangels Interesse und verfügbarer GPIOs eingestellt.
- Firmwares für Custom-Boards können natürlich auch keine bereitgestellt werden.
