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.

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

Outil requis :

NuméroLien
1xJeu de tournevis  Acheter sur Amazon
1xLecteur de carte SD  Acheter sur Amazon

Matériel requis :

NuméroLien
1xClé USB SONOFF Zigbee 3.0 Plus  Acheter sur Amazon
1xCâble d'extension USB  Acheter sur Amazon
1x Raspberry Pi  Acheter sur Amazon
1x Adaptateur secteur Raspberry Pi  Acheter sur Amazon
1x Boîtier Raspberry Pi  Acheter sur Amazon
1x Carte Micro SD 64 Go  Acheter sur Amazon


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.


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.

Affichage du menu de sélection de la langue sur la page d'accueil du tableau de bord.


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.

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.

Vue d'ensemble de l'appareil dans zigbee2mqtt. Tous les appareils Zigbee enregistrés sont répertoriés ici.


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.

Affichage de l'onglet Tableau de bord dans l'onglet zigbee2mqtt.

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.

Dans la carte du réseau chargée, vous pouvez alors voir un aperçu des appareils Zigbee connectés. Les appareils connectés avec des lignes bleues sont les différents routeurs du réseau. Divers terminaux (principalement alimentés par batterie) y sont connectés (via des lignes vertes).


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.

Vue de l'onglet Paramètres dans le tableau de bord 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.

Vue de l'onglet Groupe dans le tableau de bord zigbee2mqtt.


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.

Vue de l'onglet OTA dans le tableau de bord zigbee2mqtt. Ici, vous pouvez voir des informations sur les appareils disponibles, leur état de firmware et si une mise à jour est disponible. Si une mise à jour est disponible, vous pouvez également l'exécuter à partir d'ici.


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.


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.

Affichage des messages dans l'onglet journal zigbee2mqtt.


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.

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é.


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é. 🙂

Achetez-moi un café sur ko-fi.com       

6 commentaires

  1. Merci pour la série d'articles sur zigbee2mqtt. Jusqu'à présent, j'ai implémenté cette fonction avec homegear, puis créé mes raccourcis dans NodeRED. Cela me semble beaucoup plus confortable !

  2. Bonjour, je m'appelle Dietmar,
    Je l'ai essayé et tout fonctionne jusqu'au tableau de bord. Zigbee2mQtt a également bien passé le test.
    Cependant, je ne peux pas accéder au dashbord. J'ai effectué les entrées dans le fichier "configuration", mais lorsque j'essaie d'y accéder depuis l'extérieur, j'obtiens un message indiquant que la page n'est pas accessible. Où ai-je oublié quelque chose ? La clé a-t-elle sa propre adresse ? Je pense que c'est plutôt moi.
    Je suis reconnaissant pour toute aide.
    Cordialement
    Dietmar

    1. Salut Dietmar,
      Pouvez-vous vérifier si vous avez utilisé le bon port lors de l'appel de l'adresse ?
      Si vous avez défini le port 8080 dans la configuration, vous devez appeler le tableau de bord comme suit : http://:ADRESSE_DES_PIS:8080
      Je viens de réaliser que mon exemple est un peu trompeur à cet égard. 🙂
      Cordialement
      Fabien

      1. Bonjour Fabien,
        merci beaucoup pour la réponse rapide.
        Oui, j'ai entré le port, j'ai même défini le port explicitement dans le routeur pour le Raspi à titre de test.
        Mais n'a rien apporté.
        Donc, comme je l'ai dit, Zigbee2mqtt a bien passé le test.
        Cordialement
        Dietmar
        PS : Sous ADRESSE_DES_PIS j'entre l'adresse XXX.XXX.XXX.YYY

  3. Bonjour Dietmar,
    SUPER résumé !! Vous avez peut-être une idée pour regrouper puis piloter les vannes thermostatiques des radiateurs ? (j'arrive à me regrouper - dans mon cas avec plusieurs vannes HAMA/Saswell) MAIS comment contrôlez-vous le tout ?? Je peux créer des scènes via le WebGui - mais d'une manière ou d'une autre, elles n'ont aucune fonction, ou le réglage des vannes individuelles ne change pas lorsqu'elles sont appelées via le WebGui). Cela devient encore plus obscur lorsque je veux ensuite contrôler le groupe dans DOMOTIZ - tout n'est qu'un simple interrupteur.

Kommentar hinterlassen

Votre adresse e-mail ne sera pas publiée. Erforderliche Felder sind mit * markiert

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.