TapHome

Aqara Single Switch Module T1 (With Neutral)

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

Erfordert externes Gateway

tasmota zigbee2tasmota-gateway — Produktseite

Aqara Single Switch Module T1 (With Neutral)

Dieses Gerät kommuniziert über Zigbee durch ein Tasmota-Gateway. Stellen Sie sicher, dass Sie die Vorlage Zigbee2Tasmota Gateway importiert und Ihr Gerät gekoppelt haben, bevor Sie fortfahren.

Das Aqara Single Switch Module T1 (With Neutral) ist ein kompaktes Zigbee-3.0-Relaismodul (Modell SSM-U01) für die Unterputzinstallation hinter einem Schalter. Es wandelt einen herkömmlichen Wandschalter in einen intelligenten Schalter um, wobei die originale Schalterblende erhalten bleibt. TapHome steuert das Relais über MQTT durch ein Zigbee2Tasmota-Gateway mit ZbSend-Befehlen — ohne Cloud-Verbindung.

Das Modul erfordert einen Neutralleiter und unterstützt Lasten von 3 W bis 2500 W (10 A ohmsche Last) bei 100 – 250 VAC. Die kompakten Abmessungen (42,9 x 40 x 19,9 mm) ermöglichen die Installation in den meisten Unterputzdosen.

Als netzgespeistes Gerät fungiert das Modul als Zigbee-Router — es stärkt das Zigbee-Mesh-Netzwerk und erweitert die Reichweite für batteriebetriebene Sensoren in der Nähe.

Konfiguration

Koppeln des Moduls
  1. Stellen Sie sicher, dass das Zigbee2Tasmota Gateway eingerichtet ist und der Schalter Permit Join in TapHome aktiviert ist
  2. Halten Sie die Taste am Modul gedrückt, bis die blaue LED schnell blinkt, und lassen Sie dann los
  3. Warten Sie, bis sich der Zähler Devices Found erhöht — die Device ID des Moduls (z. B. 0x1234) erscheint in den Service-Attributen des Gateways
  4. Importieren Sie die Gerätevorlage mit der Device ID aus der Kopplung
Parameter für den Vorlagenimport

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 (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee-Kurzadresse aus der Kopplung0x1234

Nach dem Import erscheint in TapHome ein einzelnes Schaltergerät für die Ein/Aus-Steuerung.

Verdrahtung

Das Modul erfordert einen Neutralleiteranschluss mit drei Klemmen:

KlemmeAnschluss
LPhasenleiter-Eingang (Phase)
NNeutralleiter
L1Lastausgang (Leuchte oder Gerät)

Dieses Modul erfordert einen Neutralleiter. Es kann nicht in Schalterdosen installiert werden, die nur Phase und geschaltete Phase führen. Die maximale Last beträgt 10 A / 2500 W für ohmsche Lasten, die Mindestlast 3 W. Die Installation muss von einem qualifizierten Elektriker durchgeführt werden.

Gerätefunktionen

Schaltersteuerung

Die Vorlage erstellt ein einzelnes Schaltergerät, das das Feld Power liest und schreibt:

  • Lesen: Das Modul lauscht auf dem Topic tele/{GWname}/SENSOR auf ZbReceived.{ID}.Power-Nachrichten. Wenn die physische Taste gedrückt oder der Relaiszustand geändert wird, veröffentlicht das Modul seinen neuen Zustand.
  • Schreiben: TapHome sendet einen ZbSend-Befehl an cmnd/{GWname}/ZbSend mit Power: true (EIN) oder Power: false (AUS) zur Fernsteuerung des Relais.

Der Schalter reagiert sowohl auf physische Tastendrücke als auch auf TapHome-Befehle, und TapHome zeigt immer den aktuellen Relaiszustand an — unabhängig davon, wie geschaltet wurde.

Service-Attribute

Das Modul stellt diagnostische Zigbee-Metadaten bereit, die über ZbInfo-Polling abgerufen werden:

AttributBeschreibung
IEEEAddrEinzigartiger 64-Bit-Hardware-Identifikator
ModelIdZigbee-Modell-ID (lumi.switch.n0agl1)
ManufacturerVom Gerät gemeldeter Hersteller-String
EndpointsAktive Zigbee-Endpunkte
ConfigZigbee-Gerätekonfiguration
Weitere Funktionen

Das Aqara SSM-U01 unterstützt außerdem Echtzeit-Leistungsüberwachung (Watt), kumulative Energieverbrauchserfassung, interne Gerätetemperaturmeldung, entkoppelten Modus (Taste kann Szenen auslösen, ohne das Relais zu schalten) und Überlast-/Überhitzungsschutz. Diese Funktionen sind in der Hardware verfügbar, aber derzeit nicht in der TapHome-Vorlage abgebildet — sie können in einem zukünftigen Vorlagen-Update hinzugefügt werden.

Fehlerbehebung

Schalter reagiert nicht auf TapHome-Befehle
  1. Überprüfen Sie, ob die Device ID in der Vorlage mit der beim Koppeln zugewiesenen Zigbee-Kurzadresse übereinstimmt (z. B. 0xC0B4)
  2. Prüfen Sie, ob der Gateway name zwischen der Gateway-Vorlage und dieser Gerätevorlage übereinstimmt
  3. Testen Sie die physische Taste am Modul — wenn sie das Relais schaltet, TapHome sich aber nicht aktualisiert, liegt das Problem möglicherweise im Lesepfad (Topic tele/{GWname}/SENSOR)
  4. Verwenden Sie einen MQTT-Client (z. B. MQTT Explorer), um das Topic tele/{GWname}/SENSOR zu abonnieren und zu überprüfen, ob das Modul beim Schalten ZbReceived-Nachrichten mit einem Power-Feld veröffentlicht
Schalterzustand nicht synchron
  1. Wenn TapHome einen anderen Zustand als das tatsächliche Relais anzeigt, drücken Sie die physische Taste, um eine Zustandsmeldung auszulösen
  2. Die Vorlage pollt den Schalterzustand nicht aktiv — sie verlässt sich auf die Zustandsmeldungen des Geräts. Wenn das Modul kurzzeitig die Zigbee-Verbindung verliert, kann der Zustand veraltet sein, bis der nächste physische Schaltvorgang oder Befehl erfolgt
Modul koppelt nicht
  1. Stellen Sie sicher, dass das Modul mit Strom versorgt wird (Neutralleiter und Phasenleiter müssen beide angeschlossen sein)
  2. Halten Sie die Taste gedrückt, bis die blaue LED schnell blinkt — ein kurzer Tastendruck startet den Kopplungsmodus nicht
  3. Bringen Sie das Gateway beim ersten Koppeln näher, wenn das Modul weit vom Koordinator entfernt ist
  4. Wenn das Modul zuvor mit einem anderen Zigbee-Koordinator gekoppelt war, muss es möglicherweise auf Werkseinstellungen zurückgesetzt werden — halten Sie die Taste 10+ Sekunden gedrückt, bis die LED dreimal blinkt

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

Aqara Single Switch Module T1 (With Neutral) Modul
Serviceattribute
IEEEAddrZigbee-IEEE-Adresse — einzigartiger 64-Bit-Hardware-Identifikator
ModelId
Manufacturer
Endpoints
Config
Benutzerdefinierte Variablen
GWname (string)Tasmota MQTT-Topicname des Zigbee-Gateways (unter Configuration → MQTT → Topic)
ID (string) = 0xC0B4Zigbee-Kurzadresse des Aqara Single Switch Module T1 (zugewiesen bei der Kopplung)
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

Aqara - Single Switch Module T1 (With Neutral)

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 — schaltet den L1-Lastausgang

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 (5)
  • Power Monitoring — Real-time power measurement in watts — hardware supports it but not mapped in XML template
  • Energy Monitoring — Cumulative energy consumption tracking — available in hardware but not mapped in XML template
  • Device Temperature — Internal temperature sensor — hardware supports it but not mapped in XML template
  • Decoupled Mode — Button can be decoupled from relay for scene triggering — not mapped in XML template
  • Overload / Overheating Protection — Built-in safety features — max 10A / 2500W resistive load. Not exposed in template.

Quellen