Xiaomi Vacuum für Home Assistant (Marketplace-Integration)

Installationen: 95 teilen Analysedaten
GitHub-Sterne: 10
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2.7.0, 26. Oktober 2026
Kategorie: Haushaltsgeräte und Reinigung, Reinigung
Art: Marketplace-Integration
Marke: Xiaomi
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: xiaomi_vacuum
Quelle: github.com/roquerodrigo/ha-xiaomi-vacuum
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

Xiaomi Vacuum ist eine Integration für Xiaomi-Saugroboter und deckt die Modelle X20 Max, S20+ und S40 Pro ab. Steuerung und Statusabfrage laufen lokal über das MIoT-Protokoll, während die Xiaomi Cloud für die einmalige Anmeldung bei der Einrichtung, das Kartenbild und lokalisierte Fehlertexte genutzt wird. Sie fügt eine Saugroboter-Entität mit den Standardsteuerungen hinzu sowie Sensoren für Status, Fehler und die verbleibende Lebensdauer von Mopp, Bürsten und Filter. Auswahlen decken Reinigungsmodus, Wiederholungen, Wasserstufe des Mopps, Reinigungsroute und Hindernisvermeidung ab, wobei der S20+ die letzten beiden nicht hat. Vom Gerät gemeldete Räume können Home Assistant Bereichen zugeordnet werden, und der X20 Max hat außerdem Aktionen für die Zonenreinigung und zum Starten einer benutzerdefinierten Reinigung, die in der Mi Home App gespeichert ist. Die Einrichtung erfolgt in der Oberfläche, wo die Xiaomi Cloud Region und der Saugroboter ausgewählt werden.

Zusammenfassung der README und des Codes von roquerodrigo/ha-xiaomi-vacuum, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Wähle deine Xiaomi Cloud Region

RegionDer Mi Home Cloud-Server, auf dem dein Konto liegt.

Wird auch beim Ändern der Verbindung abgefragt.

Wähle deinen Saugroboter

Saugroboter

Texte aus dem Code von roquerodrigo/ha-xiaomi-vacuum. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenReinigung läuft, Mopp-Pad
TastenStaub sammeln
BilderKarte
AuswahlfelderModus, Reinigungsdurchgänge, Wasserstufe des Mopps, Reinigungsroute, Hindernisvermeidung
SensorenStatus, Fehler, Fehlercode, Lebensdauer des Mopps, Lebensdauer der Seitenbürste, Lebensdauer des Filters, Lebensdauer der Hauptbürste

Aktionen

Zone reinigenReinigt ein oder mehrere Rechtecke, die in den Kartenkoordinaten des Saugroboters angegeben sind.Felder: Zonen, Wiederholungen
Benutzerdefinierte Reinigung startenStartet eine in der Mi Home App gespeicherte benutzerdefinierte Reinigung mit den darin hinterlegten Räumen oder Zonen und Einstellungen.Felder: Name

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Ist ein nicht unterstütztes Modell

Aus der README

A Home Assistant integration for the Xiaomi Robot Vacuum X20 Max (xiaomi.vacuum.d109gl), Xiaomi Robot Vacuum S20+ (xiaomi.vacuum.b108gl) and Xiaomi Robot Vacuum S40 Pro (xiaomi.vacuum.ov71gl).
Day-to-day control and state polling run locally over the MIoT protocol (iot_class: local_polling). The Xiaomi cloud is used for one-time setup — a QR login that discovers the vacuum and fetches its IP and token for you — and for two cloud-only extras: the map image and localized error messages.
Vacuum entity with the standard HA controls: start, pause, stop, return to dock, locate, fan speed, battery, state.
Native segment cleaning — exposes the rooms reported by the device so you can use Home Assistant's Settings → Devices & services → Entities → vacuum → ⚙ → Map vacuum segments to areas dialog and…
Zone cleaning (X20 Max) — the xiaomi_vacuum.clean_zone action cleans one or more rectangles drawn in the vacuum's map coordinates, optionally setting the number of repeats. See
Custom cleanings (X20 Max) — the xiaomi_vacuum.start_custom_cleaning action starts a custom cleaning saved in the Mi Home app by its name. See
Map image — the live map is rendered from the Xiaomi cloud as an image entity you can drop on a dashboard.
Error reporting — Error (localized, human-readable fault text resolved from the Xiaomi cloud message feed) and Error code sensors. The fault is read from the device's live fault list, so it clears…

Aus der README von roquerodrigo/ha-xiaomi-vacuum, MIT License. Gekürzt.