Installer Zigbee2MQTT facilement avec Home Assistant

Zigbee2MQTT est une solution open source permettant de gérer vos appareils Zigbee sans avoir besoin des passerelles propriétaires des fabricants, grâce à lui c’est Home Assistant qui fait office de Hub. Pour installer Zigbee2MQTT cet article doit vous aidez, et cette vidéo vous aidera à mieux comprendre les éléments.

Si vous êtes ici c’est que vous avez déjà choisi votre logiciel de gestion pour vos appareils Zigbee, dans le cas contraire, renseigner vous afin de faire le bon choix entre Zigbee Home Automation et Zigbee2MQTT.

De même, si vous êtes en recherche d’une dongle USB Zigbee, je conseille les dongles de SMLIGHT qui sont très polyvalents et qui sont selon moi, la nouvelle référence.

Installer le Broker MQTT

1. Télécharger Mosquitto broker dans les modules complémentaires officiels de Home Assistant.

2. Démarrer le module Mosquitto broker.
3. Dans vos intégrations Home Assistant, ajoutez MQTT qui se trouve dans les découvertes.

C’est dans l’intégration MQTT que vous allez retrouver l’ensemble des appareils zigbee connecter à Zigbee2MQTT.

4. Créer un utilisateur pour l’authentification de Zigbee2MQTT à mosquitto broker.

Pour connecter Zigbee2MQTT au broker MQTT, vous avez besoin d’un utilisateur dédié. Je le nomme sobrement « mqtt » avec un mot de passe, et un accès local uniquement. Si vous n’avez pas l’onglet utilisateurs dans le menu personnes, pensez à activer le mode avancé dans votre profil utilisateur en bas à gauche.

Installer Zigbee2MQTT

1. Ajoutez le dépôt Zigbee2MQTT à Home Assistant

Zigbee2MQTT n’est pas un module officiel et n’est pas présent dans l’interface des modules complémentaires par défaut. Pour cela il faut ajouter le dépôt de Zigbee2MQTT

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Si le dépôt n’apparaît pas directement dans l’interface des modules, n’hésitez pas à redémarrer votre Home Assistant.

2. Installer Zigbee2MQTT

Vous devez installer « Zigbee2MQTT », le premier choix dans la liste. Après l’installation, cochez la case « Afficher dans la barre latérale » afin d’avoir accès à l’interface web Zigbee2MQTT directement depuis Home Assistant.

3. Configurer l’authentification Zigbee2MQTT à Mosquitto Broker

Avant de démarrer Zigbee2MQTT, il faut regarder dans la partie configuration et ajouter les paramètres nécessaires. Dans mqtt, ajoutez le code suivant, faite attention à mettre les informations de l’utilisateur créer précédemment dans les paramètres user et password !

base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: mqtt
password: VOTRE_MOT_DE_PASSE

4. Récupérer l’ID de votre dongle USB Zigbee

Pour le serial, vous devez mettre le port USB de votre dongle Zigbee. Le port est récupérable dans Home Assistant. Dans mon cas c’est un dongle smlight, connecté au ttyUSB1. Il suffit de récupérer l’ID et le coller dans le code.

5. Configurer votre dongle USB zigbee dans Home Assistant

Remplacer le code du « port » par l’ID de votre dongle précédemment récupérer. Pour le driver (noté adapter) tout dépend de votre clé Zigbee. Si c’est une puce Texas Instrument c’est soit ezsp ou ember. Si vous utilisez une clé zigbee avec un SoC Zigbee Silicon Labs : zstack

port: >-
  /dev/serial/by-id/VOTRE_DONGLE_ZIGBEE
baudrate: 115200
adapter: ember

Vous pouvez enfin démarrer Zigbee2MQTT et tout doit marcher correctement. Dans le cas contraire, c’est très souvent lier à la configuration serial de Zigbee2MQTT.

L’interface de Zigbee2MQTT ressemble à ceci, vous y avez accès directement depuis Home Assistant dans le panel de gauche. C’est ici que vous pouvez ajouter vos appareils Zigbee grâce au bouton dédié en haut à droite « Autoriser l’appairage ».

Installer Zigbee2MQTT est finalement plutôt simple et vous permet de profiter pleinement de vos appareils zigbee avec une solution complète en fonctionnalités et une certaine stabilité.