Schließe deinen ESP per USB an und klicke auf den Knopf. Es öffnet sich ein Fenster, in dem du den Anschluss auswählst — der Rest läuft automatisch.
Läuft in Chrome/Edge am PC oder Notebook. Version Firmware 1.7.10
Was du brauchst
- Das Steuergerät: ein Waveshare ESP32-S3-POE-ETH-8DI-8RO (8 Relais, 8 Eingänge, LAN/PoE). Das ist die empfohlene Referenz-Hardware.
- Ein USB-C-Datenkabel — wichtig: ein Datenkabel, kein reines Ladekabel. Damit verbindest du den ESP mit dem Computer.
- Chrome oder Edge auf einem Computer (Windows, macOS, Linux). Handy-Browser, Safari und Firefox können (noch) nicht flashen.
- Ein Netzwerkkabel für den späteren Betrieb (der ESP hängt per LAN/PoE am Netzwerk).
1Firmware aufspielen
- ESP anstecken: Verbinde den ESP mit dem USB-C-Kabel mit deinem Computer.
- Knopf drücken: Klicke oben auf „Firmware installieren".
- Anschluss wählen: Es erscheint ein kleines Fenster mit einer Liste. Wähle den Eintrag deines ESP (oft „USB Serial", „CP210x" oder „CH340") und klicke Verbinden.
- Installieren: Bestätige mit Install. Der Vorgang dauert etwa 1–2 Minuten — nichts abstecken. Am Ende startet der ESP von selbst neu.
2Gerät öffnen
Stecke den ESP jetzt per Netzwerkkabel ans Netzwerk (PoE oder separate Stromversorgung). Er holt sich automatisch eine IP-Adresse (DHCP).
- IP-Adresse finden: Schau im Router unter den verbundenen Geräten nach „pond-aeration". (Falls noch per USB verbunden, zeigt die serielle Ausgabe die IP direkt nach dem Start.)
- Im Browser öffnen: Gib die IP-Adresse in einen Browser ein (z. B.
http://192.168.1.50). Es öffnet sich die Bedienoberfläche des Geräts. - Auf der Oberfläche siehst du Home (Relais/Sensoren), Schedule, Settings, Lizenz, Update, Info und Log.
http://192.168.4.1/). Unter Settings → WiFi dein eigenes WLAN eintragen und speichern; danach ist das Gerät in deinem WLAN erreichbar. Wichtig: Dafür muss die mitgelieferte Antenne angesteckt sein — ohne Antenne funktioniert das WLAN nicht.3Testphase & Freischaltung
Die Firmware ist Donationware: Ein neues Gerät läuft 30 Tage lang voll (Stufe pro) — du kannst alles ausprobieren. Danach fällt es auf free zurück, bis du einen Freischaltcode einträgst.
So bekommst du einen Freischaltcode:
- Öffne am Gerät die Seite Lizenz (
/license) und lies deinen Gerätecode ab (z. B.QVGJ-HFHA-V777). - Schicke diesen Gerätecode mit deinem Unterstützer-Beitrag an license.pond-aeration@drcomp.de.
- Du erhältst per E-Mail einen Freischaltcode. Füge ihn auf der Seite Lizenz ein und klicke Freischalten — fertig, dauerhaft.
Der Gerätecode ist an genau dieses Gerät gebunden. Bei einem Hardware-Defekt bekommst du für das Ersatzgerät einen neuen Code.
Das ist kein Beinbruch: Dein Gerätecode bleibt exakt derselbe (er wird fest aus der Hardware abgeleitet, nicht aus dem Speicher). Damit gilt auch dein bisheriger Freischaltcode unverändert weiter — öffne einfach die Seite Lizenz am Gerät und füge denselben Code noch einmal ein. Du brauchst keinen neuen Code und musst nichts erneut anfragen. Bewahre den Freischaltcode (aus der E-Mail) also gut auf.
4Mit ioBroker verbinden (optional)
Für Automatisierung, Zeitpläne und Überwachung installierst du den ioBroker-Adapter automatic-pond-aeration, wählst das Backend „ESP32 (direct)" und trägst die IP des Geräts ein. Der Adapter zeigt dir den Lizenzstatus an und übernimmt die Steuerung (ab Stufe community).
Ausführliche Anleitung: siehe das vollständige Handbuch (unten verlinkt).
Probleme?
Im Auswahlfenster erscheint kein Anschluss / kein ESP
Meist ist es das Kabel: Viele USB-Kabel laden nur und übertragen keine Daten — nimm ein echtes Datenkabel. Probiere außerdem einen anderen USB-Port. Fehlt der USB-Treiber, installiere den passenden (CP210x von Silicon Labs oder CH340) und lade die Seite neu.
Das Flashen startet, bricht dann aber ab
Setze den ESP in den Download-Modus und starte neu: BOOT-Taste gedrückt halten, kurz RESET tippen, BOOT loslassen — dann erneut „Firmware installieren". Hilft auch: ein anderes Datenkabel/anderer USB-Port, den Serial-Monitor in anderen Programmen schließen, und den Browser-Tab neu laden. Nach einem erfolgreichen Flash meldet sich der USB-Port des S3 kurz ab und neu an — das ist normal.
Der Knopf ist ausgegraut oder sagt „nicht unterstützt"
Web-Flashen geht nur mit Google Chrome oder Microsoft Edge an einem Computer. Handy-Browser, Safari und Firefox unterstützen die nötige USB-Schnittstelle nicht.
Es kommt „nicht erlaubt" / kein Zugriff auf den USB-Port
Die Seite muss über https:// geöffnet sein (diese Seite ist es). Öffne sie nicht als lokale Datei und nicht über eine unsichere Verbindung.
Ich finde die IP-Adresse des Geräts nicht
Stelle sicher, dass das Netzwerkkabel steckt und der ESP Strom hat (PoE oder Netzteil). Schau im Router unter „verbundene Geräte" nach dem Namen pond-aeration. Alternativ zeigt die serielle Ausgabe die IP direkt nach dem Start.
Nach dem (erneuten) Flashen ist meine Freischaltung weg
Das ist normal: Der Installer überschreibt den gesamten Speicher, in dem auch der Freischaltcode liegt. Dein Gerätecode ist aber unverändert (er kommt aus der Hardware), also gilt derselbe Freischaltcode weiter — öffne am Gerät die Seite Lizenz und füge ihn erneut ein. Ein neuer Code ist nicht nötig. Tipp: Für Updates die Geräteseite Update nutzen (Knopf „Install update online") — die behält die Freischaltung.
Der Router zeigt statt „pond-aeration" einen alten Namen (z. B. „espressif")
Der ESP meldet seinen Hostnamen beim Anmelden per DHCP. Viele Router merken sich den zuerst gesehenen Namen zu einer MAC-Adresse und zeigen ihn weiter, auch wenn das Gerät längst einen neuen sendet. So lösen: im Router den alten Geräteeintrag entfernen bzw. die DHCP-Zuordnung/Lease zurücksetzen (oder den Router kurz neu starten), dann den ESP neu verbinden. Am Gerät selbst steht der richtige Name immer unter Info. Firmware ≥ 1.2.1 setzt den Namen zusätzlich früher im Startablauf, damit er sicher im ersten DHCP-Request steht.