TapHome

Aqara Single Switch Module T1 (With Neutral)

Packet Parser → MQTT
Autor
Posljednje ažuriranje: 03. 2026

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Aqara Single Switch Module T1 (With Neutral)

Ovaj uređaj komunicira preko protokola Zigbee putem pristupnika Tasmota. Prije nastavka provjerite jeste li uvezli predložak Zigbee2Tasmota Gateway i uparili uređaj.

Aqara Single Switch Module T1 (With Neutral) je kompaktan Zigbee 3.0 relejni modul (model SSM-U01) za ugradnju iza prekidača. Pretvara klasični zidni prekidač u pametni prekidač, uz zadržavanje postojeće maske prekidača. TapHome upravlja relejem preko protokola MQTT putem pristupnika Zigbee2Tasmota pomoću naredbi ZbSend, bez potrebe za vezom s oblakom.

Modul zahtijeva neutralni vodič i podržava opterećenja od 3 W do 2500 W (10 A, omsko opterećenje) pri 100–250 VAC. Zahvaljujući malim dimenzijama (42,9 × 40 × 19,9 mm) može se ugraditi u većinu podžbuknih kutija za prekidače.

Budući da se napaja iz mreže, modul radi kao Zigbee usmjerivač (router). Jača Zigbee mesh mrežu i povećava domet za obližnje senzore na baterije.

Konfiguracija

Uparivanje modula
  1. Provjerite je li Zigbee2Tasmota Gateway postavljen i je li sklopka Permit Join u sustavu TapHome uključena
  2. Na modulu dugo pritisnite tipku dok plava LED dioda ne počne brzo treptati, a zatim je otpustite
  3. Pričekajte da se brojač Devices Found poveća. Device ID modula (npr. 0x1234) prikazuje se u servisnim atributima pristupnika
  4. Uvezite ovaj predložak uređaja s Device ID-jem dobivenim pri uparivanju
Parametri uvoza predloška

Predložak uređaja traži 4 parametra:

ParametarOpisPrimjer
MQTT Broker IP AddressIP adresa vašeg MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (zadano 1883)1883
Gateway nameMQTT tema uređaja Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKratka Zigbee adresa dobivena pri uparivanju0x1234

Nakon uvoza u sustavu TapHome pojavljuje se jedan uređaj Sklopka za uključivanje i isključivanje.

Spajanje

Modul zahtijeva priključak neutralnog vodiča i ima tri stezaljke:

StezaljkaSpoj
LUlaz faznog vodiča (faza)
NNeutralni vodič
L1Izlaz prema trošilu (svjetlo ili uređaj)

Ovaj modul zahtijeva neutralni vodič. Ne može se ugraditi u kutije prekidača u kojima su samo fazni i povratni vodič. Najveće opterećenje je 10 A / 2500 W za omska opterećenja, najmanje opterećenje je 3 W. Ugradnju mora obaviti kvalificirani električar.

Mogućnosti uređaja

Upravljanje sklopkom

Predložak stvara jedan uređaj Sklopka koji čita i upisuje polje Power:

  • Čitanje: Modul prati temu tele/{GWname}/SENSOR i poruke ZbReceived.{ID}.Power. Kad se pritisne fizička tipka ili se promijeni stanje releja, modul objavljuje novo stanje.
  • Upisivanje: TapHome šalje naredbu ZbSend na cmnd/{GWname}/ZbSend s Power: true (uključeno) ili Power: false (isključeno) i tako daljinski upravlja relejem.

Sklopka reagira i na pritisak fizičke tipke i na naredbe iz sustava TapHome, a TapHome uvijek prikazuje trenutačno stanje releja, bez obzira na to kako je promijenjeno.

Servisni atributi

Modul prikazuje dijagnostičke Zigbee metapodatke dobivene periodičnim upitom ZbInfo:

AtributOpis
IEEEAddrJedinstveni 64-bitni hardverski identifikator
ModelIdZigbee ID modela (lumi.switch.n0agl1)
ProizvođačNaziv proizvođača koji javlja uređaj
EndpointsAktivne Zigbee krajnje točke (endpoints)
ConfigZigbee konfiguracija uređaja
Dodatne mogućnosti

Aqara SSM-U01 podržava i mjerenje snage u stvarnom vremenu (W), praćenje ukupne potrošnje energije, javljanje unutarnje temperature uređaja, odvojeni način rada (decoupled mode, tipka može pokrenuti scenu bez prebacivanja releja) i zaštitu od preopterećenja i pregrijavanja. Hardver te mogućnosti ima, ali zasad nisu mapirane u predlošku TapHome. Mogu se dodati u nekom od budućih ažuriranja predloška.

Rješavanje problema

Sklopka ne reagira na naredbe iz sustava TapHome
  1. Provjerite odgovara li Device ID u predlošku kratkoj Zigbee adresi dodijeljenoj pri uparivanju (npr. 0xC0B4)
  2. Provjerite je li Gateway name isti u predlošku pristupnika i u ovom predlošku uređaja
  3. Isprobajte fizičku tipku na modulu. Ako prebacuje relej, a TapHome se ne ažurira, problem je možda u primanju stanja (tema tele/{GWname}/SENSOR)
  4. Pomoću MQTT klijenta (npr. MQTT Explorer) pretplatite se na tele/{GWname}/SENSOR i provjerite objavljuje li modul pri prebacivanju poruke ZbReceived s poljem Power
Stanje sklopke nije usklađeno
  1. Ako TapHome prikazuje drugačije stanje od stvarnog stanja releja, pritisnite fizičku tipku kako bi modul javio stanje
  2. Predložak ne ispituje stanje sklopke aktivno, nego se oslanja na to da uređaj javi promjene. Ako modul nakratko izgubi Zigbee vezu, prikazano stanje može biti zastarjelo do sljedećeg fizičkog prebacivanja ili naredbe
Modul se ne uparuje
  1. Provjerite ima li modul napajanje (spojeni moraju biti i neutralni i fazni vodič)
  2. Dugo pritisnite tipku dok plava LED dioda ne počne brzo treptati. Kratki pritisak ne pokreće način uparivanja
  3. Ako je modul daleko od koordinatora, pri prvom uparivanju približite pristupnik
  4. Ako je modul prije bio uparen s drugim Zigbee koordinatorom, prije spajanja na novu mrežu možda ga treba vratiti na tvorničke postavke. Držite tipku dulje od 10 sekundi dok LED dioda ne trepne tri puta

Kako ga instalirati u TapHome

Preduvjeti

  • Zigbee pristupnik s firmverom Tasmota (npr. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker koji radi u vašoj lokalnoj mreži (ugrađeni broker TapHome ili vanjski)
  • TapHome CCU u istoj mreži

TapHome ima ugrađeni MQTT broker — uključite ga u Postavke → Hardver → MQTT Broker. Nije potreban nikakav dodatni softver.

Korak 1 — Postavite Tasmota Zigbee pristupnik

  1. Na podržani Zigbee koordinator (npr. Sonoff ZBBridge, eWeLink ZB-GW03) učitajte firmver Tasmota
  2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
  3. Idite na Configuration → Configure MQTT i postavite:
    • Host: IP adresu vašeg MQTT brokera (npr. 192.168.1.10)
    • Port: 1883
    • Topic: zapišite naziv teme (npr. tasmota_XXXXX) — trebat će vam pri uvozu predloška

Detaljne upute potražite u dokumentaciji Tasmota Zigbee.

Korak 2 — Uvezite predložak pristupnika u sustav TapHome

  1. Preuzmite predložak pristupnika sa stranice kompatibilnosti Zigbee2Tasmota Gateway
  2. U sustavu TapHome idite na Postavke → Hardver → Packet Parser → Uvoz
  3. Uvezite predložak s ovim parametrima:
    • MQTT Broker IP Address: IP adresa vašeg brokera (npr. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT tema iz koraka 1 (npr. tasmota_XXXXX)

Nakon uvoza vidjet ćete dva uređaja: Permit Join (sklopka) i Pronađeni uređaji (brojač).

Korak 3 — Uparite Zigbee uređaj

  1. U sustavu TapHome uključite sklopku Permit Join — otvara se razdoblje od 60 sekundi za uparivanje
  2. Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
  3. Pratite brojač Pronađeni uređaji — povećava se kada se pridruži novi uređaj
  4. U Servisnim atributima pristupnika pogledajte ID novog uređaja (npr. 0x1234), proizvođača i model
  5. Način uparivanja automatski se isključuje nakon isteka vremena

Korak 4 — Uvezite predložak uređaja

  1. Preuzmite predložak za konkretni uređaj s odgovarajuće stranice kompatibilnosti
  2. Uvezite predložak s ovim parametrima:
    • MQTT Broker IP Address: ista kao za pristupnik
    • MQTT Broker Port: 1883
    • Gateway name: ista Tasmota MQTT tema kao gore
    • Device ID: kratka adresa iz uparivanja (npr. 0x1234)

Dostupni uređaji

Aqara Single Switch Module T1 (With Neutral) Modul
Servisni atributi
IEEEAddrZigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator
ModelId
Proizvođač
Endpoints
Config
Prilagođene varijable
GWname (string)Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic)
ID (string) = 0xC0B4Kratka Zigbee adresa modula Aqara Single Switch Module T1 (dodjeljuje se pri uparivanju)
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
Servisni atributi
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Sklopka Sklopka

Relej za uključivanje i isključivanje kojim se upravlja naredbom ZbSend Power — uključuje i isključuje izlaz prema trošilu L1

boolean
Vrijednosti / stanja: ON · OFF

Sklopka

Zapis stanja sklopke
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
Povezivanje: Packet Parser → MQTT
Moguća poboljšanja (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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu