Home
Softono
ioBroker.ecovacs-deebot

ioBroker.ecovacs-deebot

Open source MIT JavaScript
GitHub
77
Stars
12
Forks
64
Issues
9
Watchers
1 week
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
m
Published by
mrbungle64
Visit View Profile

README.md

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