TapHome
Službeni · TapHome Provjereno

Zigbee2Tasmota Gateway

Zigbee2Tasmota pristupnik (gateway) za povezivanje Zigbee uređaja sa sustavom TapHome preko MQTT-a. Upravlja uparivanjem i otkrivanjem uređaja preko koordinatora s firmverom Tasmota.

TasmotaPacket Parser → MQTT2 uređajaRevizija 1.0 Posljednje ažuriranje: 29. ožujka 2026.
Radi na Coreu TapHome Next 2026.1.41766
iOvaj smo predložak u laboratoriju TapHome uvezli u ovaj Core i svi su njegovi uređaji dodani bez pogreške.
Zigbee2Tasmota Gateway

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Adresa u mreži

Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera 127.0.0.1 (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.

Priprema mreže

Upute za integraciju

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:

PristupnikProcesorZigbee radioPovezivanjeNapomene
eWeLink ZB-GW03 (preporučeno)ESP32EFR32 (EZSP)Ethernet + ZigbeeDostupan s unaprijed instaliranim firmverom Tasmota
Sonoff ZBBridgeESP8266EFR32 (EZSP)Wi-Fi + ZigbeeZahtijeva ručno učitavanje firmvera Tasmota
Sonoff ZBBridge ProESP32CC2652P (ZNP)Wi-Fi + ZigbeeDo 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

  1. Na svoj Zigbee koordinator učitajte firmver Tasmota (preskočite ako je unaprijed instaliran)
  2. Preko web-sučelja Tasmota spojite pristupnik na svoju mrežu
  3. Idite na Configuration → Configure MQTT i postavite:
    • Host: IP adresu vašeg MQTT brokera (npr. 192.168.1.10)
    • Port: 1883
  4. 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:

ParametarOpisPrimjer
MQTT Broker IP AddressIP adresa vašeg MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (zadano 1883)1883
Gateway nameTasmota MQTT tema iz Configuration → MQTT → Topictasmota_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:

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

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

Permit Join ne pronalazi uređaje

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

Device ID se ne prikazuje

  1. Nakon uspješnog uparivanja u servisnom atributu Novi uređaji modula pristupnika potražite ID uređaja, proizvođača i model
  2. Ako je servisni atribut prazan, isključite i ponovno uključite Permit Join, a zatim ponovno uparite uređaj
  3. 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 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Zigbee2Tasmota Gateway Modul
Servisni atributi
Novi uređajiNedavno 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đajiPodaci o uparenom uređaju — ID, proizvođač i model otkrivenih Zigbee uređaja

Pronađeni uređaji

Čitanje
Va := count
Servisni atributi
New devices
new
Permit Join Sklopka Čitanje i pisanje

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.

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Gateway name (Tasmota->Configuration->MQTT->Topic)tasmota_XXXXX

Izvori

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.

Predložak · TapHome portal Zigbee2Tasmota Gateway 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. Packet Parser → MQTT Pogledaj u TapHome portalu