Online-Flashtool Online Flash Tool

Lumi im Browser installieren

Install Lumi in Your Browser

Home-Assistant-Voice-Satellit-Firmware für das Waveshare ESP32-S3-Touch-AMOLED-1.75 — Quelltext auf github.com/mohoel/home-assistant-voice-display. Läuft über ESP Web Tools (Web Serial) in Chrome oder Edge am Desktop — ohne Installation, ohne Terminal.

Home Assistant Voice Satellite firmware for the Waveshare ESP32-S3-Touch-AMOLED-1.75 — source code at github.com/mohoel/home-assistant-voice-display. Runs via ESP Web Tools (Web Serial) in Chrome or Edge on desktop — no install, no terminal.

Voraussetzungen
Requirements
Chrome oder Edge (Desktop) Chrome or Edge (desktop) USB-C-Kabel mit Datenleitung USB-C cable with data lines Waveshare-Board per USB Waveshare board via USB
Dein Browser unterstützt Web Serial nicht. Bitte Chrome oder Edge am Desktop verwenden. Your browser doesn't support Web Serial. Please use Chrome or Edge on desktop. Web Serial ist auf dieser Seite nicht erlaubt. Diese Seite muss über https:// aufgerufen werden (nicht als heruntergeladene Datei). Web Serial isn't allowed on this page. This page must be loaded via https:// (not as a downloaded file).
So läuft das Flashen ab How flashing works
  1. Board per USB anschließen.
  2. Oben auf „Gerät verbinden & flashen" klicken.
  3. Im Auswahldialog des Browsers den seriellen Port des Boards wählen.
  4. Meldet sich kein Port: Board in den Download-Modus bringen — BOOT gedrückt halten, kurz RESET drücken, dann BOOT loslassen — und den Dialog erneut öffnen.
  5. Flashvorgang abwarten (ein bis zwei Minuten). Nicht abstecken.
  6. Direkt danach öffnet sich automatisch das Fenster zur WLAN-Auswahl — ohne weiteren Klick.
  7. Ausnahme: Lief auf dem Board schon exakt dieselbe Firmware-Version (z. B. ein zweiter Testlauf), erkennt ESP Web Tools das, flasht gar nicht neu und zeigt direkt „Change Wi-Fi" statt der Auswahl — derselbe Dialog, nur ein Klick mehr und mit anderer Beschriftung.
  1. Connect the board via USB.
  2. Click "Connect Device & Flash" above.
  3. In the browser's selection dialog, choose the board's serial port.
  4. No port shows up: put the board into download mode — hold BOOT, briefly press RESET, then release BOOT — and open the dialog again.
  5. Wait for flashing to finish (one to two minutes). Don't unplug.
  6. Right afterward, the Wi-Fi selection window opens automatically — no further click needed.
  7. Exception: if the board already ran the exact same firmware version (e.g. a second test run), ESP Web Tools detects that, doesn't flash again, and shows "Change Wi-Fi" directly instead of the selection — the same dialog, just one click further and with a different label.
Wichtig, bevor du klickst Important, before you click

Diese Firmware bringt dein WLAN nicht mit — in eine öffentlich gehostete Datei kann es schließlich nicht hinein. Du trägst es direkt nach dem Flashen im Browser ein; wie das abläuft, steht unten unter „Nach dem Flashen". Danach ist das Gerät fertig eingerichtet, Updates kommen später über Home Assistant.

This firmware doesn't bring your Wi-Fi along — it simply can't go into a publicly hosted file. You enter it right after flashing, in the browser; how that works is described below under "After Flashing". After that, the device is fully set up, and updates come later through Home Assistant.

Nach dem Flashen After Flashing

Direkt nach dem Flashen fragt ESP Web Tools über dieselbe USB-Verbindung nach deinem WLAN (Improv Wi-Fi) — SSID und Passwort einfach im Dialog eintragen, kein Hotspot, kein Gerätewechsel nötig. Das Gerät verbindet sich direkt und meldet sich per mDNS im Netz.

Überspringst du diesen Schritt oder schließt die Seite vorher, findet das Gerät beim nächsten Start — mit Absicht — kein WLAN, denn diese Firmware kennt deines nicht. Es öffnet dann ersatzweise einen eigenen Hotspot, ungefähr Lumi Fallback Hotspot, mit einer Konfigurationsseite dahinter (Captive Portal):

  1. Am Handy oder Laptop mit diesem Hotspot verbinden.
  2. Öffnet sich keine Konfigurationsseite von selbst, im Browser http://192.168.4.1 aufrufen.
  3. Dort das eigene WLAN samt Passwort eintragen und speichern.
  4. Das Gerät verbindet sich damit und meldet sich per mDNS im Netz.

In Home Assistant taucht es danach unter Einstellungen → Geräte & Dienste als ESPHome-Gerät auf. Beim Hinzufügen fragt Home Assistant nach einem Verschlüsselungsschlüssel — das ist ein fest hinterlegter, nicht geheimer Platzhalter:

Bw1nT2P6zfBP++xn1gTvfloJweHwPrXXRj0I01RdKZk=

Dieser Schlüssel steht offen im Quelltext (secrets.public.yaml) und schützt nichts — er ist nur nötig, damit Home Assistant sich überhaupt verbindet. Alles Weitere läuft danach über Home Assistant: Einstellungen sind ganz normale Entities, und neue Firmware-Versionen erscheinen unter Einstellungen → Geräte → Updates mit einem „Installieren“-Knopf — diese Seite braucht es dafür nicht mehr.

Right after flashing, ESP Web Tools asks for your Wi-Fi over the same USB connection (Improv Wi-Fi) — just enter the SSID and password in the dialog, no hotspot, no switching devices needed. The device connects directly and announces itself on the network via mDNS.

If you skip this step or close the page before that, the device — on purpose — finds no Wi-Fi on its next boot, because this firmware doesn't know yours. It then opens its own hotspot instead, roughly Lumi Fallback Hotspot, with a configuration page behind it (captive portal):

  1. Connect a phone or laptop to this hotspot.
  2. If no configuration page opens by itself, open http://192.168.4.1 in the browser.
  3. Enter your own Wi-Fi and password there and save.
  4. The device connects with it and announces itself on the network via mDNS.

It then shows up in Home Assistant under Settings → Devices & Services as an ESPHome device. When adding it, Home Assistant asks for an encryption key — this is a fixed, non-secret placeholder:

Bw1nT2P6zfBP++xn1gTvfloJweHwPrXXRj0I01RdKZk=

This key is right there in the source code (secrets.public.yaml) and protects nothing — it's only needed so Home Assistant can connect at all. Everything else runs through Home Assistant from here on: settings are ordinary entities, and new firmware versions appear under Settings → Devices → Updates with an "Install" button — this page isn't needed for that anymore.