Même un réseau Z-Wave bien conçu peut présenter des problèmes : appareils qui ne répondent plus, latences élevées, échecs de communication. Ce chapitre vous donne tous les outils pour diagnostiquer et résoudre les problèmes les plus courants.
La carte du réseau mesh dans ZWave JS UI
ZWave JS UI propose une visualisation graphique de votre réseau mesh Z-Wave. Pour y accéder : menu principal > Mesh Graph (icône réseau). Cette carte montre :
- Tous les nœuds de votre réseau (hub, appareils mains secteur, appareils batterie)
- Les connexions établies entre nœuds (les routes de communication)
- La force du signal entre chaque paire de nœuds (RSSI et LWR — Last Working Route)
- Les nœuds marqués en rouge ou orange (problèmes détectés)
Problèmes courants et solutions
| Problème | Cause probable | Solution |
| Appareil marqué ‘Dead’ | Pas de courant, panne matérielle, hors portée | Vérifier l’alimentation. Heal du nœud. Re-inclure si nécessaire. |
| Appareil ne répond plus (sleeping) | Batterie déchargée ou appareil trop loin | Changer la batterie. Améliorer le mesh avec des relais. |
| Latence élevée (> 2 s) | Route de communication trop longue, mauvais RSSI | Heal du nœud. Ajouter des relais intermédiaires. |
| Entités non créées après inclusion | Interview incomplet | Forcer un re-interview (ZWave JS UI > Re-interview node) |
| Appariement S2 échoue | DSK incorrect ou mauvaise procédure d’appui | Recommencer avec le bon DSK. Vérifier la notice du produit. |
| Valeurs incorrectes ou nulles | Firmware ancien sur l’appareil | Mettre à jour le firmware OTA si disponible |
| Hub Z-Wave ne démarre pas | Port série incorrect ou conflit USB | Vérifier /dev/serial/by-id. Essayer un autre port USB. |
Le Heal Network
Le ‘Heal Network’ (ou Network Heal) est l’opération qui demande à chaque nœud de recalculer ses routes de communication. C’est l’équivalent d’un ‘défragmentation’ de votre réseau Z-Wave. À effectuer :
- Après avoir ajouté de nouveaux appareils mains secteur (nouvelles routes possibles)
- Après avoir déplacé des appareils
- Quand vous observez des latences élevées
- Une fois par mois en maintenance préventive
⏰ Effectuez le heal la nuit
Le heal network peut prendre 5 à 30 minutes selon la taille du réseau.
Pendant le heal, certains appareils peuvent être temporairement non réactifs.
Programmez le heal à 3h00 du matin via une automatisation HA :
service: zwave_js.heal_network
# ou pour un nœud spécifique :
service: zwave_js.heal_node
target:
device_id: DEVICE_IDMettre à jour le firmware des appareils Z-Wave (OTA)
Les appareils Z-Wave 700/800 récents supportent les mises à jour de firmware en OTA (Over-The-Air), directement depuis ZWave JS UI, sans démonter l’appareil. Cette fonctionnalité est encore en déploiement progressif selon les fabricants.
- Dans ZWave JS UI, cliquez sur un nœud
- Onglet ‘OTA Firmware Update’
- Si une mise à jour est disponible, un bouton ‘Update’ apparaît
- Cliquez ‘Update’ et attendez la progression (2 à 15 minutes selon l’appareil)
- L’appareil redémarre automatiquement avec le nouveau firmware
Sauvegarder et restaurer le réseau Z-Wave
La sauvegarde de votre configuration Z-Wave est cruciale. En cas de panne du serveur ou de migration vers un nouveau matériel, vous devrez restaurer votre réseau sans ré-exclure et ré-inclure tous les appareils.
Sauvegarde automatique Home Assistant
Les sauvegardes complètes de Home Assistant (Paramètres > Système > Sauvegardes) incluent la base de données ZWave JS UI et les clés de réseau. Planifiez une sauvegarde automatique quotidienne.
Sauvegarde manuelle des clés
En plus des sauvegardes HA, sauvegardez manuellement vos clés de réseau Z-Wave (S2 et S0) dans un gestionnaire de mots de passe. Sans ces clés, même avec une sauvegarde complète, vos appareils sécurisés S2 devront être ré-inclus.
Migration du hub Z-Wave
Si vous changez de dongle Z-Wave (ex : Aeotec → Zooz 800LR), la migration est possible sans ré-inclusion :
- Exportez la configuration NVM (Non-Volatile Memory) depuis ZWave JS UI > Controller > Backup NVM
- Débranchez l’ancien dongle et branchez le nouveau
- Dans ZWave JS UI avec le nouveau dongle, cliquez sur Controller > Restore NVM
- Importez le fichier NVM exporté
- Le nouveau dongle hérite de l’identité réseau complet (Home ID, Node IDs, routes)
