Zigbee2Tasmota Gateway

Packet Parser → MQTT

Trimis de

Ultima actualizare: 03. 2026

Documentația Tasmota Zigbee

Zigbee2Tasmota (Z2T) este un bridge Zigbee–MQTT ușor, care rulează pe microcontrolere ESP8266/ESP32 cu modul radio Zigbee integrat. Permite TapHome să comunice cu dispozitivele Zigbee prin brokerul MQTT local — fără conexiune la cloud.

Acest șablon de gateway este condiția preliminară pentru toate șabloanele de dispozitive Zigbee2Tasmota. Trebuie importat primul, înainte de a adăuga orice șablon de dispozitiv Zigbee. Gateway-ul gestionează împerecherea dispozitivelor și pune la dispoziție în TapHome comutatorul Permit Join și contorul Dispozitive găsite.

Hardware de gateway acceptat

Următorii coordonatori Zigbee sunt compatibili cu Zigbee2Tasmota:

Gateway	Procesor	Radio Zigbee	Conectivitate	Note
eWeLink ZB-GW03 (recomandat)	ESP32	EFR32 (EZSP)	Ethernet + Zigbee	Disponibil cu Tasmota preinstalat
Sonoff ZBBridge	ESP8266	EFR32 (EZSP)	Wi-Fi + Zigbee	Necesită încărcarea manuală a firmware-ului Tasmota
Sonoff ZBBridge Pro	ESP32	CC2652P (ZNP)	Wi-Fi + Zigbee	Până la 128 de dispozitive, necesită încărcarea firmware-ului

Alte echipamente hardware compatibile sunt Tube’s Ethernet Zigbee Gateway (bazat pe EFR32) și gateway-uri DIY construite folosind ESP32 și module CC2530/CC2652.

eWeLink ZB-GW03 este recomandat pentru conectivitatea Ethernet (mai fiabilă decât Wi-Fi) și pentru că este disponibil cu Tasmota preinstalat — nu este necesară încărcarea firmware-ului.

Configurare

Configurarea gateway-ului Tasmota

Încărcați firmware-ul Tasmota pe coordonatorul Zigbee (omiteți acest pas dacă este preinstalat)
Conectați gateway-ul la rețea prin interfața web Tasmota
Accesați Configuration → Configure MQTT și setați:
- Host: adresa IP a brokerului dvs. MQTT (de ex. 192.168.1.10)
- Port: 1883
Notați numele Topic (de ex. tasmota_XXXXX) — acesta este parametrul Gateway name necesar la importul șablonului

TapHome are un broker MQTT integrat — activați-l în Setări → Hardware → MQTT Broker. Nu este necesar niciun software de broker suplimentar.

Parametrii de import ai șablonului

Șablonul gateway-ului necesită 3 parametri:

Parametru	Descriere	Exemplu
MQTT Broker IP Address	Adresa IP a brokerului dvs. MQTT	`192.168.1.10`
MQTT Broker Port	Portul brokerului (implicit 1883)	`1883`
Gateway name	Topicul MQTT Tasmota din Configuration → MQTT → Topic	`tasmota_XXXXX`

După import, modulul se abonează la tele/{GWname}/# și apar două dispozitive: Permit Join și Dispozitive găsite.

Funcțiile dispozitivului

Împerecherea dispozitivelor Zigbee

Comutatorul Permit Join controlează modul de împerechere al gateway-ului:

Porniți Permit Join în TapHome — se publică o comandă ZbPermitJoin care deschide o fereastră de împerechere de 60 de secunde
Porniți procedura de împerechere pe dispozitivul Zigbee (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
Urmăriți contorul Dispozitive găsite — crește când un dispozitiv nou se conectează cu succes la rețea
Verificați atributul de service Dispozitive noi al gateway-ului pentru a vedea ID-ul dispozitivului împerecheat (de ex. 0x1234), producătorul și modelul
Modul de împerechere se dezactivează automat după expirarea timpului

Device ID-ul (adresa scurtă, de ex. 0x1234) afișat în atributele de service este necesar la importul șabloanelor specifice dispozitivelor.

Monitorizarea dispozitivelor

Modulul gateway-ului interoghează ZbInfo la fiecare oră, pentru a actualiza informațiile despre toate dispozitivele Zigbee împerecheate. Atributul de service Dispozitive noi afișează detaliile dispozitivelor descoperite recent, inclusiv adresa scurtă Zigbee, producătorul și identificatorul modelului.

Funcții suplimentare

Gateway-ul Zigbee Tasmota acceptă și listarea tuturor dispozitivelor împerecheate (ZbStatus), vizualizarea configurației rețelei (ZbConfig — PanID, canal, chei de criptare), denumirea dispozitivelor, gestionarea grupurilor și legarea directă între dispozitive. Aceste funcții de diagnosticare și administrare pot fi adăugate într-o actualizare viitoare a șablonului.

Șabloane de dispozitive Zigbee acceptate

După împerecherea unui dispozitiv, importați șablonul specific dispozitivului respectiv. Fiecare șablon de dispozitiv necesită 4 parametri: adresa IP a brokerului MQTT, portul, Gateway name (același ca la gateway) și Device ID-ul de la împerechere.

Șabloane de dispozitive Zigbee2Tasmota disponibile:

Rezolvarea problemelor

Gateway-ul nu se conectează la brokerul MQTT

Verificați dacă gateway-ul Tasmota este conectat la rețea (verificați interfața web Tasmota)
Verificați dacă adresa IP și portul brokerului MQTT sunt aceleași în configurația MQTT Tasmota și în parametrii de import ai șablonului TapHome
Verificați dacă brokerul MQTT rulează și este accesibil pe portul specificat

Permit Join nu găsește dispozitive

Asigurați-vă că dispozitivul Zigbee este în modul de împerechere — majoritatea dispozitivelor necesită ținerea apăsată a unui buton timp de 5 secunde sau mai mult
Verificați dacă comutatorul Permit Join este ON în TapHome înainte de a porni procedura de împerechere a dispozitivului
La prima împerechere, apropiați dispozitivul Zigbee de gateway (la 2–3 metri)
Unele dispozitive necesită o resetare la setările din fabrică înainte de a se putea împerechea cu un coordonator nou

Device ID-ul nu apare

După împerecherea reușită, verificați atributul de service Dispozitive noi al modulului gateway-ului pentru ID-ul dispozitivului, producător și model
Dacă atributul de service este gol, încercați să comutați Permit Join pe OFF și din nou pe ON, apoi împerecheați din nou dispozitivul
Device ID-ul se poate găsi și în consola Tasmota (comanda ZbStatus), prin interfața web a gateway-ului

Canalul radio Zigbee nu trebuie să se suprapună cu canalul Wi-Fi. Pentru cele mai bune rezultate, folosiți canalele Zigbee 15, 20 sau 25, care au interferențe minime cu Wi-Fi. Verificați canalul curent cu comanda ZbConfig în consola Tasmota.

Dispozitive disponibile

Zigbee2Tasmota Gateway Modul

Atribute de service

Dispozitive noi

Dispozitive Zigbee descoperite recent — afișează ID-ul dispozitivului, producătorul și modelul după împerechere

Variabile personalizate

GWname (string) Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic)

Tasmota - Zigbee GW

Citire (modul)

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

Scriere (modul)

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

Ascultător

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

Atribute de service

New devices

new

Dispozitive găsite Variabilă Doar citire

Contorul dispozitivelor Zigbee împerecheate cu succes — crește în timpul Permit Join când se conectează un dispozitiv nou

numeric

Atribute de service

Dispozitive noi

Detaliile dispozitivelor împerecheate — ID-ul, producătorul și modelul dispozitivelor Zigbee descoperite

Permit Join Comutator

Comutator pentru modul de împerechere Zigbee — deschide o fereastră de 60 de secunde în care dispozitivele noi se pot conecta la rețea

boolean

Valori / Stări: ON · OFF

Permit Join

Scrierea stării comutatorului

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

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

Ascultător

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) )

Conexiune: Packet Parser → MQTT

Îmbunătățiri posibile (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.

Descărcați șablon

Surse

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

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal