Ecovacs Smart-Home-Integration, kostenlos und Open Source
Control Ecovacs Deebot robot vacuums and GOAT mowers: start, dock, battery, errors.
Veröffentlicht von prohand
- Geräte
- Version 1.3.0
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Control your Ecovacs Deebot robot vacuums and Ecovacs GOAT lawn mowers from Gladys: start and stop the job, send the robot back to its dock, set the suction power, follow the battery, the errors and the wear of the parts.
The integration goes through the Ecovacs cloud, with the account of the Ecovacs Home app: Ecovacs offers no local connection. Gladys needs Internet access, and the robot must show up in the app.
Before you start
- Install the Ecovacs Home app and add your robots to it.
- Note the email and password of the account, and the country chosen when the account was created.
- Account created with Google, Apple or Facebook sign-in: it has no password. Set one in the app (Profile, account settings).
Configuration
- Open the Configuration tab of the integration.
- Fill in the email, the password and the country of the account.
- Pick the refresh interval (1 minute by default).
- Save, then click Test the connection: the message lists the robots found.
- Open the Discover tab and add your robots.
Device verification
Ecovacs may ask to confirm Gladys as a new device (the message says so, the cloud answers code 1013 "Please update to the latest version"):
- Click Send the verification code: Ecovacs mails a code to the account (look in the spam folder too).
- Enter it in Confirm the device and click: the robots are listed.
Gladys keeps the same device id for the account, even after a restart.
The password is never sent in clear text: only its MD5 fingerprint goes to Ecovacs, as the app does.
What you get
| Feature | Vacuum | Mower | Detail |
|---|---|---|---|
| State | ✔ | ✔ | Stopped, running, paused, error, returning to dock, charging, docked |
| Cleaning / Mowing | ✔ | ✔ | 1 starts (or resumes after a pause), 0 stops |
| Return to dock / station | ✔ | ✔ | 1 sends the robot back |
| Suction power | ✔ | Quiet, Standard, Max, Max+ (depending on the model) | |
| Battery, Charging | ✔ | ✔ | In % |
| Last error | ✔ | ✔ | English text with its code, see the table below |
| Main brush, Side brush, Filter | ✔ | Remaining life in %, read every 30 minutes | |
| Blades, Camera lens brush | ✔ | Remaining life in %, read every 30 minutes |
A cloud badge shows on the robot card when it answers, unreachable when it no longer does (switched off, out of Wi-Fi).
Actions
- Test the connection: signs in and lists the robots found.
- Send the verification code / Confirm the device: device verification, when Ecovacs asks for it (see above).
- Locate a robot: the robot plays its "I'm here" sound.
Scenes (Gladys 5.1 or later)
The integration adds its own cards to the scene editor, under
Integrations. Every trigger can be narrowed to one robot; left empty, it
matches them all. Common variable: {{triggerEvent.data.name}} (robot name).
Triggers:
- Cleaning or mowing started: the robot starts working (not when it resumes after a pause).
- Cleaning or mowing finished: the robot stopped working (done, stopped or on its way back).
- Robot back on its dock: the robot is on its dock or station, charging.
- Robot error: the robot reported a new error. Variables
{{triggerEvent.data.code}}and{{triggerEvent.data.message}}. Perfect for a "robot stuck" notification. - Consumable worn out: a brush, filter or blade went down to 10 % of its
life or less. Can be narrowed by consumable; variables
{{triggerEvent.data.consumable_name}}and{{triggerEvent.data.percent}}.
Actions (output sent or located: true when the robot took the order, to
gate the rest of the scene):
- Start a robot (resumes when paused), Pause a robot, Stop a robot, Send a robot back to its dock, Locate a robot.
Dashboard widget
Add the Ecovacs robot widget to a dashboard and pick the robot in its settings. It shows:
- the battery, live;
- the state, the last error, the suction power, the wear of the consumables (orange under 10 %) and the connection;
- four buttons: Start (or Resume, or Pause while working), Stop, Dock and Locate.
The widget uses the last reading of the robot: displaying it costs no request to the Ecovacs cloud.
Common error codes
| Code | Meaning |
|---|---|
| 101 | Battery low |
| 102 | Robot stuck in a loop |
| 103 | Wheel problem |
| 104 | Cliff sensor problem |
| 105 | Robot stuck |
| 106 | Side brush worn out |
| 107 | Dust bin full |
| 108 | Side brush blocked |
| 109 | Main brush blocked |
| 110 | Dust bin missing |
| 111 | Bumper problem |
| 112 | Laser sensor problem |
| 113 | Main brush worn out |
| 115 | Battery problem |
| 118 | Filter blocked |
| 119 | Fan problem |
| 120 | Water tank problem |
| 204 | Wheel stuck |
| 312 | Replace the dust bag |
| 1007 | Mop plate loose |
Supported robots
- Recent Deebots (JSON protocol): OZMO 920/950, T8, T9, T10, T20, T30, X1,
X2, N8, N10… The new-generation (
_V2) and older commands are detected automatically. - GOAT mowers: support to be confirmed, feedback welcome.
- Not supported: the very old Deebots (first 600/900 series, XMPP protocol). "Test the connection" names them.
Troubleshooting
- "Ecovacs refused the email or password": check them in the app, and above all the country of the account. After such a refusal the integration stops retrying on its own (so as not to lock the account): fix the configuration or click Test the connection.
- "Ecovacs asks to confirm Gladys as a new device": follow Device verification. The integration does not retry on its own until then.
- "Ecovacs refused the verification code": the code is wrong or too old; ask for a new one.
- "The Ecovacs cloud cannot be reached": check the Internet access of Gladys. The integration retries every 5 minutes.
- The robot is unreachable: it is switched off or out of Wi-Fi; check it answers in the Ecovacs Home app.
- The integration logs (Gladys UI or
docker logs) never contain the password or the tokens.
Konfigurationseinstellungen
Diese Einstellungen fragt Ecovacs in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | Your robots (Deebot vacuums, GOAT mowers) are reached through the Ecovacs cloud, with the account of the Ecovacs Home app: add the robots in the app first, then enter the same email, password and country here. Accounts created with Google, Apple or Facebook sign-in need a password: set one in the app (Profile, account settings). On the first connection, Ecovacs may ask to confirm Gladys as a new device: "Send the verification code" mails you a code, enter it in "Confirm the device". |
string | Ja | The email of your Ecovacs Home account. | |
| Password | secret | Ja | The password of your Ecovacs Home account. Only its MD5 fingerprint is sent to Ecovacs, as the app does. |
| Country of the account | select | Ja | The country chosen when the account was created: it decides which Ecovacs servers hold it. |
| Refresh interval | select | Nein | How often each robot is asked for its state through the cloud. |
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.3.0) 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 externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation