Ecovacs Smart-Home-Integration, kostenlos und Open Source
Ecovacs-Deebot-Saugroboter und GOAT-Mähroboter steuern: Start, Station, Akku, Fehler.
Veröffentlicht von prohand
- Geräte
- Version 1.4.1
- Erfordert Gladys >=5.1.0
- ★ 0
Steuere deine Ecovacs-Deebot-Saugroboter und Ecovacs-GOAT-Mähroboter aus Gladys: Auftrag starten und stoppen, den Roboter zu seiner Ladestation zurückschicken, die Saugleistung einstellen, Akku, Fehler und Verschleiß der Teile verfolgen.
Die Integration läuft über die Ecovacs-Cloud, mit dem Konto der App Ecovacs Home: Ecovacs bietet keine lokale Verbindung an. Gladys braucht Internetzugang, und der Roboter muss in der App erscheinen.
Bevor du beginnst
- Installiere die App Ecovacs Home und füge deine Roboter hinzu.
- Notiere die E-Mail-Adresse und das Passwort des Kontos sowie das Land, das bei der Erstellung des Kontos gewählt wurde.
- Konto mit Google-, Apple- oder Facebook-Anmeldung erstellt: Es hat kein Passwort. Lege eines in der App fest (Profil, Kontoeinstellungen).
Konfiguration
- Öffne den Tab Konfiguration der Integration.
- Gib die E-Mail-Adresse, das Passwort und das Land des Kontos ein.
- Wähle das Aktualisierungsintervall (standardmäßig 1 Minute).
- Speichere und klicke dann auf Verbindung testen: Die Meldung listet die gefundenen Roboter auf.
- Öffne den Tab Entdecken und füge deine Roboter hinzu.
Geräteverifizierung
Ecovacs kann verlangen, Gladys als neues Gerät zu bestätigen (die Meldung sagt es, die Cloud antwortet mit dem Code 1013 „Please update to the latest version“):
- Klicke auf Bestätigungscode senden: Ecovacs schickt einen Code an die E-Mail-Adresse des Kontos (sieh auch im Spam-Ordner nach).
- Gib ihn unter Gerät bestätigen ein und klicke: Die Roboter werden aufgelistet.
Gladys behält für das Konto dieselbe Gerätekennung, auch nach einem Neustart.
Das Passwort wird nie im Klartext gesendet: Wie in der App geht nur sein MD5-Fingerabdruck an Ecovacs.
Was du erhältst
| Funktion | Saugroboter | Mähroboter | Detail |
|---|---|---|---|
| Zustand | ✔ | ✔ | Gestoppt, in Betrieb, pausiert, Fehler, Rückkehr zur Ladestation, lädt, an der Station |
| Reinigung / Mähen | ✔ | ✔ | 1 startet (oder setzt nach einer Pause fort), 0 stoppt |
| Rückkehr zur Ladestation / Station | ✔ | ✔ | 1 schickt den Roboter zurück |
| Saugleistung | ✔ | Leise, Standard, Max, Max+ (je nach Modell) | |
| Akku, Laden | ✔ | ✔ | In % |
| Letzter Fehler | ✔ | ✔ | Englischer Text mit seinem Code, siehe Tabelle unten |
| Hauptbürste, Seitenbürste, Filter | ✔ | Verbleibende Lebensdauer in %, alle 30 Minuten gelesen | |
| Messer, Bürste der Kameralinse | ✔ | Verbleibende Lebensdauer in %, alle 30 Minuten gelesen |
Ein Badge Cloud erscheint auf der Karte des Roboters, wenn er antwortet, und Nicht erreichbar, wenn er nicht mehr antwortet (ausgeschaltet, außerhalb des WLANs).
Aktionen
- Verbindung testen: meldet sich an und listet die gefundenen Roboter auf.
- Bestätigungscode senden / Gerät bestätigen: Geräteverifizierung, wenn Ecovacs sie verlangt (siehe oben).
- Roboter orten: Der Roboter spielt seinen Ton „Ich bin hier“ ab.
Szenen (Gladys 5.1 oder neuer)
Die Integration fügt dem Szenen-Editor eigene Karten hinzu, unter
Integrationen. Jeder Auslöser lässt sich auf einen Roboter einschränken;
leer gelassen, gilt er für alle. Gemeinsame Variable:
{{triggerEvent.data.name}} (Name des Roboters).
Auslöser:
- Reinigung oder Mähen gestartet: Der Roboter beginnt zu arbeiten (nicht beim Fortsetzen nach einer Pause).
- Reinigung oder Mähen beendet: Der Roboter hat die Arbeit beendet (fertig, gestoppt oder auf dem Rückweg).
- Roboter zurück an der Ladestation: Der Roboter steht an seiner Ladestation oder Station und lädt.
- Roboterfehler: Der Roboter hat einen neuen Fehler gemeldet. Variablen
{{triggerEvent.data.code}}und{{triggerEvent.data.message}}(auf Englisch). Ideal für eine Benachrichtigung „Roboter festgefahren“. - Verschleißteil abgenutzt: Eine Bürste, ein Filter oder ein Messer ist auf
10 % seiner Lebensdauer oder weniger gesunken. Lässt sich nach Verschleißteil
einschränken; Variablen
{{triggerEvent.data.consumable_name}}(auf Englisch) und{{triggerEvent.data.percent}}.
Aktionen (Ausgabe sent oder located: wahr, wenn der Roboter den Befehl
angenommen hat, um den Rest der Szene davon abhängig zu machen):
- Roboter starten (setzt fort, wenn pausiert), Roboter pausieren, Roboter stoppen, Roboter zur Ladestation schicken, Roboter orten.
Dashboard-Widget
Füge das Widget Ecovacs-Roboter zu einem Dashboard hinzu und wähle den Roboter in seinen Einstellungen. Es zeigt:
- den Akku, live;
- den Zustand, den letzten Fehler, die Saugleistung, den Verschleiß der Verschleißteile (orange unter 10 %) und die Verbindung;
- vier Tasten: Starten (oder Fortsetzen, oder Pause während der Arbeit), Stopp, Station und Orten.
Das Widget nutzt die letzte Abfrage des Roboters: Seine Anzeige kostet keine Anfrage an die Ecovacs-Cloud.
Häufige Fehlercodes
| Code | Bedeutung |
|---|---|
| 101 | Akku schwach |
| 102 | Roboter in einer Schleife festgefahren |
| 103 | Problem mit einem Rad |
| 104 | Problem mit dem Absturzsensor |
| 105 | Roboter festgefahren |
| 106 | Seitenbürste abgenutzt |
| 107 | Staubbehälter voll |
| 108 | Seitenbürste blockiert |
| 109 | Hauptbürste blockiert |
| 110 | Staubbehälter fehlt |
| 111 | Problem mit dem Stoßfänger |
| 112 | Problem mit dem Lasersensor |
| 113 | Hauptbürste abgenutzt |
| 115 | Akkuproblem |
| 118 | Filter verstopft |
| 119 | Problem mit dem Gebläse |
| 120 | Problem mit dem Wassertank |
| 204 | Rad blockiert |
| 312 | Ersetze den Staubbeutel |
| 1007 | Wischplatte locker |
Unterstützte Roboter
- Aktuelle Deebots (JSON-Protokoll): OZMO 920/950, T8, T9, T10, T20, T30, X1,
X2, N8, N10… Die Befehle der neuen Generation (
_V2) und die älteren werden automatisch erkannt. - GOAT-Mähroboter: Unterstützung noch zu bestätigen, Rückmeldungen willkommen.
- Nicht unterstützt: die sehr alten Deebots (erste Serien 600/900, XMPP-Protokoll). „Verbindung testen“ nennt sie.
Fehlerbehebung
- „Ecovacs hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfe sie in der App und vor allem das Land des Kontos. Nach einer solchen Ablehnung versucht es die Integration nicht mehr von selbst (um das Konto nicht zu sperren): Korrigiere die Konfiguration oder klicke auf Verbindung testen.
- „Ecovacs verlangt, Gladys als neues Gerät zu bestätigen“: Folge der Geräteverifizierung. Bis dahin versucht es die Integration nicht von selbst.
- „Ecovacs hat den Bestätigungscode abgelehnt“: Der Code ist falsch oder zu alt; fordere einen neuen an.
- „Die Ecovacs-Cloud ist nicht erreichbar“: Prüfe den Internetzugang von Gladys. Die Integration versucht es alle 5 Minuten erneut.
- Der Roboter ist nicht erreichbar: Er ist ausgeschaltet oder außerhalb des WLANs; prüfe, ob er in der App Ecovacs Home antwortet.
- Die Protokolle der Integration (Gladys-Oberfläche oder
docker logs) enthalten nie das Passwort oder die Tokens.
Konfigurationseinstellungen
Diese Einstellungen fragt Ecovacs in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Gladys erreicht deine Roboter (Deebot-Saugroboter, GOAT-Mähroboter) über die Ecovacs-Cloud, mit dem Konto der App Ecovacs Home: Füge die Roboter zuerst in der App hinzu und gib dann hier dieselbe E-Mail-Adresse, dasselbe Passwort und dasselbe Land ein. Konten, die mit der Google-, Apple- oder Facebook-Anmeldung erstellt wurden, benötigen ein Passwort: Lege eines in der App fest (Profil, Kontoeinstellungen). Bei der ersten Verbindung kann Ecovacs verlangen, Gladys als neues Gerät zu bestätigen: „Bestätigungscode senden“ schickt dir einen Code per E-Mail, gib ihn unter „Gerät bestätigen“ ein. |
string | Ja | Die E-Mail-Adresse deines Ecovacs-Home-Kontos. | |
| Passwort | secret | Ja | Das Passwort deines Ecovacs-Home-Kontos. Wie in der App wird nur sein MD5-Fingerabdruck an Ecovacs gesendet. |
| Land des Kontos | select | Ja | Das bei der Kontoerstellung gewählte Land: Es bestimmt, auf welchen Ecovacs-Servern das Konto liegt. |
| Aktualisierungsintervall | select | Nein | Wie oft der Zustand jedes Roboters über die Cloud abgefragt wird. |
So installierst du Ecovacs in Gladys
- Öffne in Gladys Integrationen: Ecovacs erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-ecovacs:1.4.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-ecovacs.
Ecovacs benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Ecovacs ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation