📌 Comment les appareils SONOFF Zigbee fonctionnent avec Home Assistant

Introduction

Les appareils Zigbee SONOFF constituent un excellent choix pour créer un réseau domestique intelligent local stable et réactif. Avec Home Assistant comme hub domotique et un coordinateur Zigbee tel que la clé USB Zigbee 3.0 Plus SONOFF (ZBDongle-E ou ZBDongle-P), vous pouvez contrôler vos appareils Zigbee SONOFF, comme l'interrupteur mural intelligent ZBM5, sans passer par le cloud.

Ce guide vous guidera dans l'intégration des appareils SONOFF Zigbee avec Home Assistant en utilisant deux méthodes :

• ZHA (Domotique Zigbee)
• Z2M (Zigbee2MQTT)

Les deux offrent un excellent contrôle local, une prise en charge de l'automatisation et une compatibilité avec la gamme de produits SONOFF Zigbee.

Préparation

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Assistant à domicile installé et en cours d'exécution
• UN Coordinateur Zigbee (par exemple, Clé USB SONOFF Zigbee 3.0 Plus-P / -E )
• Appareil Zigbee SONOFF : SONOFF ZBM5

Guide d'installation

Il existe deux manières d'utiliser le dongle USB SONOFF Zigbee 3.0 Plus pour ajouter vos appareils Zigbee à Home Assistant : ZHA ou Zigbee2MQTT.

Ici, je vais vous présenter

Suivez ici si vous utilisez ZBDongle-E : Ajouter ZBDongle-E à HA

Suivez ici si vous utilisez ZBDongle-P : Ajouter ZBDongle-P à HA

Après avoir ajouté le dongle USB SONOFF Zigbee 3.0 Plus à Home Assistant, nous pouvons ajouter des appareils Zigbee à HA pour le contrôle.

via ZHA

Étape 1 : Installer et configurer ZHA dans Home Assistant

• Accédez à Home Assistant et accédez à Paramètres → Appareils et services.
• Cliquez sur « Ajouter une intégration » et recherchez Zigbee Home Automation (ZHA) .
• Une fois terminé, vous devriez voir ZHA configuré avec succès dans Home Assistant.

Étape 2 : ajouter SONOFF ZBM5 à Home Assistant

1. Dans Home Assistant, accédez à Paramètres > Appareils et services > ZHA > appareils .

2. Mettre le SONOFF ZBM5 en mode appairage en appuyant sur le bouton physique et en le maintenant enfoncé pendant 5 secondes jusqu'à ce que la LED commence à clignoter.
3. Cliquez sur « Ajouter un appareil » et attendez que ZHA découvre le ZBM5.

4. Une fois trouvé, vous pouvez renommer et attribuer l'appareil à une pièce si nécessaire.

via Z2M

Étape 1 : Installer les modules complémentaires

Lors de la connexion HA via le module complémentaire Zigbee2MQTT, vous devez installer les deux modules complémentaires suivants :

1. Courtier Mosquitto (courtier MQTT)
2. Zigbee2MQTT

Installer le courtier Mosquitto

Accédez à Paramètres → Modules complémentaires → Boutique de modules complémentaires et installez le module complémentaire du courtier Mosquitto , puis démarrez-le.

Installer Zigbee2MQTT

1. Ajouter un référentiel

Retournez à la boutique de modules complémentaires, cliquez sur « ⋮ » → « Référentiels », remplissez

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

et cliquez sur Ajouter → Fermer ou cliquez sur le bouton Ajouter un référentiel ci-dessous, cliquez sur Ajouter → Fermer

Lien d'installation

Installer Zigbee2MQTT

Revenez à la liste des magasins , recherchez Zigbee2MQTT et procédez à l'installation.

Étape 2 : Configurer Zigbee2MQTT

Ouvrez le module complémentaire Zigbee2MQTT → page Configuration .
Vous devez configurer le type d'adaptateur de l'appareil et le chemin du port série sous série.

Le format suivant :

 adapter: Adapter Type
port: ZBDongle Serial Port Path

Exemple de configuration :

Pour ZBDongle-E (SONOFF Zigbee 3.0 USB Dongle Plus V2) :

 adapter: ember
port: /dev/ttyUSB0

Pour ZBDongle-P (clé USB SONOFF Zigbee 3.0 Plus) :

 adapter: zstack
port: /dev/ttyUSB0

⚠️ Le chemin du port série peut varier selon le système hôte. Sous Linux, vous pouvez le trouver en exécutant :

 ls -l /dev/serial/by-id

Exemple de sortie :

 coolkit@coolkit-All-Series:~$ ls -l /dev/serial/by-id
total  0
lrwxrwxrwx 1 root root 13 3月 31 18:09 usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_76536147c914ef11950378b8bf9df066-if00-port0 -> ../../ttyUSB0

Le chemin du port série dans ce cas est :

 /dev/ttyUSB0

Une fois la configuration terminée, démarrez le module complémentaire Zigbee2MQTT . Patientez environ deux minutes, puis cliquez sur l' interface Web pour accéder à la console et ajouter et gérer les appareils Zigbee.

Dépannage

Appareil non trouvé ?

Assurez-vous que le ZBDongle est détecté dans /dev/ttyUSB*

Redémarrez Home Assistant après avoir inséré le dongle

Éloignez le dongle des ports USB 3.0 ou utilisez une rallonge USB

Délai d'appairage expiré ?

Assurez-vous que le ZBM5 est en mode d'appairage (LED clignotante)

Redémarrez le commutateur et réessayez

​

Z2M ne démarre pas ?

Vérifiez le type d'adaptateur Zigbee et le port dans configuration.yaml

FAQ

Q : Puis-je utiliser ZBM5 sans Internet ?
Oui. ZHA et Z2M sont des intégrations locales , aucun cloud n'est requis après l'installation.

Q : Puis-je mettre à jour le firmware du ZBM5 via Home Assistant ?
Oui, vous pouvez mettre à jour le micrologiciel de l'appareil sur Home Assistant.

Q : Quelle est la différence entre ZHA et Zigbee2MQTT ?
ZHA est plus convivial et intégré à la haute disponibilité. Z2M offre davantage de contrôle, de journaux et de prise en charge des appareils. Tous deux sont compatibles avec SONOFF.

Q : Les mêmes fonctionnalités sont-elles disponibles sur Home Assistant lors de l’intégration d’appareils via ZHA et Z2M ?

R : Non, ils ne sont pas exactement identiques. Bien que ZHA et Z2M permettent de contrôler et de surveiller les appareils Zigbee dans Home Assistant, il existe des différences en termes de prise en charge des appareils, de flexibilité de configuration et d'exposition des fonctionnalités. Les fonctionnalités disponibles peuvent varier selon l'appareil et la méthode d'intégration.

Q : Puis-je mélanger ZHA et Z2M dans le même Home Assistant ?
Non. Vous ne pouvez utiliser qu'une seule intégration Zigbee par dongle/instance, sauf si vous utilisez des coordinateurs et des canaux Zigbee distincts.