TapHome

Aqara Temperature, Humidity and Pressure Sensor

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 03. 2026

Külső átjáró szükséges

tasmota zigbee2tasmota-gateway — termékoldal

Aqara Temperature, Humidity and Pressure Sensor

Ez az eszköz Zigbee-n keresztül kommunikál egy Tasmota átjárón át. Győződj meg róla, hogy a Zigbee2Tasmota Gateway sablon importálva van és az eszközöd párosítva van.

Az Aqara WSDCGQ11LM egy kompakt, elemmel működő Zigbee szenzor, amely a környezeti hőmérsékletet, relatív páratartalmat és légköri nyomást méri. A TapHome-mal MQTT-n keresztül kommunikál egy Zigbee2Tasmota átjárón át — a szenzor periodikus méréseket küld a tele/{gateway}/SENSOR topicon, a sablon pedig a ZbReceived JSON payloadot elemzi.

A szenzort egy CR2032 gombelem táplálja. A sablon szervizattribútumokon keresztül figyeli az elemszintet és -feszültséget, figyelmeztet ha az elem 30 % alá csökken, és észleli az eszköz offline állapotait (figyelmeztetés 12 óra után, hiba 24 óra után).

Konfiguráció

A szenzor párosítása
  1. A Zigbee2Tasmota átjárón aktiváld a Permit Join funkciót (a TapHome-ban az átjáró sablon kapcsolójával vagy a Tasmota konzol ZbPermitJoin 1 parancsával)
  2. Tartsd lenyomva a reset gombot az Aqara szenzoron körülbelül 5 másodpercig, amíg a kék LED villogni nem kezd
  3. Engedd el a gombot — a szenzornak 60 másodpercen belül párosodnia kell
  4. Jegyezd fel a hozzárendelt Device ID-t (pl. 0x1234) az átjáró szervizattribútumaiból vagy a Tasmota konzolból
Importparaméterek

Párosítás után importáld az eszközsablont ezekkel a paraméterekkel:

ParaméterLeírásPélda
MQTT Broker IP AddressAz MQTT broker IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDRövid Zigbee cím a párosításból0x1234

Az Aqara/Xiaomi Zigbee eszközök nem teljesen felelnek meg a Zigbee szabványnak, és bizonyos Zigbee routerekkel kapcsolódási problémák léphetnek fel. Ismert inkompatibilis routerek: Centralite, General Electric, OSRAM, Sylvania, SmartThings és Securifi. Használj Xiaomi eszközökkel igazoltan kompatibilis routereket (pl. IKEA TRADFRI).

Eszközképességek

Hőmérséklet és páratartalom

A Temperature and Humidity eszköz a ZbReceived JSON payloadból olvassa a Temperature és Humidity mezőket. A hőmérséklet °C-ban, közvetlen értékként jelenik meg. A páratartalom nyers egész számként érkezik (pl. 4520 = 45,20 %), és a listener szkript 100-zal osztja el, hogy a TapHome által százalékként megjelenített arányt kapja.

Mindkét érték frissül, amikor a szenzor SENSOR üzenetet küld — jellemzően percenként vagy jelentős változáskor.

Légköri nyomás

A Pressure eszköz a ZbReceived JSON payloadból olvassa a Pressure mezőt. Az érték hPa-ban (hektopascal) jelenik meg, és a ValueLogTypeConversion segítségével a 62-es nyers típusról a 25-ös nyomás típusra képeződik le 1:1 lineáris skálával.

A légköri nyomás felhasználható időjárási trendek figyelésére vagy tengerszint feletti magasságon alapuló automatizálási szabályokhoz.

Elem és eszközállapot

A modul több szervizattribútumot tesz elérhetővé, amelyeket a ZbInfo lekérdezési mechanizmus tölt fel (1 órás intervallummal a ReadScript-en keresztül):

  • Battery Percentage — becsült CR2032 elemszint. 30 % alá csökkenés esetén figyelmeztetés jelenik meg.
  • Battery Voltage — aktuális elemfeszültség voltban.
  • Link Quality — Zigbee jelerősség 0–254-ről 0–100 %-ra skálázva.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — eszközazonosítás és Zigbee konfigurációs metaadatok.

A sablon a ZbInfo válaszokból a LastSeenEpoch értéket is nyomon követi. Ha a szenzort több mint 12 órája nem látta, figyelmeztetés jelenik meg. 24 óra után hiba jelenik meg — ez azt jelzi, hogy a szenzor offline lehet, hatótávolságon kívül van, vagy az eleme lemerült.

A CR2032 elem frissítései Zigbee eszközökről akár 24 órát is igénybe vehetnek. A hirtelen csökkenés nem feltétlenül jelenti az elem meghibásodását — várd meg a következő jelentési ciklust.

További képességek

A WSDCGQ11LM szenzorenkénti kalibrációs offseteket is támogat a hőmérséklet, páratartalom és nyomás mérésekhez (elérhető a zigbee2mqtt-ban). Az elemfeszültség egyes Zigbee stackekben eszközszintű entitásként is elérhető. Ezek a képességek egy jövőbeli sablonfrissítésben kerülhetnek hozzáadásra.

Hibaelhárítás

A szenzor nem küld adatokat
  1. Ellenőrizd, hogy a Zigbee2Tasmota átjáró csatlakozik-e az MQTT brokerhez és fogad-e üzeneteket (ellenőrizd a tele/{GWname}/SENSOR topicot egy MQTT kliensben)
  2. Győződj meg róla, hogy a sablonban lévő Device ID megegyezik a párosítás során kiosztott rövid címmel (pl. 0x1234)
  3. Ellenőrizd a Link Quality szervizattribútumot — a 20 % alatti értékek gyenge Zigbee jelet jeleznek. Helyezd a szenzort közelebb az átjáróhoz, vagy adj hozzá egy kompatibilis Zigbee router eszközt
  4. Nyomd meg egyszer a szenzor gombját az adás kikényszerítéséhez, és ellenőrizd, hogy az átjáró fogadja-e az üzenetet
A páratartalom érték hibásnak tűnik

A sablon a nyers Humidity értéket 100-zal osztja (pl. 4520-ból 0,4520 lesz, 45,20 %-ként megjelenítve). Ha az érték túl alacsonynak tűnik (pl. 0,45 % 45 % helyett), ellenőrizd a Zigbee2Tasmota firmware verziót — egyes firmware verziók a páratartalmat már százalékos formátumban jelentik, így az osztás felesleges.

Az eszköz offline figyelmeztetést jelez
  1. Ellenőrizd az elemszintet — a lemerült CR2032 miatt a szenzor leáll az adáshoz
  2. Az Aqara szenzor Zigbee végeszköz (nem router), és a közeli Zigbee router eszközökön keresztül kommunikál. Ha egy router kiesik, a szenzor elérhetetlenné válhat
  3. Próbáld megnyomni a szenzor gombját az ébresztéshez és a Zigbee hálózathoz való újra csatlakozás kikényszerítéséhez
  4. Ha a probléma továbbra is fennáll, párosítsd újra az eszközt a reset gomb 5 másodpercig tartó lenyomásával, amíg a kék LED villogni nem kezd

Telepítés a TapHome-ban

Előfeltételek

  • Zigbee átjáró Tasmota firmware-rel (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker a helyi hálózaton (TapHome beépített broker vagy külső)
  • TapHome CCU ugyanazon a hálózaton

A TapHome rendelkezik beépített MQTT brokerrel — aktiválja a Beállítások → Hardware → MQTT Broker menüpontban. Nincs szükség további szoftverre.

1. lépés — Tasmota Zigbee átjáró beállítása

  1. Telepítse a Tasmota firmware-t egy támogatott Zigbee koordinátorra (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Csatlakoztassa az átjárót a Wi-Fi hálózathoz a Tasmota webes felületén
  3. Navigáljon a Configuration → Configure MQTT menüpontra és állítsa be:
    • Host: az MQTT broker IP-címe (pl. 192.168.1.10)
    • Port: 1883
    • Topic: jegyezze fel a topic nevét (pl. tasmota_XXXXX) — szükség lesz rá a sablon importálásakor

Részletes útmutatót a Tasmota Zigbee dokumentációban talál.

2. lépés — Átjáró sablon importálása a TapHome-ba

  1. Töltse le az átjáró sablont a Zigbee2Tasmota Gateway kompatibilitási oldalról
  2. A TapHome-ban lépjen a Beállítások → Hardware → Packet Parser → Import menüpontra
  3. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: a broker IP-címe (pl. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: a Tasmota MQTT topic az 1. lépésből (pl. tasmota_XXXXX)

Importálás után két eszköz jelenik meg: Permit Join (kapcsoló) és Devices Found (számláló).

3. lépés — Zigbee eszköz párosítása

  1. A TapHome-ban kapcsolja be a Permit Join kapcsolót — megnyílik egy 60 másodperces párosítási ablak
  2. A Zigbee eszközön indítsa el a párosítási folyamatot (jellemzően tartsa lenyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd)
  3. Figyelje a Devices Found számlálót — növekszik, amikor új eszköz csatlakozik
  4. Ellenőrizze az átjáró Service Attributes részét az új eszköz azonosítójának (pl. 0x1234), gyártójának és modelljének megtekintéséhez
  5. A párosítási mód automatikusan deaktiválódik az időkorlát lejártakor

4. lépés — Eszközsablon importálása

  1. Töltse le az eszközspecifikus sablont a megfelelő kompatibilitási oldalról
  2. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: ugyanaz, mint az átjáróé
    • MQTT Broker Port: 1883
    • Gateway name: ugyanaz a Tasmota MQTT topic, mint fentebb
    • Device ID: a párosításból kapott rövid cím (pl. 0x1234)

Elérhető eszközök

Aqara Temperature, Humidity and Pressure Sensor Modul
Szerviz attribútumok
IEEEAddrZigbee IEEE cím — a szenzor egyedi 64 bites hardverazonosítója
ModelId
Manufacturer
Endpoints
Config
Kapcsolat minőségeZigbee jelerősség — 0 % (nincs jel) – 100 % (kiváló)
Elem feszültség
ElemszintBecsült CR2032 elemszint — figyelmeztetés 30 % alatt
Egyéni változók
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

Olvasás (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Figyelő
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
Szerviz attribútumok
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Nyomás Változó Csak olvasható

Légköri nyomás hPa-ban — hasznos időjárás-figyeléshez és tengerszint feletti magasságon alapuló automatizáláshoz

numeric Egység: hPa

Nyomás

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Pressure", true);
    if(!ISNULL(val), Va := val);
end
Hőmérséklet és páratartalom Hőmérséklet-érzékelő Csak olvasható

Kombinált léghőmérséklet (°C) és relatív páratartalom (%) egyetlen Zigbee szenzorból

temperature + humidity Egység: °C / %

Hőmérséklet és páratartalom

Figyelő
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
Kapcsolat: Packet Parser → MQTT
Lehetséges fejlesztések (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.

Források