Je eigen Zigbee-coördinator koppelen
Draai je al Zigbee2MQTT op je eigen stick? Dan sluit je die in vier stappen aan op FairGrow. Je hardware blijft van jou, en er hoeft niets open in je firewall.
Vier stappen, eenmalig
Daarna staat je coördinator als kaart in FairGrow, net als elk ander toestel.
Download de brug
Een installer voor Windows, macOS of je Raspberry Pi. Hij staat hieronder en regelt de rest zelf.
Haal een koppelcode
Een code van acht tekens uit het paneel Toon toestellen, eenmalig en een kwartier geldig. Hieronder zie je hoe.
Voer de code één keer in
De brug wisselt hem in voor een sleutel die op je eigen machine blijft staan. De code vervalt daarna meteen.
Koppel je eerste toestel
Open Netwerk bij je coördinator. Daar staat Koppelvenster openen voor een nieuw toestel, en Toestellen overnemen voor wat er al op zat.
Installeren duurt een minuut
Kies je systeem en start de installer. Hij zet alles klaar, vraagt om je koppelcode en zorgt dat de brug voortaan vanzelf meestart.
FairGrow-brug
Werkt met je eigen Zigbee2MQTT of rechtstreeks met ZHA in Home Assistant. Praat met je coördinator en met FairGrow, en verder met niets.
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shLet op: de brug hoort niet op je Home Assistant zelf. Het is geen integratie en geen add-on, en op Home Assistant OS kun je er geen Python bij zetten. Zet hem op een andere machine in hetzelfde netwerk die aan blijft: je pc, een Raspberry Pi, een NAS of een virtuele machine. Bij ZHA praat hij daarvandaan over het netwerk met Home Assistant.
Draai je Home Assistant? Lees eerst Eén radio, en maar één die hem mag hebben. Daar staat waarom Zigbee2MQTT daar vaak niet wil starten, en wat je eraan doet.
Wat de installer precies doet
- Kijkt of Python 3 op je machine staat, en zegt anders waar je hem haalt.
- Maakt een eigen map met een eigen Python-omgeving, los van je systeem.
- Haalt de brug op en vergelijkt de vingerafdruk met wat het platform zegt. Klopt die niet, dan start er niets.
- Vraagt je koppelcode, en waar je Zigbee2MQTT of Home Assistant draait.
- Koppelt één keer en zorgt dat de brug bij het opstarten automatisch meestart.
Alles staat in een eigen map en er wordt niets aan je systeem-Python veranderd. Weghalen doe je met fairgrow-brug.bat /verwijderen of sh fairgrow-brug.sh --verwijderen; de koppeling zelf trek je in op je eigen coördinatorkaart. Liever met de hand? De losse brug staat er nog: fgzb_brug.py.
Bijwerken naar een nieuwere versie doe je met fairgrow-brug.bat /bijwerken of sh fairgrow-brug.sh --bijwerken. Je koppeling en je instellingen blijven staan, dus je hoeft geen nieuwe koppelcode te halen.
Zo haal je je koppelcode
Drie klikken in FairGrow. De code is eenmalig en een kwartier geldig.
1. Paneel Toon toestellen
2. Kies je coördinator
3. Je code
Waar je metingen langsgaan
Elke verbinding wordt van jouw kant naar buiten gemaakt. Er komt niets naar binnen.
Elke pijl wijst naar buiten. Je coördinator en je toestellen blijven in je eigen netwerk.
Drie dingen
Een ondersteunde coördinator
Elke stick die Zigbee2MQTT aankan: SONOFF ZBDongle-E of P, SLZB-06, ConBee III.
Zigbee2MQTT die draait
Versie 2.x met een MQTT-server in je eigen netwerk. Je bestaande opstelling blijft gewoon werken.
Een machine die aan blijft
De brug is een klein Python-programma. Een Raspberry Pi naast je coördinator is genoeg.
Eén radio, en maar één die hem mag hebben
Draai je Home Assistant, en zeker op een Yellow? Dan loop je waarschijnlijk tegen twee dingen aan die niets met FairGrow te maken hebben. Hier staat wat er gebeurt, en wat je eraan doet.
In je Home Assistant Yellow zit een Zigbee-radio ingebouwd. Die radio kan maar door één programma tegelijk gebruikt worden. Bij de meeste mensen gebruikt ZHA hem al, want ZHA zit standaard in Home Assistant.
Start je daarna Zigbee2MQTT, dan vraagt die om dezelfde radio. Hij krijgt hem niet en stopt meteen weer. In het logboek staat dan een regel over de seriële poort: Error: Error while opening serialport. Dat leest als kapot, maar er is niets kapot. De radio is bezet.
- In een Home Assistant Yellow zit één Zigbee-radio. Eén, niet twee.
- ZHA heeft die radio meestal al in gebruik. Dat is de gewone toestand.
- Zigbee2MQTT vraagt om dezelfde radio en krijgt hem niet.
- Daarom stopt Zigbee2MQTT meteen weer, met een fout over de seriële poort.
- Er is niets kapot. De radio is bezet.
Wij passen ons aan jouw opstelling aan
Jij hoeft je werkende Zigbee-netwerk niet om te gooien om met ons te kunnen werken. Daarom praat onze brug rechtstreeks met ZHA. Je hoeft Zigbee2MQTT dan helemaal niet te installeren, er komt geen tweede stick bij, en aan wat je nu hebt verandert niets.
Kies in de installatie voor ZHA in Home Assistant. Hij vraagt dan om het adres van je Home Assistant en om een langdurig toegangstoken. Dat token maak je op je profielpagina, tabblad Beveiliging, en het moet van een account met beheerdersrechten zijn: ZHA laat een gewoon account geen enkele opdracht toe. Het token blijft op jouw machine.
Eén ding kan ZHA niet: een afgewezen toestel buiten de deur houden. ZHA kent geen blokkeerlijst, dus zo'n toestel gaat wel weg maar kan opnieuw aankloppen. Dat zeggen we er op de kaart bij in plaats van het stil te laten mislukken.
Naast ZHA, met een tweede radio
Wil je liever Zigbee2MQTT gebruiken, dan kan dat naast ZHA zolang het een eigen radio heeft. Een losse Zigbee-stick in een USB-poort van je Yellow is genoeg. Je bestaande toestellen blijven waar ze zijn en hoeven niet opnieuw gekoppeld te worden.
Dit is een keuze, geen eis. Voor de meeste mensen is de ZHA-brug hiernaast de kortere weg, want daar hoef je niets voor te kopen en niets voor te installeren.
Zigbee2MQTT staat niet in de winkel
Je kunt in de app-winkel van Home Assistant zoeken wat je wilt, je vindt hem daar niet. Dat komt niet door jou.
Home Assistant toont alleen apps uit lijsten die het al kent. Zigbee2MQTT staat in een eigen lijst die er nog niet bij staat. Je voegt die lijst één keer toe, en daarna staat de app er gewoon tussen.
Ga naar Instellingen, dan Add-ons, dan Add-on store. Klik rechtsboven op de drie puntjes, kies Repositories en plak dit adres:
https://github.com/zigbee2mqtt/hassio-zigbee2mqttInstalleer daarna eerst de Mosquitto broker en start die, want Zigbee2MQTT praat daarmee. Onze installer doet dit hele rijtje voor je: hij kijkt of je Home Assistant draait, voegt de lijst toe, zet de app erop en schrijft in installatie.log precies wat er gebeurde als er toch iets misgaat.
- Zoek je in de app-winkel op zigbee2mqtt, dan vind je niets.
- Klik rechtsboven op de drie puntjes, kies Repositories en plak daar https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.
- Nu staan de Mosquitto broker en Zigbee2MQTT wel in de lijst. Installeer Mosquitto eerst en start die.
Een nieuw Zigbee-toestel wacht op jou
Er komt niets vanzelf op je dashboard te staan.
Het staat in quarantaine
Het toestel wacht. Geen metingen, geen dashboard, nog niets.
We vragen wie het is
Merk, model, wat het kan. Op de kaart zie je wat gemeten is en wat opgezocht.
Jij beslist
Toevoegen, of weigeren. Weigeren haalt het toestel weg en houdt het buiten de deur.
Wat je Zigbee-coördinator hier kan
Een coördinator van een ander merk is niet minder. Hij is alleen anders gebouwd.
Werkt
- Het koppelvenster openen vanuit FairGrow
- Merk, model en de mogelijkheden van een toestel uitlezen
- Vertellen of een toestel verkeer van anderen kan doorgeven
- Een toestel verwijderen en buiten de deur houden
- Een netwerkscan draaien: welke toestellen via welke lopen, en hoe sterk
- Je adapter en firmware herkennen, en waarschuwen bij een combinatie waarvan we weten dat die niet werkt
Werkt niet
- Zigbee2MQTT kan niet opvragen wat een toestel weigert. Daarvoor leunen we op onze eigen toestellenbibliotheek.
- Niet elk toestel kan via Zigbee2MQTT knipperen zodat je het terugvindt.
Konden we iets niet zelf meten, dan staat dat op de kaart. We laten een geleende waarde nooit voor een meting doorgaan.
Zie hoe je Zigbee-netwerk ervoor staat
Zigbee is een meshnetwerk: je toestellen praten via elkaar. Vanaf je coördinator vraag je een netwerkscan aan en zie je wie via wie loopt.
De plattegrond
Elk toestel, elke verbinding en hoe sterk die is. Een zwakke schakel zie je liggen voordat een sensor wegvalt.
Wat eraan mankeert
Een toestel met maar één buur, een verbinding die te zwak is, iets dat te ver van de coördinator hangt. Met de regel erbij waarom we dat zeggen.
Het verloop
We bewaren elke scan. Zo zie je een verbinding wegzakken of een toestel telkens van buur wisselen, in plaats van pas te merken dat het stil is.
Een scan vraagt elke router om zijn buurtabel en kost radiotijd, dus die start nooit vanzelf. En een router die niet antwoordt noemen we niet stilletjes geïsoleerd: dan staat er dat we het niet weten.
Als het niet lukt, zien we waarom
De installatie meet je systeem door en legt vast wat er gebeurt.
Eerst meten, dan koppelen
Poorten, rechten, drivers, de opstarttaak. Bijna alles wat misgaat, gaat mis buiten de brug.
Wij houden onze kant ook bij
Elke poging krijgt een referentie. Daaronder staat wat er van jouw kant binnenkwam, ook als het koppelen nooit lukte.
Opsturen kan met één knop
Onder Jouw coördinators staat Logboek opsturen. Wachtwoorden worden bij binnenkomst gemaskeerd.
Welke Zigbee-hardware werkt. Wat er stukgaat met adapters en merken uit de winkel, en wat wij ervoor opvangen. Bekijk wat werkt
Je Zigbee-coördinator is gekoppeld. Zo ga je verder. Een toestel toevoegen, goedkeuren en weten waar het staat. En wat wij daarna in de gaten houden. Voeg je eerste toestel toe
Wat mensen ons vragen
Welke coördinators kan ik aansluiten?
Zigbee2MQTT en Home Assistant ZHA, allebei nu al en allebei zelf in te stellen: download de brug, kies bij de installatie welke van de twee je hebt, haal een koppelcode, klaar. Draai je ZHA, dan hoef je Zigbee2MQTT niet te installeren en verandert er niets aan je opstelling; hier staat waarom dat uitmaakt. Voor allebei ronden we de laatste test op echte hardware nog af, dus laat het weten als je iets tegenkomt. deCONZ / Phoscon staat daarna op de rol; die kun je nu nog niet kiezen. Staat de jouwe er niet bij? Laat weten welke je hebt.
Ik draai Home Assistant en Zigbee2MQTT wil niet starten
Dan houdt ZHA waarschijnlijk je Zigbee-radio vast. Een Home Assistant Yellow heeft er maar één, en twee programma's kunnen hem niet delen. Zigbee2MQTT stopt dan meteen met een fout over de seriële poort. Je hoeft dat niet op te lossen: onze brug praat rechtstreeks met ZHA, dus Zigbee2MQTT heb je dan helemaal niet nodig. Hier staat het uitgetekend, met allebei de wegen die je hebt.
Wat gaat er van mijn netwerk af?
De gegevens van je coördinator, en van de toestellen die tijdens jouw sessie koppelen: adres, merk, model en hun metingen. Toestellen die al in je Zigbee2MQTT staan en niet koppelen blijven erbuiten.
Moet ik een poort openzetten?
Nee. De brug maakt alleen verbindingen naar buiten. Er komt niets van ons je netwerk in.
Hoe stop ik ermee?
Koppel de coördinator los in FairGrow. De sleutel is dan meteen ongeldig. Je toestellen blijven in de lijst staan, ze krijgen alleen geen nieuwe metingen meer.
Wat als mijn brug een tijdje uit staat?
Er gaat niets stuk. De metingen stoppen en gaan verder zodra de brug terug is. Op de kaart zie je de tijd sinds het laatste bericht oplopen.
Wat gebeurt er als een toestel wegvalt?
Je brug meldt elke vijf minuten wat je coördinator ziet. Valt een toestel stil, dan staat dat bij je coördinator met de reden erbij: het toestel zelf, of de router waar het onder hing. Meldt de brug zich niet meer, dan zeggen we dat eerst, want dan lijkt alles weg terwijl alleen de brug stilstaat.
Sluit je eigen coördinator aan
Vertel ons welke stick je gebruikt en wat je wilt meten. We lopen het koppelen met je door.