--- title: "Aqara Single Switch Module T1 (With Neutral)" description: "Ein/Aus-Relaissteuerung des Aqara SSM-U01 Zigbee-Schaltmoduls über Tasmota-Gateway. Netzspeisung, Neutralleiter erforderlich, max 10A/2500W. ZbSend Power." url: "https://taphome.com/de/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/" language: de lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"] questions: ["Wie integriere ich das Aqara Single Switch Module T1 mit TapHome?","Wie steuere ich das Aqara SSM-U01 Relais über TapHome?","Wie koppele ich das Aqara-Schaltmodul mit einem Zigbee2Tasmota-Gateway?","Warum reagiert mein Aqara-Schaltmodul nicht auf TapHome-Befehle?","Benötigt das Aqara SSM-U01 einen Neutralleiter?","Wie hoch ist die maximale Last des Aqara SSM-U01 Schaltmoduls?"] --- # Aqara Single Switch Module T1 (With Neutral) Kommunikation: Packet Parser → MQTT - [Aqara Produktseite — SSM-U01](https://www.aqara.com/en/product/single-switch-module-t1-with-neutral/) > 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 Sie > die Vorlage [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/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](https://taphome.com/de/compatibility/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: | 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 (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | **Device ID** | Zigbee-Kurzadresse aus der Kopplung | `0x1234` | 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: | Klemme | Anschluss | |--------|-----------| | **L** | Phasenleiter-Eingang (Phase) | | **N** | Neutralleiter | | **L1** | Lastausgang (Leuchte oder Gerät) | > [!WARNING] > 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: | Attribut | Beschreibung | |----------|--------------| | **IEEEAddr** | Einzigartiger 64-Bit-Hardware-Identifikator | | **ModelId** | Zigbee-Modell-ID (`lumi.switch.n0agl1`) | | **Manufacturer** | Vom Gerät gemeldeter Hersteller-String | | **Endpoints** | Aktive Zigbee-Endpunkte | | **Config** | Zigbee-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 > [!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. Aqara Single Switch Module T1 (With Neutral) Modul Serviceattribute | | | |--------------|-------------------------------------------------------------------| | IEEEAddr | Zigbee-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) = 0xC0B4 Zigbee-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 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 — schaltet den L1-Lastausgang 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 (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. ## 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 - Aqara Product Page — SSM-U01 [www.aqara.com](https://www.aqara.com/en/product/single-switch-module-t1-with-neutral/) 2026-03-29 - Blakadder Device Entry — Aqara SSM-U01 [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_SSM-U01.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/)