Configuration avec le compte Xiaomi Home

Cette méthode doit être utilisée si le robot aspirateur est actuellement géré via l'application Xiaomi Home. Pour garantir la compatibilité, elle peut être vérifiée via l'application officielle Xiaomi Home disponible pour iOS et Android.

Exigences

• Identifiants: Doivent correspondre exactement au nom d'utilisateur et au mot de passe utilisés pour se connecter à l'application mobile (pas au site officiel).
• Région du serveur: Le pays sélectionné doit correspondre à la région où l'appareil est enregistré dans l'application. Des régions non correspondantes entraîneront des erreurs "échec de la connexion" ou "appareil introuvable".

Connexions tierces

Si le compte a été créé en utilisant un service tiers (comme Google ou Apple), un mot de passe dédié doit d'abord être généré dans les paramètres utilisateur de l'application. Les mots de passe de comptes tiers ne peuvent pas être utilisés pour l'authentification.

Recommandation de sélection d'application

Certains appareils peuvent être configurés en utilisant soit l'application Dreamehome, soit Xiaomi Home. Sauf si une connexion locale est strictement nécessaire, il est fortement recommandé d'utiliser l'application Dreamehome au lieu de Xiaomi Home pour les appareils pris en charge :

• Flux de caméra : La fonctionnalité de flux de caméra n'est pas disponible pour les appareils configurés via Xiaomi Home.
• Mises à jour Push : La connexion Dreamehome utilise le Cloud Push pour les mises à jour en temps réel, éliminant ainsi le besoin de requêtes de sondage périodiques.

Préférer l'option Cloud

Lors de l'étape de configuration, une option supplémentaire Préférer Cloud est disponible et est cochée par défaut.

• Lorsque coché (par défaut) : Force toutes les communications via le cloud (si pris en charge par l'appareil). Il s'agit du comportement par défaut car sur les appareils plus récents, Xiaomi a désactivé les capacités d'accès local. De plus, si l'appareil et Home Assistant se trouvent sur des sous-réseaux différents, la communication locale échouera.
• Lorsque décoché (recommandé pour les configurations prises en charge) : L'intégration récupère le jeton requis à partir du cloud mais établit une connexion locale directe avec l'appareil (similaire à la méthode Connexion locale). Cela offre l'avantage de la mise à jour automatique des jetons et des adresses IP tout en maintenant toutes les communications (sauf les données de la carte) locales. Si cette méthode entraîne une erreur "impossible d'atteindre l'appareil" à l'étape finale de la configuration, la configuration doit être réessayée avec l'option Préférer le cloud cochée.

  Exigence de sous-réseau

  Pour des raisons de sécurité, le dispositif ne répond qu'aux requêtes provenant de son propre sous-réseau. Par conséquent, l'aspirateur robot et Home Assistant doivent être sur le même sous-réseau exact pour que la communication locale fonctionne. Consultez cet article python-miio pour résoudre les problèmes liés aux sous-réseaux différents.

Vérification Captcha

Si les serveurs Xiaomi Home signalent la tentative de connexion ou l'adresse IP comme non fiable, une étape de vérification captcha sera requise. Dans ce cas, l'image captcha doit être résolue pour passer à l'étape suivante.

Authentification à deux facteurs (2FA)

En plus d'un captcha, une tentative de connexion non fiable peut également déclencher l'authentification à deux facteurs (2FA). L'intégration demandera automatiquement un code 2FA aux serveurs Xiaomi Home, qui est envoyé au numéro de téléphone enregistré (prioritaire) ou à l'adresse e-mail.

Ce code doit être récupéré et saisi à l'étape de configuration pour compléter la connexion.

Limitations de la 2FA

• Validité du code: Si la fenêtre de configuration est fermée et qu'une nouvelle tentative de connexion est effectuée, un nouveau code 2FA sera généré. Le code le plus récemment reçu doit toujours être utilisé.
• Limitation du débit: Xiaomi limite strictement le nombre de codes 2FA pouvant être demandés par jour. Des tentatives de connexion répétées peuvent entraîner un blocage temporaire.

Mises à jour périodiques de l'état

Contrairement à d'autres méthodes de connexion cloud qui prennent en charge les notifications push, la connexion Xiaomi Home repose entièrement sur une récupération en arrière-plan pour obtenir le dernier état. Pour optimiser l'utilisation du réseau, l'intervalle de récupération est calculé dynamiquement en fonction du temps écoulé depuis le dernier changement d'état ; les requêtes sont envoyées fréquemment lorsque l'appareil fonctionne activement, mais l'intervalle augmente progressivement à mesure que le temps passe alors que l'appareil reste inactif.

Ré-authentification

L'intégration stocke en toute sécurité un jeton d'authentification après une connexion réussie pour communiquer avec les serveurs cloud. Si ce jeton expire ou est invalidé par le service cloud pour une raison quelconque, Home Assistant déclenchera automatiquement un processus de ré-authentification, demandant à nouveau la saisie des identifiants du compte.