Tutoriel Home Assistant : Intégrer la domotique Xiaomi facilement !

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 :

Avertissement. Le kit Xiaomi Smart Home avec prise chinoise est destiné au marché chinois. Les appareils ne sont pas certifiés CE ou FCC. Vous êtes responsable de l’utilisation des appareils Xiaomi. Le site LesAlexiens.fr ne pourra pas être tenu pour responsable en cas d’accident, blessure ou détérioration de matériel. De plus, les serveurs chinois ne sont pas en conformité avec le RGPD.
La passerelle Mijia Europe (DGNWG05LM) ne fonctionne pas sur Home Assistant actuellement.

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 :

  1. Installez l’application Xiaomi Home sur votre appareil Android (si cela n’est pas déjà fait)
  2. Définissez votre région sur Chine continentale (Paramètres > Paramètres régionaux)
  3. Connectez-vous à votre compte Xiaomi depuis l’application
  4. Sélectionnez votre passerelle puis cliquez sur les 3 points en haut à droite de l’écran
  5. Cliquez plusieurs fois sur le numéro de version en bas de l’écran
  6. Deux options supplémentaires sont maintenant accessibles (Si ce n’est pas le cas, essayez à nouveau toutes les étapes)
  7. Choisissez la première nouvelle option puis cliquez sur le premier bouton afin d’activer le mode local
  8. Notez le mot de passe (Celui-ci sera indispensable lors de l’intégration)
  9. Assurez-vous d’appuyer sur le bouton OK pour enregistrer vos modifications
  10. Choisissez la seconde option apparue et notez l’adresse IP qui apparait après  »local IP »
  11. Rendez cette IP fixe dans votre box internet / routeur (cf. partie « Adresse IP fixe » du tutoriel DuckDNS)

Plusieurs passerelles en votre possession ? Répétez les opérations ci-dessus pour chaque passerelle. 🙂

Depuis un appareil iOS :

  1. Installez l’application Xiaomi Home sur votre appareil iOS (si cela n’est pas déjà fait)
  2. Définissez votre région sur Chine continentale (Paramètres > Paramètres régionaux)
  3. Connectez-vous à votre compte Xiaomi depuis l’application
  4. Sélectionnez votre passerelle puis cliquez sur les 3 points en haut à droite de l’écran
  5. Cliquez plusieurs fois sous le menu A propos dans la partie vierge
  6. Trois options supplémentaires sont maintenant accessibles (Si ce n’est pas le cas, essayez à nouveau toutes les étapes)
  7. Choisissez la deuxième nouvelle option puis cliquez sur le premier bouton afin d’activer le mode local
  8. Notez le mot de passe (Celui-ci sera indispensable lors de l’intégration)
  9. Assurez-vous d’appuyer sur le bouton OK pour enregistrer vos modifications
  10. Choisissez la troisième option apparue et notez l’adresse IP qui apparait après  »local IP »
  11. Rendez cette IP fixe dans votre box internet / routeur (cf. partie « Adresse IP fixe » du tutoriel DuckDNS)
Plusieurs passerelles en votre possession ? Répétez les opérations ci-dessus pour chaque passerelle. 🙂

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 :

Home Assistant configuration.yaml xiaomi gateway
Home Assistant configuration.yaml – Xiaomi gateway
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 :

Home Assistant configuration.yaml multiple xiaomi gateway
Home Assistant configuration.yaml multiple xiaomi gateway
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.

Cet exemple fonctionne uniquement avec le bouton rond de la 1ère génération.

Intégration des passerelles Xiaomi / Aqara compatible Homekit

Passerelles compatibles :

Ajout de votre passerelle dans Home Assistant

Lors de l’installation de votre serveur Home Assistant, celui-ci a certainement détecté votre hub / passerelle (gateway) via HomeKit. Il suffit alors de cliquer sur « configurer » pour ajouter automatiquement votre passerelle à Home Assistant.
Votre passerelle n’est pas apparue automatiquement ? Pas d’inquiétude nous allons procéder à son intégration. 🙂

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 » :

configurer une intégration home assistant
configurer une intégration home assistant

Il vous suffira ensuite de sélectionner « Accessoire HomeKit« . Home Assistant commencera à scanner votre wifi afin de détecter votre passerelle.

homekit qr code

Le fameux code HomeKit vous sera demandé. Celui-ci ce situe sur la boite ou directement sous la passerelle.

N’oubliez pas de mettre les tirets comme l’exemple ci-dessus.

Voilà! Votre passerelle ainsi que tous ses appareils appairés sont disponibles depuis votre instance Home Assistant. N’hésitez pas à redémarrer votre serveur si vos appareils Xiaomi n’apparaissent pas.

 

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.

 

Félicitations! Vous pouvez dorénavant créer des automatisations avec vos appareils Xiaomi et Aqara ! 🙂

 

Plusieurs plumes de passionnés d'Alexa pour vous concocter des articles à 4 mains ou plus... Une écriture collaborative pour aborder les sujets les plus pointus ou transversaux, les meilleurs bons plans domotique et maison connectée du web, et bien plus encore...