Nous verrons dans ce nouveau tutoriel comment configurer votre clé Z-Wave Aeotec Z-Stick avec l’add-on Z-Wave JS to MQTT sur votre environnement domotique Home Assistant.
Le protocole Z-Wave en un coup d’oeil :
- Protocole sans fil standardisé – Z-Wave Alliance
- Le Z-Wave fonctionne sur les fréquences 868MHz (Europe), 908MHz (US) ou autres fréquences suivant les bandes ISM des régions.
- Utilise un réseau maillé (mesh)
- Portée d’environ 50 mètres (d’avantage en extérieur qu’en intérieur)
- Fonctionne de façon autonome et décentralisé ou bien centralisé avec une passerelle domotique
Prérequis, matériels et versions
Clé Z-Wave Aeotec Stick
Rallonge USB (Utile pour éviter les interférences en cas d’utilisation d’un autre protocole comme le Zigbee)
Configuration de la clé Z-Wave Aeotec Stick
Avec serveur MINI FORUM + Proxmox
Tout d’abord, branchez la clé USB Aeotec Z-Stick au niveau de votre serveur MINI FORUM, puis rendez-vous sur l’interface d’administration de Proxmox.
Depuis le serveur virtuel Home Assistant OS et l’onglet « Hardware », cliquez sur « Add » puis sur « USB Decice ».
Sélectionnez « Use USB Port » puis sélectionnez le port ou vous avez branché votre clé (pas d’affichage chez moi).
Rendez-vous cette fois-ci sur l’interface d’administration de Home Assistant puis redémarrer complètement Home Assistant. Vous pouvez également passer par Proxmox pour redémarrer la VM si vous le souhaitez.
Une fois redémarré, retournez sur Home Assistant dans la partie « System » pour vérifier que la clé USB est bien détectée.
La clé Aeotec Z-Stick apparait bien.
Vous pouvez garder de côté l’information « ttyACM0 ».
Configuration Add-on Z-Wave JS to MQTT
Nous allons maintenant configurer l’add-on Z-Wave JS to MQTT. Pour ce faire, rendez-vous dans la configuration de Home Assistant puis cliquez sur « Add-ons, Backups & Supervisor ».
Recherchez « Z-Wave JS to MQTT » puis cliquez sur l’add-on.
Cliquez sur « Install ».
Activez toutes les options puis cliquez sur « Start ».
L’add-on devrait maintenant apparaitre sur le menu de gauche. Cliquez dessus puis rendez-vous dans la configuration de cet add-on (la roue crantée).
Vérifiez que le port correspond bien à celui de votre clé USB Aeotec Z-Stick.
Pour finir, générez les 4 clés en cliquant sur chaque bouton (CF 3, 4, 5, 6).
Cliquez sur « Save ».
Retournez au niveau du menu principal de l’add-on et vérifiez que votre clé Aeotec Z-Stick est bien reconnue. Si c’est le cas, nous pouvons passer à la suite.
Intégration Z-Wave JS
Il faut maintenant configurer correctement l’intégration de l’add-on Z-Wave JS. Pour ce faire, rendez-vous dans le menu principal « Configuration » puis cliquez sur « Devices & Services ».
Cliquez en bas à droite sur « Add Integration » puis recherchez « Z-Wave JS ».
Décochez la case « Use the Z-Wave JS Supervisor add-on » puis cliquez sur « Submit ».
Copier l’URL suivante :
ws://a0d7b954-zwavejs2mqtt:3000
Puis cliquez sur « Submit ».
Cliquez sur « Finish ».
Les nouveaux « device » sont automatiquement découverts.
Par défaut lors de la première configuration, vous devriez retrouver votre clé Aeotec Z-Stick en cliquant sur « 1 device ».