TapHome

Aqara Temperature, Humidity and Pressure Sensor

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

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Temperature, Humidity and Pressure Sensor

Toto zariadenie komunikuje cez Zigbee prostredníctvom brány Tasmota. Uistite sa, že máte importovanú šablónu Zigbee2Tasmota Gateway a vaše zariadenie je spárované.

Aqara WSDCGQ11LM je kompaktný batériový Zigbee senzor, ktorý meria teplotu okolia, relatívnu vlhkosť a atmosférický tlak. S TapHome komunikuje cez MQTT prostredníctvom brány Zigbee2Tasmota — senzor posiela periodické údaje cez topic tele/{gateway}/SENSOR a šablóna parsuje JSON payload ZbReceived.

Senzor je napájaný gombíkovou batériou CR2032. Šablóna monitoruje úroveň a napätie batérie cez servisné atribúty, upozorní keď batéria klesne pod 30 % a deteguje offline stavy zariadenia (upozornenie po 12 hodinách, chyba po 24 hodinách).

Konfigurácia

Párovanie senzora
  1. Na bráne Zigbee2Tasmota aktivujte Permit Join (cez prepínač šablóny brány v TapHome alebo príkazom ZbPermitJoin 1 v konzole Tasmota)
  2. Stlačte a podržte tlačidlo reset na senzore Aqara približne 5 sekúnd, kým nezačne blikať modrá LED
  3. Uvoľnite tlačidlo — senzor by sa mal spárovať do 60 sekúnd
  4. Poznačte si priradené Device ID (napr. 0x1234) zo servisných atribútov brány alebo konzoly Tasmota
Parametre importu

Po spárovaní importujte šablónu zariadenia s týmito parametrami:

ParameterPopisPríklad
MQTT Broker IP AddressIP adresa MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolený 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátka Zigbee adresa z párovania0x1234

Zigbee zariadenia Aqara/Xiaomi nie sú plne kompatibilné so štandardom Zigbee a môžu mať problémy s pripojením k niektorým Zigbee routerom. Medzi známe nekompatibilné routery patria Centralite, General Electric, OSRAM, Sylvania, SmartThings a Securifi. Používajte routery potvrdene kompatibilné so zariadeniami Xiaomi (napr. IKEA TRADFRI).

Schopnosti zariadenia

Teplota a vlhkosť

Zariadenie Temperature and Humidity číta polia Temperature a Humidity z JSON payloadu ZbReceived. Teplota sa hlási v °C ako priama hodnota. Vlhkosť sa hlási ako surové celé číslo (napr. 4520 pre 45,20 %) a v listener skripte sa delí 100, čím vznikne pomer, ktorý TapHome zobrazuje ako percentá.

Obe hodnoty sa aktualizujú vždy, keď senzor odošle správu SENSOR — zvyčajne každých niekoľko minút alebo pri výraznej zmene.

Atmosférický tlak

Zariadenie Pressure číta pole Pressure z JSON payloadu ZbReceived. Hodnota sa hlási v hPa (hektopascaloch) a mapuje sa cez ValueLogTypeConversion zo surového typu 62 na typ tlaku 25 s lineárnou škálou 1:1.

Atmosférický tlak je možné využiť na monitorovanie počasových trendov alebo automatizačné pravidlá založené na nadmorskej výške.

Batéria a stav zariadenia

Modul sprístupňuje niekoľko servisných atribútov plnených mechanizmom ZbInfo (1-hodinový interval cez ReadScript):

  • Battery Percentage — odhadovaná úroveň batérie CR2032. Pri poklese pod 30 % sa zobrazí upozornenie.
  • Battery Voltage — aktuálne napätie batérie vo voltoch.
  • Link Quality — sila Zigbee signálu škálovaná z 0–254 na 0–100 %.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — identifikácia zariadenia a metadáta Zigbee konfigurácie.

Šablóna tiež sleduje LastSeenEpoch z odpovedí ZbInfo. Ak senzor nebol videný viac ako 12 hodín, zobrazí sa upozornenie. Po 24 hodinách sa zobrazí chyba — to znamená, že senzor môže byť offline, mimo dosah alebo má vybitú batériu.

Aktualizácie batérie CR2032 zo Zigbee zariadení môžu trvať až 24 hodín. Náhly pokles nemusí nutne znamenať zlyhanie batérie — počkajte na ďalší cyklus hlásenia.

Ďalšie schopnosti

WSDCGQ11LM tiež podporuje kalibračné offsety pre meranie teploty, vlhkosti a tlaku pre jednotlivé senzory (dostupné v zigbee2mqtt). Napätie batérie je navyše sprístupnené ako entita na úrovni zariadenia v niektorých Zigbee stackoch. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Senzor nehlási dáta
  1. Overte, že brána Zigbee2Tasmota je pripojená k MQTT brokeru a prijíma správy (skontrolujte tele/{GWname}/SENSOR v MQTT klientovi)
  2. Potvrďte, že Device ID v šablóne zodpovedá krátkej adrese priradenej počas párovania (napr. 0x1234)
  3. Skontrolujte servisný atribút Link Quality — hodnoty pod 20 % indikujú slabý Zigbee signál. Presuňte senzor bližšie k bráne alebo pridajte kompatibilný Zigbee router
  4. Stlačte tlačidlo senzora raz pre vynútenie prenosu a overte, že brána prijme správu
Údaj vlhkosti sa zdá nesprávny

Šablóna delí surovú hodnotu Humidity číslom 100 (napr. 4520 sa zmení na 0,4520, zobrazené ako 45,20 %). Ak sa údaj zdá príliš nízky (napr. 0,45 % namiesto 45 %), overte verziu firmvéru Zigbee2Tasmota — niektoré verzie firmvéru hlásia vlhkosť už v percentách, čím je delenie zbytočné.

Zariadenie hlási offline upozornenie
  1. Skontrolujte úroveň batérie — vybitá CR2032 spôsobí, že senzor prestane vysielať
  2. Senzor Aqara je Zigbee koncové zariadenie (nie router) a komunikuje cez blízke Zigbee routery. Ak router vypadne, senzor sa môže stať nedostupným
  3. Skúste stlačiť tlačidlo senzora pre jeho prebudenie a vynútenie opätovného pripojenia k Zigbee sieti
  4. Ak problém pretrváva, znovu spárujte zariadenie podržaním tlačidla reset na 5 sekúnd, kým nezačne blikať modrá LED

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 Temperature, Humidity and Pressure Sensor Modul
Servisné atribúty
IEEEAddrZigbee IEEE adresa — jedinečný 64-bitový hardvérový identifikátor senzora
ModelId
Manufacturer
Endpoints
Config
Kvalita spojeniaSila Zigbee signálu — 0 % (žiadny signál) až 100 % (vynikajúci)
Napätie batérie
Úroveň batérieOdhadovaná úroveň batérie CR2032 — upozornenie pri poklese pod 30 %
Vlastné premenné
GWname (string)Tasmota MQTT topic name of the Zigbee gateway (found in Configuration → MQTT → Topic)
ID (string)Zigbee short address of the Aqara Temperature, Humidity and Pressure Sensor (assigned during pairing)
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 - Temperature, Humidity and Pressure 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 + "%"
Tlak Premenná Len na čítanie

Atmosférický tlak v hPa — vhodný na sledovanie počasia a automatizáciu podľa nadmorskej výšky

numeric Jednotka: hPa

Tlak

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Pressure", true);
    if(!ISNULL(val), Va := val);
end
Teplota a vlhkosť Teplotný senzor Len na čítanie

Kombinovaná teplota vzduchu (°C) a relatívna vlhkosť (%) z jedného Zigbee senzora

temperature + humidity Jednotka: °C / %

Teplota a vlhkosť

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var temp := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Temperature", true);
    var hum := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Humidity", true);
    if (!ISNULL(temp), Te := temp);
    if (!ISNULL(hum), Hu := hum/ 100);
end
Pripojenie: Packet Parser → MQTT
Možné vylepšenia (3)
  • Battery Voltage (device-level) — Battery voltage in mV exposed as a separate entity in zigbee2mqtt. TapHome template reads it as a module-level service attribute instead.
  • Sensor Calibration Offsets — zigbee2mqtt supports per-sensor calibration offsets for temperature, humidity, and pressure. Not configurable in TapHome template.
  • Link Quality (device-level) — LinkQuality is available per SENSOR message but only exposed as a module-level service attribute via ZbInfo polling.

Zdroje