5.6 Configurer la clé USB Z-Wave sur Jeedom

Pour que votre boîte domotique Jeedom puisse communiqur avec les objets connectés qui utilisent le protocole Z-Wave, vous devez lui brancher une clé USB Z-Wave et configurer la boîte pour qu'elle la reconnaisse.

• Branchez la clé USB Z-Wave sur le Raspberry Pi.

• Vous devez maintenant vous assurer que la clé est reconnue par le Pi. En effet, il y a parfois des incompatibilités entre la clé et le Raspberry Pi 4. Si c'est le cas, une solution intéresante consiste à brancher la clé dans un hub USB qui, lui, sera branché au Pi.

  Pour vérifier si la clé est reconnue, lancez cette commande sur le Pi (notez que le premier caractère est un L minuscule) :

  Terminal du Raspberry Pi

  lsusb

  Si la clé est reconnue, vous obtiendrez une ligne qui la décrit.

  Résultat à l'écran

  Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub

  Bus 001 Device 007: ID 0658:0200 Sigma Designs, Inc. Aeotec Z-Stick Gen5n(ZW090) - UZB

  BUS 001 DEVICE 006: id 1A40:0101 Terminus Technology Inc. Hub

  Bus 001 Device 003: ID 413c:2003 Dell Computers Corp. Keyboard

  Bus 001 Device 002: ID 2109:3431 VIA Labs, Inc. Hub

  Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

  Selon le modèle de votre clé, vous pourriez aussi avoir Silicon Labs CP210x UART Bridge.
• Accédez à l'interface d'administration de Jeedom.
• Rendez-vous dans le menu Plugins / Gestion des plugins.
• Cliquez sur l'icône Market.

  

• Recherchez « Z-Wave ».

  

• Dans les résultats de recherche, choisissez Z-Wave, par Jeedom SAS puis effectuez l'installation stable.

  Note : si le plugin Z-Wave n'est pas disponible, essayez d'effectuer une mise à jour de Jeedom.

  

• Une fois l'installation complétée, acceptez de vous rendre sur la page de configuration du plugin. Vous pourrez retourner à la page de configuration plus tard à l'aide du menu Plugins / Gestion des plugins puis en cliquant sur l'icône Z-Wave.
• Si la clé est dans l'état inactif, cliquez sur le bouton Activer.

  

• Si vous ne réussissez pas à activer la clé, ceci peut dépendre d'une erreur de programmation du côté du plugin. Rendez-vous dans le menu Analyse / Logs / zwavejs pour voir les messages d'erreur. Si vous voyez un message du genre « file_exists(): Argument #1 ($filename) must be of type string, array given », suivez les instructions sur la fiche Activation de la clé Z-Wave : « file_exists(): Argument #1 ($filename) must be of type string, array given ».
• Dans la zone Dépendances, si vous voyez NOK, cliquez sur Relancer pour installer les dépendances manquantes.

  

  Armez-vous de patience, cette opération dure de longues minutes. Vous pourriez avoir l'impression que le processus est figé avant d'atteindre 100%. Par exemple, sur mon Jeedom, l'installation est restée figée à 11% pendant 13 longues minutes.

  

  Si l'opération échoue, vous pouvez trouver une trace des problèmes rencontrés en allant dans le menu Analyse / Logs / openzwave_update.

  Parfois, un simple redémarrage du Raspberry Pi permet de compléter l'opération avec succès.

• Plus bas dans ce même écran, configurez le port du contrôleur Z-Wave à Auto si cette option est disponible.

  Si l'option Auto n'est pas disponible :

  • Débranchez la clé USB Z-Wave du Raspberry Pi puis rebranchez-la.

  • Dans une fenêtre Terminal sur le Raspberry Pi ou via SSH, entrez cette commande :

    Terminal du Raspberry Pi

    dmesg | grep tty

    Résultat à l'écran

    pi@jeedom:~ $ dmesg | grep tty
    [ 0.000000] Kernel command line: coherent_pool=1M 8250.nr_uarts=0 snd_bcm2835.enable_compat_alsa=0 snd_bcm2835.enable_hdmi=1 video=HDMI-A-1:1680x1050M@60 smsc95xx.macaddr=D8:3A:DD:24:30:4D vc_mem.mem_base=0x3f000000 vc_mem.mem_size=0x3f600000 console=ttyS0,115200 console=tty1 root=PARTUUID=c764c245-02 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait
    [ 0.001837] printk: console [tty1] enabled
    [ 1.584526] fe201000.serial: ttyAMA0 at MMIO 0xfe201000 (irq = 36, base_baud = 0) is a PL011 rev2
    [ 5.314135] cdc_acm 1-1.3:1.0: ttyACM0: USB ACM device
    [ 159.584503] cdc_acm 1-1.3:1.0: ttyACM0: USB ACM device

  • Le port à utiliser apparaîtra sur la dernière ligne. C'est la valeur à choisir dans la liste déroulante vis-à-vis Port du contrôleur Z-Wave. Notez que si le port désiré n'apparaît pas dans la liste déroulante, vous pouvez essayer de régler la situation en enlevant le crochet vis-à-vis Soft Reset dans la zone Configuration. Vous devrez ensuite redémarrer Jeedom.

  N'oubliez pas de cliquer sur Sauvegarder.

• Après cette manipulation, vous devriez voir le statut OK dans la zone Démon. Au besoin, cliquez sur (Re)Démarrer.

  

  Si vous obtenez un message à propos du serveur MQTT (le plugin MQTT Manager a été installé par le plugin Z-Wave), suivez les instructions pour activer un serveur MQTT local ici : « Plugin MQTT Manager sous Jeedom ».

  Si vous n'arrivez toujours pas à obtenir le statut OK, vous pouvez consulter le log openzwave pour obtenir plus d'information. Au besoin, pour obtenir plus d'informations, ajustez le niveau de log à Debug dans la zone Logs et surveillance puis cliquez à nouveau sur Redémarrer.

• Quand le statut et la configuration sont à OK, votre boîte domotique est prête à se connecter avec des appareils Z-Wave.

Pour plus d'information

« Z-Stick Gen5 Utilitaire de sauvegarde ». La domotique de Nechry. https://nechry-automation.ch/2017/10/23/z-stick-gen5-utilitaire-de-sauvegarde/