---
title: "Zigbee2Tasmota Gateway"
description: "Povežite Zigbee uređaje sa sustavom TapHome preko MQTT-a pomoću pristupnika s firmverom Tasmota. Upravlja uparivanjem i koordinira sve predloške Z2T."
url: "https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Kako integrirati Zigbee uređaje sa sustavom TapHome pomoću firmvera Tasmota?","Koji je hardver potreban za Zigbee2Tasmota pristupnik?","Kako upariti Zigbee uređaje sa sustavom TapHome preko firmvera Tasmota?","Kako pronaći Zigbee Device ID nakon uparivanja?","Koja je razlika između eWeLink ZB-GW03 i Sonoff ZBBridge?","Kako postaviti MQTT za Zigbee2Tasmota pristupnik u sustavu TapHome?"]
---

# Zigbee2Tasmota Gateway

Komunikacija: Packet Parser → MQTT

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

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Zigbee2Tasmota (Z2T) je jednostavan most Zigbee-MQTT koji radi na mikrokontrolerima ESP8266/ESP32 s integriranim Zigbee radijskim modulom. Omogućuje sustavu TapHome komunikaciju sa Zigbee uređajima preko vašeg lokalnog MQTT brokera, bez veze s oblakom.

Ovaj predložak pristupnika **preduvjet je za sve predloške uređaja Zigbee2Tasmota**. Mora se uvesti prvi, prije dodavanja bilo kojeg predloška Zigbee uređaja. Pristupnik upravlja uparivanjem uređaja i u sustavu TapHome daje sklopku Permit Join i brojač Pronađeni uređaji.

## Podržani hardver pristupnika

Sa Zigbee2Tasmota kompatibilni su sljedeći Zigbee koordinatori:

| Pristupnik | Procesor | Zigbee radio | Povezivanje | Napomene |
|---------|-----------|-------------|--------------|-------|
| **eWeLink ZB-GW03** (preporučeno) | ESP32 | EFR32 (EZSP) | Ethernet + Zigbee | Dostupan s unaprijed instaliranim firmverom Tasmota |
| **Sonoff ZBBridge** | ESP8266 | EFR32 (EZSP) | Wi-Fi + Zigbee | Zahtijeva ručno učitavanje firmvera Tasmota |
| **Sonoff ZBBridge Pro** | ESP32 | CC2652P (ZNP) | Wi-Fi + Zigbee | Do 128 uređaja, zahtijeva učitavanje firmvera |

Kompatibilan hardver je i Tube's Ethernet Zigbee Gateway (na bazi EFR32) te vlastite DIY izvedbe s ESP32 i modulima CC2530/CC2652.

> [!TIP]
> eWeLink ZB-GW03 preporučuje se zbog Ethernet veze (pouzdanija od Wi-Fi mreže) i dostupnosti s unaprijed instaliranim firmverom Tasmota, pa učitavanje firmvera nije potrebno.

## Konfiguracija

### Postavljanje pristupnika Tasmota

1. Na svoj Zigbee koordinator učitajte [firmver Tasmota](https://tasmota.github.io/docs/Getting-Started/) (preskočite ako je unaprijed instaliran)
2. Preko web-sučelja Tasmota spojite pristupnik na svoju mrežu
3. Idite na **Configuration** → **Configure MQTT** i postavite:
   - **Host:** IP adresu vašeg MQTT brokera (npr. `192.168.1.10`)
   - **Port:** `1883`
4. Zapišite naziv **Topic** (npr. `tasmota_XXXXX`) — to je parametar **Gateway name** koji je potreban pri uvozu predloška

> [!TIP]
> TapHome ima ugrađeni MQTT broker — uključite ga u **Postavke** → **Hardver** → **MQTT Broker**. Dodatni softver za broker nije potreban.

### Parametri za uvoz predloška

Predložak pristupnika zahtijeva 3 parametra:

| Parametar | Opis | Primjer |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | IP adresa vašeg MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (zadano 1883) | `1883` |
| **Gateway name** | Tasmota MQTT tema iz Configuration → MQTT → Topic | `tasmota_XXXXX` |

Nakon uvoza modul se pretplaćuje na `tele/{GWname}/#` i pojavljuju se dva uređaja: **Permit Join** i **Pronađeni uređaji**.

## Mogućnosti uređaja

### Uparivanje Zigbee uređaja

Sklopka **Permit Join** upravlja načinom uparivanja pristupnika:

1. U sustavu TapHome uključite **Permit Join** — time se šalje naredba `ZbPermitJoin` koja otvara razdoblje od 60 sekundi za uparivanje
2. Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
3. Pratite brojač **Pronađeni uređaji** — povećava se kada se novi uređaj uspješno pridruži mreži
4. U servisnom atributu **Novi uređaji** na pristupniku pogledajte ID uparenog uređaja (npr. `0x1234`), proizvođača i model
5. Način uparivanja automatski se isključuje nakon isteka vremena

Device ID (kratka adresa poput `0x1234`) prikazan u servisnim atributima potreban je pri uvozu predložaka za pojedine uređaje.

### Praćenje uređaja

Modul pristupnika svaki sat šalje upit `ZbInfo` i osvježava podatke o svim uparenim Zigbee uređajima. Servisni atribut **Novi uređaji** prikazuje podatke o nedavno otkrivenim uređajima, uključujući njihovu kratku Zigbee adresu, proizvođača i identifikator modela.

### Dodatne mogućnosti

Tasmota Zigbee pristupnik podržava i popis svih uparenih uređaja (`ZbStatus`), pregled konfiguracije mreže (`ZbConfig` — PanID, kanal, ključevi za šifriranje), imenovanje uređaja, upravljanje grupama i izravno povezivanje (binding) između uređaja. Te dijagnostičke i upravljačke mogućnosti mogu se dodati u nekom budućem ažuriranju predloška.

## Podržani predlošci Zigbee uređaja

Nakon uparivanja uređaja uvezite odgovarajući predložak za taj uređaj. Svaki predložak uređaja zahtijeva 4 parametra: MQTT Broker IP, Port, Gateway name (isti kao za pristupnik) i Device ID iz uparivanja.

Dostupni predlošci uređaja Zigbee2Tasmota:

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

## Rješavanje problema

### Pristupnik se ne spaja na MQTT broker

1. Provjerite je li pristupnik Tasmota spojen na mrežu (pogledajte web-sučelje Tasmota)
2. Provjerite podudaraju li se IP adresa i port MQTT brokera u MQTT konfiguraciji firmvera Tasmota i u parametrima za uvoz predloška TapHome
3. Provjerite radi li MQTT broker i je li dostupan na navedenom portu

### Permit Join ne pronalazi uređaje

1. Provjerite je li Zigbee uređaj u načinu uparivanja — većina uređaja zahtijeva držanje tipke 5 i više sekundi
2. Provjerite je li sklopka Permit Join u sustavu TapHome uključena prije pokretanja postupka uparivanja na uređaju
3. Tijekom prvog uparivanja približite Zigbee uređaj pristupniku (na 2–3 metra)
4. Neki uređaji prije uparivanja s novim koordinatorom zahtijevaju vraćanje na tvorničke postavke

### Device ID se ne prikazuje

1. Nakon uspješnog uparivanja u servisnom atributu **Novi uređaji** modula pristupnika potražite ID uređaja, proizvođača i model
2. Ako je servisni atribut prazan, isključite i ponovno uključite Permit Join, a zatim ponovno uparite uređaj
3. Device ID možete pronaći i u konzoli Tasmota (naredba `ZbStatus`) preko web-sučelja pristupnika

> [!WARNING]
> Zigbee radijski kanal ne bi se smio preklapati s kanalom vaše Wi-Fi mreže. Za najbolje rezultate koristite Zigbee kanale 15, 20 ili 25, na koje Wi-Fi najmanje utječe. Trenutačni kanal provjerite naredbom `ZbConfig` u konzoli Tasmota.

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Zigbee2Tasmota Gateway Modul

Servisni atributi

|              |                                                                                               |
|--------------|-----------------------------------------------------------------------------------------------|
| Novi uređaji | Nedavno otkriveni Zigbee uređaji — nakon uparivanja prikazuje ID uređaja, proizvođača i model |

Prilagođene varijable

|                   |                                                                                       |
|-------------------|---------------------------------------------------------------------------------------|
| `GWname` (string) | Naziv Tasmota MQTT teme Zigbee pristupnika (nalazi se u Configuration → MQTT → Topic) |

Čitanje (modul)

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

Zapis (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
```

Servisni atributi

New devices

```taphome
new
```

Pronađeni uređaji Varijabla Samo za čitanje

Brojač uspješno uparenih Zigbee uređaja — povećava se kada se novi uređaj pridruži mreži dok je Permit Join uključen

numeric

Servisni atributi

|              |                                                                              |
|--------------|------------------------------------------------------------------------------|
| Novi uređaji | Podaci o uparenom uređaju — ID, proizvođač i model otkrivenih Zigbee uređaja |

Čitanje

```taphome
Va := count
```

Servisni atributi

New devices

```taphome
new
```

Permit Join Sklopka Čitanje i pisanje

Sklopka načina uparivanja Zigbee — otvara razdoblje od 60 sekundi u kojem se novi uređaji mogu pridružiti mreži

boolean

Vrijednosti / stanja: ON · OFF

Zapis stanja sklopke

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

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji                                        | Zadano          |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |

## Izvori

- 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

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

