ESPhome Sensoren in Betrieb nehmen

Diese Anleitung führt Sie Schritt für Schritt durch alles, was Sie nach dem Auspacken eines Sensors brauchen:

1. WLAN einrichten – der Sensor meldet sich in Ihrem Netzwerk an
2. Webinterface öffnen – Messwerte ansehen und den Sensor identifizieren
3. Sensor registrieren – damit die Daten in Ihrem Dashboard erscheinen
4. Firmware aktualisieren – auch dann, wenn der Sensor längst an seinem Einsatzort hängt

Was Sie brauchen

• den Sensor, angeschlossen an seine Stromversorgung (bzw. am Einsatzort montiert, siehe Gerätedokumentation)
• ein 2,4-GHz-WLAN mit Internetzugang – die Sensoren können kein 5-GHz-WLAN. Hat Ihr Router beide Bänder unter einem gemeinsamen Namen, ist das in der Regel kein Problem
• Name und Passwort dieses WLANs
• ein Smartphone, Tablet oder Notebook mit WLAN und Webbrowser

WLAN einrichten

Ein fabrikneuer Sensor kennt Ihr WLAN noch nicht. Er löst das, indem er selbst ein kleines WLAN aufspannt (den sogenannten Hot-Spot oder Captive Portal), über das Sie ihm die Zugangsdaten Ihres WLANs mitteilen.

Schritt für Schritt

1. Sensor mit Strom versorgen. Findet der Sensor kein bekanntes WLAN, eröffnet er nach etwa einer Minute seinen eigenen Hot-Spot. Seine Bezeichnung (SSID) beginnt mit eco… und endet mit einer Kennung, z. B. ecopvgx-431512.

2. Mit dem Hot-Spot verbinden. Öffnen Sie an Smartphone oder Notebook die WLAN-Einstellungen und verbinden Sie sich mit dem Hot-Spot des Sensors. Das Passwort lautet:

   Passwort: 12345678

3. Konfigurationsseite öffnen. Auf vielen Smartphones öffnet sich die Seite automatisch. Andernfalls öffnen Sie in einem Webbrowser die Adresse http://192.168.4.1. Falls Sie nach Zugangsdaten gefragt werden:

   Benutzer: admin
   Passwort: 12345678

   

4. Sensor-ID notieren. Im oberen Bereich der Seite steht die Kennung des Sensors in der Form eco…-<ID> (im Bild markiert). Notieren Sie sich diese – Sie brauchen sie später zur Registrierung. Sie lässt sich auch später im Webinterface wieder nachlesen.

5. Zugangsdaten Ihres WLANs eingeben. Wählen Sie Ihr WLAN aus der Liste (oder tippen Sie den Namen bei SSID ein), geben Sie das Password ein und tippen Sie auf Save.

   

6. Warten. Der Sensor startet neu, der Hot-Spot verschwindet, und nach kurzer Zeit ist der Sensor in Ihrem WLAN angemeldet. Ihr Smartphone verbindet sich dabei automatisch wieder mit Ihrem normalen WLAN.

Verfügt Ihr Sensor über eine Status-LED, sehen Sie dort, wie es ihm geht (siehe Fehlerbehebung).

Webinterface

Jeder Sensor besitzt eine kleine Webseite, die er in Ihrem WLAN bereitstellt. Dort sehen Sie die aktuellen Messwerte, ein Protokoll für die Fehlersuche und die Möglichkeit zum Firmware-Update. Sie brauchen dafür nur einen Webbrowser im selben WLAN wie der Sensor.

Sensor finden

Öffnen Sie in Ihrem Browser die Adresse

http://eco…-<ID>

also z. B. http://ecopvgx-431512. In einigen Netzen müssen Sie ein .local anhängen: http://ecopvgx-431512.local.

Funktioniert beides nicht (manche Router und Heimnetze lösen Gerätenamen nicht auf), schauen Sie in der Geräteliste Ihres WLAN-Routers nach, welche IP-Adresse dem Sensor zugewiesen wurde, und öffnen dann http://<IP-Adresse>, z. B. http://192.168.1.95.

Anmeldung

Auf der Webseite melden Sie sich an mit:

Benutzer: admin
Passwort: 12345678

Das sehen Sie dort

1. Sensordaten
2. Ein „Klick“ auf einen Sensorwert zeigt Details (Verlauf)
3. Ein „Doppel-Klick“ auf eine Überschrift vergrößert den Bereich
4. Logfile-Ausgabe – hier steht im Fehlerfall, was nicht funktioniert
5. Laufzeit seit dem letzten Neustart
6. Name und Typ des Sensors
7. Hell-/Dunkelmodus
8. Heartbeat: grün = aktiv, grau = offline

Weiter unten auf der Seite finden Sie die Angaben zum Sensor selbst:

1. EcoSensor ID – wird zur Registrierung des Sensors benötigt
2. Netzwerkangaben und Betriebsparameter, u. a. die IP-Adresse des Webinterfaces und die installierte Firmware-Version
3. Firmware-Update (je nach Sensor als Schaltfläche Firmware update oder als Dateiauswahl OTA Update, siehe Firmware-Update)

Sensor registrieren

Damit die Messwerte Ihres Sensors in Ihrem Dashboard erscheinen, muss er einmalig Ihrem Konto zugeordnet werden. Dafür benötigen Sie die EcoSensor ID (eco…-<ID>) aus dem Hot-Spot oder dem Webinterface. Wie die Registrierung abläuft, steht in der Dokumentation Gerät registrieren.

Integration in Home-Assistant (optional)

Bei einigen Ausführungen der Sensoren lässt sich eine Schnittstelle zur Hausautomationssoftware Home-Assistant aktivieren. Sie ist Teil einer eigenen Firmware-Variante (Kennzeichnung -ha, siehe Firmware-Update). Wer Home-Assistant nicht nutzt, braucht dieses Kapitel nicht.

Fügen Sie den Sensor in Home-Assistant wie folgt hinzu:

Einstellungen (1) → Geräte & Dienste (2)

→ + Integration hinzufügen

Wählen Sie nun „ESPHome“ aus und geben Sie den Hostnamen des Sensors an (eco…-<ID>). Manchmal muss ein .local angehängt werden, z. B. ecopvgx-431512.local.

Anschließend werden Sie nach einem Verschlüsselungsschlüssel gefragt. Dieser liegt jedem Sensor bei bzw. wird Ihnen per E-Mail mitgeteilt.

Firmware-Update

Die Firmware ist die Software, die auf dem Sensor läuft. Wir verbessern sie laufend; ein Update bringt Fehlerbehebungen und neue Funktionen. Wie Sie sie aktualisieren, hängt davon ab, wie Sie an den Sensor herankommen und was der Sensor kann. Die Sensoren der Eco-Serie hängen meist an einem festen Ort und sind dort oft nur noch über das WLAN erreichbar – deshalb sind die Wege hier nach Aufwand sortiert. Nehmen Sie den einfachsten, der bei Ihrem Sensor funktioniert.

Welcher Weg gilt für meinen Sensor?

Öffnen Sie das Webinterface und scrollen Sie nach unten (Punkt 3 im Bild oben):

• Bietet ecosensors.cloud für Ihren Sensor ein Update direkt im Dashboard an? → Weg A. (Noch in Entwicklung, siehe unten.)
• Gibt es im Webinterface des Sensors eine Schaltfläche „Firmware update“? → Weg B.
• Gibt es einen Abschnitt „OTA Update“ mit Datei auswählen und UPDATE? → Weg C.
• Erreichen Sie den Sensor im WLAN gar nicht mehr oder schlägt ein Update dauerhaft fehl? → Weg D.

Die Gerätedokumentation nennt außerdem, welchen Weg Ihr Sensor unterstützt.

Vor jedem Update

• Installierte Version prüfen: Im Webinterface steht unter EcoSensor FW Version die aktuell installierte Version. Im Dashboard unter Firmware (Anmeldung nötig) sehen Sie zu jedem Ihrer Geräte, ob ein Update verfügbar ist.
• Stromversorgung sicherstellen: Trennen Sie den Sensor während des Updates nicht vom Strom und lassen Sie ihn danach in Ruhe neu starten (etwa eine Minute). Bei Wechselrichter-Sticks wie dem EcoPVGX heißt das: nur bei Tageslicht aktualisieren.
• Richtige Variante wählen: Manche Sensoren gibt es mit und ohne Home-Assistant-Schnittstelle (-ha). Spielen Sie immer die Variante ein, die bereits auf dem Sensor läuft – sonst ändern Sie ungewollt dessen Verhalten (siehe auch Home-Assistant).

Weg A: Update über ecosensors.cloud

Sensoren, die sich selbst aktualisieren können, sollen künftig direkt über ecosensors.cloud aktualisiert werden können: Sie lösen das Update auf der Website aus, der Sensor installiert die neue Firmware selbständig. Sie brauchen weder Zugriff auf das Webinterface des Sensors noch müssen Sie im selben WLAN sein – der Sensor muss lediglich online sein. Das ist besonders praktisch für Sensoren an exponierten Stellen.

Wo Sie einen verfügbaren Update-Hinweis finden und wie Sie ihn auslösen, wird hier ergänzt, sobald die Funktion freigeschaltet ist. Schon jetzt zeigt Ihnen die Seite Firmware für jedes Ihrer Geräte die installierte und die aktuelle Version.

Weg B: Update per Knopfdruck

Der Sensor lädt die neueste Firmware selbst aus dem Internet herunter und installiert sie. Sie müssen keine Datei herunterladen.

1. Öffnen Sie das Webinterface des Sensors.
2. Drücken Sie die Schaltfläche „Firmware update“.
3. Warten Sie ein bis zwei Minuten. Der Sensor lädt die Firmware, installiert sie und startet neu. Die Webseite ist dabei kurz nicht erreichbar.
4. Laden Sie die Seite neu und prüfen Sie unter EcoSensor FW Version, ob die neue Version läuft.

Ist bereits die neueste Version installiert, passiert beim erneuten Drücken nichts Schlimmes – der Sensor installiert sie dann einfach noch einmal.

Weg C: Update-Datei hochladen

Manche Sensoren (z. B. EcoPVGX, EcoSPM) können sich nicht selbst aktualisieren. Hier laden Sie die Update-Datei selbst herunter und übergeben sie dem Sensor über dessen Webinterface. Auch dafür brauchen Sie keine USB-Verbindung, Sie müssen nur im selben WLAN sein wie der Sensor.

1. Update-Datei herunterladen

1. Melden Sie sich bei ecosensors.cloud an und öffnen Sie die Seite Firmware.
2. Dort sehen Sie die Produkte Ihrer Geräte, die installierte und die aktuelle Version. Laden Sie im Abschnitt Downloads die Update-Datei (Dateiendung .ota.bin) für die richtige Variante herunter.

2. Datei auf den Sensor übertragen

1. Öffnen Sie das Webinterface des Sensors (aus dem selben WLAN) und scrollen Sie zu OTA Update.
2. Klicken Sie auf Datei auswählen und wählen Sie die heruntergeladene .ota.bin.
3. Klicken Sie auf UPDATE und warten Sie, bis die Übertragung abgeschlossen ist und der Sensor neu gestartet hat (ca. 1–2 Minuten). Schließen Sie den Browser-Tab nicht vorher.
4. Laden Sie die Seite neu und prüfen Sie unter EcoSensor FW Version, ob die neue Version läuft.

Sie können dieses Update auch mit dem Smartphone durchführen: Das Webinterface (und die Konfigurationsseite des Hot-Spots, dort ebenfalls als OTA Update) funktioniert im mobilen Browser.

Weg D: Update per USB

Nur nötig, wenn der Sensor per WLAN nicht mehr erreichbar ist, ein Update über das Webinterface dauerhaft fehlschlägt oder ein bereits vorhandenes Gerät erstmals auf unsere Firmware umgestellt werden soll. Dazu muss der Sensor physisch erreichbar sein, d. h. an einen Computer angeschlossen werden. Bei Sensoren, die einmal fest montiert wurden, bedeutet das: ausbauen.

Wie Sie den Sensor an den Computer anschließen und ob dafür ein Gehäuse geöffnet oder ein Jumper gesetzt werden muss, ist gerätespezifisch – siehe Gerätedokumentation.

1. Laden Sie unter Firmware das Komplette Image (Erstinstallation) für Ihren Sensor und die richtige Variante herunter.

2. Verbinden Sie den Sensor per USB mit Ihrem Computer.

3. Öffnen Sie das ESP Web Tool in einem Chromium-basierten Browser (Chrome, Edge, Brave …). Das Tool läuft komplett im Browser, Sie müssen nichts installieren.

4. Klicken Sie auf CONNECT und wählen Sie den USB-Anschluss des Sensors aus.

   

5. Wählen Sie über SELECT die heruntergeladene Datei aus. Die Adresse (Feld 0x) bleibt auf 0. Klicken Sie danach auf PROGRAM.

   

6. Warten Sie, bis der Fortschritt 100 % erreicht.

   

7. Sobald das Tool Done! meldet, trennen Sie den Sensor vom Computer und schließen ihn wieder an seine normale Stromversorgung an („reset your device“).

   

Der Sensor startet mit der neuen Firmware. Je nach Zustand verbindet er sich mit Ihrem WLAN oder eröffnet wieder seinen Hot-Spot – dann beginnen Sie bei WLAN einrichten.

Fehlerbehebung

LED-Meldungen

Einige Sensoren besitzen Status-LEDs, von denen meist die rote als Status-LED dient. Im Normalfall leuchtet die rote LED gar nicht.

• Rot
  • langsames Blinken: Eine Warnung ist aktiv. Das ist z. B. der Fall, wenn das Lesen eines Sensorwerts vorübergehend fehlschlägt, wenn die WLAN- oder MQTT-Verbindung unterbrochen ist (z. B. beim Start) oder wenn die Home-Assistant-Schnittstelle aktiv, aber nicht verbunden ist.
  • schnelles Blinken: Der Sensor hat beim Einrichten einen Fehler gefunden. In den meisten Fällen versucht er trotzdem, sich zu erholen und weiterzumachen.

Der Hot-Spot erscheint nicht

• Warten Sie nach dem Einschalten bis zu zwei Minuten.
• Der Hot-Spot erscheint nur, wenn der Sensor kein bekanntes WLAN findet. Ist Ihr altes WLAN noch in Reichweite, verbindet er sich eventuell weiterhin damit – schalten Sie es zur Einrichtung kurz aus.
• Suchen Sie nach WLANs im 2,4-GHz-Band; manche Smartphones blenden Netze ohne Internetzugang aus oder wechseln selbstständig zurück in Ihr Heim-WLAN. Deaktivieren Sie ggf. vorübergehend die mobilen Daten und verbinden Sie sich erneut.

Das Webinterface ist nicht erreichbar

• Sind Sie mit dem gleichen WLAN verbunden wie der Sensor (nicht im Gäste-WLAN, nicht über mobile Daten)?
• Funktioniert http://eco…-<ID> nicht, versuchen Sie http://eco…-<ID>.local, und wenn auch das nicht geht, die IP-Adresse aus Ihrem Router (siehe Sensor finden).
• Starten Sie den Sensor neu (Strom trennen und wieder einstecken oder im Webinterface Restart).

Der Sensor meldet sich nicht im Dashboard

• Ist der Sensor registriert?
• Zeigt das Webinterface den Heartbeat grün, der Sensor ist aber im Dashboard offline? Prüfen Sie den Internetzugang Ihres WLANs.
• Läuft die Home-Assistant-Variante ohne Kopplung, startet der Sensor alle 15 Minuten neu (siehe Home-Assistant).

Das Firmware-Update funktioniert nicht

• Weg B: Hat der Sensor Internetzugang? Wenn nicht, nutzen Sie Weg C.
• Weg C: Ist es wirklich die Update-Datei (.ota.bin) und die zum Sensor passende Variante?
• Bricht die Übertragung ab, nähern Sie sich dem Sensor mit dem Endgerät oder verbessern Sie den Empfang und versuchen es erneut.
• Hilft nichts davon: Weg D.

Gerätedokumentation

Die folgenden Seiten enthalten alles, was nur für das jeweilige Gerät gilt – z. B. Anschluss, Kompatibilität, technische Daten und Besonderheiten beim Firmware-Update per USB:

• EcoPVGX – für Growatt Wechselrichter
• EcoMBR1 – für ModBus-RTU-Geräte
• EcoSPM – für Shelly PM Mini Gen3