Installer Z-Wave sur Home Assistant avec ZwaveJS2Mqtt

Tutoriel d'installation de Z-Wave sur Home Assistant OS

Après voir vu hier comment installer Zigbee2MQTT sur Home Assistant simplement, nous allons continuer à améliorer notre installation domotique en lui ajoutant le protocole Z-Wave. En effet, si le ZigBee tend peu à peu à s’imposer dans nos maisons connectées, le protocole domotique roi demeure toujours le très efficace Z-Wave que nous allons intégrer très simplement sur Home Assistant avec ZwaveJS2MQTT.

[toc]

Utiliser le protocole Z-Wave avec Home Assistant

Tout comme le ZigBee, Home Assistant devient peu à peu la référence des systèmes domotiques open source. Fort d’une équipe dynamique et d’une communauté mondiale particulièrement active, Home Assistant OS prend en charge quasiment tous les protocoles du marché et notamment le Z-Wave.

Z-Wave, c’est quoi ?

Créé en 1999 par la société danoise Zensys et racheté en 2018 par Silicon Labs, le Z-Wave est un protocole de communication sans fil permettant de connecter des appareils sur un réseau local maillé.

Ce protocole présente plusieurs avantages :

  • une excellente portée : le protocole Z-Wave utilise la bande des 868 MHz et fonctionne en réseau maillé. Comme vous le savez, plus la fréquence est basse, plus la portée est importante. C’est inversement proportionnel. Cette portée est, par ailleurs, étendue grâce à un maillage réseau capable de prendre en charge un grand nombre d’appareils. On lit souvent qu’il se limite à 232 appareils, mais il peut théoriquement en compter 28 soit 256.
  • une sensibilité réduite aux interférences : c’est le second avantage de la bande des 868 MHz qui est bien moins sollicitée que les 2.4 GHz du Wi-Fi / ZigBee / Bluetooth…
  • une faible latence : avec des messages de quelques octets seulement, le protocole Z-Wave est particulière rapide malgré sa vitesse de transmission de 100 kbit/s maximum.
  • une faible consommation : grâce à des messages très légers et à une gestion de l’énergie maitrisée, le Z-Wave ne consomme presque rien. Ainsi, de petits capteurs peuvent tenir 3 à 5 ans avec une simple pile. Certains interrupteurs sont même sans fil et capables de se contenter de l’énergie cinétique générée lors de leur utilisation.
  • une sécurité accrue :  Z-Wave S2 utilise un échange de clés asymétriques qui implique une clé publique et une clé privée. Toute commande peut être chiffrée à l’aide de la clé publique, mais seule la clé privée peut la déverrouiller. Grâce à cette méthode, déchiffrer une clé est pratiquement impossible, c’est d’ailleurs la raison pour laquelle des alarmes connectées telles que Ring Alarm V2 utilisent ce protocole.
  • compatibilité Matter à venir : à l’instar du ZigBee, le Z-Wave sera prochainement compatible Matter et donc avec un grand nombre d’objets connectés. En attendant, nous allons d’ailleurs voir comme il peut fonctionner avec MQTT…

Pré-requis

Vous ne serez pas surpris d’apprendre que vous devez évidemment avoir une installation Home Assistant sur Raspberry Pi, Odroid, NUC ou NAS. En ce qui nous concerne, nous allons utiliser une machine virtuelle Home Assistant sur NAS Synology.

D’un point de vue hardware, il vous faudra évidemment un dongle Z-Wave. Nous avons utilisé un Aeotec Z-Stick gen5 (ZW090) réputé pour son efficacité, mais vous pouvez en choisir un autre évidemment.

Voici quelques modèles compatibles Home Assistant chez notre partenaire Domadoo :

Que vous retrouverez évidemment aussi chez Amazon :

51,40€
65,56€
En Stock
5 neufs à partir de 51,40€
Le 13 octobre 2024 15 h 50 min
Amazon.fr

Nous allons installer Z-Wave JS to MQTT car nous utilisons déjà un broker Mosquitto MQTT et Zigbee2MQTT sur Home Assistant. Vous en aurez besoin pour ce qui va suivre et nous vous invitons à consulter les tutoriels ci-dessous le cas échéant.

À LIRE :
Tutoriel : installer Mosquitto MQTT sur NAS Synology
À LIRE :
Tutoriel : installer Mosquitto MQTT sur Raspberry Pi

Notez que vous pouvez néanmoins choisir de ne pas utiliser MQTT et vous contenter de l’intégration Z-Wave JS qui vous sera d’ailleurs proposée dès que vous aurez connecté votre dongle, auquel cas vous pouvez passer directement au point 19 de notre tutoriel.

A vous de voir si vous souhaitez, ou non, utiliser un broker, mais si vous êtes des nombreux lecteurs qui nous suivent fidèlement – et que nous remercions chaleureusement – sachez que nous aurons besoin de cette intégration dans de futurs tutoriels de domotique DIY.

Installer Z-Wave JS to MQTT sur Home Assistant

La première des choses à faire est évidemment de connecter votre dongle à un port USB de votre box domotique Home Assistant. En ce qui nous concerne, nous allons utiliser le contrôleur Aeotc Z-Stick Gen5 sur un hub USB branché notre NAS Synology DS920+.

Nous allons maintenant procéder à l’installation de Z-Wave JS to MQTT afin de remonter les informations à notre broker Mosquitto MQTT. La procédure peut vous paraître un peu longue car nous vous guidons clic après clic, mais rassurez-vous, elle n’a absolument rien de compliqué.

  1. Ouvrez Home Assistant (http://homeassistant.local:8123/) ;
  2. Allez dans le Superviseur ou Paramètres ;
  3. Cliquez sur Modules complémentaires  et accédez à la Boutique des modules complémentaires via le bouton situé en bas à droite ;
  4. Recherchez « Z-Wave » et cliquez sur Z-Wave JS vers MQTT ;
  5. Cliquez sur Installer et attendez 2 à 3 minutes que l’installation se termine ;
  6. Faites « Démarrer », patientez quelques secondes, puis appuyer sur le bouton « Ouvrir l’interface utilisateur web » ;
  7. Allez dans Menu > Settings (la roue crantée) et développez l’onglet Z-Wave ;
  8. Dans Serial Port, sélectionnez /dev/ttyACM0 ;
  9. En dessous, vous trouvez 4 champs avec des clés, cliquez sur les boutons d’actualisation pour générer les clés de sécurité aléatoires pour S0 Legacy, S2 Authenticated, S2 Unauthenticated et S2 Access control ;
  10. Cliquez sur Enregistrer en bas à droite ;
  11. Allez sur l’icône« 4 cases » situé tout en haut et vérifiez si le pilote a bien démarré correctement.
  12. Retournez dans Modules complémentaires ;
  13. Cliquez sur Z-Wave JS vers MQTT ;
  14. Consulter la Documentation du deuxième onglet ;
  15. Repérez une adresse de ce type : « ws://a0d7b954-zwavejs2mqtt:3000 » et copiez-la. Attention, cette adresse est seulement valable pour le dongle Aeotec Z-Stick Gen5 ;
  16. Allez dans Paramètres ou Supervisor > Appareils et services ;
  17. Puis sur le bouton + Ajouter l’intégration situé en bas à droite ;
  18. Recherchez Z-Wave JS ou cliquez ici (lien d’accès direct) et faites Configurer ;
  19. Décochez  « Utiliser le module complémentaire Z-Wave JS du Supervisor » et cliquez sur Soumettre ;
  20. Collez l’adresse du serveur Z-Wave copiée plus haut : ws://a0d7b954-zwavejs2mqtt:300 et confirmez en cliquant sur Soumettre ;
  21. Assignez votre dongle Z-Wave à la zone de votre choix et cliquez sur Terminer.
Votre dongle Z-Wave est maintenant configuré sur Home Assistant ! Il ne reste plus qu’à associer quelques appareils…

Appairage d’un appareil Z-Wave sur Home Assistant

Pour appairer un appareil, rien de plus simple, il vous suffit de vous rendre sur :

Supervisor ou Paramètres > Appareils et services > Z-Wave JS > + Ajouter un appareil

En quelques secondes, votre périphérique est associé et vous le retrouvez dans Home Assistant. Ici, nous avons choisi le nouveau capteur Zooz ZSE40-700 4-en-1 et nous retrouvons bien toutes ses entités : mouvement, luminosité, température et humidité.

En revenant sur l’interface de Z-Wave sur JS, nous retrouvons tous nos appareils :

Et comme sur Zigbee2MQTT, nous retrouvons un graphe de notre réseau :

Pour finir, tout est bien présent sur notre broker MQTT !

En conclusion, cette intégration peut paraître compliquée de prime abord, mais ZwaveJS2MQTT est finalement facile à mettre en œuvre et sacrément efficace. On aime la stabilité sans faille (ou presque) du Z-Wave, sa latence réduite et son excellente portée. Certes, les objets connectés utilisant ce protocole sont généralement plus chers, mais c’est le prix de la qualité et de la fiabilité. On recommande à tous les fans de domotique !

 

Fasciné par Alexa depuis le jour où je l'ai reçue en bêta test, je me suis peu à peu passionné pour le sujet, avant de me décider à aller plus loin en créant un site avec Jean-Christophe. Une activité qui me permet d'étancher ma soif de nouvelles technologies et de partager mes découvertes sur la plus sympathique des communautés : Les Alexiens.