Intégration externe - Xiaomi MIoT (purificateurs, humidificateurs, prises…)

Salut tout le monde ! :waving_hand:

Les aspirateurs Xiaomi ont déjà leurs intégrations (Xiaomi Home de @callemand, Roborock, Dreame). Mais il restait tout le reste de l’écosystème Mi Home : purificateurs, humidificateurs, ventilateurs, prises, lampes… Voici Xiaomi MIoT, qui les pilote en local.

Ce que ça fait

  • Pas de liste de modèles codée à la main : l’intégration lit la spécification publique de chaque modèle (miot-spec.org) et traduit ce qu’elle trouve en appareils Gladys :
    • purificateurs d’air : marche/arrêt, mode, vitesse, PM2.5, filtre restant, verrouillage enfant ;
    • humidificateurs et déshumidificateurs : humidité, consigne, réservoir ;
    • ventilateurs : vitesse, oscillation ;
    • prises (avec la consommation quand elle est mesurée) ;
    • lampes : luminosité, température de couleur, couleur ;
    • capteurs d’environnement : température, humidité, PM2.5, PM10, CO2, luminosité.
    • Les radiateurs sont affichés, mais jamais pilotés : je préfère ne rien chauffer à distance.
  • Un déclencheur « entretien nécessaire » : filtre à 10 % ou moins, réservoir vide, défaut.
  • Une action de scène pour régler n’importe quelle propriété d’un appareil, pour les cas avancés.
  • Un widget « Qualité de l’air » : PM2.5, humidité, filtre et boutons marche/mode.
  • En français, anglais, allemand et espagnol.

Le truc sympa

PM2.5 au-dessus de 35 → le purificateur passe en mode max
Réservoir de l’humidificateur vide → notification
Je pars de la maison → toutes les prises Xiaomi coupées

Installation

:warning: Gladys 5.1 minimum.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-xiaomi-miot: Xiaomi MIoT / Mi Home purifiers, humidifiers, fans, plugs and lights for Gladys Assistant, local miIO protocol · GitHub

  1. Importez vos appareils depuis votre compte Xiaomi (e-mail, mot de passe, région du compte ; la vérification en deux étapes est gérée). Le compte ne sert qu’à récupérer les « jetons » des appareils, une seule fois : ensuite, tout se passe en local.
  2. Ou ajoutez un appareil à la main, avec son adresse IP et son jeton.
  3. Onglet Découverte : ajoutez-les.

Petites réserves honnêtes

  • Développée sans le matériel : tout a été testé sur les vraies spécifications de 14 modèles, et j’ai vérifié que la connexion au compte Xiaomi va bien jusqu’au serveur réel, mais rien n’a tourné sur un vrai purificateur. Vos retours sont les bienvenus :folded_hands:
  • Les aspirateurs, et les appareils Bluetooth ou Zigbee qui passent par une passerelle Xiaomi, ne sont pas gérés ici.

Elle s’appuie sur le travail de hass-xiaomi-miot (Apache 2.0) : merci à al-one ! Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à Xiaomi.

Dépôt : GitHub - guim31/gladys-xiaomi-miot: Xiaomi MIoT / Mi Home purifiers, humidifiers, fans, plugs and lights for Gladys Assistant, local miIO protocol · GitHub