iobroker.ecovacs-deebot

    1.3.3 • Public • Published

    Logo

    Ecovacs Deebot adapter for ioBroker

    Stable version Latest version Number of Installations Number of monthly downloads Number of downloads github-workflow

    This adapter uses the ecovacs-deebot.js library.

    Features

    Some noteworthy features are:

    • Retrieve information (e.g. battery, cleaning log, consumable, cleaning and charging status)
    • Send clean commands (e.g. auto, spot area, custom area) and various other commands (e.g. play sound, reset consumables)
    • Save the last run custom area and rerun the saved areas
    • Adjustment of vacuum power (clean speed) and water level
    • Retrieve information during the cleaning process (e.g. current position and area)
    • Retrieve information of the maps incl. spot areas and virtual boundaries
    • Delete, save and recreate single virtual boundaries as well as a full set of virtual boundaries *)
    • Function for loading the current map image *)

    *) Experimental

    Please note: Some features are only available for some models

    Models

    Supported models

    • Deebot 900/901
    • Deebot OZMO 930
    • Deebot OZMO 920/950

    The models listed are those that I have in use myself or which are technically identical to these.

    These models should work properly or at least partially

    • Deebot Slim 2
    • Deebot N79 series
    • Deebot M88
    • Deebot 500
    • Deebot 600/601/605
    • Deebot 710/711
    • Deebot OZMO 610
    • Deebot OZMO 900/905
    • Deebot OZMO Slim 10/11
    • Deebot OZMO T5
    • Deebot U2 series
    • Deebot N3 MAX
    • Deebot N7
    • Deebot N8 series
    • Deebot T8 series
    • Deebot T9 series

    The models listed are either already known to work or are technically similar to these models. Nevertheless, the functionality may be partially limited.

    I try to achieve a wide range of functionality, but decide this case by case depending on complexity and various other criteria. There is of course no claim to full functionality.

    Installation

    It is recommended to use version 12.x or 14.x of Node.js. The minimum required version is 12.x

    This adapter uses the node-canvas library for some map-related functionality which may require the installation of some additional packages.

    The installation of canvas is optional and not necessary for models without map functionality, but for 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

    Usage

    • Information on how to use this adapter can be found here

    States

    • Information about the states can be found here (English) and here (German)

    FAQ

    • Frequently asked questions can be found here

    Known issues

    • For some models (e.g. Deebot OZMO 930) it is recommended to schedule a restart once a day because there are some reports that the connection is lost after approx. 24 hours
    • The "edge" function does not work with Deebot U2 (starts auto clean instead)
    • Some "cleaninglog" states are empty on T9 series ("last20Logs", "lastCleaningDate" and "lastCleaningMapImageURL")

    Changelog

    1.3.3

    • Bumped ecovacs-deebot.js to 0.7.1 (incl. fix for CVE-2022-0155)

    1.3.2

    • Bumped follow-redirects to 1.14.7 (fix for CVE-2022-0155) and some other dependencies
    • Added N8 PRO+

    1.3.1

    • Fix the cleaning functions for the Deebot 710 series

    1.3.0

    • Using library version 0.7.0 (beta)
    • The minimum required version of Node.js is now 12.x
    • Some improvements for newer models (e.g. T9 series)
    • Some other improvements and fixes

    1.2.4

    • Using library version 0.6.8
    • Some optimizations
    • Preparations for changing the minimum required Node.js version to 12.x

    1.2.3

    • Using library version 0.6.6
    • Lots of code refactoring, optimizations and some fixes

    1.2.2

    • Added function to load current map image (non 950 type models, e.g. OZMO 930, Deebot 901)

    1.2.1

    • Some enhancements and fixes
    • (benep) Added state to play sound by id

    1.2.0

    • Using library version 0.6.1
    • Added functions for deleting, saving and recreating saved virtual boundaries (950 type models, e.g. OZMO 920/950, T8 series)
    • Added functions for saving and recreating sets of virtual boundaries (950 type models, e.g. OZMO 920/950, T8 series)
    • Added options to control clean speed and water level separately for each spot area
    • Added function to save current spot area values
    • Added function to load current map image (950 type models, e.g. OZMO 920/950, T8 series)
    • Added some cleaning log values and some states for current cleaning stats
    • Removed "Use alternative API call for lastCleaningMapImageURL and lastCleaningTimestamp" option
    • Moved some states from "info" channel to sub channels "info.library" and "info.network"
    • Quite a lot of improvements for processing map data, spot areas and virtual boundaries
    • Some optimisations for js-controller 3.3
    • Improved support for N8 series
    • Initial support for T9 series
    • Some improvements and fixes

    1.1.1

    • Using library version 0.6.0
      • Updated login process
      • Support for Chinese server login
    • Initial support for some models (e.g. N3, N7 and N8 series)

    1.1.0

    • Stable release

    1.0.13

    • Using library version 0.5.6
    • Some improvements and fixes

    1.0.12

    • Using library version 0.5.5
    • Added some more T8 models
    • Several improvements and fixes

    1.0.11

    • Enabled some features for OZMO 900
    • Several minor improvements

    1.0.10

    • Using library version 0.5.4
    • Several improvements and fixes
    • Added available spot area boundaries to "map" channel (read only)

    1.0.9

    • Using library version 0.5.3
    • Added some experimental features (for a few models only)
    • Added option for virtual boundaries and some further improvements to adapter config
    • Some improvements for js-controller 3.2.x

    1.0.8

    • Using library version 0.5.2
    • Added available virtualBoundaries channel for Deebot 900/901 and Ozmo 930 (read only)
    • Added "volume" and buttons for resetting consumable values for 950 type models (920/950/T8)
    • Improved synchronization of spot area buttons
    • Add option for setting the language for spot area names
    • Added some experimental features (for a few models only)
    • Several enhancements and fixes
    • Bump some dependencies

    1.0.7

    • Using library version 0.5.1
    • Initial support for Deebot U2 series
    • Improved support for Ozmo T8 models
    • (boriswerner) Fixed cleaning log for 950 type models (920/950/T8)
    • (boriswerner) Added available virtualBoundaries to "map" channel (currently read only)
    • Improved handling of device classes
    • Several enhancements and fixes

    1.0.6

    • Using library version 0.5.0
    • Fix for running multiple devices
    • Support for additional Ozmo T8 models
    • Add option to synchronize spotArea buttons
    • Set state value for triggered buttons to false
    • Add option to suppress "unknown" value for "map.deebotPositionCurrentSpotAreaID" state
    • Further enhancements and fixes

    1.0.5

    • Bump library to 0.4.25
    • Initial support for Ozmo T8 and T8+
    • Implement buttons for resetting consumable values (currently Deebot 900/901 and Ozmo 930 only)
    • Several enhancements and fixes

    1.0.4

    • Bump library to 0.4.21
    • Remove canvas from dependencies
    • Several bugfixes and improvements (especially for N79 series)
    • Possibility to specify the number of reruns for a spot area
    • Spot areas in the "control" channel are now created automatically
    • Remove number of spot areas from adapter settings
    • Some refactoring
    • Bump dependencies

    1.0.1 - 1.0.3

    • Added support for Ozmo T8 AIVI
    • Compact mode support
    • Added a button to save the last used custom area values
    • Added buttons to rerun saved custom areas
    • Some enhancements and fixes

    1.0.0

    • Stable release

    0.0.1 - 0.6.5

    Disclaimer

    I am in no way affiliated with ECOVACS.

    License

    MIT License

    Copyright (c) 2022 Sascha Hölzel mrb1232@posteo.de

    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    Install

    npm i iobroker.ecovacs-deebot

    DownloadsWeekly Downloads

    371

    Version

    1.3.3

    License

    MIT

    Unpacked Size

    261 kB

    Total Files

    21

    Last publish

    Collaborators

    • bluefox
    • mrbungle64