Guide d’intégration des appareils Shelly Zigbee

Modifié le  Jeu, 31 Juill. à 3:47 H

Pré-requis système

Avant de commencer, assurez-vous de disposer des éléments suivants :

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

  • Un logiciel de contrôle Zigbee installé et fonctionnel, tel que :

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

    • Zigbee2MQTT avec un broker MQTT

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

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


Étapes d’installation

Étape 1 : Passer au firmware Zigbee (si nécessaire)

Certains appareils Shelly sont livrés avec un firmware Wi-Fi/Matter par défaut. Si votre appareil prend en charge Zigbee mais ne l’utilise pas encore, procédez comme suit :

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

  2. Attendez 5 à 10 secondes pendant la commutation vers le mode Zigbee

Remarque : Cette étape n’est requise qu’une seule fois, sauf si vous repassez manuellement en mode Wi-Fi par la suite.


Étape 2 : Activer le mode d’appairage

L’appareil doit être en mode d’appairage pour rejoindre le réseau Zigbee :

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

  • Mode manuel : appuyez rapidement 3 fois sur le bouton de l’appareil


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

Avec Home Assistant (ZHA)

  1. Allez dans :
    Paramètres → Appareils & Services → Ajouter une intégration → Ajouter un appareil Zigbee

  2. Cliquez sur « Ajouter un appareil »

  3. Attendez que l’appareil Shelly apparaisse

  4. Sélectionnez-le, puis nommez-le et affectez-le à une zone si souhaité

Avec Zigbee2MQTT

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

  2. Cliquez sur « Permit Join »

  3. Attendez que l’appareil soit découvert

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


Étape 4 : Utiliser l’appareil

Une fois l’appareil appairé, il expose ses entités Zigbee disponibles, telles que :

  • Commutateurs

  • Capteurs

  • Niveau de batterie (si pris en charge)

Vous pouvez l’utiliser dans des automatismes, des scènes ou le contrôler manuellement depuis votre plateforme Zigbee.


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

Pour garantir les meilleures performances et la compatibilité à long terme, mettez à jour le firmware de votre appareil Shelly vers la dernière version disponible.

⚠️ Important : La mise à jour OTA via Zigbee n’est pas encore disponible. Vous devez temporairement activer le mode Wi-Fi/BLE pour effectuer la mise à jour.

Procédure de mise à jour

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

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

    • Après la réinitialisation, l’appareil crée un point d’accès Wi-Fi

    • Connectez-vous à celui-ci, puis accédez à l’adresse http://192.168.33.1 dans un navigateur

  3. Mettre à jour le firmware via l’interface web

    • Accédez à Paramètres → Firmware

    • Installez la version la plus récente disponible

  4. Vérifier le statut Zigbee

Statut ZigbeeSignification
joinedL’appareil est connecté avec succès au réseau Zigbee
steeringL’appareil est en mode appairage, en recherche de réseau
failedÉchec de la connexion – réessayez l’appairage

Si le statut est « failed », appuyez 3 fois rapidement pour réactiver le mode appairage.


Dépannage

ProblèmeSolution
Aucune réaction après 5 pressionsAppuyez rapidement et distinctement ; attendez 5 à 10 secondes
L’appareil n’apparaît pasVérifiez qu’il est bien en mode Zigbee ; recommencez l’appairage (3 pressions)
L’appareil apparaît comme inconnuAttendez quelques minutes ; mettez à jour les définitions de périphériques de votre coordinateur
Connexion Zigbee instable ou faibleRapprochez l’appareil du coordinateur ou ajoutez des routeurs Zigbee au réseau