Ecovacs for Home Assistant (built-in integration)

About

Ecovacs is a built-in Home Assistant integration for Ecovacs robot vacuums and lawn mowers through the vendor's cloud. It adds vacuum and lawn mower entities, along with a map image, a last job event and an error sensor. Sensors report the remaining lifespan of parts such as brushes, filters, mops and the dust bag, and buttons reset each of those lifespans. Numbers and selects adjust values like volume, clean count, water flow level, work mode, active map and auto-empty frequency. Switches cover options such as child lock, carpet auto-boost suction and continuous cleaning. A self-hosted instance can be used instead of the cloud, and an action returns raw positions of the chargers and the device. Setup is done in the UI.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Vacuums
Switches
Sensors

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect

ModeSelect the mode you want to use to connect to Ecovacs. If you are unsure, select Cloud. Select Self-hosted only if you have a working self-hosted instance.

Sign in

Country
MQTT URLEnter the MQTT URL of your self-hosted instance including the scheme (mqtt/mqtts).
REST URLEnter the REST URL of your self-hosted instance including the scheme (http/https).
Password
Username
Verify MQTT SSL certificate

Device verification

Verification code

Sign in again

Password

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsMop attached
ButtonsRelocate, Reset air freshener lifespan, Reset blade lifespan, Reset main brush lifespan, Reset cleaning solution lifespan, Reset dust bag lifespan, Reset filter lifespan, Reset hand filter lifespan, Reset lens brush lifespan, Reset round mop lifespan, Reset sewage box lifespan, Reset side brush lifespan, and 9 more
EventsLast job
ImagesMap
NumbersClean count, Cut direction, Volume, Water flow level
SelectsActive map, Auto-empty frequency, Water flow level, Work mode
SensorsError, Air freshener lifespan, Blade lifespan, Main brush lifespan, Cleaning solution lifespan, Dust bag lifespan, Filter lifespan, Hand filter lifespan, Lens brush lifespan, Round mop lifespan, Sewage box lifespan, Side brush lifespan, and 19 more
SwitchesAdvanced mode, Border spin, Border switch, Carpet auto-boost suction, Child lock, Clean preference, Continuous cleaning, Cross map border warning, Move up warning, Safe protect, True detect

Actions

Get raw positionsRetrieves a raw response containing the positions of the chargers and the device itself.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

Robot vacuums in Vulpo

The Robot Vacuum card's detail view starts, pauses and docks the vacuum, finds it and cleans chosen rooms, as the vacuum allows. A Live Activity follows the run on the Lock Screen, and both are part of Vulpo Pro.

Shows in Vulpo Quick Toggle card, Robot Vacuum card, Button card, Select card, Apple Watch, Control Center, Vacuum Live Activity.

Download Vulpo Widgets & Live Activities in Vulpo