Home Assistant peut intégrer plusieurs appareils Xiaomi, mais il n’existe pas une méthode universelle valable pour tout l’écosystème. La compatibilité dépend du modèle, de sa génération, de l’intégration utilisée et parfois de la région du compte Xiaomi Home.
Les anciens tutoriels qui recommandent systématiquement de basculer le compte sur « Chine continentale », d’activer un menu LAN caché ou d’extraire un token ne doivent plus être appliqués aveuglément. Certaines anciennes passerelles utilisent encore ce type de méthode, tandis que d’autres appareils peuvent aujourd’hui être ajoutés directement depuis l’interface de Home Assistant.
Commencer par configurer correctement l’appareil dans Xiaomi Home
Pour de nombreux appareils pris en charge, Home Assistant recommande d’abord de configurer l’équipement dans Xiaomi Home. L’intégration Home Assistant peut ensuite découvrir ou connecter l’appareil selon le modèle.
- Ajoutez l’appareil dans Xiaomi Home et vérifiez qu’il fonctionne normalement.
- Notez la région/serveur utilisé par votre compte Xiaomi Home.
- Mettez le firmware de l’appareil à jour.
- Dans Home Assistant, ouvrez Paramètres > Appareils et services.
- Vérifiez si Xiaomi Home est découvert automatiquement ou utilisez Ajouter une intégration.
- Suivez le flux de configuration proposé pour votre appareil.
La documentation Home Assistant précise que, pour les appareils pris en charge, l’utilisation des identifiants Xiaomi Home peut simplifier la configuration et permettre de récupérer les équipements associés au compte.
Tous les appareils Xiaomi sont-ils compatibles avec Home Assistant ?
Non. La marque Xiaomi couvre des centaines de références et plusieurs générations de protocoles. Une caméra, un purificateur d’air, une passerelle, une prise ou un aspirateur peuvent utiliser des intégrations différentes.
Avant d’acheter un appareil dans l’objectif de l’utiliser avec Home Assistant, vérifiez le modèle exact dans la documentation Home Assistant. Une simple mention « Xiaomi Home » sur l’emballage ne garantit pas une intégration complète dans Home Assistant.
Région Xiaomi Home : pourquoi elle compte
Home Assistant peut avoir besoin de connaître le serveur utilisé par Xiaomi Home. La région est celle sur laquelle l’appareil a été initialement configuré. Il ne faut donc pas la changer au hasard uniquement parce qu’un ancien tutoriel indique que « Chine continentale » débloque davantage de fonctions.
Un changement de région peut faire disparaître des appareils de l’application ou les rattacher à un autre serveur. Pour une installation européenne stable, partez autant que possible d’appareils vendus pour votre marché.
Contrôle local ou cloud : cela dépend de l’appareil
La situation n’est pas binaire. Certains appareils Xiaomi peuvent être pilotés localement sur le réseau, tandis que d’autres utilisent le service Xiaomi Home pour récupérer une partie de leur configuration ou de leurs sous-appareils.
Home Assistant indique par exemple que certaines passerelles peuvent nécessiter les identifiants Xiaomi Home pour récupérer les appareils enfants, puis continuer à échanger localement pour le contrôle et les mises à jour d’état. D’autres intégrations historiques utilisent encore des mécanismes différents.
Les vieux tutoriels de token sont-ils encore utiles ?
Parfois, mais uniquement pour des modèles précis. L’extraction d’un token Xiaomi a longtemps été une étape courante pour plusieurs appareils MiIO. Aujourd’hui, Home Assistant recommande souvent d’utiliser son flux de configuration lorsque celui-ci existe, plutôt que de commencer par des scripts tiers.
- Ne téléchargez pas un « token extractor » exécutable depuis une source inconnue.
- Ne saisissez pas vos identifiants Xiaomi dans un script tiers sans en comprendre le fonctionnement.
- Vérifiez d’abord si votre appareil dispose d’une intégration officielle/configurable depuis l’interface.
- Si un token est réellement nécessaire, suivez la documentation correspondant exactement au modèle.
Passerelles Xiaomi et sous-appareils
Les anciennes et nouvelles passerelles Xiaomi ne se comportent pas toutes de la même manière. Certaines permettent à Home Assistant d’accéder directement aux sous-appareils, tandis que d’autres ont besoin du service Xiaomi Home pour les récupérer.
Évitez donc de recopier une procédure « mode développeur + LAN + clé » conçue pour une passerelle de 2018 sur un hub plus récent. Vérifiez le numéro de modèle de la passerelle avant toute manipulation.
Roborock, Aqara et autres marques : attention aux raccourcis
Un produit historiquement associé à l’écosystème Xiaomi peut disposer aujourd’hui de sa propre application ou de sa propre intégration Home Assistant. Il vaut donc mieux rechercher l’intégration du fabricant et du modèle exact plutôt que de supposer qu’il doit obligatoirement passer par Xiaomi Home.
Home Assistant précise notamment que certains aspirateurs Roborock doivent être configurés dans Xiaomi Home pour l’intégration Xiaomi Miio, alors que d’autres usages peuvent relever d’une intégration Roborock distincte. Le choix dépend du modèle et de votre configuration actuelle.
Réseau : pourquoi VLAN et sous-réseaux peuvent poser problème
Si vous segmentez vos objets connectés sur un VLAN ou un sous-réseau séparé, certaines découvertes ou communications locales Xiaomi peuvent ne plus fonctionner automatiquement. Home Assistant documente notamment des limitations lorsque les paquets UDP ne proviennent pas du même sous-réseau.
Ce n’est pas une raison pour abandonner la segmentation réseau, mais une installation avancée peut demander des règles réseau supplémentaires. Pour un utilisateur débutant, commencez par faire fonctionner l’appareil sur un réseau simple avant de complexifier l’architecture.
Quelle méthode choisir ?
| Situation | Méthode conseillée |
|---|---|
| Appareil supporté et découvert par Home Assistant | Utiliser le flux de configuration dans l’interface |
| Appareil déjà configuré dans Xiaomi Home | Conserver la même région et suivre l’intégration correspondante |
| Ancien appareil MiIO demandant un token | Suivre la documentation spécifique au modèle |
| Appareil non listé comme compatible | Ne pas supposer qu’une méthode Xiaomi générique fonctionnera |
| Installation multi-marques | Utiliser les intégrations propres à chaque écosystème plutôt qu’un seul hack générique |
Avant de modifier une installation qui fonctionne
- Notez le modèle exact des appareils et hubs.
- Conservez la région Xiaomi Home utilisée lors de l’appairage.
- Faites une sauvegarde Home Assistant avant une grosse migration.
- Ne supprimez pas l’appareil de Xiaomi Home tant que la nouvelle intégration n’est pas validée.
- Testez les commandes et les remontées d’état avant de migrer vos automatisations.
Pour comprendre l’architecture Xiaomi Home, les hubs et les protocoles avant de passer à Home Assistant, consultez notre guide domotique Xiaomi.
FAQ
Dois-je obligatoirement extraire un token Xiaomi ?
Non. Cela dépend de l’appareil et de l’intégration. Commencez par le flux de configuration Home Assistant correspondant à votre modèle.
Faut-il mettre Xiaomi Home en région Chine ?
Non comme règle générale. Utilisez la région sur laquelle votre appareil a été configuré et suivez la documentation du modèle.
Home Assistant remplace-t-il Xiaomi Home ?
Pas toujours. Selon l’appareil, Xiaomi Home peut rester nécessaire pour l’appairage, les mises à jour ou certaines fonctions propriétaires.
Le contrôle est-il entièrement local ?
Cela dépend du modèle et de l’intégration. Certains échanges sont locaux, d’autres peuvent encore nécessiter les services Xiaomi Home.