SLZB-adapter instellen in Home Assistant (ZHA en Zigbee2MQTT)

Je hebt een SMLIGHT SLZB-adapter en wilt hem koppelen aan Home Assistant. In deze handleiding lees je stap voor stap hoe je dat doet via Ethernet, met ZHA (ingebouwd in Home Assistant) of met Zigbee2MQTT. Twijfel je nog welke adapter je nodig hebt? Bekijk dan eerst de SLZB-vergelijker.

Wat heb je nodig?

• Een SLZB-adapter met Ethernet, bijvoorbeeld de SLZB-06MU of SLZB-MR5U.
• Een netwerkkabel en voeding: een PoE-switch of PoE-injector, of een USB-C-voeding.
• Home Assistant in hetzelfde netwerk.
• Kies één van de twee: ZHA of Zigbee2MQTT. Gebruik ze niet allebei tegelijk op dezelfde radio.

Stap 1: adapter aansluiten en het IP-adres vinden

1. Sluit de adapter met een netwerkkabel aan op je router of switch. Met PoE is dat meteen ook de voeding; anders sluit je USB-C aan.
2. Zoek het IP-adres van de adapter in de lijst met apparaten van je router. De naam begint meestal met SLZB.
3. Geef de adapter in je router een vast IP-adres (DHCP-reservering). Zo blijft de verbinding werken na een herstart.
4. Open het IP-adres in je browser. Je komt in SLZB-OS, de webinterface van de adapter. Werk hier eerst de firmware bij als er een update klaarstaat.
5. Controleer in SLZB-OS dat de Zigbee-radio in coördinatormodus staat. Bij nieuwe adapters is dat standaard zo.

Tip: zet de adapter centraal in huis, niet direct naast je router of server. Wifi en USB 3.0 kunnen het Zigbee-signaal storen.

Stap 2: de SMLIGHT-integratie toevoegen (aanbevolen)

Sinds versie 2024.9 heeft Home Assistant een officiële SMLIGHT SLZB-integratie. Die koppelt nog geen Zigbee-apparaten, maar laat je de adapter zelf beheren vanuit Home Assistant: firmware-updates, temperatuur, verbindingsstatus, herstarten en de LED’s uitschakelen.

Meestal vindt Home Assistant de adapter vanzelf: je ziet hem onder Instellingen → Apparaten en diensten as Gevonden. Klik op Toevoegen. Zie je hem niet, voeg dan de integratie SMLIGHT SLZB handmatig toe met het IP-adres.

Stap 3a: koppelen met ZHA

ZHA zit standaard in Home Assistant en is de eenvoudigste keuze voor de meeste gebruikers.

1. Ga naar Instellingen → Apparaten en diensten. Vaak staat Zigbee Home Automation er al als gevonden apparaat; klik dan op Toevoegen en ga naar stap 5.
2. Anders: klik op Integratie toevoegen en kies Zigbee Home Automation.
3. Kies bij de seriële poort voor handmatig invoeren.
4. Kies het radiotype en vul de gegevens in:
   • Radiotype: ZNP voor Texas Instruments-chips (SLZB-06U: CC2652P), EZSP voor Silicon Labs-chips (SLZB-06MU, 07MG24, MR5U).
   • Pad: socket://IP-ADRES:6638, bijvoorbeeld socket://192.168.1.50:6638
   • Baudrate: 115200
   • Flow control: niet ingesteld
5. Kies bij een nieuwe installatie voor een nieuw netwerk maken. Heb je een back-up van een oude coördinator, dan kun je die hier terugzetten.
6. Klaar. Koppel je eerste apparaat via ZHA → Apparaat toevoegen en zet het apparaat in koppelmodus.

Stap 3b: koppelen met Zigbee2MQTT

Zigbee2MQTT ondersteunt meer apparaten en geeft je meer instellingen en een netwerkkaart. Je hebt er wel een MQTT-broker voor nodig, zoals de Mosquitto-add-on.

1. Installeer de apps Mosquitto broker and Zigbee2MQTT via Instellingen → Apps (heette tot versie 2026.2 “add-ons”), of draai Zigbee2MQTT in Docker.
2. Vul in de configuratie van Zigbee2MQTT bij serial het volgende in:

serial:
  port: tcp://192.168.1.50:6638
  baudrate: 115200
  adapter: ember      # Silicon Labs: SLZB-06MU, 07MG24, MR5U
  # adapter: zstack   # Texas Instruments: SLZB-06U

3. Vervang het IP-adres door dat van je adapter. Poort 6638 is de standaard in SLZB-OS.
4. Start Zigbee2MQTT en open de webinterface. Klik op Permit join en zet je apparaat in koppelmodus.

NB: wijzigingen die je in de UI van de Zigbee2MQTT-app maakt, worden soms niet opgeslagen. Werkt de verbinding niet, controleer dan de configuratie in de YAML-modus.

Welk radiotype hoort bij mijn adapter?

Adapter	Zigbee-chip	ZHA radiotype	Zigbee2MQTT adapter
SLZB-06U	CC2652P (TI)	ZNP	zstack
SLZB-06MU	EFR32MG21 (Silicon Labs)	EZSP	ember
SLZB-07MG24 (USB)	EFR32MG24 (Silicon Labs)	EZSP	ember
SLZB-MR5U	EFR32MG24 (Silicon Labs)	EZSP	ember
SLZB-MR2U, MR4U, MRW10U, Ultima 3	TI of Silicon Labs, afhankelijk van welke radio je voor Zigbee gebruikt	ZNP (TI) of EZSP (Silicon Labs)	zstack (TI) of ember (Silicon Labs)

Thread en Matter gebruiken (MR-serie)

Met een multi-radio-adapter uit de MR-serie draai je Zigbee op de ene radio en Thread op de andere. In SLZB-OS zie je per radio welke firmware erop staat en via welke poort hij bereikbaar is. Gebruik de Zigbee-radio zoals hierboven beschreven. De Thread-radio koppel je aan de OpenThread Border Router in Home Assistant, waarna je Matter-over-Thread-apparaten kunt toevoegen. SMLIGHT beschrijft de precieze stappen per model in de officiële handleiding.

Problemen oplossen

• Home Assistant vindt de adapter niet automatisch: automatisch vinden werkt via mDNS. Staan Home Assistant en de adapter in verschillende netwerken of VLAN’s, voeg hem dan handmatig toe met het IP-adres.
• Zigbee2MQTT meldt “No valid USB adapter found”: controleer het adres (tcp://, niet socket://) en het adaptertype, en kijk of de instellingen echt zijn opgeslagen.
• Verbinding valt weg na een herstart: geef de adapter een vast IP-adres in je router.
• Apparaten vallen af of reageren traag: verplaats de adapter weg van je wifi-router en zorg voor genoeg routers in huis, zoals slimme stekkers of inbouwschakelaars. Meer uitleg vind je op What is Zigbee?.
• Je wilt overstappen van ZHA naar Zigbee2MQTT of andersom: stop eerst de ene integratie volledig. Twee programma’s kunnen niet tegelijk met dezelfde radio praten.

Kom je er niet uit? Neem contact met ons op. Klanten van ZDV Shop helpen we graag op weg.