Zigbee2Tasmota Gateway

Packet Parser → MQTT

Eingereicht von

Zuletzt aktualisiert: 03. 2026

Tasmota Zigbee Dokumentation

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.

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

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

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:

Schalten Sie Permit Join in TapHome ein — dadurch wird ein ZbPermitJoin-Befehl gesendet, der ein 60-Sekunden-Pairing-Fenster öffnet
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)
Beobachten Sie den Devices Found-Zähler — er erhöht sich, wenn ein neues Gerät erfolgreich dem Netzwerk beitritt
Prüfen Sie das Service-Attribut New devices am Gateway, das die ID des gepaarten Geräts (z. B. 0x1234), Hersteller und Modell anzeigt
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:

Fehlerbehebung

Gateway verbindet sich nicht mit dem MQTT-Broker

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

Permit Join findet keine Geräte

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
Vergewissern Sie sich, dass der Permit-Join-Schalter in TapHome eingeschaltet ist, bevor Sie die Pairing-Prozedur des Geräts starten
Positionieren Sie das Zigbee-Gerät während des ersten Pairings näher am Gateway (innerhalb von 2–3 Metern)
Einige Geräte erfordern einen Werksreset, bevor sie mit einem neuen Koordinator gepaart werden können

Device ID wird nicht angezeigt

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

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

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)

Tasmota - Zigbee GW

Lesen (Modul)

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

Schreiben (Modul)

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

Listener

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

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

Permit Join Schalter

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

boolean

Werte / Zustände: ON · OFF

Permit Join

Schaltzustand schreiben

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

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

Listener

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.

Vorlage herunterladen

Quellen

Tasmota Zigbee Documentation
tasmota.github.io 2026-03-29
Zigbee Compatible Devices Database
zigbee.blakadder.com 2026-03-29
Supported Zigbee Gateway Hardware
templates.blakadder.com 2026-03-29