---
title: "Aqara Water Leak Sensor"
description: "Zigbee snímač úniku vody IP67 přes bránu Tasmota. Detekce vody při 0,5 mm přes ZoneStatusChange, monitoring baterie a offline stavu. Napájen CR2032."
url: "https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-water-leak-sensor/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","water-leak-detection","security"]
  questions: ["Jak integrovat snímač úniku vody Aqara s TapHome?","Co detekuje šablona Aqara SJCGQ11LM v TapHome?","Jak spárovat snímač úniku vody Aqara s bránou Zigbee2Tasmota?","Proč můj snímač úniku vody Aqara nehlásí stav zaplavení?","Monitoruje šablona snímače úniku vody Aqara úroveň baterie v TapHome?","Jak TapHome detekuje únik vody přes Zigbee?"]
---

# Aqara Water Leak Sensor

Komunikace: Packet Parser → MQTT

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

> Adresa v síti
> 
> U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

> [!IMPORTANT]
> Toto zařízení komunikuje přes **Zigbee** prostřednictvím brány Tasmota. Ujistěte se, že máte
> importovanou šablonu [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/)
> a zařízení spárované před pokračováním.

Aqara Water Leak Sensor (SJCGQ11LM) je kompaktní bateriový Zigbee snímač úniku vody s krytím IP67. Detekuje přítomnost vody, když hladina vody u kontaktních plošek na spodní straně zařízení dosáhne 0,5 mm. TapHome komunikuje se snímačem přes MQTT prostřednictvím brány Zigbee2Tasmota — snímač publikuje hodnotu `ZoneStatusChange` v JSON zprávě `ZbReceived`, když je detekován nebo odstraněn únik vody.

Snímač je napájen knoflíkovou baterií CR2032 (životnost přibližně 2 roky). Šablona monitoruje úroveň a napětí baterie přes servisní atributy, upozorní při poklesu pod 30 % a detekuje offline stav zařízení (varování po 12 hodinách, chyba po 24 hodinách).

## Konfigurace

### Spárování snímače

1. V TapHome zapněte přepínač **Permit Join** v modulu Zigbee2Tasmota Gateway
2. Na snímači stiskněte a podržte tlačítko, dokud nezačne blikat modrá LED, poté uvolněte
3. Počkejte, až se zvýší počítadlo **Devices Found** — Device ID snímače (např. `0xF121`) se zobrazí v servisních atributech brány
4. Importujte tuto šablonu zařízení pomocí Device ID ze spárování

> [!TIP]
> Pokud se spárování nespustí, zkuste podržet logo vody na spodní straně snímače přibližně 10 sekund, dokud třikrát neblikne modrá LED, poté uvolněte.

### Parametry importu

| Parametr | Popis | Příklad |
|----------|-------|---------|
| **MQTT Broker IP Address** | IP adresa vašeho MQTT brokeru | `192.168.1.10` |
| **MQTT Broker Port** | Port brokeru (výchozí 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Zigbee krátká adresa ze spárování | `0xF121` |

## Možnosti zařízení

### Detekce úniku vody

Šablona poskytuje jedno zařízení **Flood Sensor** mapované jako `PacketParserReedContact` (typ 1031) s kapabilitou `FloodSensor`. Zařízení parsuje pole `ZoneStatusChange` z `ZbReceived.{DeviceID}` v MQTT SENSOR zprávě:

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

Snímač se probudí a odešle svůj stav, když voda dosáhne kontaktních plošek o výšce 0,5 mm na spodní straně zařízení, a znovu když se voda odstraní a plošky uschnou.

> [!NOTE]
> Na rozdíl od snímačů dveří/oken, které používají pole `Contact`, snímač úniku vody používá `ZoneStatusChange` — stavové pole Zigbee IAS Zone. Jedná se o standardní mechanismus pro alarmové snímače v protokolu Zigbee.

### Monitoring baterie

Modul sleduje stav baterie prostřednictvím dvou servisních atributů:

- **Battery Percentage** — odhadovaná úroveň nabití CR2032; **varování o nízké baterii** se spustí při poklesu pod 30 %
- **Battery Voltage** — surové napětí článku CR2032 ve voltech

Data o baterii se parsují z polí `BatteryPercentage` a `BatteryVoltage` ve zprávě `ZbReceived`.

### Detekce offline stavu

Šablona monitoruje dostupnost zařízení pomocí časového razítka `LastSeenEpoch` z pollingu `ZbInfo` (každou 1 hodinu):

- **Varování** — zařízení nebylo vidět déle než **12 hodin**
- **Chyba** — zařízení nebylo vidět déle než **24 hodin**

Pomáhá to odhalit situace, kdy snímač ztratil Zigbee konektivitu nebo je baterie zcela vybitá.

### Diagnostické servisní atributy

Modul zpřístupňuje dodatečná Zigbee metadata získaná přes polling `ZbInfo`:

| Atribut | Popis |
|---------|-------|
| **IEEEAddr** | Unikátní 64bitový hardwarový identifikátor |
| **ModelId** | Zigbee model ID (`lumi.sensor_wleak.aq1`) |
| **Manufacturer** | Řetězec výrobce hlášený zařízením |
| **Endpoints** | Aktivní Zigbee endpointy |
| **Config** | Zigbee konfigurace zařízení |
| **Link Quality** | Síla signálu škálovaná od 0–100 % |

### Další možnosti

Aqara SJCGQ11LM také hlásí interní teplotu zařízení přes Zigbee. Kvalita linky (LQI) pro každou zprávu je dostupná v každém SENSOR payloadu, ale momentálně je zpřístupněna pouze na úrovni modulu přes hodinový polling `ZbInfo`. Tyto možnosti mohou být přidány v budoucí aktualizaci šablony.

## Řešení problémů

### Snímač nehlásí stav zaplavení

1. Ověřte, že snímač je spárovaný s bránou Zigbee2Tasmota — zkontrolujte `ZbStatus` v Tasmota konzoli
2. Potvrďte, že **Device ID** v šabloně odpovídá krátké adrese ze spárování (např. `0xF121`)
3. Položte snímač na mokrý povrch pro vyvolání změny stavu — zařízení by mělo publikovat hodnotu `ZoneStatusChange` během několika sekund
4. Použijte MQTT klienta (např. MQTT Explorer) pro přihlášení k `tele/{GWname}/SENSOR` a ověřte, že snímač publikuje zprávy `ZbReceived` s polem `ZoneStatusChange`

### Offline varování navzdory fungujícímu snímači

1. Detekce offline stavu závisí na pollingu `ZbInfo` (hodinově). Pokud snímač neodeslal žádnou zprávu do 12 hodin, zobrazí se varování
2. Bateriová Zigbee zařízení spí mezi událostmi — jedná se o normální chování. Varování se obvykle zruší po další události úniku nebo `ZbInfo` pollingu
3. Pokud varování přetrvává déle než 24 hodin, zkontrolujte baterii (CR2032) a v případě potřeby zařízení znovu spárujte

### Falešné alarmy nebo žádná detekce

1. Ujistěte se, že kontaktní plošky na spodní straně snímače jsou čisté a nejsou znečištěné nečistotami nebo zbytky
2. Snímač vyžaduje minimálně 0,5 mm vody pro spuštění detekce — malé kapky nebo kondenzace nemusí stačit
3. Krytí IP67 znamená, že tělo snímače je vodotěsné, ale detekční plošky musí být v přímém kontaktu s povrchem vody

> [!WARNING]
> Aqara SJCGQ11LM používá knoflíkovou baterii CR2032. Životnost baterie je typicky 2+ roky při běžném používání. Umístění v trvale vlhkém prostředí (např. pod bojlerem nebo u odpadu pračky) může snížit životnost baterie kvůli častějšímu probouzení.

## Jak nainstalovat v TapHome

### Předpoklady

- Zigbee brána s firmwarem Tasmota (např. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker běžící ve vaší lokální síti (vestavěný TapHome broker nebo externí)
- TapHome CCU ve stejné síti

> [!TIP]
> TapHome má vestavěný MQTT broker — aktivujte ho v **Nastavení** → **Hardware** → **MQTT Broker**. Není potřeba žádný další software.

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

1. Nahrajte [firmware Tasmota](https://tasmota.github.io/docs/Getting-Started/) na podporovaný Zigbee koordinátor (např. Sonoff ZBBridge, eWeLink ZB-GW03)
2. Připojte bránu k vaší Wi-Fi síti přes webové rozhraní Tasmota
3. Přejděte na **Configuration** → **Configure MQTT** a nastavte:
   - **Host:** pro vestavěný broker IP adresa TapHome Core (s rezervací IP v routeru → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)), jinak IP adresa vašeho brokeru (např. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapište si název topicu (např. `tasmota_XXXXX`) — budete ho potřebovat při importu šablony

Podrobné pokyny naleznete v [dokumentaci Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Krok 2 — Importujte šablonu brány v TapHome

1. Stáhněte si šablonu brány ze stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/zigbee2tasmota-gateway/)
2. V TapHome přejděte na **Nastavení** → **Hardware** → **Packet Parser** → **Import**
3. Importujte šablonu s těmito parametry:
   - **MQTT Broker IP Address:** pro vestavěný broker TapHome `127.0.0.1`, jinak IP adresa vašeho brokeru (např. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT topic z kroku 1 (např. `tasmota_XXXXX`)

Po importu uvidíte dvě zařízení: **Permit Join** (přepínač) a **Devices Found** (počítadlo).

### Krok 3 — Spárujte Zigbee zařízení

1. V TapHome zapněte přepínač **Permit Join** — otevře se 60sekundové okno pro párování
2. Na Zigbee zařízení spusťte proces párování (typicky podržte tlačítko reset 5 sekund, dokud LED nezačne blikat)
3. Sledujte počítadlo **Devices Found** — zvýší se, když se připojí nové zařízení
4. Zkontrolujte **Service Attributes** brány, kde uvidíte ID nového zařízení (např. `0x1234`), výrobce a model
5. Režim párování se automaticky deaktivuje po uplynutí časového limitu

### Krok 4 — Importujte šablonu zařízení

1. Stáhněte si šablonu konkrétního zařízení z příslušné stránky kompatibility
2. Importujte šablonu s těmito parametry:
   - **MQTT Broker IP Address:** stejná jako pro bránu
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** stejný Tasmota MQTT topic jako výše
   - **Device ID:** krátká adresa z párování (např. `0x1234`)

## Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Aqara Water Leak Sensor Modul

Servisní atributy

|                    |                                                                         |
|--------------------|-------------------------------------------------------------------------|
| IEEEAddr           | Zigbee IEEE adresa — unikátní 64bitový hardwarový identifikátor snímače |
| ModelId            | Zigbee identifikátor modelu hlášený zařízením (lumi.sensor\_wleak.aq1)  |
| Manufacturer       | Řetězec výrobce hlášený zařízením přes Zigbee                           |
| Endpoints          | Aktivní Zigbee endpointy na zařízení                                    |
| Config             | Konfigurační řetězec Zigbee zařízení                                    |
| Link Quality       | Síla Zigbee signálu — 0 % (žádný signál) až 100 % (nejlepší)            |
| Battery Voltage    | Napětí knoflíkové baterie CR2032 ve voltech                             |
| Battery Percentage | Odhadovaná úroveň baterie — varování při poklesu pod 30 %               |

Vlastní proměnné

`GWname` (string) Název Tasmota MQTT topicu Zigbee brány (nachází se v Configuration → MQTT → Topic) 

`ID` (string) = 0xF121 Zigbee krátká adresa snímače úniku vody Aqara (přidělená při spárování)

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

Čtení (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í atributy

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

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

Battery Percentage

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

Snímač zaplavení Jazýčkový kontakt Pouze ke čtení

Detekce úniku vody přes Zigbee IAS Zone — čte pole ZoneStatusChange ze Zigbee zprávy snímače. Krytí IP67, práh detekce 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
```

**Připojení:** Packet Parser → MQTT

Možná vylepšení (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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci                                           | Výchozí         |
|-------------------------------------------------------------|-----------------|
| 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

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)