Guide pratique · 9 min
Migrer un coordinateur Zigbee avec ZHA ou Zigbee2MQTT sans perdre le réseau
Préparer la migration d'un coordinateur Zigbee : sauvegarde, compatibilité radio, IEEE, chemin série, validation et retour arrière.
Ne pas confondre remplacement physique et migration logique
Changer le port USB ou l'adresse réseau est simple si la même radio et les mêmes paramètres restent utilisés. Remplacer le coordinateur par une autre famille de puce peut demander une procédure différente ou un nouvel appairage.
Vérifiez la documentation de ZHA ou Zigbee2MQTT pour la combinaison exacte avant de débrancher l'ancien appareil.
Sauvegarder et relever l'état initial
Créez une sauvegarde Home Assistant et exportez les sauvegardes proposées par l'intégration. Notez le canal, le PAN ID, l'Extended PAN ID, la clé réseau, le chemin série et le type d'adaptateur sans publier ces données.
Conservez l'ancien coordinateur intact jusqu'à la validation complète du nouveau réseau.
Migrer dans une fenêtre contrôlée
Arrêtez proprement le service qui utilise le coordinateur avant de le remplacer. Configurez l'adaptateur et le chemin exacts, puis redémarrez une seule pile Zigbee pour éviter les accès concurrents à la radio.
Ne lancez pas immédiatement une réinitialisation ou un nouvel appairage si les appareils n'apparaissent pas. Consultez les journaux et revenez à l'ancien matériel si nécessaire.
Valider les routeurs puis les appareils sur pile
Testez d'abord plusieurs routeurs alimentés, puis réveillez les appareils sur pile selon leur procédure. Vérifiez les commandes, attributs et automatismes critiques.
Gardez un inventaire des appareils afin d'identifier rapidement ceux qui n'ont pas communiqué depuis la migration.
Questions fréquentes
Peut-on migrer entre toutes les puces Zigbee sans réappairer ?
Non. La possibilité dépend de la pile, du type de sauvegarde et des familles de radios. Vérifiez la procédure officielle correspondant au cas exact.
Faut-il conserver l'adresse IEEE ?
Certaines migrations l'exigent ou la recommandent. Ne la modifiez pas sans comprendre la procédure de restauration utilisée.
Pourquoi arrêter ZHA ou Zigbee2MQTT avant le remplacement ?
Une radio ne doit pas être ouverte simultanément par plusieurs services. Un arrêt propre réduit les risques de corruption et d'erreur de port.
