TapHome
Slovenčina

Slovenčina

Čeština Magyar Italiano Polski Deutsch Română Hrvatski English
Oficiálna · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Okrúhly Zigbee snímač teploty a vlhkosti Xiaomi WSDCGQ01LM (CR2032) v TapHome cez MQTT prostredníctvom brány Zigbee2MQTT. Hlási teplotu, relatívnu vlhkosť, stav batérie, napätie batérie a kvalitu Zigbee spojenia. Páruje sa v Zigbee2MQTT cez Permit join a resetovacie tlačidlo.

Zigbee2MQTTPacket Parser → MQTT1 zariadenieRevízia 1.0 Posledná aktualizácia: 10. novembra 2026

Import do aplikácie TapHomeHardvér › Packet Parser › Pridať zo šablóny

Stiahnuť šablónu
Na tejto stránke

Návod na integráciu

Snímač teploty a vlhkosti Xiaomi Mi (model WSDCGQ01LM) je malý okrúhly Zigbee snímač na batériu, určený do interiéru. Meria teplotu okolia a relatívnu vlhkosť a napája ho gombíková batéria CR2032. Zigbee2MQTT ho uvádza aj pod white-label názvami Xiaomi YTC4042GL, YTC4007CN a YTC4018CN. Nejde o hranatý Aqara WSDCGQ11LM, ktorý meria aj tlak vzduchu.

TapHome so snímačom komunikuje nepriamo. WSDCGQ01LM sa páruje so Zigbee koordinátorom, ktorý spravuje brána Zigbee2MQTT, a tá publikuje namerané hodnoty ako JSON na MQTT topikoch. TapHome sa na tieto topiky prihlasuje cez modul Packet Parser MQTT a mapuje ich na jedno zariadenie typu teplotný senzor s hodnotami vlhkosti, batérie a kvality spojenia. Rovnako sa nastavujú aj ďalšie Zigbee2MQTT snímače, napríklad Tuya TS0201 alebo snímač pohybu Aqara RTCGQ11LM.

Požiadavky

  • Zigbee koordinátor — Zigbee adaptér podporovaný v Zigbee2MQTT
  • Brána Zigbee2MQTT — beží na hostiteľskom počítači pri koordinátore
  • MQTT broker — dostupný z hostiteľa Zigbee2MQTT aj z riadiacej jednotky TapHome
  • Riadiaca jednotka TapHome s podporou Packet Parser MQTT

Samotný snímač nemá pripojenie cez Wi-Fi ani Ethernet. Celá IP komunikácia prebieha medzi MQTT brokerom, Zigbee2MQTT a riadiacou jednotkou TapHome. Šablóna očakáva predvolený základný topik Zigbee2MQTT zigbee2mqtt.

Párovanie so Zigbee2MQTT

WSDCGQ01LM je potrebné spárovať s koordinátorom Zigbee2MQTT ešte pred importom šablóny:

  1. Umiestnite snímač blízko Zigbee koordinátora.
  2. Otvorte webové rozhranie Zigbee2MQTT a zapnite režim párovania (Permit join).
  3. Stlačte a podržte resetovacie tlačidlo približne 5 sekúnd, kým nezačne blikať modré svetlo. Resetovacie tlačidlo je malé tlačidlo na vrchnej strane zariadenia.
  4. Snímač sa pripojí automaticky a zobrazí sa v zozname zariadení Zigbee2MQTT so svojou IEEE adresou. Voliteľne mu v nastaveniach zariadenia priraďte friendly name (napríklad bedroom_climate).

Percento batérie sa po spárovaní môže zobraziť až po 24 hodinách — snímač ho hlási len periodicky.

Umiestnenie

Snímač je určený len do interiéru. Môže voľne stáť na požadovanom mieste, alebo sa dá po odstránení ochrannej fólie prilepiť lepiacou nálepkou (náhradná nálepka je súčasťou balenia). Povrch musí byť čistý a suchý. Snímač neupevňujte na kovový povrch.

Voľby zariadenia v Zigbee2MQTT

Zigbee2MQTT ponúka pre tento snímač voľby špecifické pre zariadenie. Prejavia sa pri ďalšom reporte zo zariadenia:

VoľbaPopis
temperature_calibrationAbsolútny posun pripočítaný k hodnote teploty
temperature_precisionPočet desatinných miest teploty (0–3, presnosť môže len znížiť)
humidity_calibrationAbsolútny posun pripočítaný k hodnote vlhkosti
humidity_precisionPočet desatinných miest vlhkosti (0–3, presnosť môže len znížiť)

Konfigurácia

Parametre importu

Pri importe šablóny zadajte adresu MQTT brokera:

ParameterPopisPredvolená hodnota
Mqtt Broker ipAddressIP adresa MQTT brokera192.168.0.1
Mqtt Broker portTCP port MQTT brokera1883

Modul sa prihlasuje na koreňový topik zigbee2mqtt/#.

Premenná modulu

Po importe nastavte premennú modulu Xiaomi_WSDCGQ01LM_1 na identitu snímača v Zigbee2MQTT:

PremennáPopisAko ju získaťPredvolená hodnota v šablóne
Xiaomi_WSDCGQ01LM_1Friendly name alebo IEEE adresa snímača v Zigbee2MQTTWebové rozhranie Zigbee2MQTT → Devices → WSDCGQ01LM → skopírujte friendly name alebo IEEE adresu0x00158d0001823a01

Predvolená hodnota 0x00158d0001823a01 je len príklad. Nahraďte ju friendly name alebo IEEE adresou vášho snímača, inak šablóna nedostane žiadne dáta.

Listener skript reaguje len na správy na topiku zigbee2mqtt/, za ktorým nasleduje hodnota tejto premennej, preto sa hodnota musí presne zhodovať s názvom v Zigbee2MQTT. V aplikácii TapHome sa šablóna pridáva do MQTT rozhrania s týmito parametrami importu a premenná sa potom upravuje v nastaveniach modulu.

Friendly name (napríklad bedroom_climate) sa číta ľahšie ako IEEE adresa. Ak sa friendly name neskôr v Zigbee2MQTT zmení, je potrebné aktualizovať aj premennú v TapHome.

Možnosti zariadenia

Šablóna vytvorí jedno zariadenie Xiaomi WSDCGQ01LM typu teplotný senzor. Aktualizuje sa zo stavovej JSON správy na zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}.

Teplota a vlhkosť

Teplota v °C sa číta z vlastnosti temperature. Relatívna vlhkosť sa číta z vlastnosti humidity, ktorú Zigbee2MQTT publikuje v percentách. Šablóna ju delí 100, pretože TapHome uchováva vlhkosť v rozsahu 0–1 a zobrazuje ju v percentách, takže payload 54.2 sa v TapHome zobrazí ako 54,2 %.

Podľa návodu výrobcu snímač meria:

VeličinaRozsahPresnosť
Teplota-20 °C až 50 °C±0,3 °C
Relatívna vlhkosť10–90 % RH, bez kondenzácie±3 %

Monitorovanie batérie a signálu

Zariadenie má tri servisné atribúty, ktoré sa čítajú z tej istej JSON správy:

  • Battery — zostávajúca kapacita batérie v percentách (0–100 %) z vlastnosti battery, zobrazuje sa napríklad ako 95%
  • Battery voltage — napätie batérie v milivoltoch z vlastnosti voltage, zobrazuje sa napríklad ako 3000mV
  • Atribút — kvalita Zigbee spojenia (LQI) z vlastnosti linkquality, zobrazuje sa s jednotkou lqi; šablóna tento atribút zobrazuje pod názvom Atribút

Battery a Battery voltage zobrazujú -, kým nepríde prvá správa s týmito hodnotami. Atribút kvality spojenia začína na hodnote 0lqi.

Technické parametre

ParameterHodnota
ModelWSDCGQ01LM
Bezdrôtové pripojenieZigbee, 2405–2480 MHz
BatériaCR2032
Rozmery36 × 36 × 11,5 mm

Riešenie problémov

Žiadne dáta v TapHome

  1. Overte, či sa snímač zobrazuje v zozname zariadení Zigbee2MQTT s nedávnym časom „Last seen“.
  2. Overte, či sa premenná Xiaomi_WSDCGQ01LM_1 presne zhoduje s friendly name alebo IEEE adresou a či bola vzorová hodnota 0x00158d0001823a01 nahradená.
  3. Prihláste sa MQTT klientom (napríklad MQTT Explorer) na zigbee2mqtt/# a overte, že na zigbee2mqtt/{friendly_name} prichádzajú JSON správy.
  4. Overte, či sú IP adresa a port brokera z parametrov importu dostupné z riadiacej jednotky TapHome.

Snímač prestane posielať správy alebo opustí sieť

Zariadenia Xiaomi úplne nedodržiavajú štandard Zigbee a občas sa od siete odpoja. Najčastejšie príčiny sú:

  1. Slabý signál — kvalita spojenia pod 20 sa považuje za slabú. Presuňte snímač bližšie ku koordinátoru alebo k Zigbee routeru napájanému zo siete.
  2. Nízke napätie batérie — môže sa to stať, aj keď sa batéria stále javí ako plná. Vyskúšajte inú batériu CR2032.
  3. Nekompatibilný router — o routeroch od výrobcov Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi a niektorých ďalších je známe, že spôsobujú problémy so zariadeniami Xiaomi. Pripojte snímač priamo ku koordinátoru tak, že stlačíte resetovacie tlačidlo, keď je snímač fyzicky blízko koordinátora.

Hodnota vlhkosti v smart rules je medzi 0 a 1

Je to očakávané správanie. TapHome uchováva vlhkosť v rozsahu 0–1 (0,542 = 54,2 %) a aplikácia ju zobrazuje v percentách. V smart rules a vzorcoch používajte hodnotu v rozsahu 0–1.

Dostupné zariadenia 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Xiaomi WSDCGQ01LM Modul
Vlastné premenné
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Teplotný senzor
Servisné atribúty
Battery
Battery voltage
Atribút
Premenná: battery, Premenná: voltage, Premenná: link

Xiaomi WSDCGQ01LM

Listener
if RECEIVEDMSG.TOPIC = "zigbee2mqtt/"+ Xiaomi_WSDCGQ01LM_1 
   VAR payloadTemp := PARSEJSON(RECEIVEDMSG.PAYLOAD, "temperature");
   Te := payloadTemp;
   VAR payloadHum := PARSEJSON(RECEIVEDMSG.PAYLOAD, "humidity");
   Hu := payloadHum/100;
   battery := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery", true);
   voltage := PARSEJSON(RECEIVEDMSG.PAYLOAD,"voltage", true);
   link := PARSEJSON(RECEIVEDMSG.PAYLOAD,"linkquality", true);
end
Servisné atribúty
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Pripojenie: Packet Parser → MQTT

Parametre importu

Tieto hodnoty zadáte pri importe XML.

Pýta sa v aplikáciiPredvolené
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883

Súvisiaca dokumentácia

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Šablóna · portál TapHome Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu. Packet Parser → MQTT Zobraziť v portáli TapHome