Xiaomi Vacuum voor Home Assistant (Marketplace-integratie)

Installaties: 95 die analysegegevens delen
GitHub-sterren: 10
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v2.7.0, 26 oktober 2026
Categorie: Huishoudelijke apparaten en schoonmaak, Schoonmaken
Soort: Marketplace-integratie
Merk: Xiaomi
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: xiaomi_vacuum
Bron: github.com/roquerodrigo/ha-xiaomi-vacuum
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

Xiaomi Vacuum is een integratie voor Xiaomi-robotstofzuigers, met ondersteuning voor de modellen X20 Max, S20+ en S40 Pro. Bediening en statusopvraging verlopen lokaal via het MIoT-protocol, terwijl de Xiaomi-cloud wordt gebruikt voor de eenmalige login tijdens de installatie, de kaartafbeelding en gelokaliseerde foutteksten. Het voegt een stofzuigerentiteit toe met standaardbediening, plus sensoren voor status, fout en de resterende levensduur van de mop, de borstels en het filter. Selecties omvatten reinigingsmodus, herhalingen, waterniveau van de mop, veegroute en obstakelvermijding, en de S20+ heeft de laatste twee niet. Kamers die het apparaat meldt kunnen worden gekoppeld aan gebieden van Home Assistant, en de X20 Max heeft ook acties voor zonereiniging en voor het starten van een aangepaste reiniging die in de Mi Home-app is opgeslagen. De installatie gebeurt in de UI, waar je de Xiaomi-cloudregio en de stofzuiger kiest.

Automatische samenvatting van de README en de code van roquerodrigo/ha-xiaomi-vacuum, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Kies je Xiaomi-cloudregio

RegioDe Mi Home-cloudserver waarop je account staat.

Ook gevraagd bij het wijzigen van de verbinding.

Kies je stofzuiger

Stofzuiger

Teksten uit de code van roquerodrigo/ha-xiaomi-vacuum. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

Binaire sensorenReiniging bezig, Moppad
KnoppenStof verzamelen
AfbeeldingenKaart
SelectiesModus, Aantal reinigingen, Waterniveau mop, Veegroute, Obstakelvermijding
SensorenStatus, Fout, Foutcode, Levensduur mop, Levensduur zijborstel, Levensduur filter, Levensduur hoofdborstel

Acties

Zone reinigenReinigt een of meer rechthoeken die zijn getekend in de kaartcoördinaten van de stofzuiger.Velden: Zones, Herhalingen
Aangepaste reiniging startenStart een aangepaste reiniging die in de Mi Home-app is opgeslagen, met de kamers of zones en de instellingen die daarin staan.Velden: Naam

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Is een niet-ondersteund model

Uit de 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…

Uit de README van roquerodrigo/ha-xiaomi-vacuum, MIT License. Ingekort.