Aller au contenu principal

Gérez ses appareils Zigbee dans sa domotique avec une clé USB Zigbee et Zigbee2mqtt

Dans ce tutoriel, nous allons vous expliquer comment intégrer vos appareils Zigbee dans Gladys via une clé USB Zigbee.

Vous pourrez ainsi connecter tout type d'appareils Zigbee en direct, et vous affranchir des bridges Zigbee souvent fournis par les constructeurs (Bridge Philips Hue, Hub Xiaomi).

Nous utilisons pour cela l'excellent projet open-source Zigbee2Mqtt.

Si vous préférez en vidéo, j'ai filmé ce tutoriel sur Youtube pour vous montrer comment faire concrètement :

Le matériel nécessaire

Pour commencer, vous aurez besoin d'un dongle USB Zigbee.

Sonoff Zigbee 3.0 USB dongle plus

Nous avons testé par exemple le Sonoff Zigbee 3.0 USB Dongle Plus, qui fonctionne très bien avec Gladys et Zigbee2mqtt. Dans mon cas je l'ai acheté chez Domadoo, mais il est aussi trouvable sur Amazon.

Le gros avantage de ce dongle est qu'il est déjà flashé, par conséquent il est prêt à l'emploi, il n'y a rien à faire.

Vous pouvez consulter la liste des adapteurs Zigbee supportés ici.

Vous pouvez consulter la liste des appareils Zigbee compatibles ici.

danger

Si vous faites tourner Gladys sur un Raspberry Pi avec un disque externe, votre Raspberry Pi risque d'avoir des problèmes d'alimentation pour alimenter en même temps le disque externe et la clé USB Zigbee.

Nous recommandons d'utiliser un hub USB alimenté de manière externe.

Si Zigbee2Mqtt ne démarre pas chez vous, je vous recommande de lire la FAQ sur le site de Zigbee2mqtt : Zigbee2MQTT fails to start

Configurez le port du dongle USB

Connectez votre dongle USB Zigbee à votre machine faisant tourner Gladys (Raspberry Pi, NAS).

Dans Gladys, Rendez-vous dans Intégrations / Zigbee2Mqtt.

En cliquant dans le menu sur Paramètres, Gladys va automatiquement scanner les différents ports USB pour vous proposer une liste déroulante. Indiquez dans le paramètrage le port USB à utiliser pour permettre à Gladys de communqiuer en Zigbee.

Paramètrage dongle USB

13 Mai 2023: Il est maintenant possible de sélectionner directement dans Gladys le modèle de dongle Zigbee que vous utilisez :

Modèle Zigbee

Cela permet de charger directement la configuration Zigbee2mqtt correspondante.

Activez Zigbee2Mqtt

Une fois votre dongle configuré, Gladys a besoin d'installer deux containers (MQTT et Zigbee2Mqtt) pour utiliser le dongle et communiquer avec tous vos appareils. Ne vous inquiétez pas, tout cela a été automatisé.

Rendez-vous dans la partie Configuration et cliquez sur le bouton Activer Zigbee2mqtt. Après quelques instants (le temps dépend de votre modèle de Raspberry Pi et de votre bande passante), vous devriez visualiser tous les éléments démarrés et les liens entre chacun au vert.

Etat des services Zigbee2Mqtt

Autorisez l'association d'appareils

Pour permettre aux périphériques d'êtres associés à votre réseau Zigbee, il faut autoriser l'association dans la configuration de Zigbee.

Cliquez sur le menu Découverte Zigbee, puis cliquez sur le bouton Autoriser l'association.

Autoriser l'association

⚠️ Attention, une fois vos appareils associés, vous devrez revenir ici pour interdire l'association, par sécurité.

Ajoutez des appareils

Pour que votre périphérique rejoigne le réseau, reportez-vous à la notice de celui-ci. Dans la majorité des cas, un appui long sur le bouton physique permet cette opération.

Les appareils déjà associés à votre réseau Zigbee apparaîtront automatiquement avec la liste des fonctionnalités détectées. Vous pouvez les renommer et les associer à une pièce grâce à la liste déroulante.

Ajouter un appareil

Modifiez les appareils

Si nécessaire, vous pouvez vous rendre dans le menu Appareils pour modifier/compléter la configuration de vos appareils.

Cliquez sur le bouton Editer d'un appareil. Vous pourrez alors éditer son nom, la pièce à laquelle il appartient et le nom de chaque fonctionnalité.

Editer un appareil

Utilisation

Vous pouvez maintenant utiliser ces appareils Zigbee depuis le Tableau de bord ou depuis les Scènes de manière automatique. Selon les fonctionnalités de chaque appareil, vous aurez accès à des mesures, des états ou des actions.