Zigbee2mqtt

[Alain]

Suivi de l'évolution de la solution Zigbee2mqtt sur Domoticz.

06/12/2021 : 1874 dispositifs de 263 vendeurs - version de Zigbee2mqtt : 1.21.2 - version du plugin : 3.1.0-beta
02/01/2022 : 1937 dispositifs de 271 vendeurs - version de Zigbee2mqtt : 1.22.2 - version du plugin : 3.1.0-beta
08/02/2022 : 2029 dispositifs de 284 vendeurs - version de Zigbee2mqtt : 1.23.0 - version de l'interface : 0.6.71
05/03/2022 : 2104 dispositifs de 292 vendeurs - version de Zigbee2mqtt : 1.24.0 - version de l'interface : 0.6.76
03/04/2022 : 2149 dispositifs de 295 vendeurs - version de Zigbee2mqtt : 1.25.0 - version de l'interface : 0.6.80
06/05/2022 : 2195 dispositifs de 301 vendeurs - version de Zigbee2mqtt : 1.25.1 - version de l'interface : 0.6.83
13/07/2022 : 2301 dispositifs de 315 vendeurs - version de Zigbee2mqtt : 1.26.0 - version de l'interface : 0.6.103
02/09/2022 : 2403 dispositifs de 327 vendeurs - version de Zigbee2mqtt : 1.27.2 - version de l'interface : 0.6.110
09/10/2022 : 2466 dispositifs de 336 vendeurs - version de Zigbee2mqtt : 1.28.0 - version de l'interface : 0.6.112
04/11/2022 : 2507 dispositifs de 340 vendeurs - version de Zigbee2mqtt : 1.28.1 - version de l'interface : 0.6.114
02/12/2022 : 2572 dispositifs de 348 vendeurs - version de Zigbee2mqtt : 1.28.4 - version de l'interface : 0.6.119
05/01/2023 : 2640 dispositifs de 351 vendeurs - version de Zigbee2mqtt : 1.29 - version de l'interface : 0.6.121
08/02/2023 : 2719 dispositifs de 357 vendeurs - version de Zigbee2mqtt : 1.30.1 - version de l'interface : 0.6.124
03/03/2023 : 2786 dispositifs de 359 vendeurs - version de Zigbee2mqtt : 1.30.2 - version de l'interface : 0.6.125
04/04/2023 : 2822 dispositifs de 362 vendeurs - version de Zigbee2mqtt : 1.30.3 - version de l'interface : 0.6.127
14/05/2023 : 2880 dispositifs de 370 vendeurs - version de Zigbee2mqtt : 1.30.4 - version de l'interface : 0.6.127
09/06/2023 : 2971 dispositifs de 379 vendeurs - version de Zigbee2mqtt : 1.31.2 - version de l'interface : 0.6.129
24/07/2023 : 3022 dispositifs de 381 vendeurs - version de Zigbee2mqtt : 1.32.1 - version de l'interface : 0.6.129
03/08/2023 : 3089 dispositifs de 389 vendeurs - version de Zigbee2mqtt : 1.32.2 - version de l'interface : 0.6.133
04/09/2023 : 3142 dispositifs de 392 vendeurs - version de Zigbee2mqtt : 1.33 - version de l'interface : 0.6.135
04/10/2023 : 3191 dispositifs de 392 vendeurs - version de Zigbee2mqtt : 1.33.1 - version de l'interface : 0.6.136
07/11/2023 : 3257 dispositifs de 392 vendeurs - version de Zigbee2mqtt : 1.33.2 - version de l'interface : 0.6.142
05/12/2023 : 3326 dispositifs de 400 vendeurs - version de Zigbee2mqtt : 1.34 - version de l'interface : 0.6.147
06/01/2024 : 3386 dispositifs de 400 vendeurs - version de Zigbee2mqtt : 1.35 - version de l'interface : 0.6.150
07/04/2024 : 3523 dispositifs de 415 vendeurs - version de Zigbee2mqtt : 1.36.1 - version de l'interface : 0.6.161
03/06/2024 : 3616 dispositifs de 432 vendeurs - version de Zigbee2mqtt : 1.38 - version de l'interface : 0.7.1
04/07/2024 : 3683 dispositifs de 435 vendeurs - version de Zigbee2mqtt : 1.39 - version de l'interface : 0.7.2
02/08/2024 : 3730 dispositifs de 441 vendeurs - version de Zigbee2mqtt : 1.39.1 - version de l'interface : 0.7.4
02/10/2024 : 3789 dispositifs de 446 vendeurs - version de Zigbee2mqtt : 1.40.2 - version de l'interface : 0.7.4
06/11/2024 : 3900 dispositifs de 451 vendeurs - version de Zigbee2mqtt : 1.41 - version de l'interface : 0.7.4
10/12/2024 : 3986 dispositifs de 457 vendeurs - version de Zigbee2mqtt : 1.42 - version de l'interface : 0.7.6

04/01/2025 : 4073 dispositifs de 470 vendeurs - version de Zigbee2mqtt : 2.0 - Attendre 2/3 mois pour faire la mise à jour

23/05/2025 : 4343 dispositifs de 495 vendeurs - version de Zigbee2mqtt : 2.3 - version de l'interface : 0.9.10
31/08/2025 : 4516 dispositfs de 508 vendeurs - version de Zigbee2mqtt (docker) 2.6 - version de l'interface : 0.9.19
02/10/2025 : 4678 dispositfs de 518 vendeurs - version de Zigbee2mqtt (docker) 2.6.2 - version de l'interface : 2.2.1 Refonte complète de l'interface
02/11/2025 : 4901 dispositfs de 533 vendeurs - version de Zigbee2mqtt (docker) 2.7.0 - version de l'interface : 2.4.2

31/08/2025 - Suite à la mise en place de la solution avec SMLight SLZB-06 la partie ci-dessous n'est plus mise à jour.

Version du firmware - option coordinator - pour le dongle Zigbee 3.0 USB Dongle Plus de Sonoff testé sur la dernière image H64 :

02/12/2022 : CC1352P2_CC2652P_launchpad_coordinator_20220219 - lien : https://github.com/Koenkk/Z-Stack-firmw ... 220219.zip

Version du firmware - option coordinator - pour le stick CC2652RB de slae.sh https://slae.sh/projects/cc2652/ :

08/07/2021 : CC2652RB_coordinator_20210708.zip
17/12/2021 : CC2652RB_coordinator_20211217.zip - lien : https://github.com/Koenkk/Z-Stack-firmw ... _3.x.0/bin
02/09/2022 : CC2652RB_coordinator_20220219.zip - lien : https://github.com/Koenkk/Z-Stack-firmw ... 220219.zip

Attention : les 2 dernières versions de firmware ont la même date mais le nom global est différent - ne pas faire d'erreur.

Version du plugin dans Domoticz - lien vers le site https://github.com/stas-demydiuk/domoti ... qtt-plugin :

02/11/2021 : 3.1.0-beta
30/01/2022 : plus d'utilisation du plugin pour moi suite au passage à MQTT Automatic Discovery dans Domoticz

Pour vérifier si un dispositif est reconnu par Zigbee2mqtt : https://www.zigbee2mqtt.io/supported-devices/
Le github de Zigbee2mqtt : https://github.com/Koenkk/zigbee2mqtt

[Alain]

Ne plus utiliser ce plugin Zigbee2mqtt si vous êtes en MQTT Automatic Discovery

Mise à jour du plugin Zigbee2mqtt utilisé dans Domoticz :

Aller dans le répertoire du plugin

Code : Tout sélectionner

cd /home/pi/domoticz/plugins/zigbee2mqtt

puis lancer la mise à jour

Code : Tout sélectionner

git pull

et relancer Domoticz

Code : Tout sélectionner

sudo service domoticz restart

C'est la méthode classique pour mettre à jour tous les plugins python dans Domoticz.

[Alain]

Pour mettre à jour Zigbee2mqtt (actuellement il y a une mise à jour par mois en début de mois) :

Aller dans le répertoire de Zigbee2mqtt et lancer le shell update.sh

Code : Tout sélectionner

cd /opt/zigbee2mqtt
./update.sh

Ne pas tenir compte des messages de warning.

Ou bien manuellement :

Code : Tout sélectionner

cd /opt/zigbee2mqtt
sudo service zigbee2mqtt stop
cp -R data data-backup
git checkout HEAD -- npm-shrinkwrap.json
git pull
npm ci
cp -R data-backup/* data
sudo service zigbee2mqtt start
rm -rf data-backup

Les données sont sauvegardées dans le répertoire data-backup et restaurées ensuite, ce répertoire peut être conservé comme sauvegarde.
Les mises à jour permettent l'utilisation des dispositifs rajoutés depuis la version précédente.

[Alain]

Opérations à réaliser une seule fois pour créer l'environnement nécessaire au flashage du firmware sur le dongle usb CC2652RB. Ces outils sont intégrés dans l'image H64.

Vérification de la version de python 3 (qui ne doit pas être inférieure à 3.4) et installation du programme python de flashage, en étant positionné dans le répertoire /data de zigbee2mqtt ainsi le script sera sauvegardé avec /data chaque nuit

Code : Tout sélectionner

cd /opt/zigbee2mqtt/data
python3 --version
git clone https://github.com/JelmerT/cc2538-bsl.git

Vérification de la version de python 3 installée et installation du script python qui réalise le flashage

Installation des dépendances et vérification de la bonne exécution du script en listant les options possibles depuis le répertoire /cc2538-bsl

Code : Tout sélectionner

cd cc2538-bsl
pip3 install pyserial
pip3 install intelhex
pip3 install python-magic
./cc2538-bsl.py -h

Installation des dépendances et affichage des options

Installation d'un programme de test pour vérifier le port utilisé et la version installée
fichier à downloader : http://gofile.me/6qA2m/zzfkie8Q8 (insister même si vous avez des messages liés à la sécurité )
à copier dans le répertoire /opt/zigbee2mqtt/data/cc2538-bsl et à rendre exécutable

Code : Tout sélectionner

chmod +x test.py

Le programme est installé dans l'image H64.

Avant le test, il faut stopper tous les accès au dongle CC2652RB

Code : Tout sélectionner

sudo service zigbee2mqtt stop
python3 ./test.py

Contrôle du port et de la version de firmware installée

[Alain]

Actions à réaliser à chaque nouveau flashage du firmware sur un dongle CC2652RB de slae.sh

Downloader le firmware désiré depuis le github

Code : Tout sélectionner

https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator/Z-Stack_3.x.0/bin

Décompresser le fichier .zip qui a été récupéré (depuis un Pi ou un PC/Mac) et transférer le fichier .hex avec Filezilla sur le Pi qui utilise le dongle dans le répertoire /opt/zigbee2mqtt/data/cc2538-bsl

Fichiers .zip et .hex du firmware de décembre 2021

Vérifier le port usb à utiliser pour le flashage, dans l'exemple c'est USB0

Code : Tout sélectionner

ls -l /dev/serial/by-id

Contrôle du port usb du dongle CC2652RB

Vérifier aussi avec l'outil test.py avant et après le flashage du firmware (voir dans le message ci-dessus)

Changer le nom du dongle en fonction de ce que vous obtenez avec l'outil test.py.

Changement de firmware dans mon cas (après arrêt de Zigbee2mqtt et en étant dans le répertoire /opt/zigbee2mqtt/data/cc2538-bsl :

Code : Tout sélectionner

sudo service zigbee2mqtt stop
cd /opt/zigbee2mqtt/data/cc2538-bsl
./cc2538-bsl.py -p /dev/serial/by-id/usb-Silicon_Labs_slae.sh_cc2652rb_stick_-_slaesh_s_iot_stuff_00_12_4B_00_23_93_37_0D-if00-port0 -evw CC2652RB_coordinator_20211217.hex

Opération de changement de firmware sur le dongle CC2652RB

Vérification dans l'interface de Domoticz après redémarrage de Zigbee2mqtt (si on utilise le plugin) :

Contrôle des versions en haut à droite de l'écran

Dans Paramètres + A Propos on peut vérifier les versions du produit (sans le plugin) :

Vérification des versions dans l'interface Zigbee2MQTT

[Alain]

Après avoir mis à jour la version de Zigbee2mqtt et changé la version du firmware du dongle, j'ai testé la mise à du firmware sur une ampoule Ikea et ça fonctionne Je suis assez bluffé
Voici les étapes de l'opération (25 minutes environ) :
Dans l'onglet MàJ OTA de l'interface Zigbee2mqtt, on lance la mise à jour pour le dispositif souhaité (tous les dispositifs ne disposent pas de cette option).

Lorsque la mise à jour est lancée, il y a une indication dans la liste des périphériques

il y a aussi un affichage en bas à droite de la fenêtre qui indique la progression

On peut aussi suivre l'évolution dans l'onglet des journaux

Version du firmware avant la mise à jour

Fin de l'opération

Version après la mise à jour (la date du firmware n'a pas été mise à jour !)

[Alain]

J'ai trouvé une particularité pour la configuration de 2 dispositifs : le switch on/off E1743 d'Ikea et le bouton rond WXKG01LM de Xiaomi (click/long click/double click/etc.).
Pour savoir si vos dispositifs ont des particularités, il faut aller dans la description des dispositifs du site zigbee2mqtt : https://www.zigbee2mqtt.io/devices/WXKG01LM.html. C'est aussi là que l'on trouve la façon d'appairer les dispositifs.
Dans le fichier configuration.yaml qui se trouve dans /opt/zigbee2mqtt/data, il faut rajouter une ligne (legacy: false) dans la description du dispositif.

Code : Tout sélectionner

devices:
  '0x12345678':
    friendly_name: my_device
    legacy: false

Avant de faire la modification, il est prudent de stopper zigbee2mqtt
Ce qui donne :

Code : Tout sélectionner

sudo service zigbee2mqtt stop
cd /opt/zigbee2mqtt/data
sudo nano configuration.yaml
sudo service zigbee2mqtt start
sudo service zigbee2mqtt status

Si je suis confronté à des cas particuliers similaires, je rajouterais l'information ici. N'hésitez pas à faire de même

[Alain]

Attention : La nouvelle version de zigbee2mqtt de début janvier 2024 (version 2.0) contient de nombreux changements qui semblent délicats à maîtriser/corriger selon les retours de certains utilisateurs

Lien vers la discussion sur le sujet : https://github.com/Koenkk/zigbee2mqtt/discussions/24198

Je recommande de rester dans la version actuelle en attendant une stabilisation de cette nouvelle version.

Pour préparer la migration, il faut cependant faire quelques modifications dans le fichier configuration.yaml dans /opt/zigbee2mqtt/data :

Code : Tout sélectionner

advanced:
     homeassistant_legacy_entity_attributes: false
     homeassistant_legacy_triggers: false
     legacy_api: false
     legacy_availability_payload: false
device_options:
     legacy: false

Modifications faites sans conséquences visibles pour l'instant à Gradignan.

[Alain]

SMLIGHT SLZB-06

Été 2025 - Changement de mode de connexion !

Passage à un module SMLight SLZB-06 en remplacement du dongle zigbee raccordé en usb sur le Raspberry Domoticz.

Le module SLZB-06 est un élément autonome à base d'ESP32 qui est raccordé sur le réseau local en RJ45 (il est aussi possible de le connecter en wifi). Son emplacement est donc indépendant de la machine Domoticz.
Dans mon cas, le SLZB-06 est installé dans mon grenier pour une meilleure couverture zigbee. Il communique avec Zigbee2mqtt qui est installé sur mon serveur Proxmox Soyo dans mon bureau dans une VM Debian. Zigbee2mqtt tourne dans un container Docker et il communique via Mosquitto (qui est aussi installé dans un container Docker de la même VM) avec Domoticz lui qui est toujours sur le même Raspberry qu'avant.

Le SLZB-06 dispose d'une interface web pour la configuration, c'est beaucoup plus simple qu'avec un dongle usb. L'antenne est aussi plus efficace.

Interface de gestion du SLZB-06

Quelques liens utiles sur les produits SMlight :

• https://www.domo-blog.fr/optimisez-domo ... e2mqtt-zha
• https://smlight.tech//
• https://zatoufly.fr/quel-dongle-smlight ... andations/

J'allais oublier le prix !

Tarif TTC port compris