---
title: "Zigbee2Tasmota Gateway"
description: "Zigbee-Geräte über ein Tasmota-Gateway und den lokalen MQTT-Broker ohne Cloud: Pairing per Permit Join, Geräteerkennung, Basis aller Z2T-Vorlagen."
url: "https://taphome.com/de/compatibility/zigbee2tasmota-gateway/"
language: de
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","zigbee","gateway","tasmota","wifi","ethernet"]
  questions: ["Wie integriert man Zigbee-Geräte mit TapHome über Tasmota?","Welche Hardware benötige ich für ein Zigbee2Tasmota Gateway?","Wie paart man Zigbee-Geräte mit TapHome über Tasmota?","Wie finde ich die Zigbee Device ID nach dem Pairing?","Was ist der Unterschied zwischen eWeLink ZB-GW03 und Sonoff ZBBridge?","Wie richtet man MQTT für das Zigbee2Tasmota Gateway in TapHome ein?"]
---

# Zigbee2Tasmota Gateway

Kommunikation: Packet Parser → MQTT

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

> Netzwerkadresse
> 
> Beim in TapHome integrierten MQTT-Broker geben Sie in TapHome `127.0.0.1` als Broker-Adresse ein. Im Gerät geben Sie die IP-Adresse des TapHome Core ein und richten für den Core eine IP-Reservierung im Router ein.
> 
> [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)

## Integrationsanleitung

Zigbee2Tasmota (Z2T) ist eine leichtgewichtige Zigbee-to-MQTT-Bridge, die auf ESP8266/ESP32-Mikrocontrollern mit integriertem Zigbee-Funkmodul läuft. Sie ermöglicht TapHome die Kommunikation mit Zigbee-Geräten über Ihren lokalen MQTT-Broker — ohne Cloud-Verbindung.

Diese Gateway-Vorlage ist die **Voraussetzung für alle Zigbee2Tasmota-Gerätevorlagen**. Sie muss zuerst importiert werden, bevor Zigbee-Gerätevorlagen hinzugefügt werden können. Das Gateway verwaltet das Geräte-Pairing und stellt in TapHome einen Permit-Join-Schalter und einen Devices-Found-Zähler bereit.

## Unterstützte Gateway-Hardware

Die folgenden Zigbee-Koordinatoren sind mit Zigbee2Tasmota kompatibel:

| Gateway | Prozessor | Zigbee-Funk | Konnektivität | Hinweise |
|---------|-----------|-------------|---------------|----------|
| **eWeLink ZB-GW03** (empfohlen) | ESP32 | EFR32 (EZSP) | Ethernet + Zigbee | Mit vorinstallierter Tasmota-Firmware erhältlich |
| **Sonoff ZBBridge** | ESP8266 | EFR32 (EZSP) | WiFi + Zigbee | Erfordert manuelles Flashen der Tasmota-Firmware |
| **Sonoff ZBBridge Pro** | ESP32 | CC2652P (ZNP) | WiFi + Zigbee | Bis zu 128 Geräte, Flashen erforderlich |

Weitere kompatible Hardware umfasst das Tube's Ethernet Zigbee Gateway (EFR32-basiert) und eigene DIY-Aufbauten mit ESP32 und CC2530/CC2652-Modulen.

> [!TIP]
> Das eWeLink ZB-GW03 wird empfohlen — dank Ethernet-Anbindung (zuverlässiger als WiFi) und Verfügbarkeit mit vorinstallierter Tasmota-Firmware ist kein Flashen nötig.

## Konfiguration

### Einrichtung des Tasmota-Gateways

1. Flashen Sie die [Tasmota-Firmware](https://tasmota.github.io/docs/Getting-Started/) auf Ihren Zigbee-Koordinator (überspringen, falls vorinstalliert)
2. Verbinden Sie das Gateway über die Tasmota-Weboberfläche mit Ihrem Netzwerk
3. Navigieren Sie zu **Configuration** → **Configure MQTT** und stellen Sie ein:
   - **Host:** IP-Adresse Ihres MQTT-Brokers (z. B. `192.168.1.10`)
   - **Port:** `1883`
4. Notieren Sie den **Topic**-Namen (z. B. `tasmota_XXXXX`) — dies ist der Parameter **Gateway name**, der beim Vorlagenimport benötigt wird

> [!TIP]
> TapHome verfügt über einen integrierten MQTT-Broker — aktivieren Sie ihn unter **Settings** → **Hardware** → **MQTT Broker**. Zusätzliche Broker-Software ist nicht erforderlich.

### Parameter für den Vorlagenimport

Die Gateway-Vorlage benötigt 3 Parameter:

| Parameter | Beschreibung | Beispiel |
|-----------|--------------|---------|
| **MQTT Broker IP Address** | IP-Adresse Ihres MQTT-Brokers | `192.168.1.10` |
| **MQTT Broker Port** | Broker-Port (Standard 1883) | `1883` |
| **Gateway name** | Tasmota MQTT Topic aus Configuration → MQTT → Topic | `tasmota_XXXXX` |

Nach dem Import abonniert das Modul `tele/{GWname}/#` und zwei Geräte erscheinen: **Permit Join** und **Devices Found**.

## Gerätefunktionen

### Zigbee-Geräte pairen

Der Schalter **Permit Join** steuert den Pairing-Modus des Gateways:

1. Schalten Sie **Permit Join** in TapHome ein — dadurch wird ein `ZbPermitJoin`-Befehl gesendet, der ein 60-Sekunden-Pairing-Fenster öffnet
2. Starten Sie die Pairing-Prozedur an Ihrem Zigbee-Gerät (in der Regel die Reset-Taste 5 Sekunden gedrückt halten, bis die LED blinkt)
3. Beobachten Sie den **Devices Found**-Zähler — er erhöht sich, wenn ein neues Gerät erfolgreich dem Netzwerk beitritt
4. Prüfen Sie das Service-Attribut **New devices** am Gateway, das die ID des gepaarten Geräts (z. B. `0x1234`), Hersteller und Modell anzeigt
5. Der Pairing-Modus deaktiviert sich nach Ablauf des Zeitlimits automatisch

Die Device ID (Kurzadresse wie `0x1234`), die in den Service-Attributen angezeigt wird, wird beim Import gerätespezifischer Vorlagen benötigt.

### Geräteüberwachung

Das Gateway-Modul fragt stündlich `ZbInfo` ab, um die Informationen zu allen gepaarten Zigbee-Geräten zu aktualisieren. Das Service-Attribut **New devices** zeigt Details kürzlich entdeckter Geräte einschließlich ihrer kurzen Zigbee-Adresse, des Herstellers und der Modellkennung.

### Zusätzliche Funktionen

Das Tasmota Zigbee Gateway unterstützt außerdem das Auflisten aller gepaarten Geräte (`ZbStatus`), das Anzeigen der Netzwerkkonfiguration (`ZbConfig` — PanID, Kanal, Verschlüsselungsschlüssel), Gerätebenennungen, Gruppenverwaltung und direkte Gerät-zu-Gerät-Bindungen. Diese Diagnose- und Verwaltungsfunktionen können in einem zukünftigen Vorlagen-Update ergänzt werden.

## Unterstützte Zigbee-Gerätevorlagen

Nach dem Pairing eines Geräts importieren Sie die entsprechende gerätespezifische Vorlage. Jede Gerätevorlage benötigt 4 Parameter: MQTT Broker IP, Port, Gateway name (identisch mit dem Gateway) und die Device ID aus dem Pairing.

Verfügbare Zigbee2Tasmota-Gerätevorlagen:

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

## Fehlerbehebung

### Gateway verbindet sich nicht mit dem MQTT-Broker

1. Überprüfen Sie, ob das Tasmota-Gateway mit dem Netzwerk verbunden ist (Tasmota-Weboberfläche prüfen)
2. Stellen Sie sicher, dass IP-Adresse und Port des MQTT-Brokers in der Tasmota-MQTT-Konfiguration und den TapHome-Importparametern übereinstimmen
3. Prüfen Sie, ob der MQTT-Broker läuft und auf dem angegebenen Port erreichbar ist

### Permit Join findet keine Geräte

1. Stellen Sie sicher, dass das Zigbee-Gerät im Pairing-Modus ist — die meisten Geräte erfordern das Halten einer Taste für 5+ Sekunden
2. Vergewissern Sie sich, dass der Permit-Join-Schalter in TapHome eingeschaltet ist, bevor Sie die Pairing-Prozedur des Geräts starten
3. Positionieren Sie das Zigbee-Gerät während des ersten Pairings näher am Gateway (innerhalb von 2–3 Metern)
4. Einige Geräte erfordern einen Werksreset, bevor sie mit einem neuen Koordinator gepaart werden können

### Device ID wird nicht angezeigt

1. Prüfen Sie nach erfolgreichem Pairing das Service-Attribut **New devices** am Gateway-Modul für Device ID, Hersteller und Modell
2. Falls das Service-Attribut leer ist, schalten Sie Permit Join auf OFF und wieder auf ON und pairen Sie das Gerät erneut
3. Die Device ID kann auch über die Tasmota-Konsole (Befehl `ZbStatus`) in der Gateway-Weboberfläche gefunden werden

> [!WARNING]
> Der Zigbee-Funkkanal sollte sich nicht mit Ihrem Wi-Fi-Kanal überschneiden. Für beste Ergebnisse verwenden Sie die Zigbee-Kanäle 15, 20 oder 25, die minimale Wi-Fi-Interferenz aufweisen. Den aktuellen Kanal können Sie mit dem Befehl `ZbConfig` in der Tasmota-Konsole prüfen.

## Verfügbare Geräte 2

Diese Geräte erscheinen nach dem Import in TapHome.

Zigbee2Tasmota Gateway Modul

Serviceattribute

|             |                                                                                            |
|-------------|--------------------------------------------------------------------------------------------|
| Neue Geräte | Kürzlich entdeckte Zigbee-Geräte — zeigt Geräte-ID, Hersteller und Modell nach dem Pairing |

Benutzerdefinierte Variablen

|                   |                                                                                            |
|-------------------|--------------------------------------------------------------------------------------------|
| `GWname` (string) | Tasmota MQTT-Topic-Name des Zigbee-Gateways (zu finden unter Configuration → MQTT → Topic) |

Lesen (Modul)

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

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

Serviceattribute

New devices

```taphome
new
```

Gefundene Geräte Variable Nur lesen

Zähler erfolgreich gepairter Zigbee-Geräte — erhöht sich während Permit Join beim Beitritt eines neuen Geräts

numeric

Serviceattribute

|             |                                                                                       |
|-------------|---------------------------------------------------------------------------------------|
| Neue Geräte | Details des gepaarten Geräts — ID, Hersteller und Modell der entdeckten Zigbee-Geräte |

Lesen

```taphome
Va := count
```

Serviceattribute

New devices

```taphome
new
```

Permit Join Schalter Lesen und Schreiben

Zigbee-Pairing-Modus-Schalter — aktiviert ein 60-Sekunden-Fenster für den Netzwerkbeitritt neuer Geräte

boolean

Werte / Zustände: ON · OFF

Schaltzustand schreiben

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

**Verbindung:** Packet Parser → MQTT

Mögliche Verbesserungen (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.

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

| In der App abgefragt                                        | Standard        |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP-Adresse                                      | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` |

## Quellen

- 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

## Verwandte Dokumentation

- [MQTT Integration](https://taphome.com/de/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/)
- [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/)
- [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)
- [MQTT-Broker](https://taphome.com/de/docs/integration/packet-parser/mqtt-broker/)
- [Listener-Skripte](https://taphome.com/de/docs/script/listener-scripts/)