HowTo : Zigbee - Administration de Zigbee2mqtt à partir du tableau de bord

Initialement, Zigbee2mqtt ne pouvait être activé que via le fichier de configuration ou l'accès au Serveur MQTT configurer et contrôler.

Cependant, il existe maintenant une extension très utile pour zigbee2mqtt qui permet de configurer zigbee2mqtt via un serveur web intégré. Cela signifie que vous visitez simplement un site Web accessible via le même Raspberry Pi sur lequel zigbee2mqtt est installé.

Toutes les options de configuration y sont alors rendues disponibles de manière claire et élégante. Vous n'avez plus à vous débattre avec le fichier de configuration et pouvez tout configurer facilement à partir du navigateur.

J'ai résumé les informations sur la façon d'activer le tableau de bord de zigbee2mqtt et un bref aperçu des fonctions dans l'article suivant.

Consignes de sécurité

Je sais que les notes suivantes sont toujours un peu ennuyeuses et semblent inutiles. Malheureusement, de nombreuses personnes qui savaient "mieux" ont perdu des yeux, des doigts ou d'autres choses à cause d'une négligence ou se sont blessées. La perte de données est presque négligeable en comparaison, mais même celles-ci peuvent être vraiment ennuyeuses. Par conséquent, veuillez prendre cinq minutes pour lire les consignes de sécurité. Parce que même le projet le plus cool ne vaut pas une blessure ou d'autres problèmes.
https://www.nerdiy.de/sicherheitshinweise/

Liens d'affiliation/publicitaires

Les liens vers des boutiques en ligne répertoriés ici sont des liens dits d'affiliation. Si vous cliquez sur un tel lien d'affiliation et effectuez un achat via ce lien, Nerdiy.de recevra une commission de la boutique en ligne ou du fournisseur concerné. Le prix ne change pas pour vous. Si vous effectuez vos achats via ces liens, vous aidez Nerdiy.de à pouvoir proposer d'autres projets utiles à l'avenir. 🙂 

Conditions préalables

Articles utiles :
Avant de commencer cet article, vous devez avoir préparé un RaspberryPi pour qu'il soit accessible via le réseau et contrôlé via SSH. De plus, zigbee2mqtt doit bien sûr déjà être installé.

Les articles suivants décrivent ce qui doit être fait pour préparer le RaspberryPi.

• Zigbee - Installation de zigbee2mqtt sur le Raspberry Pi
• Zigbee - enregistrer des appareils, des capteurs et des actionneurs avec zigbee2mqtt

Dans les listes suivantes, vous trouverez toutes les pièces dont vous avez besoin pour mettre en œuvre cet article.

Outil requis :

Matériel requis :

Activer le tableau de bord Zigbee2mqtt

Par défaut, le tableau de bord zigbee2mqtt n'est pas (encore) activé.

Pour l'activer, une simple entrée dans le fichier de configuration zigbee2mqtt suffit.

Pour ce faire, ouvrez le fichier de configuration avec la commande bash suivante.

sudo nano /opt/zigbee2mqtt/data/configuration.yaml

Utilisez ensuite les touches fléchées pour naviguer jusqu'à la fin du fichier de configuration et ajoutez la partie ci-dessous au fichier de configuration.

Vous devez absolument changer le mot de passe (auth_token). Cela sera nécessaire plus tard pour ouvrir le tableau de bord.

interface : port : 8080 hôte : 0.0.0.0 auth_token : secretPassword URL : https://url.org

Vous pouvez trouver plus d'informations sur les options de configuration du tableau de bord sous le lien suivant.

• https://www.zigbee2mqtt.io/guide/configuration/frontend.html#nginx-proxy-configuration

Aller au tableau de bord

Le tableau de bord peut être ouvert via un simple navigateur Web. Il vous suffit de saisir l'adresse du Raspberry Pi sur lequel zigbee2mqtt est installé dans la barre d'adresse de votre navigateur. Il est important que vous ajoutiez le port défini dans le fichier de configuration à l'adresse.

Par exemple, si le Raspberry Pi est accessible à l'adresse "ADRESSE_DES_PIS" et que le port configuré est "8083", vous pourrez accéder au tableau de bord zigbee2mqtt à l'adresse suivante.

• http:// ADRESSE_DES_PIS :8038/

Réglage de la langue

Le premier paramètre que vous voudrez probablement modifier est la langue du tableau de bord.

Vous pouvez régler le tableau de bord dans la langue de votre choix via un menu simple. Cliquez simplement sur le symbole du drapeau dans la barre de menu supérieure du tableau de bord et sélectionnez la langue souhaitée.

Enregistrez de nouveaux appareils sur zigbee2mqtt

Vous pouvez également enregistrer facilement de nouveaux appareils zigbee via le tableau de bord. Auparavant, il fallait modifier le fichier de configuration ou envoyer des messages via MQTT.

Le tableau de bord rend ce processus beaucoup plus facile. Un clic suffit et zigbee2mqtt permet d'ajouter de nouveaux capteurs ou actionneurs Zigbee.

Comment ajouter des appareils Zigbee que j'ai également décrit plus en détail dans l'article suivant.

• Zigbee - enregistrer des appareils, des capteurs et des actionneurs avec zigbee2mqtt

Pour ajouter de nouveaux appareils à zigbee2mqtt, cliquez simplement sur le bouton affiché dans la barre de menu supérieure.

Il est alors possible d'ajouter de nouveaux appareils Zigbee.

Cette autorisation est automatiquement désactivée après 255 secondes.

Afficher un aperçu des appareils enregistrés sur zigbee2mqtt

Maintenant, quelques mots sur les éléments de menu individuels du tableau de bord zigbe2mqtt.

Dans la barre de menu supérieure, sous l'onglet "Devices", vous pouvez voir tous les appareils connectés à votre installation zigbee2mqtt. Ici, vous pouvez voir en un coup d'œil le "Friendly Name", l'adresse IEEE, le fabricant, le modèle, l'intensité du signal et, le cas échéant, l'état de charge. La dernière icône indique en outre si l'appareil en question est alimenté par une batterie ou par le secteur.

Tableau de bord par zigbee2mqtt

L'onglet suivant dans le menu du Dashboard est l'onglet "Dashboard". Ici aussi, la plupart des appareils Zigbee sont répertoriés. La différence ici est que les appareils inscrits peuvent également être contrôlés ou lus.

À cette fin, les appareils Zigbee individuels sont combinés en tuiles. Chaque tuile représente un appareil Zigbee. L'apparence de la vignette varie en fonction du type d'appareil.

Sur la gauche, vous pouvez voir la vue de la vignette du tableau de bord pour un Capteur de porte ou de fenêtre Xiaomi Aqara MCCGQ11LM.

Les données suivantes peuvent être visualisées :

1. nom familier
2. Premier nom de statut
3. Nom du deuxième statut
4. état du premier état
5. état du second état
6. "Horodatage "dernier vu
7. Icône de force de réception
8. Force de réception dans la plage de valeurs 0-255 (plus grand, mieux)
9. État de charge ou type d'alimentation

Sur la gauche, vous pouvez voir la vue de la vignette du tableau de bord pour un Lampe IKEA LED1903C5/LED1835C6.

Les données suivantes peuvent être visualisées :

1. nom familier
2. Premier nom de statut
3. Nom du deuxième statut
4. Nom du troisième statut
5. état du premier état
6. état du second état
7. état du tiers état
8. "Horodatage "dernier vu
9. Icône de force de réception
10. Force de réception dans la plage de valeurs 0-255 (plus grand, mieux)
11. État de charge ou type d'alimentation

Afficher la carte / la carte du réseau des appareils enregistrés sur zigbee2mqtt

Une fonctionnalité vraiment intéressante pour avoir un aperçu des appareils connectés est l'onglet carte.

En cela, non seulement tous les appareils sont affichés. Il est également visible comment ceux-ci sont connectés les uns aux autres. Certains terminaux ne sont pas toujours directement connectés au dongle USB Zigbee. De nombreux appareils alimentés par le secteur fonctionnent également comme des répéteurs ou des routeurs pour le réseau Zigbee. Un terminal peut être indirectement connecté au dongle USB Zigbee via un routeur. Une telle configuration est très visible à l'aide de la vue cartographique.

Pour que la carte du réseau s'affiche, vous devez d'abord cliquer sur le bouton "Load Map".

Cela récupère la configuration réseau et l'affiche peu de temps après.

Configurer / mettre en place Zigbee2Mqtt

La plupart des paramètres de zigbee2mqtt sont cachés derrière l'onglet Paramètres.

Vous pouvez configurer la plupart des paramètres ici sans avoir à modifier le fichier de configuration zigbee2mqtt.

Regrouper les appareils

Une autre fonction utile est cachée derrière l'onglet Groupes. Ici, vous pouvez regrouper les appareils Zigbee.

Par exemple, deux lampes ou plus peuvent être regroupées et contrôlées de manière centralisée. Les commandes de commutation sont ainsi transmises en parallèle à chaque lampe du groupe. Ceci est utile, par exemple, si vous souhaitez allumer toutes les lampes d'un lustre en même temps.

Lancer une mise à jour en direct (OTA)

L'onglet OTA offre la possibilité (si disponible) d'exécuter une mise à jour en direct (OTA) sur les appareils Zigbee.

Ainsi, si un nouveau firmware est disponible pour vos capteurs ou actionneurs Zigbee, vous pouvez facilement le transférer sur l'appareil respectif d'un simple clic.

Utiliser la fonction Touchlink avec zigbee2mqtt

Vous trouverez les options de la fonction Touchlink dans l'onglet Touchlink. Cette fonction est principalement connue des appareils IKEA Zigbee et est utile si vous souhaitez connecter des appareils rapidement et facilement.

Pour ce faire, vous devez activer la fonction Touchlink et placer l'appareil à connecter à proximité de la station de base Zigbee (par exemple, le Clé USB Sonoff zigbee 3.0 Plus) prise.

Vous pouvez également trouver des informations sur la façon d'ajouter des appareils à votre réseau Zigbee dans l'article suivant.

• Zigbee - enregistrer des appareils, des capteurs et des actionneurs avec zigbee2mqtt

Afficher le journal de zigbee2mqtt

Il est particulièrement utile de pouvoir afficher la sortie du journal de zigbee2mqtt pour le débogage et l'enregistrement de nouveaux appareils Zigbee.

Dans l'onglet journaux, vous pouvez (selon le niveau de journal défini) voir tous les changements d'état dans zigbee2mqtt.
À l'aide d'options de filtrage simples, vous pouvez également définir les messages que vous souhaitez voir et selon quel niveau de journalisation ils doivent être filtrés.

Basculer le thème entre le mode clair et le mode sombre

Avec l'icône du soleil ou de la lune, vous pouvez changer l'apparence de votre tableau de bord zigbee2mqtt entre un design sombre et clair. Cliquez simplement sur les icônes marquées en rouge et le design sera ajusté en conséquence.

À gauche, vous voyez la vue "claire" du tableau de bord de zigbee2mqtt.

En cliquant sur le soleil dans la zone rouge, vous pouvez passer du design au design sombre.

Voici la vue "sombre" du tableau de bord de zigbee2mqtt.

En cliquant sur la lune dans la zone marquée en rouge, vous pouvez passer du design au design lumineux.

Plus d'articles sur le sujet

J'ai résumé d'autres articles sur le sujet de Zigbee et zigbee2mqtt dans la catégorie suivante. Vous y trouverez également des articles sur divers appareils Zigbee et leur apparence NodeRed peut être contrôlée.

• https://nerdiy.de/category/smarthome/zigbee/

Dans la catégorie suivante, j'ai également répertorié certains appareils Zigbee qui peuvent être contrôlés ou lus avec le code NodeRed qui y est proposé.

• https://nerdiy.de/category/zigbee-geraet/

Amusez-vous avec le projet

J'espère que tout a fonctionné comme décrit. Si ce n'est pas le cas ou si vous avez des questions ou des suggestions, faites-le moi savoir dans les commentaires. Je les ajouterai à l'article si nécessaire.
Les idées de nouveaux projets sont toujours les bienvenues. 🙂

PS Beaucoup de ces projets - en particulier les projets matériels - coûtent beaucoup de temps et d'argent. Bien sûr, je le fais parce que j'aime ça, mais si vous pensez que c'est cool que je partage l'information avec vous, je serais heureux d'un petit don au fonds du café. 🙂