--- title: "Aqara Single Switch Module T1 (With Neutral)" description: "Be/ki relévezérlés az Aqara SSM-U01 Zigbee kapcsolómodulhoz Tasmota gatewayen át. Hálózati tápellátás, nullavezeték szükséges, max 10A/2500W." url: "https://taphome.com/hu/compatibility/zigbee2tasmota-aqara-single-switch-module-t1-with-neutral/" language: hu lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","smart-plug","zigbee","zigbee2tasmota","switch","relay","mains-powered"] questions: ["Hogyan integráljam az Aqara Single Switch Module T1-et a TapHome-mal?","Hogyan vezéreljem az Aqara SSM-U01 relét a TapHome-on keresztül?","Hogyan párosítsam az Aqara kapcsolómodult egy Zigbee2Tasmota gatewayhez?","Miért nem reagál az Aqara kapcsolómodulom a TapHome parancsokra?","Szükséges nullavezeték az Aqara SSM-U01-hez?","Mekkora az Aqara SSM-U01 kapcsolómodul maximális terhelése?"] --- # Aqara Single Switch Module T1 (With Neutral) Kommunikáció: Packet Parser → MQTT - [Aqara termékoldal — SSM-U01](https://www.aqara.com/en/product/single-switch-module-t1-with-neutral/) > Hálózati cím > > A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató > [!IMPORTANT] > Ez az eszköz **Zigbee**-n keresztül kommunikál egy Tasmota gatewayen át. Győződj meg róla, hogy a > [Zigbee2Tasmota Gateway](https://taphome.com/hu/compatibility/zigbee2tasmota-gateway/) sablon importálva van, > és az eszköz párosítva van, mielőtt folytatnád. Az Aqara Single Switch Module T1 (With Neutral) egy kompakt Zigbee 3.0 relé modul (SSM-U01 modell), amelyet kapcsoló mögötti telepítésre terveztek. Hagyományos fali kapcsolót alakít okos kapcsolóvá az eredeti kapcsolólap megtartásával. A TapHome MQTT-n keresztül vezérli a relét egy Zigbee2Tasmota gatewayen át `ZbSend` parancsokkal — felhőkapcsolat nélkül. A modul nullavezetéket igényel, és 3 W-tól 2500 W-ig (10 A ohmos terhelés) támogat terheléseket 100 – 250 VAC feszültségen. Kompakt méretei (42,9 x 40 x 19,9 mm) lehetővé teszik a telepítést a legtöbb fali kapcsolódobozba. Hálózatról táplált eszközként a modul **Zigbee routerként** működik — erősíti a Zigbee mesh hálózatot és kiterjeszti a hatótávolságot a közeli elemmel működő szenzorok számára. ## Konfiguráció ### A modul párosítása 1. Győződj meg róla, hogy a [Zigbee2Tasmota Gateway](https://taphome.com/hu/compatibility/zigbee2tasmota-gateway/) be van állítva, és a **Permit Join** kapcsoló BE van kapcsolva a TapHome-ban 2. A modulon **hosszan nyomd meg a gombot, amíg a kék LED gyorsan villogni nem kezd**, majd engedd el 3. Várd meg, amíg a **Devices Found** számláló növekszik — a modul Device ID-je (pl. `0x1234`) megjelenik a gateway szervizattribútumaiban 4. Importáld az eszközsablont a párosításkor kapott Device ID használatával ### Sablonimport paraméterei Az eszközsablon 4 paramétert igényel: | Paraméter | Leírás | Példa | |-----------|--------|-------| | **MQTT Broker IP Address** | Az MQTT broker IP-címe | `192.168.1.10` | | **MQTT Broker Port** | Broker port (alapértelmezett 1883) | `1883` | | **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | **Device ID** | Zigbee rövid cím a párosításból | `0x1234` | Importálás után egyetlen Kapcsoló eszköz jelenik meg a TapHome-ban be/ki vezérléshez. ### Bekötés A modul nullavezetékes csatlakozást igényel három csatlakozóval: | Csatlakozó | Bekötés | |------------|---------| | **L** | Fázisvezeték bemenet | | **N** | Nullavezeték | | **L1** | Terhelés kimenet (lámpa vagy készülék) | > [!WARNING] > Ez a modul **nullavezetéket igényel**. Nem telepíthető olyan kapcsolódobozokba, amelyekben csak fázis- és kapcsolt fázisvezeték van. A maximális terhelés 10 A / 2500 W ohmos terhelésnél, a minimális terhelés 3 W. A telepítést szakképzett villanyszerelőnek kell elvégeznie. ## Eszközképességek ### Kapcsolóvezérlés A sablon egy Kapcsoló eszközt hoz létre, amely a `Power` mezőt olvassa és írja: - **Olvasás:** A modul a `tele/{GWname}/SENSOR` topicon figyeli a `ZbReceived.{ID}.Power` üzeneteket. A fizikai gomb megnyomásakor vagy a reléállapot változásakor a modul közzéteszi az új állapotát. - **Írás:** A TapHome `ZbSend` parancsot küld a `cmnd/{GWname}/ZbSend` topicra `Power: true` (BE) vagy `Power: false` (KI) értékkel a relé távoli vezérléséhez. A kapcsoló reagál a fizikai gombnyomásra és a TapHome parancsokra egyaránt, és a TapHome mindig az aktuális reléállapotot tükrözi — függetlenül attól, hogyan lett átkapcsolva. ### Szervizattribútumok A modul diagnosztikai Zigbee metaadatokat szolgáltat `ZbInfo` lekérdezésen keresztül: | Attribútum | Leírás | |------------|--------| | **IEEEAddr** | Egyedi 64 bites hardverazonosító | | **ModelId** | Zigbee modell ID (`lumi.switch.n0agl1`) | | **Manufacturer** | Az eszköz által jelentett gyártói karakterlánc | | **Endpoints** | Aktív Zigbee végpontok | | **Config** | Zigbee eszközkonfiguráció | ### További képességek Az Aqara SSM-U01 emellett támogatja a valós idejű teljesítményfigyelést (watt), a kumulatív energiafogyasztás nyomon követését, a belső eszközhőmérséklet jelentését, a leválasztott módot (a gomb jeleneteket indíthat a relé kapcsolása nélkül) és a túlterhelés/túlmelegedés elleni védelmet. Ezek a funkciók a hardverben elérhetők, de jelenleg nincsenek leképezve a TapHome sablonban — egy jövőbeli sablonfrissítésben adhatók hozzá. ## Hibaelhárítás ### A kapcsoló nem reagál a TapHome parancsokra 1. Ellenőrizd, hogy a sablonban szereplő Device ID megegyezik-e a párosítás során kapott Zigbee rövid címmel (pl. `0xC0B4`) 2. Ellenőrizd, hogy a **Gateway name** megegyezik-e a gateway sablon és ezen eszközsablon között 3. Teszteld a modul fizikai gombját — ha átkapcsolja a relét, de a TapHome nem frissül, az olvasási útvonalban (`tele/{GWname}/SENSOR` topic) lehet a probléma 4. Használj egy MQTT klienst (pl. MQTT Explorer), iratkozz fel a `tele/{GWname}/SENSOR` topicra, és ellenőrizd, hogy a modul `ZbReceived` üzeneteket publikál-e `Power` mezővel átkapcsoláskor ### Kapcsolóállapot nincs szinkronban 1. Ha a TapHome más állapotot mutat, mint a tényleges relé, nyomd meg a fizikai gombot egy állapotjelentés kiváltásához 2. A sablon nem kérdezi le aktívan a kapcsoló állapotát — az eszköz állapotjelentéseire támaszkodik. Ha a modul rövid időre elveszti a Zigbee-kapcsolatot, az állapot elavulttá válhat a következő fizikai átkapcsolásig vagy parancsig ### A modul nem párosodik 1. Győződj meg róla, hogy a modul kap tápellátást (a nullavezetéknek és a fázisvezetéknek egyaránt csatlakoztatva kell lennie) 2. Hosszan nyomd meg a gombot, amíg a kék LED gyorsan villogni nem kezd — rövid gombnyomás nem indítja el a párosítási módot 3. Az első párosítás során vidd közelebb a gatewayt, ha a modul messze van a koordinátortól 4. Ha a modul korábban másik Zigbee koordinátorral volt párosítva, szükség lehet gyári visszaállításra — tartsd nyomva a gombot 10+ másodpercig, amíg a LED háromszor felvillan ## Telepítés a TapHome-ban ### Előfeltételek - Zigbee átjáró Tasmota firmware-rel (pl. Sonoff ZBBridge, eWeLink ZB-GW03) - MQTT broker a helyi hálózaton (TapHome beépített broker vagy külső) - TapHome CCU ugyanazon a hálózaton > [!TIP] > A TapHome rendelkezik beépített MQTT brokerrel — aktiválja a **Beállítások** → **Hardware** → **MQTT Broker** menüpontban. Nincs szükség további szoftverre. ### 1. lépés — Tasmota Zigbee átjáró beállítása 1. Telepítse a [Tasmota firmware-t](https://tasmota.github.io/docs/Getting-Started/) egy támogatott Zigbee koordinátorra (pl. Sonoff ZBBridge, eWeLink ZB-GW03) 2. Csatlakoztassa az átjárót a Wi-Fi hálózathoz a Tasmota webes felületén 3. Navigáljon a **Configuration** → **Configure MQTT** menüpontra és állítsa be: - **Host:** a beépített brokerhez a TapHome Core IP-címe (IP-foglalással a routerben → [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)), egyébként a broker IP-címe (pl. `192.168.1.10`) - **Port:** `1883` - **Topic:** jegyezze fel a topic nevét (pl. `tasmota_XXXXX`) — szükség lesz rá a sablon importálásakor Részletes útmutatót a [Tasmota Zigbee dokumentációban](https://tasmota.github.io/docs/Zigbee/) talál. ### 2. lépés — Átjáró sablon importálása a TapHome-ba 1. Töltse le az átjáró sablont a [Zigbee2Tasmota Gateway](https://taphome.com/hu/compatibility/zigbee2tasmota-gateway/) kompatibilitási oldalról 2. A TapHome-ban lépjen a **Beállítások** → **Hardware** → **Packet Parser** → **Import** menüpontra 3. Importálja a sablont ezekkel a paraméterekkel: - **MQTT Broker IP Address:** a beépített TapHome brokerhez `127.0.0.1`, egyébként a broker IP-címe (pl. `192.168.1.10`) - **MQTT Broker Port:** `1883` - **Gateway name:** a Tasmota MQTT topic az 1. lépésből (pl. `tasmota_XXXXX`) Importálás után két eszköz jelenik meg: **Permit Join** (kapcsoló) és **Devices Found** (számláló). ### 3. lépés — Zigbee eszköz párosítása 1. A TapHome-ban kapcsolja be a **Permit Join** kapcsolót — megnyílik egy 60 másodperces párosítási ablak 2. A Zigbee eszközön indítsa el a párosítási folyamatot (jellemzően tartsa lenyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd) 3. Figyelje a **Devices Found** számlálót — növekszik, amikor új eszköz csatlakozik 4. Ellenőrizze az átjáró **Service Attributes** részét az új eszköz azonosítójának (pl. `0x1234`), gyártójának és modelljének megtekintéséhez 5. A párosítási mód automatikusan deaktiválódik az időkorlát lejártakor ### 4. lépés — Eszközsablon importálása 1. Töltse le az eszközspecifikus sablont a megfelelő kompatibilitási oldalról 2. Importálja a sablont ezekkel a paraméterekkel: - **MQTT Broker IP Address:** ugyanaz, mint az átjáróé - **MQTT Broker Port:** `1883` - **Gateway name:** ugyanaz a Tasmota MQTT topic, mint fentebb - **Device ID:** a párosításból kapott rövid cím (pl. `0x1234`) ## Elérhető eszközök 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Aqara Single Switch Module T1 (With Neutral) Modul Szerviz attribútumok | | | |--------------|----------------------------------------------------| | IEEEAddr | Zigbee IEEE cím — egyedi 64 bites hardverazonosító | | ModelId | | | Manufacturer | | | Endpoints | | | Config | | Egyéni változók `GWname` (string) A Zigbee gateway Tasmota MQTT topic neve (Configuration → MQTT → Topic alatt található) `ID` (string) = 0xC0B4 Az Aqara Single Switch Module T1 Zigbee rövid címe (párosítás során kapott) 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 Figyelő ```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 ``` Szerviz attribútumok IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Kapcsoló Kapcsoló Olvasás és írás Be/ki relé vezérlése ZbSend Power paranccsal — kapcsolja az L1 terhelés kimenetet boolean Értékek / Állapotok: ON · OFF Kapcsoló állapot írása ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", "{\"device\":\" " + ID + "\",\"send\":{\"Power\":" + St + "}}") ``` Figyelő ```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 ``` **Kapcsolat:** Packet Parser → MQTT Lehetséges fejlesztések (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. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |-------------------------------------------------------------|-----------------| | Mqtt Broker IP-cím | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Források - 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 ## Kapcsolódó dokumentáció - [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/) - [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/) - [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)