Zigbee2MQTT opsætning

Zigbee2MQTT opsætning

Zigbee er fantastisk. Lavt strømforbrug, mesh-netværk, og enheder der bare virker. Men hver producent vil have dig til at bruge deres hub. Philips Hue hub til Hue pærer. IKEA hub til TRÅDFRI. Aqara hub til Aqara sensorer.

Zigbee2MQTT løser det problem. Én USB-dongle, én software, alle enheder. Jeg har Aqara sensorer, IKEA pærer og Sonoff kontakter kørende på samme netværk. De snakker sammen uden problemer.

Hvad skal du bruge?

Zigbee USB-dongle:

Jeg anbefaler Sonoff Zigbee 3.0 USB Dongle Plus (den med “E” i navnet). Den koster omkring 150-200 kr og virker bare. Ældre dongles som CC2531 kan godt bruges, men de har kortere rækkevidde og færre samtidige enheder.

Andre gode valg:

  • SLZB-06 (Ethernet-baseret, dyrere men meget stabil)
  • Conbee II (populær, men jeg har haft bedre held med Sonoff)

MQTT Broker:

Zigbee2MQTT sender data via MQTT. Du skal bruge en broker - Mosquitto er standarden.

Installation

Jeg antager du kører Home Assistant OS. Bruger du Docker? Så kør Zigbee2MQTT som separat container - der kommer en guide til det.

Trin 1: Installer Mosquitto

  1. Gå til Indstillinger → Add-ons
  2. Klik Add-on butik
  3. Søg efter “Mosquitto broker”
  4. Klik Installer
  5. Start add-on’en

Under Konfiguration behøver du normalt ikke ændre noget. Standard indstillinger virker fint.

Trin 2: Opret MQTT bruger

Mosquitto skal bruge en bruger. Gå til Indstillinger → Personer → Brugere og opret en ny:

  • Brugernavn: mqtt
  • Password: (vælg noget sikkert)
  • Slå “Kun lokal adgang” til

Skriv password ned - du skal bruge det om lidt.

Trin 3: Installer Zigbee2MQTT

  1. Gå til Add-on butik
  2. Klik på de tre prikker øverst → Repositories
  3. Tilføj: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
  4. Søg efter “Zigbee2MQTT” og installer

Trin 4: Find din dongle

Før du konfigurerer, skal du finde donglen. Gå til Indstillinger → System → Hardware → All Hardware.

Led efter noget med “Silicon Labs” eller “Sonoff” i navnet. Det ligner typisk:

/dev/serial/by-id/usb-Silicon_Labs_Sonoff_Zigbee_3.0_USB_Dongle_Plus-if00-port0

Kopier hele stien.

Trin 5: Konfigurer Zigbee2MQTT

Gå til Zigbee2MQTT add-on → Konfiguration og udfyld:

serial:
  port: /dev/serial/by-id/usb-Silicon_Labs_Sonoff_Zigbee_3.0_USB_Dongle_Plus-if00-port0
mqtt:
  server: mqtt://core-mosquitto
  user: mqtt
  password: dit-mqtt-password
frontend:
  port: 8485

Udskift port-stien med din egen. Og brug det password du oprettede til MQTT brugeren.

Trin 6: Start og test

Start Zigbee2MQTT add-on’en. Åbn loggen og vent på at du ser:

Zigbee2MQTT started!

Nu kan du åbne web-interfacet på:

http://homeassistant.local:8485

Tilføj din første enhed

Parringstilstand

I Zigbee2MQTT interfacet, klik Permit join øverst. Du har nu ca. 5 minutter til at parre enheder.

Par enheden

Hver enhed parres forskelligt:

  • Aqara sensor: Hold knappen nede i 5 sekunder til LED blinker
  • IKEA pære: Tænd/sluk 6 gange hurtigt
  • Sonoff kontakt: Hold knappen 5 sekunder

Enheden dukker op i Zigbee2MQTT og automatisk i Home Assistant.

Giv den et navn

Klik på enheden i Zigbee2MQTT og giv den et fornuftigt navn. “Stue_temperatur” er bedre end “0x00158d0001234567”.

Netværkstips

Placering af koordinator

USB-donglen er din Zigbee-koordinator. Placering betyder noget:

  • Minimum 1 meter fra din router/WiFi
  • Ikke bag ved metal eller beton
  • Gerne centralt i hjemmet
  • USB-forlænger kan hjælpe

Jeg havde problemer med rækkevidde indtil jeg satte donglen på en USB-forlænger væk fra min server. Nat og dag forskel.

Mesh-netværk

Zigbee er et mesh-netværk. Det betyder at enheder kan sende beskeder gennem hinanden. Men kun enheder med strøm (routere) gør det - batteridrevne enheder (end devices) gør ikke.

Så: Placer dine smarte stikkontakter og pærer strategisk. De forstærker signalet til dine sensorer.

Zigbee og WiFi

Zigbee bruger 2.4 GHz ligesom WiFi. De kan forstyrre hinanden. Zigbee kanal 11 ligger tættest på WiFi kanal 1, og Zigbee kanal 25-26 ligger tættest på WiFi kanal 11.

Min tommelfingerregel: Sæt dit WiFi på kanal 1 eller 6, og lad Zigbee2MQTT vælge kanal automatisk (den vælger typisk 11 eller 15).

Populære Zigbee-enheder

Her er hvad jeg selv bruger og kan anbefale:

Sensorer:

  • Aqara dør/vindue sensor - billig og pålidelig
  • Aqara temperatur/fugtighed - batteriet holder evigt
  • Aqara bevægelsessensor - hurtig respons

Kontakter:

  • Sonoff ZBMINI - passer i underlag bag kontakten
  • IKEA TRETAKT - billig smart stikkontakt

Pærer:

  • IKEA TRÅDFRI - godt lys, fin pris
  • Philips Hue - virker også uden Hue hub

Fejlfinding

Enhed parrer ikke

  • Er “Permit join” aktiveret?
  • Er enheden tæt nok på koordinatoren?
  • Prøv at nulstille enheden helt (se manual)
  • Tjek at enheden er på listen over understøttede enheder

Enhed falder fra

  • Dårlig signalstyrke - flyt enheden eller tilføj flere routere
  • Interferens fra WiFi - skift kanal
  • Batteriet er lavt

Zigbee2MQTT starter ikke

Tjek loggen. Typiske problemer:

  • Forkert port-sti
  • Donglen bruges af andet software
  • MQTT login fejler

Næste skridt

Med Zigbee2MQTT kørende kan du nu:

Zigbee-kaninhullet er dybt. Velkommen ned.