Guide d’intégration des appareils Shelly Zigbee

Modifié le  Lun, 23 Févr. à 4:05 H

Configuration requise

Assurez-vous de disposer des éléments et accès suivants :

  • Un coordinateur Zigbee (ex. : Sonoff ZBDongle, ConBee II, SkyConnect) connecté à votre système domotique

  • Un logiciel de gestion Zigbee installé et opérationnel, tel que :

    • Home Assistant avec l’intégration ZHA, ou

    • Zigbee2MQTT avec un broker MQTT correctement configuré

  • Un appareil Shelly compatible Zigbee, avec accès physique à son bouton

  • Un ordinateur ou un appareil mobile connecté au même réseau local que votre plateforme domotique


Configuration étape par étape

Étape 1 : Passer au firmware Zigbee (si applicable)

Certains appareils Shelly sont livrés par défaut avec un firmware Wi-Fi/Matter. Si votre appareil prend en charge Zigbee mais n’est pas en mode Zigbee, vous devez effectuer le changement manuellement.

Pour les versions de firmware inférieures à 1.7.0 :

  1. Appuyez rapidement 5 fois sur le bouton de l’appareil.

  2. Attendez 5 à 10 secondes pendant que l’appareil bascule en mode firmware Zigbee.

Remarque : Cette opération n’est nécessaire qu’une seule fois, sauf si le firmware est ensuite repassé manuellement en mode Wi-Fi.

Pour les versions 1.7.0 et supérieures :

Le changement de firmware peut uniquement être effectué via l’interface web locale :

Settings → Switch to Matter/Zigbee


Étape 2 : Activer le mode appairage

L’appareil Shelly doit être en mode appairage pour se connecter à votre réseau Zigbee.

  • Mode appairage automatique : activé après une réinitialisation d’usine

  • Mode appairage manuel : appuyez rapidement 3 fois sur le bouton


Étape 3 : Appairer l’appareil à votre réseau Zigbee

Pour Home Assistant (ZHA)

  1. Accédez à :
    Settings → Devices & Services → Add Integration → Add Zigbee Device

  2. Cliquez sur Add Device.

  3. Attendez que l’appareil Shelly apparaisse.

  4. Sélectionnez-le et attribuez-lui éventuellement un nom et une zone.

Pour Zigbee2MQTT

  1. Ouvrez l’interface web Zigbee2MQTT (généralement http://<votre-ip>:8080).

  2. Cliquez sur Permit Join.

  3. Attendez que l’appareil Shelly soit détecté.

  4. Renommez-le et configurez-le selon vos besoins.


Étape 4 : Utilisation de l’appareil

Une fois l’appairage réussi, l’appareil expose ses entités Zigbee disponibles, telles que :

  • Interrupteurs

  • Capteurs

  • Indicateurs de niveau de batterie (si pris en charge)

Vous pouvez désormais l’utiliser dans des automatisations, des scènes ou en contrôle manuel via votre plateforme Zigbee.


Étape 5 (Recommandé) : Mettre à jour le firmware Zigbee

Pour des performances optimales et une compatibilité continue, mettez à jour votre appareil Shelly vers la dernière version du firmware Zigbee.

⚠️ Les mises à jour du firmware doivent actuellement être effectuées en mode Wi-Fi/BLE. Les mises à jour OTA via Zigbee ne sont pas prises en charge pour le moment.

Procédure de mise à jour

1. Activer le mode Wi-Fi/BLE
Maintenez le bouton arrière enfoncé pendant 5 secondes pour changer de mode.

2. Se connecter au point d’accès de l’appareil

  • Après la réinitialisation, l’appareil diffuse un point d’accès Wi-Fi local.

  • Connectez-vous à celui-ci, puis ouvrez http://192.168.33.1 dans votre navigateur.

3. Mettre à jour via l’interface web

  • Accédez à : Settings → Firmware

  • Installez la dernière version disponible incluant les améliorations Zigbee.

4. Vérifier l’état de la connexion Zigbee

Statut ZigbeeSignification
joinedL’appareil est correctement connecté au réseau
steeringL’appareil est en mode appairage et recherche un réseau
failedL’appareil n’a pas réussi à rejoindre le réseau

Si le statut affiche « failed », appuyez rapidement 3 fois sur le bouton pour relancer le mode appairage.


Dépannage

ProblèmeSolution
Aucune réaction après 5 pressionsVérifiez que les pressions sont rapides et distinctes ; attendez 5 à 10 secondes après la séquence
L’appareil n’apparaît pasVérifiez qu’il est en mode Zigbee ; relancez l’appairage en appuyant 3 fois sur le bouton
L’appareil apparaît comme « unknown »Attendez quelques minutes ; mettez à jour les définitions d’appareils de votre coordinateur Zigbee
Signal Zigbee faible ou déconnexionsRapprochez l’appareil du coordinateur ou ajoutez des routeurs Zigbee pour renforcer le réseau