Plugin ZiGate pour Jeedom

Installation

Après l’installation du plugin depuis le Jeedom Market, la page de configuration s’ouvre :

Plusieurs étapes sont nécessaires à la configuration du plugin :

1. Activer le plugin, la configuration devient alors accessible
2. Lancer l’installation des dépendances
3. Si besoin, relancer le démon, jusqu’à ce que le statut et la configuration soient OK
4. Sélectionner le port USB de la ZiGate, le nom Prolific doit apparaître dans le nom
5. Dans le cas de la version WiFi, il faut saisir l’adresse IP ainsi que le port de la clé ZiGate

Ce panneau de configuration donne aussi l’accès aux logs, ce sont les logs les plus utiles sur la communication avec les équipements.

Fonctionnement

• Mode inclusion : passe le plugin en mode détection d’équipement pendant 30 secondes. Il faut lancer la procédure d’association sur les équipements à associer dans cet intervalle.
• TouchLink : association d’équipement en mode touch link.
• Network scan : lancement d’un scan du réseau ZigBee. Peut résoudre des problèmes d’association, mais pour l’instant l’impact est inconnu
• Synchroniser : synchronise les informations du plugin avec les informations réelles du réseau ZigBee. Commande très importante à utiliser régulièrement pour s’assurer que les données affichées sont bien les données en cours. Plus techniquement, cette synchronisation permet d’afficher les données les plus récentes présentes dans le démon, qui est le composant qui porte la vérité sur le réseau ZigBee.
• Nettoyer : Supprime les équipements marqués “manquant” (les fantomes). Attention à ne pas utiliser juste après le démarrage du plugin, car un équipement peut sembler manquant juste parce qu’il n’a pas communiquer récemment avec la ZiGate mais ce n’est pas pour autant un fantome, donc le supprimer peut poser des problèmes de fonctionnement.
• Reset ZiGate : équivalent à un débranchement/rebranchement de la ZiGate. Cette commande ne supprime aucune donnée.
• Erase PDM : permet d’effacer la mémoire EEProm de la ZiGate et donc de repartir à 0. Attention toutes vos associations côté ZiGate seront perdues mais pas les équipements Jeedom correspondant. Il faudra ré-associer tous vos équipements à la ZiGate pour recréer l’association avec les équipements Jeedom.
• Configuration : accès à la configuration du plugin, ainsi qu’aux logs.
• Santé : accès à la synthèse de l’état de vos équipements.
• Terminal : permet d’envoyer des commandes brutes à la ZiGate. Par exemple:
  • je veux faire un reset : commande=0x0011 (et rien pour data).
  • je veux ajouter le groupe “abcd” à l’équipement “1234” sur son endpoint 3 : commande=0x0060 et data=0212340103abcd.

Mes équipements ZiGate

Configuration des équipements

Fonctions

• Identifier : lance la commande identify sur l’équipement pendant 5 secondes. Le résulat dépend de l’équipement, mais l’idée générale est de pouvoir identifier visuellement l’équipement en question. Une ampoule peut, par exemple, clignoter quelques secondes.
• Découvrir l’équipement : commande importante qui envoie une série de questions à l’équipement pour l’identifier, découvrir ses capacités, et le configurer au mieux. Cette opération est lancée automatiquement lors de l’association d’un équipement, mais il peut être utile de la relancer lors qu’un équipement ne transmet plus son état par exemple, celà peut relancer la communication. Le plugin est en mesure d’identifier quand un rafraîchissement est nécessaire. Le cas échéant, il sera automatique pour un équipement sur secteur. Pour un équipement sur batterie, il faut la réveiller. La méthode dépend de l’équipement. Voir les intégrations plus bas. Le rafraîchissement est également lancé automatiquement lors du (re)démarrage du démon.
• Rafraichir l’équipement : permet simplement de forcer la lecture des informations auprès de l’équipement.
• Configuration avancée : accès à la configuration avancée de l’équipement, déconseillé pour les non initiés

Paramètres de l’équipement

• Nom de l’équipement ZiGate : nom que l’on veut donner à l’équipement
• Parent : objet parent dans Jeedom
• Catégorie : catégorie Jeedom
• ADDR : adresse de l’équipement au sein du réseau ZigBee
• Type : type de l’équipement après identification de l’équipement
• Manufacturer : constructeur de l’équipement
• IEEE : identifiant réseau unique, l’équivalent d’une adresse mac par exemple
• Link quality : niveau de qualité du lien avec l’équipement. Une valeur basse indique un lien trop faible, la communication peut être instable. Une valeur à 50 peut engendrer des disparitions temporaires d’équipement. Une valeur de 100 semble être stable.
• Power source : source d’énergie * 0 : inconnu * 3 : batterie
• Batterie : niveau de batterie de l’équipement

L’onglet Commandes regroupe l’ensemble des commandes de l’équipement. Consulter la documentation de Jeedom pour plus d’information.

Intégration des équipements

Ikea

Voir Ikea.

Philips

Voir Philips.

Xiaomi

Voir Xiaomi.

Osram

Voir Osram.

Autres

Voir Autres.

FAQ

Le statut de l’équipement ne remonte plus dans Jeedom

Lancer un rafraîchissement de l’équipement. Si le problème revient régulièrement, il peut être intéressant de mettre en place un cron pour déclencher ce rafraîchissement à intervalle régulier.

Le daemon ne se lance pas ou plus

En cas de non lancement du daemon et de message de type :

[2018-08-25 20:35:17][ERROR][ZiGate] : No response after command 0x0010
Traceback (most recent call last):
File "/var/www/html/plugins/ZiGate/core/class/../../resources/ZiGated/ZiGated.py", line 281, in <module>
z.autoStart()
File "/usr/local/lib/python3.4/dist-packages/ZiGate/core.py", line 225, in autoStart
self.get_version()
File "/usr/local/lib/python3.4/dist-packages/ZiGate/core.py", line 588, in get_version
self._version = self.send_data(0x0010, wait_response=0x8010).data
AttributeError: 'NoneType' object has no attribute 'data'
[2018-08-25 20:39:18][ERROR][ZiGate] : No response after command 0x0010
Traceback (most recent call last):
File "/var/www/html/plugins/ZiGate/core/class/../../resources/ZiGated/ZiGated.py", line 281, in <module>
z.autoStart()
File "/usr/local/lib/python3.4/dist-packages/ZiGate/core.py", line 225, in autoStart
self.get_version()
File "/usr/local/lib/python3.4/dist-packages/ZiGate/core.py", line 588, in get_version
self._version = self.send_data(0x0010, wait_response=0x8010).data
AttributeError: 'NoneType' object has no attribute 'data'

• Désactiver la “Gestion automatique”.
• Arrêter manuelelment le daemon.
• Attendre 2 mn.
• Relancer manuelelment le daemon.

Problème de dépendances python

Le plugin ZiGate utilise Python3. Python 2 et 3 doivent collaborer au sein de Jeedom. Assurez-vous de n’avoir pas mis à jour votre stack pip et d’avoir les bonnes versions (9.0.x).

$ pip2 -V
pip 9.0.1 from /usr/lib/python2.7/dist-packages (python 2.7)
$ pip3 -V
pip 9.0.1 from /usr/lib/python3/dist-packages (python 3.5)
$ pip -V
pip 9.0.1 from /usr/lib/python2.7/dist-packages (python 2.7)

Si ce n’est pas le cas :

$ sudo python3 -m pip uninstall pip
$ sudo apt-get remove python3-pip python-pip
$ sudo apt-get install python3-pip python-pip
$ sudo python2 -m pip uninstall pip
$ sudo apt-get remove python-pip
$ sudo apt-get install python-pip

Si ça ne fonctionne toujours pas vérifier que pip existe:

$ which pip
/usr/bin/pip

Si la commande ne retourne rien c’est que pip est manquant, il faut alors le recréer:

$ sudo cp /usr/bin/pip2 /usr/bin/pip