pimatic-deebot

This repository is no longer maintained!

Pimatic plugin to control one or more Ecovacs Deebot cleaning robots.

This plugin is based on the ecovacs-deebot library from mrbungle64.

Preparation

Before install this plugin on Debian-based Linux systems the following commandline 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

These libs are needed for creating map functionality and to identify the spot area during cleaning.

The plugin can be installed via the plugins page of Pimatic.

Config of the plugin

{
  email:        "The email address for your Deebots account"
  password:     "The password for your Deebots account"
  countrycode:  "Your country code like 'DE'
  debug:        "Debug mode. Writes debug messages to the Pimatic log, if set to true."
}

Config of a Deebot Device

Devices are added via the discovery function. Per cleaning robot a DeebotDevice is discovered unless the device is already in the config. The automatic generated Id must not change. Its the unique reference to your vacuum. You can change the Pimatic device name after you have saved the device.

{
  nickname:
    "A nickname for the Deebot set via the app and then used in Pimatic
  show:       
    "If 'all': variables will be shown in the GUI except the variables selected in Attributes.
    If 'none': nothing will be shown in the GUI, except the ones selected in Attributes."
  attributes:
    "Deebot attributes that will be hidden (show=all) or shown (show=none) in the GUI."
  items:[
    "ChargeState", "FanSpeed", "CleanReport", "BatteryInfo",
    "LifeSpan_filter" , "LifeSpan_main_brush",
    "LifeSpan_side_brush", "WaterLevel", "WaterBoxInfo"
  ]
}

The attributes are updated and visible in the Gui. The items you can use depend on your type of Deebot. The Deebot can be controlled via rules

The action syntax:

  deebot <Pimatic Deebot Id>
    [clean] [<room-number>|$rooms-variable]
    [cleanarea] [x1,y1,x2,y2]|$area-variable cleanings 1..2|$cleanings-variable
    [pause|resume|stop|charge|
    [speed] <speed-number>|$speed-variable

The <room-nummer> or the $roomsvariable are optional. If you leave them out, the vacuum will start the default routine. The $rooms-variable is variable with room-numbers separated by a comma. Example: 0,1,8,3,2 The fan speed-number must be 1 (silient), 2 (normal), 3 (high) or 4 (very high)

Support of models

Supported models

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

These models should work properly or at least partially

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

---

The minimum node requirement for this plugin is node v10!