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.

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

Vereist gereedschap:

NummerLink
1xSchroevendraaierset  Kopen bij Amazon
1xSD-kaartlezer  Kopen bij Amazon

Benodigd materiaal:

NummerLink
1xSONOFF Zigbee 3.0 USB Dongle Plus  Kopen bij Amazon
1xUSB-verlengkabel  Kopen bij Amazon
1x Raspberry Pi  Kopen bij Amazon
1x Raspberry Pi voeding  Kopen bij Amazon
1x Raspberry Pi behuizing  Kopen bij Amazon
1x Micro SD-kaart 64GB  Kopen bij Amazon


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.


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.

Weergave van het taalkeuzemenu op de startpagina van het dashboard.


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.

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.

Apparaatoverzichtsweergave in zigbee2mqtt. Alle geregistreerde Zigbee-apparaten staan hier vermeld.


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.

Dashboard-tabbladweergave op het tabblad zigbee2mqtt.

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.

In de geladen netwerkkaart zie je dan een overzicht van de aangesloten Zigbee-apparaten. De apparaten die met blauwe lijnen zijn verbonden, zijn de verschillende routers in het netwerk. Er zijn verschillende (meestal batterijgevoede) eindapparaten op aangesloten (via groene leidingen).


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.

Weergave van het tabblad Instellingen in het zigbee2mqtt-dashboard.


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.

Weergave van het tabblad Groep in het zigbee2mqtt-dashboard.


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.

Weergave van OTA-tabblad in zigbee2mqtt-dashboard. Hier ziet u informatie over de beschikbare apparaten, hun firmwarestatus en of er een update beschikbaar is. Als er een update beschikbaar is, kunt u deze ook vanaf hier uitvoeren.


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.


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.

De berichten bekijken op het logtabblad van zigbee2mqtt.


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.

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


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

Koop Me a Coffee op ko-fi.com       

7 comments

  1. Bedankt voor de reeks artikelen over zigbee2mqtt. Tot nu toe heb ik deze functie geïmplementeerd met homegear en vervolgens mijn snelkoppelingen gemaakt in NodeRED. Dit lijkt mij veel comfortabeler!

  2. Hallo, mijn naam is Dietmar,
    Ik heb het geprobeerd en alles werkt tot aan het dashboard. Ook Zigbee2mQtt heeft de test goed doorstaan.
    Ik heb echter geen toegang tot het dashboard. Ik heb de gegevens ingevoerd in het "configuratie"-bestand, maar wanneer ik het van buitenaf probeer te openen, krijg ik de melding dat de pagina niet toegankelijk is. Waar ben ik iets vergeten? Heeft de stick een eigen adres? Waarschijnlijk ik.
    Ik ben dankbaar voor alle hulp.
    Hartelijke groeten
    Dieetmar

    1. Hallo Dietmar,
      Kun je controleren of je de juiste poort hebt gebruikt bij het aanroepen van het adres?
      Als je in de configuratie poort 8080 hebt ingesteld, dan moet je het dashboard als volgt oproepen: http://:ADRESSE_DES_PIS:8080
      Ik realiseerde me net dat mijn voorbeeld wat dat betreft een beetje misleidend is. 🙂
      Hartelijke groeten
      Fabian

      1. Hallo Fabian,
        hartelijk dank voor de snelle reactie.
        Ja, ik heb de poort ingevoerd, zelfs de poort expliciet ingesteld in de router voor de Raspi als test.
        Maar bracht niets mee.
        Dus zoals ik al zei, Zigbee2mqtt heeft de test goed doorstaan.
        Hartelijke groeten
        Dieetmar
        PS: Onder ADRESSE_DES_PIS voer ik het adres XXX.XXX.XXX.YYY in

  3. Hallo Dietmar,
    SUPER samenvatting!! Heb je misschien een idee hoe je radiatorthermostaatkranen groepeert en vervolgens aanstuurt? (Het lukt me om mezelf te groeperen - in mijn geval met verschillende HAMA / Saswell-kleppen) MAAR hoe regel je het hele ding?? Ik kan scènes maken via de WebGui - maar op de een of andere manier hebben ze geen enkele functie, of de instelling van de afzonderlijke kleppen verandert niet wanneer ze worden opgeroepen via de WebGui). Het wordt nog onduidelijker wanneer ik vervolgens de groep in DOMOTIZ wil besturen - het is allemaal maar een simpele schakelaar.

  4. Bonjour
    Is het mogelijk om een lamp of een Zigbee-module rechtstreeks te bedienen via zigbee2mqtt?
    in het genre : http:// ADDRESS_IP :8083/Light1/switch_on ??
    Merci

Kommentar hinterlassen

Het e-mailadres wordt niet gepubliceerd. Erforderliche Felder sind mit * markiert

Deze site gebruikt Akismet om spam te verminderen. Bekijk hoe je reactie-gegevens worden verwerkt.