TapHome

Aqara Single Switch Module T1 (With Neutral)

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 03. 2026

Külső átjáró szükséges

tasmota zigbee2tasmota-gateway — termékoldal

Aqara Single Switch Module T1 (With Neutral)

Ez az eszköz Zigbee-n keresztül kommunikál egy Tasmota gatewayen át. Győződj meg róla, hogy a 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 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éterLeírásPélda
MQTT Broker IP AddressAz MQTT broker IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee rövid cím a párosításból0x1234

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
LFázisvezeték bemenet
NNullavezeték
L1Terhelés kimenet (lámpa vagy készülék)

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útumLeírás
IEEEAddrEgyedi 64 bites hardverazonosító
ModelIdZigbee modell ID (lumi.switch.n0agl1)
ManufacturerAz eszköz által jelentett gyártói karakterlánc
EndpointsAktív Zigbee végpontok
ConfigZigbee 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

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 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: az MQTT 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 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 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 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

Aqara Single Switch Module T1 (With Neutral) Modul
Szerviz attribútumok
IEEEAddrZigbee 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) = 0xC0B4Az 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

Aqara - Single Switch Module T1 (With Neutral)

Figyelő
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
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Kapcsoló Kapcsoló

Be/ki relé vezérlése ZbSend Power paranccsal — kapcsolja az L1 terhelés kimenetet

boolean
Értékek / Állapotok: ON · OFF

Kapcsoló

Kapcsoló állapot írása
MQTTPUBLISH("cmnd/" + GWname+ "/ZbSend", 
    "{\"device\":\" " + ID + 
    "\",\"send\":{\"Power\":" + St + "}}")
Figyelő
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.

Források