Xiaomi Vacuum
Sur Home Assistant 2026.11 ou une version ultérieure ? L’ouvrir dans la Marketplace
- Installations
- 95 partagent leurs statistiques
- Étoiles GitHub
- 10
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.7.0,
- Catégorie
- Électroménager et nettoyage, Nettoyage
- Type
- Intégration de la Marketplace
- Marque
- Xiaomi
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
xiaomi_vacuum- Problèmes
- Signaler un problème
Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.
À propos
Xiaomi Vacuum est une intégration pour les aspirateurs robots Xiaomi, qui couvre les modèles X20 Max, S20+ et S40 Pro. Le contrôle et la lecture de l'état se font en local via le protocole MIoT, tandis que le cloud Xiaomi sert à la connexion unique lors de la configuration, à l'image de la carte et aux textes d'erreur localisés. Elle ajoute une entité aspirateur avec les commandes standard, ainsi que des capteurs pour l'état, l'erreur et la durée de vie restante de la serpillière, des brosses et du filtre. Les sélecteurs couvrent le mode de nettoyage, les répétitions, le niveau d'eau de la serpillière, le trajet de balayage et l'évitement d'obstacles, et le S20+ n'a pas les deux derniers. Les pièces signalées par l'appareil peuvent être associées aux zones de Home Assistant, et le X20 Max propose aussi des actions pour le nettoyage de zone et pour lancer un nettoyage personnalisé enregistré dans l'app Mi Home. La configuration se fait dans l'interface, où tu choisis la région du cloud Xiaomi et l'aspirateur.
Résumé automatique du README et du code de roquerodrigo/ha-xiaomi-vacuum, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Choisis ta région du cloud Xiaomi
- RégionLe serveur cloud Mi Home qui héberge ton compte.
Également demandé lors d’une modification de la connexion.
Choisis ton aspirateur
- Aspirateur
Textes issus du code de roquerodrigo/ha-xiaomi-vacuum. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesNettoyage en cours, Lavette
- BoutonsCollecter la poussière
- ImagesCarte
- SélecteursMode, Nombre de passages, Niveau d'eau de la serpillière, Trajet de balayage, Évitement d'obstacles
- CapteursÉtat, Erreur, Code d’erreur, Vie serpillière, Vie brosse latérale, Vie filtre, Vie brosse principale
Actions
- Nettoyer une zoneNettoie un ou plusieurs rectangles tracés dans les coordonnées de la carte de l'aspirateur.Champs : Zones, Répétitions
- Lancer un nettoyage personnaliséLance un nettoyage personnalisé enregistré dans l'app Mi Home, avec les pièces ou les zones et les réglages qui y sont enregistrés.Champs : Nom
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Est un modèle non pris en charge
Extrait du 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…
Informations
- Installations
- 95 partagent leurs statistiques
- Étoiles GitHub
- 10
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.7.0,
- Catégorie
- Électroménager et nettoyage, Nettoyage
- Type
- Intégration de la Marketplace
- Marque
- Xiaomi
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
xiaomi_vacuum- Problèmes
- Signaler un problème
