Roborock

Roborock

Aktueller Release
0.7.4
Entwickler
copystring
Lizenz
MIT

Roborock-Adapter für ioBroker

Mit diesem Adapter können Sie einen in der Roborock-App eingerichteten Roborock-Staubsauger steuern, seinen Status abrufen, die Reinigungshistorie einsehen und seine Karte anzeigen.

Dieser Adapter nutzt die Sentry-Bibliotheken, um Ausnahmen und Codefehler automatisch an die Entwickler zu melden. Weitere Details und Informationen zum Deaktivieren der Fehlerberichterstattung finden Sie in der Sentry-Plugin-Dokumentation ! Die Sentry-Berichterstattung wird ab js-controller 3.0 verwendet.

Anforderungen

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

Unterstützte Roboter

  • S-Serie: 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-Serie: Q5 Pro, Q7, 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

Zonenreinigung

Diese Funktion ist nur verfügbar, wenn die Kartenerstellung in den Adapteroptionen aktiviert ist. Öffnen Sie die Karte über die Registerkarte „Web-UI“ des Adapters in der ioBroker-Administrationsoberfläche; eine manuelle URL ist nicht erforderlich.

Die Kartenerstellung funktioniert nicht auf dem Raspberry Pi.

  • Zeichnen Sie das Quadrat, das Sie reinigen möchten. Roborock unterstützt bis zu 4 Reinigungszonen gleichzeitig.

Changelog

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.

0.7.0 (2026-05-04)

  • (copystring) Added support for Roborock Q10, including map handling for this model.
  • (copystring) Added support for Roborock Saros Z70.
  • (copystring) Improved local connections for newer Roborock models so reconnects, keepalive checks and map transfers are more reliable.
  • (copystring) Fixed empty images in mapBase64 and mapBase64Truncated.

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.