Plugin OpenZWave

Ce plugin permet l’exploitation de modules Z-Wave par l’intermédiaire de la librairie OpenZwave.

Introduction

Z-Wave communique en utilisant une technologie radio de faible puissance dans la bande de fréquence de 868,42 MHz. Il est spécifiquement conçu pour les applications de domotique. Le protocole radio Z-Wave est optimisé pour des échanges à faible bande passante (entre 9 et 40 kbit/s) entre des appareils sur pile ou alimentés sur secteur.

Z-Wave fonctionne dans la gamme de fréquences sous-gigahertz, selon les régions (868 MHz en Europe, 908 MHz aux US, et d’autres fréquences suivant les bandes ISM des régions). La portée théorique est d’environ 30 mètres en intérieur et 100 mètres en extérieur. Le réseau Z-Wave utilise la technologie du maillage (mesh) pour augmenter la portée et la fiabilité. Z-Wave est conçu pour être facilement intégré dans les produits électroniques de basse consommation, y compris les appareils à piles tels que les télécommandes, les détecteurs de fumée et capteurs de sécurité.

Le Z-Wave+, apporte certaines améliorations dont une meilleure portée et améliore la durée de vie des batteries entre autres. La rétrocompatibilité est totale avec le Z-Wave.

Distances à respecter avec les autres sources de signaux sans fil

Les récepteurs radio doivent être positionnés à une distance minimum de 50 cm des autres sources radioélectriques.

Exemples de sources radioélectriques:

Tip

Si vous disposez un contrôleur USB (Z-Stick), il est recommandé de l’éloigner de la box à l’aide d’une simple rallonge USB de 1M par exemple.

La distance entre d’autres émetteurs sans fil tels que les téléphones sans fil ou transmissions radio audio doit être d’au moins 3 mètres. Les sources de radio suivantes doivent être prises en compte :

Epaisseur efficace des murs

Les emplacements des modules doivent être choisis de telle manière que la ligne de connexion directe ne fonctionne que sur une très courte distance au travers de la matière (un mur), afin d’éviter au maximum les atténuations.

introduction01

Les parties métalliques du bâtiment ou des meubles peuvent bloquer les ondes électromagnétiques.

Maillage et Routage

Les nœuds Z-Wave sur secteur peuvent transmettre et répéter les messages qui ne sont pas à portée directe du contrôleur. Ce qui permet une plus grande flexibilité de communication, même si il n’y a pas de connexion sans fil directe ou si une connexion est temporairement indisponible, à cause d’un changement dans la pièce ou le bâtiment.

introduction02

Le contrôleur Id 1 peut communiquer directement avec les nœuds 2, 3 et 4. Le nœud 6 est en dehors de sa portée radio, cependant, il se trouve dans la zone de couverture radio du nœud 2. Par conséquent, le contrôleur peut communiquer avec le nœud 6 via le nœud 2. De cette façon, le chemin du contrôleur via le nœud 2 vers le nœud 6, est appelé route. Dans le cas où la communication directe entre le nœud 1 et le nœud 2 est bloquée, il y a encore une autre option pour communiquer avec le nœud 6, en utilisant le nœud 3 comme un autre répéteur du signal.

Il devient évident que plus l’on possède de nœuds secteur, plus les options de routage augmentent , et plus la stabilité du réseau augmente. Le protocole Z-Wave est capable de router les messages par l’intermédiaire d’un maximum de quatre nœuds de répétition. C’est un compromis entre la taille du réseau, la stabilité et la durée maximale d’un message.

Tip

Il est fortement recommandé en début d’installation d’avoir un ratio entre nœuds secteur et nœud sur piles de 2/3, afin d’avoir un bon maillage réseau. Privilégier des micromodules aux smart-plugs. Les micros modules seront à un emplacement définitif et ne seront pas débranchés, ils ont aussi en général une meilleure portée. Un bon départ est l’éclairage des zones communes. Il permettra de bien répartir les modules secteurs à des endroits stratégiques dans votre domicile. Par la suite vous pourrez ajouter autant de modules sur pile que souhaité, si vos routes de base sont bonnes.

Tip

Le Graphique du réseau ainsi que la table de routage permettent de visualiser la qualité de votre réseau.

Tip

Il existe des modules répéteur pour combler des zones où aucun module secteur n’a d’utilité.

Propriétés des appareils Z-Wave

  Voisins Route Fonctions possibles
Contrôleur Connaît tous les voisins A accès à la table de routage complète Peut communiquer avec tous les appareils dans le réseau, si une voie existe
Esclave Connaît tous les voisins N’a pas d’information sur la table de routage Ne peut répondre au nœud qu’il a reçu le message. Par conséquent, ne peut pas envoyer des messages non sollicités
Esclaves de routage Connaît tous ses voisins A la connaissance partielle de la table de routage Peut répondre au nœud qu’il a reçu le message et peut envoyer des messages non sollicités à un certain nombre de nœuds

En résumé:

Configuration du plugin

Après le téléchargement du plugin, il vous suffit de l’activer et de le configurer.

configuration01

Une fois activé, le démon devrait se lancer. Le plugin est préconfiguré avec des valeurs par défaut ; vous n’avez normalement plus rien à faire. Cependant vous pouvez modifier la configuration.

Dépendances

Cette partie permet de valider et d’installer les dépendances requises au bon fonctionnement du plugin Zwave (aussi bien en local qu’en déporté, ici en local) configuration02

Tip

La mise à jour des dépendances peut prendre plus de 20 minutes selon votre matériel. La progression est affichée en temps réel et un log Openzwave_update est accessible.

Important

La mise à jour des dépendances est normalement à effectuer seulement si le Statut est NOK, mais il est toutefois possible, pour régler certains problèmes, d’être appelé à refaire l’installation des dépendances.

Tip

Si vous êtes en mode déporté, les dépendances du démon local peuvent être NOK, c’est tout à fait normal.

Démon

Cette partie permet de valider l’état actuel du ou des démons et de configurer la gestion automatique de ceux-ci. configuration04 Le démon local et l’ensemble des démons déportés seront affichés avec leurs différentes informations

Log

Cette partie permet de choisir le niveau de log ainsi que d’en consulter le contenu.

configuration05

Sélectionner le niveau puis sauvegarder, le démon sera alors relancé avec les instructions et traces sélectionnées.

Le niveau Debug ou Info peuvent être utiles pour comprendre pourquoi le démon plante ou ne remonte pas une valeur.

Important

En mode Debug le démon est très verbeux, il est recommandé d’utiliser ce mode seulement si vous devez diagnostiquer un problème particulier. Il n’est pas recommandé de laisser tourner le démon en Debug en permanence, si on utilise une SD-Card. Une fois le debug terminé, il ne faut pas oublier de retourner sur un niveau moins élevé comme le niveau Error qui ne remonte que d’éventuelles erreurs.

Configuration

Cette partie permet de configurer les paramètres généraux du plugin configuration06

Une fois les configurations récupérées, il faudra selon les changements apportés:

N’oubliez pas de configuration08 si vous effectuez une modification.

Important

Si vous utilisez Ubuntu : Pour que le démon fonctionne, il faut absolument avoir ubuntu 15.04 (les versions inférieures ont un bug et le démon n’arrive pas à se lancer). Attention si vous faites une mise à jour à partir de 14.04 il faut une fois en 15.04 relancer l’installation des dépendances.

Important

La sélection du Port clé Z-Wave en mode de détection automatique, Auto, ne fonctionne que pour les dongles USB.

Paneau Mobile

configuration09

Permet d’afficher ou non le panel mobile lors que vous utiliser l’application sur un téléphone.

Configuration des équipements

La configuration des équipements Z-Wave est accessible à partir du menu plugin :

appliance01

Ci-dessous un exemple d’une page du plugin Z-Wave (présentée avec quelques équipements) :

appliance02

Tip

Comme à beaucoup d’endroits sur Jeedom, placer la souris tout à gauche permet de faire apparaître un menu d’accès rapide (vous pouvez, à partir de votre profil, le laisser toujours visible).

Tip

Les boutons sur la ligne tout en haut Synchroniser, Réseau-Zwave et Santé, sont visibles seulement si vous êtes en mode Expert. appliance03

Général

Vous retrouvez ici toute la configuration de votre équipement :

appliance04

Important

La suppression d’un équipement n’engendre pas une exclusion du module sur le contrôleur. appliance11 Un équipement supprimé qui est toujours rattaché à son contrôleur sera automatiquement recréé suite à la synchronisation.

Commandes

Ci-dessous vous retrouvez la liste des commandes :

appliance05

Tip

En fonction des types et sous-types, certaines options peuvent être absentes.

Important

Le bouton Tester dans le cas d’une commande de type Info, ne va pas interroger le module directement mais la valeur disponible dans le cache de Jeedom. Le test retournera la bonne valeur seulement si le module en question a transmis une nouvelle valeur correspondant à la définition de la commande. Il est alors tout à fait normal de ne pas obtenir de résultat suite à la création d’une nouvelle commande Info, spécialement sur un module sur pile qui notifie rarement Jeedom.

La loupe, disponible dans l’onglet général, permet de recréer l’ensemble des commandes pour le module en cours. appliance13 Si aucune commande n’est présente ou si les commandes sont erronées la loupe devrait remédier à la situation.

Important

La loupe va supprimer les commandes existantes. Si les commandes étaient utilisées dans des scénarios, vous devrez alors corriger vos scénarios aux autres endroits où les commandes étaient exploitées.

Jeux de Commandes

Certains modules possèdent plusieurs jeux de commandes préconfigurées

appliance06

Vous pouvez les sélectionner via les choix possibles, si le module le permet.

Important

Vous devez effectuer la loupe pour appliquer le nouveau jeux de commandes.

Documentation et Assistant

Pour un certain nombre de modules, une aide spécifique pour la mise en place ainsi que des recommandations de paramètres sont disponibles.

appliance07

Le bouton Documentation permet d’accéder à la documentation spécifique du module pour Jeedom.

Des modules particuliers disposent aussi d’un assistant spécifique afin de faciliter l’application de certains paramètres ou fonctionnements.

Le bouton Assistant permet d’accéder à l’écran assistant spécifique du module.

Configuration recommandée

appliance08

Permet d’appliquer un jeu de configuration recommandée par l’équipe Jeedom.

Tip

Lors de leur inclusion, les modules ont les paramètres par défaut du constructeur et certaines fonctions ne sont pas activées par défaut.

Les éléments suivants, selon le cas, seront appliqués pour simplifier l’utilisation du module.

Pour appliquer le jeu de configuration recommandé, cliquer sur le bouton : Configuration recommandée, puis confirmer l’application des configurations recommandées.

appliance09

L’assistant active les différents éléments de configurations.

Une confirmation du bon déroulement sera affichée sous forme de bandeau

appliance10

Important

Les modules sur piles doivent être réveillés pour appliquer le jeu de configuration.

La page de l’équipement vous informe si des éléments n’ont pas encore été activés sur le module. Veuillez-vous référer à la documentation du module pour le réveiller manuellement ou attendre le prochain cycle de réveil.

appliance11

Tip

Il est possible d’activer automatiquement l’application du jeu de configuration recommandé lors de l’inclusion de nouveau module, voir la section Configuration du plugin pour plus de détails.

Configuration des modules

C’est ici que vous retrouverez toutes les informations sur votre module

node01

La fenêtre possède plusieurs onglets :

Résumé

Fournit un résumé complet de votre nœud avec différentes informations sur celui-ci, comme par exemple l’état des demandes qui permet de savoir si le nœud est en attente d’information ou la liste des nœuds voisins.

Tip

Sur cet onglet il est possible d’avoir des alertes en cas de détection possible d’un souci de configuration, Jeedom vous indiquera la marche à suivre pour corriger. Il ne faut pas confondre une alerte avec une erreur, l’alerte est dans une majorité des cas, une simple recommandation.

Valeurs

node02

Vous retrouvez ici toutes les commandes et états possibles sur votre module. Ils sont ordonnés par instance et classe de commande puis index. Le « mapping » des commandes est entièrement basé sur ces informations.

Tip

Forcer la mise à jour d’une valeur. Les modules sur pile vont rafraichir une valeur seulement au prochain cycle de réveil. Il est toutefois possible de réveiller à la main un module, voir la documentation du module.

Tip

Il est possible d’avoir plus de commandes ici que sur Jeedom, c’est tout à fait normal. Dans Jeedom les commandes ont été présélectionnées pour vous.

Important

Certains modules n’envoient pas automatiquement leurs états, il faut dans ce cas activer le rafraichissement manuel à 5 minutes sur la ou les valeurs souhaitées. Il est recommandé de laisser en automatique le rafraichissement. Abuser du rafraichissement manuel peut impacter fortement les performances du réseau Z-Wave, utilisez seulement pour les valeurs recommandées dans la documentation spécifique Jeedom. node16 L’ensemble des valeurs (index) de l’instance d’une commande classe sera remonté, en activant le rafraichissement manuel sur le plus petit index de l’instance de la commande classe. Répéter pour chaque instance si nécessaire.

Paramètres

node03

Vous retrouvez ici toutes les possibilités de configuration des paramètres de votre module ainsi que la possibilité de copier la configuration d’un autre nœud déjà en place.

Lorsqu’un paramètre est modifié, la ligne correspondante passe en jaune, node04 le paramètre est en attente d’être appliqué.

Si le module accepte le paramètre, la ligne redevient transparente.

Si toutefois le module refuse la valeur, la ligne passera alors en rouge avec la valeur appliquée retournée par le module. node05

A l’inclusion, un nouveau module est détecté avec les paramètres par défaut du constructeur. Sur certains modules, des fonctionnalités ne seront pas actives sans modifier un ou plusieurs paramètres. Référez-vous à la documentation du constructeur et à nos recommandations afin de bien paramétrer vos nouveaux modules.

Tip

Les modules sur pile vont appliquer les changements de paramètres seulement au prochain cycle de réveil. Il est toutefois possible de réveiller à la main un module, voir la documentation du module.

Tip

La commande Reprendre de…​ vous permet reprendre la configuration d’un autre module identique, sur le module en cours.

node06

Tip

La commande Appliquer sur…​ vous permet d’appliquer la configuration actuelle du module sur un ou plusieurs modules identiques.

node18

Tip

La commande Actualiser les paramètres force le module à actualiser les paramètres sauvegardés dans le module.

Si aucun fichier de configuration est définie pour le module, un assistant manuel vous permet d’appliquer des paramètres au module. node17 Veillez vous référer à la documentation du fabricant pour connaitre la définition de l’index, valeur et taille.

##Associations

C’est ici que se retrouve la gestion des groupes d’association de votre module.

node07

Les modules Z-Wave peuvent contrôler d’autres modules Z-Wave, sans passer par le contrôleur ni Jeedom. La relation entre un module de contrôle et un autre module est appelée association.

Afin de contrôler un autre module, le module de commande a besoin de maintenir une liste des appareils qui recevront le contrôle des commandes. Ces listes sont appelées groupes d’association et elles sont toujours liées à certains événements (par exemple le bouton pressé, les déclencheurs de capteurs, …​ ).

Dans le cas où un événement se produit, tous les périphériques enregistrés dans le groupe d’association concerné recevront une commande Basic.

Tip

Voir la documentation du module, pour comprendre les différents groupes d’associations possibles et leur comportement.

Tip

La majorité des modules ont un groupe d’association qui est réservé pour le contrôleur principal, il est utilisé pour remonter les informations au contrôleur. Il se nomme en général : Report ou LifeLine.

Tip

Il est possible que votre module ne possède aucun groupe.

Tip

La modification des groupes d’associations d’un module sur pile sera appliquée au prochain cycle de réveil. Il est toutefois possible de réveiller à la main un module, voir la documentation du module.

Pour connaitre avec quels autres modules le module en cours est associé, il suffit de cliquer sur le menu Associé à quels modules

node08

L’ensemble des modules utilisant le module en cours ainsi que le nom des groupes d’associations seront affichés.

Associations multi-instances

Certain module supporte une commande classe multi-instance associations. Lorsqu’un module supporte cette CC, il est possible de spécifier avec quelle instance on souhaite créer l’association

node09

Important

Certains modules doivent être associés à l’instance 0 du contrôleur principale afin de bien fonctionner. Pour cette raison, le contrôleur est présent avec et sans l’instance 0.

Systèmes

Onglet regroupant les paramètres systèmes du module.

node10

Tip

Les modules sur piles se réveillent à des cycles réguliers, appelés intervalles de réveil (Wakeup Interval). L’intervalle de réveil est un compromis entre le temps maximal de vie de la batterie et les réponses souhaitées du dispositif. Pour maximiser la durée de vie de vos modules, adapter la valeur Wakeup Interval par exemple à 14400 secondes (4h), voir encore plus élevé selon les modules et leur usage. node11

Tip

Les modules Interrupteur et Variateur peuvent implémenter une Classe de commande spéciale appelée SwitchAll 0x27. Vous pouvez en modifier ici le comportement. Selon le module, plusieurs options sont à disposition. La commande SwitchAll On/OFF peut être lancée via votre module contrôleur principal.

Actions

Permet d’effectuer certaines actions sur le module.

node12

Certaines actions seront actives selon le type de module et ses possibilités ou encore selon l’état actuel du module comme par exemple s’il est présumé mort par le contrôleur.

Important

Il ne faut pas utiliser les actions sur un module si on ne sait pas ce que l’on fait. Certaines actions sont irréversibles. Les actions peuvent aider à la résolution de problèmes avec un ou des modules Z-Wave.

Tip

La Régénération de la détection du noeud permet de détecter le module pour reprendre les derniers jeux de paramètres. Cette action est requise lorsqu’on vous informe qu’une mise a jour de paramètres et ou de comportement du module est requit pour le bon fonctionnement. La Régénération de la détection du noeud implique un redémarrage du réseau, l’assistant l’effectue automatiquement.

Tip

Si vous avez plusieurs modules identiques dont il est requis d’exécuter la Régénération de la détection du noeud, il est possible de la lancer une fois pour tous les modules identiques.

node13

Tip

Si un module sur pile n’est plus joignable et que vous souhaitez l’exclure, que l’exclusion ne s’effectue pas, vous pouvez lancer Supprimer le noeud fantôme Un assistant effectuera différentes actions afin de supprimer le module dit fantôme. Cette action implique de redémarrer le réseau et peut prendre plusieurs minutes avant d’être complétée.

node14

Une fois lancé, il est recommandé de fermer l’écran de configuration du module et de surveiller la suppression du module via l’écran de santé Z-Wave.

Important

Seul les modules sur pile peuvent être supprimés via cette assistant.

Statistiques

Cet onglet donne quelques statistiques de communication avec le nœud.

node15

Peut être intéressant en cas de modules qui sont présumés morts par le contrôleur “Dead”.

Inclusion / Exclusion

A sa sortie d’usine, un module ne fait partie d’aucun réseau Z-Wave.

Mode inclusion

Le module doit se joindre à un réseau Z-Wave existant pour communiquer avec les autres modules de ce réseau. Ce processus est appelé Inclusion. Les périphériques peuvent également sortir d’un réseau. Ce processus est appelé Exclusion. Les deux processus sont initiés par le contrôleur principal du réseau Z-Wave.

addremove01

Ce bouton vous permet de passer en mode inclusion pour ajouter un module à votre réseau Z-Wave.

Vous pouvez choisir le mode d’inclusion après avoir cliqué le bouton Inclusion.

addremove02

Depuis l’apparition du Z-Wave+, il est possible de sécuriser les échanges entre le contrôleur et les noeuds. Il est donc recommandé de faire les inclusions en mode Sécurisé.

Si toutefois, un module ne peut être inclus en mode sécurisé, veuillez l’inclure en mode Non sécurisé.

Une fois en mode inclusion : Jeedom vous le signale.

Tip

Un module ‘non sécurisé’ peut commander des modules ‘non sécurisés’. Un module ‘non sécurisé’ ne peut pas commander un module ‘sécurisé’. Un module ‘sécurisé’ pourra commander des modules ‘non sécurisés’ sous réserve que l’émetteur le supporte.

addremove03

Une fois l’assistant lancé, il faut en faire de même sur votre module (se référer à la documentation de celui-ci pour le passer en mode inclusion).

Tip

Tant que vous n’avez pas le bandeau, vous n’êtes pas en mode inclusion.

Si vous re cliquez sur le bouton, vous sortez du mode inclusion.

Tip

Il est recommandé, avant l’inclusion d’un nouveau module qui serait “nouveau” sur le marché, de lancer la commande Config modules via l’écran de configuration du plugin. Cette action va récupérer l’ensemble des dernières versions des fichiers de configurations openzwave ainsi que le mapping de commandes Jeedom.

Important

Lors d’une inclusion, il est conseillé que le module soit à proximité du contrôleur principal, soit à moins d’un mètre de votre jeedom.

Tip

Certains modules requièrent obligatoirement une inclusion en mode sécurisé, par exemple pour les serrures de porte.

Tip

A noter que l’interface mobile vous donne aussi accès à l’inclusion, le panel mobile doit avoir été activé.

Tip

Si le module appartient déjà à un réseau, suivez le processus d’exclusion avant de l’inclure dans votre réseau. Sinon l’inclusion de ce module va échouer. Il est d’ailleurs recommandé d’exécuter une exclusion avant l’inclusion, même si le produit est neuf, sorti du carton.

Tip

Une fois le module à son emplacement définitif, il faut lancer l’action soigner le réseau, afin de demander à tous les modules de rafraichir l’ensemble des voisins.

Mode exclusion

addremove04

Ce bouton vous permet de passer en mode exclusion, cela pour retirer un module de votre réseau Z-Wave, il faut en faire de même avec votre module (se référer à la documentation de celui-ci pour le passer en mode exclusion).

addremove05

Tip

Tant que vous n’avez pas le bandeau, vous n’êtes pas en mode exclusion.

Si vous re cliquez sur le bouton, vous sortez du mode exclusion.

Tip

A noter que l’interface mobile vous donne aussi accès à l’exclusion.

Tip

Un module n’a pas besoin d’être exclu par le même contrôleur sur lequel il a été préalablement inclus. D’où le fait qu’on recommande d’exécuter une exclusion avant chaque inclusion.

Synchroniser

addremove06

Bouton permettant de synchroniser les modules du réseau Z-Wave avec les équipements Jeedom. Les modules sont associés au contrôleur principal, les équipements dans Jeedom sont créés automatiquement lors de leur inclusion. Ils sont aussi supprimés automatiquement lors de l’exclusion, si l’option Supprimer automatiquement les périphériques exclus est activée.

Si vous avez inclus des modules sans Jeedom (requiert un dongle avec pile comme le Aeon-labs Z-Stick GEN5), une synchronisation sera nécessaire suite au branchement de la clé, une fois le démon démarré et fonctionnel.

Tip

Si vous n’avez pas l’image ou que Jeedom n’a pas reconnu votre module, ce bouton peut permettre de corriger (sous réserve que l’interview du module soit complète).

Tip

Si sur votre table de routage et/ou sur l’écran de santé Z-Wave, vous avez un ou des modules nommés avec leur nom générique, la synchronisation permettra de remédier à cette situation.

Le bouton Synchroniser n’est visible qu’en mode expert : addremove07

Réseaux Z-Wave

network01

Vous retrouvez ici des informations générales sur votre réseau Z-Wave.

network02

Résumé

Le premier onglet vous donne le résumé de base de votre réseau Z-Wave, vous retrouvez notamment l’état du réseau Z-Wave ainsi que le nombre d’éléments dans la file d’attente.

Informations

Etat

network03

Un ensemble d’informations sur l’état actuel du réseau, à savoir :

Une fois que le réseau a au minimum atteint Topology loaded, des mécanismes internes au serveur Z-Wave vont forcer des mises à jour de valeurs, il est alors tout-à-fait normal de voir monter le nombre de messages. Celui-ci va rapidement retourner à 0.

Tip

Le réseau est dit fonctionnel au moment où il atteint le statut Topology Loaded, c’est-à-dire que l’ensemble des nœuds secteurs ont complété leurs interviews. Selon le nombre de modules, la répartition pile/secteur, le choix du dongle USB et le PC sur lequel tourne le plugin Z-Wave, le réseau va atteindre cette état entre une et cinq minutes.

Un réseau Ready, signifie que tous les nœuds secteur et sur pile ont complété leur interview.

Tip

Selon les modules dont vous disposez, il est possible que le réseau n’atteigne jamais de lui-même le statut Ready. Les télécommandes, par exemple, ne se réveillent pas d’elles-mêmes et ne compléteront jamais leur interview. Dans ce genre de cas, le réseau est tout-à-fait opérationnel et même si les télécommandes n’ont pas complété leur interview, elles assurent leurs fonctionnalités au sein du réseau.

Capacités

Permet de savoir si le contrôleur est un contrôleur principal ou secondaire.

Système

Affiche diverses informations système.

Actions

network05

Vous retrouvez ici toutes les actions possibles sur l’ensemble de votre réseau Z-Wave. Chaque action est accompagnée d’une description sommaire.

Important

Certaines actions sont vraiment risquées voire irréversibles, l’équipe Jeedom ne pourra être tenue responsable en cas de mauvaise manipulation.

Important

Certains modules requièrent une inclusion en mode sécurisé, par exemple pour les serrures de porte. L’inclusion sécurisée doit être lancée via l’action de cet écran.

Tip

Si une action ne peut être lancée, elle sera désactivée jusqu’au moment où elle pourra être à nouveau exécutée.

Statistiques

network06

Vous retrouvez ici les statistiques générales sur l’ensemble de votre réseau Z-Wave.

Graphique du réseau

network07

Cet onglet vous donnera une représentation graphique des différents liens entre les nœuds.

Explication la légende des couleurs :

Tip

Seul les équipements actifs seront affichés dans le graphique réseau.

Le réseau Z-Wave est constitué de trois différents types de nœuds avec trois fonctions principales.

La principale différence entre les trois types de nœuds est leur connaissance de la table de routage du réseau et par la suite leur capacité à envoyer des messages au réseau.

Table de routage

Chaque nœud est en mesure de déterminer quels autres nœuds sont en communication directe. Ces nœuds sont appelés voisins. Au cours de l’inclusion et/ou plus tard sur demande, le nœud est en mesure d’informer le contrôleur de la liste de voisins. Grâce à ces informations, le contrôleur est capable de construire une table qui a toutes les informations sur les routes possibles de communication dans un réseau.

network08

Les lignes du tableau contiennent les nœuds de source et les colonnes contiennent les nœuds de destination. Se référer à la légende pour comprendre les couleurs de cellule qui indiquent les liens entre deux nœuds.

Explication la légende des couleurs :

Tip

Seul les équipements actifs seront affichés dans le graphique réseau.

Important

Un module présumé mort, ne participe pas/plus au maillage du réseau. Il sera marqué ici d’un point d’exclamation rouge dans un triangle.

Tip

Vous pouvez lancer manuellement la mise à jour des voisins, par module ou pour l’ensemble du réseau à l’aide des boutons disponibles dans la table de routage.

Santé

health01

Cette fenêtre résume l’état de votre réseau Z-Wave :

health02

Vous avez ici :

Important

Les équipements désactivés seront affichés mais aucune information de diagnostic ne sera présente.

Le nom du module peut-être suivit par une ou deux images:

health04 Modules supportant la COMMAND_CLASS_ZWAVE_PLUS_INFO

health05 Modules supportant la COMMAND_CLASS_SECURITY et securisé.

health06 Modules supportant la COMMAND_CLASS_SECURITY et non sécurisé.

health07 Module FLiRS, routeurs esclaves (modules à piles) à écoute fréquente.

Tip

La commande Ping peut être utilisée si le module est présumé mort “DEATH” afin de confirmer si c’est réellement le cas.

Tip

Les modules qui dorment répondront seulement au Ping lors de leur prochain réveil.

Tip

La notification Timeout ne signifie pas nécessairement un problème avec le module. Lancer un Ping et dans la majorité des cas le module répondra par une Notification NoOperation qui confirme un retour fructueux du Ping.

Tip

La Temporisation et le %OK sur des nœuds sur piles avant la complétion de leur interview n’est pas significative. En effet le nœud ne va pas répondre aux interrogations du contrôleur du fait qu’il est en sommeil profond.

Tip

Le serveur Z-Wave s’occupe automatiquement de lancer des tests sur les modules en Timeout au bout de 15 minutes

Tip

Le serveur Z-Wave essaie automatiquement de remonter les modules présumés morts.

Tip

Une alerte sera envoyée à Jeedom si le module est présumé mort. Vous pouvez activer une notification pour en être informé le plus rapidement possible. Voir la configuration des Messages dans l’écran de Configuration de Jeedom.

health03

Tip

Si sur votre table de routage et/ou sur l’écran de santé Z-Wave vous avez un ou des modules nommés avec leurs nom générique, la synchronisation permettra de remédier à cette situation.

Tip

Si sur votre table de routage et/ou sur l’écran de santé Z-Wave vous avez un ou des modules nommés Unknown, cela signifie que l’interview du module n’a pas été complétée avec succès. Vous avez probablement un NOK dans la colonne constructeur. Ouvrir le détail du/des modules, pour essayer les suggestions de solution proposées (voir section Dépannage et diagnostique, plus bas).

Statut de l’interview

Etape de l’interview d’un module après le démarrage du démon.

Notification

Détails des notifications envoyées par les modules

Backups

La partie backup va vous permettre de gérer les backups de la topologie de votre réseau. C’est votre fichier zwcfgxxx.xml, il constitue le dernier état connu de votre réseau, c’est une forme de cache de votre réseau. A partir de cet écran vous pourrez :

backup01

Mettre à jour OpenZWave

Suite à une mise à jour du plugin Z-Wave il est possible que Jeedom vous demande de mettre à jour les dépendances Z-Wave. Un NOK au niveau des dépendances sera affiché:

update01

Tip

Une mise à jour des dépendances n’est pas à faire à chaque mise à jour du plugin.

Jeedom devrait lancer de lui même la mise à jour des dépendances si le plugin considère qu’elle sont NOK. Cette validation est effectuée au bout de 5 minutes.

La durée de cette opération peut varier en fonction de votre système (jusqu’à plus de 1h sur raspberry pi)

Une fois la mise à jour des dépendances complétée, le démon se relancera automatiquement à la validation de Jeedom. Cette validation est effectuée au bout de 5 minutes.

Tip

Dans l’éventualité où la mise à jour des dépendances ne se complèterait pas, veillez consulter le log Openzwave_update qui devrait vous informer sur le problème.

Liste des modules compatible

Vous trouverez la liste des modules compatibles ici

Dépannage et diagnostic

Mon module n’est pas détecté ou ne remonte pas ses identifiants produit et type

troubleshooting01

Lancer la Regénération de la détection du nœud depuis l’onglet Actions du module.

Si vous avez plusieurs modules dans ce cas de figure, lancer Regénérer la détection de nœuds inconnues depuis l’écran Réseau ZWave onglet Actions.

Mon module est présumé mort par le controleur Dead

troubleshooting02

Si le module est toujours branché et joignable, suivre les solutions proposées dans l’écran du module.

Si le module a été décommissionné ou est réellement défectueux, vous pouvez l’exclure du réseau en utilisant supprimer le nœud en erreur via onglet Actions.

Si le module est parti en réparation et un nouveau module de remplacement a été livré, vous pouvez lancer Remplacer nœud en échec via onglet Actions, le contrôleur déclenche l’inclusion puis vous devez procéder à l’inclusion sur le module. L’id de l’ancien module sera conservé ainsi que ses commandes.

Comment utiliser la commande SwitchAll

troubleshooting03

Elle est disponible via votre nœud contrôleur. Votre contrôleur devrait avoir les commandes Switch All On et Switch All Off.

Si votre contrôleur n’apparaît pas dans votre liste de module, lancez la synchronisation.

troubleshooting04

La Commande Classe Switch All est en général supportée sur les interrupteurs et les variateurs. Son comportement est configurable sur chaque module qui la supporte.

On peut donc soit:

Le choix d’options dépend d’un constructeur à l’autre.

Il faut donc bien prendre le temps de passer en revue l’ensemble de ses interrupteurs/variateurs avant de mettre en place un scénario si vous ne pilotez pas que des lumières.

Mon module n a pas de commande Scene ou Bouton

troubleshooting05

Vous pouvez ajouter la commande dans l’écran de “mapping” des commandes.

Il s’agit d’une commande Info en CC 0x2b Instance 0 commande data[0].val

Le mode scène doit être activé dans les paramètres du module. Voir la documentation de votre module pour plus de détails.

Forcer le rafraichissement de valeurs

Il est possible de forcer à la demande le rafraîchissement des valeurs d’une instance pour une commande classe spécifique.

Il est possible de faire via une requête http ou de créer une commande dans l’écran de mapping d’un équipement.

troubleshooting06

Il s’agit d’une commande Action choisir la CC souhaitée pour une Instance donnée avec la commande data[0].ForceRefresh()

L’ensemble des index de l’instance pour cette commande Classe sera mise à jour. Les nœuds sur piles attendront leur prochain réveil avant d’effectuer la mise à jour de leur valeur.

Vous pouvez aussi utiliser par script en lançant une requête http au serveur REST Z-Wave. Remplacer ip_jeedom, node_id, instance_id, cc_id et index

http://token:\#APIKEY\#@ip\_jeedom:8083/ZWaveAPI/Run/devicesnode\_id.instances\[instance\_id\].commandClasses\[cc\_id\].data\[index\].ForceRefresh()

Transferer les modules sur un nouveau controleur

Pour différentes raisons, vous pouvez être amené à devoir transférer l’ensemble de vos modules sur un nouveau contrôleur principal.

Vous décidez de passer du raZberry à un Z-Stick Gen5 ou parce que, vous devez effectuer un Reset complet du contrôleur principal.

Voici différentes étapes pour y arriver sans perdre vos scénarios, widgets et historiques de valeur:

Remplacer un module defaillant

Comment refaire l’inclusion d’un module défaillant sans perdre vos scénarios, widgets et historiques de valeur

Si le module est présumé “Dead” :

Si le module n’est pas présumé “Dead” mais est toujours accessible:

Suppression de noeud fantome

Si vous avez perdu toute communication avec un module sur pile et que vous souhaitez l’exclure du réseau, il est possible que l’exclusion n’aboutisse pas ou que le nœud reste présent dans votre réseau.

Un assistant automatique de nœud fantôme est disponible.

Cet assistant est disponible seulement pour les modules sur piles.

Actions post inclusion

On recommande d’effectuer l’inclusion à moins 1M du contrôleur principal, or ce ne sera pas la position finale de votre nouveau module. Voici quelques bonnes pratiques à faire suite à l’inclusion d’un nouveau module dans votre réseau.

Une fois l’inclusion terminée, il faut appliquer un certain nombre de paramètres à notre nouveau module afin d’en tirer le maximum. Rappel, les modules, suite à l’inclusion, ont les paramètres par défaut du constructeur. Profitez d’être à côté du contrôleur et de l’interface Jeedom pour bien paramétrer votre nouveau module. Il sera aussi plus simple de réveiller le module pour voir l’effet immédiat du changement. Certains modules ont une documentation spécifique Jeedom afin de vous aider avec les différents paramètres ainsi que des valeurs recommandées.

Testez votre module, validez les remontées d’informations, retour d’état et actions possibles dans le cas d’un actuateur.

Lors de l’interview, votre nouveau module a recherché ses voisins. Toutefois, les modules de votre réseau ne connaissent pas encore votre nouveau module.

Déplacez votre module à son emplacement définitif. Lancez la mise à jour de ses voisins et réveillez-le encore une fois.

troubleshooting07

On constate qu’il voit un certain nombre de voisins mais que les voisins, eux, ne le voient pas.

Pour remédier à cette situation, il faut lancer l’action soigner le réseau, afin de demander à tous les modules de retrouver leurs voisins.

Cette action peut prendre 24 heures avant d’être terminée, vos modules sur pile effectueront l’action seulement à leur prochain réveil.

troubleshooting08

L’option de soigner le réseau 2x par semaine permet de faire ce processus sans action de votre part, elle est utile lors de la mise en place de nouveaux modules et ou lorsqu’on les déplace.

Pas de remontee état de la pile

Les modules Z-Wave n’envoient que très rarement l’état de leur pile au contrôleur. Certains vont le faire à l’inclusion puis seulement lorsque celle-ci atteint 20% ou une autre valeur de seuil critique.

Pour vous aider à mieux suivre l’état de vos piles, l’écran Batteries sous le menu Analyse vous donne une vue d’ensemble de l’état de vos piles. Un mécanisme de notification de piles faibles est aussi disponible.

La valeur remontée de l’écran Piles est la dernière connue dans le cache.

Toutes les nuits, le plugin Z-Wave demande à chaque module de rafraichir la valeur Battery. Au prochain réveil, le module envoie la valeur à Jeedom pour être ajouté au cache. Donc il faut en général attendre au moins 24h avant l’obtention d’une valeur dans l’écran Batteries.

Tip

Il est bien entendu possible de rafraichir manuellement la valeur Battery via l’onglet Valeurs du module puis, soit attendre le prochain réveil ou encore de réveiller manuellement le module pour obtenir une remontée immédiate. Le cycle de réveil (Wake-up Interval) du module est défini dans l’onglet Système du module. Pour optimiser la vie de vos piles, il est recommandé d’espacer au maximum ce délai. Pour 4h, il faudrait appliquer 14400, 12h 43200. Certains modules doivent écouter régulièrement des messages du contrôleur comme les Thermostats. Dans ce cas, il faut penser à 15min soit 900. Chaque module est différent, il n’y a donc pas de règle exacte, c’est au cas par cas et selon l’expérience.

Tip

La décharge d’une pile n’est pas linéaire, certains modules vont montrer un grosse perte en pourcentage dans les premiers jours de mise en service, puis ne plus bouger durant des semaines pour se vider rapidement une fois passé les 20%.

Controleur est en cours d initialisation

Lorsque vous démarrez le démon Z-Wave, si vous essayez de lancer immédiatement une inclusion/exclusion, vous risquez d’obtenir ce message: * “Le contrôleur est en cours d’initialisation, veuillez réessayer dans quelques minutes”

Tip

Suite au démarrage du démon, le contrôleur passe sur l’ensemble des modules afin de refaire leur interview. Ce comportement est tout-à-fait normal en OpenZWave.

Si toutefois après plusieurs minutes (plus de 10 minutes), vous avez toujours ce message, ce n’est plus normal.

Il faut essayer les différentes étapes:

Il faut maintenant débuter les tests hardwares:

Si le problème persiste toujours, il faut réinitialiser le contrôleur:

Le controleur ne répond plus

Plus aucune commande n’est transmise aux modules mais les retours d’états sont remontés vers Jeedom.

Il est possible que la queue de messages du contrôleur soit remplie. Voir l’écran Réseau Z-Wave si le nombre de messages en attente ne fait qu’augmenter.

Il faut dans ce cas relancer le Demon Z-Wave.

Si le problème persiste, il faut réinitialiser le contrôleur:

Erreur lors des dependances

Plusieurs erreurs peuvent survenir lors de la mise à jour des dépendances. Il faut consulter le log de mise à jour des dépendances afin de déterminer quelle est exactement l’erreur. De façon générale, l’erreur se trouve à la fin du log dans les quelque dernières lignes.

Voici les possibles problèmes ainsi que leurs possibles résolutions:

Le package mercurial ne veut pas s’installer, pour corriger lancer en ssh:

    sudo rm /var/lib/dpkg/info/$mercurial* -f
    sudo apt-get install mercurial

A 75% c’est le début de la compilation de la librairie openzwave ainsi que du wrapper python openzwave. Cette étape est très longue, on peut toutefois consulter la progression via la vue du log de mise à jour. Il faut donc être simplement patient.

        arm-linux-gnueabihf-gcc: internal compiler error: Killed (program cc1plus)
        Please submit a full bug report,
        with preprocessed source if appropriate.
        See <file:///usr/share/doc/gcc-4.9/README.Bugs> for instructions.
        error: command 'arm-linux-gnueabihf-gcc' failed with exit status 4
        Makefile:266: recipe for target 'build' failed
        make: *** [build] Error 1

Cette erreur peut survenir suite à un manque de mémoire RAM durant la compilation.

Depuis l’UI jeedom, lancez la compilation des dépendances.

Une fois lancée, en ssh, arrêtez ces processus (consommateurs en mémoire) :

    sudo systemctl stop cron
    sudo systemctl stop apache2
    sudo systemctl stop mysql.

Pour suivre l’avancement de la compilation, on fait un tail sur le fichier log openzwave_update.

    tail -f /var/www/html/log/openzwave_update

Lorsque la compilation est terminée et sans erreur, relancez les services que vous avez arrêté

sudo systemctl start cron sudo systemctl start apache2 sudo systemctl
start mysql

Utilisation de la carte Razberry sur un Raspberry Pi 3

Pour utiliser un contrôleur Razberry sur un Raspberry Pi 3, le contrôleur Bluetooth interne du Raspberry doit être désactivé.

Ajouter cette ligne:

    dtoverlay=pi3-miniuart-bt

À la fin du fichier:

    /boot/config.txt

Puis redémarrer votre Raspberry.

API HTTP

Le plugin Z-Wave met à disposition des développeurs et des utilisateurs une API complète afin de pouvoir opérer le réseau Z-Wave via requête HTTP.

Il vous est possible d’exploiter l’ensemble des méthodes exposées par le serveur REST du démon Z-Wave.

La syntaxe pour appeler les routes est sous cette forme:

URL = http://token:\#APIKEY\#@\#IP\_JEEDOM\#:\#PORTDEMON\#/\#ROUTE\#

Pour connaitre l’ensemble des routes, veuillez vous référer github du plugin Z-Wave.

Example: Pour lancer un ping sur le noeud id 2

URL = http://token:a1b2c3d4e5f6g7h8@192.168.0.1:8083/ZWaveAPI/Run/devices\[2\].TestNode()

FAQ

J’ai l’erreur “Not enough space in stream buffer”

Malheureusement cette erreur est matériel, nous ne pouvons rien y faire et cherchons pour le moment comment forcer un redémarrage du démon dans le cas de cette erreur (mais souvent il faut en plus débrancher la clef pendant 5min pour que ca reparte)

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site web. Si vous continuez à utiliser ce site, nous supposerons que vous en êtes satisfait.