ioBroker.mihome-vacuum 6.0.0 veröffentlicht
Hallo zusammen,
nach einer umfangreichen Modernisierung ist ioBroker.mihome-vacuum 6.0.0 veröffentlicht.
Diese Version wurde grundlegend überarbeitet. Neben der vollständigen Migration des Backends auf TypeScript wurden die Konfigurationsoberfläche sowie die VIS-1- und VIS-2-Widgets neu entwickelt.
Wichtige Voraussetzungen
Version 6.0.0 benötigt mindestens:
Node.js 22.13
js-controller 7.2.2
Admin 7.8.23
Bitte prüft diese Versionen vor dem Update.
Da es sich um eine große Modernisierung handelt, empfiehlt sich vor dem Update ein ioBroker-Backup. Nach dem Update sollten insbesondere Modell, Manager, lokale Verbindung, Cloud-Anmeldung, Timer und Widgets kontrolliert werden.
Neue Admin-Oberfläche
Die bisherige Konfiguration wurde durch eine moderne, responsive Oberfläche auf Basis von React, Vite und TypeScript ersetzt.
Die Oberfläche enthält getrennte Bereiche für:
Verbindung und Geräteauswahl
allgemeine Einstellungen
Karteneinstellungen
Timer
erweiterte Diagnose
Die Oberfläche unterstützt Hell- und Dunkelmodus sowie die vom ioBroker-Admin verwendete Sprache.
Neue Xiaomi-Cloud-Anmeldung
Die veraltete Anmeldung mit Xiaomi-Benutzername und Passwort wurde entfernt.
Die Anmeldung erfolgt jetzt über einen Xiaomi-Anmeldelink:
In der Adapterkonfiguration die passende Xiaomi-Region auswählen.
Auf „Xiaomi-Anmeldelink erstellen“ klicken.
Den angezeigten Link im Browser öffnen.
Die Anmeldung bei Xiaomi bestätigen.
Zur Adapterkonfiguration zurückkehren.
Auf „Geräte abrufen“ klicken.
Den gewünschten Staubsauger auswählen.
Es wird kein QR-Bild erzeugt. Die intern verwendeten QR-Protokollbezeichnungen bleiben lediglich aus Kompatibilitätsgründen erhalten.
Nach der Geräteauswahl können folgende Werte automatisch übernommen beziehungsweise aktualisiert werden:
lokaler Gerätetoken
IP-Adresse
Modell
passender Geräte-Manager
Lokale Steuerung bleibt unabhängig
Die lokale Steuerung über IP-Adresse und Token funktioniert weiterhin ohne aktive Xiaomi-Cloud-Anmeldung.
Die Cloud wird nur für folgende Funktionen benötigt:
automatische Gerätesuche
bequemes Ermitteln von Token, IP-Adresse und Modell
Xiaomi-Cloud-Karten
Wer Token, IP-Adresse und Modell bereits kennt, kann den Adapter vollständig manuell einrichten.
Eine mögliche Anleitung zum manuellen Ermitteln des Tokens findet ihr hier:
Token-Anleitung
Bitte behandelt den Token wie ein Passwort und veröffentlicht ihn niemals in Logs, Screenshots oder Forenbeiträgen.
Geschützte Konfiguration
Der lokale Gerätetoken und die Xiaomi-Cloud-Sitzung werden über die offiziellen ioBroker-Mechanismen geschützt und verschlüsselt gespeichert.
Der Token ist in der Oberfläche standardmäßig verdeckt. Über das Augensymbol kann er bei Bedarf angezeigt und kopiert werden.
Passwörter, Cookies, Cloud-Sitzungen, Gerätetoken, vollständige Xiaomi-Antworten und Anmelde-URLs werden nicht in normalen Logs ausgegeben.
Erweiterte Diagnose
In der Konfiguration kann bei Bedarf eine erweiterte Diagnose aktiviert werden.
Diese Ausgabe enthält zusätzliche Informationen über:
Geräteerkennung
Protokollabläufe
Cloud-Kommunikation
Modell- und Funktionsauswahl
Kartenverarbeitung
Die Diagnose ist standardmäßig deaktiviert und sollte nur vorübergehend zur Fehlersuche eingeschaltet werden. Vertrauliche Werte und personenbezogene Daten werden dabei soweit möglich entfernt oder gekürzt.
Komplett neue VIS-Widgets
Version 6 enthält neu entwickelte Widgets für VIS 1 und VIS 2.
Die Widgets bieten unter anderem:
aktuelle Karte
Verbindungsstatus
Roboterstatus
Akkustand
gereinigte Fläche
Reinigungszeit
Saugstärke
Start
Pause
Rückkehr zur Ladestation
Roboter finden
Raumreinigung
eigene Saugstärke pro Raum
Wartungszustände
Filter
Hauptbürste
Seitenbürste
Sensoren
Wasserfilter
Zurücksetzen der Wartungszähler
Reinigungshistorie
Fehleranzeige mit verständlichem Fehlertext
Die Darstellung ist responsiv und für breite sowie kleinere Widgetgrößen optimiert. Die Karte wird proportional dargestellt und sollte nicht mehr andere Bedienelemente überlagern.
Alle sichtbaren Texte verwenden die ioBroker-i18n-Übersetzungen.
Nach dem Update müssen vorhandene alte Widgets gegebenenfalls durch die neuen Widgets ersetzt oder deren Objekt-IDs neu zugewiesen werden.
Karten
Je nach Modell und Konfiguration können Karten über unterschiedliche Quellen bereitgestellt werden:
Xiaomi Cloud
lokale Roborock-Kartenverarbeitung
Valetudo, sofern mit dem jeweiligen Modell und der verwendeten Valetudo-Version kompatibel
Die lokale Steuerung bleibt auch dann verfügbar, wenn keine Cloud-Karte geladen werden kann.
Karten werden weiterhin über folgende Datenpunkte bereitgestellt:
cleanmap.map64
cleanmap.mapURL
cleanmap.actualMap
cleanmap.mapStatus
Der genaue Funktionsumfang hängt vom Modell und dessen Firmware ab.
Räume und Timer
Die Raumverwaltung wurde robuster gestaltet.
Unter anderem werden nun:
fehlende Raumobjekte vor dem Schreiben erstellt
Raumzuordnungen sicherer verarbeitet
mehrere Adapterinstanzen sauber getrennt
Räume direkt in den Widgets gestartet
individuelle Saugstärken pro Raum unterstützt
Die Timerverwaltung wurde ebenfalls modernisiert und verwendet nun die vorgesehenen ioBroker-Timermechanismen. Timer können in der Admin-Oberfläche erstellt, bearbeitet, geladen und gespeichert werden.
Backend vollständig auf TypeScript umgestellt
Das produktive Backend sowie die Geräte-Manager wurden von JavaScript auf TypeScript migriert:
Roborock
Viomi
Dreame
Miio/UDP-Kommunikation
Xiaomi-Cloud-Verbindung
Kartenverarbeitung
Raumverwaltung
Timerverwaltung
Protokoll- und Statusverarbeitung
Dabei wurden auch zahlreiche ältere und inzwischen veraltete ioBroker-Aufrufe ersetzt.
Stabilitätsverbesserungen
Unter anderem wurden folgende Probleme behoben:
verlorene erste miIO.info-Anfrage nach dem Verbindungsaufbau
verzögerte Statusabfragen ohne gültigen Manager-Kontext
Absturz mit Cannot read properties of undefined (reading 'log')
Befehle, die erst nach mehrmaligem Auslösen ausgeführt wurden
fehlendes Objekt control.clean_home
fehlende Raum-State-Objekte
falscher Datentyp beim WLAN-Signal
Statuszugriffe nach dem Beenden des Adapters
nicht sauber beendete Cloud-Anmeldungen
parallele oder überlappende Statusabfragen
Probleme bei mehreren Instanzen und im Compact Mode
beschädigte oder abgelaufene Cloud-Sitzungen
optionale beziehungsweise fehlende Konfigurationswerte
GitHub- und Dev-Server-Installationen ohne vorherige Build-Artefakte
Unterstützte Gerätefamilien
Der Adapter unterstützt Geräte aus folgenden Familien:
Roborock beziehungsweise rockrobo
Viomi
Dreame
Explizit dokumentiert sind unter anderem:
Roborock
rockrobo.vacuum.v1
roborock.vacuum.s4
roborock.vacuum.s5
roborock.vacuum.s5e
roborock.vacuum.m1s
roborock.vacuum.a10
roborock.vacuum.a15
Viomi
viomi.vacuum.v6
viomi.vacuum.v7
viomi.vacuum.v8
viomi.vacuum.v19
Dreame
dreame.vacuum.r2205
dreame.vacuum.r2216o
dreame.vacuum.r2228o
dreame.vacuum.p2008
dreame.vacuum.p2009
dreame.vacuum.p2027
dreame.vacuum.p2028
dreame.vacuum.p2029
dreame.vacuum.p2036
dreame.vacuum.p2041o
dreame.vacuum.p2114a
dreame.vacuum.p2148o
dreame.vacuum.p2156o
Nicht jede Funktion ist bei jeder Gerätefamilie verfügbar. Insbesondere Karten, Räume, Dockfunktionen und Wischfunktionen unterscheiden sich je nach Modell und Firmware.
Weitere Modelle aus diesen Gerätefamilien können funktionieren, gelten aber erst nach einem erfolgreichen Gerätetest als bestätigt.
Tests
Version 6.0.0 wurde umfangreich geprüft:
209 Laufzeit- und Protokolltests
76 Paket- und Metadatenprüfungen
TypeScript-Prüfung für Backend, Admin und Widgets
ESLint
Installationstest des gepackten npm-Pakets
Adaptertests unter Node.js 22 und Node.js 24
Tests unter Linux, Windows und macOS
erfolgreicher Live-Test mit einem roborock.vacuum.s5
Die vollständige Release-Pipeline ist grün.
Installation
Version 6.0.0 ist auf npm als latest veröffentlicht:
ioBroker.mihome-vacuum auf npm
GitHub Release:
ioBroker.mihome-vacuum v6.0.0
GitHub-Repository:
ioBroker.mihome-vacuum
Je nach Aktualisierungszeitpunkt der ioBroker-Repositories kann es etwas dauern, bis die Version regulär im Admin angezeigt wird.
Rückmeldungen und Fehlerberichte
Bitte gebt bei Problemen möglichst folgende Informationen an:
Adapterversion
Node.js-Version
js-controller-Version
Admin-Version
vollständige Modellkennung
ausgewählter Manager
verwendete Kartenquelle
relevante Logzeilen
genaue Aktion, bei der das Problem auftritt
Bitte veröffentlicht niemals:
Gerätetoken
Xiaomi-Passwort
Cookies
Cloud-Sitzungen
vollständige Xiaomi-Anmeldelinks
vollständige unbereinigte API-Antworten
Fehler und nachvollziehbare Funktionswünsche können über GitHub gemeldet werden:
GitHub Issues
Vielen Dank an alle Tester und Nutzer, die Logs, Rückmeldungen und Gerätetests zur Verfügung gestellt haben. Besonders bei Viomi- und Dreame-Geräten sind weitere reale Gerätetests sehr willkommen.