Xiaomi Miot : intégrer tes appareils Xiaomi à Home Assistant

Appareils Xiaomi intégrés à Home Assistant via l'intégration Xiaomi Miot
Comment intégrer tes appareils Xiaomi (Wi-Fi, Bluetooth LE, Zigbee) à Home Assistant via l'intégration communautaire Xiaomi Miot, et les limites à connaître face à l'intégration officielle.

Sommaires

Tu as un aspirateur, une prise ou un capteur Xiaomi qui dort dans l’appli Mi Home, séparé du reste de ta domotique ? L’intégration communautaire Xiaomi Miot (parfois appelée « MIoT Auto ») permet de récupérer la quasi-totalité du catalogue Xiaomi dans Home Assistant — Wi-Fi, Bluetooth LE et Zigbee — en passant par le protocole miot-spec plutôt que l’ancien miIO.

Ce guide est basé sur la documentation du projet communautaire hass-xiaomi-miot et les retours de la communauté Home Assistant — je n’ai pas testé cette intégration moi-même, donc vérifie la compatibilité de ton appareil précis avant de te lancer.


🧩 Ce qu’il te faut avant de commencer

  • HACS déjà installé dans Home Assistant (voir mon article sur les intégrations HACS que j’utilise si ce n’est pas encore le cas).
  • Un compte Xiaomi/Mi Home, avec tes appareils déjà appairés dans l’appli officielle.
  • Pour les appareils Wi-Fi : le « token » de l’appareil, récupérable via l’appli Mi Home ou des outils communautaires d’extraction de token.

🔧 Installer l’intégration

  1. Dans HACS, va dans Intégrations → Explorer et télécharger des dépôts, cherche « Xiaomi Miot » et télécharge le dépôt.
  2. Redémarre Home Assistant.
  3. Va dans Paramètres → Appareils et services → Ajouter une intégration, cherche « Xiaomi Miot », et connecte-toi avec ton compte Xiaomi.
  4. L’intégration liste automatiquement les appareils détectés sur ton compte ; sélectionne ceux que tu veux ajouter.

Attention à la confusion : Xiaomi propose aussi sa propre intégration officielle (« Xiaomi Home »), distincte du projet communautaire hass-xiaomi-miot. Les deux ne couvrent pas exactement le même catalogue d’appareils ni les mêmes protocoles — vérifie laquelle supporte ton appareil avant d’installer les deux en parallèle.


📲 Ce que tu récupères dans Home Assistant

Grâce au protocole miot-spec, l’intégration expose généralement bien plus de détails qu’une intégration générique : pas seulement « on/off », mais aussi le niveau de batterie, les modes de fonctionnement spécifiques (vitesse d’aspiration, mode silencieux…), les capteurs de température/humidité embarqués, et parfois des statistiques d’usage (durée de fonctionnement, consommables à changer sur un aspirateur robot).


🎯 Limites à connaître

  • Dépendance au cloud Xiaomi : la configuration initiale passe par ton compte Mi Home — ce n’est pas une intégration 100 % locale comme Zigbee2MQTT, même si les requêtes du quotidien passent ensuite en local sur le même réseau pour la plupart des appareils Wi-Fi.
  • Couverture variable selon l’appareil : certains appareils récents ou très spécifiques peuvent ne pas être encore supportés par le mapping miot-spec de l’intégration.
  • Deux intégrations qui se recoupent partiellement : l’intégration officielle Xiaomi Home et le projet communautaire hass-xiaomi-miot évoluent séparément — mélanger les deux sur le même appareil peut créer des entités en double.

👉 En résumé

Xiaomi Miot est une des façons les plus complètes de sortir tes appareils Xiaomi de l’appli Mi Home pour les intégrer à tes automatisations Home Assistant. Pour centraliser ensuite tes alertes liées à ces appareils, jette un œil à l’article sur les notifications Home Assistant, ou à celui sur le suivi de consommation électrique si tu intègres des prises Xiaomi.