{"id":246884,"date":"2025-11-16T06:35:11","date_gmt":"2025-11-16T06:35:11","guid":{"rendered":"https:\/\/forum-xiaomi.com\/blog\/actualites-xiaomi\/guide-xiaomi-maison-intelligente\/"},"modified":"2026-09-14T20:56:10","modified_gmt":"2026-09-14T20:56:10","slug":"xiaomi-home-assistant","status":"publish","type":"post","link":"https:\/\/forum-xiaomi.com\/blog\/guides-tutoriels\/xiaomi-home-assistant\/","title":{"rendered":"Xiaomi et Home Assistant : int\u00e9grer ses appareils sans vieux tutoriels Mi Home"},"content":{"rendered":"<p class=\"wp-block-paragraph\"><strong>Home Assistant<\/strong> peut int\u00e9grer plusieurs appareils Xiaomi, mais il n\u2019existe pas une m\u00e9thode universelle valable pour tout l\u2019\u00e9cosyst\u00e8me. La compatibilit\u00e9 d\u00e9pend du mod\u00e8le, de sa g\u00e9n\u00e9ration, de l\u2019int\u00e9gration utilis\u00e9e et parfois de la r\u00e9gion du compte Xiaomi Home.<\/p>\n\n<p class=\"wp-block-paragraph\">Les anciens tutoriels qui recommandent syst\u00e9matiquement de basculer le compte sur \u00ab Chine continentale \u00bb, d\u2019activer un menu LAN cach\u00e9 ou d\u2019extraire un token ne doivent plus \u00eatre appliqu\u00e9s aveugl\u00e9ment. Certaines anciennes passerelles utilisent encore ce type de m\u00e9thode, tandis que d\u2019autres appareils peuvent aujourd\u2019hui \u00eatre ajout\u00e9s directement depuis l\u2019interface de Home Assistant.<\/p>\n\n<h2 class=\"wp-block-heading\">Commencer par configurer correctement l\u2019appareil dans Xiaomi Home<\/h2>\n\n<p class=\"wp-block-paragraph\">Pour de nombreux appareils pris en charge, Home Assistant recommande d\u2019abord de configurer l\u2019\u00e9quipement dans <strong>Xiaomi Home<\/strong>. L\u2019int\u00e9gration Home Assistant peut ensuite d\u00e9couvrir ou connecter l\u2019appareil selon le mod\u00e8le.<\/p>\n\n<ol class=\"wp-block-list\"><li>Ajoutez l\u2019appareil dans Xiaomi Home et v\u00e9rifiez qu\u2019il fonctionne normalement.<\/li><li>Notez la r\u00e9gion\/serveur utilis\u00e9 par votre compte Xiaomi Home.<\/li><li>Mettez le firmware de l\u2019appareil \u00e0 jour.<\/li><li>Dans Home Assistant, ouvrez <strong>Param\u00e8tres &gt; Appareils et services<\/strong>.<\/li><li>V\u00e9rifiez si Xiaomi Home est d\u00e9couvert automatiquement ou utilisez <strong>Ajouter une int\u00e9gration<\/strong>.<\/li><li>Suivez le flux de configuration propos\u00e9 pour votre appareil.<\/li><\/ol>\n\n<p class=\"wp-block-paragraph\">La documentation Home Assistant pr\u00e9cise que, pour les appareils pris en charge, l\u2019utilisation des identifiants Xiaomi Home peut simplifier la configuration et permettre de r\u00e9cup\u00e9rer les \u00e9quipements associ\u00e9s au compte.<\/p>\n\n<h2 class=\"wp-block-heading\">Tous les appareils Xiaomi sont-ils compatibles avec Home Assistant ?<\/h2>\n\n<p class=\"wp-block-paragraph\">Non. La marque Xiaomi couvre des centaines de r\u00e9f\u00e9rences et plusieurs g\u00e9n\u00e9rations de protocoles. Une cam\u00e9ra, un purificateur d\u2019air, une passerelle, une prise ou un aspirateur peuvent utiliser des int\u00e9grations diff\u00e9rentes.<\/p>\n\n<p class=\"wp-block-paragraph\">Avant d\u2019acheter un appareil dans l\u2019objectif de l\u2019utiliser avec Home Assistant, v\u00e9rifiez le <strong>mod\u00e8le exact<\/strong> dans la documentation Home Assistant. Une simple mention \u00ab Xiaomi Home \u00bb sur l\u2019emballage ne garantit pas une int\u00e9gration compl\u00e8te dans Home Assistant.<\/p>\n\n<h2 class=\"wp-block-heading\">R\u00e9gion Xiaomi Home : pourquoi elle compte<\/h2>\n\n<p class=\"wp-block-paragraph\">Home Assistant peut avoir besoin de conna\u00eetre le serveur utilis\u00e9 par Xiaomi Home. La r\u00e9gion est celle sur laquelle l\u2019appareil a \u00e9t\u00e9 initialement configur\u00e9. Il ne faut donc pas la changer au hasard uniquement parce qu\u2019un ancien tutoriel indique que \u00ab Chine continentale \u00bb d\u00e9bloque davantage de fonctions.<\/p>\n\n<p class=\"wp-block-paragraph\">Un changement de r\u00e9gion peut faire dispara\u00eetre des appareils de l\u2019application ou les rattacher \u00e0 un autre serveur. Pour une installation europ\u00e9enne stable, partez autant que possible d\u2019appareils vendus pour votre march\u00e9.<\/p>\n\n<h2 class=\"wp-block-heading\">Contr\u00f4le local ou cloud : cela d\u00e9pend de l\u2019appareil<\/h2>\n\n<p class=\"wp-block-paragraph\">La situation n\u2019est pas binaire. Certains appareils Xiaomi peuvent \u00eatre pilot\u00e9s localement sur le r\u00e9seau, tandis que d\u2019autres utilisent le service Xiaomi Home pour r\u00e9cup\u00e9rer une partie de leur configuration ou de leurs sous-appareils.<\/p>\n\n<p class=\"wp-block-paragraph\">Home Assistant indique par exemple que certaines passerelles peuvent n\u00e9cessiter les identifiants Xiaomi Home pour r\u00e9cup\u00e9rer les appareils enfants, puis continuer \u00e0 \u00e9changer localement pour le contr\u00f4le et les mises \u00e0 jour d\u2019\u00e9tat. D\u2019autres int\u00e9grations historiques utilisent encore des m\u00e9canismes diff\u00e9rents.<\/p>\n\n<h2 class=\"wp-block-heading\">Les vieux tutoriels de token sont-ils encore utiles ?<\/h2>\n\n<p class=\"wp-block-paragraph\">Parfois, mais uniquement pour des mod\u00e8les pr\u00e9cis. L\u2019extraction d\u2019un token Xiaomi a longtemps \u00e9t\u00e9 une \u00e9tape courante pour plusieurs appareils MiIO. Aujourd\u2019hui, Home Assistant recommande souvent d\u2019utiliser son flux de configuration lorsque celui-ci existe, plut\u00f4t que de commencer par des scripts tiers.<\/p>\n\n<ul class=\"wp-block-list\"><li>Ne t\u00e9l\u00e9chargez pas un \u00ab token extractor \u00bb ex\u00e9cutable depuis une source inconnue.<\/li><li>Ne saisissez pas vos identifiants Xiaomi dans un script tiers sans en comprendre le fonctionnement.<\/li><li>V\u00e9rifiez d\u2019abord si votre appareil dispose d\u2019une int\u00e9gration officielle\/configurable depuis l\u2019interface.<\/li><li>Si un token est r\u00e9ellement n\u00e9cessaire, suivez la documentation correspondant exactement au mod\u00e8le.<\/li><\/ul>\n\n<h2 class=\"wp-block-heading\">Passerelles Xiaomi et sous-appareils<\/h2>\n\n<p class=\"wp-block-paragraph\">Les anciennes et nouvelles passerelles Xiaomi ne se comportent pas toutes de la m\u00eame mani\u00e8re. Certaines permettent \u00e0 Home Assistant d\u2019acc\u00e9der directement aux sous-appareils, tandis que d\u2019autres ont besoin du service Xiaomi Home pour les r\u00e9cup\u00e9rer.<\/p>\n\n<p class=\"wp-block-paragraph\">\u00c9vitez donc de recopier une proc\u00e9dure \u00ab mode d\u00e9veloppeur + LAN + cl\u00e9 \u00bb con\u00e7ue pour une passerelle de 2018 sur un hub plus r\u00e9cent. V\u00e9rifiez le num\u00e9ro de mod\u00e8le de la passerelle avant toute manipulation.<\/p>\n\n<h2 class=\"wp-block-heading\">Roborock, Aqara et autres marques : attention aux raccourcis<\/h2>\n\n<p class=\"wp-block-paragraph\">Un produit historiquement associ\u00e9 \u00e0 l\u2019\u00e9cosyst\u00e8me Xiaomi peut disposer aujourd\u2019hui de sa propre application ou de sa propre int\u00e9gration Home Assistant. Il vaut donc mieux rechercher l\u2019int\u00e9gration du fabricant et du mod\u00e8le exact plut\u00f4t que de supposer qu\u2019il doit obligatoirement passer par Xiaomi Home.<\/p>\n\n<p class=\"wp-block-paragraph\">Home Assistant pr\u00e9cise notamment que certains aspirateurs Roborock doivent \u00eatre configur\u00e9s dans Xiaomi Home pour l\u2019int\u00e9gration Xiaomi Miio, alors que d\u2019autres usages peuvent relever d\u2019une int\u00e9gration Roborock distincte. Le choix d\u00e9pend du mod\u00e8le et de votre configuration actuelle.<\/p>\n\n<h2 class=\"wp-block-heading\">R\u00e9seau : pourquoi VLAN et sous-r\u00e9seaux peuvent poser probl\u00e8me<\/h2>\n\n<p class=\"wp-block-paragraph\">Si vous segmentez vos objets connect\u00e9s sur un VLAN ou un sous-r\u00e9seau s\u00e9par\u00e9, certaines d\u00e9couvertes ou communications locales Xiaomi peuvent ne plus fonctionner automatiquement. Home Assistant documente notamment des limitations lorsque les paquets UDP ne proviennent pas du m\u00eame sous-r\u00e9seau.<\/p>\n\n<p class=\"wp-block-paragraph\">Ce n\u2019est pas une raison pour abandonner la segmentation r\u00e9seau, mais une installation avanc\u00e9e peut demander des r\u00e8gles r\u00e9seau suppl\u00e9mentaires. Pour un utilisateur d\u00e9butant, commencez par faire fonctionner l\u2019appareil sur un r\u00e9seau simple avant de complexifier l\u2019architecture.<\/p>\n\n<h2 class=\"wp-block-heading\">Quelle m\u00e9thode choisir ?<\/h2>\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Situation<\/th><th>M\u00e9thode conseill\u00e9e<\/th><\/tr><\/thead><tbody><tr><td>Appareil support\u00e9 et d\u00e9couvert par Home Assistant<\/td><td>Utiliser le flux de configuration dans l\u2019interface<\/td><\/tr><tr><td>Appareil d\u00e9j\u00e0 configur\u00e9 dans Xiaomi Home<\/td><td>Conserver la m\u00eame r\u00e9gion et suivre l\u2019int\u00e9gration correspondante<\/td><\/tr><tr><td>Ancien appareil MiIO demandant un token<\/td><td>Suivre la documentation sp\u00e9cifique au mod\u00e8le<\/td><\/tr><tr><td>Appareil non list\u00e9 comme compatible<\/td><td>Ne pas supposer qu\u2019une m\u00e9thode Xiaomi g\u00e9n\u00e9rique fonctionnera<\/td><\/tr><tr><td>Installation multi-marques<\/td><td>Utiliser les int\u00e9grations propres \u00e0 chaque \u00e9cosyst\u00e8me plut\u00f4t qu\u2019un seul hack g\u00e9n\u00e9rique<\/td><\/tr><\/tbody><\/table><\/figure>\n\n<h2 class=\"wp-block-heading\">Avant de modifier une installation qui fonctionne<\/h2>\n\n<ul class=\"wp-block-list\"><li>Notez le mod\u00e8le exact des appareils et hubs.<\/li><li>Conservez la r\u00e9gion Xiaomi Home utilis\u00e9e lors de l\u2019appairage.<\/li><li>Faites une sauvegarde Home Assistant avant une grosse migration.<\/li><li>Ne supprimez pas l\u2019appareil de Xiaomi Home tant que la nouvelle int\u00e9gration n\u2019est pas valid\u00e9e.<\/li><li>Testez les commandes et les remont\u00e9es d\u2019\u00e9tat avant de migrer vos automatisations.<\/li><\/ul>\n\n<p class=\"wp-block-paragraph\">Pour comprendre l\u2019architecture Xiaomi Home, les hubs et les protocoles avant de passer \u00e0 Home Assistant, consultez notre <a href=\"https:\/\/forum-xiaomi.com\/blog\/guides-tutoriels\/xiaomi-domotique-maison\/\">guide domotique Xiaomi<\/a>.<\/p>\n\n<h2 class=\"wp-block-heading\">FAQ<\/h2>\n\n<h3 class=\"wp-block-heading\">Dois-je obligatoirement extraire un token Xiaomi ?<\/h3>\n<p class=\"wp-block-paragraph\">Non. Cela d\u00e9pend de l\u2019appareil et de l\u2019int\u00e9gration. Commencez par le flux de configuration Home Assistant correspondant \u00e0 votre mod\u00e8le.<\/p>\n\n<h3 class=\"wp-block-heading\">Faut-il mettre Xiaomi Home en r\u00e9gion Chine ?<\/h3>\n<p class=\"wp-block-paragraph\">Non comme r\u00e8gle g\u00e9n\u00e9rale. Utilisez la r\u00e9gion sur laquelle votre appareil a \u00e9t\u00e9 configur\u00e9 et suivez la documentation du mod\u00e8le.<\/p>\n\n<h3 class=\"wp-block-heading\">Home Assistant remplace-t-il Xiaomi Home ?<\/h3>\n<p class=\"wp-block-paragraph\">Pas toujours. Selon l\u2019appareil, Xiaomi Home peut rester n\u00e9cessaire pour l\u2019appairage, les mises \u00e0 jour ou certaines fonctions propri\u00e9taires.<\/p>\n\n<h3 class=\"wp-block-heading\">Le contr\u00f4le est-il enti\u00e8rement local ?<\/h3>\n<p class=\"wp-block-paragraph\">Cela d\u00e9pend du mod\u00e8le et de l\u2019int\u00e9gration. Certains \u00e9changes sont locaux, d\u2019autres peuvent encore n\u00e9cessiter les services Xiaomi Home.<\/p>","protected":false},"excerpt":{"rendered":"<p>Int\u00e9grer des appareils Xiaomi dans Home Assistant : compatibilit\u00e9 mod\u00e8le par mod\u00e8le, configuration via Xiaomi Home, r\u00e9gions, limites du contr\u00f4le local et pr\u00e9cautions avec les anciens tutoriels tokens\/LAN.<\/p>\n","protected":false},"author":2,"featured_media":252567,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[7],"tags":[456,457,343,455,10],"class_list":["post-246884","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-guides-tutoriels","tag-appareils-connectes","tag-centralisation","tag-domotique","tag-maison-intelligente","tag-xiaomi"],"_links":{"self":[{"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/posts\/246884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/comments?post=246884"}],"version-history":[{"count":2,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/posts\/246884\/revisions"}],"predecessor-version":[{"id":251348,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/posts\/246884\/revisions\/251348"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/media\/252567"}],"wp:attachment":[{"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/media?parent=246884"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/categories?post=246884"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/forum-xiaomi.com\/blog\/wp-json\/wp\/v2\/tags?post=246884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}