Zigbee2Tasmota Gateway

Packet Parser → MQTT

Přidal

Poslední aktualizace: 03. 2026

Dokumentace Tasmota Zigbee

Zigbee2Tasmota (Z2T) je lehký Zigbee-to-MQTT bridge běžící na mikrokontrolérech ESP8266/ESP32 s integrovaným Zigbee rádiovým modulem. Umožňuje TapHome komunikovat se Zigbee zařízeními přes lokální MQTT broker — bez připojení do cloudu.

Tato šablona brány je předpokladem pro všechny šablony Zigbee2Tasmota zařízení. Musí být importována jako první, před přidáním jakýchkoli šablon Zigbee zařízení. Brána zajišťuje párování zařízení a poskytuje v TapHome přepínač Permit Join a počítadlo Devices Found.

Podporovaný hardware brány

Následující Zigbee koordinátory jsou kompatibilní se Zigbee2Tasmota:

Brána	Procesor	Zigbee rádio	Připojení	Poznámky
eWeLink ZB-GW03 (doporučený)	ESP32	EFR32 (EZSP)	Ethernet + Zigbee	K dispozici s předinstalovaným firmwarem Tasmota
Sonoff ZBBridge	ESP8266	EFR32 (EZSP)	WiFi + Zigbee	Vyžaduje ruční nahrání firmwaru Tasmota
Sonoff ZBBridge Pro	ESP32	CC2652P (ZNP)	WiFi + Zigbee	Až 128 zařízení, vyžaduje nahrání firmwaru

Mezi další kompatibilní hardware patří Tube’s Ethernet Zigbee Gateway (na bázi EFR32) a vlastní DIY sestavy s ESP32 a moduly CC2530/CC2652.

eWeLink ZB-GW03 je doporučený díky Ethernet připojení (spolehlivější než WiFi) a dostupnosti s předinstalovaným firmwarem Tasmota — bez nutnosti flashování.

Konfigurace

Nastavení Tasmota brány

Nahrajte firmware Tasmota na váš Zigbee koordinátor (přeskočte, pokud je předinstalovaný)
Připojte bránu k síti přes webové rozhraní Tasmota
Přejděte na Configuration → Configure MQTT a nastavte:
- Host: IP adresa vašeho MQTT brokeru (např. 192.168.1.10)
- Port: 1883
Zapište si název Topic (např. tasmota_XXXXX) — jedná se o parametr Gateway name potřebný při importu šablony

TapHome má vestavěný MQTT broker — aktivujte ho v Settings → Hardware → MQTT Broker. Není potřeba žádný další software pro broker.

Parametry importu šablony

Šablona brány vyžaduje 3 parametry:

Parametr	Popis	Příklad
MQTT Broker IP Address	IP adresa vašeho MQTT brokeru	`192.168.1.10`
MQTT Broker Port	Port brokeru (výchozí 1883)	`1883`
Gateway name	Tasmota MQTT topic z Configuration → MQTT → Topic	`tasmota_XXXXX`

Po importu se modul přihlásí k odběru tele/{GWname}/# a v TapHome se objeví dvě zařízení: Permit Join a Devices Found.

Funkce zařízení

Párování Zigbee zařízení

Přepínač Permit Join ovládá párovací režim brány:

Zapněte Permit Join v TapHome — tím se odešle příkaz ZbPermitJoin, který otevře 60sekundové párovací okno
Spusťte párovací proceduru na vašem Zigbee zařízení (typicky podržte resetovací tlačítko 5 sekund, dokud nezačne blikat LED)
Sledujte počítadlo Devices Found — zvýší se, když se nové zařízení úspěšně připojí k síti
Zkontrolujte servisní atribut New devices na bráně, kde se zobrazí ID spárovaného zařízení (např. 0x1234), výrobce a model
Párovací režim se automaticky deaktivuje po uplynutí časového limitu

Device ID (krátká adresa jako 0x1234) zobrazené v servisních atributech je potřebné při importu šablon specifických pro dané zařízení.

Monitorování zařízení

Modul brány každou hodinu dotazuje ZbInfo pro obnovení informací o všech spárovaných Zigbee zařízeních. Servisní atribut New devices zobrazuje detaily nedávno objevených zařízení včetně jejich krátké Zigbee adresy, výrobce a identifikátoru modelu.

Další funkce

Tasmota Zigbee brána také podporuje výpis všech spárovaných zařízení (ZbStatus), zobrazení konfigurace sítě (ZbConfig — PanID, kanál, šifrovací klíče), pojmenování zařízení, správu skupin a přímé vazby mezi zařízeními. Tyto diagnostické a správcovské funkce mohou být doplněny v budoucí aktualizaci šablony.

Podporované šablony Zigbee zařízení

Po spárování zařízení importujte odpovídající šablonu specifickou pro dané zařízení. Každá šablona zařízení vyžaduje 4 parametry: MQTT Broker IP, Port, Gateway name (stejný jako u brány) a Device ID z párování.

Dostupné šablony Zigbee2Tasmota zařízení:

Řešení problémů

Brána se nepřipojuje k MQTT brokeru

Ověřte, že Tasmota brána je připojena k síti (zkontrolujte webové rozhraní Tasmota)
Potvrďte, že IP adresa a port MQTT brokeru se shodují mezi konfigurací Tasmota MQTT a parametry importu šablony v TapHome
Zkontrolujte, zda MQTT broker běží a je dostupný na zadaném portu

Permit Join nenachází zařízení

Ujistěte se, že Zigbee zařízení je v párovacím režimu — většina zařízení vyžaduje podržení tlačítka na 5+ sekund
Zkontrolujte, že přepínač Permit Join je zapnutý v TapHome před spuštěním párovací procedury zařízení
Během počátečního párování přesuňte Zigbee zařízení blíže k bráně (do 2–3 metrů)
Některá zařízení vyžadují obnovení továrního nastavení, než se mohou spárovat s novým koordinátorem

Device ID se nezobrazuje

Po úspěšném spárování zkontrolujte servisní atribut New devices na modulu brány pro Device ID, výrobce a model
Pokud je servisní atribut prázdný, zkuste přepnout Permit Join na OFF a znovu na ON, poté zařízení znovu spárujte
Device ID lze také najít v konzoli Tasmota (příkaz ZbStatus) přes webové rozhraní brány

Zigbee rádiový kanál by se neměl překrývat s vaším Wi-Fi kanálem. Pro nejlepší výsledky použijte Zigbee kanály 15, 20 nebo 25, které mají minimální rušení od Wi-Fi. Aktuální kanál zkontrolujete příkazem ZbConfig v konzoli Tasmota.

Dostupná zařízení

Zigbee2Tasmota Gateway Modul

Servisní atributy

Nová zařízení

Nedávno objevená Zigbee zařízení — zobrazuje ID zařízení, výrobce a model po spárování

Vlastní proměnné

GWname (string) Název MQTT topicu Tasmota pro Zigbee bránu (najdete v Configuration → MQTT → Topic)

Tasmota - Zigbee GW

Čtení (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í atributy

New devices

new

Nalezená zařízení Proměnná Pouze ke čtení

Počítadlo úspěšně spárovaných Zigbee zařízení — zvyšuje se během Permit Join při připojení nového zařízení

numeric

Servisní atributy

Nová zařízení

Detaily spárovaného zařízení — ID, výrobce a model objevených Zigbee zařízení

Permit Join Přepínač

Přepínač párovacího režimu Zigbee — povolí 60sekundové okno pro připojení nových zařízení k síti

boolean

Hodnoty / Stavy: ON · OFF

Permit Join

Zápis stavu přepínače

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

Připojení: Packet Parser → MQTT

Možná vylepšení (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.

Stáhnout šablonu

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