L’inclusion (ou appairage) est le processus par lequel un appareil Z-Wave rejoint votre réseau. C’est une étape clé qui détermine le niveau de sécurité et la qualité de l’intégration. Z-Wave 700/800 propose plusieurs méthodes d’inclusion, du plus basique au plus sécurisé.
Les modes d’inclusion Z-Wave
| Mode | Sécurité | Comment | Recommandé ? |
| Inclusion non sécurisée | ⚠️ Aucune | Simple appui bouton — pas de chiffrement | Non — évitez sauf legacy |
| S0 (Security 0) | ⚠️ Faible | Inclus avec clé partagée statique (vulnérable) | Non — héritage Z-Wave 300/500 |
| S2 Unauthenticated | ✅ Bon | S2 sans vérification du DSK | Oui — appareils non-critiques |
| S2 Authenticated | ✅✅ Très bon | S2 + vérification DSK (5 chiffres) | Oui — la plupart des appareils |
| S2 Access Control | ✅✅✅ Excellent | S2 + DSK complet (25 chiffres) | Oui — serrures, alarmes |
| SmartStart (QR code) | ✅✅✅ Excellent | Scan QR code — S2 automatique | Oui — appareils récents 700/800 |
Inclure un appareil — Tutoriel pas à pas
Méthode recommandée : Inclusion S2 via ZWave JS UI
📍 Important : lieu d’inclusion
TOUJOURS inclure vos appareils Z-Wave à leur emplacement définitif (ou à moins de 2 m de leur position finale).
Si vous incluez dans la même pièce que le hub puis déplacez l’appareil, les routes réseau ne seront pas optimales et vous aurez des problèmes de communication.
Exception : les appareils mains secteur (prises, interrupteurs) — incluez-les en place définitive.
- Dans ZWave JS UI, cliquez sur le bouton ‘+ Add Node’ (icône +) dans la barre de navigation
- Sélectionnez ‘Secure Inclusion’ pour activer le mode S2
- ZWave JS UI affiche ‘Ready to include – press the button on your device’
- Sur votre appareil Z-Wave, effectuez la procédure d’inclusion (triple appui rapide sur le bouton, ou la procédure spécifique au fabricant — consultez la notice)
- L’appareil envoie une requête d’inclusion. ZWave JS UI détecte la demande de sécurité S2
- Une fenêtre apparaît demandant le DSK (Device Specific Key) — 5 premiers chiffres inscrits sur l’étiquette de l’appareil ou dans l’application du fabricant
- Saisissez les 5 chiffres et confirmez. L’échange de clés S2 est effectué
- L’appareil est maintenant inclus et apparaît dans la liste des nœuds Z-Wave
- Attendez que l’interview soit complète (statut ‘Ready’) avant de configurer
Méthode SmartStart (appareils Z-Wave 700/800)
SmartStart est la méthode d’inclusion la plus simple et la plus sécurisée pour les appareils récents. Elle ne nécessite pas de mode d’inclusion manuel :
- Dans ZWave JS UI, cliquez sur ‘SmartStart’
- Scannez le QR code Z-Wave imprimé sur l’appareil ou dans sa notice
- L’appareil est enregistré dans la liste SmartStart. Pas besoin d’actionner de bouton
- Branchez ou mettez sous tension l’appareil — il rejoint automatiquement le réseau avec S2
Exclure un appareil
Pour retirer un appareil de votre réseau Z-Wave (avant de le revendre, le remplacer ou le déplacer vers un autre réseau) :
- Dans ZWave JS UI, cliquez sur ‘− Remove Node’
- Effectuez la procédure d’exclusion sur l’appareil (souvent le même bouton que l’inclusion)
- L’appareil est retiré du réseau. Son ID de nœud est libéré
🔄 Réinitialisation d’usine
Si un appareil Z-Wave a été inclus dans un autre réseau et que vous ne pouvez pas l’exclure normalement (réseau inaccessible), faites une réinitialisation d’usine (factory reset).
La procédure varie selon les fabricants — consultez la notice de l’appareil.
Après un factory reset, l’appareil peut être inclus normalement dans votre réseau.
L’interview des appareils
Après l’inclusion, ZWave JS UI effectue automatiquement un ‘interview’ de l’appareil : il interroge tous ses Command Classes (fonctionnalités supportées), ses capacités, ses endpoints (canaux), et ses paramètres de configuration. Cette étape est indispensable pour que Home Assistant crée correctement toutes les entités.
L’interview peut durer de 30 secondes (appareils mains secteur proches du hub) à plusieurs minutes (appareils sur batterie qui dorment entre les échanges). Attendez le statut ‘Ready’ avant de commencer à utiliser l’appareil dans vos automatisations.
| Statut interview | Signification | Que faire ? |
| Included (not ready) | Vient d’être inclus, interview en cours | Attendre |
| Interviewing… | Interview en cours | Attendre (ne pas couper l’alimentation) |
| Ready | Interview terminé, appareil opérationnel | Vous pouvez configurer |
| Asleep | Appareil sur batterie en veille | Normal — il répondra à son réveil |
| Dead | Appareil ne répond plus | Voir chapitre 7 — Diagnostics |
| Failed | Echec de communication persistant | Voir chapitre 7 — Diagnostics |
