Oui, un appareil Zigbee déjà appairé n’a pas besoin d’être réappairé lorsque vous changez de coordinateur, à condition de migrer l’ensemble du réseau plutôt que d’ajouter les appareils un par un. La migration transfère l’identité du réseau vers le nouveau coordinateur, et les appareils existants le reconnaissent ensuite. Après une migration ZHA, ils peuvent mettre jusqu’à une heure environ à se reconnecter, sans action de votre part (SmartHomeScene, 2025-12-08).
Peut-on ajouter un appareil Zigbee sans le réappairer ?
Ajouter un appareil et migrer le réseau sont deux opérations distinctes, qui n’ont pas le même effet sur les appareils déjà en place.
Ajouter un appareil ou migrer le réseau
| Critère | Ajout d’un appareil | Migration du réseau |
|---|---|---|
| Objet de l’opération | Enregistrer un nouvel appareil dans le réseau existant | Transférer l’identité du réseau vers un nouveau coordinateur |
| Appareils déjà appairés | Non concernés | Reconnectés au nouveau coordinateur |
| Réappairage | Requis pour le nouvel appareil | Non requis pour les appareils existants, sauf changement de famille de puces |
Un passage entre zstack et ember n’est pas officiellement supporté et peut imposer le réappairage de certains appareils ; pour les familles ConBee, EZSP, ZBOSS et ZiGate, la sauvegarde et la restauration ne sont pas prises en charge officiellement par Zigbee2MQTT (SmartHomeScene, 2025-12-08).
Ce qui se passe pendant la migration
Pendant la reconnexion, les données de qualité de liaison (LQI) sont inexactes. Le réseau peut mettre jusqu’à 24 h à se rééquilibrer (SmartHomeScene, 2025-12-08). Évitez donc de juger la portée ou la stabilité des appareils pendant cette période.
Plateformes concernées
- ZHA (intégré à Home Assistant) : la migration se lance depuis les paramètres réseau de l’intégration, avec l’option « Migrate Automatically ».
- Zigbee2MQTT : le réseau est transféré à partir de fichiers propres à la plateforme, dont coordinator_backup.json, database.db et configuration.yaml. Ces fichiers doivent être sauvegardés avant toute opération (SmartHomeScene, 2025-12-08).
Comprendre le rôle du coordinateur
Le coordinateur est l’appareil qui crée le réseau Zigbee et en définit l’identité : clé réseau, PAN ID, canal et adresse IEEE. Dans une box domotique, c’est le dongle radio branché sur la machine qui remplit ce rôle. Lorsqu’on remplace ce dongle, le nouveau module doit reprendre les paramètres du réseau existant. Sans cela, il ne reconnaît plus les appareils déjà en place.
Les quatre identifiants du réseau
Le coordinateur s’appuie sur quatre éléments qui définissent le réseau :
| Élément | Rôle dans le réseau |
|---|---|
| Clé réseau | Protège les échanges. Un appareil qui ne possède pas la bonne clé ne peut pas dialoguer avec le réseau. |
| PAN ID | Identifie le réseau local et le distingue de ceux des voisins. |
| Canal | Fréquence radio sur laquelle le réseau émet et écoute. |
| Adresse IEEE | Identifiant unique du coordinateur lui-même. |
Ces quatre informations sont précisément celles que ZHA retient pour décrire le réseau du coordinateur, selon un fil de la communauté Home Assistant (2020).
Pourquoi ces données comptent pour la reconnaissance
Lorsqu’un appareil rejoint le réseau, il mémorise la clé réseau, le PAN ID et le canal. Il s’en sert ensuite pour reconnaître le réseau auquel il appartient. Si le nouveau coordinateur reprend exactement ces paramètres, les appareils retrouvent leur réseau et reprennent la communication. Si l’un d’eux diffère, par exemple une clé différente, les appareils ne reconnaissent plus le réseau et doivent être réappairés.
Coordinateur et appareils finaux
Un réseau Zigbee comporte trois types d’appareils, qui ont des rôles différents :
- Coordinateur : un seul par réseau. Il crée le réseau et en fixe la clé et les paramètres d’identité.
- Routeur : appareil alimenté en permanence, comme une prise ou une ampoule. Il relaie les messages entre les autres appareils et étend la portée du réseau.
- Appareil final : capteur ou bouton, souvent sur pile. Il ne relaie pas les messages et communique via un routeur ou directement avec le coordinateur.
La distinction compte pour la migration : le coordinateur est le seul élément dont les paramètres doivent être transférés. En cas de migration réussie, les routeurs et appareils finaux n’ont en principe rien à reconfigurer, mais certains peuvent devoir être réappairés si le réseau n’est pas restauré à l’identique ou si la famille de puces change.
Sauvegarder avant toute migration
Avant de remplacer le coordinateur Zigbee, il faut sauvegarder ce qui permet de restaurer le réseau. Les éléments à conserver dépendent de l’intégration utilisée : ZHA, intégrée à Home Assistant, ou Zigbee2MQTT. Dans les deux cas, la sauvegarde ne couvre pas tout, et une sauvegarde complète de la box reste la base.
Sauvegarde complète de Home Assistant
Avant toute opération sur le coordinateur, réalisez une sauvegarde complète de Home Assistant. Selon SmartHomeScene (2025-12-08), la migration ZHA exige cette sauvegarde préalable, avec le nouveau coordinateur branché. Elle conserve la configuration, les automatisations et les intégrations, ce qui limite les réglages à refaire si la migration échoue.
Périmètre limité de la sauvegarde native ZHA
La sauvegarde propre à ZHA ne contient que les informations réseau du coordinateur. Elle ne suffit donc pas à restaurer l’ensemble de la configuration. Le forum Home Assistant Community (2020) rappelle que cette sauvegarde reste insuffisante seule et qu’une sauvegarde complète de Home Assistant reste recommandée.
Fichiers à conserver avec Zigbee2MQTT
Avec Zigbee2MQTT, trois fichiers doivent être copiés en lieu sûr avant l’arrêt du service :
| Fichier | Rôle | Action |
|---|---|---|
coordinator_backup.json |
Sauvegarde des informations du coordinateur | Copier hors du dossier de données |
database.db |
Base des appareils appairés | Copier avant tout arrêt du service |
configuration.yaml |
Configuration de Zigbee2MQTT | Copier et conserver une version lisible |
Arrêtez Zigbee2MQTT seulement après avoir vérifié la présence des trois fichiers dans une copie. Vérifiez aussi leur taille : un fichier vide signale une sauvegarde incomplète.
Migrer avec ZHA
ZHA, l’intégration Zigbee native de Home Assistant, permet de transférer un réseau Zigbee existant vers un nouveau coordinateur directement depuis l’interface, sans passer par des fichiers de configuration. La migration se déclenche depuis les paramètres de l’intégration. Le coordinateur est la clé USB ou le module qui relie le réseau Zigbee à Home Assistant, et c’est lui qui doit être remplacé.
Le principe est de brancher le nouveau coordinateur sur l’hôte avant de lancer la migration, puis d’indiquer à ZHA de reprendre le réseau existant sur ce nouveau matériel.
Parcours dans l’interface
| Étape | Action | Emplacement |
|---|---|---|
| 1 | Brancher le nouveau coordinateur sur l’hôte Home Assistant | Port USB de l’appareil qui fait tourner Home Assistant |
| 2 | Ouvrir l’intégration ZHA | Paramètres > Appareils et services > ZHA |
| 3 | Cliquer sur Configurer | Page de l’intégration ZHA |
| 4 | Ouvrir les paramètres réseau | Paramètres réseau |
| 5 | Sélectionner Migrer l’adaptateur | Paramètres réseau |
| 6 | Choisir l’option Migrate Automatically | Fenêtre de migration |
Ordre des opérations
Le branchement précède la migration. L’option Migrate Automatically doit être choisie une fois que le nouveau coordinateur est détecté par le système. Si le matériel n’est pas branché au moment de l’étape 5, la migration ne peut pas le cibler.
Migrer avec Zigbee2MQTT
Avec Zigbee2MQTT, la migration vers un nouveau coordinateur ne passe par aucun assistant graphique : elle repose sur des modifications manuelles du fichier configuration.yaml. Selon SmartHomeScene (décembre 2025), la séquence est la suivante : arrêter Zigbee2MQTT, copier l’adresse IEEE de l’ancien coordinateur vers le nouveau, vérifier pan_id et ext_pan_id, mettre à jour le port serial, puis redémarrer le service. L’ordre compte. Toute modification effectuée pendant que Zigbee2MQTT tourne peut être écrasée au prochain enregistrement de la configuration, ou bien le service peut tenter d’accéder au coordinateur pendant sa reconfiguration.
Arrêter Zigbee2MQTT avant toute modification
Arrêtez le service avant d’ouvrir le fichier de configuration. Selon le mode d’installation, cela passe par le bouton d’arrêt de l’add-on Zigbee2MQTT dans Home Assistant, par la commande systemctl stop zigbee2mqtt sous Linux, ou par l’arrêt du conteneur Docker correspondant. Vérifiez ensuite dans les journaux que le service n’est plus actif. Un port serial encore occupé par Zigbee2MQTT empêche le nouveau coordinateur d’être ouvert au redémarrage.
Copier l’adresse IEEE de l’ancien coordinateur
L’adresse IEEE identifie le coordinateur de façon unique sur le réseau Zigbee. Relevez-la sur l’ancien coordinateur, puis reportez-la dans la configuration du nouveau. La saisie doit être exacte, caractère par caractère : une seule erreur empêche le nouveau coordinateur de reprendre l’identité de l’ancien. Relisez la valeur après copie, en la comparant à la source, avant de redémarrer.
Vérifier pan_id, ext_pan_id et le port serial
Les valeurs pan_id et ext_pan_id déterminent si le nouveau coordinateur reprend le réseau existant ; le port serial sert seulement à joindre le nouveau matériel.
| Paramètre | Emplacement dans la configuration | Action |
|---|---|---|
pan_id |
Section advanced |
Doit être identique à celui de l’ancien réseau |
ext_pan_id |
Section advanced |
Doit être identique à celui de l’ancien réseau |
| Port serial | Section serial |
Doit pointer vers le nouveau coordinateur |
Les valeurs pan_id et ext_pan_id sont l’identité du réseau : si elles changent, les appareils ne reconnaissent plus le réseau et doivent être réappairés. Pour le port serial, le chemin peut changer quand le périphérique est branché sur un autre port USB. Sous Linux, la liste des périphériques stables s’obtient avec ls /dev/serial/by-id/. Sur macOS et Windows, le nom de port est affiché par le système ou par le gestionnaire de périphériques.
Une fois l’adresse IEEE, pan_id, ext_pan_id et le port serial vérifiés, redémarrez Zigbee2MQTT et contrôlez dans les journaux que le coordinateur est bien détecté.
Que faire si des appareils ne répondent plus après une migration ?
Après une migration, un appareil Zigbee absent ou inactif ne signifie pas forcément que l’opération a échoué. Selon SmartHomeScene (décembre 2025), les appareils peuvent mettre jusqu’à une heure environ à se reconnecter après une migration ZHA. Pendant ce délai, un appareil peut rester hors ligne sans défaut matériel. Le diagnostic doit donc commencer après cette fenêtre, et non dès les premières minutes.
Les trois phases à distinguer
| Phase | Durée indiquée | Comportement attendu |
|---|---|---|
| Reconnexion des appareils | jusqu’à une heure environ | Les appareils rejoignent progressivement le nouveau coordinateur |
| Rééquilibrage du réseau | jusqu’à 24 h | Le réseau recalcule ses chemins entre coordinateur, routeurs et appareils |
| Valeurs LQI | pendant tout le rééquilibrage | Les indicateurs de qualité de liaison sont inexacts |
Interpréter le LQI avec prudence
Le LQI (Link Quality Indicator) reflète la qualité du lien radio entre deux appareils. Pendant le rééquilibrage, ses valeurs ne sont pas fiables : un LQI faible ou incohérent n’indique pas nécessairement un problème de portée. Évitez donc de déplacer un capteur, d’ajouter un répéteur ou de conclure à une panne en vous basant sur ces chiffres avant la fin de la période de 24 h.
Méthode de diagnostic
- Attendre l’heure indiquée avant toute action corrective.
- Vérifier l’alimentation des appareils secteur (prises, interrupteurs, ampoules), qui servent de routeurs. Un routeur éteint peut isoler plusieurs appareils.
- Contrôler les appareils sur pile, qui ne relaient pas les messages : leur absence peut venir de leur propre pile ou de leur éloignement du routeur le plus proche.
- Observer l’évolution sur 24 h. Un appareil qui revient progressivement pendant cette période suit le comportement normal du réseau.
- Ne réappairer qu’en dernier recours. Si l’appareil reste hors ligne après la fenêtre de 24 h et que les vérifications ci-dessus sont négatives, consultez la notice du fabricant avant toute remise en inclusion.
Quelles limites selon les puces ?
La migration d’un coordinateur Zigbee sans réappairage dépend de la famille de puce utilisée, et Zigbee2MQTT ne la traite pas de la même façon selon les familles. Selon SmartHomeScene (2025-12-08), la sauvegarde et la restauration ne sont prises en charge officiellement que pour les familles zstack et ember. Pour les familles ConBee, EZSP, ZBOSS et ZiGate, la sauvegarde et la restauration ne sont pas prises en charge officiellement par Zigbee2MQTT : une migration vers l’un de ces coordinateurs ne garantit donc pas que vos appareils conservent leur appairage.
Familles prises en charge et non prises en charge
| Famille ou puce | Sauvegarde et restauration officielles dans Zigbee2MQTT | Conséquence pour la migration |
|---|---|---|
| zstack | Prises en charge | Migration sans réappairage envisageable dans le cadre officiel |
| ember | Prises en charge | Migration sans réappairage envisageable dans le cadre officiel |
| ConBee, EZSP, ZBOSS, ZiGate | Non prises en charge | Réappairage possible, sans garantie de conservation |
Ce tableau ne préjuge pas de la réussite d’une migration. Il indique seulement le cadre dans lequel le projet Zigbee2MQTT la documente.
Passage entre zstack et ember
Un changement de famille, de zstack vers ember ou l’inverse, n’est pas officiellement supporté. Selon SmartHomeScene (2025-12-08), ce passage peut obliger à réappairer certains appareils. Il ne faut donc pas le considérer comme une migration transparente, même si les deux familles sont prises en charge individuellement.
Sauvegarde ZHA et périmètre des données
Avant une migration, identifiez précisément quelles données sont protégées et lesquelles ne le sont pas.
Questions fréquentes
Faut-il réappairer les appareils Zigbee après un changement de coordinateur ?
Non, à condition de transférer l’ensemble du réseau vers le nouveau coordinateur plutôt que de ré-enregistrer chaque appareil. Le réappairage peut redevenir nécessaire si le réseau n’est pas restauré à l’identique ou si la famille de puces change, notamment pour ConBee, EZSP, ZBOSS ou ZiGate, qui ne bénéficient pas de la prise en charge officielle de la sauvegarde par Zigbee2MQTT.
Quel rôle jouent pan_id, ext_pan_id et le port série dans Zigbee2MQTT ?
Les valeurs pan_id et ext_pan_id déterminent si le nouveau coordinateur reprend le réseau existant, tandis que la clé réseau (network_key) doit rester identique. Le port série sert uniquement à joindre le matériel et n’influe pas sur l’identité du réseau. Vérifiez ces éléments dans le fichier de configuration avant de redémarrer le service.
Combien de temps attendre avant de conclure qu’un appareil ne répond plus ?
Avec ZHA, l’attente se compte en heures : comptez environ une heure pour la reconnexion, puis surveillez le rééquilibrage pendant jusqu’à 24 h. Si l’appareil reste absent passé ce délai, vérifiez dans les journaux de Home Assistant que le nouveau coordinateur est actif et que l’appareil figure toujours dans l’intégration ZHA. Avec Zigbee2MQTT, aucun délai n’est précisé : consultez la documentation officielle du projet avant de conclure.
