Un ghost node (nœud fantôme) est l’un des problèmes les plus insidieux d’une installation Z-Wave. Il s’agit d’un appareil qui a été retiré physiquement — ou qui est irrémédiablement défaillant — sans avoir été correctement exclu du réseau. Il reste inscrit dans la table du contrôleur, consomme des ressources réseau et peut bloquer le routage d’autres appareils.
Comment reconnaître un ghost node ?
- Nœud visible dans l’interface mais en statut « mort », « déconnecté » ou « échec » en permanence.
- Le nœud n’a jamais de Last Working Route valide.
- Les tentatives de ping vers ce nœud échouent systématiquement.
- Le réseau tente régulièrement de joindre ce nœud, générant des erreurs dans les logs.
- Dans Z-Wave JS UI, le nœud apparaît en rouge et ne répond à aucune action.
⚠️ Un ghost node ne disparaît pas tout seul. Il faut impérativement le supprimer manuellement. Plus longtemps il reste, plus il dégrade les performances du réseau en occupant des ressources de routage.
Étape 1 — Confirmer qu’il s’agit bien d’un ghost node
- Dans Z-Wave JS UI, sélectionnez le nœud suspect.
- Cliquez sur « Ping Node ». Si la réponse est systématiquement « Failed », c’est un candidat ghost node.
- Vérifiez l’onglet « Node Info » : la dernière communication remonte à plusieurs jours ou semaines.
- Tentez un « Request Node Info » depuis l’interface : si l’opération time out, c’est confirmé.
Étape 2 — Suppression sur Z-Wave JS UI
- Sélectionnez le nœud fantôme dans la liste.
- Cliquez sur l’onglet « Actions ».
- Sélectionnez « Remove Failed Node » (et non « Exclude Node »).
- Confirmez l’opération. Z-Wave JS vérifie d’abord que le nœud ne répond pas, puis le retire de la table.
- Le nœud disparaît de l’interface.
- Lancez un Heal Network pour recalculer les routes sans ce nœud.
Suppression sur Jeedom
- Ouvrez le plugin Z-Wave > liste des équipements.
- Identifiez le nœud mort (icône rouge ou statut « Noeud mort »).
- Cliquez sur le nœud > onglet Actions > Supprimer le nœud.
- Si le bouton est grisé, essayez via le menu Actions globales > Supprimer nœuds morts.
Cas difficiles : ghost node qui résiste
Certains ghost nodes résistent à la suppression standard. Causes possibles et solutions :
| Problème | Cause | Solution |
| Bouton « Remove Failed » grisé | Le logiciel croit que le nœud est encore joignable | Attendre 24h que le nœud passe en statut « dead », réessayer |
| Erreur lors de la suppression | Incohérence dans la table de routage | Redémarrer le service Z-Wave, réessayer |
| Nœud réapparaît après suppression | Backup restauré automatiquement | Désactiver la restauration auto, supprimer puis sauvegarder NVM |
| Plusieurs ghost nodes simultanément | Panne majeure ou migration sans exclusion | Utiliser PC Controller pour un nettoyage de masse |
Prévention : éviter les ghost nodes
- Toujours exclure un appareil avant de le retirer physiquement ou de le remplacer.
- Si un appareil tombe en panne définitivement, procéder à une exclusion forcée depuis le logiciel.
- Maintenir un inventaire à jour de vos appareils Z-Wave avec leur numéro de nœud.
