Library for running Ecovacs Deebot vacuum cleaner robots
This library uses the canvas library which might require additional installations. For the full functional range please install the following packages.
For Debian-based Linux systems the following commands should be executed:
sudo apt-get update
sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
A reboot might be necessary before executing the next command
sudo npm install canvas --unsafe-perm=true
For instructions for other systems visit https://www.npmjs.com/package/canvas#compiling
Afterwards you can install the library with
npm install ecovacs-deebot
If you want to install this library explicitly without canvas you can install it with
npm install ecovacs-deebot --no-optional
It is recommended to use version 10.x, 12.x or 14.x of Node.js. The minimum required version is 10.x
Information on how to use this library can be found here.
- Deebot 901
- Deebot OZMO 920
- Deebot OZMO 930
- Deebot OZMO 950
- Deebot Slim 2
- Deebot N79 series
- Deebot M88
- Deebot 600/601/605
- Deebot 710/711/711s
- Deebot 900
- Deebot OZMO 610
- Deebot OZMO 900
- Deebot OZMO T5
- Deebot OZMO T8 series
- Deebot OZMO Slim 10
- Deebot N3 MAX
- Deebot N7
- Deebot N8 series
- Deebot U2 series
- There's a strange behavior of the battery value on Deebot 900/901. It's very likely that this is a firmware bug
- Some cleaning commands may not work with Deebot 710/711/711s
- "Edge" command does not work with Deebot U2 (starts auto clean instead)
- Updated login process (credits to @And3rsL)
- Support for Chinese server login
- Implemented AutoEmpty commands for T8+/plus
- Initial support for some more models (e.g. N3, N7 and N8 series)
- Quite a lot refactoring and code consolidation
- Some improvements for handling charge status
- Added OZMO T5 and some more T8 models
- Several enhancements and fixes
- Some fixes for cleaning logs (non 950 type)
- Some refactoring and code improvements
- Implement ResetLifeSpan, SetVolume and GetVolume for 950 type models
- Implement OnOff for non 950 type MQTT models
- Implement method to get translated spot area names
- Bump some dependencies
- Several enhancements and fixes
- Initial support for Deebot U2 series
- Improved support for T8 models
- Improved handling of device classes
- (boriswerner) Fixed cleaning log for 950 type models
- (boriswerner) VirtualBoundaries handling
- Lots of code refactoring
- Fix problem running multiple devices
- Added support for more Ozmo T8 models
- Bugfix releases
- Added support for Ozmo T8+
- (boriswerner) Added new spotAreaNames (950 type)
- Update some dependencies
- Bugfix for Ozmo T8 (without AIVI)
- Removed canvas from dependencies
- Added support for Ozmo T8 (without AIVI)
- Update dependencies
- ResetLifeSpan and SetLifeSpan (non Ozmo 950)
- Several enhancements and fixes. Especially for N79S/SE and N79T/W
- Bugfix release
- Added support for Ozmo T8 AIVI
- (boriswerner) Emit error on missing cleanlog (Ozmo 920/950)
- (boriswerner) Control which API call is used for lastCleanMap & timestamp (Ozmo 920/950)
- Several enhancements and fixes
- Implemented cleaning logs
- Several enhancements and fixes
- (nicoduj) Fixed
Failure code 0002
error - Implemented move commands
- Some work on implementation of handling cleanLogs
- Several enhancements and fixes
- Added support for Ozmo 920
- Added map/spotArea template and functionality for Ozmo 930 and Deebot 900/901
- Improved handling command response and MQTT messages
- Several enhancements and fixes
- (boriswerner) Added map/spotArea template and functionality
- (boriswerner) Added enhanced map/spotArea functionality for Ozmo 950
- @joostth (sucks.js)
- @wpietri (sucks)
- @bmartin5692 (sucks, bumber)
- @Ligio (ozmo)
- @And3rsL (Deebotozmo)
All credits for originally figuring out and documenting the protocol go to @wpietri. He documented his findings on the protocol in his repository.
I am in no way affiliated with ECOVACS.
GNU GENERAL PUBLIC LICENSE
Copyright (c) 2021 Sascha Hölzel mrb1232@posteo.de