Home Assistant koppelen aan Zigbee-schakelaars via Zigbee2mqtt

Je hebt Home Assistant draaien, Zigbee-schakelaars in je woning en wilt beide aan elkaar koppelen zonder afhankelijk te zijn van cloud-diensten of propriëtaire hubs. Zigbee2mqtt maakt dat mogelijk: een open-source brug die Zigbee-apparaten rechtstreeks met Home Assistant verbindt via MQTT. In deze handleiding doorloop je de volledige installatie, van hardware tot eerste schakelcommando.

Waarom Zigbee2mqtt als gateway voor Home Assistant

Home Assistant ondersteunt meerdere integraties voor Zigbee, maar Zigbee2mqtt biedt een aantal praktische voordelen. Het werkt volledig lokaal, zonder afhankelijkheid van externe servers. Je behoudt volledige controle over je netwerk en data. Daarnaast ondersteunt Zigbee2mqtt een breed scala aan Zigbee-apparaten, waaronder schakelaars van merken die niet standaard met propriëtaire hubs werken.

Voor elektro-installateurs die werken met open domotica-systemen is dit een efficiënte oplossing. Je hoeft geen aparte hub per merk te installeren en kunt verschillende Zigbee-apparaten in één netwerk beheren. Maledro Zigbee-schakelaars werken naadloos samen met Zigbee2mqtt, wat ze geschikt maakt voor projecten waar Home Assistant de centrale besturing vormt.

Benodigde hardware voor de installatie

Voordat je begint met de software-installatie, heb je specifieke hardware nodig. Een Zigbee-coordinator is essentieel: dit is de USB-stick die fungeert als brug tussen je Zigbee-netwerk en Home Assistant. Veelgebruikte modellen zijn de ConBee II van Dresden Elektronik, de Sonoff Zigbee 3.0 USB Dongle Plus en de CC2652-gebaseerde coordinators zoals de Electrolama zzh.

De keuze hangt af van je budget en gewenste bereik. De ConBee II heeft een sterke signaalverwerking, maar is duurder. De Sonoff-dongle biedt een goede prijs-kwaliteitverhouding en werkt stabiel in middelgrote woningen. Voor grotere projecten of woningen met meerdere verdiepingen kan een CC2652-coordinator met externe antenne beter presteren.

Zorg dat je Home Assistant al operationeel is, bij voorkeur op een Raspberry Pi, een NUC of een andere dedicated server. De installatie van Zigbee2mqtt vereist toegang tot de terminal, dus een SSH-verbinding naar je Home Assistant-omgeving is nodig.

Stap-voor-stap installatie van Zigbee2mqtt

De installatie gebeurt via de Add-on Store in Home Assistant Supervisor. Open de Supervisor-interface, ga naar de Add-on Store en zoek naar "Zigbee2mqtt". Klik op installeren en wacht tot het proces voltooid is.

Na installatie open je de configuratie van de add-on. Hier moet je de seriële poort van je Zigbee-coordinator opgeven. De meest voorkomende paden zijn `/dev/ttyUSB0` of `/dev/ttyACM0`. Als je twijfelt welke poort actief is, kun je dit controleren via de terminal met het commando:

``` ls /dev/tty* ```

Sluit de coordinator aan op een USB-poort van je server en voer het commando opnieuw uit. De nieuwe poort die verschijnt is die van je coordinator.

Vul in de configuratie van Zigbee2mqtt het volgende in onder "serial":

``` serial: port: /dev/ttyUSB0 ```

Vervang `/dev/ttyUSB0` door de poort die je hebt gevonden. Start vervolgens de add-on. In het logboek zie je of Zigbee2mqtt correct opstart en verbinding maakt met de coordinator.

Toegang tot de Zigbee2mqtt-interface

Zigbee2mqtt heeft een eigen webinterface die je bereikt via het IP-adres van je Home Assistant-server, gevolgd door poort 8099. Bijvoorbeeld: `http://192.168.1.10:8099`. In deze interface zie je alle gekoppelde Zigbee-apparaten, kun je nieuwe apparaten toevoegen en instellingen aanpassen.

De interface toont een overzicht van je netwerk, inclusief signaalsterkte en route-informatie. Dit is handig bij het diagnosticeren van verbindingsproblemen of het optimaliseren van de plaatsing van apparaten.

Zigbee-schakelaars koppelen aan het netwerk

Om een Zigbee-schakelaar toe te voegen, zet je Zigbee2mqtt in koppelmodus. Klik in de webinterface rechtsboven op "Permit join (All)". Dit activeert de koppelmodus voor 254 seconden.

Zet de schakelaar in pairing-modus. Bij Maledro Zigbee-schakelaars doe je dit door de fysieke schakelaar drie keer snel achter elkaar in te drukken. De LED op de schakelaar knippert om aan te geven dat hij zoekt naar een netwerk. Binnen enkele seconden verschijnt de schakelaar in de Zigbee2mqtt-interface met een standaardnaam zoals `0x00158d0001a2b3c4`.

Je kunt de naam direct aanpassen naar iets herkenbaars, bijvoorbeeld "Woonkamer_Plafond" of "Gang_Schakelaar_1". Deze naam wordt automatisch overgenomen in Home Assistant.

Integratie met Home Assistant via MQTT

Zigbee2mqtt communiceert met Home Assistant via MQTT. Als je de MQTT-integratie nog niet hebt geïnstalleerd, doe dat via de integraties-pagina in Home Assistant. Installeer eerst de Mosquitto broker via de Add-on Store, start deze en voeg vervolgens de MQTT-integratie toe.

Zodra MQTT actief is, detecteert Home Assistant automatisch de apparaten die Zigbee2mqtt publiceert. Ga naar "Instellingen" → "Apparaten en diensten" en je ziet de gekoppelde Zigbee-schakelaars verschijnen onder de MQTT-integratie.

Elk apparaat heeft entiteiten zoals `switch.woonkamer_plafond` of `light.gang_schakelaar_1`, afhankelijk van het type apparaat. Deze entiteiten kun je direct gebruiken in automatiseringen, dashboards en scenes.

Automatiseringen en bediening instellen

Met de schakelaars in Home Assistant kun je automatiseringen opzetten. Een eenvoudig voorbeeld: schakel de verlichting in de gang automatisch in bij bewegingsdetectie tussen 18:00 en 07:00. Of koppel een schakelaar aan een tijdschema om buitenverlichting bij zonsondergang te activeren.

In de automatisering-editor selecteer je de entiteit van de schakelaar als trigger of actie. Je kunt ook meerdere schakelaars groeperen in een lichtgroep, zodat je met één commando alle verlichting in een ruimte bedient.

Voor geavanceerde scenario's kun je Node-RED gebruiken, een visuele automatiseringstool die naadloos integreert met Home Assistant. Dit is vooral handig bij complexe logica of integraties met externe systemen.

Veelvoorkomende installatieproblemen en oplossingen

Als de coordinator niet wordt herkend, controleer dan of de USB-poort correct is ingesteld in de configuratie. Sommige coordinators vereisen een specifieke baudrate; dit staat vermeld in de documentatie van het model. Voor de meeste CC2652-coordinators is de standaard baudrate 115200.

Wanneer een schakelaar niet koppelt, zorg dan dat de pairing-modus actief is en dat "Permit join" ingeschakeld staat in Zigbee2mqtt. Sommige apparaten vereisen een factory reset voordat ze opnieuw kunnen koppelen. Bij Maledro-schakelaars doe je dit door de schakelaar tien seconden ingedrukt te houden tot de LED drie keer knippert.

Verbindingsproblemen kunnen ontstaan door te grote afstanden tussen coordinator en apparaten. Zigbee-netwerken bouwen een mesh-structuur op, waarbij apparaten die permanent op stroom staan fungeren als router. Zorg voor voldoende powered devices (geen batterij-apparaten) tussen de coordinator en eindapparaten om het netwerk stabiel te houden.

Compatibiliteit met Maledro Zigbee-schakelaars

Maledro Zigbee-schakelaars zijn getest met Zigbee2mqtt en werken zonder aanpassingen. De schakelaars ondersteunen het Zigbee 3.0-protocol, wat brede compatibiliteit garandeert. Na koppeling worden ze herkend als switch-entiteiten in Home Assistant.

De schakelaars behouden hun handmatige bediening, ook wanneer ze via Home Assistant worden aangestuurd. Dit betekent dat je altijd fysiek kunt schakelen, ongeacht de status van je domotica-systeem. Voor installateurs is dit een belangrijk veiligheidskenmerk: bewoners blijven altijd controle houden over de verlichting, zelfs bij een storing in het netwerk.

De touchbediening en app-functionaliteit van Maledro-schakelaars blijven beschikbaar naast de Home Assistant-integratie. Je kunt kiezen of je via de Tuya-app, Home Assistant of handmatig schakelt, afhankelijk van de situatie.

Onderhoud en updates van Zigbee2mqtt

Zigbee2mqtt ontvangt regelmatig updates met ondersteuning voor nieuwe apparaten en bugfixes. Updates installeer je via de Add-on Store in Home Assistant. Controleer voor het updaten altijd de release notes op breaking changes die invloed kunnen hebben op je configuratie.

Na een update kan het nodig zijn om apparaten opnieuw te configureren als er wijzigingen zijn in de apparaat-definities. Dit gebeurt zelden, maar is goed om in de gaten te houden bij kritische installaties.

Maak periodiek een backup van je Zigbee2mqtt-configuratie. Deze vind je in de map `/config/zigbee2mqtt/` op je Home Assistant-server. Bij een hardware-wissel of systeemherstel kun je hiermee snel je netwerk herstellen zonder alle apparaten opnieuw te hoeven koppelen.

Uitbreiden naar een compleet Home Assistant-systeem

Zodra je Zigbee-schakelaars succesvol zijn gekoppeld, kun je het systeem uitbreiden met andere Zigbee-apparaten zoals sensoren, dimmers en rolluikschakelaars. Zigbee2mqtt ondersteunt duizenden apparaten van verschillende merken, wat flexibiliteit biedt bij het samenstellen van een domotica-systeem.

Voor grotere projecten met tientallen apparaten is het verstandig om de netwerkstructuur te visualiseren via de kaartfunctie in Zigbee2mqtt. Hiermee identificeer je zwakke verbindingen en kun je de plaatsing van routers optimaliseren.

Wil je meer weten over elektronische schakelaars die compatibel zijn met Home Assistant, of zoek je specifieke configuratiehandleidingen? Bekijk de handleidingen voor technische documentatie of neem contact op voor advies bij grotere installaties.