Ecovacs

---

The ecovacs integration is the main integration to integrate all Ecovacs (Deebot) vacuums. You will need your Ecovacs account information (username, password) to discover and control vacuums in your account.

There is currently support for the following device types within Home Assistant:

• Vacuum

Configuration

To add your Ecovacs devices into your Home Assistant installation, add the following to your configuration.yaml file:

ecovacs:
  username: YOUR_ECOVACS_USERNAME
  password: YOUR_ECOVACS_PASSWORD
  country: YOUR_TWO_LETTER_COUNTRY_CODE
  continent: YOUR_TWO_LETTER_CONTINENT_CODE

YAMLCopy

CONFIGURATION VARIABLES

Looking for your configuration file?username string REQUIRED

Your username to login to your Ecovacs account.password string REQUIRED

Your password to login to your Ecovacs account.country string REQUIRED

Your two-letter country code (us, uk, etc).continent string REQUIRED

Your two-letter continent code (na, eu, etc).

Note: For some countries, you will need to set continent to ww (meaning worldwide.) There is unfortunately no way to know the correct settings other than guessing and checking. See the sucks library protocol documentation for more information about what has been figured out about the Ecovacs servers.

Additional note: There are some issues during the password encoding. Using some special characters (e.g., -) in your password does not work.

STABILITY AND REPORTING BUGS

The library that talks to the Ecovacs s