HowTo: Zigbee - Beheer van Zigbee2mqtt via het Dashboard

Aanvankelijk kon Zigbee2mqtt alleen worden geactiveerd via het configuratiebestand of toegang tot de MQTT-server configureren en controleren.

Er is nu echter een zeer handige extensie voor cigbee2mqtt die het mogelijk maakt om zigbee2mqtt te configureren via een geïntegreerde webserver. Je bezoekt dus gewoon een website die bereikbaar is via dezelfde Raspberry Pi waarop zigbee2mqtt is geïnstalleerd.

Alle configuratiemogelijkheden worden daar dan op een overzichtelijke en elegante manier ter beschikking gesteld. U hoeft niet meer door het configuratiebestand te worstelen en kunt alles gemakkelijk vanuit de browser configureren.

Ik heb informatie samengevat over het activeren van het dashboard van zigbee2mqtt en een kort overzicht van de functies in het volgende artikel.

Veiligheidsinstructies

Ik weet dat de volgende opmerkingen altijd een beetje vervelend zijn en onnodig lijken. Helaas hebben veel mensen die "beter" wisten door onvoorzichtigheid ogen, vingers of andere dingen verloren of zichzelf verwond. Gegevensverlies is in vergelijking bijna te verwaarlozen, maar zelfs dit kan erg vervelend zijn. Neem daarom vijf minuten de tijd om de veiligheidsinstructies te lezen. Omdat zelfs het coolste project geen blessure of andere problemen waard is.
https://www.nerdiy.de/sicherheitshinweise/

Affiliate links / reclame links

De hier vermelde links naar online winkels zijn zogenaamde affiliate-links. Als u op zo'n affiliate-link klikt en via deze link een aankoop doet, ontvangt Nerdiy.de een commissie van de betreffende onlineshop of aanbieder. De prijs verandert voor jou niet. Als u via deze links uw aankopen doet, steunt u Nerdiy.de om in de toekomst andere nuttige projecten aan te kunnen bieden. 🙂 

Eisen

Handige artikelen:
Voordat je aan dit artikel begint, moet je een RaspberryPi hebben voorbereid zodat deze via het netwerk kan worden bereikt en via SSH kan worden bestuurd. Daarnaast moet zigbee2mqtt natuurlijk al geïnstalleerd zijn.

In de volgende artikelen wordt beschreven wat er moet gebeuren om de RaspberryPi voor te bereiden.

• Zigbee - Zigbee2mqtt installeren op de Raspberry Pi
• Zigbee - registreer apparaten, sensoren en actuatoren met zigbee2mqtt

In de volgende lijsten vindt u alle onderdelen die u nodig heeft om dit artikel te implementeren.

Vereist gereedschap:

Benodigd materiaal:

Schakel het Zigbee2mqtt-dashboard in

Standaard is het zigbee2mqtt dashboard (nog) niet ingeschakeld.

Om het te activeren, volstaat een simpele invoer in het zigbee2mqtt-configuratiebestand.

Open hiervoor het configuratiebestand met de volgende bash-opdracht.

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

Gebruik vervolgens de pijltjestoetsen om naar het einde van het configuratiebestand te navigeren en voeg het onderstaande deel toe aan het configuratiebestand.

U moet zeker het wachtwoord (auth_token) wijzigen. Dit is later nodig om het dashboard te openen.

frontend: poort: 8080 host: 0.0.0.0 auth_token: secretPassword url: https://url.org

Meer informatie over de configuratiemogelijkheden van het dashboard vindt u onder de volgende link.

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

Ga naar het dashboard

Het dashboard is te openen via een eenvoudige webbrowser. Het enige wat je hoeft te doen is het adres in te voeren van de Raspberry Pi waarop zigbee2mqtt is geïnstalleerd in de adresbalk van je browser. Het is belangrijk dat u de in het configuratiebestand gedefinieerde poort toevoegt aan het adres.

Als de Raspberry Pi bijvoorbeeld toegankelijk is op het adres "ADDRESS_DES_PIS" en de geconfigureerde poort is "8083", dan zou je het zigbee2mqtt dashboard bereiken op het volgende adres.

• http:// ADDRESS_DES_PIS :8038/

De taal instellen

De eerste instelling die je waarschijnlijk wilt wijzigen, is de taal van het dashboard.

Via een eenvoudig menu stel je het dashboard in op de door jou gewenste taal. Klik gewoon op het vlagsymbool in de bovenste menubalk van het dashboard en selecteer de gewenste taal.

Registreer nieuwe apparaten bij zigbee2mqtt

Ook nieuwe zigbee toestellen registreer je eenvoudig via het dashboard. In het verleden moest het configuratiebestand gewijzigd worden of moesten er berichten verstuurd worden via MQTT.

Het dashboard maakt dit proces veel eenvoudiger. Eén klik is voldoende en met zigbee2mqtt kunt u nieuwe Zigbee-sensoren of -actuatoren toevoegen.

Hoe Zigbee-apparaten toe te voegen, heb ik ook in meer detail beschreven in het volgende artikel.

• Zigbee - registreer apparaten, sensoren en actuatoren met zigbee2mqtt

Om nieuwe apparaten aan zigbee2mqtt toe te voegen, klikt u gewoon op de knop in de bovenste menubalk.

Het is dan mogelijk om nieuwe Zigbee-apparaten toe te voegen.

Deze toestemming wordt na 255 seconden automatisch gedeactiveerd.

Geef een overzicht weer van de apparaten die zijn geregistreerd bij zigbee2mqtt

Nu een paar woorden over de afzonderlijke menu-items van het zigbe2mqtt-dashboard.

In de bovenste menubalk onder het tabblad "Devices" kun je alle apparaten bekijken die geregistreerd zijn bij je zigbee2mqtt installatie. Hier zie je in één oogopslag de "Friendly Name", het IEEE-adres, de fabrikant, het model, de signaalsterkte en, indien van toepassing, de laadstatus. Het laatste pictogram geeft ook aan of het betreffende apparaat wordt gevoed door een batterij of door netvoeding.

Dashboard door zigbee2mqtt

Het volgende tabblad in het dashboard menu is het tabblad "Dashboard". Hier staan ook de meeste Zigbee apparaten. Het verschil hier is dat de geregistreerde apparaten ook bestuurd of uitgelezen kunnen worden.

Hiervoor worden de afzonderlijke Zigbee-apparaten gecombineerd in tegels. Elke tegel vertegenwoordigt een Zigbee-apparaat. Het uiterlijk van de tegel is afhankelijk van het apparaattype.

Aan de linkerkant ziet u de weergave van de dashboardtegel voor één Xiaomi Aqara MCCGQ11LM deur- of raamsensor.

De volgende gegevens kunnen worden bekeken:

1. vriendelijke naam
2. Eerste statusnaam
3. Tweede statusnaam
4. staat van de eerste staat
5. staat van de tweede staat
6. "Tijdstempel "Laatst gezien
7. Receptie Sterkte Icoon
8. Ontvangststerkte in het waardebereik 0-255 (groter beter)
9. Ladingstoestand of soort levering

Aan de linkerkant ziet u de weergave van de dashboardtegel voor een IKEA lamp LED1903C5/LED1835C6.

De volgende gegevens kunnen worden bekeken:

1. vriendelijke naam
2. Eerste statusnaam
3. Tweede statusnaam
4. Derde statusnaam
5. staat van de eerste staat
6. staat van de tweede staat
7. staat van de derde staat
8. "Tijdstempel "Laatst gezien
9. Receptie Sterkte Icoon
10. Ontvangststerkte in het waardebereik 0-255 (groter beter)
11. Ladingstoestand of soort levering

Toon kaart / netwerkkaart van de apparaten die zijn geregistreerd bij zigbee2mqtt

Een heel coole functie om een overzicht te krijgen van de aangesloten apparaten is het kaarttabblad.

Hierin worden niet alleen alle apparaten getoond. Ook is te zien hoe deze met elkaar verbonden zijn. Sommige eindapparaten zijn niet altijd direct aangesloten op de Zigbee USB dongle. Veel apparaten op netstroom functioneren ook als repeaters of routers voor het Zigbee-netwerk. Via een router kan een eindapparaat indirect op de Zigbee USB-dongle worden aangesloten. Een dergelijke configuratie is goed zichtbaar met behulp van de kaartweergave.

Om de netwerkkaart weer te geven, moet je eerst op de knop "Kaart laden" klikken.

Hiermee wordt de netwerkconfiguratie opgehaald en kort daarna weergegeven.

Zigbee2Mqtt configureren/inrichten

De meeste instellingen voor zigbee2mqtt zijn verborgen achter het tabblad Instellingen.

U kunt de meeste instellingen hier configureren zonder het configuratiebestand van zigbee2mqtt te hoeven bewerken.

Apparaten groeperen

Een andere handige functie zit verborgen achter het tabblad Groepen. Hier kun je Zigbee apparaten groeperen.

Zo kunnen bijvoorbeeld twee of meer lampen worden gegroepeerd en centraal worden aangestuurd. Schakelcommando's worden zo parallel aan elke lamp in de groep doorgegeven. Dit is bijvoorbeeld handig als je alle lampen in een kroonluchter tegelijk wilt schakelen.

Start een OTA-update (Over the Air).

Het tabblad OTA biedt de mogelijkheid (indien beschikbaar) om een over-the-air (OTA) update uit te voeren op de Zigbee-apparaten.

Dus als er nieuwe firmware beschikbaar is voor uw Zigbee-sensoren of -actuatoren, kunt u deze eenvoudig met een simpele klik naar het betreffende apparaat overbrengen.

Gebruik de Touchlink-functie met zigbee2mqtt

De opties voor de Touchlink-functie vindt u op het tabblad Touchlink. Deze functie is vooral bekend van IKEA Zigbee apparaten en is handig als je snel en eenvoudig apparaten wilt koppelen.

Hiervoor moet u de Touchlink-functie activeren en het aan te sluiten apparaat in de buurt van het Zigbee-basisstation plaatsen (bijv. Sonoff zigbee 3.0 USB Dongle Plus) uitstel.

In het volgende artikel vind je ook informatie over het toevoegen van apparaten aan je Zigbee-netwerk.

• Zigbee - registreer apparaten, sensoren en actuatoren met zigbee2mqtt

Toon logboek van zigbee2mqtt

Het is vooral handig om de logoutput van zigbee2mqtt te kunnen weergeven voor het debuggen en registreren van nieuwe Zigbee-apparaten.

In de logs tab kun je (afhankelijk van het ingestelde logniveau) alle statusveranderingen in zigbee2mqtt zien.
Met behulp van eenvoudige filteropties kunt u ook instellen welke berichten u wilt zien en op welk logniveau ze moeten worden gefilterd.

Schakel het thema tussen lichte en donkere modus

Met het zon- of maanpictogram kunt u het uiterlijk van uw zigbee2mqtt-dashboard wijzigen tussen donker en licht ontwerp. Klik gewoon op de rood gemarkeerde pictogrammen en het ontwerp wordt dienovereenkomstig aangepast.

Links zie je de "heldere" weergave van het dashboard van zigbee2mqtt.

Door op de zon in het rode gebied te klikken, kunt u het ontwerp naar het donkere ontwerp schakelen.

Hier zie je de "donkere" weergave van het dashboard van zigbee2mqtt.

Door op de maan in het rood gemarkeerde gebied te klikken, kunt u het ontwerp omschakelen naar het lichtontwerp.

Meer artikelen over het onderwerp

Ik heb andere artikelen over het onderwerp Zigbee en zigbee2mqtt samengevat in de volgende categorie. Daar vind je ook artikelen over verschillende Zigbee-apparaten en hoe ze eruit zien NodeRed kan worden gecontroleerd.

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

In de volgende categorie heb ik ook enkele Zigbee-apparaten opgesomd die kunnen worden aangestuurd of uitgelezen met de daar aangeboden NodeRed-code.

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

Veel plezier met het project

Ik hoop dat alles werkte zoals beschreven. Zo niet, of als je vragen of suggesties hebt, laat het me weten in de commentaren. Ik zal dit dan zo nodig aan het artikel toevoegen.
Ideeën voor nieuwe projecten zijn altijd welkom. 🙂

PS Veel van deze projecten - vooral de hardwareprojecten - kosten veel tijd en geld. Natuurlijk doe ik dit omdat ik het leuk vind, maar als je het cool vindt dat ik de informatie met je deel, dan zou ik blij zijn met een kleine donatie aan het koffiefonds. 🙂