HowTo: Zigbee - Apparaten of sensoren en actuatoren registreren met zigbee2mqtt

Zodat uw Zigbee-apparaten voor uw SmartHome Deze moeten natuurlijk wel eerst verbonden zijn met je Zigbee netwerk.

Dit kan op verschillende manieren worden geïmplementeerd. De eenvoudigste manier om nieuwe apparaten toe te voegen aan je Zigbee-netwerk is via de cigbee2mqtt Dashboard.

Het dashboard dient hier natuurlijk al op ingericht te zijn. Informatie over het activeren en gebruiken van dit dashboard vind je ook in het artikel Zigbee - Beheer van Zigbee2mqtt via het dashboard.

In het volgende artikel wordt beschreven hoe je een nieuw Zigbee-apparaat aansluit op je Zigbee-netwerk.


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


Ontgrendel de toegang tot het Zigbee-netwerk

Om nieuwe apparaten aan je Zigbee-netwerk toe te voegen, moet je de toegang tot het Zigbee-netwerk activeren.

Dankzij het zigbee2mqtt-dashboard gebeurt dit met slechts één klik. In de bovenste menubalk bevindt zich een knop waarmee de toegang tot het Zigbee-netwerk kan worden geactiveerd of gedeactiveerd.

Weergave van het logboektabblad van het zigbee2mqtt-dashboard. Het rood gemarkeerde gebied bevat de knop waarmee de toegang tot het Zigbee-netwerk kan worden gecontroleerd. De beste manier om het registratieproces van nieuwe Zigbee-apparaten te volgen, is door het logboektabblad te bekijken.

Als de toegang tot uw Zigbee-netwerk momenteel niet is geactiveerd, klikt u op de knop

  • Deelname toestaan (Alle)

lezen.

Klik dus nu op de knop om de toegang tot je Zigbee-netwerk te activeren.

Zodra de toegang tot uw Zigbee-netwerk is geactiveerd, verandert het opschrift op de knop in

  • Deelnemen aan (alle) XXX uitschakelen

Het getal (hier XXX) geeft aan hoe lang de toegang nog actief is. De toegang wordt daarom uiterlijk na 255 seconden weer gedeactiveerd. Zo voorkom je dat je per ongeluk de toegang geactiveerd laat staan.


Bewaak het registratieproces van het nieuwe Zigbee-apparaat

Nadat je de toegang tot je Zigbee-netwerk hebt geactiveerd, is het nu tijd om het Zigbee-apparaat te registreren. Het leuke is dat je dit registratieproces live kunt volgen via de logoutput.

Als je dat nog niet hebt gedaan, open dan het log-tabblad in het zigbee2mqtt-dashboard.

Stel hiervoor het "logniveau" in op "debug" en klik op de knop "Wissen" om alle eerdere logberichten te verbergen.

Als je dat nog niet hebt gedaan, activeer dan uiterlijk nu de toegang tot je Zigbee-netwerk.

Klik hiervoor op de rood gemarkeerde knop in het bovenste gedeelte van het dashboard.

Op dit punt moet u de verbinding met het netwerk op uw Zigbee-apparaat tot stand brengen. De meeste apparaten hebben achterop een kleine knop die je meerdere keren moet indrukken of lang ingedrukt moet houden. Deze procedure is niet uniform, maar zou beschreven moeten worden in de handleiding van het apparaat.

Ook heb ik in een paar artikelen op Nerdiy.de beschreven hoe je bepaalde Zigbee-apparaten registreert. De artikelen vind je hier: https://nerdiy.de/category/zigbee-geraet/

Een zeer goede lijst inclusief zoekfunctie is hier ook beschikbaar: https://www.zigbee2mqtt.io/supported-devices/

Nadat het Zigbee-apparaat is verbonden met het Zigbee-netwerk, wordt dit weergegeven in het logboek.

De eerste rood onderstreepte uitvoer in het log (type="device joined") geeft aan dat een Zigbee-apparaat zich bij het netwerk heeft aangesloten.

Het "interview" (type="device_interview") van dit apparaat begint dan. Het Zigbee netwerk weet namelijk nog niet wat voor apparaat het is. Hiervoor worden in het verdere verloop van het registratieproces alle belangrijke gegevens opgevraagd.

Mochten er in de tussentijd Zigbee berichten binnenkomen, dan worden deze door zigbee2mqtt genegeerd om eerst het registratieproces van het nieuwe Zigbee apparaat te voltooien.

Zodra alle eigenschappen van het nieuwe Zigbee-apparaat zijn opgehaald, wordt dit weergegeven in het logboek. Ook worden de waarden van de respectievelijke eigenschappen vermeld. (Zie rood gemarkeerde punten op de afbeelding)

Tegen het einde van het registratieproces wordt de registratie voltooid met het volgende...

…bericht bevestigd.

  • Succesvol '0xXX..XX' geconfigureerd

Dit bericht wordt zowel in het logboek weergegeven als kortstondig als pop-up in de linker benedenhoek.


Schakel de toegang tot het Zigbee-netwerk uit en kopieer het IEEE-adres

Nadat je alle Zigbee-apparaten hebt aangemeld, dien je de toegang tot je Zigbee-netwerk weer uit te schakelen.

Klik hiervoor op de knop "Deelnemen uitschakelen..." bovenaan het dashboard.

Uiterlijk op dit moment moet u ook het IEEE-adres van uw Zigbee-apparaat kopiëren. Dit is het unieke adres waarmee je Zigbee-apparaat kan worden geïdentificeerd en waaronder de data ook wordt ontvangen of verzonden naar het apparaat.

Je vindt het adres in het dashboard in het toesteloverzicht of in het logboek zelf. In de afbeelding hiernaast is het IEEE-adres te zien in de verborgen/gemaskeerde gebieden.

Het IEEE-adres heeft het volgende formaat

  • bijvoorbeeld: 0xbc11aceffe54a28f

U kunt nu het nieuw geregistreerde Zigbee-apparaat gebruiken via de zigbee2mqtt-dashboard aansturen of uitlezen of u gebruikt een SmartHome of automatiseringssoftware (bijv NodeRed ) om te reageren op Zigbee-gebeurtenissen of acties te activeren.

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


Meer artikelen over het onderwerp

Het zigbee2mqtt dashboard is niet alleen geschikt voor het registreren van je Zigbee apparaten. Ook vele andere opties van zigbee2mqtt kunnen hiermee worden geconfigureerd. Informatie over het gebruik van het zigbee2mqtt-dashboard vindt u ook in het volgende artikel.

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.

Externe links:


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       

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.