Plugin: RoboRock - Staubsauger

[hismastersvoice]

Ich habe aus Eigenbedarf mal ein Plugin für RoboRock Staubsauger entwickelt.

https://wiki.loxberry.de/plugins/roborock/start


Was macht das Plugin?

• Status je Sauger: Akku, Zustand, Fehler, Reinigungsfortschritt, Saug-/Wisch-/Wassereinstellung, Dock-Status, Verbrauchsteile-Laufzeiten, online ja/nein.
• Ausgabe wahlweise per UDP (je Intervall nur geänderte Felder, plus periodischer Voll-Refresh), MQTT (jeder Wert ein Topic, retained) und/oder HTTP (Abfrage auf Anfrage).
• Steuerung per HTTP-GET: Start, Stopp, Pause, Andocken, Suchen, Saugstufe, Wassermenge, Wischmodus, Programm (Saugen/Wischen/beides), Nicht-stören, gezielte Raumreinigung.
• Mehrere Sauger gleichzeitig, jeder mit eigenem Prefix.
• Fertige Loxone-Vorlagen (VIU + VO), die automatisch für alle konfigurierten Sauger erzeugt werden.


Freu mich auf Feedback

[Prof.Mobilux]

Sehr cool - das einzigste, warum bei mir aktuell ioBroker noch parallel läuft.... Ist das eine Eigenentwicklung oder nutzt Du irgendeine vorhandene Lib?

[hismastersvoice]

Nutze eine fertige Lib, wollte das Rad nicht neu erfinden.

https://github.com/Python-roborock/python-roborock

Allerdings läuft die nicht auf 5.x sondern auch 3.21.1.
Es gibt noch diverse ungelöste Probleme mit Rate-Limits etc.
Deswegen habe ich mich vorerst für älter und kpl. Lokal arbeitende Version entschieden.


Es laufen aber die aktuellen Modelle mit der 3.21.1.

[MiLox]

Ah super, danke. Ich nutze aktuell noch den Umweg über HA. Schaue mir mal an ob es sich lohnt umzusteigen.

[t_heinrich]

Das klingt ja toll.
Frage: kann man dann auch die Roborock.app benutzen?

Bis dato nutze ich immer noch die Xiaomi Home.app, damit ich das Loxberry.Plugin MiRobot2Lox-NG nutzen kann.

Danke.

[hismastersvoice]

Die App hat erst mal nix mit dem Plugin zu tun.

Ich gehe davon aus dass deine Geräte schon älter sind?
Wenn ja lass es dir die es ist.

[t_heinrich]

Da hab ich mich evtl. falsch ausgedrückt.
Also ich habe einen roborock Q8 Max+.
Die "bessere" App soll die roborock.app sein, die konnte man aber nicht nutzen, wenn man das Loxberry.Plugin MiRobot2Lox-NG nutzen wollte.
Von daher bin ich doch eher geneigt dazu dein Plugin zu testen/nutzen. :-)

[Iluminatus23]

Kann ich mit diesem Plugin einen Roborock S7 Pro Ultra auch einen Befehl geben, dass er Raum A saugen+wischen soll und mit einem anderen Befehl Raum B nur saugen ohne zu wischen?

[hismastersvoice]

Theoretisch ja, aber wie du dir vorstellen kannst habe ich nicht alle Sauger von RoboRock.
Also installieren und versuchen.

Du kannst per API alles einstellen wenn das Model unterstützt wird, und auch Räume (auch mehrere) per API reinigen lassen.
Vermutlich brauchst du mehrere Befehle nicht nur einen.

[meisterjäger]

Ich konnte einen Code anfordern aber wenn ich mich mit diesem einloggen will kommt folgende Fehlermeldung. Kann mir wer helfen?

[Prof.Mobilux]

Deine Namensauflösung ist kaputt. Weather4Lox Plugin installiert? Dann mal dort im Thread nachlesen. Wenn das W4L nicht installiert ist Deine Netzwerkeinstellungen prüfen.

[meisterjäger]

Vielen Dank für den Hinweis. Ich habe weather4lox installiert. Mit dem Hinweis im Thread funktioniert es jetzt

[Desastermann]

Plugin entdeckt, installiert und zack funktioniert auf anhieb mit einem Roborock S6 MaxV.
Die Räume und die IDs konnte ich noch nicht importieren, hier muss ich noch bisschen probieren.

Aber grundsätzlich läuft das.

DANKE, DANKE, DANKE!!!

[king-rulez]

Hat jemand das gleiche Problem bei Loxberry Version 3.0.1.3 ?

[s2nrbald]

Ja, ich auch.

ich versuche gerade das neue RoboRock-Plugin unter LoxBerry v3.0.1.3 in Betrieb zu nehmen, scheitere aber leider komplett am Login-Prozess. Sobald ich versuche mich einzuloggen, bricht das Skript mit folgendem Fehler ab:

Traceback (most recent call last): File "/opt/loxberry/bin/plugins/roborock/roborock_login.py", line 27, in <module> from roborock.web_api import RoborockApiClient ModuleNotFoundError: No module named 'roborock'

Ich habe bereits versucht, die Abhängigkeit manuell über das Web-Terminal nachzuinstallieren (python3 -m pip install python-roborock). Dabei bin ich in eine Versions-Sackgasse geraten:
Die aktuelle Version der python-roborock Bibliothek auf PyPI setzt anscheinend mindestens Python 3.11 voraus und hat das Modul web_api.py intern komplett umstrukturiert oder entfernt (der Import wirft auch bei manuellen Pfad-Injektionen einen ImportError). Mein LoxBerry läuft im Terminal standardmäßig auf einer Python 3.9 Basis.
Da der Plugin-Entwickler hismastersvoice oben geschrieben hat, dass das Plugin auf einer älteren, lokalen Version (3.21.1 / bzw. einer älteren Git-Lib) aufsetzt, vermute ich, dass die Abhängigkeiten bei mir bei der Plugin-Installation nicht richtig mitinstalliert wurden oder im falschen Python-Pfad liegen.
Hat jemand unter LoxBerry 3.0.1.3 denselben Fehler gelöst oder kann mir sagen, in welches exakte Verzeichnis (z.B. /opt/loxberry/data/plugins/roborock/libs) ich welche genaue Legacy-Version der python-roborock Lib manuell kopieren muss, damit der Web-UI-Login-Prozess fehlerfrei durchläuft?
Vielen Dank für eure Hilfe!

---

[hismastersvoice]

cd /opt/loxberry/bin/plugins/roborock
rm -rf venv
python3 -m venv venv
./venv/bin/pip install -r requirements.txt
./venv/bin/python3 -c "import roborock; print('ok')"
sudo systemctl restart roborock

Das passiert wohl wenn die venv nicht sauber installiert werden.

Ich mache einen fix bei dem das in der Installation schon gecheckt und ggf die Installation unterbrochen wird wenn es nicht sauber installiert wird.

[s2nrbald]

Hallo zusammen,

ich habe das Plugin erfolgreich installiert und der Login funktioniert. Leider bekomme ich beim Verbinden mit meinem Roborock Saros 20X einen Timeout-Fehler:

INFO roborock.local_api: Connecting to 192.168.178.199
INFO roborock.local_api: Connected to 192.168.178.199
ERROR roborock.local_api: id=1 Timeout after 4 seconds

Das Gerät ist per Ping erreichbar und reagiert auf Befehle über die Roborock-App. Die Konfiguration (IP, UDP, HTTP-API) ist korrekt gesetzt.

Nach einiger Recherche vermute ich, dass die verwendete python-roborock Bibliothek (Version 0.20.2) den Saros 20X noch nicht unterstützt. Laut Changelog wurde der Saros 20X erst in Version 5.10+ der Bibliothek hinzugefügt (Mai 2026). Die neueren Versionen benötigen jedoch Python 3.11+, während LoxBerry 3.0.1.3 auf Python 3.9 läuft.

Geräte-Details:

• Modell: roborock.vacuum.a288
• LoxBerry Version: 3.0.1.3
• python-roborock Version: 0.20.2
• Python Version: 3.9

Meine Fragen:

• Ist der Saros 20X (roborock.vacuum.a288) mit dem Plugin kompatibel?
• Gibt es Pläne, das Plugin auf eine neuere Version der python-roborock Bibliothek zu aktualisieren?
• Gibt es einen Workaround für Python 3.9?

Vielen Dank für das tolle Plugin und eure Hilfe!

[hismastersvoice]

Saros 20X nutzt nicht den lokalen Port 58867
Ich habe das Plugin so gebaut das es ohne Cloud arbeitet.

Ich habe mal einen Cloud-Fallback eingebaut wenn die Daten nicht Lokal kommen.
Kann es aber nicht wirklich testen.

Versuch mal dein Glück mit der Version

[atta1990]

Hi und vielen Dank für das geniale Plugin. Funktioniert mit meinem Qrevo Curv S5X super.

Gibt es eine Möglichkeit herauszufinden welchen Raum der Sauger gerade reinigt?

Danke und Grüße!

[hismastersvoice]

Gibt es eine Möglichkeit herauszufinden welchen Raum der Sauger gerade reinigt?

In der Version 1.0.4 habe ich das eingebaut.
Es dauert immer ein paar Sekunden bis er den richten Raum übermittelt!