Installer et configurer le Z-Wave sur Jeedom avec Z-Wave JS

Pour faire tourner le Z-Wave sur Jeedom en 2026, il faut le plugin Z-Wave JS, gratuit, et un contrôleur Z-Wave : une clé USB ou la radio intégrée d’une box Luna. L’ancien tutoriel de cette page reposait sur le plugin OpenZwave et recommandait une clé Aeotec de génération 5, deux choix que je ne ferais plus aujourd’hui. Je vous donne ici le plugin, la clé, l’installation, puis les réglages qui font un réseau stable.

Quel plugin Z-Wave installer sur Jeedom en 2026 ?

La réponse tient dans le Market lui-même. Relevé au 14 septembre 2026 :

La documentation de Jeedom présente Z-Wave JS comme le plugin officiel à privilégier. Il s’appuie sur la bibliothèque Z-Wave JS UI, très suivie, et fait transiter les échanges par le protocole MQTT. Pour vous, cela change deux choses : un second plugin s’installe avec lui, et les redémarrages du réseau deviennent instantanés une fois la première découverte des modules terminée.

Si vous hésitez encore entre Z-Wave et Zigbee pour démarrer, prenez le temps de lire notre comparatif des technologies domotiques. Mon conseil d’intégrateur ne change pas : une box, un protocole principal. Le Z-Wave coûte plus cher au module, mais sa bande de fréquence en 868 MHz ne partage pas l’encombrement du Wi-Fi en 2,4 GHz.

Quelle clé Z-Wave choisir pour Jeedom ?

Vous avez trois cas de figure. Si votre box est une Jeedom Luna, elle embarque déjà une radio Z-Wave 700 : aucun achat. Une box Atlas, livrée sans protocole radio, ou un mini-PC sous Debian demandent une clé USB. Et si vous possédez déjà une clé utilisée sous OpenZwave, gardez-la : Z-Wave JS reprend son réseau.

Pour un achat neuf, je privilégie une clé de série 800. La Home Assistant Connect ZWA-2 en fait partie. Son fabricant la dit compatible avec Z-Wave JS UI, le moteur du plugin Jeedom, en précisant qu’il faut alors régler à la main la région et la puissance d’émission. Elle sort réglée sur la région européenne par défaut, ce qui vous simplifie la tâche. Je n’ai pas trouvé de test de cette clé publié par Jeedom : considérez-la comme compatible par son moteur, pas comme validée par l’éditeur.

Elle gère aussi le Z-Wave Long Range, un réseau en étoile distinct du maillage classique, sur 864 et 866 MHz en Europe. Ne comptez pas dessus pour vos premiers modules : il faut des équipements compatibles, et le maillage classique suffit dans une maison.

Si vous comparez avec une box Z-Wave clé en main, notre comparatif des box Z-Wave vous aide à peser l’option d’une box dédiée.

Comment installer et démarrer le plugin Z-Wave JS ?

Installez le plugin depuis le Market, comme décrit dans notre guide d’installation d’un plugin Jeedom, puis suivez cet ordre :

1. Activez Z-Wave JS. Les dépendances démarrent seules et installent aussi le plugin MQTT Manager.
2. Patientez : la première installation compile Z-Wave JS UI et peut durer plusieurs dizaines de minutes.
3. Vérifiez que le démon de MQTT Manager est démarré. Sans lui, Z-Wave JS refuse de lancer le sien.
4. Dans la configuration, sélectionnez le port du contrôleur Z-Wave, le réglage que la documentation place en tête.
5. Laissez cochée l’option Appliquer la configuration recommandée, puis démarrez le démon.

Deux options méritent votre attention. Suppression des périphériques exclus retire automatiquement de Jeedom un module exclu du réseau : pratique, mais je la laisse décochée tant que je teste, pour ne perdre aucun équipement par erreur. Le préfixe MQTT, zwave par défaut, ne se touche que si vous partagez un broker avec d’autres systèmes.

Si vous partez d’une clé vierge, le réseau est prêt aussitôt. Avec une clé qui porte déjà des modules, le plugin les interroge un par un : ils apparaissent d’abord sous leur numéro de nœud, sans image, puis sont identifiés. Réveillez ensuite les modules à piles, ou attendez leur réveil. Le réseau n’est complet qu’à ce moment-là.

⚠️ Recopiez les clés de sécurité affichées par le plugin dès le premier démarrage, et rangez-les hors de la box. La documentation est sans ambiguïté : si vous les perdez, chaque module inclus en mode sécurisé est à réappairer, serrures et motorisations comprises.

Comment inclure vos modules et régler leur sécurité ?

Le bouton Inclusions de la page du plugin bascule le contrôleur en mode inclusion, par défaut, S0 ou S2, ou en mode exclusion. Pour un module qui refuse de s’inclure, ou qui a déjà servi sur une autre box, lancez d’abord une exclusion : elle le libère de son ancien réseau.

Sur la sécurité, les règles ont changé depuis l’époque d’OpenZwave. La documentation Z-Wave de Home Assistant, qui repose sur le même moteur, résume l’écart entre les deux générations de chiffrement. Le S0 ajoute beaucoup de trafic sur le maillage et ne se justifie que pour d’anciens modules qui l’exigent, comme certaines serrures. Le S2 n’alourdit pas le trafic et apporte d’autres garanties.

Un point à connaître côté Jeedom : sa documentation indique que l’inclusion S2 n’est pas encore possible directement depuis le plugin, alors que le moteur la gère. En pratique, j’inclus l’éclairage, les prises et le chauffage en mode par défaut, et je réserve le chiffrement aux ouvrants.

Une fois inclus, un module se règle depuis trois boutons de sa page. Valeurs liste toutes ses classes de commande, dont Configuration, qui porte ses paramètres : sous Z-Wave JS, il n’y a plus d’onglet de paramètres séparé. Nœud affiche son identification, ses statistiques et quelques actions techniques, que le plugin gère normalement seul. Groupe gère les associations directes entre modules, un sujet détaillé dans notre guide des groupes et associations Z-Wave.

Prenons trois modules courants. Une prise Fibaro Wall Plug se branche sans outil. Un micromodule de volet comme le Fibaro Roller Shutter 4 ou un Smart Implant se câblent derrière un interrupteur : ce travail se fait disjoncteur coupé, absence de tension vérifiée au testeur, et au moindre doute par un électricien.

Comment surveiller et fiabiliser le réseau maillé ?

Le bouton Réseau Z-Wave regroupe le diagnostic : résumé, actions, statistiques, graphique du réseau, table de routage et santé. Prenez l’habitude d’ouvrir le graphique après chaque ajout de module, il vous montre par où passent réellement les messages.

Les modules alimentés sur secteur relaient les messages des autres. Voici les réflexes qui gardent un maillage en forme :

• Installez vos modules sur secteur avant vos capteurs à piles, pièce par pièce en partant de la box.
• Limitez les rapports trop fréquents dans les paramètres : une prise qui envoie sa puissance en continu encombre le réseau pour rien.
• N’activez le polling, la communication forcée, que si le module ne sait pas faire autrement, ce qui n’arrive quasiment jamais selon la documentation.
• Consultez l’onglet santé avant de soupçonner un module : un nœud mort ou une pile vide s’y voit tout de suite.

Pour un capteur à piles, chaque message envoyé use la pile. Désactivez les mesures dont vous ne vous servez pas, luminosité ou température selon le modèle, et vous gagnerez des mois d’autonomie.

Le bouton Synchroniser crée dans Jeedom les équipements que le contrôleur connaît déjà. Il sert surtout avec les clés à batterie, comme l’Aeotec Z-Stick Gen5, capables d’inclure un module loin de la box.

Comment migrer depuis OpenZwave sans tout perdre ?

Bonne nouvelle, la documentation de Jeedom affirme qu’il n’existe aucun risque à faire cohabiter les plugins OpenZwave et Z-Wave JS pendant la bascule. Si Z-Wave JS vous pose problème, vous arrêtez son démon, relancez celui d’OpenZwave, et retrouvez votre réseau à l’identique.

La marche suit quatre temps. Arrêtez la gestion automatique puis le démon d’OpenZwave. Si vous aviez inclus des modules en mode sécurisé, saisissez dans Z-Wave JS la clé S0 qu’utilisait OpenZwave, donnée par la documentation : 0102030405060708090A0B0C0D0E0F10. Démarrez Z-Wave JS et laissez-le interroger tout le réseau. Testez chaque module, ce qui peut prendre plusieurs jours.

Ne supprimez aucun équipement OpenZwave avant la fin de ces essais, même désactivé. Quand tout répond, l’outil de remplacement d’équipements et de commandes du Core bascule vos équipements vers le nouveau plugin, et vos scénarios suivent.

Un module reconnu sous OpenZwave et mal géré sous Z-Wave JS ? Vérifiez d’abord dans Valeurs que ses données bougent quand vous l’actionnez. Une icône en forme de stylo, en bout de ligne, crée alors la commande manquante. Si cela ne suffit pas, le support demande la marque, la référence exacte et des captures des fenêtres Nœud et Valeurs.

FAQ sur Jeedom et le Z-Wave