Découverte du dongle USB Z-Wave+ série 800 Zooz ZST39 sous Home Assistant

Le contrôleur USB Zooz ZST39 série 800 est un adaptateur Z-Wave+ longue portée pour les systèmes domotiques tel que Home Assistant. Il offre une connectivité stable et fiable pour un large éventail d’appareils Z-Wave. Cet article, a pour but de vous guider à travers les étapes d’installation dans Home Assistant à l’aide des intégrations Z-Wave JS et Z-Wave JS UI.

Présentation du contrôleur Zooz ZST39

Imaginez une maison intelligente où vos lumières s’allument automatiquement lorsque vous franchissez la porte, où le thermostat s’ajuste pour vous offrir un confort optimal et où vos serrures se verrouillent automatiquement lorsque vous quittez la maison.

Le contrôleur USB Zooz ZST39 série 800 rend tout cela possible en ajoutant à votre box domotique, la possibilité d’intégrer des modules fonctionnant en Z-Wave. Cette petite clé discrète se branche simplement sur un port USB et vous permet de contrôler une large gamme d’appareils Z-Wave, notamment :

• Ampoules intelligentes
• Thermostats intelligents
• Serrures intelligentes
• Détecteurs de mouvement
• Commutateurs intelligents
• Et bien plus encore

La clé USB est livrée bien protégée dans son carton format réduit, avec son manuel d’utilisation (vous pouvez aussi le retrouver ici). Le contrôleur est très simple en apparence avec son petit format et sa couleur noire.

Voici les caractéristiques principales du contrôleur USB ZOOZ ZST39 série 800 :

• Portée longue distance : Il couvre une portée allant jusqu’à 300 mètres en champ libre, idéal pour les grandes maisons ou les configurations complexes.
• Sécurité S2 : Il intègre la dernière norme de sécurité Z-Wave, S2, garantissant une communication protégée contre le piratage et les interférences.
• Facilité d’utilisation : Il se distingue par sa simplicité d’installation et d’utilisation. Il suffit de le brancher sur un port USB de votre box domotique exécutant par exemple Home Assistant et de suivre les instructions à l’écran.
• Compatibilité : Il est compatible avec une large gamme de logiciels domotiques, tels que Home Assistant, Jeedom…
• Fonction SmartStart : Il facilite l’inclusion de nouveaux périphériques Z-Wave sur votre réseau grâce à la fonction SmartStart. Voici comment fonctionne SmartStart :
  • Association simplifiée : Traditionnellement, l’ajout d’un appareil Z-Wave implique de mettre le contrôleur et l’appareil dans un « mode inclusion » spécifique, puis de saisir manuellement un code de sécurité. SmartStart élimine cette étape.
  • Codes de sécurité préconfigurés : Les appareils compatibles SmartStart sont livrés avec un code de sécurité unique intégré lors de leur fabrication. Ce code est partagé en toute sécurité avec le contrôleur pendant le processus d’inclusion, éliminant le besoin de saisie manuelle.
  • Inclusion plus rapide : Avec SmartStart, le contrôleur peut identifier automatiquement l’appareil et son code de sécurité, rationalisant le processus d’inclusion et réduisant le temps nécessaire pour ajouter de nouveaux appareils à votre réseau.
  • Sécurité améliorée : Bien que SmartStart simplifie l’association, cela ne compromet pas la sécurité. Les codes pré-chargés sont uniques à chaque appareil et échangés en toute sécurité pendant le processus d’inclusion.

Installation

Pour utiliser le contrôleur Zooz ZST39 série 800 sur Home Assistant, vous devez d’abord installer l’intégration Z-Wave JS qui permet de contrôler et configurer des périphériques Z-Wave. Sur Home Assistant, il existe deux possibilités pour installer Z-Wave JS :

• La première, la plus simple, est d’utiliser l’intégration par défaut de Home Assistant et de vous laisser guider. L’inconvénient de cette solution, c’est que vous avez peu de contrôle sur votre réseau Z-Wave et sur la configuration de votre clé USB.
• La deuxième, celle que l’article détaillera, est d’utiliser Z-Wave JS UI en plus de l’intégration par défaut de Home Assistant.

Tout d’abord, vous devez avoir installé HACS dans votre Home Assistant. Si ce n’est pas le cas, je vous invite à vous référer à la documentation présente ici avant de commencer.

Une fois HACS installé, cliquez sur l’entrée HACS dans le menu de gauche, puis sur « Modules complémentaires ».

À présent, cliquez sur « Boutique des modules complémentaires » puis rechercher « Z-Wave JS UI » et installez-le.

Une fois installé, assurez-vous que les options « Lancer au démarrage », « Chien de garde » et « Afficher dans la barre latérale » sont cochées, puis cliquez sur démarrer.

Maintenant, nous pouvons passer à la partie configuration du contrôleur Zooz ZST39 série 800. Pour cela, cliquez sur « Ouvrir l’interface utilisateur web » puis rendez-vous dans « Settings » grâce au menu (trois tiret l’un en dessous de l’autre) en haut à gauche à côté de « Control Pannel ».

À présent, déroulez la partie Z-Wave, puis sélectionner votre clé USB dans « Serial Port ». Si votre clé USB n’apparaît pas, assurez-vous de l’avoir branchée correctement et de l’avoir montée correctement si vous utilisez une machine virtuelle. Ensuite, il faut générer les « Security Keys » et « Security Keys (Long Range) » en cliquant sur toutes les doubles flèches en cercle (si un message rouge apparaît, recommencez une nouvelle fois). Attention à bien sauvegarder ces clés, car elles seront nécessaires si vous devez restaurer votre réseau Z-Wave. Pour finir cette étape, cliquez sur « Save » tout en bas de l’écran.

Pour vérifier la configuration, rendez-vous à nouveau sur le « Control Panel » via le menu en haut à gauche. Si cela a fonctionné, vous devriez voir apparaitre votre premier « Node » correspondant à votre contrôleur USB.

L’installation et la configuration de Z-Wave JS UI est maintenant terminée. Il faut désormais ajouter l’intégration Z-Wave dans Home Assistant. Pour cela, rendez-vous dans les paramètres de Home Assistant puis « Appareils et services » puis cliquez sur « Ajouter une intégration » en bas à droite de votre écran.

Il faut ensuite rechercher l’intégration Z-Wave dans la liste puis cliquez dessus pour accéder à ses paramètres d’installation. Dans le premier écran, il faut décocher « Utiliser le module complémentaire Z-Wave Js du Supervisor ». Dans le deuxième écran, il faut renseigner l’adresse « ws://a0d7b954-zwavejs2mqtt:3000 ». Enfin, sur le dernier écran, il faut renseigner la pièce de l’intégration.

Vous avez à présent terminé l’installation de votre contrôleur Z-Wave+ Zooz ZST39 série 800 dans Home Assistant. Sur la page de l’intégration, vous retrouvez pour le moment les informations et actions principales de votre réseau Z-Wave.

Ajouter des modules

Passons maintenant à la partie la plus intéressante, qui consiste à ajouter l’ensemble de vos modules Z-Wave à Home Assistant.

Au passage, j’en profite pour vous partager en bas de l’article, l’ensemble des modules que j’utilise (certains depuis plusieurs années). Je considère ces modules comme très fiables et ils permettent une variété très complète de scénarios pour votre maison connecté.

Pour ajouter un module, il faut se rendre dans Z-Wave JS UI, puis cliquez sur le bouton bleu en bas à droite de votre écran, puis sur le bouton vert (signe infini) qui apparait.

Dans la fenêtre qui apparaît, choisissez « Inclusion » puis cliquez sur « Next ». Saisissez à présent un nom et une pièce pour votre module. Ces informations, modifiables ultérieurement, seront utilisées dans l’intégration Home Assistant et serviront de base pour l’id de vos entités. Cliquez ensuite sur « Next ».

Sur ce nouvel écran, vous pouvez choisir le niveau de sécurité à utiliser pour inclure votre module. Je vous conseille de rester sur « Default » et de laisser Z-Wave JS gérer cela pour vous. Cliquez sur « Next » puis réveillez votre module (via un triple clique ou autre en fonction de votre module) puis attendez que Z-Wave JS ajoute votre module dans Home Assistant.

Si l’intégration est réussie, vous devriez obtenir l’écran de confirmation ci-dessous.

Configuration des modules

Maintenant que votre module a été ajouté, vous pouvez le retrouver dans l’intégration Z-Wave de Home Assistant que nous avons ajouté précédemment.

Dans la page du module, on retrouve l’ensemble des entités disponibles pour le module avec les états courants. Au milieu à gauche, vous retrouvez également un bouton « Configurer » qui permet d’accéder à l’ensemble des réglages possible pour votre module. Il vous suffit de rentrer les valeurs souhaitées pour qu’elles soient directement appliquées sur votre module s’il s’agit d’un module alimenté ou après un réveil pour les modules sur batterie.

Sur la page du module, à côté du bouton « Configurer », en cliquant sur les trois petits points, vous avez aussi accès à plusieurs fonctionnalités intéressantes :

• Réinterrogation : permet de réinterroger le module pour qu’il renvoie l’ensemble de sa configuration et des entités disponibles. Cela peut être utile lorsqu’il y a eu une inclusion partielle
• Reconstruire les routes : permet de demander à votre module d’optimiser sa route pour joindre votre contrôleur. Comme vous le savez, le réseau Z-Wave est un réseau maillé et donc chaque module alimenté électriquement peu servir de relais aux autres modules pour avoir la meilleure connexion possible.
• Supprimer l’appareil défaillant : comme son nom l’indique, cela permet de supprimer un module quand celui-ci ne répond plus et que vous ne pouvez pas l’exclure normalement
• Statistiques : affiche des statistiques d’utilisation de votre module
• Mise à jour : permet d’installer manuellement un firmware pour votre module
• Télécharger les diagnostics : permet de récupérer des informations de diagnostics
• Supprimer : permet de supprimer le module de l’intégration Z-Wave mais celui-ci sera toujours présent sur votre réseau Z-Wave

Voilà, vous pouvez à présent utiliser pleinement vos modules Z-Wave dans Home Assistant grâce à la clé USB Zooz ZST39 série 800.

A noter, que de nombreuses autres fonctions sont possibles avec Z-Wave JS UI, comme la visualisation du votre réseau Z-Wave, l’optimisation des routes pour joindre votre contrôleur, l’exclusion de module… Pour cela, n’hésitez pas à consulter la documentation officielle présente ici.

Conclusion