Skip to content

Installation

Jump to bottom
David Panusch edited this page Oct 27, 2026 · 1 revision

🇩🇪 Deutsch | 🇬🇧 English

Installation

Es gibt zwei Wege zur fertigen Uhr:

  • Selbst kompilieren: Nur so lässt sich die Uhr über Konfiguration (include/Config.h) an Layout, Sprache und Hardware anpassen. Für die meisten Nachbauten ist das der richtige Weg.
  • Fertige Firmware flashen: schneller, aber mit fest einkompilierter Standard-Konfiguration.

Viele USB-Boards (NodeMCU, Wemos D1 Mini) brauchen einen Treiber für CH340 oder CP210x. Zum Flashen ein Datenkabel verwenden, kein reines Ladekabel.

Selbst kompilieren

Benötigt werden PlatformIO (Core oder IDE), Node.js und Git. Node.js wird für den Bau der Weboberfläche gebraucht.

Die Umgebungen in platformio.ini heißen ESP8266, ESP32 und ESP32C3.

Windows (VS Code)

  1. PlatformIO IDE installieren (bringt Visual Studio Code mit), dazu Node.js und Git.
  2. In VS Code erscheint links ein PlatformIO-Symbol (Ameisenkopf).
  3. Quick Access → Miscellaneous → Clone Git Project wählen und https://github.com/ESPWortuhr/Multilayout-ESP-Wordclock eintragen.
  4. Unter Projects das Projekt mit Add Existing hinzufügen und öffnen.
  5. Den ESP per USB anschließen. Unter Project Tasks die passende Umgebung aufklappen und General → Upload wählen.

Der erste Build dauert einige Minuten, weil PlatformIO alle Bibliotheken lädt. Am Ende erscheint SUCCESS.

macOS

brew install platformio node
git clone https://github.com/ESPWortuhr/Multilayout-ESP-Wordclock.git
cd Multilayout-ESP-Wordclock
pio run -e ESP8266 -t upload

Linux

python3 -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
sudo apt install npm git
git clone https://github.com/ESPWortuhr/Multilayout-ESP-Wordclock.git
cd Multilayout-ESP-Wordclock
pio run -e ESP8266 -t upload

Für den Zugriff auf den seriellen Port den eigenen Benutzer der Gruppe dialout hinzufügen (sudo usermod -a -G dialout $USER) und neu anmelden.

Fertige Firmware

Auf der Releases-Seite liegt pro Chip eine Datei, z. B. ESP8266_V5.0.0.bin, dazu SHA256SUMS zum Prüfen.

Standard-Konfiguration: deutsches Layout Ger10x11Alternative, GRB-LEDs, RTC DS3231, I2C aus. Layout, LED-Typ und vieles mehr lassen sich danach in der Weboberfläche umstellen. Eine andere RTC (z. B. DS1307) oder fest einkompilierte WLAN-Daten erfordern einen eigenen Build.

Update über WLAN (OTA)

Läuft auf der Uhr bereits eine Firmware, geht das Update ohne Kabel:

  1. http://<IP-der-Uhr>:81/update öffnen (Port 81).
  2. Die .bin-Datei auswählen und hochladen.
  3. Die Uhr startet neu. Einstellungen bleiben erhalten, außer der Changelog meldet einen Reset (beim Wechsel von 4.x auf 5.x).

Ist WEB_PROTECTED aktiv, fragt die Update-Seite nach WEB_USER und WEB_PASSWORD.

Serielles Flashen mit esptool

Für ein neues Board oder eine Uhr, die nicht mehr startet. Voraussetzung: pip install esptool.

# ESP8266 (NodeMCU, Wemos D1 Mini)
esptool.py --chip esp8266 --port /dev/ttyUSB0 write_flash 0x0 ESP8266_V5.0.0.bin

# ESP32 und ESP32-C3: die Datei enthält nur die Anwendung
esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash 0x10000 ESP32_V5.0.0.bin

Der Port heißt unter Windows COM3 o. ä., unter macOS /dev/cu.usbserial-*.

Im Browser flashen

Werkzeug Anmerkung
esptool-js Offizielle Browser-Version von Espressif, Datei und Offset von Hand eintragen
esp.huhn.me Schlichtere Oberfläche, ebenfalls mit freiem Offset

Es gelten dieselben Offsets wie bei esptool. Web Serial funktioniert nur in Chromium-Browsern (Chrome, Edge, Opera) über HTTPS. Vorher alle seriellen Monitore schließen.

Leerer ESP32 oder ESP32-C3

Der Offset 0x10000 schreibt nur die Anwendung. Ein komplett leerer Chip braucht zusätzlich Bootloader (0x1000, beim ESP32-C3 0x0) und Partitionstabelle (0x8000). Diese Dateien liegen nicht im Release. In dem Fall einmal mit pio run -e ESP32 -t upload flashen, danach gehen Updates über WLAN.

Nightly-Builds

Für jeden Stand von main baut Actions → Nightly Firmware die Firmware für alle drei Chips. Unter Artifacts des obersten erfolgreichen Laufs liegen firmware-ESP8266, firmware-ESP32 und firmware-ESP32C3.

  • Das Archiv enthält die .bin (<Chip>_V<Version>_<Commit>.bin), eine .sha256-Prüfsumme und die .elf zum Auflösen von Absturz-Backtraces.
  • Download nur mit GitHub-Login, Löschung nach 14 Tagen.
  • Ungetestete Entwicklungsstände. Für eine stabile Uhr das Release nehmen.

Wechsel von 4.x auf 5.0.0

Das Update setzt alle Einstellungen auf Standardwerte zurück. Vorher Hardware-Pins, MQTT, OpenWeatherMap und Layout notieren. Die Minutenvariante „Ecken“ gibt es nicht mehr, die 11 × 11-Layouts nutzen die normalen Minuten-LEDs.

Weiter: Einrichtung

🇩🇪 Deutsch

🇬🇧 English

Repository · Releases

Clone this wiki locally