Après vous avoir montré plusieurs solutions pour installer MQTT sur une box domotique, il est grand temps de faire communiquer notre broker Mosquitto avec un autre incontournable de la domotique : le protocole ZigBee. Pour ce faire, nous allons tout simplement installer Zigbee2MQTT sur Home Assistant.
Mise à jour 17/01/2023 : Installation avec Home Assistant 2023.1.2
[toc]Zigbee2MQTT, c’est quoi ?
Si vous vous intéressez à la domotique DIY, vous avez forcément entendu parler du protocole ZigBee. Il faut dire qu’avec son maillage réseau et sa faible consommation, il a tout pour plaire. En temps normal, un coordinateur ZigBee (passerelle, hub, dongle…) remonte les informations de son réseau à l’aide de requêtes HTTP, mais même si cela fonctionne parfaitement, ce n’est pas pour autant la méthode la plus efficace.
C’est là qu’intervient le protocole MQTT. En effet, MQTT est un protocole beaucoup plus léger que HTTP, qui ne nécessite pas d’interroger un serveur et demande beaucoup moins de données. Il permet donc des échanges plus rapides et moins gourmands. Concrètement, il est 90 fois plus rapide que le protocole HTTP, nécessite 10 fois moins d’énergie pour envoyer des messages et même jusqu’à 170 fois moins pour en recevoir.
D’où l’idée d’allier ZigBee et MQTT. Pour ce faire, nous avons Zigbee2MQTT, une passerelle capable de réceptionner les informations de notre coordinateur ZigBee et de les envoyer vers notre broker MQTT sous forme de topics. Cela permet à différents clients comme Home Assistant, Homey, Jeedom ou Domoticz de s’abonner à ces topics et de les lire.
Pré-requis pour Zigbee2MQTT
Pour fonctionner, Zigbee2MQTT va nécessiter un coordinateur ZigBee et un broker MQTT.
- Un broker MQTT : nous avons choisi le broker Mosquitto MQTT car il nous a toujours donné pleine satisfaction, mais il en existe bien d’autres. S’agissant probablement du plus utilisé en domotique, nous ne saurions que vous conseiller de faire de même, d’autant qu’il est open source et donc gratuit.
- Un coordinateur ZigBee : nous allons utiliser le dernier dongle Sonoff ZigBee 3.0, car en plus d’être proposé à un prix défiant toute concurrence, il s’avère être particulièrement efficace avec son boitier en alliage d’aluminium réduisant les interférences et son antenne à haut gain de 20 dBm. Néanmoins, vous pouvez tout à fait vous tourner vers la très connue Phoscon Conbee 2 (très appréciée car plug & play), la fameuse ZiGate USB-TTL (sa compatibilité est encore considérée comme expérimentale à ce jour) ou encore vers des dongles CC2531 ou CC2652 (moins chers, mais il vous faudra parfois les flasher). Vous retrouverez la liste complète des coordinateurs compatibles Zigbee2MQTT ici.
Installer Mosquitto MQTT sur Home Assistant (2023)
Configurer un broker
Avant de procéder à l’installation de Zigbee2MQTT, votre broker MQTT doit être opérationnel. Sous Home Assistant 2023.1.2 (version OS 9.4), rien de plus simple, il existe un module complémentaire officiel.
Rendez-vous dans :
Paramètres > Modules complémentaires > Boutique des modules complémentaires > MQTT
Méthodes alternatives :
Importer Zigbee2MQTT sur Home Assistant
L’installation de Zigbee2MQTT sur Home Assistant est vraiment simple, il vous suffit de cliquer ici.
Rendez-vous dans :
Paramètres > Modules complémentaires > Boutique des modules complémentaires
Ensuite, cliquez sur les trois points en haut à droite puis sélectionnez « Dépôts » et entrez l’adresse suivante :
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Installer Zigbee2MQTT sur Home Assistant
Deux nouveaux add-ons sont apparus dans nos modules complémentaires, mais Zigbee2MQTT Edge étant une version à destination des développeurs, nous nous contenterons du premier.
- Sélectionner Zigbee2mqtt ;
- Cliquez sur « Installer »;
- Patientez quelques secondes.
Configurer Zigbee2MQTT sur Home Assistant 2023
Il est temps de brancher votre dongle ZigBee sur un port USB de votre Raspberry pi, Odroid, NUC ou NAS. En ce qui nous concerne, nous allons utiliser le Sonoff ZBDongle-P que nous vous recommandons vivement, mais vous pouvez utiliser un dongle CC2531 ou CC2652, une clé Conbee II, une ZiGate USB-TTL, etc. L’avantage du dongle Sonoff ZigBee 3.0 est d’être pré-flashé avec le bon firmware et muni d’une antenne 20 dBm. Il est par ailleurs très stable et peu sensible aux interférences.
Voici notre configuration :
homeassistant: false permit_join: true mqtt: base_topic: zigbee2mqtt server: 'mqtt://xxxxxxx' user: xxx password: xxxxxxx serial: port: /dev/ttyUSB0
Pour une clé ConBee II ou RaspBee II, vous pouvez ajouter :
serial: adapter: deconz
Et pour Zigate :
serial: adapter: zigate
Ceci fait, il ne nous reste plus qu’à :
- Cliquer sur Démarrer Zigbee2MQTT ;
- Aller sur « Ouvrir l’interface utilisateur web ».
Patientez un peu, il se peut que le bouton de l’interface utilisateur de Zigbee2MQTT mette quelques minutes à arriver, mais si tout va bien vous devriez avoir quelque chose qui ressemble à ça :
Évidemment, c’est encore vide. Voyons si tout fonctionne bien en ajoutant quelques objets connectés…
Appairage Zigbee2MQTT sur Home Assistant
Pour appairer un appareil, rien de plus simple, il vous suffit de cliquer sur le bouton « Activer l’appairage (Tout) » en haut à droite.
Vous avez maintenant 2 minutes 15 secondes précisément pour mettre votre appareil en mode appairage. En général, il suffit de maintenir un petit bouton pendant 5 secondes ou d’appuyer dans un petit trou à l’aide d’une aiguille. L’association se fait alors très vite et vous verrez une ou plusieurs notifications vertes apparaître à droite de votre écran.
Enfin, nous retrouvons nos appareils, ici le tout nouveau Aqara Motion Sensor P1 :
Nous vous laissons découvrir tous les réglages possibles pour chaque appareil, mais vous verrez qu’ils sont souvent bien plus nombreux qu’avec les hubs propriétaires.
Enfin, vous pouvez visualiser le maillage de votre réseau ZigBee dans « Schéma » ou « Map » si vous êtes sur une version en anglais.
Ici, nous n’avons pour l’instant installer que trois appareils et un coordinateur, mais vous retrouverez :
- Étoile bleue : les coordinateurs ou ZigBee Coordinators (ZC) qui gèrent le réseau ;
- Cercle bleu : les routeurs ou ZigBee Routers (ZR) qui vont pouvoir envoyer et recevoir des informations pour leur compte et pour celui des appareils terminaux ;
- Cercle vert : les terminaux ou ZigBee End Devices (ZED) qui se contentent d’envoyer des informations et de recevoir des commandes.
Suivez-nous sur Google Actualités
