---
title: "Aqara Water Leak Sensor"
description: "Senzor Zigbee IP67 pentru scurgeri de apă prin gateway Tasmota. Detectează apa de la 0,5 mm (ZoneStatusChange), baterie CR2032 și stare offline."
url: "https://taphome.com/ro/compatibility/zigbee2tasmota-aqara-water-leak-sensor/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","water-leak-detection","security"]
  questions: ["Cum integrez senzorul Aqara pentru scurgeri de apă cu TapHome?","Ce detectează șablonul TapHome pentru Aqara SJCGQ11LM?","Cum împerechez senzorul Aqara pentru scurgeri de apă cu un gateway Zigbee2Tasmota?","De ce senzorul meu Aqara pentru scurgeri de apă nu raportează starea de inundație?","Monitorizează șablonul senzorului Aqara pentru scurgeri de apă nivelul bateriei în TapHome?","Cum detectează TapHome scurgerile de apă prin Zigbee?"]
---

# Aqara Water Leak Sensor

Comunicație: Packet Parser → MQTT

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

> Adresa în rețea
> 
> Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este `127.0.0.1` (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

> [!IMPORTANT]
> Acest dispozitiv comunică prin **Zigbee** printr-un gateway Tasmota. Înainte de a continua,
> asigurați-vă că ați importat șablonul [Zigbee2Tasmota Gateway](https://taphome.com/ro/compatibility/zigbee2tasmota-gateway/)
> și ați împerecheat dispozitivul.

Aqara Water Leak Sensor (SJCGQ11LM) este un senzor Zigbee compact pentru scurgeri de apă, cu grad de protecție IP67, alimentat cu baterie. Detectează prezența apei atunci când nivelul apei la contactele de pe partea inferioară a dispozitivului atinge 0,5 mm. TapHome comunică cu senzorul prin MQTT, printr-un gateway Zigbee2Tasmota — senzorul publică valoarea `ZoneStatusChange` în payloadul JSON `ZbReceived` atunci când este detectată o scurgere de apă sau când aceasta dispare.

Senzorul este alimentat de o baterie tip monedă CR2032 (durată de viață de aproximativ 2 ani). Șablonul monitorizează nivelul și tensiunea bateriei prin atribute de service, avertizează când nivelul bateriei scade sub 30 % și detectează starea offline a dispozitivului (avertisment după 12 ore, eroare după 24 de ore).

## Configurare

### Împerecherea senzorului

1. În TapHome, porniți comutatorul **Permit Join** din modulul Zigbee2Tasmota Gateway
2. Pe senzor, țineți apăsat butonul până când LED-ul albastru începe să clipească, apoi eliberați-l
3. Așteptați până când contorul **Dispozitive găsite** crește — Device ID-ul senzorului (de ex. `0xF121`) apare în atributele de service ale gateway-ului
4. Importați acest șablon de dispozitiv folosind Device ID-ul de la împerechere

> [!TIP]
> Dacă împerecherea nu pornește, încercați să țineți apăsat logoul cu picătura de apă de pe partea inferioară a senzorului aproximativ 10 secunde, până când LED-ul albastru clipește de trei ori, apoi eliberați-l.

### Parametrii de import

| Parametru | Descriere | Exemplu |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | Adresa IP a brokerului dvs. MQTT | `192.168.1.10` |
| **MQTT Broker Port** | Portul brokerului (implicit 1883) | `1883` |
| **Gateway name** | Topicul MQTT Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Adresa scurtă Zigbee de la împerechere | `0xF121` |

## Funcțiile dispozitivului

### Detectarea scurgerilor de apă

Șablonul pune la dispoziție un singur dispozitiv **Senzor de inundații**, mapat ca `PacketParserReedContact` (tipul 1031) cu funcția `FloodSensor`. Dispozitivul citește câmpul `ZoneStatusChange` din `ZbReceived.{DeviceID}` din mesajul MQTT SENSOR:

- **ZoneStatusChange = 1** → **Alarmă** (apă detectată)
- **ZoneStatusChange = 0** → **OK** (uscat)

Senzorul se trezește și transmite starea atunci când apa atinge contactele de 0,5 mm de pe partea inferioară a dispozitivului și din nou atunci când apa este îndepărtată și contactele se usucă.

> [!NOTE]
> Spre deosebire de senzorii pentru uși și ferestre, care folosesc câmpul `Contact`, senzorul pentru scurgeri de apă folosește `ZoneStatusChange` — un câmp de stare Zigbee IAS Zone. Acesta este mecanismul standard pentru senzorii de tip alarmă în protocolul Zigbee.

### Monitorizarea bateriei

Modulul urmărește starea bateriei prin două atribute de service:

- **Nivelul bateriei** — nivelul estimat de încărcare al bateriei CR2032; un **avertisment de baterie descărcată** se generează când nivelul scade sub 30 %
- **Tensiunea bateriei** — tensiunea brută a celulei CR2032, în volți

Datele bateriei se citesc din câmpurile `BatteryPercentage` și `BatteryVoltage` din payloadul `ZbReceived`.

### Detectarea stării offline

Șablonul monitorizează disponibilitatea dispozitivului cu ajutorul marcajului de timp `LastSeenEpoch` din interogarea `ZbInfo` (la fiecare oră):

- **Avertisment** — dispozitivul nu a mai trimis niciun mesaj de mai mult de **12 ore**
- **Eroare** — dispozitivul nu a mai trimis niciun mesaj de mai mult de **24 de ore**

Astfel se pot detecta situațiile în care senzorul a pierdut conectivitatea Zigbee sau bateria este complet descărcată.

### Atribute de service pentru diagnosticare

Modulul pune la dispoziție metadate Zigbee suplimentare, obținute prin interogarea `ZbInfo`:

| Atribut | Descriere |
|-----------|-------------|
| **IEEEAddr** | Identificator hardware unic de 64 de biți |
| **ModelId** | ID-ul modelului Zigbee (`lumi.sensor_wleak.aq1`) |
| **Producător** | Șirul cu numele producătorului raportat de dispozitiv |
| **Endpointuri** | Endpointuri Zigbee active |
| **Config** | Configurația Zigbee a dispozitivului |
| **Calitatea legăturii** | Puterea semnalului, scalată la 0–100 % |

### Funcții suplimentare

Aqara SJCGQ11LM raportează prin Zigbee și temperatura internă a dispozitivului. Calitatea legăturii pentru fiecare mesaj (LQI) este disponibilă în fiecare payload SENSOR, dar în prezent este pusă la dispoziție doar la nivel de modul, prin interogarea `ZbInfo` la fiecare oră. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Senzorul nu raportează starea de inundație

1. Verificați dacă senzorul este împerecheat cu gateway-ul Zigbee2Tasmota — verificați `ZbStatus` în consola Tasmota
2. Verificați dacă **Device ID-ul** din șablon corespunde adresei scurte de la împerechere (de ex. `0xF121`)
3. Așezați senzorul pe o suprafață udă pentru a declanșa o schimbare a stării — dispozitivul ar trebui să publice o valoare `ZoneStatusChange` în câteva secunde
4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `tele/{GWname}/SENSOR` și verificați dacă senzorul publică mesaje `ZbReceived` cu câmpul `ZoneStatusChange`

### Avertisment offline deși senzorul funcționează

1. Detectarea stării offline se bazează pe interogarea `ZbInfo` (la fiecare oră). Dacă senzorul nu a trimis niciun mesaj timp de 12 ore, apare un avertisment
2. Dispozitivele Zigbee alimentate cu baterie intră în repaus între evenimente — acesta este un comportament normal. Avertismentul dispare de obicei după următorul eveniment de scurgere sau după următoarea interogare `ZbInfo`
3. Dacă avertismentul persistă mai mult de 24 de ore, verificați bateria (CR2032) și, dacă este necesar, împerecheați din nou dispozitivul

### Alarme false sau lipsa detectării

1. Asigurați-vă că contactele de pe partea inferioară a senzorului sunt curate și nu sunt acoperite de murdărie sau depuneri
2. Senzorul are nevoie de cel puțin 0,5 mm de apă pentru a declanșa detectarea — picăturile mici sau condensul pot să nu fie suficiente
3. Gradul de protecție IP67 înseamnă că carcasa senzorului este etanșă, dar contactele de detectare trebuie să fie în contact direct cu suprafața apei

> [!WARNING]
> Aqara SJCGQ11LM folosește o baterie tip monedă CR2032. Durata de viață a bateriei este de obicei de peste 2 ani la utilizare normală. Amplasarea în medii permanent umede (de ex. sub o centrală termică sau lângă scurgerea unei mașini de spălat) poate reduce durata de viață a bateriei din cauza trezirilor mai frecvente.

## Cum se instalează în TapHome

### Cerințe preliminare

- Gateway Zigbee cu firmware Tasmota (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
- Broker MQTT care rulează în rețeaua dvs. locală (brokerul integrat TapHome sau unul extern)
- TapHome CCU în aceeași rețea

> [!TIP]
> TapHome are un broker MQTT integrat — activați-l în **Setări** → **Hardware** → **MQTT Broker**. Nu este necesar niciun software suplimentar.

### Pasul 1 — Configurați gateway-ul Zigbee Tasmota

1. Încărcați [firmware-ul Tasmota](https://tasmota.github.io/docs/Getting-Started/) pe un coordonator Zigbee acceptat (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
2. Conectați gateway-ul la rețeaua dvs. Wi-Fi prin interfața web Tasmota
3. Accesați **Configuration** → **Configure MQTT** și setați:
   - **Host:** pentru brokerul integrat, adresa IP a unității TapHome Core (cu rezervare IP în router → [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)), altfel adresa IP a brokerului dvs. MQTT (de ex. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** notați numele topicului (de ex. `tasmota_XXXXX`) — veți avea nevoie de el la importul șablonului

Pentru instrucțiuni detaliate, consultați [documentația Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Pasul 2 — Importați șablonul gateway-ului în TapHome

1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate [Zigbee2Tasmota Gateway](https://taphome.com/ro/compatibility/zigbee2tasmota-gateway/)
2. În TapHome, accesați **Setări** → **Hardware** → **Packet Parser** → **Import**
3. Importați șablonul cu acești parametri:
   - **MQTT Broker IP Address:** pentru brokerul integrat TapHome `127.0.0.1`, altfel adresa IP a brokerului dvs. (de ex. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** topicul MQTT Tasmota de la pasul 1 (de ex. `tasmota_XXXXX`)

După import veți vedea două dispozitive: **Permit Join** (comutator) și **Dispozitive găsite** (contor).

### Pasul 3 — Împerecheați un dispozitiv Zigbee

1. În TapHome, porniți comutatorul **Permit Join** — se deschide o fereastră de împerechere de 60 de secunde
2. Pe dispozitivul Zigbee, porniți procedura de împerechere (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
3. Urmăriți contorul **Dispozitive găsite** — crește când se conectează un dispozitiv nou
4. Verificați **atributele de service** ale gateway-ului pentru a vedea ID-ul noului dispozitiv (de ex. `0x1234`), producătorul și modelul
5. Modul de împerechere se dezactivează automat după expirarea timpului

### Pasul 4 — Importați șablonul dispozitivului

1. Descărcați șablonul specific dispozitivului de pe pagina de compatibilitate corespunzătoare
2. Importați șablonul cu acești parametri:
   - **MQTT Broker IP Address:** aceeași ca la gateway
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** același topic MQTT Tasmota ca mai sus
   - **Device ID:** adresa scurtă de la împerechere (de ex. `0x1234`)

## Dispozitive disponibile 1

Aceste dispozitive apar în TapHome după import.

Aqara Water Leak Sensor Modul

Atribute de service

|                     |                                                                                 |
|---------------------|---------------------------------------------------------------------------------|
| IEEEAddr            | Adresa IEEE Zigbee — identificatorul hardware unic de 64 de biți al senzorului  |
| ModelId             | Identificatorul de model Zigbee raportat de dispozitiv (lumi.sensor\_wleak.aq1) |
| Producător          | Șirul cu numele producătorului raportat de dispozitiv prin Zigbee               |
| Endpointuri         | Endpointuri Zigbee active pe dispozitiv                                         |
| Config              | Șirul de configurație Zigbee al dispozitivului                                  |
| Calitatea legăturii | Puterea semnalului Zigbee — de la 0 % (fără semnal) la 100 % (cel mai bun)      |
| Tensiunea bateriei  | Tensiunea bateriei tip monedă CR2032, în volți                                  |
| Nivelul bateriei    | Nivelul estimat al bateriei — avertisment sub 30 %                              |

Variabile personalizate

`GWname` (string) Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic) 

`ID` (string) = 0xF121 Adresa scurtă Zigbee a senzorului Aqara Water Leak Sensor (atribuită la împerechere)

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

Citire (modul)

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

Ascultător

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

Atribute de service

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

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

Battery Percentage

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

Senzor de inundații Contact reed Doar citire

Detectarea scurgerilor de apă prin Zigbee IAS Zone — citește câmpul ZoneStatusChange din mesajul Zigbee al senzorului. Grad de protecție IP67, prag de detectare 0,5 mm.

boolean

Ascultător

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

**Conexiune:** Packet Parser → MQTT

Îmbunătățiri posibile (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.

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație                                      | Implicit        |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker Adresă IP                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Surse

- 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

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)

