Home
Softono

IoBroker.ecovacs Deebot

Open source MIT JavaScript
GitHub
77
Stars
12
Forks
64
Issues
9
Watchers
3 months
Last Commit
Home Automation

 About IoBroker.ecovacs Deebot

Control your Ecovacs Deebot and yeedi vacuum cleaner with ioBroker

Platforms

Web Self-hosted

Languages

JavaScript

Links

Source Code

Need Help Installing IoBroker.ecovacs Deebot?

We provide expert installation service for this software. Our team will install, configure, and secure IoBroker.ecovacs Deebot on your server. plans start at just $30.

Hire an Expert
Published by
mrbungle64
Visit View Profile

IoBroker.ecovacs Deebot

View on GitHub

ioBroker.ecovacs-deebot

Logo

Stable version Latest version Number of Installations

This adapter uses the ecovacs-deebot.js library.

⚠️ Maintenance Status: Community-Driven Project This adapter is now following a Community-Driven maintenance model. The maintainer focuses on the core engine and personally owned devices. Support for all other models depends entirely on community contributions (Pull Requests).

🗺️ Roadmap & Strategy

To ensure long-term maintainability, we are streamlining the adapter's architecture. Note: We are currently in the 1.4.x release cycle.

  1. Phase 1 (Planned): Final Legacy Support (Adapter v1.5.x / Library v0.9.6)
    • This will be the final "safe harbor" for all legacy devices using XML protocols (XMPP/XML or MQTT/XML).
    • Once released, no new legacy features will be added.
  2. Phase 2 (Planned): Modernization (Adapter v2.0.x / Library v1.0.0)
    • Transition to a Pure MQTT/JSON stack.
    • Complete removal of legacy code to improve performance and stability.
    • Breaking Change: Legacy models (e.g., OZMO 930, Deebot 900) will no longer be supported in v2.x.

Models & Support Tiers

Support is divided into tiers based on device availability for the maintainer:

Tier Model Series (Examples) Status
🟢 Active OZMO 920/950, T8 AIVI, X1 Turbo Fully Supported. Devices owned by the maintainer
🟡 Community T10, T20, T30, X2, X8 etc. Best Effort. Supported via community Pull Requests
🔴 Legacy OZMO 930, Deebot 900/901 etc. Maintenance Only. Supported in v1.5.x only

How to get your model supported?

If you own a modern (MQTT/JSON) model that is currently not supported:

  1. Check the ecovacs-deebot.js library.
  2. Provide a Pull Request with the necessary model definitions.
  3. Requests for new models without a Pull Request will be closed without further notice.

Changelog

1.4.16 (alpha)

  • Breaking change: Bump minimum required version of Node.js to 20.x
  • Add more states for air drying timer
  • Use adapter-dev module
  • Some further improvements and optimizations
  • Bumped ecovacs-deebot.js to 0.9.6 (latest beta)
  • Bumped several other dependencies

1.4.15 (latest stable)

  • Breaking change: Bump minimum required version of Node.js to 18.x
  • Bumped ecovacs-deebot.js to 0.9.6 (beta)
  • Add state (button) for manually requesting the cleaning log
  • Separate mopping and scrubbing mode
  • Add states for air drying timer
  • Some further improvements and optimizations

0.0.1 - 1.4.14

Installation & Prerequisites

  • Node.js: >= 20.x (since v1.4.16)
  • ioBroker: Stable installation
  • Optional: canvas for map rendering (see Wiki for details).

Disclaimer

I am in no way affiliated with Ecovacs Robotics Co., Ltd. or yeedi Technology Limited. This is a private hobby project.

License

MIT License - Copyright (c) 2026 Sascha Hölzel