Comment migrer votre coordinateur Zigbee vers le nouveau dongle SONOFF ?

Présentation

Pour les passerelles Zigbee traditionnelles, les barrières écosystémiques entre les marques rendent souvent la migration très compliquée. Passer à une nouvelle passerelle signifie généralement devoir réajouter un grand nombre de sous-appareils depuis le début.

Cependant, pour les coordinateurs Zigbee sous forme de Dongles — couramment utilisés avec des plateformes open source — la situation est tout autre. Si vous devez remplacer votre Dongle, à la fois ZHA et Z2M proposent des fonctionnalités de migration de coordinateur Zigbee qui vous permettent de transférer votre configuration rapidement et sans effort. Cela rend la mise à niveau vers un nouveau Dongle beaucoup plus simple et pratique.

Après plusieurs cycles d’itération et de mises à jour, la gamme SONOFF Dongle s’est enrichie avec le Dongle-M, le Dongle-PMG24 et le Dongle-LMG21 — chacun conçu pour différents utilisateurs et scénarios. Les trois sont basés sur la solution Ember et supportent les fonctionnalités de migration, vous permettant de transférer les données de votre ancien Dongle et de continuer à faire fonctionner 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) en utilisant ZHA ou Z2M.

ZHA : Migration du coordinateur Zigbee  

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

Résultat :

Pas besoin de reconfigurer les appareils  

Étapes de migration :

1. Rendez-vous sur la page de configuration 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 Soumettre.

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 la méthode de connexion pour le Dongle-M :

• Connexion USB : Sélectionnez directement le périphérique série et connectez-vous.
  
• Connexion TCP : Choisissez Entrer manuellement, puis sélectionnez 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 à partir de la sauvegarde automatique.

7. Migration réussie.

Z2M :  Migration du coordinateur Zigbee  

Tutoriel officiel Zigbee2MQTT : https://www.zigbee2mqtt.io/guide/faq/#how-do-i-migrate-from-one-adapter-to-another

Migrer d’un coordinateur Ember vers Dongle-M

Résultat :

Pas besoin de reconfigurer les appareils

Étapes :

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

2. Utilisez le module complémentaire Éditeur de fichiers pour accéder à /homeassistant/zigbee2mqtt/configuration.yaml.

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

4. Redémarrez Zigbee2MQTT.

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

Résultat : 
Testé sans besoin de reconfiguration des appareils

Étapes :

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

2. Utilisez le module complémentaire Éditeur de fichiers 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 entrez le chemin série du Dongle-M, par exemple tcp://Dongle-M.local:6638. Assurez-vous de changer le pilote en 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. Le pan_id et l’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é avec succès et la console Zigbee2MQTT accessible, arrêtez le module complémentaire. Retournez dans /homeassistant/zigbee2mqtt/, supprimez la nouvelle base de données database.db, et renommez la base de données originale database.db.backup en database.db.

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

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

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