---
title: "Aqara Water Leak Sensor"
description: "Zigbee snímač úniku vody IP67 cez bránu Tasmota. Detekcia vody pri 0,5 mm cez ZoneStatusChange, monitoring batérie a offline stavu. Napájaný CR2032."
url: "https://taphome.com/sk/compatibility/zigbee2tasmota-aqara-water-leak-sensor/"
language: sk
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","water-leak-detection","security"]
  questions: ["Ako integrovať snímač úniku vody Aqara s TapHome?","Čo detekuje šablóna Aqara SJCGQ11LM v TapHome?","Ako spárovať snímač úniku vody Aqara s bránou Zigbee2Tasmota?","Prečo môj snímač úniku vody Aqara nehlási stav zaplavenia?","Monitoruje šablóna snímača úniku vody Aqara úroveň batérie v TapHome?","Ako TapHome detekuje únik vody cez Zigbee?"]
---

# Aqara Water Leak Sensor

Komunikácia: Packet Parser → MQTT

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

> Adresa v sieti
> 
> Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

> [!IMPORTANT]
> Toto zariadenie komunikuje cez **Zigbee** prostredníctvom brány Tasmota. Uistite sa, že máte
> importovanú šablónu [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/)
> a zariadenie spárované pred pokračovaním.

Aqara Water Leak Sensor (SJCGQ11LM) je kompaktný batériový Zigbee snímač úniku vody s krytím IP67. Detekuje prítomnosť vody, keď hladina vody pri kontaktných plôškach na spodnej strane zariadenia dosiahne 0,5 mm. TapHome komunikuje so snímačom cez MQTT prostredníctvom brány Zigbee2Tasmota — snímač publikuje hodnotu `ZoneStatusChange` v JSON správe `ZbReceived`, keď je detekovaný alebo odstránený únik vody.

Snímač je napájaný gombíkovou batériou CR2032 (životnosť približne 2 roky). Šablóna monitoruje úroveň a napätie batérie cez servisné atribúty, upozorní pri poklese pod 30 % a detekuje offline stav zariadenia (varovanie po 12 hodinách, chyba po 24 hodinách).

## Konfigurácia

### Spárovanie snímača

1. V TapHome zapnite prepínač **Permit Join** v module Zigbee2Tasmota Gateway
2. Na snímači stlačte a podržte tlačidlo, kým nezačne blikať modrá LED, potom uvoľnite
3. Počkajte, kým sa zvýši počítadlo **Devices Found** — Device ID snímača (napr. `0xF121`) sa zobrazí v servisných atribútoch brány
4. Importujte túto šablónu zariadenia pomocou Device ID zo spárovania

> [!TIP]
> Ak sa spárovanie nespustí, skúste podržať logo vody na spodnej strane snímača približne 10 sekúnd, kým sa trikrát blikne modrá LED, potom uvoľnite.

### Parametre importu

| Parameter | Popis | Príklad |
|-----------|-------|---------|
| **MQTT Broker IP Address** | IP adresa vášho MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (predvolene 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Zigbee krátka adresa zo spárovania | `0xF121` |

## Možnosti zariadenia

### Detekcia úniku vody

Šablóna poskytuje jedno zariadenie **Flood Sensor** mapované ako `PacketParserReedContact` (typ 1031) s kapabilitou `FloodSensor`. Zariadenie parsuje pole `ZoneStatusChange` z `ZbReceived.{DeviceID}` v MQTT SENSOR správe:

- **ZoneStatusChange = 1** → **Alarm** (voda detekovaná)
- **ZoneStatusChange = 0** → **OK** (sucho)

Snímač sa prebudí a odošle svoj stav, keď voda dosiahne kontaktné plôšky s výškou 0,5 mm na spodnej strane zariadenia, a znovu keď sa voda odstráni a plôšky uschnú.

> [!NOTE]
> Na rozdiel od snímačov dverí/okien, ktoré používajú pole `Contact`, snímač úniku vody používa `ZoneStatusChange` — stavové pole Zigbee IAS Zone. Toto je štandardný mechanizmus pre alarmové snímače v protokole Zigbee.

### Monitoring batérie

Modul sleduje stav batérie prostredníctvom dvoch servisných atribútov:

- **Battery Percentage** — odhadovaná úroveň nabitia CR2032; **varovanie o nízkej batérii** sa spustí pri poklese pod 30 %
- **Battery Voltage** — surové napätie článku CR2032 vo voltoch

Údaje o batérii sa parsujú z polí `BatteryPercentage` a `BatteryVoltage` v správe `ZbReceived`.

### Detekcia offline stavu

Šablóna monitoruje dostupnosť zariadenia pomocou časovej značky `LastSeenEpoch` z pollingu `ZbInfo` (každú 1 hodinu):

- **Varovanie** — zariadenie nebolo videné viac ako **12 hodín**
- **Chyba** — zariadenie nebolo videné viac ako **24 hodín**

Pomáha to odhaliť situácie, keď snímač stratil Zigbee konektivitu alebo je batéria úplne vybitá.

### Diagnostické servisné atribúty

Modul sprístupňuje dodatočné Zigbee metadáta získané cez polling `ZbInfo`:

| Atribút | Popis |
|---------|-------|
| **IEEEAddr** | Unikátny 64-bitový hardvérový identifikátor |
| **ModelId** | Zigbee model ID (`lumi.sensor_wleak.aq1`) |
| **Manufacturer** | Reťazec výrobcu hlásený zariadením |
| **Endpoints** | Aktívne Zigbee endpointy |
| **Config** | Zigbee konfigurácia zariadenia |
| **Link Quality** | Sila signálu škálovaná od 0–100 % |

### Ďalšie možnosti

Aqara SJCGQ11LM tiež hlási internú teplotu zariadenia cez Zigbee. Kvalita linky (LQI) pre každú správu je dostupná v každom SENSOR payloade, ale momentálne je sprístupnená len na úrovni modulu cez hodinový polling `ZbInfo`. Tieto možnosti môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### Snímač nehlási stav zaplavenia

1. Overte, že snímač je spárovaný s bránou Zigbee2Tasmota — skontrolujte `ZbStatus` v Tasmota konzole
2. Potvrďte, že **Device ID** v šablóne zodpovedá krátkej adrese zo spárovania (napr. `0xF121`)
3. Položte snímač na mokrý povrch na vyvolanie zmeny stavu — zariadenie by malo publikovať hodnotu `ZoneStatusChange` do niekoľkých sekúnd
4. Použite MQTT klienta (napr. MQTT Explorer) na prihlásenie sa k `tele/{GWname}/SENSOR` a overte, že snímač publikuje `ZbReceived` správy s poľom `ZoneStatusChange`

### Offline varovanie napriek fungujúcemu snímači

1. Detekcia offline stavu závisí od pollingu `ZbInfo` (hodinovo). Ak snímač neodoslal žiadnu správu do 12 hodín, zobrazí sa varovanie
2. Batériové Zigbee zariadenia spia medzi udalosťami — toto je normálne správanie. Varovanie sa zvyčajne zruší po ďalšej udalosti úniku alebo `ZbInfo` pollingu
3. Ak varovanie pretrváva viac ako 24 hodín, skontrolujte batériu (CR2032) a v prípade potreby zariadenie znovu spárujte

### Falošné alarmy alebo žiadna detekcia

1. Uistite sa, že kontaktné plôšky na spodnej strane snímača sú čisté a nie sú znečistené nečistotami alebo zvyškami
2. Snímač vyžaduje minimálne 0,5 mm vody na spustenie detekcie — malé kvapky alebo kondenzácia nemusia stačiť
3. Krytie IP67 znamená, že telo snímača je vodotesné, ale detekčné plôšky musia byť v priamom kontakte s povrchom vody

> [!WARNING]
> Aqara SJCGQ11LM používa gombíkovú batériu CR2032. Životnosť batérie je zvyčajne 2+ roky pri bežnom používaní. Umiestnenie v trvalo vlhkom prostredí (napr. pod bojlerom alebo pri odpade práčky) môže znížiť životnosť batérie kvôli častejšiemu prebúdzaniu.

## Ako nainštalovať v TapHome

### Predpoklady

- Zigbee brána s firmvérom Tasmota (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker bežiaci vo vašej lokálnej sieti (vstavaný TapHome broker alebo externý)
- TapHome CCU v rovnakej sieti

> [!TIP]
> TapHome má vstavaný MQTT broker — aktivujte ho v **Nastavenia** → **Hardware** → **MQTT Broker**. Nie je potrebný žiadny ďalší softvér.

### Krok 1 — Nastavte Tasmota Zigbee bránu

1. Nahrajte [firmvér Tasmota](https://tasmota.github.io/docs/Getting-Started/) na podporovaný Zigbee koordinátor (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
2. Pripojte bránu k vašej Wi-Fi sieti cez webové rozhranie Tasmota
3. Prejdite na **Configuration** → **Configure MQTT** a nastavte:
   - **Host:** pre vstavaný broker IP adresa TapHome Core (s rezerváciou IP v routeri → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)), inak IP adresa vášho brokera (napr. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapíšte si názov topicu (napr. `tasmota_XXXXX`) — budete ho potrebovať pri importe šablóny

Podrobné pokyny nájdete v [dokumentácii Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Krok 2 — Importujte šablónu brány v TapHome

1. Stiahnite si šablónu brány zo stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/)
2. V TapHome prejdite na **Nastavenia** → **Hardware** → **Packet Parser** → **Import**
3. Importujte šablónu s týmito parametrami:
   - **MQTT Broker IP Address:** pre vstavaný broker TapHome `127.0.0.1`, inak IP adresa vášho brokera (napr. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT topic z kroku 1 (napr. `tasmota_XXXXX`)

Po importe uvidíte dve zariadenia: **Permit Join** (prepínač) a **Devices Found** (počítadlo).

### Krok 3 — Spárujte Zigbee zariadenie

1. V TapHome zapnite prepínač **Permit Join** — otvorí sa 60-sekundové okno pre párovanie
2. Na Zigbee zariadení spustite proces párovania (zvyčajne podržte tlačidlo reset 5 sekúnd, kým LED nezačne blikať)
3. Sledujte počítadlo **Devices Found** — zvýši sa, keď sa pripojí nové zariadenie
4. Skontrolujte **Service Attributes** brány, kde uvidíte ID nového zariadenia (napr. `0x1234`), výrobcu a model
5. Režim párovania sa automaticky deaktivuje po uplynutí časového limitu

### Krok 4 — Importujte šablónu zariadenia

1. Stiahnite si šablónu konkrétneho zariadenia z príslušnej stránky kompatibility
2. Importujte šablónu s týmito parametrami:
   - **MQTT Broker IP Address:** rovnaká ako pre bránu
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** rovnaký Tasmota MQTT topic ako vyššie
   - **Device ID:** krátka adresa z párovania (napr. `0x1234`)

## Dostupné zariadenia 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Aqara Water Leak Sensor Modul

Servisné atribúty

|                    |                                                                          |
|--------------------|--------------------------------------------------------------------------|
| IEEEAddr           | Zigbee IEEE adresa — unikátny 64-bitový hardvérový identifikátor snímača |
| ModelId            | Zigbee identifikátor modelu hlásený zariadením (lumi.sensor\_wleak.aq1)  |
| Manufacturer       | Reťazec výrobcu hlásený zariadením cez Zigbee                            |
| Endpoints          | Aktívne Zigbee endpointy na zariadení                                    |
| Config             | Konfiguračný reťazec Zigbee zariadenia                                   |
| Link Quality       | Sila Zigbee signálu — 0 % (žiadny signál) až 100 % (najlepší)            |
| Battery Voltage    | Napätie gombíkovej batérie CR2032 vo voltoch                             |
| Battery Percentage | Odhadovaná úroveň batérie — varovanie pri poklese pod 30 %               |

Vlastné premenné

`GWname` (string) Názov Tasmota MQTT topicu Zigbee brány (nachádza sa v Configuration → MQTT → Topic) 

`ID` (string) = 0xF121 Zigbee krátka adresa snímača úniku vody Aqara (pridelená pri spárovaní)

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

Čítanie (modul)

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

Listener

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

Servisné atribúty

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

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

Battery Percentage

```taphome
BatteryPercentage + "%"
```

Snímač zaplavenia Jazýčkový kontakt Len na čítanie

Detekcia úniku vody cez Zigbee IAS Zone — číta pole ZoneStatusChange zo Zigbee správy snímača. Krytie IP67, prah detekcie 0,5 mm.

boolean

Listener

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".ZoneStatusChange", true);
    if(!ISNULL(val), Rc := val);
end
```

**Pripojenie:** Packet Parser → MQTT

Možné vylepšenia (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.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii                                         | Predvolené      |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Zdroje

- 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

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)