TapHome

Aqara Water Leak Sensor

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

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Aqara Water Leak Sensor

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 Water Leak Sensor (SJCGQ11LM) je kompaktan Zigbee senzor curenja vode na bateriju sa zaštitom IP67. Prisutnost vode prepoznaje kad razina vode na kontaktnim pločicama na dnu uređaja dosegne 0,5 mm. TapHome komunicira sa senzorom preko protokola MQTT putem pristupnika Zigbee2Tasmota. Kad se curenje vode prepozna ili prestane, senzor objavljuje vrijednost ZoneStatusChange u JSON poruci ZbReceived.

Senzor se napaja gumbastom baterijom CR2032 (trajanje oko 2 godine). Predložak prati razinu i napon baterije putem servisnih atributa, upozorava kad razina baterije padne ispod 30 % i prepoznaje kad je uređaj izvan mreže (upozorenje nakon 12 sati, pogreška nakon 24 sata).

Konfiguracija

Uparivanje senzora
  1. U sustavu TapHome uključite sklopku Permit Join u modulu Zigbee2Tasmota Gateway
  2. Na senzoru pritisnite i držite tipku dok plava LED dioda ne počne treptati, a zatim je otpustite
  3. Pričekajte da se brojač Devices Found poveća. Device ID senzora (npr. 0xF121) prikazuje se u servisnim atributima pristupnika
  4. Uvezite ovaj predložak uređaja s Device ID-jem dobivenim pri uparivanju

Ako se uparivanje ne pokrene, pokušajte oko 10 sekundi držati pritisnut logotip vode na dnu senzora, dok plava LED dioda ne trepne tri puta, a zatim ga otpustite.

Parametri uvoza
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 uparivanju0xF121

Mogućnosti uređaja

Prepoznavanje curenja vode

Predložak sadrži jedan uređaj Senzor curenja vode mapiran kao PacketParserReedContact (tip 1031) s funkcijom FloodSensor. Uređaj čita polje ZoneStatusChange iz ZbReceived.{DeviceID} u MQTT poruci SENSOR:

  • ZoneStatusChange = 1 → Alarm (otkrivena voda)
  • ZoneStatusChange = 0 → OK (suho)

Senzor se budi i šalje svoje stanje kad voda dosegne kontaktne pločice od 0,5 mm na donjoj strani uređaja te ponovno kad se voda ukloni i pločice se osuše.

Za razliku od senzora vrata i prozora koji koriste polje Contact, senzor curenja vode koristi ZoneStatusChange, polje statusa Zigbee IAS Zone. To je standardni mehanizam za alarmne senzore u protokolu Zigbee.

Praćenje baterije

Modul prati stanje baterije putem dva servisna atributa:

  • Razina baterije — procijenjena razina napunjenosti baterije CR2032; upozorenje na slabu bateriju pojavljuje se kad razina padne ispod 30 %
  • Napon baterije — neobrađena vrijednost napona članka CR2032 u voltima

Podaci o bateriji čitaju se iz polja BatteryPercentage i BatteryVoltage u poruci ZbReceived.

Prepoznavanje prekida veze

Predložak prati dostupnost uređaja pomoću vremenske oznake LastSeenEpoch iz periodičnog upita ZbInfo (svakih sat vremena):

  • Upozorenje — uređaj se nije javio dulje od 12 sati
  • Pogreška — uređaj se nije javio dulje od 24 sata

Tako se mogu otkriti situacije u kojima je senzor izgubio Zigbee vezu ili je baterija potpuno ispražnjena.

Dijagnostički servisni atributi

Modul prikazuje dodatne Zigbee metapodatke dobivene periodičnim upitom ZbInfo:

AtributOpis
IEEEAddrJedinstveni 64-bitni hardverski identifikator
ModelIdZigbee ID modela (lumi.sensor_wleak.aq1)
ProizvođačNaziv proizvođača koji javlja uređaj
EndpointsAktivne Zigbee krajnje točke (endpoints)
ConfigZigbee konfiguracija uređaja
Kvaliteta vezeJačina signala u rasponu 0–100 %
Dodatne mogućnosti

Aqara SJCGQ11LM preko protokola Zigbee javlja i unutarnju temperaturu uređaja. Kvaliteta veze (LQI) dostupna je u svakoj poruci SENSOR, ali se zasad prikazuje samo na razini modula putem upita ZbInfo svakih sat vremena. Ove mogućnosti mogu se dodati u nekom od budućih ažuriranja predloška.

Rješavanje problema

Senzor ne javlja curenje vode
  1. Provjerite je li senzor uparen s pristupnikom Zigbee2Tasmota. Provjerite ZbStatus u konzoli Tasmota
  2. Provjerite odgovara li Device ID u predlošku kratkoj adresi dobivenoj pri uparivanju (npr. 0xF121)
  3. Stavite senzor na mokru površinu kako biste izazvali promjenu stanja. Uređaj bi u roku od nekoliko sekundi trebao objaviti vrijednost ZoneStatusChange
  4. Pomoću MQTT klijenta (npr. MQTT Explorer) pretplatite se na tele/{GWname}/SENSOR i provjerite objavljuje li senzor poruke ZbReceived s poljem ZoneStatusChange
Upozorenje o prekidu veze iako senzor radi
  1. Prepoznavanje prekida veze oslanja se na upit ZbInfo (svakih sat vremena). Ako senzor u 12 sati nije poslao nijednu poruku, pojavljuje se upozorenje
  2. Zigbee uređaji na baterije između događaja su u stanju mirovanja. To je normalno. Upozorenje obično nestaje nakon sljedećeg curenja vode ili sljedećeg upita ZbInfo
  3. Ako upozorenje traje dulje od 24 sata, provjerite bateriju (CR2032) i po potrebi ponovno uparite uređaj
Lažni alarmi ili senzor ne prepoznaje vodu
  1. Provjerite jesu li kontaktne pločice na dnu senzora čiste i nisu li prekrivene prljavštinom ili naslagama
  2. Senzor prepoznaje vodu tek kad njezina razina dosegne najmanje 0,5 mm. Male kapljice ili kondenzacija možda neće biti dovoljne
  3. Zaštita IP67 znači da je kućište senzora vodootporno, ali pločice za prepoznavanje moraju biti u izravnom dodiru s površinom vode

Aqara SJCGQ11LM koristi gumbastu bateriju CR2032. Pri uobičajenoj upotrebi baterija obično traje više od 2 godine. Postavljanje u stalno vlažan prostor (npr. ispod bojlera ili pokraj odvoda perilice rublja) može skratiti trajanje baterije jer se senzor češće budi.

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 Water Leak Sensor Modul
Servisni atributi
IEEEAddrZigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator senzora
ModelIdZigbee identifikator modela koji javlja uređaj (lumi.sensor_wleak.aq1)
ProizvođačNaziv proizvođača koji uređaj javlja preko protokola Zigbee
EndpointsAktivne Zigbee krajnje točke (endpoints) na uređaju
ConfigKonfiguracijski niz Zigbee uređaja
Kvaliteta vezeJačina Zigbee signala — od 0 % (nema signala) do 100 % (najbolji)
Napon baterijeNapon gumbaste baterije CR2032 u voltima
Razina baterijeProcijenjena razina baterije — upozorenje ispod 30 %
Prilagođene varijable
GWname (string)Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic)
ID (string) = 0xF121Kratka Zigbee adresa senzora curenja vode Aqara (dodjeljuje se pri uparivanju)
After pairing the sensor via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus

Aqara - Water Leak Sensor

Čitanje (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var bat := PARSEJSON(ZbReceived, "BatteryPercentage", true);
    if(!ISNULL(bat), BatteryPercentage := bat);
    var volt := PARSEJSON(ZbReceived, "BatteryVoltage", true);
    if(!ISNULL(volt), BatteryVoltage := volt);
    
    var deviceInfo := PARSEJSON(RECEIVEDMSG.Payload, "ZbInfo." + ID, true);
    if !ISNULL(deviceInfo)
    	LastSeenEpoch := PARSEJSON(deviceInfo, "LastSeenEpoch");
        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"));
        COMPLETESERVICEATTRIBUTE("Link Quality", ROUND(LINEAR(PARSEJSON(deviceInfo, "LinkQuality"), 0,0, 254, 100)) + "%");
    end
end

if BatteryPercentage < 30
	ADDWARNING("Low battery (<30%)");
end

if !ISNAN(LastSeenEpoch)
	DATETIME now := NOW();
	var secondsSeen := now.UNIXTIME - LastSeenEpoch;
	if secondsSeen > 12 * 60 * 60
		if secondsSeen > 24 * 60 * 60
			ADDERROR("Device is offline > 24H");
		else
			ADDWARNING("Device is offline > 12H");        
		end
	end
end
Servisni atributi
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Senzor curenja vode Magnetski kontakt Samo za čitanje

Prepoznavanje curenja vode preko Zigbee IAS Zone — čita polje ZoneStatusChange iz Zigbee poruke senzora. Zaštita IP67, prag prepoznavanja 0,5 mm.

boolean

Senzor curenja vode

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".ZoneStatusChange", true);
    if(!ISNULL(val), Rc := val);
end
Povezivanje: Packet Parser → MQTT
Moguća poboljšanja (2)
  • Device Temperature — Blakadder lists device temperature reporting as a supported feature of SJCGQ11LM. The TapHome template does not parse this field.
  • Link Quality (device-level) — LinkQuality is available per SENSOR message but only exposed as a module-level service attribute via ZbInfo polling.

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