--- title: "Aqara Temperature, Humidity and Pressure Sensor" description: "Monitorujte teplotu, vlhkosť a atmosférický tlak cez Zigbee prostredníctvom brány Tasmota. Batériový senzor s detekciou offline stavu." url: "https://taphome.com/sk/compatibility/zigbee2tasmota-aqara-temperature-humidity-and-pressure-sensor/" language: sk lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","sensor","zigbee","battery-powered","weather"] questions: ["Ako integrovať Aqara WSDCGQ11LM s TapHome?","Čo meria šablóna senzora teploty a vlhkosti Aqara v TapHome?","Ako pripojiť Zigbee senzor Aqara k TapHome cez Tasmota?","Prečo sa môj senzor Aqara zobrazuje v TapHome ako offline?","Ako spárovať Aqara WSDCGQ11LM s bránou Zigbee2Tasmota?","Monitoruje TapHome úroveň batérie Zigbee senzorov Aqara?"] --- # Aqara Temperature, Humidity and Pressure Sensor Komunikácia: Packet Parser → MQTT - [Produktová stránka Aqara](https://www.aqara.com/en/product/temperature-humidity-sensor/) > Adresa v sieti > > Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu > [!IMPORTANT] > Toto zariadenie komunikuje cez **Zigbee** prostredníctvom brány Tasmota. Uistite sa, že máte > importovanú šablónu [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/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: | Parameter | Popis | Príklad | |-----------|-------|---------| | MQTT Broker IP Address | IP adresa MQTT brokera | `192.168.1.10` | | MQTT Broker Port | Port brokera (predvolený 1883) | `1883` | | Gateway name | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | Device ID | Krátka Zigbee adresa z párovania | `0x1234` | > [!WARNING] > 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. > [!TIP] > 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í hodnotu Humidity číslom 100 (napr. `45.2` sa zmení na 0,452, zobrazené ako 45,2 %). Ak je údaj 100-krát vyšší alebo nižší, skontrolujte hodnotu `Humidity` v konzole Tasmota — šablóna ju očakáva v percentách. ### 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 > [!TIP] > 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](https://tasmota.github.io/docs/Getting-Started/) 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:** pre vstavaný broker IP adresa TapHome Core (s rezerváciou IP v routeri → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)), inak IP adresa vášho 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](https://tasmota.github.io/docs/Zigbee/). ### Krok 2 — Importujte šablónu brány v TapHome 1. Stiahnite si šablónu brány zo stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/) 2. V TapHome prejdite na **Nastavenia** → **Hardware** → **Packet Parser** → **Import** 3. Importujte šablónu s týmito parametrami: - **MQTT Broker IP Address:** pre vstavaný broker TapHome `127.0.0.1`, inak 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 2 Tieto zariadenia sa po importe zobrazia v TapHome. Aqara Temperature, Humidity and Pressure Sensor Modul Servisné atribúty | | | |------------------|---------------------------------------------------------------------------| | IEEEAddr | Zigbee IEEE adresa — jedinečný 64-bitový hardvérový identifikátor senzora | | ModelId | | | Manufacturer | | | Endpoints | | | Config | | | Kvalita spojenia | Sila Zigbee signálu — 0 % (žiadny signál) až 100 % (vynikajúci) | | Napätie batérie | | | Úroveň batérie | Odhadovaná úroveň batérie CR2032 — upozornenie pri poklese pod 30 % | Vlastné premenné `GWname` (string) Názov Tasmota MQTT topicu Zigbee gateway (nájdete v Configuration → MQTT → Topic) `ID` (string) Zigbee krátka adresa senzora (priradená počas párovania) 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 Čítanie (modul) ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` Listener ```taphome 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 ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome 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 Listener ```taphome 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 / % Listener ```taphome 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. ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |-------------------------------------------------------------|-----------------| | Mqtt Broker IP adresa | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Zdroje - Tasmota Zigbee Documentation [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) 2026-03-29 - Zigbee Compatible Devices Database 2026-03-29 - Aqara Product Page — Temperature and Humidity Sensor [www.aqara.com](https://www.aqara.com/en/product/temperature-humidity-sensor/) 2026-03-29 - Blakadder — Aqara WSDCGQ11LM [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_WSDCGQ11LM.html) 2026-03-29 - zigbee2mqtt — Aqara WSDCGQ11LM [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/WSDCGQ11LM.html) 2026-03-29 ## Súvisiaca dokumentácia - [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/) - [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)