Tasshack/dreame-vacuum

---

Features

• Wide range of Dreame, MOVA, Mijia and Trouver robot vacuums and mops, configurable with a DreameHome, MovaHome, Xiaomi Home account or fully locally without the cloud
• Almost every setting and state exposed dynamically as auto generated entities
• Live and multi-floor map support with zone, spot and room cleaning
• Per-room suction, water volume and cleaning order for customized cleaning
• Persistent notifications and events for automations
• Cleaning/cruising history, obstacle photos, map backup & recovery and saved WiFi maps
• Backend translations for 40 languages
• Complete interactive map editor via embedded Dreame Vacuum Card

---

Documentation

• Installation - Minimum Home Assistant version and hardware requirements, with HACS and manual setup steps
• Configuration - Adding the device with a Dreamehome, Xiaomi Home, MOVAhome or TROUVER account, or locally over the LAN
• Configuration Options - Per device settings offered during setup and from the Configure button
• Supported Devices - Model codes of every tested Dreame, MOVA, Mijia and TROUVER robot with the features it exposes
• How to Use - How entities, services and events come together on a dashboard
• Dashboard - Setup examples and YAML templates for every supported Lovelace card, including the built-in Dreame Vacuum Card
• Entities - What gets generated for a device, with map, room and consumable entities covered separately
• Map Support - How map data is decoded and rendered, with history, recovery, obstacle photos and WiFi maps
• Services - Parameters and automation examples for device and map control
• Notifications - Which device events raise a persistent notification and how to turn them off
• Events - Event types fired on the bus and the payloads they carry
• FAQ - Recurring questions from the issue tracker and their actual causes

---

Thanks To

• xiaomi_vacuum by @pooyashahidi
• Xiaomi MIoT for Home Assistant by @ha0y
• Xiaomi Cloud Map Extractor by @PiotrMachowski
• Dreame cloud authentication by @kuudori
• Mova cloud support by @r1si