Configuration avec connexion locale Non recommandé

Cette méthode doit être utilisée pour établir une connexion locale directe avec l'aspirateur robot sans dépendre d'une connectivité cloud continue. Pour utiliser cette méthode, l'appareil doit avoir été ajouté avec succès à l'application officielle Xiaomi Home (disponible pour iOS et Android) au moins une fois afin de générer un jeton valide. De plus, il doit rester lié au compte pendant cette étape de configuration afin que l'intégration puisse récupérer l'adresse IP et le jeton requis depuis le cloud.

Compatibilité des appareils

Cette méthode de connexion est exclusivement prise en charge pour les appareils fabriqués avant 2022 et compatibles avec l'application Xiaomi Home. Si un appareil ne peut pas être ajouté à l'application Xiaomi Home, il ne fournira en aucun cas une API locale avec aucun jeton.

Aucune prise en charge des cartes Non recommandé

Il n'est techniquement pas possible de récupérer les données de la carte via l'API locale. Par conséquent, la méthode de connexion locale offre aucun support de carte, ce qui désactive complètement plusieurs fonctionnalités principales qui dépendent des données de la carte telles que Historique nettoyage, Récupération carte, et les Entités de pièce dynamiques. Comme la carte et ses fonctionnalités dépendantes sont centrales pour la fonctionnalité principale de l'intégration, cette méthode de connexion est strictement non recommandée. Pour une expérience complète et pleinement fonctionnelle, il est fortement conseillé d'utiliser plutôt l'une des méthodes de connexion cloud.

Récupération de l'IP et du Jeton

Pour configurer la connexion locale, vous devez fournir manuellement l'adresse IP de l'appareil et son jeton.

Exigence de sous-réseau

Pour des raisons de sécurité, l'appareil 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 exactement le même sous-réseau pour que la communication locale fonctionne. Voir cet article python-miio pour résoudre les problèmes de sous-réseau croisé.

Méthode 1 : Extracteur de Jetons Xiaomi Cloud Recommandé

C'est la méthode la plus fiable. Elle fonctionne sur Windows, macOS ou Linux, se connectant directement aux serveurs cloud de Xiaomi pour récupérer les adresses IP et les jetons de tous les appareils liés au compte simultanément.

1. Télécharger l'Outil : Téléchargez la version appropriée (par exemple, .exe pour Windows) de Xiaomi Cloud Tokens Extractor depuis GitHub.
2. Exécuter l'Application : Exécutez le fichier téléchargé pour ouvrir une interface terminal.
3. Saisir les Identifiants : Fournissez le nom d'utilisateur exact (Email ou ID Xiaomi) et le mot de passe utilisés pour l'application Xiaomi Home.
4. Sélectionner la Région du Serveur : Spécifiez la région du serveur correspondant à l'application Xiaomi Home (par exemple, de pour l'Europe). Si la région est inconnue, laissez l'invite vide et appuyez sur Entrée pour scanner tous les serveurs disponibles.
5. Récupérer le Jeton: L'outil affichera une liste de tous les appareils connectés au compte. Localisez l'aspirateur cible dans la liste et copiez son jeton de 32 caractères correspondant.

Méthode 2 : Application GUI de Bureau (Get_MiHome_devices_token)

Pour les utilisateurs qui préfèrent une interface graphique à un outil en ligne de commande, une application de bureau est disponible.

1. Télécharger l'Application: Téléchargez et installez l'application Get_MiHome_devices_token depuis GitHub.
2. Connexion: Ouvrez l'application, entrez les identifiants du compte Xiaomi et sélectionnez la région du serveur appropriée.
3. Récupérer le Jeton: Une fois authentifié, tous les appareils liés, ainsi que leurs adresses IP et jetons respectifs, seront affichés sous forme de tableau.

Méthode 3 : Application Mi Home Modifiée pour Android Non recommandé

Les utilisateurs Android peuvent utiliser une version modifiée de l'application Mi Home pour visualiser les jetons directement dans l'interface de l'application sur leur appareil mobile.

1. Désinstaller l'application originale: Désinstallez complètement l'application officielle Mi Home de l'appareil Android. (Remarque : Les appareils resteront liés en toute sécurité au compte cloud).
2. Installer l'application modifiée: Recherchez en ligne l'APK modifiée "MiHome by Vevs", téléchargez la dernière version et installez-la sur l'appareil.
3. Connexion: Ouvrez l'application modifiée et connectez-vous en utilisant les identifiants du compte Xiaomi.
4. Récupérer le Token: Sélectionnez l'aspirateur cible pour ouvrir son interface de contrôle. Touchez les trois points dans le coin supérieur droit pour accéder aux paramètres, puis naviguez vers la section Infos réseau ou Paramètres généraux. L'adresse IP et le token de l'appareil seront directement visibles sur cet écran.