TapHome
Čeština
Slovenčina

Čeština

Magyar Italiano Polski Deutsch Română Hrvatski English
Oficiální · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Kulatý Zigbee senzor teploty a vlhkosti Xiaomi WSDCGQ01LM (CR2032) v TapHome přes MQTT prostřednictvím brány Zigbee2MQTT. Hlásí teplotu, relativní vlhkost, stav baterie, napětí baterie a kvalitu Zigbee spojení. Páruje se v Zigbee2MQTT přes Permit join a resetovací tlačítko.

Zigbee2MQTTPacket Parser → MQTT1 zařízeníRevize 1.0 Poslední aktualizace: 10. listopadu 2026

Import do aplikace TapHomeHardware › Packet Parser › Přidat ze šablony

Stáhnout šablonu
Na této stránce

Návod na integraci

Senzor teploty a vlhkosti Xiaomi Mi (model WSDCGQ01LM) je malý kulatý Zigbee snímač na baterii, určený do interiéru. Měří teplotu okolí a relativní vlhkost a napájí ho knoflíková baterie CR2032. Zigbee2MQTT ho uvádí také pod white-label názvy Xiaomi YTC4042GL, YTC4007CN a YTC4018CN. Nejde o hranatý Aqara WSDCGQ11LM, který měří i tlak vzduchu.

TapHome komunikuje se snímačem nepřímo. WSDCGQ01LM se páruje se Zigbee koordinátorem, který spravuje brána Zigbee2MQTT, a ta publikuje naměřené hodnoty jako JSON na MQTT topicích. TapHome se k těmto topicům přihlašuje přes modul Packet Parser MQTT a mapuje je na jedno zařízení typu teplotní senzor s hodnotami vlhkosti, baterie a kvality spojení. Stejně se nastavují i další Zigbee2MQTT snímače, například Tuya TS0201 nebo snímač pohybu Aqara RTCGQ11LM.

Požadavky

  • Zigbee koordinátor — Zigbee adaptér podporovaný v Zigbee2MQTT
  • Brána Zigbee2MQTT — běží na hostitelském počítači u koordinátoru
  • MQTT broker — dostupný z hostitele Zigbee2MQTT i z řídicí jednotky TapHome
  • Řídicí jednotka TapHome s podporou Packet Parser MQTT

Samotný snímač nemá připojení přes Wi-Fi ani Ethernet. Veškerá IP komunikace probíhá mezi MQTT brokerem, Zigbee2MQTT a řídicí jednotkou TapHome. Šablona očekává výchozí základní topic Zigbee2MQTT zigbee2mqtt.

Párování se Zigbee2MQTT

WSDCGQ01LM je nutné spárovat s koordinátorem Zigbee2MQTT ještě před importem šablony:

  1. Umístěte snímač blízko Zigbee koordinátoru.
  2. Otevřete webové rozhraní Zigbee2MQTT a zapněte režim párování (Permit join).
  3. Stiskněte a podržte resetovací tlačítko přibližně 5 sekund, dokud nezačne blikat modré světlo. Resetovací tlačítko je malé tlačítko na horní straně zařízení.
  4. Snímač se připojí automaticky a zobrazí se v seznamu zařízení Zigbee2MQTT se svou IEEE adresou. Volitelně mu v nastavení zařízení přiřaďte friendly name (například bedroom_climate).

Procento baterie se po spárování může zobrazit až po 24 hodinách — snímač ho hlásí jen periodicky.

Umístění

Snímač je určen pouze do interiéru. Může volně stát na požadovaném místě, nebo ho lze po odstranění ochranné fólie přilepit lepicí samolepkou (náhradní samolepka je součástí balení). Povrch musí být čistý a suchý. Snímač neupevňujte na kovový povrch.

Volby zařízení v Zigbee2MQTT

Zigbee2MQTT nabízí pro tento snímač volby specifické pro zařízení. Projeví se při dalším reportu ze zařízení:

VolbaPopis
temperature_calibrationAbsolutní posun přičtený k hodnotě teploty
temperature_precisionPočet desetinných míst teploty (0–3, přesnost může pouze snížit)
humidity_calibrationAbsolutní posun přičtený k hodnotě vlhkosti
humidity_precisionPočet desetinných míst vlhkosti (0–3, přesnost může pouze snížit)

Konfigurace

Parametry importu

Při importu šablony zadejte adresu MQTT brokeru:

ParametrPopisVýchozí hodnota
Mqtt Broker ipAddressIP adresa MQTT brokeru192.168.0.1
Mqtt Broker portTCP port MQTT brokeru1883

Modul se přihlašuje ke kořenovému topicu zigbee2mqtt/#.

Proměnná modulu

Po importu nastavte proměnnou modulu Xiaomi_WSDCGQ01LM_1 na identitu snímače v Zigbee2MQTT:

ProměnnáPopisJak ji získatVýchozí hodnota v šabloně
Xiaomi_WSDCGQ01LM_1Friendly name nebo IEEE adresa snímače v Zigbee2MQTTWebové rozhraní Zigbee2MQTT → Devices → WSDCGQ01LM → zkopírujte friendly name nebo IEEE adresu0x00158d0001823a01

Výchozí hodnota 0x00158d0001823a01 je pouze příklad. Nahraďte ji friendly name nebo IEEE adresou vašeho snímače, jinak šablona nedostane žádná data.

Listener skript reaguje jen na zprávy na topicu zigbee2mqtt/, za kterým následuje hodnota této proměnné, proto se hodnota musí přesně shodovat s názvem v Zigbee2MQTT. V aplikaci TapHome se šablona přidává do MQTT rozhraní s těmito parametry importu a proměnná se pak upravuje v nastavení modulu.

Friendly name (například bedroom_climate) se čte snáz než IEEE adresa. Pokud se friendly name později v Zigbee2MQTT změní, je nutné aktualizovat i proměnnou v TapHome.

Možnosti zařízení

Šablona vytvoří jedno zařízení Xiaomi WSDCGQ01LM typu teplotní senzor. Aktualizuje se ze stavové JSON zprávy na zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}.

Teplota a vlhkost

Teplota v °C se čte z vlastnosti temperature. Relativní vlhkost se čte z vlastnosti humidity, kterou Zigbee2MQTT publikuje v procentech. Šablona ji dělí 100, protože TapHome uchovává vlhkost v rozsahu 0–1 a zobrazuje ji v procentech, takže payload 54.2 se v TapHome zobrazí jako 54,2 %.

Podle návodu výrobce snímač měří:

VeličinaRozsahPřesnost
Teplota-20 °C až 50 °C±0,3 °C
Relativní vlhkost10–90 % RH, bez kondenzace±3 %

Monitorování baterie a signálu

Zařízení má tři servisní atributy, které se čtou ze stejné JSON zprávy:

  • Battery — zbývající kapacita baterie v procentech (0–100 %) z vlastnosti battery, zobrazuje se například jako 95%
  • Battery voltage — napětí baterie v milivoltech z vlastnosti voltage, zobrazuje se například jako 3000mV
  • Atribút — kvalita Zigbee spojení (LQI) z vlastnosti linkquality, zobrazuje se s jednotkou lqi; šablona tento atribut zobrazuje pod názvem Atribút

Battery a Battery voltage zobrazují -, dokud nepřijde první zpráva s těmito hodnotami. Atribut kvality spojení začíná na hodnotě 0lqi.

Technické parametry

ParametrHodnota
ModelWSDCGQ01LM
Bezdrátové připojeníZigbee, 2405–2480 MHz
BaterieCR2032
Rozměry36 × 36 × 11,5 mm

Řešení problémů

Žádná data v TapHome

  1. Ověřte, že se snímač zobrazuje v seznamu zařízení Zigbee2MQTT s nedávným časem „Last seen“.
  2. Ověřte, že se proměnná Xiaomi_WSDCGQ01LM_1 přesně shoduje s friendly name nebo IEEE adresou a že byla vzorová hodnota 0x00158d0001823a01 nahrazena.
  3. Přihlaste se MQTT klientem (například MQTT Explorer) k zigbee2mqtt/# a ověřte, že na zigbee2mqtt/{friendly_name} přicházejí JSON zprávy.
  4. Ověřte, že jsou IP adresa a port brokeru z parametrů importu dostupné z řídicí jednotky TapHome.

Snímač přestane posílat zprávy nebo opustí síť

Zařízení Xiaomi plně nedodržují standard Zigbee a občas se od sítě odpojí. Nejčastější příčiny jsou:

  1. Slabý signál — kvalita spojení pod 20 se považuje za slabou. Přesuňte snímač blíž ke koordinátoru nebo k Zigbee routeru napájenému ze sítě.
  2. Nízké napětí baterie — může se to stát, i když se baterie stále jeví jako plná. Vyzkoušejte jinou baterii CR2032.
  3. Nekompatibilní router — o routerech od výrobců Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi a některých dalších je známo, že způsobují problémy se zařízeními Xiaomi. Připojte snímač přímo ke koordinátoru tak, že stisknete resetovací tlačítko, když je snímač fyzicky blízko koordinátoru.

Hodnota vlhkosti ve smart rules je mezi 0 a 1

Jde o očekávané chování. TapHome uchovává vlhkost v rozsahu 0–1 (0,542 = 54,2 %) a aplikace ji zobrazuje v procentech. Ve smart rules a vzorcích používejte hodnotu v rozsahu 0–1.

Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Xiaomi WSDCGQ01LM Modul
Vlastní proměnné
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Teplotní senzor
Servisní atributy
Battery
Battery voltage
Atribút
Proměnná: battery, Proměnná: voltage, Proměnná: 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í atributy
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Připojení: Packet Parser → MQTT

Parametry importu

Tyto hodnoty zadáte při importu XML.

Ptá se v aplikaciVýchozí
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883

Související dokumentace

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Šablona · portál TapHome Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu. Packet Parser → MQTT Zobrazit v portálu TapHome