---
title: "Zigbee2Tasmota Gateway"
description: "Csatlakoztasd Zigbee eszközeidet a TapHome-hoz MQTT-n Tasmota gateway segítségével. Párosítás, eszközfelderítés és az összes Z2T sablon koordinálása."
url: "https://taphome.com/hu/compatibility/zigbee2tasmota-gateway/"
language: hu
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Hogyan integrálhatok Zigbee eszközöket a TapHome-mal Tasmota segítségével?","Milyen hardverre van szükségem a Zigbee2Tasmota gateway-hez?","Hogyan párosíthatok Zigbee eszközöket a TapHome-mal Tasmotán keresztül?","Hogyan találom meg a Zigbee Device ID-t párosítás után?","Mi a különbség az eWeLink ZB-GW03 és a Sonoff ZBBridge között?","Hogyan állítom be az MQTT-t a Zigbee2Tasmota gateway-hez a TapHome-ban?"]
---

# Zigbee2Tasmota Gateway

Kommunikáció: Packet Parser → MQTT

- [Tasmota Zigbee dokumentáció](https://tasmota.github.io/docs/Zigbee/)

> Hálózati cím
> 
> A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

A Zigbee2Tasmota (Z2T) egy könnyűsúlyú Zigbee-to-MQTT bridge, amely ESP8266/ESP32 mikrokontrollereken fut beépített Zigbee rádiómodullal. Lehetővé teszi a TapHome számára a Zigbee eszközökkel való kommunikációt a helyi MQTT brokeren keresztül — felhőkapcsolat nélkül.

Ez a gateway sablon az **összes Zigbee2Tasmota eszközsablon előfeltétele**. Ezt kell először importálni, mielőtt bármilyen Zigbee eszközsablont hozzáadnál. A gateway kezeli az eszközpárosítást, és a TapHome-ban biztosít egy Permit Join kapcsolót és egy Devices Found számlálót.

## Támogatott gateway hardver

A következő Zigbee koordinátorok kompatibilisek a Zigbee2Tasmotával:

| Gateway | Processzor | Zigbee rádió | Csatlakozás | Megjegyzések |
|---------|-----------|-------------|-------------|--------------|
| **eWeLink ZB-GW03** (ajánlott) | ESP32 | EFR32 (EZSP) | Ethernet + Zigbee | Előretelepített Tasmota firmware-rel kapható |
| **Sonoff ZBBridge** | ESP8266 | EFR32 (EZSP) | WiFi + Zigbee | Kézi Tasmota firmware telepítés szükséges |
| **Sonoff ZBBridge Pro** | ESP32 | CC2652P (ZNP) | WiFi + Zigbee | Akár 128 eszköz, firmware telepítés szükséges |

További kompatibilis hardver: Tube's Ethernet Zigbee Gateway (EFR32 alapú) és egyedi DIY összeállítások ESP32 és CC2530/CC2652 modulokkal.

> [!TIP]
> Az eWeLink ZB-GW03 ajánlott az Ethernet csatlakozása (megbízhatóbb, mint a WiFi) és az előretelepített Tasmota firmware elérhetősége miatt — nincs szükség flashelésre.

## Konfiguráció

### A Tasmota gateway beállítása

1. Telepítsd a [Tasmota firmware-t](https://tasmota.github.io/docs/Getting-Started/) a Zigbee koordinátorodra (hagyd ki, ha előretelepített)
2. Csatlakoztasd a gateway-t a hálózathoz a Tasmota webes felületén
3. Navigálj a **Configuration** → **Configure MQTT** menüpontra és állítsd be:
   - **Host:** az MQTT brokered IP-címe (pl. `192.168.1.10`)
   - **Port:** `1883`
4. Jegyezd fel a **Topic** nevét (pl. `tasmota_XXXXX`) — ez a **Gateway name** paraméter, amelyre a sablon importálásakor szükség lesz

> [!TIP]
> A TapHome beépített MQTT brokerrel rendelkezik — aktiváld a **Settings** → **Hardware** → **MQTT Broker** menüpontban. Nincs szükség további broker szoftverre.

### Sablonimport paraméterei

A gateway sablon 3 paramétert igényel:

| Paraméter | Leírás | Példa |
|-----------|--------|-------|
| **MQTT Broker IP Address** | Az MQTT brokered IP-címe | `192.168.1.10` |
| **MQTT Broker Port** | Broker port (alapértelmezett 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic a Configuration → MQTT → Topic menüből | `tasmota_XXXXX` |

Az importálás után a modul feliratkozik a `tele/{GWname}/#` topicra, és két eszköz jelenik meg: **Permit Join** és **Devices Found**.

## Eszközképességek

### Zigbee eszközök párosítása

A **Permit Join** kapcsoló vezérli a gateway párosítási módját:

1. Kapcsold be a **Permit Join**-t a TapHome-ban — ez egy `ZbPermitJoin` parancsot küld, amely 60 másodperces párosítási ablakot nyit
2. Indítsd el a párosítási eljárást a Zigbee eszközödön (általában tartsd nyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd)
3. Figyeld a **Devices Found** számlálót — növekszik, amikor egy új eszköz sikeresen csatlakozik a hálózathoz
4. Ellenőrizd a **New devices** szervizattribútumot a gateway-en, ahol megjelenik a párosított eszköz azonosítója (pl. `0x1234`), gyártója és modellje
5. A párosítási mód az időkorlát lejárta után automatikusan deaktiválódik

A Device ID (rövid cím, pl. `0x1234`), amely a szervizattribútumokban jelenik meg, az eszközspecifikus sablonok importálásakor szükséges.

### Eszközfigyelés

A gateway modul óránként lekérdezi a `ZbInfo`-t az összes párosított Zigbee eszköz adatainak frissítéséhez. A **New devices** szervizattribútum mutatja a nemrég felderített eszközök részleteit, beleértve a rövid Zigbee címüket, gyártójukat és modellazonosítójukat.

### További képességek

A Tasmota Zigbee gateway támogatja az összes párosított eszköz listázását (`ZbStatus`), a hálózati konfiguráció megtekintését (`ZbConfig` — PanID, csatorna, titkosítási kulcsok), az eszközök elnevezését, csoportkezelést és közvetlen eszköz-eszköz kötéseket. Ezek a diagnosztikai és kezelési funkciók egy jövőbeli sablonfrissítésben adhatók hozzá.

## Támogatott Zigbee eszközsablonok

Az eszköz párosítása után importáld a megfelelő eszközspecifikus sablont. Minden eszközsablon 4 paramétert igényel: MQTT Broker IP, Port, Gateway name (ugyanaz, mint a gateway-nél) és a párosításból származó Device ID.

Elérhető Zigbee2Tasmota eszközsablonok:

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

## Hibaelhárítás

### A gateway nem csatlakozik az MQTT brokerhez

1. Ellenőrizd, hogy a Tasmota gateway csatlakozik a hálózathoz (nézd meg a Tasmota webes felületét)
2. Győződj meg, hogy az MQTT broker IP-címe és portja megegyezik a Tasmota MQTT konfigurációjában és a TapHome sablonimport paramétereiben
3. Ellenőrizd, hogy az MQTT broker fut és elérhető a megadott porton

### A Permit Join nem talál eszközöket

1. Győződj meg, hogy a Zigbee eszköz párosítási módban van — a legtöbb eszköznél 5+ másodpercig kell nyomva tartani egy gombot
2. Ellenőrizd, hogy a Permit Join kapcsoló be van kapcsolva a TapHome-ban, mielőtt elindítanád az eszköz párosítási eljárását
3. Az első párosítás során helyezd a Zigbee eszközt közelebb a gateway-hez (2–3 méteren belül)
4. Egyes eszközöknél gyári visszaállítás szükséges, mielőtt új koordinátorral párosíthatók

### A Device ID nem jelenik meg

1. Sikeres párosítás után ellenőrizd a **New devices** szervizattribútumot a gateway modulon a Device ID, gyártó és modell megjelenítéséhez
2. Ha a szervizattribútum üres, próbáld kikapcsolni a Permit Join-t (OFF), majd újra bekapcsolni (ON), és párosítsd újra az eszközt
3. A Device ID a Tasmota konzolon is megtalálható (`ZbStatus` parancs) a gateway webes felületén

> [!WARNING]
> A Zigbee rádiócsatorna ne legyen átfedésben a Wi-Fi csatornáddal. A legjobb eredmény érdekében használd a 15, 20 vagy 25 Zigbee csatornát, amelyek minimális Wi-Fi interferenciával rendelkeznek. Az aktuális csatornát a `ZbConfig` paranccsal ellenőrizheted a Tasmota konzolon.

## Elérhető eszközök 2

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Zigbee2Tasmota Gateway Modul

Szerviz attribútumok

|             |                                                                                                                |
|-------------|----------------------------------------------------------------------------------------------------------------|
| Új eszközök | Nemrég felderített Zigbee eszközök — párosítás után megjeleníti az eszköz azonosítóját, gyártóját és modelljét |

Egyéni változók

|                   |                                                                                             |
|-------------------|---------------------------------------------------------------------------------------------|
| `GWname` (string) | A Zigbee gateway Tasmota MQTT topic neve (a Configuration → MQTT → Topic menüben található) |

Olvasás (modul)

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

Írás (modul)

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

Figyelő

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

Szerviz attribútumok

New devices

```taphome
new
```

Talált eszközök Változó Csak olvasható

Sikeresen párosított Zigbee eszközök számlálója — növekszik a Permit Join alatt, amikor új eszköz csatlakozik

numeric

Szerviz attribútumok

|             |                                                                                             |
|-------------|---------------------------------------------------------------------------------------------|
| Új eszközök | Párosított eszköz részletei — felderített Zigbee eszközök azonosítója, gyártója és modellje |

Olvasás

```taphome
Va := count
```

Szerviz attribútumok

New devices

```taphome
new
```

Permit Join Kapcsoló Olvasás és írás

Zigbee párosítási mód kapcsoló — 60 másodperces ablakot nyit új eszközök hálózathoz csatlakozásához

boolean

Értékek / Állapotok: ON · OFF

Kapcsoló állapot írása

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

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

Figyelő

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

**Kapcsolat:** Packet Parser → MQTT

Lehetséges fejlesztések (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.

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri                                          | Alapérték       |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP-cím                                          | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` |

## Források

- 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

## Kapcsolódó dokumentáció

- [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)
- [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/)
- [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)