---
title: "Zigbee2Tasmota Gateway"
description: "Propojte Zigbee zařízení s TapHome přes MQTT pomocí brány s firmwarem Tasmota. Párování, objevování zařízení a koordinace všech Z2T šablon."
url: "https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/"
language: cs
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Jak integrovat Zigbee zařízení s TapHome pomocí Tasmota?","Jaký hardware potřebuji pro Zigbee2Tasmota gateway?","Jak spárovat Zigbee zařízení s TapHome přes Tasmota?","Jak najít Zigbee Device ID po spárování?","Jaký je rozdíl mezi eWeLink ZB-GW03 a Sonoff ZBBridge?","Jak nastavit MQTT pro Zigbee2Tasmota gateway v TapHome?"]
---

# Zigbee2Tasmota Gateway

Komunikace: Packet Parser → MQTT

- [Dokumentace Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/)

> Adresa v síti
> 
> U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

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.

> [!TIP]
> 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

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

> [!TIP]
> 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:

1. Zapněte **Permit Join** v TapHome — tím se odešle příkaz `ZbPermitJoin`, který otevře 60sekundové párovací okno
2. Spusťte párovací proceduru na vašem Zigbee zařízení (typicky podržte resetovací tlačítko 5 sekund, dokud nezačne blikat LED)
3. Sledujte počítadlo **Devices Found** — zvýší se, když se nové zařízení úspěšně připojí k síti
4. Zkontrolujte servisní atribut **New devices** na bráně, kde se zobrazí ID spárovaného zařízení (např. `0x1234`), výrobce a model
5. 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í:

- [Aqara Temperature, Humidity and Pressure Sensor](https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-temperature-humidity-and-pressure-sensor/)
- [Aqara Door and Window Sensor](https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-door-and-window-sensor/)
- [Aqara Vibration Sensor](https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-vibration-sensor/)
- [Aqara Water Leak Sensor](https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-water-leak-sensor/)
- [Aqara Single Switch Module T1 (With Neutral)](https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/)
- [IKEA TRADFRI E1810 Remote](https://taphome.com/cs/compatibility/zigbee2tasmota-ikea-tradfri-e1810/)
- [Livarno SMART TS0505B](https://taphome.com/cs/compatibility/zigbee2tasmota-livarno-smart-ts0505b/)
- [Moes Smart Switch](https://taphome.com/cs/compatibility/zigbee2tasmota-moes-smart-switch/)

## Řešení problémů

### Brána se nepřipojuje k MQTT brokeru

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

### Permit Join nenachází zařízení

1. 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
2. Zkontrolujte, že přepínač Permit Join je zapnutý v TapHome před spuštěním párovací procedury zařízení
3. Během počátečního párování přesuňte Zigbee zařízení blíže k bráně (do 2–3 metrů)
4. 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

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

> [!WARNING]
> 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í 2

Tato zařízení se po importu zobrazí v TapHome.

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

Čtení (modul)

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

Zápis (modul)

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

Listener

```taphome
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

```taphome
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í |

Čtení

```taphome
Va := count
```

Servisní atributy

New devices

```taphome
new
```

Permit Join Přepínač Čtení i zápis

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

Zápis stavu přepínače

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

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

Listener

```taphome
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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci                                           | Výchozí         |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` |

## Zdroje

- Tasmota Zigbee Documentation
  
  [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) 2026-03-29
- Zigbee Compatible Devices Database
  
  2026-03-29
- Supported Zigbee Gateway Hardware
  
  [templates.blakadder.com](https://templates.blakadder.com/ewelink_ZB-GW03.html) 2026-03-29

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)