This binding integrates vacuum cleaners made by Ecovacs into openHAB 3.x.
(Note: for openHAB 4.x, it will be part of the addon distribution)
Supported devices
Most devices made in the last 3 years should work with it, namely:
- Deebot 600/601/605 *
- Deebot OZMO 610
- Deebot 710/711/711s
- Deebot 900/901
- Deebot OZMO 900/905 *
- Deebot OZMO 920 *
- Deebot OZMO 930 *
- Deebot OZMO 950 *
- Deebot Slim 2
- Deebot OZMO Slim 10/11 *
- Deebot OZMO T5
- Deebot (OZMO) T8 series *
- Deebot T9 series
- Deebot N3 MAX
- Deebot N7
- Deebot N8 series *
- Deebot U2 series
- Deebot X1 Omni
Devices marked with an asterisk were successfully tested so far (by either myself or various people using the binding).
Supported features
Supported are
- reading device state
- sending commands to start and stop cleaning
- reading last cleaning log entry
- tracking current cleaning area/duration changes
- changing suction power level and amount of water used for mopping (on OZMO devices)
- tracking brush and filter life times
Please see the README file for details on the supported channels.
Changelog
Version 20220207
- Initial release
Version 20220212
- Improve last cleaning map image download (retry on failure)
- Correctly handle unconfigured country
Version 20220213
- Handle server-side MQTT disconnections (reconnect in that case)
Version 20220222
- Split
state
channel:state
now only contains basic operational state (cleaning, pause, stop, returning, charging, idle), while the currently used cleaning mode (if device is active) is now provided in thecurrent-cleaning-mode
channel. For details see README file.
Version 20220224
- Fix deadlock on server-side MQTT disconnection
Version 20220226
- Fix API server selection for users in UK and China
Version 20220228
- (Hopefully) fix login for UK users
Version 20220304
- Correctly handle expired login token
Version 20220309
- Handle expired login token
- Correctly handle reconnections
- Fix Deebot 610 device definition
Version 20220513
- Fix device metadata for Deebot OZMO 900/905 (add missing mapping capability)
- Add some more Deebot N8 and Deebot X1 models to supported device list
Version 20220520
- Remove ālast clean mapā and ālast clean modeā channels for XML devices (clean log doesnāt contain those fields for those models)
Version 20220615
- Add rule actions for device sound playback
- Add channel for current cleaning spot (for ācustom areaā and āspot areaā modes)
- Add command for custom area cleaning
Version 20220622
- Fix event updates not working when using more than one MQTT device
Version 20220726
- Rebuild against OH 3.4.0 snapshot
Version 20220902
- Change separators of āspotAreaā and ācustomAreaā definition lists to semicolons to allow using spotArea and customArea commands in command options
Version 20220916
- Added Deebot T10 models to supported device list
Version 20220921
- Fixed communication error being shown after access token expiry
Version 20221106
- Fix vacuum thing being set ONLINE too early if initialization fails
Version 20230109
- Add channel for enabling/disabling āTrue Detect 3Dā
- Add channel for enabling/disabling continuous cleaning
- Add channel for setting default number of cleaning passes
- Add channel for enabling/disabling/triggering auto dust bin emptying
Version 20230114
- Fix device metadata for newer devices with auto empty station & True Detect 3D
- Fix clean info report parsing for Deebot X1 Omni
Version 20230116
- Fix event update stopping on Deebot X1 Omni when cleaning pads are washed
Version 20230118
- Ignore MQTT messages with invalid JSON syntax, which previously broke event updates
Version 20230201
- Fix authentication token expiry not being handled correctly on some (XML-over-MQTT) models
Version 20230314
- Add some missing models to supported device list