---
title: "Zigbee2Tasmota Gateway"
description: "Zigbee brána s firmvérom Tasmota (napr. ZB-GW03, Sonoff ZBBridge) pripojí Zigbee zariadenia k TapHome cez MQTT: párovanie a objavovanie zariadení."
url: "https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/"
language: sk
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Ako integrovať Zigbee zariadenia s TapHome pomocou Tasmota?","Aký hardvér potrebujem pre Zigbee2Tasmota gateway?","Ako spárovať Zigbee zariadenia s TapHome cez Tasmota?","Ako nájsť Zigbee Device ID po spárovaní?","Aký je rozdiel medzi eWeLink ZB-GW03 a Sonoff ZBBridge?","Ako nastaviť MQTT pre Zigbee2Tasmota gateway v TapHome?"]
---

# Zigbee2Tasmota Gateway

Komunikácia: Packet Parser → MQTT

- [Dokumentácia Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/)

> Adresa v sieti
> 
> Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

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.

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

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

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

1. Zapnite **Permit Join** v TapHome — tým sa odošle príkaz `ZbPermitJoin`, ktorý otvorí 60-sekundové párovacie okno
2. 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)
3. Sledujte počítadlo **Devices Found** — zvýši sa, keď sa nové zariadenie úspešne pripojí k sieti
4. Skontrolujte servisný atribút **New devices** na bráne, kde sa zobrazí ID spárovaného zariadenia (napr. `0x1234`), výrobca a model
5. 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í:

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

## Riešenie problémov

### Brána sa nepripája k MQTT brokeru

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

### Permit Join nenachádza zariadenia

1. Uistite sa, že Zigbee zariadenie je v párovacom režime — väčšina zariadení vyžaduje podržanie tlačidla na 5+ sekúnd
2. Skontrolujte, že prepínač Permit Join je zapnutý v TapHome pred spustením párovacej procedúry zariadenia
3. Počas prvotného párovania premiestnite Zigbee zariadenie bližšie k bráne (do 2–3 metrov)
4. 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

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

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

Tieto zariadenia sa po importe zobrazia v TapHome.

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

Čítanie (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é atribúty

New devices

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

Čítanie

```taphome
Va := count
```

Servisné atribúty

New devices

```taphome
new
```

Permit Join Prepínač Čítanie aj zápis

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

boolean

Hodnoty / Stavy: ON · OFF

Zápis stavu prepínača

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

**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.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii                                         | Predvolené      |
|-------------------------------------------------------------|-----------------|
| 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

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)