--- title: "Aqara Temperature, Humidity and Pressure Sensor" description: "Monitorujte teplotu, vlhkost a atmosférický tlak přes Zigbee prostřednictvím brány Tasmota. Bateriový senzor s detekcí offline stavu." url: "https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-temperature-humidity-and-pressure-sensor/" language: cs lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","sensor","zigbee","battery-powered","weather"] questions: ["Jak integrovat Aqara WSDCGQ11LM s TapHome?","Co měří šablona senzoru teploty a vlhkosti Aqara v TapHome?","Jak připojit Zigbee senzor Aqara k TapHome přes Tasmota?","Proč se můj senzor Aqara zobrazuje v TapHome jako offline?","Jak spárovat Aqara WSDCGQ11LM s bránou Zigbee2Tasmota?","Monitoruje TapHome úroveň baterie Zigbee senzorů Aqara?"] --- # Aqara Temperature, Humidity and Pressure Sensor Komunikace: Packet Parser → MQTT - [Produktová stránka Aqara](https://www.aqara.com/en/product/temperature-humidity-sensor/) > Adresa v síti > > U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru. > > [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/) ## Návod na integraci > [!IMPORTANT] > Toto zařízení komunikuje přes **Zigbee** prostřednictvím brány Tasmota. Ujistěte se, že máte > importovanou šablonu [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/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: | Parametr | Popis | Příklad | |----------|-------|---------| | MQTT Broker IP Address | IP adresa MQTT brokeru | `192.168.1.10` | | MQTT Broker Port | Port brokeru (výchozí 1883) | `1883` | | Gateway name | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | Device ID | Krátká Zigbee adresa z párování | `0x1234` | > [!WARNING] > 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. > [!TIP] > 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í hodnotu Humidity číslem 100 (např. `45.2` se změní na 0,452, zobrazené jako 45,2 %). Pokud je údaj 100krát vyšší nebo nižší, zkontrolujte hodnotu `Humidity` v konzoli Tasmota — šablona ji očekává v procentech. ### 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 > [!TIP] > 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](https://tasmota.github.io/docs/Getting-Started/) 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:** pro vestavěný broker IP adresa TapHome Core (s rezervací IP v routeru → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)), jinak IP adresa vašeho 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](https://tasmota.github.io/docs/Zigbee/). ### Krok 2 — Importujte šablonu brány v TapHome 1. Stáhněte si šablonu brány ze stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/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:** pro vestavěný broker TapHome `127.0.0.1`, jinak 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í 2 Tato zařízení se po importu zobrazí v TapHome. Aqara Temperature, Humidity and Pressure Sensor Modul Servisní atributy | | | |-----------------|--------------------------------------------------------------------------| | IEEEAddr | Zigbee 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ň baterie | Odhadovaná úroveň baterie CR2032 — upozornění při poklesu pod 30 % | Vlastní proměnné `GWname` (string) Název Tasmota MQTT topicu Zigbee gateway (najdete v Configuration → MQTT → Topic) `ID` (string) Zigbee krátká adresa senzoru (přiřazená během párování) 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 Čtení (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í atributy IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome 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 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 vlhkost Teplotní senzor Pouze ke čtení Kombinovaná teplota vzduchu (°C) a relativní vlhkost (%) z jednoho Zigbee senzoru 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 ``` **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. ## Parametry importu Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |-------------------------------------------------------------|-----------------| | 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 ## Související dokumentace - [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)