Home Assistant tutorial: integrating an Ecovacs vacuum robot

Today we will add integration for our dear ones Evovacs Deebot in Home Assistant. Quickly and simply, we will be able to monitor the lifespan of the components as well as manage our robot vacuum cleaners.

After our Deebot Ozmo 905 reviews and ozmo 920, many of you, like us, have fallen for this brand and you will probably want to integrate them into Home Assistant home automation box freshly created.

Configuration in Home Assistant

Since File Editor, go to your file configuration.yaml :

Configuration.yaml - Ecovacs Integration
Configuration.yaml - Ecovacs Integration

Then paste this YAML code by replacing the text with your username and password Ecovacs :

ecovacs: username: Your_Ecovacs_identifier password: Your_Ecovacs_password country: fr continent: eu
  • username: Your username to log into your Ecovacs account.
  • password: Your password to log into your Ecovacs account.
  • country: Your two-letter country code (fr, es, uk, be, etc.)
  • continent: Your two-letter continent code (na, eu, etc.).


The library communicating with the servers Ecovacs Robotics is in a very early state and is still in development.

logs - Ecovacs in Home Assistant
Logs - Ecovacs in Home Assistant

In order to understand the problem and get it back, we can add this code, to display the errors in the "newspapers" page seen previously.

logger: logs: homeassistant.components.ecovacs: debug homeassistant.components.vacuum.ecovacs: debug sucks: debug

A sensor for the filter

We will create a virtual sensor to easily display the filter life.

Ecovacs filter life
Ecovacs filter life

Copy and paste this code in configuration.yaml will allow you to extract the filter life as a percentage:

sensor: - platform: template sensors: vacuum_filter: friendly_name: "Remaining lifetime of the filter" unit_of_measurement: '%' value_template: "{{state_attr ('vacuum.mon_aspirateur', 'component_filter')}}"

Remember to replace vacuum.mon_aspirateur with the name of your vacuum cleaner.

Error management

THEEcovacs vacuum cleaner has an attribute "Error" allowing to know certain things about the vacuum cleaner. We can use this attribute in a scenario, for example.

Here are the known error codes:

  • 100 NoError: The robot is operational
  • 101 BatteryLow: Low battery
  • 102 HostHang: The robot is stuck
  • 103 WheelAbnormal: Wheels do not move as expected
  • 104 DownSensorAbnormal: The descent sensor obtains abnormal values
  • 110 NoDustBox: Dust container not installed

Finalize the Ecovacs integration

To finalize the integration of our robot vacuum cleaner, nothing could be simpler, save the file from the red diskette at the top right of the screen then restart your instance by clicking on the gear:

Restart Home Assistant
Restart Home Assistant

Your vacuum cleaner is now installed in Home Assistant!

All you have to do is add your robot vacuum and our virtual sensor on your dashboard 🙂!

This is integration natively offered by Home Assistant, we can add functionality through other plugins developed by the community, for example, a map of the rooms in your home. Tell me, in the comments or via the Facebook group if you want to see in detail the installation of the card for your robots. 🙂

Several feathers of enthusiastsAlexa to concoct articles with 4 or more hands ... Collaborative writing to address the most specialized or transversal subjects, the best home automation and connected home plans on the web, and much more ...