Zigbee2Tasmota Gateway

Packet Parser → MQTT

Přidal

Poslední aktualizace: 06. 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

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu