ioBroker.roborock

Tests:

Translation:

Roborock adapter for ioBroker

This adapter allows you the control, get states, cleaning history and view the map of a Roborock vacuum cleaner which is set up in the Roborock app.

• Requirements
• Supported robots
• Zone cleaning
• Changelog
• License

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Requirements

• Node.js >= 22.0.0
• ioBroker.admin >= 7.6.17
• ioBroker.js-controller >= 6.0.11

Supported robots

• S-Series: S4, S4 Max, S5 Max, S6, S6 Pure, S6 MaxV, S7, S7 MaxV (Pro/Ultra), S7 Pro Ultra, S7 Max Ultra, S8, S8+, S8 Pro Ultra, S8 MaxV Ultra
• Q-Series: Q5 Pro, Q7, Q7 Pro, Q7 Max, Q7 L5, Q8 Max
• Q Revo: Q Revo, Q Revo Pro
• Qrevo: Qrevo Slim, Qrevo S, Qrevo Curve, Qrevo Curv Series, Qrevo Edge, Qrevo Edge Series, Qrevo L, Qrevo Master, Qrevo MaxV
• Saros: Saros 10, Saros 10R, Saros 20 / Saros 20X, Saros Z70

Zone cleaning

This feature only works when map creation is enabled in the adapter options. Open the map from the adapter’s web UI tab in the ioBroker admin interface; no manual URL needed.

Map creation does not work on raspberry pi

• Draw your square meant for cleaning. Roborock supports up to 4 cleaning zones at once.

Changelog

0.8.0 (2026-10-11)

• (copystring) Added Roborock Q7 Pro support for maps, status and consumables.
• (copystring) Improved multi-step scene execution and local connections for B01 devices.
• (copystring) Coordinated UDP discovery when multiple adapter instances run.
• (copystring) Corrected the Qrevo Edge 2 water mode mapping.
• (gemsli) Fixed segment cleaning for rooms with inactive map states.
• (copystring) Fixed cloud reauthentication after HomeData 401 responses and corrected S7 dock error handling.

0.7.4 (2026-06-07)

• (copystring) Documented tested Roborock S8+ support.
• (copystring) Fixed consumable percentage values for devices where Roborock reports maintenance data via HomeData.
• (copystring) Re-enabled macOS support and added macOS test coverage.
• (copystring) Improved dependency update automation so updates are checked weekly and merged only after successful checks.
• (copystring) Updated p-queue to 9.3.0 and protobufjs to 8.5.0.
• (copystring) Improved CI performance for Linux, macOS and Windows adapter tests without reducing test coverage.

0.7.3 (2026-05-22)

• (copystring) Fixed V1 auto-empty dust collection to use the AppPlugin-verified app_start_collect_dust command.

0.7.2 (2026-05-20)

• (copystring) Fixed missing auto-empty command for Roborock Qrevo MaxV (#1272).
• (copystring) Fixed local endpoint refresh after temporary MQTT outages so stale local IP recovery retries immediately again.
• (copystring) Require bug reports to upload a .txt debug log file.

0.7.1 (2026-05-19)

• (copystring) Fixed local TCP recovery when a Roborock device gets a new LAN IP address.
• (copystring) Updated dependencies: @napi-rs/canvas to 1.0.0, protobufjs to 8.2.0 and zod to 4.4.3.
• (copystring) Resolved npm audit security advisories in transitive dependencies and documented the temporary dependency overrides.

Older changelog entries are available in CHANGELOG_OLD.md.

License

MIT License

Copyright (c) 2026 copystring copystring@gmail.com

See LICENSE for the full license text.