TapHome

Aqara Water Leak Sensor

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 03. 2026

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Water Leak Sensor

Toto zariadenie komunikuje cez Zigbee prostredníctvom brány Tasmota. Uistite sa, že máte importovanú šablónu 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 dosiahne kontaktné plôšky s výškou 0,5 mm na spodnej strane zariadenia. 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

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
ParameterPopisPríklad
MQTT Broker IP AddressIP adresa vášho MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolene 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee krátka adresa zo spárovania0xF121

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

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útPopis
IEEEAddrUnikátny 64-bitový hardvérový identifikátor
ModelIdZigbee model ID (lumi.sensor_wleak.aq1)
ManufacturerReťazec výrobcu hlásený zariadením
EndpointsAktívne Zigbee endpointy
ConfigZigbee konfigurácia zariadenia
Link QualitySila 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

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

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 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: IP adresa vášho MQTT 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.

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

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: 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

Aqara Water Leak Sensor Modul
Servisné atribúty
IEEEAddrZigbee IEEE adresa — unikátny 64-bitový hardvérový identifikátor snímača
ModelIdZigbee identifikátor modelu hlásený zariadením (lumi.sensor_wleak.aq1)
ManufacturerReťazec výrobcu hlásený zariadením cez Zigbee
EndpointsAktívne Zigbee endpointy na zariadení
ConfigKonfiguračný reťazec Zigbee zariadenia
Link QualitySila Zigbee signálu — 0 % (žiadny signál) až 100 % (najlepší)
Battery VoltageNapätie gombíkovej batérie CR2032 vo voltoch
Battery PercentageOdhadovaná ú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) = 0xF121Zigbee 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

Aqara - Water Leak Sensor

Čítanie (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é atribúty
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
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

Snímač zaplavenia

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

Zdroje