Zigbee2Tasmota Gateway

Packet Parser → MQTT

Pridal

Posledná aktualizácia: 03. 2026

Dokumentácia Tasmota Zigbee

Zigbee2Tasmota (Z2T) je ľahký Zigbee-to-MQTT bridge bežiaci na mikrokontroléroch ESP8266/ESP32 s integrovaným Zigbee rádiovým modulom. Umožňuje TapHome komunikovať so Zigbee zariadeniami cez lokálny MQTT broker — bez pripojenia do cloudu.

Táto šablóna brány je predpokladom pre všetky šablóny Zigbee2Tasmota zariadení. Musí byť importovaná ako prvá, pred pridaním akýchkoľvek šablón Zigbee zariadení. Brána zabezpečuje párovanie zariadení a poskytuje v TapHome prepínač Permit Join a počítadlo Devices Found.

Podporovaný hardvér brány

Nasledujúce Zigbee koordinátory sú kompatibilné so Zigbee2Tasmota:

Brána	Procesor	Zigbee rádio	Pripojenie	Poznámky
eWeLink ZB-GW03 (odporúčaný)	ESP32	EFR32 (EZSP)	Ethernet + Zigbee	K dispozícii s predinštalovaným firmvérom Tasmota
Sonoff ZBBridge	ESP8266	EFR32 (EZSP)	WiFi + Zigbee	Vyžaduje manuálne nahratie firmvéru Tasmota
Sonoff ZBBridge Pro	ESP32	CC2652P (ZNP)	WiFi + Zigbee	Až 128 zariadení, vyžaduje nahratie firmvéru

Medzi ďalší kompatibilný hardvér patrí Tube’s Ethernet Zigbee Gateway (na báze EFR32) a vlastné DIY zostavy s ESP32 a modulmi CC2530/CC2652.

eWeLink ZB-GW03 je odporúčaný vďaka Ethernet pripojeniu (spoľahlivejšie ako WiFi) a dostupnosti s predinštalovaným firmvérom Tasmota — bez nutnosti flashovania.

Konfigurácia

Nastavenie Tasmota brány

Nahrajte firmvér Tasmota na váš Zigbee koordinátor (preskočte, ak je predinštalovaný)
Pripojte bránu k sieti cez webové rozhranie Tasmota
Prejdite na Configuration → Configure MQTT a nastavte:
- Host: IP adresa vášho MQTT brokera (napr. 192.168.1.10)
- Port: 1883
Zapíšte si názov Topic (napr. tasmota_XXXXX) — toto je parameter Gateway name potrebný pri importe šablóny

TapHome má vstavaný MQTT broker — aktivujte ho v Settings → Hardware → MQTT Broker. Nie je potrebný žiadny ďalší softvér pre broker.

Parametre importu šablóny

Šablóna brány vyžaduje 3 parametre:

Parameter	Popis	Príklad
MQTT Broker IP Address	IP adresa vášho MQTT brokera	`192.168.1.10`
MQTT Broker Port	Port brokera (predvolený 1883)	`1883`
Gateway name	Tasmota MQTT topic z Configuration → MQTT → Topic	`tasmota_XXXXX`

Po importe sa modul prihlási na odber tele/{GWname}/# a v TapHome sa objavia dve zariadenia: Permit Join a Devices Found.

Funkcie zariadenia

Párovanie Zigbee zariadení

Prepínač Permit Join ovláda párovací režim brány:

Zapnite Permit Join v TapHome — tým sa odošle príkaz ZbPermitJoin, ktorý otvorí 60-sekundové párovacie okno
Spustite párovací procedúru na vašom Zigbee zariadení (zvyčajne podržte resetovacie tlačidlo 5 sekúnd, kým nezačne blikať LED)
Sledujte počítadlo Devices Found — zvýši sa, keď sa nové zariadenie úspešne pripojí k sieti
Skontrolujte servisný atribút New devices na bráne, kde sa zobrazí ID spárovaného zariadenia (napr. 0x1234), výrobca a model
Párovací režim sa automaticky deaktivuje po uplynutí časového limitu

Device ID (krátka adresa ako 0x1234) zobrazené v servisných atribútoch je potrebné pri importe šablón špecifických pre dané zariadenie.

Monitorovanie zariadení

Modul brány každú hodinu dopytuje ZbInfo na obnovenie informácií o všetkých spárovaných Zigbee zariadeniach. Servisný atribút New devices zobrazuje detaily nedávno objavených zariadení vrátane ich krátkej Zigbee adresy, výrobcu a identifikátora modelu.

Ďalšie funkcie

Tasmota Zigbee brána tiež podporuje výpis všetkých spárovaných zariadení (ZbStatus), zobrazenie konfigurácie siete (ZbConfig — PanID, kanál, šifrovacie kľúče), pomenovanie zariadení, správu skupín a priame väzby medzi zariadeniami. Tieto diagnostické a správcovské funkcie môžu byť doplnené v budúcej aktualizácii šablóny.

Podporované šablóny Zigbee zariadení

Po spárovaní zariadenia importujte príslušnú šablónu špecifickú pre dané zariadenie. Každá šablóna zariadenia vyžaduje 4 parametre: MQTT Broker IP, Port, Gateway name (rovnaký ako pri bráne) a Device ID z párovania.

Dostupné šablóny Zigbee2Tasmota zariadení:

Riešenie problémov

Brána sa nepripája k MQTT brokeru

Overte, že Tasmota brána je pripojená k sieti (skontrolujte webové rozhranie Tasmota)
Potvrďte, že IP adresa a port MQTT brokera sa zhodujú medzi konfiguráciou Tasmota MQTT a parametrami importu šablóny v TapHome
Skontrolujte, či MQTT broker beží a je dostupný na zadanom porte

Permit Join nenachádza zariadenia

Uistite sa, že Zigbee zariadenie je v párovacom režime — väčšina zariadení vyžaduje podržanie tlačidla na 5+ sekúnd
Skontrolujte, že prepínač Permit Join je zapnutý v TapHome pred spustením párovacej procedúry zariadenia
Počas prvotného párovania premiestnite Zigbee zariadenie bližšie k bráne (do 2–3 metrov)
Niektoré zariadenia vyžadujú obnovenie továrenskych nastavení predtým, než sa môžu spárovať s novým koordinátorom

Device ID sa nezobrazuje

Po úspešnom spárovaní skontrolujte servisný atribút New devices na module brány pre Device ID, výrobcu a model
Ak je servisný atribút prázdny, skúste prepnúť Permit Join na OFF a znova na ON, potom zariadenie znova spárujte
Device ID možno nájsť aj v konzole Tasmota (príkaz ZbStatus) cez webové rozhranie brány

Zigbee rádiový kanál by sa nemal prekrývať s vaším Wi-Fi kanálom. Pre najlepšie výsledky použite Zigbee kanály 15, 20 alebo 25, ktoré majú minimálne rušenie od Wi-Fi. Aktuálny kanál skontrolujete príkazom ZbConfig v konzole Tasmota.

Dostupné zariadenia

Zigbee2Tasmota Gateway Modul

Servisné atribúty

Nové zariadenia

Nedávno objavené Zigbee zariadenia — zobrazuje ID zariadenia, výrobcu a model po spárovaní

Vlastné premenné

GWname (string) Názov MQTT topicu Tasmota pre Zigbee bránu (nájdete v Configuration → MQTT → Topic)

Tasmota - Zigbee GW

Čítanie (modul)

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

Zápis (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

Servisné atribúty

New devices

new

Nájdené zariadenia Premenná Len na čítanie

Počítadlo úspešne spárovaných Zigbee zariadení — zvyšuje sa počas Permit Join pri pripojení nového zariadenia

numeric

Servisné atribúty

Nové zariadenia

Detaily spárovaného zariadenia — ID, výrobca a model objavených Zigbee zariadení

Permit Join Prepínač

Prepínač párovacieho režimu Zigbee — povolí 60-sekundové okno pre pripojenie nových zariadení k sieti

boolean

Hodnoty / Stavy: ON · OFF

Permit Join

Zápis stavu prepínača

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

Pripojenie: Packet Parser → MQTT

Možné vylepšenia (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.

Stiahnuť šablónu

Zdroje

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