TapHome

Aqara Temperature, Humidity and Pressure Sensor

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

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Temperature, Humidity and Pressure 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 vaše zařízení je spárované.

Aqara WSDCGQ11LM je kompaktní bateriový Zigbee senzor, který měří teplotu okolí, relativní vlhkost a atmosférický tlak. S TapHome komunikuje přes MQTT prostřednictvím brány Zigbee2Tasmota — senzor odesílá periodická měření přes topic tele/{gateway}/SENSOR a šablona parsuje JSON payload ZbReceived.

Senzor je napájen knoflíkovou baterií CR2032. Šablona monitoruje úroveň a napětí baterie přes servisní atributy, upozorní když baterie klesne pod 30 % a detekuje offline stavy zařízení (upozornění po 12 hodinách, chyba po 24 hodinách).

Konfigurace

Párování senzoru
  1. Na bráně Zigbee2Tasmota aktivujte Permit Join (přes přepínač šablony brány v TapHome nebo příkazem ZbPermitJoin 1 v konzoli Tasmota)
  2. Stiskněte a podržte tlačítko reset na senzoru Aqara přibližně 5 sekund, dokud nezačne blikat modrá LED
  3. Uvolněte tlačítko — senzor by se měl spárovat do 60 sekund
  4. Poznamenejte si přidělené Device ID (např. 0x1234) ze servisních atributů brány nebo konzole Tasmota
Parametry importu

Po spárování importujte šablonu zařízení s těmito parametry:

ParametrPopisPříklad
MQTT Broker IP AddressIP adresa MQTT brokeru192.168.1.10
MQTT Broker PortPort brokeru (výchozí 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátká Zigbee adresa z párování0x1234

Zigbee zařízení Aqara/Xiaomi nejsou plně kompatibilní se standardem Zigbee a mohou mít problémy s připojením k některým Zigbee routerům. Mezi známé nekompatibilní routery patří Centralite, General Electric, OSRAM, Sylvania, SmartThings a Securifi. Používejte routery potvrzeně kompatibilní se zařízeními Xiaomi (např. IKEA TRADFRI).

Schopnosti zařízení

Teplota a vlhkost

Zařízení Temperature and Humidity čte pole Temperature a Humidity z JSON payloadu ZbReceived. Teplota se hlásí v °C jako přímá hodnota. Vlhkost se hlásí jako surové celé číslo (např. 4520 pro 45,20 %) a v listener skriptu se dělí 100, čímž vznikne poměr, který TapHome zobrazuje jako procenta.

Obě hodnoty se aktualizují vždy, když senzor odešle zprávu SENSOR — typicky každých několik minut nebo při výrazné změně.

Atmosférický tlak

Zařízení Pressure čte pole Pressure z JSON payloadu ZbReceived. Hodnota se hlásí v hPa (hektopascalech) a mapuje se přes ValueLogTypeConversion ze surového typu 62 na typ tlaku 25 s lineární škálou 1:1.

Atmosférický tlak lze využít k monitorování počasových trendů nebo automatizačním pravidlům založeným na nadmořské výšce.

Baterie a stav zařízení

Modul zpřístupňuje několik servisních atributů plněných mechanismem ZbInfo (1hodinový interval přes ReadScript):

  • Battery Percentage — odhadovaná úroveň baterie CR2032. Při poklesu pod 30 % se zobrazí upozornění.
  • Battery Voltage — aktuální napětí baterie ve voltech.
  • Link Quality — síla Zigbee signálu škálovaná z 0–254 na 0–100 %.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — identifikace zařízení a metadata Zigbee konfigurace.

Šablona také sleduje LastSeenEpoch z odpovědí ZbInfo. Pokud senzor nebyl viděn déle než 12 hodin, zobrazí se upozornění. Po 24 hodinách se zobrazí chyba — to znamená, že senzor může být offline, mimo dosah nebo má vybitou baterii.

Aktualizace baterie CR2032 ze Zigbee zařízení mohou trvat až 24 hodin. Náhlý pokles nemusí nutně znamenat selhání baterie — vyčkejte na další cyklus hlášení.

Další schopnosti

WSDCGQ11LM také podporuje kalibrační offsety pro měření teploty, vlhkosti a tlaku pro jednotlivé senzory (dostupné v zigbee2mqtt). Napětí baterie je navíc zpřístupněno jako entita na úrovni zařízení v některých Zigbee stackách. Tyto schopnosti mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Senzor nehlásí data
  1. Ověřte, že brána Zigbee2Tasmota je připojena k MQTT brokeru a přijímá zprávy (zkontrolujte tele/{GWname}/SENSOR v MQTT klientovi)
  2. Potvrďte, že Device ID v šabloně odpovídá krátké adrese přidělené během párování (např. 0x1234)
  3. Zkontrolujte servisní atribut Link Quality — hodnoty pod 20 % indikují slabý Zigbee signál. Přesuňte senzor blíže k bráně nebo přidejte kompatibilní Zigbee router
  4. Stiskněte tlačítko senzoru jednou pro vynucení přenosu a ověřte, že brána přijme zprávu
Údaj vlhkosti se zdá nesprávný

Šablona dělí surovou hodnotu Humidity číslem 100 (např. 4520 se změní na 0,4520, zobrazené jako 45,20 %). Pokud se údaj zdá příliš nízký (např. 0,45 % místo 45 %), ověřte verzi firmwaru Zigbee2Tasmota — některé verze firmwaru hlásí vlhkost již v procentech, čímž je dělení zbytečné.

Zařízení hlásí offline upozornění
  1. Zkontrolujte úroveň baterie — vybitá CR2032 způsobí, že senzor přestane vysílat
  2. Senzor Aqara je Zigbee koncové zařízení (ne router) a komunikuje přes blízké Zigbee routery. Pokud router vypadne, senzor se může stát nedostupným
  3. Zkuste stisknout tlačítko senzoru pro jeho probuzení a vynucení opětovného připojení k Zigbee síti
  4. Pokud problém přetrvává, znovu spárujte zařízení podržením tlačítka reset na 5 sekund, dokud nezačne blikat modrá LED

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 Temperature, Humidity and Pressure Sensor Modul
Servisní atributy
IEEEAddrZigbee IEEE adresa — jedinečný 64bitový hardwarový identifikátor senzoru
ModelId
Manufacturer
Endpoints
Config
Kvalita spojeníSíla Zigbee signálu — 0 % (žádný signál) až 100 % (vynikající)
Napětí baterie
Úroveň baterieOdhadovaná úroveň baterie CR2032 — upozornění při poklesu pod 30 %
Vlastní proměnné
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

Č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 + "%"
Tlak Proměnná Pouze ke čtení

Atmosférický tlak v hPa — vhodný pro sledování počasí a automatizaci podle nadmořské 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 vlhkost Teplotní senzor Pouze ke čtení

Kombinovaná teplota vzduchu (°C) a relativní vlhkost (%) z jednoho Zigbee senzoru

temperature + humidity Jednotka: °C / %

Teplota a vlhkost

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
Připojení: Packet Parser → MQTT
Možná vylepšení (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