Vous souhaitez piloter vos appareils Zigbee avec Home Assistant sans dépendre du Cloud ?
La clé USB Zigbee Sonoff 3.0 est aujourd’hui l’une des solutions les plus populaires pour créer un réseau Zigbee fiable, local et évolutif. Dans cet article, je vous explique pas à pas comment l’installer avec Zigbee2MQTT, depuis le branchement jusqu’à l’utilisation des appareils dans Home Assistant.

La clé USB SONOFF Zigbee 3.0

En janvier 2020, j’écrivais un article sur la clé Conbee2 dans Jeedom. Depuis, beaucoup d’eau a coulé sous les ponts. J’ai quitté Jeedom pour Home Assistant, Zigbee2MQTT (Z2M) est arrivé et des clés Zigbee de marques concurrentes, comme ici la clé USB Zigbee Sonoff 3.0, ont clairement pris le lead du marché.

Le principal avantage d’une clé USB Zigbee Sonoff 3.0 avec Home Assistant est de pouvoir piloter des appareils Zigbee sans passer par le Cloud. Tout fonctionne en local, sans communication vers l’extérieur, sans pont propriétaire et même en cas de coupure Internet (locale ou Cloud).

Installation plug and play

Dès le branchement sur un port USB (chez moi, celui du NAS Synology qui héberge la machine virtuelle Home Assistant), Home Assistant détecte automatiquement la clé USB Zigbee Sonoff 3.0 et propose de la configurer via Zigbee Home Automation (ZHA).

ZHA fonctionne correctement, mais Zigbee2MQTT (Z2M) est généralement considéré comme plus souple, mieux documenté côté compatibilité et plus simple à diagnostiquer lorsqu’on souhaite comprendre ce qui se passe réellement. C’est donc cette solution que j’ai choisie.

Installation du broker MQTT

Zigbee2MQTT nécessite obligatoirement la présence d’un broker MQTT. Celui-ci sert d’interface de communication entre le réseau Zigbee et Home Assistant.

L’installation du broker MQTT a déjà été détaillée dans un article précédent :
https://www.objetsconnectes.be/2020/03/01/flukso-jeedom-mqtt/#Installation_de_MQTT

Ajout de Zigbee2MQTT à Home Assistant

Zigbee2MQTT n’est pas installé par défaut dans Home Assistant. Il faut l’ajouter via le dépôt officiel.

1. Dans *Paramètres / Modules complémentaires*, cliquer sur « Boutique des modules complémentaires ».
2. En haut à droite, cliquer sur les trois points (⋮), puis sur « Dépôts ».
3. Ajouter l’URL suivante : https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
4. Choisir Zigbee2MQTT.
5. Installer l’add-on Zigbee2MQTT.

Identification de la clé USB Zigbee Sonoff

À cette étape, on récupère dans Home Assistant le chemin matériel exact de la clé USB Zigbee Sonoff 3.0 car on en aura besoin pour configurer Zigbee2MQTT

• Aller dans *Paramètres → Système → Matériel*
• Repérer la ligne correspondant à la clé USB Zigbee Sonoff 3.0, qui ressemble à :
  /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_XXXXXXXX-if00-port0

• Sauvegarder ce chemin. Il est fortement recommandé d’utiliser le chemin /dev/serial/by-id/, bien plus stable que /dev/ttyUSB0, qui lui peut changer à chaque redémarrage.

Configuration de Zigbee2MQTT

On passe maintenant à la configuration de l’add-on Zigbee2MQTT.

• Dans l’add-on Zigbee2MQTT, ouvrir l’onglet « Configuration »
• Coller la configuration YAML suivante en adaptant le chemin vers la clé USB :

mqtt:

  server: mqtt://core-mosquitto:1883

serial:

  # Chemin vers la clé USB

  port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_XXXXXXXX-if00-port0

  adapter: zstack

La clé USB Zigbee Sonoff 3.0 étant basée sur une puce CC2652P, l’adaptateur zstack est celui à utiliser.

Démarrage de Zigbee2MQTT

Une fois la configuration terminée, Zigbee2MQTT peut être démarré.

1. Démarrer l’add-on Zigbee2MQTT
2. Vérifier les logs Home Assistant afin de détecter d’éventuelles erreurs
3. Cliquer sur « Ouvrir l’interface utilisateur web »
4. Renseigner le nom d’utilisateur et le mot de passe MQTT utilisés par Zigbee2MQTT
5. Cliquer sur Submit

Appairage des appareils Zigbee

Zigbee2MQTT étant opérationnel, il ne reste plus qu’à appairer les appareils Zigbee.

1. Dans l’interface Zigbee2MQTT, cliquer sur « Permit join » pour autoriser l’ajout de nouveaux appareils
   
2. Mettre l’appareil Zigbee en mode appairage. Pour cette prise, il suffit de maintenir le bouton appuyé pendant 5 à 10 secondes.
   

   ---

   (Lien sponsorisé vers le produit...cela ne vous coutera rien de plus mais cela fera vivre ce blog) https://amzn.to/429Zkyp Zigbee Prise Connectée Alexa, Prises Connectée 16A avec Mesure Actuelle, Prise Intelligente 3680W avec Télécommande/Contrôle Vocal, Programmable Smart Plug Compatible Alexa Google Home 1 Pack 15,99 € (as of 23/12/2025 01:28 GMT +01:00 - Plus d’infosProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.) 【Zigbee Prise Connectée】 En se connectant à un hub ZigBee, la prise intelligente Zigbee a une meilleure connexion stable. Vous n'avez pas à vous soucier que le socket Alexa perde la connexion ou que le retard réagit. En attendant, cela peut être mieu... read more

   ---

3. Les appareils apparaissent ensuite dans l’interface Zigbee2MQTT :

On constate également leur présence côté MQTT :

Utilisation des appareils Zigbee dans Home Assistant

Zigbee2MQTT n’envoie pas directement les appareils dans Home Assistant. Les informations transitent via MQTT.

Dans Paramètres / Appareils et services, l’intégration MQTT est celle qui va donc recevoir les informations

Une entrée Zigbee2MQTT Bridge est apparue.

Les appareils appairés sont ensuite disponibles, avec un grand nombre d’entités : capteurs, états, commandes…

Conclusion

Pour une vingtaine d’euros, la clé USB Zigbee Sonoff 3.0 offre une solution fiable, locale et totalement autonome pour piloter ses appareils Zigbee avec Home Assistant. Un excellent choix que je ne regrette absolument pas.