ZigBeeForDomoticZ plugin Wiki
FAQ - Réponses aux questions fréquentes
- Q1. Où obtenir de l’aide ?
- Q2. Où trouver les logs ?
- Q3. Comment faire du débogage ?
- Q4. Où trouver la liste des coordinateurs et des objets supportés ?
- Q5. Où trouver les firmwares des coordinateurs ?
- Q6. Est il possible d’utiliser plusieurs coordinateurs dans un seul DomoticZ ?
- Q7. Est il possible de fixer le numéro du port USB ?
- Q8. Mon objet n’est pas mis à jour dans DomoticZ quand je l’actionne manuellement
- Q9. Le lien de menu ne s’affiche pas dans DomoticZ
Débogage
- T1. Mon coordinateur ne fonctionne pas
- T2. Mon objet ne s’appaire pas
- T3. Mon objet ne fonctionne pas comme prévu
Erreurs
- E1. Erreur :
No transport, write directive to XXX.XXX.XXX.XXX:8080' ignored
- E2. Erreur :
Decode8000
- E3. Erreur :
Error: <Nom du plugin> Communication error when transmiting a previous command to XXXX ieee XXXXXXXXXXXXXXXX
- E4. Erreur :
Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter
- E5. Missing module Error
- E6. Erreur :
Error: <Nom du plugin> : You need to setup the URL Base to access the Domoticz JSON/API
- E7. Erreur lors de la mise à jour des modules python :
Building wheel for cryptography (PEP 517) ... error
- E8. Erreur :
pkg_resources.VersionConflict: (dnspython 2.3.0 (/usr/local/lib/python3.10/site-packages), Requirement.parse('dnspython==2.2.1'))
- E9. Erreur :
ImportError: PyO3 modules may only be initialized once per interpreter process
- E10. Erreur :
[WebServer] Deprecated RType (devices) for API request. Handled via fallback (getdevices), please use correct API Command!
- E11. Erreur à l’installation sous Debian 12 :
This environment is externally managed. To install Python packages system-wide, try apt install python3-xyz...
- E12. Erreur :
Error: <Nom du plugin> : ModuleNotFoundError: No module named 'cchardet'
Q1. Où obtenir de l’aide ?
La première source d’aide est le wiki :
- Wiki français
- Wiki anglais
- Wiki allemand ( Malheureusement, il n’est plus à jour. Merci de nous contacter si vous êtes prêt à contribuer dans l’amélioration de ce wiki)
Vous pouvez également obtenir de l’aide et poser des questions : :
Q2. Où trouver les logs ?
Depuis la Stable6, les logs sont enregistrés dans le fichier : domoticz/plugins/Domoticz-Zigbee/Logs/PluginZigbee-XX.log
Le dossier Domoticz-Zigbee peut s’appeler Domoticz-Zigate si vous aviez installer le plugin ZiGate avant avril 2022.
Q3. Comment faire du débogage ?
Merci de consulter la page Aide au débogage
Q4. Où trouver la liste des coordinateurs et des objets supportés ?
Merci de consulter le site https://zigbee.blakadder.com/z4d.html
Q5. Où trouver les firmwares des coordinateurs ?
- Pour Texas Instrument, nous recommandons l’utilisation des firmwares Z-Stack firmware de @Koenkk disponibles ici. Nous ne recommandons pas l’utilisation de la branche develop. Merci de rester sur la branche master.
- Pour ZiGate, Les firmwares sont disponibles ici pour la Zigate V1 et ici pour la ZiGate+ V2
- Pour EZNP (Silicon Labs), nous recommandons de suivre les recommendations zigpy
Q6. Est il possible d’utiliser plusieurs coordinateurs dans un seul DomoticZ ?
- Si vous utilisez des coordinateurs ZiGates, vous pouvez faire fonctionner plusieurs instances du plugin en parallèle.
- Si vous utilisez d’autres coordinateurs (TI CCxxxx, Silicon Labs), il ne peut y avoir qu’une seule instance du plugin utilisant la couche ZigPy.
Il peut y avoir deux instances ZiGate et une instance Zigpy : cela fonctionne.
Q7. Est il possible de fixer le numéro du port USB ?
Quelques fois, au redémarrage du système, le port USB (dev/ttyUSB0 par exemple) peut changer de numéro ce qui provoque une erreur de communication avec le coordinateur. C’est plus un souci au niveau de l’OS, mais il y a des solutions :
Q8. Mon objet n’est pas mis à jour dans DomoticZ quand je l’actionne manuellement
Par exemple : Si vous éteignez une ampoule Ikea (avec l’interrupteur physique) puis que vous la rallumez, l’état de l’ampoule n’est pas mis à jour dans DomoticZ. Ou une télécommande qui ne met pas non plus à jour son état actuel vers DomoticZ.
Si vous rencontrez des problèmes comme l’exemple ci-dessus, il est fort probable que le rapport automatique ne soit pas configuré correctement à partir de l’objet. Veuillez suivre les étapes ci-dessous pour résoudre ce problème :
- Aller sur la page Réglages du WebUI
- Activer les réglages avancés
- Activer le paramètre AllowRebindingClusters.
- Éteignez l’ampoule Ikea avec l’interrupteur physique, attendez 10 secondes, puis rallumez-la. Le processus d’appairage va commencer de lui-même, les problèmes d’état devraient maintenant être résolus.
Q9. Le lien de menu ne s’affiche pas dans DomoticZ
Vérifier que l’affichage de l’onglet Personnalisé est bien activé :
-
Pour les versions de DomoticZ jusqu’à la 2022.2, aller dans Configuration / Paramètres / Onglet Système et vérifier la coche de l’onglet Personnalisé tout en bas.
-
Pour les versions de DomoticZ depuis la 2023.1, aller dans Configuration / Users et vérifier que l’onglet Personnalisé est bien coché pour les utilisateurs souhaités.
Vérifier également que le paramètre Ajouter un lien vers le WebUI dans le Custom Menu de DomoticZ est bien activé dans le menu Réglage
T1. Mon coordinateur ne fonctionne pas
Vous avez les messages suivant dans le fichier de log file :
INFO : [ MainThread] Zigate plugin beta6-6.0.114 started
INFO : [ MainThread] Plugin Database: DeviceList-2.txt
INFO : [ MainThread] DeviceConf loaded - 23 confs loaded
INFO : [ MainThread] DeviceConf loaded - 329 confs loaded
INFO : [ MainThread] load ListOfDevice
INFO : [ MainThread] Transport mode: ZigpyZNP
ERROR : [ MainThread] [ 61] I have hard time to get Coordinator Version. Mostlikly there is a communication issue
ERROR : [ MainThread] [ ] Stop the plugin and check the Coordinator connectivity.
Cela indique un souci de communication entre le plugin et le coordinateur. Vous devez vérifier les éléments suivants dans la configuration du plugin dans DomoticZ :
- Si c’est la première fois que vous utilisez le coordinateur (aucun objets appairés pour le moment), vous devez l’initialiser. Définir le Initialize Coordinateur: True dans le menu Matériel DomoticZ lors du démarrage du plugin. Une fois que le premier démarrage est correct, désactivez ce paramètre pour éviter d’effacer tous les périphériques appariés au prochain redémarrage.
- Assurez-vous que le port série est le bon.
- Assurez-vous que le modèle de coordinateur correspond à votre dongle.
- Assurez-vous qu’aucun autre processus n’est en cours d’exécution sur le port USB.
- Si le coordinateur est connecté sur un Raspberry Pi, assurez-vous d’utiliser un port USB2 (et non l’USB3 du PI4).
- Si le coordinateur est branché sur un hub USB, essayez de la brancher directement sur un port USB de votre serveur.
Si cela ne fonctionne toujours pas, vous pouvez essayer de tester le coordinateur en faisant une analyse de topologie en temps reel. Ce test se fera sans DomoticZ ni le plugin. Il ne fonctionne qu’avec TI CCxxx.
T2. Mon objet ne s’appaire pas
- Si le coordinateur est branché directement sur un port USB du serveur, essayez de le déporter en utilisant une rallonge USB (ne pas utiliser de Hub USB). Ceci permettra de l’éloigner des interférences, et en particulier celles des disques SSD, puces wifi, etc…
Merci de consulter la page Problèmes d’appairage
T3. Mon objet ne fonctionne pas comme prévu
Merci de consulter la page Problèmes d’appairage
E1. Erreur : No transport, write directive to XXX.XXX.XXX.XXX:8080' ignored
De temps en temps, il y a le message d’erreur suivant. Est-ce un gros problème ?
Error: ZigBee: No transport, write directive to 'XXX.XXX.XXX.XXX:8080' ignored.
Cette erreur provient de DomoticZ et est liée au fait que vous aviez la page WebUI ouverte depuis un moment et lorsque vous essayez d’actualiser cette page, DomoticZ a détecté qu’il n’y avait plus de communication.
Ne pas s’inquiéter de ce message.
E2. Erreur : Decode8000
Si vous voyez des journaux d’erreurs comme ici après, il s’agit très probablement d’un problème avec le matériel ZiGate.
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 22 Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 4d Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 51 Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 52 Status: [ZigBee Error Code Unknown code : 80]
- Assurez vous de ne pas utiliser le vieux module USB-TTL bleu (il faut utiliser le rouge).
- Essayez d’éteindre le ZiGate en arrêtant le plugin, de débrancher la ZiGate pendant 1 minute, de rebrancher et redémarrez le plugin.
E3. Erreur : Error: <Nom du plugin> Communication error when transmiting a previous command to XXXX ieee XXXXXXXXXXXXXXXX
Voici ci-dessous un exemple d’erreurs trouvées dans le fichier de logs :
Error: (Zigate) Communication error when transmiting a previous command to 9d58 ieee 90fd9ffffe31f150
Error: (Zigate) Decode8702 - SQN: bc AddrMode: 02 DestAddr: 9d58 SrcEP: 01 DestEP: 01 Status: d4 - Unicast frame does not have a route available but it is buffered for automatic resend
Cela indique que l’objet 90fd9ffffe31f150 n’est pas joignable ou que la ZiGate a un problème de communication avec lui.
E4. Erreur : [E4. Erreur : Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter
Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter.
Cette erreur apparaît lors de l’arrêt du plugin. Ne pas en tenir compte.
E5. Erreur : Missing module error
Vérifier que le plugin est correctement installé :
- Aller dans le répertoire du plugin Domoticz-Zigbee ou Domoticz-Zigate
- Lancer la commande
ls -l external/dnspython/
Si la réponse est :
total 0
Il faut lancer les commandes
git config --add submodule.recurse true
git submodule update --init --recursive
Vérifier que les dépendances sont bien installées
- Lancer la commande depuis le répertoire du plugin
sudo pip3 install -r requirements.txt
ATTENTION:
Sur les Windows, il faut lancer les commandes pip3 install en mode administrateur et ce, dès la première fois.
Si cela n’a pas été fait la première fois, il faut désinstaller les modules existants.
E6. Erreur : Error: <Nom du plugin> : You need to setup the URL Base to access the Domoticz JSON/API
Cette erreur apparaît lorsque API base url n’est pas (ou pas bien) paramétrée dans DomoticZ. Se reporter à l’étape 2 Paramétrage du plugin pour plus d’infos.
E7. Erreur lors de la mise à jour des modules python : Building wheel for cryptography (PEP 517) ... error
Cette erreur peut arriver en exécutant les commandes pip3 install -r requirements.txt ou python3 -m pip install -r requirements.txt --upgrade.
ERROR: Failed building wheel for cryptography
Failed to build cryptography
ERROR: Could not build wheels for cryptography which use PEP 517 and cannot be installed directly
-
Mettre à jour le module python wheel
sudo python3 -m pip install wheel --upgrade
- S’assurer que le dossier /tmp dispose de suffisamment d’espace libre
- S’assurer qu’il y a suffisamment de swap disponible. En rajouter si nécessaire
E8. Erreur : pkg_resources.VersionConflict: (dnspython 2.3.0 (/usr/local/lib/python3.10/site-packages), Requirement.parse('dnspython==2.2.1'))
Cette erreur peut apparaître lors d’un retour depuis la branche develop vers la branche stable6 : le niveau de version du module dnspython n’est pas le même.
- Lancer la commande depuis le répertoire du plugin
sudo python3 -m pip install -r requirements.txt --upgrade
E9. Erreur : ImportError: PyO3 modules may only be initialized once per interpreter process
Status: Zigpy-Elelabs: Transport mode: ZigpyEZSP
Error: Zigpy-Elelabs: Call to function 'onStart' failed, exception details:
Error: Zigpy-Elelabs: Traceback (most recent call last):
Error: Zigpy-Elelabs: File "/var/lib/domoticz/plugins/Domoticz-Zigbee/plugin.py", line 1537, in onStart
Error: Zigpy-Elelabs: _plugin.onStart()
Error: Zigpy-Elelabs: File "/var/lib/domoticz/plugins/Domoticz-Zigbee/plugin.py", line 602, in onStart
Error: Zigpy-Elelabs: from zigpy.config import (CONF_DEVICE, CONF_DEVICE_PATH,
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/config/init.py", line 32, in <module>
Error: Zigpy-Elelabs: from zigpy.config.validators import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/config/validators.py", line 9, in <module>
Error: Zigpy-Elelabs: import zigpy.zdo.types as zdo_t
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/zdo/init.py", line 10, in <module>
Error: Zigpy-Elelabs: import zigpy.util
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/util.py", line 14, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.primitives.ciphers import Cipher
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/hazmat/primitives/ciphers/init.py", line 11, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.primitives.ciphers.base import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/hazmat/primitives/ciphers/base.py", line 10, in <module>
Error: Zigpy-Elelabs: from cryptography.exceptions import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/exceptions.py", line 9, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.bindings.rust import exceptions as rustexceptions
Error: Zigpy-Elelabs: ImportError: PyO3 modules may only be initialized once per interpreter process
Cette erreur apparaît lors de l’utilisation d’un module python de cryptographie trop récent qui ne sont pas encore compatibles avec le plugin.
La commande pour installé une version compatible est :
sudo python3 -m pip install cryptography==40.0.2 --upgrade`
E10. Erreur : [WebServer] Deprecated RType (devices) for API request. Handled via fallback (getdevices), please use correct API Command!
Cette erreur est apparue à la suite de la modification de l’API de DomoticZ dans la version 2023.2.
Il suffit de mettre à jour le plugin en version 7 en suivant les recommandations.
E11. Erreur à l’installation sous Debian 12 : This environment is externally managed. To install Python packages system-wide, try apt install python3-xyz...
L’erreur complète est :
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install.
If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed.
Le fonctionnement sous Debian 12 Bookworm nécessite de modifier la commande d’installation par défaut en rajoutant –break-system-packages à la fin soit la commande complète :
sudo pip3 install -r requirements.txt --break-system-packages
Rappel : Cette commande n’est valable que pour une installation sous Debian 12 Bookworm.
E12. Erreur : Error: <Nom du plugin> : ModuleNotFoundError: No module named 'cchardet'
Cette erreur apparaît lorsque vous avez plusieurs sessions du plugin et qu’il n’y a pas la bonne version de la dependance charset-normalizer, vous devez être en 2.0.12
pip show charset-normalizer
ou si python2 est toujours installé
pip3 show charset-normalizer
Si la réponse n’est pas 2.0.12 alors :
pip install --force-reinstall --upgrade charset-normalizer==2.0.12
ou si python2 est toujours installé
pip3 install --force-reinstall --upgrade charset-normalizer==2.0.12
FAQ - Réponses aux questions fréquentes
- Q1. Où obtenir de l’aide ?
- Q2. Où trouver les logs ?
- Q3. Comment faire du débogage ?
- Q4. Où trouver la liste des coordinateurs et des objets supportés ?
- Q5. Où trouver les firmwares des coordinateurs ?
- Q6. Est il possible d’utiliser plusieurs coordinateurs dans un seul DomoticZ ?
- Q7. Est il possible de fixer le numéro du port USB ?
- Q8. Mon objet n’est pas mis à jour dans DomoticZ quand je l’actionne manuellement
- Q9. Le lien de menu ne s’affiche pas dans DomoticZ
Débogage
- T1. Mon coordinateur ne fonctionne pas
- T2. Mon objet ne s’appaire pas
- T3. Mon objet ne fonctionne pas comme prévu
Erreurs
- E1. Erreur :
No transport, write directive to XXX.XXX.XXX.XXX:8080' ignored - E2. Erreur :
Decode8000 - E3. Erreur :
Error: <Nom du plugin> Communication error when transmiting a previous command to XXXX ieee XXXXXXXXXXXXXXXX - E4. Erreur :
Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter - E5. Missing module Error
- E6. Erreur :
Error: <Nom du plugin> : You need to setup the URL Base to access the Domoticz JSON/API - E7. Erreur lors de la mise à jour des modules python :
Building wheel for cryptography (PEP 517) ... error - E8. Erreur :
pkg_resources.VersionConflict: (dnspython 2.3.0 (/usr/local/lib/python3.10/site-packages), Requirement.parse('dnspython==2.2.1')) - E9. Erreur :
ImportError: PyO3 modules may only be initialized once per interpreter process - E10. Erreur :
[WebServer] Deprecated RType (devices) for API request. Handled via fallback (getdevices), please use correct API Command! - E11. Erreur à l’installation sous Debian 12 :
This environment is externally managed. To install Python packages system-wide, try apt install python3-xyz... - E12. Erreur :
Error: <Nom du plugin> : ModuleNotFoundError: No module named 'cchardet'
Q1. Où obtenir de l’aide ?
La première source d’aide est le wiki :
- Wiki français
- Wiki anglais
- Wiki allemand ( Malheureusement, il n’est plus à jour. Merci de nous contacter si vous êtes prêt à contribuer dans l’amélioration de ce wiki)
Vous pouvez également obtenir de l’aide et poser des questions : :
Q2. Où trouver les logs ?
Depuis la Stable6, les logs sont enregistrés dans le fichier : domoticz/plugins/Domoticz-Zigbee/Logs/PluginZigbee-XX.log
Le dossier Domoticz-Zigbee peut s’appeler Domoticz-Zigate si vous aviez installer le plugin ZiGate avant avril 2022.
Q3. Comment faire du débogage ?
Merci de consulter la page Aide au débogage
Q4. Où trouver la liste des coordinateurs et des objets supportés ?
Merci de consulter le site https://zigbee.blakadder.com/z4d.html
Q5. Où trouver les firmwares des coordinateurs ?
- Pour Texas Instrument, nous recommandons l’utilisation des firmwares Z-Stack firmware de @Koenkk disponibles ici. Nous ne recommandons pas l’utilisation de la branche develop. Merci de rester sur la branche master.
- Pour ZiGate, Les firmwares sont disponibles ici pour la Zigate V1 et ici pour la ZiGate+ V2
- Pour EZNP (Silicon Labs), nous recommandons de suivre les recommendations zigpy
Q6. Est il possible d’utiliser plusieurs coordinateurs dans un seul DomoticZ ?
- Si vous utilisez des coordinateurs ZiGates, vous pouvez faire fonctionner plusieurs instances du plugin en parallèle.
- Si vous utilisez d’autres coordinateurs (TI CCxxxx, Silicon Labs), il ne peut y avoir qu’une seule instance du plugin utilisant la couche ZigPy.
Il peut y avoir deux instances ZiGate et une instance Zigpy : cela fonctionne.
Q7. Est il possible de fixer le numéro du port USB ?
Quelques fois, au redémarrage du système, le port USB (dev/ttyUSB0 par exemple) peut changer de numéro ce qui provoque une erreur de communication avec le coordinateur. C’est plus un souci au niveau de l’OS, mais il y a des solutions :
Q8. Mon objet n’est pas mis à jour dans DomoticZ quand je l’actionne manuellement
Par exemple : Si vous éteignez une ampoule Ikea (avec l’interrupteur physique) puis que vous la rallumez, l’état de l’ampoule n’est pas mis à jour dans DomoticZ. Ou une télécommande qui ne met pas non plus à jour son état actuel vers DomoticZ.
Si vous rencontrez des problèmes comme l’exemple ci-dessus, il est fort probable que le rapport automatique ne soit pas configuré correctement à partir de l’objet. Veuillez suivre les étapes ci-dessous pour résoudre ce problème :
- Aller sur la page Réglages du WebUI
- Activer les réglages avancés
- Activer le paramètre AllowRebindingClusters.
- Éteignez l’ampoule Ikea avec l’interrupteur physique, attendez 10 secondes, puis rallumez-la. Le processus d’appairage va commencer de lui-même, les problèmes d’état devraient maintenant être résolus.
Q9. Le lien de menu ne s’affiche pas dans DomoticZ
Vérifier que l’affichage de l’onglet Personnalisé est bien activé :
-
Pour les versions de DomoticZ jusqu’à la 2022.2, aller dans Configuration / Paramètres / Onglet Système et vérifier la coche de l’onglet Personnalisé tout en bas.
-
Pour les versions de DomoticZ depuis la 2023.1, aller dans Configuration / Users et vérifier que l’onglet Personnalisé est bien coché pour les utilisateurs souhaités.
Vérifier également que le paramètre Ajouter un lien vers le WebUI dans le Custom Menu de DomoticZ est bien activé dans le menu Réglage
T1. Mon coordinateur ne fonctionne pas
Vous avez les messages suivant dans le fichier de log file :
INFO : [ MainThread] Zigate plugin beta6-6.0.114 started
INFO : [ MainThread] Plugin Database: DeviceList-2.txt
INFO : [ MainThread] DeviceConf loaded - 23 confs loaded
INFO : [ MainThread] DeviceConf loaded - 329 confs loaded
INFO : [ MainThread] load ListOfDevice
INFO : [ MainThread] Transport mode: ZigpyZNP
ERROR : [ MainThread] [ 61] I have hard time to get Coordinator Version. Mostlikly there is a communication issue
ERROR : [ MainThread] [ ] Stop the plugin and check the Coordinator connectivity.
Cela indique un souci de communication entre le plugin et le coordinateur. Vous devez vérifier les éléments suivants dans la configuration du plugin dans DomoticZ :
- Si c’est la première fois que vous utilisez le coordinateur (aucun objets appairés pour le moment), vous devez l’initialiser. Définir le Initialize Coordinateur: True dans le menu Matériel DomoticZ lors du démarrage du plugin. Une fois que le premier démarrage est correct, désactivez ce paramètre pour éviter d’effacer tous les périphériques appariés au prochain redémarrage.
- Assurez-vous que le port série est le bon.
- Assurez-vous que le modèle de coordinateur correspond à votre dongle.
- Assurez-vous qu’aucun autre processus n’est en cours d’exécution sur le port USB.
- Si le coordinateur est connecté sur un Raspberry Pi, assurez-vous d’utiliser un port USB2 (et non l’USB3 du PI4).
- Si le coordinateur est branché sur un hub USB, essayez de la brancher directement sur un port USB de votre serveur.
Si cela ne fonctionne toujours pas, vous pouvez essayer de tester le coordinateur en faisant une analyse de topologie en temps reel. Ce test se fera sans DomoticZ ni le plugin. Il ne fonctionne qu’avec TI CCxxx.
T2. Mon objet ne s’appaire pas
- Si le coordinateur est branché directement sur un port USB du serveur, essayez de le déporter en utilisant une rallonge USB (ne pas utiliser de Hub USB). Ceci permettra de l’éloigner des interférences, et en particulier celles des disques SSD, puces wifi, etc…
Merci de consulter la page Problèmes d’appairage
T3. Mon objet ne fonctionne pas comme prévu
Merci de consulter la page Problèmes d’appairage
E1. Erreur : No transport, write directive to XXX.XXX.XXX.XXX:8080' ignored
De temps en temps, il y a le message d’erreur suivant. Est-ce un gros problème ?
Error: ZigBee: No transport, write directive to 'XXX.XXX.XXX.XXX:8080' ignored.
Cette erreur provient de DomoticZ et est liée au fait que vous aviez la page WebUI ouverte depuis un moment et lorsque vous essayez d’actualiser cette page, DomoticZ a détecté qu’il n’y avait plus de communication. Ne pas s’inquiéter de ce message.
E2. Erreur : Decode8000
Si vous voyez des journaux d’erreurs comme ici après, il s’agit très probablement d’un problème avec le matériel ZiGate.
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 22 Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 4d Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 51 Status: [ZigBee Error Code Unknown code : 80]
Error: ZiGate: Decode8000 - PacketType: 0030 TypeSqn: 02 sqn_app: 00 sqn_aps: 52 Status: [ZigBee Error Code Unknown code : 80]
- Assurez vous de ne pas utiliser le vieux module USB-TTL bleu (il faut utiliser le rouge).
- Essayez d’éteindre le ZiGate en arrêtant le plugin, de débrancher la ZiGate pendant 1 minute, de rebrancher et redémarrez le plugin.
E3. Erreur : Error: <Nom du plugin> Communication error when transmiting a previous command to XXXX ieee XXXXXXXXXXXXXXXX
Voici ci-dessous un exemple d’erreurs trouvées dans le fichier de logs :
Error: (Zigate) Communication error when transmiting a previous command to 9d58 ieee 90fd9ffffe31f150
Error: (Zigate) Decode8702 - SQN: bc AddrMode: 02 DestAddr: 9d58 SrcEP: 01 DestEP: 01 Status: d4 - Unicast frame does not have a route available but it is buffered for automatic resend
Cela indique que l’objet 90fd9ffffe31f150 n’est pas joignable ou que la ZiGate a un problème de communication avec lui.
E4. Erreur : [E4. Erreur : Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter
Error: (FindModule) Domoticz/DomoticzEx modules not found in interpreter.
Cette erreur apparaît lors de l’arrêt du plugin. Ne pas en tenir compte.
E5. Erreur : Missing module error
Vérifier que le plugin est correctement installé :
- Aller dans le répertoire du plugin Domoticz-Zigbee ou Domoticz-Zigate
- Lancer la commande
ls -l external/dnspython/
Si la réponse est :
total 0
Il faut lancer les commandes
git config --add submodule.recurse true
git submodule update --init --recursive
Vérifier que les dépendances sont bien installées
- Lancer la commande depuis le répertoire du plugin
sudo pip3 install -r requirements.txt
ATTENTION: Sur les Windows, il faut lancer les commandes pip3 install en mode administrateur et ce, dès la première fois. Si cela n’a pas été fait la première fois, il faut désinstaller les modules existants.
E6. Erreur : Error: <Nom du plugin> : You need to setup the URL Base to access the Domoticz JSON/API
Cette erreur apparaît lorsque API base url n’est pas (ou pas bien) paramétrée dans DomoticZ. Se reporter à l’étape 2 Paramétrage du plugin pour plus d’infos.
E7. Erreur lors de la mise à jour des modules python : Building wheel for cryptography (PEP 517) ... error
Cette erreur peut arriver en exécutant les commandes pip3 install -r requirements.txt ou python3 -m pip install -r requirements.txt --upgrade.
ERROR: Failed building wheel for cryptography
Failed to build cryptography
ERROR: Could not build wheels for cryptography which use PEP 517 and cannot be installed directly
-
Mettre à jour le module python wheel
sudo python3 -m pip install wheel --upgrade - S’assurer que le dossier /tmp dispose de suffisamment d’espace libre
- S’assurer qu’il y a suffisamment de swap disponible. En rajouter si nécessaire
E8. Erreur : pkg_resources.VersionConflict: (dnspython 2.3.0 (/usr/local/lib/python3.10/site-packages), Requirement.parse('dnspython==2.2.1'))
Cette erreur peut apparaître lors d’un retour depuis la branche develop vers la branche stable6 : le niveau de version du module dnspython n’est pas le même.
- Lancer la commande depuis le répertoire du plugin
sudo python3 -m pip install -r requirements.txt --upgrade
E9. Erreur : ImportError: PyO3 modules may only be initialized once per interpreter process
Status: Zigpy-Elelabs: Transport mode: ZigpyEZSP
Error: Zigpy-Elelabs: Call to function 'onStart' failed, exception details:
Error: Zigpy-Elelabs: Traceback (most recent call last):
Error: Zigpy-Elelabs: File "/var/lib/domoticz/plugins/Domoticz-Zigbee/plugin.py", line 1537, in onStart
Error: Zigpy-Elelabs: _plugin.onStart()
Error: Zigpy-Elelabs: File "/var/lib/domoticz/plugins/Domoticz-Zigbee/plugin.py", line 602, in onStart
Error: Zigpy-Elelabs: from zigpy.config import (CONF_DEVICE, CONF_DEVICE_PATH,
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/config/init.py", line 32, in <module>
Error: Zigpy-Elelabs: from zigpy.config.validators import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/config/validators.py", line 9, in <module>
Error: Zigpy-Elelabs: import zigpy.zdo.types as zdo_t
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/zdo/init.py", line 10, in <module>
Error: Zigpy-Elelabs: import zigpy.util
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/zigpy/util.py", line 14, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.primitives.ciphers import Cipher
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/hazmat/primitives/ciphers/init.py", line 11, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.primitives.ciphers.base import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/hazmat/primitives/ciphers/base.py", line 10, in <module>
Error: Zigpy-Elelabs: from cryptography.exceptions import (
Error: Zigpy-Elelabs: File "/usr/local/lib/python3.10/site-packages/cryptography/exceptions.py", line 9, in <module>
Error: Zigpy-Elelabs: from cryptography.hazmat.bindings.rust import exceptions as rustexceptions
Error: Zigpy-Elelabs: ImportError: PyO3 modules may only be initialized once per interpreter process
Cette erreur apparaît lors de l’utilisation d’un module python de cryptographie trop récent qui ne sont pas encore compatibles avec le plugin. La commande pour installé une version compatible est :
sudo python3 -m pip install cryptography==40.0.2 --upgrade`
E10. Erreur : [WebServer] Deprecated RType (devices) for API request. Handled via fallback (getdevices), please use correct API Command!
Cette erreur est apparue à la suite de la modification de l’API de DomoticZ dans la version 2023.2.
Il suffit de mettre à jour le plugin en version 7 en suivant les recommandations.
E11. Erreur à l’installation sous Debian 12 : This environment is externally managed. To install Python packages system-wide, try apt install python3-xyz...
L’erreur complète est :
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install.
If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv.
Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed.
Le fonctionnement sous Debian 12 Bookworm nécessite de modifier la commande d’installation par défaut en rajoutant –break-system-packages à la fin soit la commande complète :
sudo pip3 install -r requirements.txt --break-system-packages
Rappel : Cette commande n’est valable que pour une installation sous Debian 12 Bookworm.
E12. Erreur : Error: <Nom du plugin> : ModuleNotFoundError: No module named 'cchardet'
Cette erreur apparaît lorsque vous avez plusieurs sessions du plugin et qu’il n’y a pas la bonne version de la dependance charset-normalizer, vous devez être en 2.0.12
pip show charset-normalizer
ou si python2 est toujours installé
pip3 show charset-normalizer
Si la réponse n’est pas 2.0.12 alors :
pip install --force-reinstall --upgrade charset-normalizer==2.0.12
ou si python2 est toujours installé
pip3 install --force-reinstall --upgrade charset-normalizer==2.0.12