Xiaomi intègre officiellement Home Assistant en open source : une nouvelle expérience de domotique

1. Introduction

Salut à tous ! Aujourd'hui, on va parler d'un projet qui fait vraiment vibrer les passionnés de domotique : l'intégration officielle Xiaomi pour Home Assistant (ha_xiaomi_home). Développé et maintenu par Xiaomi lui-même, ce projet vise à offrir aux utilisateurs de Home Assistant une expérience de contrôle des objets connectés Xiaomi IoT plus fluide et plus fiable.

Avant, il existait bien des intégrations tierces pour les appareils Xiaomi, mais elles avaient toutes leurs petits défauts — retards de réponse, instabilité, etc. Là, avec le soutien officiel de Xiaomi, on peut s'attendre à de meilleures performances et une sécurité renforcée.

Home Assistant, c'est une plateforme d'automatisation domestique open source, connue pour sa compatibilité impressionnante et sa flexibilité. Elle est adorée par les amateurs de DIY. Et maintenant que Xiaomi, ce géant de la domotique, rejoint l'écosystème Home Assistant, c'est clairement une belle nouvelle.

Fonctionnalités principales :

• Support officiel : Développé et maintenu par Xiaomi, pour une stabilité et une compatibilité optimales.
• Intégration Home Assistant : Permet de contrôler et gérer les appareils intelligents Xiaomi directement depuis Home Assistant.
• Expérience utilisateur améliorée : Réponse plus rapide des appareils, réglant les problèmes de latence rencontrés avec les intégrations tierces.
• Large compatibilité : Prend en charge la majorité des appareils IoT Xiaomi, à l'exception des périphériques Bluetooth, infrarouges et virtuels.
• Multi-comptes et multi-zones : Supporte plusieurs comptes Xiaomi et permet d'ajouter des appareils de différentes régions dans une même zone Home Assistant.

2. Fonctionnalités clés

• Plusieurs méthodes d'installation : Git clone, HACS ou installation manuelle. Xiaomi recommande officiellement Git clone, car c'est plus pratique pour la gestion de versions et les mises à jour.
  • Installation par Git clone : cd config; git clone https://github.com/XiaoMi/ha_xiaomi_home.git; cd ha_xiaomi_home; ./install.sh /config.
• Connexion OAuth 2.0 : Utilise OAuth 2.0 pour l'authentification, sans stocker directement le mot de passe utilisateur dans Home Assistant — une couche de sécurité en plus.
• Contrôle cloud et contrôle local : Le contrôle passe principalement par le cloud Xiaomi. Pour les appareils compatibles avec le contrôle local, la communication peut se faire via la passerelle Xiaomi ou le réseau local (LAN).
  • Contrôle cloud : Communication via les serveurs cloud de Xiaomi.
  • Contrôle local : Communication directe sur le réseau local via une passerelle centrale Xiaomi ou le LAN. Attention, le contrôle local n'est pas disponible dans toutes les régions.
    • Passerelle centrale : Disponible uniquement en Chine continentale.
    • Contrôle LAN : Disponible dans toutes les régions, mais réservé aux appareils IP et reste expérimental — pas recommandé pour une utilisation quotidienne.
• Mécanisme de souscription aux messages : Quand une propriété d'appareil change ou qu'un événement se produit, le message est poussé en temps réel vers Home Assistant. Cela réduit la pression des requêtes répétitives (polling) sur le cloud.
• Mappage MIoT-Spec-V2 : Utilise le protocole IoT de Xiaomi, MIoT-Spec-V2, pour mapper appareils, services, propriétés, événements et actions vers les entités Home Assistant. Tout fonctionne comme il faut.

3. Astuces d'utilisation

• Gestion multi-comptes : Une fois qu'un compte Xiaomi est configuré, vous pouvez ajouter d'autres comptes via l'option « Ajouter un HUB ».
• Sélection de région : Lors de l'import des appareils Xiaomi, choisissez bien la bonne région. Les données sont isolées entre régions.
• Mode débogage : Activer le mode débogage pour les actions (action) permet d'envoyer manuellement des commandes avec des paramètres personnalisés.
• Mise à jour des règles de conversion d'entités : Si vous modifiez les fichiers specv2entity.py, spec_filter.json ou multi_lang.json, pensez à mettre à jour les règles de conversion d'entités dans la page de configuration de l'intégration pour que les changements prennent effet.
• Filtrage personnalisé : Le fichier spec_filter.json permet de filtrer les instances MIoT-Spec-V2 que vous ne souhaitez pas convertir en entités Home Assistant.
• Localisation : Le fichier multi_lang.json fournit des traductions locales pour les noms d'appareils et d'autres éléments textuels. Il a priorité sur les traductions provenant du cloud.

4. Cas d'utilisation

• Contrôle de l'éclairage intelligent : Réglez la luminosité, la couleur et l'état d'allumage des ampoules Xiaomi intelligentes via Home Assistant.
• Sécurité domestique : Combine caméras et capteurs Xiaomi pour automatiser la sécurité — par exemple, envoyer une alerte en cas de mouvement suspect.
• Monitoring environnemental : Utilisez les capteurs de température et d'humidité Xiaomi pour surveiller l'environnement intérieur en temps réel, et ajuster automatiquement la climatisation ou le chauffage en fonction.
• Scènes automatisées : Tirez parti de l'automatisation Home Assistant pour créer des scénarios comme le « mode retour à la maison » ou le « mode départ », et profitez d'une domotique vraiment intelligente.

5. Considérations de sécurité

Même si l'intégration officielle Xiaomi utilise OAuth 2.0 pour améliorer la sécurité, certains risques subsistent :

• Stockage en clair des données utilisateur : Les informations sensibles — données des appareils, certificats, tokens — sont stockées en clair dans les fichiers de configuration Home Assistant. Si ces fichiers sont compromis, quelqu'un pourrait accéder à vos appareils Xiaomi.
• Protégez vos fichiers de configuration : Assurez-vous que vos fichiers de configuration Home Assistant sont bien gardés, à l'abri des regards indiscrets.
• Révoquer l'autorisation : Si vous soupçonnez une fuite de token OAuth, vous pouvez révoquer l'autorisation de connexion depuis l'application Mi Home.

En résumé : protégez bien vos fichiers de configuration Home Assistant !

6. Questions fréquentes

• Quels appareils ne sont pas supportés ?
  • Les appareils Bluetooth, infrarouges et virtuels ne sont pas pris en charge pour le moment.
• Comment ajouter plusieurs comptes Xiaomi ?
  • Sur la page d'intégration Xiaomi Home déjà configurée, cliquez sur « Ajouter un HUB » pour ajouter d'autres comptes Xiaomi.
• Le contrôle local est-il disponible dans toutes les régions ?
  • Le contrôle local via passerelle centrale est uniquement disponible en Chine continentale. Le contrôle LAN est disponible partout, mais uniquement pour les appareils IP et n'est pas recommandé.
• Pourquoi Xiaomi recommande-t-il l'installation par Git clone ?
  • Git clone facilite le changement de version et les mises à jour, rendant la gestion plus simple.
• Comment mettre à jour l'intégration ?
  • Vous pouvez basculer vers une version spécifique avec Git clone, ou utiliser HACS pour la mise à jour.
• Comment utiliser une configuration personnalisée ?
  • Modifiez les fichiers spec_filter.json et multi_lang.json pour le filtrage et la traduction, puis mettez à jour les règles de conversion d'entités.