TapHome

Aqara Water Leak Sensor

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

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

tasmota zigbee2tasmota-gateway — termékoldal

Aqara Water Leak Sensor

Ez az eszköz Zigbee-n keresztül kommunikál egy Tasmota gateway-en á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 Water Leak Sensor (SJCGQ11LM) egy kompakt, IP67 védettségű, elemes Zigbee vízszivárgás-érzékelő. Érzékeli a víz jelenlétét, amikor a vízszint eléri az eszköz alján található 0,5 mm magas érintkezőfelületeket. A TapHome MQTT-n keresztül kommunikál az érzékelővel egy Zigbee2Tasmota gateway-en át — az érzékelő egy ZoneStatusChange értéket küld a ZbReceived JSON üzenetben, amikor vízszivárgást észlel vagy az megszűnik.

Az érzékelőt CR2032 gombelem táplálja (élettartam körülbelül 2 év). A sablon figyeli az akkumulátorszintet és feszültséget a szervizattribútumokon keresztül, figyelmeztet, ha az akkumulátorszint 30 % alá csökken, és érzékeli az offline állapotot (figyelmeztetés 12 óra, hiba 24 óra után).

Konfiguráció

Az érzékelő párosítása
  1. A TapHome-ban kapcsold be a Permit Join kapcsolót a Zigbee2Tasmota Gateway modulban
  2. Az érzékelőn tartsd nyomva a gombot, amíg a kék LED villogni nem kezd, majd engedd el
  3. Várd meg, amíg a Devices Found számláló növekszik — az érzékelő Device ID-ja (pl. 0xF121) megjelenik a gateway szervizattribútumai között
  4. Importáld ezt az eszközsablont a párosításból származó Device ID-val

Ha a párosítás nem indul el, tartsd az érzékelő alján lévő víz logót körülbelül 10 másodpercig, amíg háromszor villan a kék LED, majd engedd el.

Import paraméterek
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ól0xF121

Eszközképességek

Vízszivárgás-érzékelés

A sablon egyetlen Flood Sensor eszközt biztosít, amely PacketParserReedContact-ként (típus 1031) van leképezve FloodSensor képességgel. Az eszköz a ZoneStatusChange mezőt elemzi a ZbReceived.{DeviceID} MQTT SENSOR üzenetből:

  • ZoneStatusChange = 1 → Riasztás (víz érzékelve)
  • ZoneStatusChange = 0 → OK (száraz)

Az érzékelő felébred és elküldi állapotát, amikor a víz eléri az eszköz alján található 0,5 mm magas érintkezőfelületeket, majd újra, amikor a vizet eltávolítják és a felületek megszáradnak.

Az ajtó-/ablakérzékelőkkel ellentétben, amelyek a Contact mezőt használják, a vízszivárgás-érzékelő a ZoneStatusChange mezőt használja — ez egy Zigbee IAS Zone állapotmező. Ez a szabványos mechanizmus a riasztástípusú érzékelők számára a Zigbee protokollban.

Akkumulátor-figyelés

A modul két szervizattribútumon keresztül követi az akkumulátor állapotát:

  • Battery Percentage — a CR2032 becsült töltöttségi szintje; alacsony akkumulátor figyelmeztetés aktiválódik 30 % alatti szintnél
  • Battery Voltage — a CR2032 cella nyers feszültsége voltban

Az akkumulátoradatokat a BatteryPercentage és BatteryVoltage mezőkből elemzi a ZbReceived üzenetből.

Offline érzékelés

A sablon az eszköz elérhetőségét a LastSeenEpoch időbélyeg alapján figyeli a ZbInfo lekérdezésből (óránként):

  • Figyelmeztetés — az eszköz több mint 12 órája nem volt látható
  • Hiba — az eszköz több mint 24 órája nem volt látható

Ez segít felismerni azokat a helyzeteket, amikor az érzékelő elvesztette a Zigbee-kapcsolatot, vagy az akkumulátor teljesen lemerült.

Diagnosztikai szervizattribútumok

A modul további Zigbee metaadatokat tesz elérhetővé a ZbInfo lekérdezésen keresztül:

AttribútumLeírás
IEEEAddrEgyedi 64 bites hardverazonosító
ModelIdZigbee modell ID (lumi.sensor_wleak.aq1)
ManufacturerAz eszköz által jelentett gyártói karakterlánc
EndpointsAktív Zigbee végpontok
ConfigEszköz Zigbee-konfigurációja
Link QualityJelerősség 0–100 % skálán
További képességek

Az Aqara SJCGQ11LM belső eszközhőmérsékletet is jelent Zigbee-n keresztül. Az üzenetenkénti linkminőség (LQI) elérhető minden SENSOR payloadban, de jelenleg csak modulszinten van kiajánlva az óránkénti ZbInfo lekérdezésen keresztül. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az érzékelő nem jelzi az elárasztási állapotot
  1. Ellenőrizd, hogy az érzékelő párosítva van a Zigbee2Tasmota gateway-jel — nézd meg a ZbStatus-t a Tasmota konzolon
  2. Erősítsd meg, hogy a sablonban szereplő Device ID egyezik a párosításból származó rövid címmel (pl. 0xF121)
  3. Helyezd az érzékelőt nedves felületre az állapotváltozás kiváltásához — az eszköznek másodperceken belül ZoneStatusChange értéket kell küldenie
  4. Használj MQTT klienst (pl. MQTT Explorer) a tele/{GWname}/SENSOR feliratkozáshoz, és ellenőrizd, hogy az érzékelő ZbReceived üzeneteket küld ZoneStatusChange mezővel
Offline figyelmeztetés a működő érzékelő ellenére
  1. Az offline érzékelés a ZbInfo lekérdezésen alapul (óránként). Ha az érzékelő 12 órán belül nem küldött üzenetet, figyelmeztetés jelenik meg
  2. Az elemes Zigbee eszközök alvó üzemmódban vannak az események között — ez normális viselkedés. A figyelmeztetés általában a következő szivárgási esemény vagy ZbInfo lekérdezés után megszűnik
  3. Ha a figyelmeztetés 24 óránál tovább fennáll, ellenőrizd az akkumulátort (CR2032), és szükség esetén párosítsd újra az eszközt
Téves riasztások vagy nincs érzékelés
  1. Győződj meg arról, hogy az érzékelő alján lévő érintkezőfelületek tiszták, és nem takarja el szennyeződés vagy maradék
  2. Az érzékelőnek legalább 0,5 mm vízre van szüksége az érzékelés aktiválásához — apró cseppek vagy páralecsapódás nem feltétlenül elegendő
  3. Az IP67 védettségi besorolás azt jelenti, hogy az érzékelő teste vízálló, de az érzékelőfelületeknek közvetlen érintkezésben kell lenniük a víz felszínével

Az Aqara SJCGQ11LM CR2032 gombelemet használ. Az elem élettartama normál használat mellett jellemzően 2+ év. Tartósan párás környezetben való elhelyezés (pl. bojler alatt vagy mosógép lefolyója közelében) csökkentheti az elem élettartamát a gyakoribb felébredések miatt.

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 Water Leak Sensor Modul
Szerviz attribútumok
IEEEAddrZigbee IEEE cím — az érzékelő egyedi 64 bites hardverazonosítója
ModelIdAz eszköz által jelentett Zigbee modellazonosító (lumi.sensor_wleak.aq1)
ManufacturerAz eszköz által Zigbee-n keresztül jelentett gyártói karakterlánc
EndpointsAz eszköz aktív Zigbee végpontjai
ConfigAz eszköz Zigbee konfigurációs karakterlánca
Link QualityZigbee jelerősség — 0 % (nincs jel) – 100 % (legjobb)
Battery VoltageCR2032 gombelem feszültsége voltban
Battery PercentageBecsült akkumulátorszint — figyelmeztetés 30 % alatt
Egyéni változók
GWname (string)A Zigbee gateway Tasmota MQTT topic neve (Configuration → MQTT → Topic alatt található)
ID (string) = 0xF121Az Aqara vízszivárgás-érzékelő Zigbee rövid címe (párosításkor kapott)
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

Olvasás (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Figyelő
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
Szerviz attribútumok
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Elárasztás-érzékelő Reed kontaktus Csak olvasható

Vízszivárgás-érzékelés Zigbee IAS Zone-on át — a ZoneStatusChange mezőt olvassa a Zigbee érzékelő üzenetéből. IP67 védettség, 0,5 mm érzékelési küszöb.

boolean

Elárasztás-érzékelő

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".ZoneStatusChange", true);
    if(!ISNULL(val), Rc := val);
end
Kapcsolat: Packet Parser → MQTT
Lehetséges fejlesztések (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.

Források