---
title: "Aqara Water Leak Sensor"
description: "IP67 Zigbee vízszivárgás-érzékelő Tasmota gateway-en át. 0,5 mm-es küszöb ZoneStatusChange-dzsel, akkumulátor- és offline figyelés. CR2032 elemes."
url: "https://taphome.com/hu/compatibility/zigbee2tasmota-aqara-water-leak-sensor/"
language: hu
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","water-leak-detection","security"]
  questions: ["Hogyan integrálható az Aqara vízszivárgás-érzékelő a TapHome-mal?","Mit érzékel az Aqara SJCGQ11LM TapHome sablon?","Hogyan párosítható az Aqara vízszivárgás-érzékelő egy Zigbee2Tasmota gateway-jel?","Miért nem jelzi az Aqara vízszivárgás-érzékelőm az elárasztási állapotot?","Figyeli az Aqara vízszivárgás-érzékelő sablon az akkumulátorszintet a TapHome-ban?","Hogyan érzékeli a TapHome a vízszivárgást Zigbee-n keresztül?"]
---

# Aqara Water Leak Sensor

Kommunikáció: Packet Parser → MQTT

- [Aqara Water Leak Sensor](https://www.aqara.com/en/product/water-sensor/)

> Hálózati cím
> 
> A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

> [!IMPORTANT]
> 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](https://taphome.com/hu/compatibility/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 az eszköz alján található érintkezőfelületeknél eléri a 0,5 mm-t. 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

> [!TIP]
> 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éter | Leírás | Példa |
|-----------|--------|-------|
| **MQTT Broker IP Address** | Az MQTT broker IP-címe | `192.168.1.10` |
| **MQTT Broker Port** | Broker port (alapértelmezett 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Zigbee rövid cím a párosításból | `0xF121` |

## 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.

> [!NOTE]
> 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útum | Leírás |
|------------|--------|
| **IEEEAddr** | Egyedi 64 bites hardverazonosító |
| **ModelId** | Zigbee modell ID (`lumi.sensor_wleak.aq1`) |
| **Manufacturer** | Az eszköz által jelentett gyártói karakterlánc |
| **Endpoints** | Aktív Zigbee végpontok |
| **Config** | Eszköz Zigbee-konfigurációja |
| **Link Quality** | Jelerő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

> [!WARNING]
> 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

> [!TIP]
> 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](https://tasmota.github.io/docs/Getting-Started/) 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:** a beépített brokerhez a TapHome Core IP-címe (IP-foglalással a routerben → [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)), egyébként a 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](https://tasmota.github.io/docs/Zigbee/) 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](https://taphome.com/hu/compatibility/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 beépített TapHome brokerhez `127.0.0.1`, egyébként 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 1

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Aqara Water Leak Sensor Modul

Szerviz attribútumok

|                    |                                                                           |
|--------------------|---------------------------------------------------------------------------|
| IEEEAddr           | Zigbee IEEE cím — az érzékelő egyedi 64 bites hardverazonosítója          |
| ModelId            | Az eszköz által jelentett Zigbee modellazonosító (lumi.sensor\_wleak.aq1) |
| Manufacturer       | Az eszköz által Zigbee-n keresztül jelentett gyártói karakterlánc         |
| Endpoints          | Az eszköz aktív Zigbee végpontjai                                         |
| Config             | Az eszköz Zigbee konfigurációs karakterlánca                              |
| Link Quality       | Zigbee jelerősség — 0 % (nincs jel) – 100 % (legjobb)                     |
| Battery Voltage    | CR2032 gombelem feszültsége voltban                                       |
| Battery Percentage | Becsü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) = 0xF121 Az 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

Olvasás (modul)

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

Figyelő

```taphome
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

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

```taphome
BatteryVoltage + " V"
```

Battery Percentage

```taphome
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

Figyelő

```taphome
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.

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri                                          | Alapérték       |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP-cím                                          | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Források

- Tasmota Zigbee Documentation
  
  [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/)
- Zigbee Compatible Devices Database
- Blakadder Device Entry — Aqara SJCGQ11LM
  
  [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_SJCGQ11LM.html) 2026-03-29
- Aqara Product Page — Water Leak Sensor
  
  [www.aqara.com](https://www.aqara.com/en/product/water-sensor/) 2026-03-29

## Kapcsolódó dokumentáció

- [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)
- [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/)
- [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)