Aujourd’hui, nous allons ajouter à notre serveur Home Assistant une intégration incontournable, le kit Xiaomi smart home. Ce kit est certainement le premier objet obtenu par la plupart d’entre nous souhaitant commencer dans la maison connectée. Ce petit kit regroupant de nombreux capteurs miniatures et visuellement sympathique sera encore plus intéressant une fois son intégration ajoutée à notre instance Home Assistant.
Comme nous l’avons vu précédemment, il sera donc possible de faire remonter les capteurs dans l’application Alexa afin de les intégrer à nos routines. Complexifier vos routines ? Aucun soucis, il faudra créer le scénario depuis Home Assistant. Une chose est sûre, tout est possible !
Choisissez l’intégration selon la passerelle que vous possédez :
- Installation des passerelles Xiaomi chinoises et non compatibles HomeKit
- Installation des passerelles Aqara compatibles HomeKit
Intégration des passerelles Xiaomi
Passerelles compatibles :
Mode local (« développeur ») et récupération du jeton d’utilisation
Pour utiliser cette intégration, nous avons besoin d’activer le mode LAN ainsi que récupérer la clef pour l’ajout de votre clef à Home Assistant.
Depuis un appareil Android :
- Installez l’application Xiaomi Home sur votre appareil Android (si cela n’est pas déjà fait)
- Définissez votre région sur Chine continentale (Paramètres > Paramètres régionaux)
- Connectez-vous à votre compte Xiaomi depuis l’application
- Sélectionnez votre passerelle puis cliquez sur les 3 points en haut à droite de l’écran
- Cliquez plusieurs fois sur le numéro de version en bas de l’écran
- Deux options supplémentaires sont maintenant accessibles (Si ce n’est pas le cas, essayez à nouveau toutes les étapes)
- Choisissez la première nouvelle option puis cliquez sur le premier bouton afin d’activer le mode local
- Notez le mot de passe (Celui-ci sera indispensable lors de l’intégration)
- Assurez-vous d’appuyer sur le bouton OK pour enregistrer vos modifications
- Choisissez la seconde option apparue et notez l’adresse IP qui apparait après »local IP »
- Rendez cette IP fixe dans votre box internet / routeur (cf. partie « Adresse IP fixe » du tutoriel DuckDNS)
Depuis un appareil iOS :
- Installez l’application Xiaomi Home sur votre appareil iOS (si cela n’est pas déjà fait)
- Définissez votre région sur Chine continentale (Paramètres > Paramètres régionaux)
- Connectez-vous à votre compte Xiaomi depuis l’application
- Sélectionnez votre passerelle puis cliquez sur les 3 points en haut à droite de l’écran
- Cliquez plusieurs fois sous le menu A propos dans la partie vierge
- Trois options supplémentaires sont maintenant accessibles (Si ce n’est pas le cas, essayez à nouveau toutes les étapes)
- Choisissez la deuxième nouvelle option puis cliquez sur le premier bouton afin d’activer le mode local
- Notez le mot de passe (Celui-ci sera indispensable lors de l’intégration)
- Assurez-vous d’appuyer sur le bouton OK pour enregistrer vos modifications
- Choisissez la troisième option apparue et notez l’adresse IP qui apparait après »local IP »
- Rendez cette IP fixe dans votre box internet / routeur (cf. partie « Adresse IP fixe » du tutoriel DuckDNS)
Ajout de votre passerelle dans Home Assistant
Avant de poursuivre veuillez vérifier que vous avez bien réussi les trois étapes suivantes :
- Activé le mode local/LAN depuis l’application Xiaomi Home
- Copié le mot de passe (key) de votre passerelle depuis l’application Xiaomi Home
- Fixer l’adresse IP de votre passerelle depuis votre routeur ou box internet
Intégration d’une seule passerelle (gateway)
Depuis l’add-on File editor, rendez vous dans le fichier configuration.yaml afin d’y ajouter le code ci-dessous :
xiaomi_aqara:
discovery_retry: 5
gateways:
- key: le_mot_de_passe_de_votre_passerelle
Intégration de plusieurs passerelles (multiple gateways)
Si vous avez plusieurs passerelles (non compatible HomeKit), il vous suffira de vous rendre dans le fichier configuration.yaml depuis l’add-on File editor afin d’y ajouter le code ci-dessous :
xiaomi_aqara:
gateways:
- mac: adresse_mac_passerelle_1
key: votre_mot_de_passe_passerelle_1
- mac: adresse_mac_passerelle_2
key: votre_mot_de_passe_passerelle_2
Exemple d’automatisation
Bien que les automatisations sont plus simple depuis l’interface utilisateur (configurations > automations) je vous propose l’exemple sous le format YAML afin de la copier facilement.
- alias: SI appui long ALORS son de chien qui aboie
trigger:
platform: event
event_type: xiaomi_aqara.click
event_data:
entity_id: binary_sensor.mon_bouton_rond
click_type: long_click_press
action:
service: xiaomi_aqara.play_ringtone
data:
gw_mac: adresse_mac_de_la_passerelle_qui_jouera_le_son
ringtone_id: 8
ringtone_vol: 8
- alias: Arreter le son immédiatement lors d'un simple appui
trigger:
platform: event
event_type: xiaomi_aqara.click
event_data:
entity_id: binary_sensor.mon_bouton_rond
click_type: single
action:
service: xiaomi_aqara.stop_ringtone
data:
gw_mac: adresse_mac_de_la_passerelle_qui_jouera_le_son
Ce scénario n’a pas pour but d’être intégré, celui-ci montre plusieurs services comme jouer un son depuis la passerelle, utiliser un bouton appairé à celle-ci..
En effet, cet exemple joue le son d’un chien qui aboie lorsque le bouton est maintenu enfoncé et arrête le son lors d’un simple appui sur le bouton.
Intégration des passerelles Xiaomi / Aqara compatible Homekit
Passerelles compatibles :
Ajout de votre passerelle dans Home Assistant
Intégration via accessoire HomeKit
Pour l’intégrer, rien de plus simple, il vous suffit de vous rendre sur l’onglet « Configuration » puis sélectionnez « Intégrations » :
Il vous suffira ensuite de sélectionner « Accessoire HomeKit« . Home Assistant commencera à scanner votre wifi afin de détecter votre passerelle.
Le fameux code HomeKit vous sera demandé. Celui-ci ce situe sur la boite ou directement sous la passerelle.
Appareils Xiaomi disponibles dans Home Assistant
L’un des avantages de cette intégration via HomeKit est que celle-ci crée automatiquement le système d’alarme afin d’armer et de désarmer la sécurité de votre logement.
Vous pouvez également vérifier depuis la page « Configuration » dans l’onglet « Appareils » la liste de vos appareils dont les Xiaomi fraichement installés.
Suivez-nous sur Google Actualités
