TapHome
Službeni · TapHome Provjereno Energija i mjerenje

Aqara Single Switch Module T1 (With Neutral)

Kompaktni Zigbee relejni modul Aqara SSM-U01 integriran sa sustavom TapHome preko protokola MQTT putem pristupnika Zigbee2Tasmota. Uključivanje i isključivanje rasvjete i uređaja do 2500 W.

AqaraPacket Parser → MQTT1 uređajRevizija 1.0 Posljednje ažuriranje: 29. ožujka 2026.
Radi na Coreu TapHome Next 2026.1.41766
iOvaj smo predložak u laboratoriju TapHome uvezli u ovaj Core i svi su njegovi uređaji dodani bez pogreške.
Aqara Single Switch Module T1 (With Neutral)

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Adresa u mreži

Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera 127.0.0.1 (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.

Priprema mreže

Upute za integraciju

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: za ugrađeni broker IP adresu centralne jedinice TapHome Core (s rezervacijom IP adrese u usmjerivaču → Priprema mreže), inače IP adresu vašeg 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: za ugrađeni broker TapHome 127.0.0.1, inače 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 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

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 Čitanje i pisanje

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.

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Gateway name (Tasmota->Configuration->MQTT->Topic)tasmota_XXXXX
Device ID0xFFFF

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.

Predložak · TapHome portal Aqara Single Switch Module T1 (With Neutral) 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. Packet Parser → MQTT Pogledaj u TapHome portalu