TapHome

Zigbee2Tasmota Gateway

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 03. 2026
Zigbee2Tasmota Gateway

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:

GatewayProcesszorZigbee rádióCsatlakozásMegjegyzések
eWeLink ZB-GW03 (ajánlott)ESP32EFR32 (EZSP)Ethernet + ZigbeeElőretelepített Tasmota firmware-rel kapható
Sonoff ZBBridgeESP8266EFR32 (EZSP)WiFi + ZigbeeKézi Tasmota firmware telepítés szükséges
Sonoff ZBBridge ProESP32CC2652P (ZNP)WiFi + ZigbeeAká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.

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

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éterLeírásPélda
MQTT Broker IP AddressAz MQTT brokered IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic a Configuration → MQTT → Topic menübőltasmota_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:

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

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

Zigbee2Tasmota Gateway Modul
Szerviz attribútumok
Új eszközökNemré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ó)

Tasmota - Zigbee GW

Olvasás (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");
Írás (modul)
if (St = 0, count := NaN, if (isnan(count), count := 0) )
Figyelő
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
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ökPárosított eszköz részletei — felderített Zigbee eszközök azonosítója, gyártója és modellje

Talált eszközök

Olvasás
Va := count
Szerviz attribútumok
New devices
new
Permit Join Kapcsoló

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

Permit Join

Kapcsoló állapot írása
if St = 1
	MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", "");
	new := "";
	ID := "";
end

MQTTPUBLISH("cmnd/" + GWname+ "/ZbPermitJoin", tostring(St));
Figyelő
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.

Források