Installer Zigbee2Mqtt sur Home Assistant

home assistant installer zigbee2mqtt

Aujourd’hui nous vous proposons un incontournable de la domotique DIY (Do It Yourself) : Zigbee2Mqtt ! Comme vous le savez, le protocole ZigBee est de plus en plus utilisé notamment grâce à son maillage et sa faible consommation, il est donc idéal pour nos maisons connectés. En tant normal, notre coordinateur zigbee (conbee2, CC2531 ou gateway Xiaomi par exemple) utilisent le protocole zigbee pour communiquer avec les différents appareils de notre réseau maillé puis remonte toutes les informations à notre serveur Home Assistant à l’aide de requête HTTP.

L’Hypertext Transfer Protocol (Ou plus simplement HTTP) est un protocole de communication client-serveur développé pour le World Wide Web. Pour faire simple, le protocole HTTP permet à votre navigateur web (google chrome, safari, mozilla firefox) de communiquer avec les différents serveurs sur Internet. Cela fonctionne très bien et c’est grâce à ce fabuleux protocole que vous pouvez lire cet article actuellement, mais ce n’est pas forcément le plus adapté pour le monde de l’IoT et de la domotique. En effet, la smart home (domotique en français) est l’ajout de la technologie au sein de votre domicile. Automatiser votre logement apporte du confort, de la sécurité mais également des économies d’énergie si celle-ci est bien utilisée.

Le zigbee est donc parfait pour notre maison connectée cependant le protocole HTTP est beaucoup moins adapté car plus énergivore… C’est pour cela, qu’un  nouveau protocole rentre en jeu afin de le remplacer… MQTT ! Nous ne parlerons pas en détail du protocole MQTT dans cet article mais dans notre contexte de logement intelligent, il est bien plus adapté. Rapide, léger, peu énergivore et compatible avec énormément d’objets connectés, il est un atout non négligeable pour système domotique de qualité. Passons sans plus attendre à Zigbee2Mqtt, l’outil parfait pour allier Zigbee et MQTT ! 

 

4,18€
in stock
Aliexpress.com
6,58€
6,93
in stock
Aliexpress.com
16,47€
in stock
Aliexpress.com

Zigbee2MQTT c’est quoi ?

Zigbee2Mqtt est un serveur passerelle permettant de réceptionner les informations de votre réseau zigbee à l’aide de votre coordinateur zigbee afin de les envoyer vers votre broker MQTT sous forme de topics. Home Assistant se connectera au broker en tant que client « lecteur » pour consulter les différents topics de votre maillage zigbee.

zigbee-to-mqtt

Vous êtes actuellement sur Jeedom avec Zibgee2Mqtt et vous souhaitez tester Home Assistant ? Connectez votre serveur Home Assistant fraichement installé à votre broker MQTT il réceptionnera les informations en parallèle de votre Jeedom !

En quelques mots : Zigbee2MQTT transforme les informations de votre réseau zigbee en topics MQTT pour les rendre disponibles avec de nombreux serveurs domotique !

Zigbee2MQTT : Pré-requis

Pour fonctionner Zigbee2Mqtt a besoin d’un coordinateur zigbee ainsi que d’un broker MQTT.

Dans notre cas, nous allons utiliser l’add-on Mosquitto Broker disponible sur Home Assistant mais rien ne vous empêche de déporter votre broker MQTT sur un serveur différent.

Pour ce qui est du coordinateur Zigbee, plusieurs choix s’offrent à vous :

Aucune des deux clés semble vous convenir ? Retrouvez la liste des coordinateurs compatibla avec Zigbee2MQTT.

Conseil : Lorsque votre coordinateur est branchée directement sur votre serveur domotique, l’antenne souffre des interférences des signaux radio et des composants électriques du serveur. Veillez également à ne pas placer le coordinateur trop près de tout autre appareil de transmission radio (par exemple un routeur Wi-Fi). Une rallonge USB de 50 cm suffit déjà pour réduire les interférences.

22,15€
23,90
in stock
2 new from 22,15€
Amazon.fr
Free shipping
40,28€
in stock
1 new from 40,28€
Amazon.fr
Free shipping
Last updated on 16 mai 2021 8h54

Home Assistant : Add-on Mosquitto broker

Installer le serveur MQTT : Mosquitto Broker

Avant d’installer Zigbee2MQTT nous devons installer un broker MQTT (Vous avez déjà un broker MQTT ? Rendez-vous à l’étape suivante).

Notre serveur MQTT sera la source vers la quelle l’outil Zigbee2Mqtt va envoyer les différents topics contenant les informations des appareils zigbee. Pour l’installer c’est très simple, rendez-vous dans le Supervisor puis dans la boutique des modules complémentaires (add-on store). Sélectionnez Mosquitto broker :

Open your Home Assistant instance and show the dashboard of a Supervisor add-on.

 

add-on-home-assistant-mqtt-mosquitto

Cliquez sur Installer puis patientez quelques secondes :

add-on-home-assistant-mqtt-mosquitto-installation

Votre add-on est maintenant installé, pour le lancer cliquez sur Démarrer :

add-on-home-assistant-mqtt-mosquitto-broker

Votre serveur MQTT est maintenant installé et démarré ! Nous allons maintenant le configurer… en quelques secondes ! 😎

Configurer le serveur MQTT : Mosquitto broker

Pour configurer votre serveur MQTT c’est encore plus simple que de l’installer (Oui oui.. la simplicité est au rendez-vous !)

Accédez à l’onglet Configuration, normalement Home Assistant a détecté automatiquement votre broker MQTT. Il vous suffit donc d’appuyer sur le bouton Configurer :

Open your Home Assistant instance and show your configuration panel.

add-on-home-assistant-mqtt-configuration-broker

Une fenêtre comme ci-dessous devrait apparaitre :

add-on-home-assistant-mqtt-configuration-broker-mosquitto

Nous vous conseillons de cocher « Activer la découverte« , cela permettra à votre serveur MQTT de découvrir tous les objets connectés utilisant le MQTT. Pour finaliser la configuration il vous suffit d’appuyer sur Soumettre. Félicitations, votre serveur MQTT est opérationnel !

tutoriel-home-assistant-termine



Home Assistant : Add-on Zigbee2MQTT

Notre broker MQTT est maintenant opérationnel et nous avons en notre possession un coordinateur zigbee sous forme de clé USB, nous pouvons donc passer à l’installation de Zigbee2Mqtt.

Votre passerelle ZigBee ne doit pas être branchée pour le moment !

Installer Zigbee2Mqtt

Pour installer Zigbee2Mqtt vous pouvez utiliser le bouton My Home Assistant : Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

Si le bouton d’intégration ne fonctionne pas, rendez-vous dans le Supervisor puis dans la boutique des modules complémentaires (add-on store) puis cliquez sur les 3 points situés en haut à droite. Sélectionnez dépôts, une fenêtre comme ci-dessous devrait apparaitre :

Ajoutez le lien de l’add-on Zigbee2MQTT pour Home Assistant : https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

ajouter-zigbee2mqtt-home-assistant

Deux nouveaux add-ons devraient apparaitre entre les add-ons officiels et les add-ons de la communauté :

  • Zigbee2Mqtt
  • Zigbee2Mqtt Edge

Zigbee2Mqtt Edge est une version destinée aux développeurs, dans notre cas nous utiliserons la version stable. Cliquez sur l’add-on Zigbee2Mqtt afin de l’installer.

installer-zigbee2mqtt-home-assistant

Comme précédemment avec Mosquitto Broker, il vous suffit de cliquer sur le boutton Installer puis patienter quelques secondes :

configurer-zigbee2mqtt-home-assistant

Zigbee2Mqtt est installé, nous allons maintenant le configurer.

Configurer Zigbee2Mqtt

Vous pouvez relier votre clé zigbee à sa rallonge puis brancher la rallonge USB à votre serveur Home Assistant (Home Assistant Blue, Raspberry Pi, Nuc..)

Si vous utilisez une clé Conbee II ou une ZiGate USB-TTL, veuillez définir les paramètres suivants dans l’onglet configuration de l’add-on Zigbee2mqtt :

serial:
  adapter: deconz # "deconz" pour conbee2 OU "zigate" pour la ZiGate USB-TTL

Une fois le branchement effectué et la configuration ajoutée si nécessaire, vous pouvez démarrer l’addon :

demarrer-zigbee2mqtt-home-assistant

Patientez quelques minutes.. Si l’add-on est correctement configuré et démarré vous devriez voir apparaitre le bouton « Ouvrir l’interface utilisateur web« .

Voici l’interface de Zigbee2MQTT :

interface-zigbee2mqtt-home-assistant

Sur notre exemple la page est vierge car aucun appareil a était couplé, par la suite vos différents appareils zigbee couplés apparaitront sous forme de liste.

Un second onglet nommé « Map » est intéressant. En effet, vous pouvez visualiser votre maillage zigbee :

map-zigbee2mqtt-home-assistant

Dans notre cas, nous avons uniquement une étoile indiquant notre coordinateur mais après le couplage d’un appareil zigbee, celui-ci apparaitra et un trait indiquera si votre appareil est lié directement à votre coordinateur ou à un appareil de type Routeur.

Voici le code couleur :

  • Une étoile bleu : Le coordinateur zigbee (CC2531, Conbee2..)
  • Cercle vert : Appareil de type EndDevice
  • Cercle bleu : Appareil de type Router (Ils permettent de faire la liaison entre votre coordinateur et des appareils endDevice éloignés)

Zigbee2mqtt : Appairage d’un appareil

Pour appairer un appareil, activez la découverte en appuyant sur le bouton Permit Join.

Pendant 255 secondes l’appairage sera alors possible, appuyez sur le bouton de votre appareil zigbee (ou à l’aide d’un tronbonne sur certains appareils) pour lancer l’appairage celui-ci. Une notification verte devrait lorsque l’appareil sera ajouté. Il sera également visible dans la liste sur l’onglet « Devices« .

permit-join-zigbee2mqtt-home-assistant

Voici un exemple :

zigbee2mqtt-homeassistant

Notre serveur Zigbee2MQTT est maintenant opérationnel, il communique avec notre broker MQTT qui lui même transmet de façon fiable et rapide les informations à votre (ou vos plusieurs) serveur domotique Home Assistant ! 😀

tutoriel-home-assistant-termine

 

Besoin d’aide ?

N’hésitez pas à laisser un commentaire ou rejoignez nous sur le groupe facebook Home Assistant Francophone, l’équipe ainsi que la communauté vous aideront avec plaisir !



2 Commentaires

  • Merci pour ce tuto !
    Je l’ai suivi mais malheureusement cela ne fonctionne. J’ai une clé Conbee II et j’ai rajouté dans configuration.yaml
    serial:
    adapter: deconz

    Mais après redémarrage HA, le setup n’est pas pris et j’ai cette erreur : Setup failed for serial: No setup or config entry setup function defined.

    Et autrement, Zibee2mqtt ne marche pas. J’ai les erreurs suivantes :
    Zigbee2MQTT:error 2021-05-14 13:39:46: Error while starting zigbee-herdsman
    Zigbee2MQTT:error 2021-05-14 13:39:47: Failed to start zigbee
    Zigbee2MQTT:error 2021-05-14 13:39:47: Check https://www.zigbee2mqtt.io/information/FAQ.html#help-zigbee2mqtt-fails-to-start for possible solutions
    Zigbee2MQTT:error 2021-05-14 13:39:47: Exiting…
    Zigbee2MQTT:error 2021-05-14 13:39:47: Error: Failed to connect to the adapter (Error: SRSP – SYS – ping after 6000ms)

    J’ai vérifié le port, qui a bien été correctement mis dans la config de l’addon. J’ai essayé de rajouter un user spécifiique pour mqtt, mais rien n’y fait.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Suggestions