Comment migrer votre coordinateur Zigbee vers le nouveau dongle SONOFF ?

Présentation

Pour les passerelles Zigbee traditionnelles, les barrières entre les écosystèmes des différentes marques rendent souvent la migration particulièrement fastidieuse. Le passage à une nouvelle passerelle implique généralement de réajouter un grand nombre de sous-appareils depuis le début.

Toutefois, pour les coordinateurs Zigbee prenant la forme de Dongles — couramment utilisés avec des plateformes open source — la situation est bien différente. Si vous devez remplacer votre Dongle, ZHA et Z2M proposent tous deux des fonctions de migration du coordinateur Zigbee qui vous permettent de transférer rapidement et facilement votre configuration, avec un minimum d’efforts. La mise à niveau vers un nouveau Dongle devient ainsi beaucoup plus simple et pratique.

Après plusieurs cycles d’itérations et de mises à niveau, la gamme de Dongles SONOFF comprend désormais le Dongle-M, le Dongle-PMG24 et le Dongle-LMG21 — chacun étant conçu pour différents utilisateurs et scénarios. Tous trois reposent sur la solution Ember et prennent en charge les fonctions de migration, ce qui vous permet de transférer les données de votre ancien Dongle et de continuer à utiliser votre écosystème Zigbee sans interruption.

Dans cet article, nous prendrons le Dongle-M comme exemple et vous expliquerons comment migrer votre configuration — qu’elle provienne d’un Dongle basé sur Z-Stack ou d’un autre Dongle basé sur Ember — vers un nouveau Dongle SONOFF (Dongle-M, Dongle-PMG24 et Dongle-LMG21) à l’aide de ZHA ou Z2M.

ZHA : migration du coordinateur Zigbee  

Tutoriel officiel de ZHA : https://www.home-assistant.io/integrations/zha/#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha

Résultat :

Il n’est pas nécessaire de reconfigurer les appareils  

Étapes de migration :

1. Accédez à la page de configuration de ZHA et cliquez sur le bouton Migrer la radio.

2. Sélectionnez Migrer vers une nouvelle radio.

3. Confirmez les informations de migration et cliquez sur Envoyer.

4. Débranchez l’ancien Dongle et connectez le Dongle-M au port USB de l’hôte ou au réseau local.

5. Confirmez le mode de connexion du Dongle-M :

• Connexion USB : Sélectionnez directement le périphérique série et connectez-le.
  
• Connexion TCP : Sélectionnez Saisir manuellement, choisissez ensuite manuellement le type de périphérique EZSP et définissez le chemin série sur : tcp://Dongle-M.local.
  

Configuration manuelle :

6. Choisissez de restaurer la configuration à partir de la sauvegarde automatique.

7. Migration réussie.

Z2M :  migration du coordinateur Zigbee  

Tutoriel officiel de Zigbee2MQTT : Comment migrer d’un adaptateur à un autre

Migration d’un coordinateur Ember vers le Dongle-M

Résultat :

Il n’est pas nécessaire de reconfigurer les appareils

Étapes :

1. Arrêtez le module complémentaire Zigbee2MQTT.

2. Utilisez le module complémentaire File Editor pour accéder à /homeassistant/zigbee2mqtt/configuration.yaml.

3. Modifiez le port pour indiquer le chemin du Dongle-M, par exemple tcp://Dongle-M.local:6638, puis enregistrez (Ctrl + S).

4. Redémarrez Zigbee2MQTT.

Migration d’un coordinateur Z-Stack vers le Dongle-M (recommandation non officielle)

Résultat : 
Les tests indiquent qu’aucune reconfiguration des appareils n’est nécessaire

Étapes :

1. Arrêtez le module complémentaire Zigbee2MQTT.

2. Utilisez le module complémentaire File Editor pour accéder à /homeassistant/zigbee2mqtt/.

3. Sauvegardez configuration.yaml, coordinator_backup.json et database.db sur votre ordinateur local (au cas où une restauration serait nécessaire).

4. Modifiez /homeassistant/zigbee2mqtt/configuration.yaml et saisissez le chemin série du Dongle-M, par exemple tcp://Dongle-M.local:6638. Veillez à remplacer le pilote par ezsp, puis enregistrez (Ctrl + S).

5. Supprimez /homeassistant/zigbee2mqtt/coordinator_backup.json.

6. Démarrez le module complémentaire Zigbee2MQTT. Zigbee2MQTT recréera le réseau Zigbee à partir du fichier YAML. Les valeurs pan_id et extended_pan_id correspondront au réseau d’origine, tandis que la liste des appareils sera vide.

7. Une fois le réseau Zigbee démarré correctement et la console Zigbee2MQTT accessible, arrêtez le module complémentaire. Retournez dans /homeassistant/zigbee2mqtt/, supprimez le fichier database.db nouvellement généré et renommez la sauvegarde database.db.backup d’origine en database.db.

8. Modifiez également configuration.yaml pour définir l’adaptateur sur ember, puis enregistrez (Ctrl + S).  

9. Redémarrez Zigbee2MQTT. La liste originale des appareils sera alors restaurée à partir de database.db.  

Enfin, quelle que soit la méthode utilisée pour migrer votre coordinateur Zigbee, si vous rencontrez un problème, n’hésitez pas à consulter la section Dongle du forum. Nos développeurs Dongle sont là pour répondre à vos questions et vous aider à effectuer une transition fluide et sans interruption vers votre nouveau Dongle SONOFF.