TapHome

Aqara Water Leak Sensor

Packet Parser → MQTT
Přidal
Poslední aktualizace: 03. 2026

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Water Leak Sensor

Toto zařízení komunikuje přes Zigbee prostřednictvím brány Tasmota. Ujistěte se, že máte importovanou šablonu 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 dosáhne kontaktních plošek o výšce 0,5 mm na spodní straně zařízení. 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í

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
ParametrPopisPříklad
MQTT Broker IP AddressIP adresa vašeho MQTT brokeru192.168.1.10
MQTT Broker PortPort brokeru (výchozí 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee 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.

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:

AtributPopis
IEEEAddrUnikátní 64bitový hardwarový identifikátor
ModelIdZigbee model ID (lumi.sensor_wleak.aq1)
ManufacturerŘetězec výrobce hlášený zařízením
EndpointsAktivní Zigbee endpointy
ConfigZigbee konfigurace zařízení
Link QualitySí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

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

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 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: IP adresa vašeho MQTT 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.

Krok 2 — Importujte šablonu brány v TapHome

  1. Stáhněte si šablonu brány ze stránky kompatibility 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: 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í

Aqara Water Leak Sensor Modul
Servisní atributy
IEEEAddrZigbee IEEE adresa — unikátní 64bitový hardwarový identifikátor snímače
ModelIdZigbee 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
EndpointsAktivní Zigbee endpointy na zařízení
ConfigKonfigurační řetězec Zigbee zařízení
Link QualitySíla Zigbee signálu — 0 % (žádný signál) až 100 % (nejlepší)
Battery VoltageNapětí knoflíkové baterie CR2032 ve voltech
Battery PercentageOdhadovaná ú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) = 0xF121Zigbee 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

Aqara - Water Leak Sensor

Čtení (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Listener
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
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
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

Snímač zaplavení

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

Zdroje