1. Description

1.1. Xiaomi Home, pour les Aquara Home Gateway et lampes Yeeligt

Une présentation complète du plugin est disponible ici : Article de présentation

1.1.1. Xiaomi Aquara Home Gateway

La Xiaomi Aquara Home Gateway permet d’utiliser différents capteurs Zigbee Xiaomi.

Liste des capteurs compatibles :

1.1.2. Yeelight Wifi

Le plugin permet également d’utiliser les ampoules et bandeau RGB Yeelight Wifi de Xiaomi


2. Configuration

2.1. Configuration du plugin

Le plugin comporte une option de configuration :

  • Activer un cron pour les Yeelight : permet de s’assurer qu’elles restent réveillées (pas nécessaire pour tous les utilisateurs, mais chez certains elles se mettent en veille après quelques minutes)

Il y a un service qui une fois démarré récupère les informations des Aquara Gateway et également les annonces de présence des Yeelight

2.1.1. Configuration de la gateway Aquara

Une présentation complète de la gamme est disponible ici : Article de présentation

Il est par contre nécessaire de paramétrer la gateway en mode développeur

Pour cela, il faut ajouter la Gateway dans l’application Mi Home et être en China Mainland et Chinese (oui du coup des écrans peuvent contenir beaucoup de caractères illisibles à moins de maitriser le mandarin)

Ensuite cliquer dessus pour la sélectionner, là cliquer sur les "…​" et enfin "about"

Là vous avez un numéro de version, cliquez dessus de facon répéter jusqu’à un message (oui en chinois ca aide pas :)) et 2 nouvelles options apparaissent

Choisissez la première option (nouvellement apparue) et activer le bouton switch pour qu’il passe en vert, voilà le mode local est actif et votre gateway est accessible du réseau

Information importante : pour pouvoir envoyer des commandes (prise) vers la gateway, vous devez renseigner son mot de passe sur la page équipement. Ce mot de passe est visible sur la page où l’on active le mode développeur

2.1.2. Equipements compatibles

  • Gateway : anneau RGB (avec couleur et intensité, pour éteindre il faut absolument mettre l’intensité à 0), capteur de luminosité, jouer les sons enregistrés (0 à 8, 10 à 13, 20+ correspondent aux sons par défaut dans Mihome, 10000 pour éteindre, 10001 et plus pour les sons personnalisés) Présentation

  • Détecteur de mouvement : commande statut de type binaire activée sur mouvement, batterie et voltage

  • Détecteur d’ouverture : commande statut de type binaire activée sur ouverture, batterie et voltage

  • Capteur température/humidité : commande température, commande humidité, batterie et voltage

  • Bouton Switch : commande statut avec pour valeurs click, double_click, long_click_press, long_click_release, batterie et voltage

  • Prise : commande statut binaire avec on et off, état d’utilisation et consommation

  • Interrupteur mural : commande statut pour chaque interrupteur (click, double_click) et si double une commande qui donne l’appui simultané, batterie et voltage

  • Interrupteur encastré : commande statut binaire avec on et off pour chaque interrupteur

  • Cube : commande statut avec pour valeur move, tap_twice, shake_air, alert, flip90, flip180, free_fall et une commande rotate avec la valeur en degré du mouvement, batterie et voltage Présentation

2.1.3. Configuration des lampes Yeelight

Une présentation complète de la gamme est disponible ici : Article de présentation

Dans l’application Yeelight vous devez activer l’option développeur également

C’est un switch a activé dans les options de chaque ampoule/bandeau

2.2. Création des équipements

Les équipements Aquara et Yeelight sont créés automatiquement

Pour les capteurs Aquara, c’est à leur remontée d’information et heartbeat donc très régulièrement.

Pour les interrupteurs et boutons Aquara, il peut être nécessaire de les activer pour avoir la création des commandes (un clic par exemple)

Pour les Yeelight, elles sont reconnues par le plugin quand elles s’annoncent, elles font une annonce par heure et quand elles sont branchées/allumées

2.2.1. Commande enchainement des Yeelight

Pour les Yeelight, une commande spéciale est créée qui a vocation à être utilisée en scénario seulement car on doit envoyer un contenu précis à la commande.

C’est une commande message qui doit avoir par exemple :

3 recover rgb,255,0,0,500,100-wait,400-rgb,255,255,0,500,100

  • 3 : c’est un chiffre représentant le nombre de fois que la suite d’effets doit être appliquée avant de s’arrêter (0 veut dire illimité)

  • recover : une des 3 options possible (recover = retour à l’état avant effet, off = s’eteint ensuite, stay = reste au statut de fin de boucle)

  • le troisième élément est la suite des états avec leur transition, il y en a 4 possible (attention à bien ne pas mettre d’espaces)

  • hsv : pramètres (hue,saturation,duration=300,brightness=100)

  • rgb : pramètres (red,green,blue,duration=300,brightness=100)

  • temp : pramètres (degrees,duration=300,brightness=100)

  • wait(duration=300)

    Il faut bien entrer l'enchainement avec des - entre chaque effet. Et pour un enchainement il doit y avoir son nom et tous les paramètres séparés par des virgules

3. FAQ

Quel type de gateway Xiaomi est supporté ?

La "Aquara" pour le Zigbee qu’il faut bien paramétrer en mode développeur pour y accéder localement, pour cela il faut un firmware au moins en 1.4

Je n’arrive pas à passer ma gateway Aquara en mode local ?

Sur iOS il semble que ce soit assez capricieux, vous pouvez utiliser un Android en VM

Il faut également bien utilisé Mi Home en anglais et sur China Mainland si on rencontre des problèmes d’inclusion

Une information de mes capteurs ne remonte pas ?

Si vous n’avez pas de commande équivalente créée dans Jeedom, c’est que l’API n’expose pas cette information. Il faut attendre peut être une mise à jour du firmware (exemple les piles ou la charge de la prise)

Combien de capteurs au maximum sur une Gateway Aquara ?

Les remontées utilisateurs indiquent 31 capteurs + la Gateway. Au delà il faut supprimer l’appairage d’un capteur pour en remettre un. Le plugin supporte plusieurs gateways.

Quelles ampoules sont supportées ?

Les Yeelight Wifi uniquement

Certaines Yeelight ne remontent pas ?

Les Yeelight Wifi doivent toutes être paramétrées avec le mode développeur pour être joignable sur le réseau local. Pour ceci, il vous faut installer l’application Yeelight (et non pas seulement Mi Home), renseigner votre login /mot de passe, aller dans chaque équipement, accéder aux settings via les ' …​ ' et activer le 'Developer Mode'. Note : Il n’est pas nécessaire de changer la langue de l’application.