Zigbee2Tasmota Gateway

Packet Parser → MQTT

Pridal

Posledná aktualizácia: 06. 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

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli