TapHome

Moes Smart Switch

Packet Parser → MQTT
Eingereicht von
Zuletzt aktualisiert: 03. 2026

Erfordert externes Gateway

tasmota zigbee2tasmota-gateway — Produktseite

Moes Smart Switch

Dieses Gerät kommuniziert über Zigbee durch ein Tasmota-Gateway. Stellen Sie sicher, dass die Vorlage 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 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:

ParameterBeschreibungBeispiel
MQTT Broker IP AddressIP-Adresse Ihres MQTT-Brokers192.168.1.10
MQTT Broker PortBroker-Port (Standard 1883)1883
Gateway nameTasmota MQTT-Topic (gleich wie in der Gateway-Vorlage)tasmota_XXXXX
Device IDZigbee-Kurzadresse aus der Kopplung0x1234

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

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 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: IP-Adresse Ihres MQTT-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.

Schritt 2 — Gateway-Vorlage in TapHome importieren

  1. Laden Sie die Gateway-Vorlage von der Kompatibilitätsseite 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: 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

Moes Smart Switch Modul
Serviceattribute
IEEE AddressZigbee-IEEE-Adresse (64-Bit eindeutiger Bezeichner)
Model IDVom Gerät gemeldeter Zigbee-Modellbezeichner
ManufacturerVom Gerät gemeldeter Zigbee-Herstellerstring
EndpointsAktive Zigbee-Endpunkte auf dem Gerät
ConfigZigbee-Gerätekonfigurationsstring
Benutzerdefinierte Variablen
GWname (string)Tasmota MQTT topic name of the Zigbee gateway (found in Configuration → MQTT → Topic)
ID (string)Zigbee short address of the Moes Smart Switch (assigned during pairing)
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

Moes - Smart Switch

Listener
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
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Schalter Schalter

Ein/Aus-Relais gesteuert über ZbSend Power-Befehl

boolean
Werte / Zustände: ON · OFF

Schalter

Schaltzustand schreiben
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Listener
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

Quellen