---
title: "Zigbee2Tasmota Gateway"
description: "Brama Zigbee2Tasmota łączy urządzenia Zigbee z TapHome przez lokalny broker MQTT. Parowanie Permit Join i licznik urządzeń. Import jako pierwszy."
url: "https://taphome.com/pl/compatibility/zigbee2tasmota-gateway/"
language: pl
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Jak zintegrować urządzenia Zigbee z TapHome za pomocą Tasmota?","Jaki sprzęt jest potrzebny do Zigbee2Tasmota gateway?","Jak sparować urządzenia Zigbee z TapHome przez Tasmota?","Jak znaleźć Zigbee Device ID po sparowaniu?","Jaka jest różnica między eWeLink ZB-GW03 a Sonoff ZBBridge?","Jak skonfigurować MQTT dla Zigbee2Tasmota gateway w TapHome?"]
---

# Zigbee2Tasmota Gateway

Komunikacja: Packet Parser → MQTT

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

> Adres w sieci
> 
> Przy brokerze MQTT wbudowanym w TapHome wpisz w TapHome jako adres brokera `127.0.0.1`. W urządzeniu wpisz adres IP TapHome Core i nadaj jednostce Core rezerwację IP w routerze.
> 
> [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/)

## Poradnik integracji

Zigbee2Tasmota (Z2T) to lekki bridge Zigbee-to-MQTT działający na mikrokontrolerach ESP8266/ESP32 ze zintegrowanym modułem radiowym Zigbee. Umożliwia TapHome komunikację z urządzeniami Zigbee przez lokalny broker MQTT — bez połączenia z chmurą.

Ten szablon bramy jest **warunkiem wstępnym dla wszystkich szablonów urządzeń Zigbee2Tasmota**. Musi być zaimportowany jako pierwszy, przed dodaniem jakichkolwiek szablonów urządzeń Zigbee. Brama obsługuje parowanie urządzeń i udostępnia w TapHome przełącznik Permit Join oraz licznik Devices Found.

## Obsługiwany sprzęt bramy

Następujące koordynatory Zigbee są kompatybilne z Zigbee2Tasmota:

| Brama | Procesor | Radio Zigbee | Łączność | Uwagi |
|-------|----------|-------------|----------|-------|
| **eWeLink ZB-GW03** (zalecany) | ESP32 | EFR32 (EZSP) | Ethernet + Zigbee | Dostępny z preinstalowanym firmware Tasmota |
| **Sonoff ZBBridge** | ESP8266 | EFR32 (EZSP) | WiFi + Zigbee | Wymaga ręcznego flashowania firmware Tasmota |
| **Sonoff ZBBridge Pro** | ESP32 | CC2652P (ZNP) | WiFi + Zigbee | Do 128 urządzeń, wymaga flashowania |

Inny kompatybilny sprzęt to Tube's Ethernet Zigbee Gateway (na bazie EFR32) oraz własne zestawy DIY z ESP32 i modułami CC2530/CC2652.

> [!TIP]
> eWeLink ZB-GW03 jest zalecany dzięki połączeniu Ethernet (bardziej niezawodne niż WiFi) i dostępności z preinstalowanym firmware Tasmota — bez konieczności flashowania.

## Konfiguracja

### Konfiguracja bramy Tasmota

1. Zainstaluj [firmware Tasmota](https://tasmota.github.io/docs/Getting-Started/) na koordynatorze Zigbee (pomiń, jeśli preinstalowany)
2. Podłącz bramę do sieci przez interfejs webowy Tasmota
3. Przejdź do **Configuration** → **Configure MQTT** i ustaw:
   - **Host:** adres IP brokera MQTT (np. `192.168.1.10`)
   - **Port:** `1883`
4. Zapisz nazwę **Topic** (np. `tasmota_XXXXX`) — to parametr **Gateway name** potrzebny podczas importu szablonu

> [!TIP]
> TapHome ma wbudowany broker MQTT — aktywuj go w **Settings** → **Hardware** → **MQTT Broker**. Nie jest potrzebne dodatkowe oprogramowanie brokera.

### Parametry importu szablonu

Szablon bramy wymaga 3 parametrów:

| Parametr | Opis | Przykład |
|----------|------|---------|
| **MQTT Broker IP Address** | Adres IP brokera MQTT | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (domyślny 1883) | `1883` |
| **Gateway name** | Topic MQTT Tasmota z Configuration → MQTT → Topic | `tasmota_XXXXX` |

Po zaimportowaniu moduł subskrybuje `tele/{GWname}/#` i pojawiają się dwa urządzenia: **Permit Join** i **Devices Found**.

## Funkcje urządzenia

### Parowanie urządzeń Zigbee

Przełącznik **Permit Join** steruje trybem parowania bramy:

1. Włącz **Permit Join** w TapHome — powoduje to wysłanie polecenia `ZbPermitJoin`, które otwiera 60-sekundowe okno parowania
2. Uruchom procedurę parowania na urządzeniu Zigbee (zwykle przytrzymaj przycisk reset przez 5 sekund, aż LED zacznie migać)
3. Obserwuj licznik **Devices Found** — zwiększa się, gdy nowe urządzenie pomyślnie dołączy do sieci
4. Sprawdź atrybut serwisowy **New devices** na bramie, aby zobaczyć ID sparowanego urządzenia (np. `0x1234`), producenta i model
5. Tryb parowania deaktywuje się automatycznie po upłynięciu limitu czasu

Device ID (krótki adres, np. `0x1234`) wyświetlany w atrybutach serwisowych jest potrzebny podczas importu szablonów specyficznych dla urządzenia.

### Monitorowanie urządzeń

Moduł bramy co godzinę odpytuje `ZbInfo` w celu odświeżenia informacji o wszystkich sparowanych urządzeniach Zigbee. Atrybut serwisowy **New devices** pokazuje szczegóły ostatnio wykrytych urządzeń, w tym ich krótki adres Zigbee, producenta i identyfikator modelu.

### Dodatkowe funkcje

Brama Tasmota Zigbee obsługuje również wyświetlanie listy wszystkich sparowanych urządzeń (`ZbStatus`), przeglądanie konfiguracji sieci (`ZbConfig` — PanID, kanał, klucze szyfrowania), nazywanie urządzeń, zarządzanie grupami oraz bezpośrednie wiązanie urządzeń między sobą. Te funkcje diagnostyczne i zarządzania mogą być dodane w przyszłej aktualizacji szablonu.

## Obsługiwane szablony urządzeń Zigbee

Po sparowaniu urządzenia zaimportuj odpowiedni szablon specyficzny dla danego urządzenia. Każdy szablon urządzenia wymaga 4 parametrów: MQTT Broker IP, Port, Gateway name (taki sam jak bramy) oraz Device ID z parowania.

Dostępne szablony urządzeń Zigbee2Tasmota:

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

## Rozwiązywanie problemów

### Brama nie łączy się z brokerem MQTT

1. Sprawdź, czy brama Tasmota jest podłączona do sieci (sprawdź interfejs webowy Tasmota)
2. Potwierdź, że adres IP i port brokera MQTT są zgodne między konfiguracją MQTT w Tasmota a parametrami importu szablonu w TapHome
3. Sprawdź, czy broker MQTT działa i jest dostępny na podanym porcie

### Permit Join nie znajduje urządzeń

1. Upewnij się, że urządzenie Zigbee jest w trybie parowania — większość urządzeń wymaga przytrzymania przycisku przez 5+ sekund
2. Sprawdź, czy przełącznik Permit Join jest włączony w TapHome przed rozpoczęciem procedury parowania urządzenia
3. Podczas pierwszego parowania umieść urządzenie Zigbee bliżej bramy (w odległości 2–3 metrów)
4. Niektóre urządzenia wymagają przywrócenia ustawień fabrycznych przed sparowaniem z nowym koordynatorem

### Device ID się nie wyświetla

1. Po udanym sparowaniu sprawdź atrybut serwisowy **New devices** na module bramy, aby zobaczyć Device ID, producenta i model
2. Jeśli atrybut serwisowy jest pusty, spróbuj przełączyć Permit Join na OFF i ponownie na ON, a następnie sparuj urządzenie ponownie
3. Device ID można również znaleźć w konsoli Tasmota (polecenie `ZbStatus`) przez interfejs webowy bramy

> [!WARNING]
> Kanał radiowy Zigbee nie powinien nakładać się na kanał Wi-Fi. Dla najlepszych rezultatów użyj kanałów Zigbee 15, 20 lub 25, które mają minimalne zakłócenia Wi-Fi. Aktualny kanał sprawdzisz poleceniem `ZbConfig` w konsoli Tasmota.

## Dostępne urządzenia 2

Te urządzenia pojawią się w TapHome po imporcie.

Zigbee2Tasmota Gateway Moduł

Atrybuty serwisowe

|                 |                                                                                                |
|-----------------|------------------------------------------------------------------------------------------------|
| Nowe urządzenia | Niedawno wykryte urządzenia Zigbee — wyświetla ID urządzenia, producenta i model po sparowaniu |

Zmienne niestandardowe

|                   |                                                                                      |
|-------------------|--------------------------------------------------------------------------------------|
| `GWname` (string) | Nazwa topicu MQTT Tasmota bramy Zigbee (znajduje się w Configuration → MQTT → Topic) |

Odczyt (moduł)

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

Zapis (moduł)

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

Nasłuchiwanie

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

Atrybuty serwisowe

New devices

```taphome
new
```

Znalezione urządzenia Zmienna Tylko do odczytu

Licznik pomyślnie sparowanych urządzeń Zigbee — zwiększa się podczas Permit Join, gdy nowe urządzenie dołączy

numeric

Atrybuty serwisowe

|                 |                                                                                    |
|-----------------|------------------------------------------------------------------------------------|
| Nowe urządzenia | Szczegóły sparowanego urządzenia — ID, producent i model wykrytych urządzeń Zigbee |

Odczyt

```taphome
Va := count
```

Atrybuty serwisowe

New devices

```taphome
new
```

Permit Join Przełącznik Odczyt i zapis

Przełącznik trybu parowania Zigbee — włącza 60-sekundowe okno na dołączenie nowych urządzeń do sieci

boolean

Wartości / Stany: ON · OFF

Zapis stanu przełącznika

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

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

Nasłuchiwanie

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

**Połączenie:** Packet Parser → MQTT

Możliwe ulepszenia (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

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji                                         | Domyślnie       |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker Adres IP                                        | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` |

## Źródła

- 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

## Powiązana dokumentacja

- [MQTT Integration](https://taphome.com/pl/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/)
- [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/)
- [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/pl/docs/integration/packet-parser/mqtt-broker/)
- [Skrypty listener](https://taphome.com/pl/docs/script/listener-scripts/)