--- title: "Moes Smart Switch" description: "Moes Zigbee Wandschalter (ZTS-EU-Serie) mit TapHome über MQTT via Zigbee2Tasmota-Gateway integriert. Glas-Touchpanel mit Ein/Aus-Steuerung." url: "https://taphome.com/de/compatibility/zigbee2tasmota-moes-smart-switch/" language: de lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","zigbee","smart-plug","tasmota","switch","wall-switch"] questions: ["Wie integriere ich einen Moes Zigbee-Schalter mit TapHome?","Wie steuere ich einen Moes Wandschalter über TapHome?","Wie koppele ich einen Moes Smart Switch mit Zigbee2Tasmota?","Kann TapHome Tuya Zigbee-Wandschalter steuern?","Was ist der Unterschied zwischen Moes und Aqara Zigbee-Schaltern?","Wie richte ich einen Moes Glas-Touchschalter in TapHome ein?"] --- # Moes Smart Switch Kommunikation: Packet Parser → MQTT - [Moes ZTS-EU — Zigbee2MQTT](https://www.zigbee2mqtt.io/devices/ZTS-EU_1gang.html) - [Moes ZTS-EU1-W — Blakadder Zigbee-Datenbank](https://zigbee.blakadder.com/Moes_ZTS-EU1-W.html) > 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 > [!IMPORTANT] > Dieses Gerät kommuniziert über **Zigbee** durch ein Tasmota-Gateway. Stellen Sie sicher, dass die Vorlage [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/zigbee2tasmota-gateway/) importiert und Ihr Gerät gekoppelt ist. Der Moes Smart Switch (ZTS-EU-Serie) ist ein Zigbee-Wandschalter mit Glas-Touchpanel, konzipiert für die Installation im EU-Stil. TapHome steuert ihn über MQTT durch das Zigbee2Tasmota-Gateway und ermöglicht das Ein-/Ausschalten angeschlossener Lasten. Moes gehört zum Tuya-Ökosystem — der Schalter verwendet einen Tuya TS0601-Chipsatz und ist über moeshouse.com und Aliexpress erhältlich. Die ZTS-EU-Serie gibt es in 1-, 2- und 3-Gang-Varianten; diese Vorlage unterstützt das 1-Gang-Modell. Als netzbetriebenes Gerät fungiert der Schalter als **Zigbee-Router** — er stärkt das Zigbee-Mesh-Netzwerk und erweitert die Reichweite für batteriebetriebene Geräte in der Nähe. ## Konfiguration ### Kopplung des Schalters 1. Stellen Sie sicher, dass das [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/zigbee2tasmota-gateway/) eingerichtet und der **Permit Join**-Schalter in TapHome aktiviert ist 2. **Halten Sie die Touchtaste 10+ Sekunden gedrückt** (oder schalten Sie den physischen Schalter 5-mal schnell um), bis die LED-Anzeige schnell blinkt 3. Der Schalter wechselt in den Kopplungsmodus — die LED blinkt zur Bestätigung 4. Notieren Sie die **Device ID** (z. B. `0x1234`) aus den Serviceattributen des Gateways ### Vorlagen-Importparameter Die Gerätevorlage erfordert 4 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 (gleich wie in der Gateway-Vorlage) | `tasmota_XXXXX` | | **Device ID** | Zigbee-Kurzadresse aus der Kopplung | `0x1234` | Nach dem Import erscheint in TapHome ein Schalter-Gerät für die Ein/Aus-Steuerung. ## Gerätefunktionen ### Schaltersteuerung Die Vorlage erstellt ein Schalter-Gerät, das das Feld `Power` liest und schreibt: - **Lesen:** Das Modul lauscht auf dem Topic `tele/{GWname}/SENSOR` nach `ZbReceived.{ID}.Power`-Nachrichten. Wenn Sie die physische Touchtaste drücken, veröffentlicht der Schalter seinen neuen Zustand. - **Schreiben:** TapHome sendet einen `ZbSend`-Befehl mit `Power: true` (EIN) oder `Power: false` (AUS), um das Relais fernzusteuern. Der Schalter reagiert sowohl auf physische Berührungen als auch auf TapHome-Befehle, und TapHome zeigt immer den aktuellen Zustand an — unabhängig davon, wie der Schalter umgeschaltet wurde. ### Serviceattribute Das Modul stellt diagnostische Informationen über Serviceattribute bereit: - **IEEE Address** — Zigbee-IEEE-Adresse (64-Bit eindeutiger Bezeichner) - **Model ID** — Zigbee-Modellbezeichner (typischerweise `TS0601`) - **Manufacturer** — Zigbee-Herstellerstring - **Endpoints** — aktive Zigbee-Endpunkte - **Config** — Gerätekonfigurationsstring ### Zusätzliche Funktionen Der Moes ZTS-EU unterstützt auch die Steuerung des Anzeige-LED-Modus (aus, folgt Schalterzustand, zeigt Position, eingefroren) und die Konfiguration des Einschaltverhaltens (aus, ein, vorheriger Zustand). Diese Funktionen sind in Zigbee2MQTT verfügbar, werden aber derzeit in der TapHome-Vorlage nicht abgebildet. ## Fehlerbehebung ### Schalter reagiert nicht auf TapHome-Befehle 1. Überprüfen Sie, ob die Device ID in der Vorlage mit der während der Kopplung zugewiesenen Zigbee-Kurzadresse übereinstimmt 2. Stellen Sie sicher, dass der Gateway-Name zwischen der Gateway-Vorlage und dieser Gerätevorlage übereinstimmt 3. Testen Sie die physische Touchtaste — wenn sie das Relais schaltet, TapHome sich aber nicht aktualisiert, könnte ein Problem im Lesepfad (SENSOR-Topic) vorliegen 4. Prüfen Sie die Tasmota-Konsole auf `ZbReceived`-Nachrichten beim Umschalten des Schalters ### Schalterzustand nicht synchron 1. Wenn der Schalter in TapHome einen anderen Zustand als die tatsächliche Relaisposition anzeigt, drücken Sie die physische Taste, um eine Zustandsmeldung auszulösen 2. Die Vorlage fragt den Schalterzustand nicht aktiv ab — sie verlässt sich auf die Änderungsmeldungen des Geräts. Wenn der Schalter kurzzeitig die Verbindung verliert, kann der Zustand bis zum nächsten physischen Umschalten veraltet sein ### Verhalten der Anzeige-LED Die Anzeige-LED auf dem Schalterpanel wird von der Tuya-Firmware gesteuert. Standardmäßig kann sie dem Schalterzustand folgen oder ausgeschaltet bleiben. Die TapHome-Vorlage steuert die Anzeige nicht — verwenden Sie Zigbee2MQTT oder die Tuya-App, um den Anzeigemodus zu ändern. ## Installation in TapHome ### Voraussetzungen - Zigbee-Gateway mit Tasmota-Firmware (z. B. Sonoff ZBBridge, eWeLink ZB-GW03) - MQTT-Broker in Ihrem lokalen Netzwerk (integrierter TapHome-Broker oder externer) - TapHome CCU im selben Netzwerk > [!TIP] > TapHome hat einen integrierten MQTT-Broker — aktivieren Sie ihn unter **Einstellungen** → **Hardware** → **MQTT Broker**. Keine zusätzliche Software erforderlich. ### Schritt 1 — Tasmota Zigbee-Gateway einrichten 1. Flashen Sie die [Tasmota-Firmware](https://tasmota.github.io/docs/Getting-Started/) auf einen unterstützten Zigbee-Koordinator (z. B. Sonoff ZBBridge, eWeLink ZB-GW03) 2. Verbinden Sie das Gateway über die Tasmota-Weboberfläche mit Ihrem Wi-Fi-Netzwerk 3. Navigieren Sie zu **Configuration** → **Configure MQTT** und konfigurieren Sie: - **Host:** beim integrierten Broker die IP-Adresse des TapHome Core (mit einer IP-Reservierung im Router → [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)), sonst die IP-Adresse Ihres Brokers (z. B. `192.168.1.10`) - **Port:** `1883` - **Topic:** notieren Sie den Topic-Namen (z. B. `tasmota_XXXXX`) — Sie benötigen ihn beim Vorlagenimport Ausführliche Anleitungen finden Sie in der [Tasmota Zigbee-Dokumentation](https://tasmota.github.io/docs/Zigbee/). ### Schritt 2 — Gateway-Vorlage in TapHome importieren 1. Laden Sie die Gateway-Vorlage von der Kompatibilitätsseite [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/zigbee2tasmota-gateway/) herunter 2. In TapHome gehen Sie zu **Einstellungen** → **Hardware** → **Packet Parser** → **Import** 3. Importieren Sie die Vorlage mit diesen Parametern: - **MQTT Broker IP Address:** `127.0.0.1` für den integrierten TapHome-Broker, sonst die IP-Adresse Ihres Brokers (z. B. `192.168.1.10`) - **MQTT Broker Port:** `1883` - **Gateway name:** Tasmota-MQTT-Topic aus Schritt 1 (z. B. `tasmota_XXXXX`) Nach dem Import sehen Sie zwei Geräte: **Permit Join** (Schalter) und **Devices Found** (Zähler). ### Schritt 3 — Zigbee-Gerät koppeln 1. In TapHome schalten Sie den **Permit Join**-Schalter ein — es öffnet sich ein 60-Sekunden-Kopplungsfenster 2. Starten Sie am Zigbee-Gerät den Kopplungsvorgang (typischerweise 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 beitritt 4. Überprüfen Sie die **Service Attributes** des Gateways, um die ID des neuen Geräts (z. B. `0x1234`), den Hersteller und das Modell zu sehen 5. Der Kopplungsmodus wird nach Ablauf des Zeitlimits automatisch deaktiviert ### Schritt 4 — Geräte-Vorlage importieren 1. Laden Sie die gerätespezifische Vorlage von der entsprechenden Kompatibilitätsseite herunter 2. Importieren Sie die Vorlage mit diesen Parametern: - **MQTT Broker IP Address:** dieselbe wie für das Gateway - **MQTT Broker Port:** `1883` - **Gateway name:** derselbe Tasmota-MQTT-Topic wie oben - **Device ID:** die Kurzadresse aus der Kopplung (z. B. `0x1234`) ## Verfügbare Geräte 1 Diese Geräte erscheinen nach dem Import in TapHome. Moes Smart Switch Modul Serviceattribute | | | |--------------|-----------------------------------------------------| | IEEE Address | Zigbee-IEEE-Adresse (64-Bit eindeutiger Bezeichner) | | Model ID | Vom Gerät gemeldeter Zigbee-Modellbezeichner | | Manufacturer | Vom Gerät gemeldeter Zigbee-Herstellerstring | | Endpoints | Aktive Zigbee-Endpunkte auf dem Gerät | | Config | Zigbee-Gerätekonfigurationsstring | Benutzerdefinierte Variablen `GWname` (string) Tasmota MQTT Topic-Name des Zigbee-Gateways (unter Configuration → MQTT → Topic) `ID` (string) Zigbee-Kurzadresse des Moes Smart Switch (beim Pairing zugewiesen) After pairing the device via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 var ZbReceived := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbReceived." + ID, true); var val := PARSEJSON(ZbReceived, ".LinkQuality", true); if(!ISNULL(val), LinkQuality := val); var deviceInfo := PARSEJSON(TOSTRING(RECEIVEDMSG.Payload), "ZbInfo." + ID, true); if !ISNULL(deviceInfo) COMPLETESERVICEATTRIBUTE("IEEEAddr", PARSEJSON(deviceInfo, "IEEEAddr")); COMPLETESERVICEATTRIBUTE("ModelId", PARSEJSON(deviceInfo, "ModelId")); COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer")); COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints")); COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config")); end end ``` Serviceattribute IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Schalter Schalter Lesen und Schreiben Ein/Aus-Relais gesteuert über ZbSend Power-Befehl boolean Werte / Zustände: ON · OFF Schaltzustand schreiben ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", "{\"device\":\" " + ID + "\",\"send\":{\"Power\":" + St + "}}") ``` Listener ```taphome VAR json := tostring(RECEIVEDMSG.Payload); VAR topic := RECEIVEDMSG.Topic; if INDEXOF(topic, "SENSOR") > 0 var val := PARSEJSON(json, "ZbReceived." + ID + ".Power", true); if(!ISNULL(val), St := val); end ``` **Verbindung:** Packet Parser → MQTT Mögliche Verbesserungen (2) - Indicator Light — Controls LED indicator mode: off, switch (follows switch state), position (shows position), freeze - Power On Behavior — Controls state after power outage: off, on, previous ## 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` | | Device ID | `0xFFFF` | ## Quellen - Tasmota Zigbee Documentation [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) - Zigbee Compatible Devices Database - Moes ZTS-EU1-W — Blakadder Zigbee Database [zigbee.blakadder.com](https://zigbee.blakadder.com/Moes_ZTS-EU1-W.html) 2026-03-29 - Moes ZTS-EU\_1gang — Zigbee2MQTT Device Page [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/ZTS-EU_1gang.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/)