Zigbee2Tasmota Gateway

Packet Parser → MQTT

Autor

Posljednje ažuriranje: 03. 2026

Dokumentacija Tasmota Zigbee

Zigbee2Tasmota (Z2T) je jednostavan most Zigbee-MQTT koji radi na mikrokontrolerima ESP8266/ESP32 s integriranim Zigbee radijskim modulom. Omogućuje sustavu TapHome komunikaciju sa Zigbee uređajima preko vašeg lokalnog MQTT brokera, bez veze s oblakom.

Ovaj predložak pristupnika preduvjet je za sve predloške uređaja Zigbee2Tasmota. Mora se uvesti prvi, prije dodavanja bilo kojeg predloška Zigbee uređaja. Pristupnik upravlja uparivanjem uređaja i u sustavu TapHome daje sklopku Permit Join i brojač Pronađeni uređaji.

Podržani hardver pristupnika

Sa Zigbee2Tasmota kompatibilni su sljedeći Zigbee koordinatori:

Pristupnik	Procesor	Zigbee radio	Povezivanje	Napomene
eWeLink ZB-GW03 (preporučeno)	ESP32	EFR32 (EZSP)	Ethernet + Zigbee	Dostupan s unaprijed instaliranim firmverom Tasmota
Sonoff ZBBridge	ESP8266	EFR32 (EZSP)	Wi-Fi + Zigbee	Zahtijeva ručno učitavanje firmvera Tasmota
Sonoff ZBBridge Pro	ESP32	CC2652P (ZNP)	Wi-Fi + Zigbee	Do 128 uređaja, zahtijeva učitavanje firmvera

Kompatibilan hardver je i Tube’s Ethernet Zigbee Gateway (na bazi EFR32) te vlastite DIY izvedbe s ESP32 i modulima CC2530/CC2652.

eWeLink ZB-GW03 preporučuje se zbog Ethernet veze (pouzdanija od Wi-Fi mreže) i dostupnosti s unaprijed instaliranim firmverom Tasmota, pa učitavanje firmvera nije potrebno.

Konfiguracija

Postavljanje pristupnika Tasmota

Na svoj Zigbee koordinator učitajte firmver Tasmota (preskočite ako je unaprijed instaliran)
Preko web-sučelja Tasmota spojite pristupnik na svoju mrežu
Idite na Configuration → Configure MQTT i postavite:
- Host: IP adresu vašeg MQTT brokera (npr. 192.168.1.10)
- Port: 1883
Zapišite naziv Topic (npr. tasmota_XXXXX) — to je parametar Gateway name koji je potreban pri uvozu predloška

TapHome ima ugrađeni MQTT broker — uključite ga u Postavke → Hardver → MQTT Broker. Dodatni softver za broker nije potreban.

Parametri za uvoz predloška

Predložak pristupnika zahtijeva 3 parametra:

Parametar	Opis	Primjer
MQTT Broker IP Address	IP adresa vašeg MQTT brokera	`192.168.1.10`
MQTT Broker Port	Port brokera (zadano 1883)	`1883`
Gateway name	Tasmota MQTT tema iz Configuration → MQTT → Topic	`tasmota_XXXXX`

Nakon uvoza modul se pretplaćuje na tele/{GWname}/# i pojavljuju se dva uređaja: Permit Join i Pronađeni uređaji.

Mogućnosti uređaja

Uparivanje Zigbee uređaja

Sklopka Permit Join upravlja načinom uparivanja pristupnika:

U sustavu TapHome uključite Permit Join — time se šalje naredba ZbPermitJoin koja otvara razdoblje od 60 sekundi za uparivanje
Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
Pratite brojač Pronađeni uređaji — povećava se kada se novi uređaj uspješno pridruži mreži
U servisnom atributu Novi uređaji na pristupniku pogledajte ID uparenog uređaja (npr. 0x1234), proizvođača i model
Način uparivanja automatski se isključuje nakon isteka vremena

Device ID (kratka adresa poput 0x1234) prikazan u servisnim atributima potreban je pri uvozu predložaka za pojedine uređaje.

Praćenje uređaja

Modul pristupnika svaki sat šalje upit ZbInfo i osvježava podatke o svim uparenim Zigbee uređajima. Servisni atribut Novi uređaji prikazuje podatke o nedavno otkrivenim uređajima, uključujući njihovu kratku Zigbee adresu, proizvođača i identifikator modela.

Dodatne mogućnosti

Tasmota Zigbee pristupnik podržava i popis svih uparenih uređaja (ZbStatus), pregled konfiguracije mreže (ZbConfig — PanID, kanal, ključevi za šifriranje), imenovanje uređaja, upravljanje grupama i izravno povezivanje (binding) između uređaja. Te dijagnostičke i upravljačke mogućnosti mogu se dodati u nekom budućem ažuriranju predloška.

Podržani predlošci Zigbee uređaja

Nakon uparivanja uređaja uvezite odgovarajući predložak za taj uređaj. Svaki predložak uređaja zahtijeva 4 parametra: MQTT Broker IP, Port, Gateway name (isti kao za pristupnik) i Device ID iz uparivanja.

Dostupni predlošci uređaja Zigbee2Tasmota:

Rješavanje problema

Pristupnik se ne spaja na MQTT broker

Provjerite je li pristupnik Tasmota spojen na mrežu (pogledajte web-sučelje Tasmota)
Provjerite podudaraju li se IP adresa i port MQTT brokera u MQTT konfiguraciji firmvera Tasmota i u parametrima za uvoz predloška TapHome
Provjerite radi li MQTT broker i je li dostupan na navedenom portu

Permit Join ne pronalazi uređaje

Provjerite je li Zigbee uređaj u načinu uparivanja — većina uređaja zahtijeva držanje tipke 5 i više sekundi
Provjerite je li sklopka Permit Join u sustavu TapHome uključena prije pokretanja postupka uparivanja na uređaju
Tijekom prvog uparivanja približite Zigbee uređaj pristupniku (na 2–3 metra)
Neki uređaji prije uparivanja s novim koordinatorom zahtijevaju vraćanje na tvorničke postavke

Device ID se ne prikazuje

Nakon uspješnog uparivanja u servisnom atributu Novi uređaji modula pristupnika potražite ID uređaja, proizvođača i model
Ako je servisni atribut prazan, isključite i ponovno uključite Permit Join, a zatim ponovno uparite uređaj
Device ID možete pronaći i u konzoli Tasmota (naredba ZbStatus) preko web-sučelja pristupnika

Zigbee radijski kanal ne bi se smio preklapati s kanalom vaše Wi-Fi mreže. Za najbolje rezultate koristite Zigbee kanale 15, 20 ili 25, na koje Wi-Fi najmanje utječe. Trenutačni kanal provjerite naredbom ZbConfig u konzoli Tasmota.

Dostupni uređaji

Zigbee2Tasmota Gateway Modul

Servisni atributi

Novi uređaji

Nedavno otkriveni Zigbee uređaji — nakon uparivanja prikazuje ID uređaja, proizvođača i model

Prilagođene varijable

GWname (string) Naziv Tasmota MQTT teme Zigbee pristupnika (nalazi se u Configuration → MQTT → Topic)

Tasmota - Zigbee GW

Čitanje (modul)

MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");

Zapis (modul)

if (St = 0, count := NaN, if (isnan(count), count := 0) )

Listener

if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var ModelId := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".ModelId", true);
    var Manufacturer := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Manufacturer", true);
    if !ISNULL(Manufacturer) and !ISNULL(ModelId)
    	new := new + ID + " - " + Manufacturer + " (" + ModelId + ")";
    	ID := "";
    	count := count +1;
    end
end

if INDEXOF(RECEIVEDMSG.Topic, "RESULT") > 0
	if PARSEJSON(RECEIVEDMSG.Payload, "$.ZbState.JoinStatus", true) = 1
		ID := PARSEJSON(RECEIVEDMSG.Payload, "$.ZbState.ShortAddr");
	end
end

Servisni atributi

New devices

new

Pronađeni uređaji Varijabla Samo za čitanje

Brojač uspješno uparenih Zigbee uređaja — povećava se kada se novi uređaj pridruži mreži dok je Permit Join uključen

numeric

Servisni atributi

Novi uređaji

Podaci o uparenom uređaju — ID, proizvođač i model otkrivenih Zigbee uređaja

Permit Join Sklopka

Sklopka načina uparivanja Zigbee — otvara razdoblje od 60 sekundi u kojem se novi uređaji mogu pridružiti mreži

boolean

Vrijednosti / stanja: ON · OFF

Permit Join

Zapis stanja sklopke

if St = 1
	MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");
	new := "";
	ID := "";
end

MQTTPUBLISH("cmnd/" + GWname+ "/ZbPermitJoin", tostring(St));

Listener

if INDEXOF(RECEIVEDMSG.Topic, "RESULT") > 0
    var Status := PARSEJSON(RECEIVEDMSG.Payload, "ZbState.Status", true);
    if Status = 20
        St := 0;
    elseif Status = 21
        St := 1;
    end
end

if (St = 0, count := NaN, if (isnan(count), count := 0) )

Povezivanje: Packet Parser → MQTT

Moguća poboljšanja (2)

Zigbee Device List — Lists all paired devices with short/IEEE addresses. Could provide a device inventory view.
Zigbee Network Configuration — PanID, ExtPanID, channel, encryption keys. Could expose as service attributes.

Preuzmite predložak

Izvori

Tasmota Zigbee Documentation
tasmota.github.io 2026-03-29
Zigbee Compatible Devices Database
2026-03-29
Supported Zigbee Gateway Hardware
templates.blakadder.com 2026-03-29

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu