Zigbee mreža za Home Assistant: ZHA ili Zigbee2MQTT i kako je složiti

Zigbee je bežični protokol za male uređaje niske potrošnje: senzore, prekidače, žarulje i utičnice. Radi na 2,4 GHz, uređaji jedni drugima prosljeđuju poruke (mreža tipa mesh) i sve ostaje u kući. Ako protokol još uspoređuješ s drugima, pogledaj usporedbu bežičnih protokola.

Ovaj tekst pretpostavlja da već imaš instaliran Home Assistant. Ako nemaš, kreni od Home Assistant od nule.

Koordinator: srce mreže

Svaka Zigbee mreža ima točno jedan koordinator, radio koji mrežu stvara i spaja je s Home Assistantom. Najčešći izbori:

Home Assistant Connect ZBT-2. Službeni USB stick (oko 45 €), HA ga prepoznaje sam i nudi postavljanje. Radi kao Zigbee ili kao Thread radio, ne oba u isto vrijeme. Najmanje petljanja. Ako već imaš stariji ZBT-1 (ranije SkyConnect), i on je podržan, iako se više ne proizvodi.
SONOFF ZBDongle-E (čip Silicon Labs EFR32MG21) i ZBDongle-P (čip Texas Instruments CC2652P). Povoljni USB stickovi, oba rade sa ZHA i sa Zigbee2MQTT. Procjena: oko 25 do 35 €.
SMLIGHT SLZB-06. Koordinator s Ethernetom i napajanjem preko mrežnog kabela (PoE). Spaja se preko mreže, pa ga možeš staviti na sredinu stana, daleko od servera. Dobar izbor kad je HA u ormaru ili virtualnom stroju.

Za većinu stanova svejedno je koji od ovih uzmeš. Važnije je gdje stoji.

USB produžni kabel nije opcionalan

USB 3 priključci i SSD adapteri stvaraju smetnje upravo oko 2,4 GHz. Stick utaknut izravno u računalo, pokraj USB 3 diska, zna imati slab domet i gubiti uređaje.

Stick spoji preko USB produžnog kabela (oko metar), po mogućnosti u USB 2 priključak.
Odmakni ga od rutera, računala i metalnih kućišta.
Kod Raspberry Pija sa SSD-om na USB 3 ovo je posebno važno.

Kanali: Zigbee i Wi-Fi dijele isti zrak

Zigbee na 2,4 GHz koristi kanale 11 do 26, svaki širok oko 2 MHz. Wi-Fi na 2,4 GHz koristi široke kanale, a u Europi se obično biraju 1, 6 i 11 jer se ne preklapaju. Zigbee kanali koji padaju u razmak između njih:

Wi-Fi kanal	Zigbee kanal koji izbjegava preklapanje
1 i 6	15
6 i 11	20
11 (12 i 13 ne koristiš)	25

Postupak je jednostavan: provjeri na kojem kanalu radi tvoj Wi-Fi (i susjedni, ako ih vidiš), postavi ga ručno umjesto na automatski odabir i Zigbee stavi na kanal koji mu ne smeta. Ako ti je Wi-Fi na kanalu 1, Zigbee 20 ili 25 je razuman izbor.

Kanal odaberi prije uparivanja. Kasnija promjena kanala moguća je, ali dio uređaja, osobito baterijskih, zna zahtijevati ponovno uparivanje.

Zašto Zigbee uopće dijeli spektar s Wi-Fi-jem i kako se to uspoređuje s Matterom, objašnjeno je u tekstu Wi-Fi, Zigbee ili Matter.

ZHA ili Zigbee2MQTT

Oba su zreli, besplatni projekti. Razlika je u tome koliko želiš kontrole i koliko dijelova održavati.

ZHA (Zigbee Home Automation)

Integracija ugrađena u Home Assistant.

Nema dodatnih programa: dodaš integraciju, odabereš stick i gotovo.
Uređaji se pojavljuju kao obični HA uređaji i entiteti.
Radi na svim vrstama instalacije, i na Containeru.
Manje postavki. Za nestandardne uređaje oslanja se na takozvane quirks, male prilagodbe za pojedine modele.

Zigbee2MQTT

Zaseban program koji upravlja Zigbee mrežom i šalje sve preko MQTT-a, laganog protokola za poruke. Trebaš i MQTT broker, posrednika koji prima i dijeli poruke. Na HAOS-u to je aplikacija Mosquitto (do 2026.2 zvale su se dodaci), a HA se na njega spaja integracijom MQTT.

Šira podrška uređajima, osobito jeftinijim i manje poznatim modelima. Na stranici projekta postoji popis podržanih uređaja s opisom što svaki izlaže.
Puno više postavki po uređaju: osjetljivost, intervali javljanja, ponašanje nakon nestanka struje i slično.
Vlastito web sučelje s kartom mreže i alatima za dijagnostiku.
Neovisan je o HA-u. Mreža radi i dok se HA ponovno pokreće, a teoretski je možeš spojiti i na drugi sustav.
Tri dijela za održavanje umjesto jednog: Zigbee2MQTT, Mosquitto i MQTT integracija.

Kako odlučiti

Imaš uglavnom poznate marke (IKEA, Philips Hue, Aqara) i želiš što manje održavanja: ZHA.
Kupuješ raznolike uređaje, voliš imati sve postavke pod rukom ili već koristiš MQTT za druge stvari: Zigbee2MQTT.

Prelazak s jednog na drugo kasnije u pravilu znači ponovno uparivanje svih uređaja, pa odluku shvati ozbiljno.

Usmjerivači i krajnji uređaji

Zigbee uređaji imaju dvije uloge:

Usmjerivači (routers) su uređaji na stalnom napajanju: pametne utičnice, žarulje, ugradni releji, neki zidni prekidači. Prosljeđuju poruke drugima i grade mrežu.
Krajnji uređaji (end devices) su baterijski senzori i daljinski upravljači. Većinu vremena spavaju i ne prosljeđuju ništa. Svaki se drži jednog "roditelja", koordinatora ili usmjerivača.

Iz toga slijede tri pravila:

Prvo usmjerivači. Prije senzora rasporedi nekoliko utičnica ili releja po stanu, tako da svaka prostorija ima barem jedan usmjerivač u blizini.
Uparuj na mjestu gdje će uređaj živjeti. Utičnicu ne uparuj pokraj koordinatora pa je onda nosi na drugi kraj stana. Uključi je tamo gdje će stajati i tek onda pokreni uparivanje. Isto vrijedi za senzore: baterijski uređaj pri uparivanju bira roditelja u blizini.
Pametne žarulje na prekidaču nisu dobri usmjerivači. Kad netko ugasi zidni prekidač, žarulja nestaje iz mreže, a uređaji koji su išli preko nje moraju tražiti novi put. Za temelj mreže radije koristi utičnice i releje.

Nakon uparivanja daj mreži nekoliko sati da se složi prije nego što zaključiš da je nešto slabo. Karta mreže u ZHA ili Zigbee2MQTT pokazat će koje veze su slabe.

Primjer: svjetlo u hodniku na pokret

Senzor pokreta u hodniku pali svjetlo samo kad je sunce ispod horizonta i gasi ga kad dvije minute nema pokreta. Ako ti logika okidača, uvjeta i akcija nije poznata, pogledaj vodič okidači, uvjeti i akcije.

alias: Hodnik, svjetlo na pokret nakon zalaska
description: Pali svjetlo na pokret kad je mrak, gasi nakon 2 min bez pokreta.
mode: restart
triggers:
  - trigger: state
    entity_id: binary_sensor.hodnik_pokret
    to: "on"
conditions:
  - condition: state
    entity_id: sun.sun
    state: below_horizon
actions:
  - action: light.turn_on
    target:
      entity_id: light.hodnik
  - wait_for_trigger:
      - trigger: state
        entity_id: binary_sensor.hodnik_pokret
        to: "off"
        for:
          minutes: 2
  - action: light.turn_off
    target:
      entity_id: light.hodnik

Nekoliko napomena:

Uvjet koristi stanje sun.sun umjesto condition: sun s after: sunset. Uvjet after: sunset vrijedi samo do ponoći, pa svjetlo u tri ujutro ne bi radilo.
mode: restart znači da novi pokret prekida čekanje i kreće ispočetka, pa se svjetlo ne gasi dok netko još hoda.
Senzor pokreta sam drži stanje on neko vrijeme nakon zadnjeg pokreta. Stvarno vrijeme do gašenja zato je to vrijeme plus dvije minute. Kod nekih modela interval se može podesiti, češće u Zigbee2MQTT nego u ZHA.
Nazive entiteta zamijeni svojima. Automatizaciju možeš zalijepiti u uređivač automatizacija preko opcije Uredi u YAML-u.

Kratki popis

Koordinator na produžnom kabelu, daleko od USB 3 i rutera.
Wi-Fi na fiksnom kanalu, Zigbee na kanalu koji ga izbjegava, odabran prije uparivanja.
ZHA za jednostavnost, Zigbee2MQTT za širinu podrške i kontrolu.
Prvo usmjerivači na stalnom napajanju, uparivanje na konačnom mjestu.
Sigurnosna kopija nakon što mreža proradi. Kod Zigbee2MQTT-a ona uključuje i njegove postavke ako radi kao aplikacija na HAOS-u.

Zigbee uređaji rade lokalno, ali to ne znači da je sustav automatski siguran. Općenita pravila za mrežu i račune nađi u vodiču o sigurnosnim pravilima.