TapHome
Magyar
Slovenčina Čeština

Magyar

Italiano Polski Deutsch Română Hrvatski English
Hivatalos · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Xiaomi WSDCGQ01LM kerek Zigbee hőmérséklet- és páratartalom-érzékelő (CR2032) a TapHome rendszerben, MQTT-n keresztül, Zigbee2MQTT híddal. Hőmérsékletet, relatív páratartalmat, elemszintet, elemfeszültséget és Zigbee kapcsolatminőséget jelent. A Zigbee2MQTT-ben a Permit join funkcióval és a reset gombbal párosítható.

Zigbee2MQTTPacket Parser → MQTT1 eszközRevízió 1.0 Utoljára frissítve: 2026. november 10.

Importálás a TapHome alkalmazásbaHardver › Packet Parser › Hozzáadás sablonból

Sablon letöltése
Ezen az oldalon

Integrációs útmutató

A Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM modell) kicsi, kerek, elemes Zigbee érzékelő beltéri használatra. A környezeti hőmérsékletet és a relatív páratartalmat méri, és CR2032 gombelemmel működik. A Zigbee2MQTT Xiaomi YTC4042GL, YTC4007CN és YTC4018CN white label néven is felsorolja. Nem azonos a szögletes Aqara WSDCGQ11LM érzékelővel, amely a légnyomást is méri.

A TapHome közvetve kommunikál az érzékelővel. A WSDCGQ01LM egy Zigbee koordinátorral párosodik, amelyet Zigbee2MQTT híd kezel, és ez a mért értékeket JSON formátumban publikálja MQTT topicokon. A TapHome egy Packet Parser MQTT modulon keresztül iratkozik fel ezekre a topicokra, és egyetlen hőmérséklet-érzékelő eszközre képezi le őket páratartalom-, elem- és kapcsolatminőség-értékekkel. Más Zigbee2MQTT érzékelők, például a Tuya TS0201 vagy az Aqara RTCGQ11LM mozgásérzékelő, ugyanígy állíthatók be.

Követelmények

  • Zigbee koordinátor — a Zigbee2MQTT által támogatott Zigbee adapter
  • Zigbee2MQTT híd — a koordinátor melletti hoston fut
  • MQTT broker — elérhető a Zigbee2MQTT hostról és a TapHome vezérlőegységről is
  • TapHome vezérlőegység Packet Parser MQTT támogatással

Magának az érzékelőnek nincs Wi-Fi- vagy Ethernet-kapcsolata. Minden IP-hálózati kommunikáció az MQTT broker, a Zigbee2MQTT és a TapHome vezérlőegység között zajlik. A sablon a Zigbee2MQTT alapértelmezett zigbee2mqtt alaptopicját (base topic) várja.

Párosítás a Zigbee2MQTT-vel

A WSDCGQ01LM-et a sablon importálása előtt párosítani kell a Zigbee2MQTT koordinátorral:

  1. Helyezd az érzékelőt a Zigbee koordinátor közelébe.
  2. Nyisd meg a Zigbee2MQTT webes felületét, és engedélyezd a párosítási módot (Permit join).
  3. Tartsd nyomva a reset gombot körülbelül 5 másodpercig, amíg a kék fény villogni nem kezd. A reset gomb az eszköz tetején lévő kis gomb.
  4. Az érzékelő automatikusan csatlakozik, és az IEEE címével megjelenik a Zigbee2MQTT eszközlistájában. Az eszköz beállításaiban opcionálisan friendly name-et is adhatsz neki (például bedroom_climate).

Az elem százalékos töltöttsége a párosítás után akár 24 órával később jelenik meg — az érzékelő ugyanis csak időnként jelenti.

Elhelyezés

Az érzékelő kizárólag beltéri használatra készült. Szabadon állhat a kívánt helyen, vagy a védőfólia eltávolítása után az öntapadó matricával rögzíthető (a dobozban egy tartalék matrica is van). A felületnek tisztának és száraznak kell lennie. Ne szereld az érzékelőt fémfelületre.

Zigbee2MQTT eszközopciók

A Zigbee2MQTT eszközspecifikus opciókat kínál ehhez az érzékelőhöz. Ezek az eszköz következő jelentésétől lépnek életbe:

OpcióLeírás
temperature_calibrationA hőmérséklet-értékhez hozzáadott abszolút eltolás
temperature_precisionA hőmérséklet tizedesjegyeinek száma (0–3, csak csökkentheti a pontosságot)
humidity_calibrationA páratartalom-értékhez hozzáadott abszolút eltolás
humidity_precisionA páratartalom tizedesjegyeinek száma (0–3, csak csökkentheti a pontosságot)

Konfiguráció

Importálási paraméterek

A sablon importálásakor add meg az MQTT broker címét:

ParaméterLeírásAlapérték
Mqtt Broker ipAddressAz MQTT broker IP-címe192.168.0.1
Mqtt Broker portAz MQTT broker TCP portja1883

A modul a zigbee2mqtt/# gyökértopicra iratkozik fel.

Modulváltozó

Az importálás után állítsd be a Xiaomi_WSDCGQ01LM_1 modulváltozót az érzékelő Zigbee2MQTT-beli azonosítójára:

VáltozóLeírásHogyan szerezhető megAlapérték a sablonban
Xiaomi_WSDCGQ01LM_1Az érzékelő Zigbee2MQTT friendly name-je vagy IEEE címeZigbee2MQTT webes felület → Devices → WSDCGQ01LM → másold ki a friendly name-et vagy az IEEE címet0x00158d0001823a01

A 0x00158d0001823a01 alapérték csak példa. Cseréld le az érzékelőd friendly name-jére vagy IEEE címére, különben a sablon nem kap adatot.

A listener szkript csak azokra az üzenetekre reagál, amelyek topicja zigbee2mqtt/, majd ennek a változónak az értéke, ezért az értéknek pontosan meg kell egyeznie a Zigbee2MQTT-beli névvel. A TapHome alkalmazásban a sablont ezekkel az importálási paraméterekkel adod hozzá az MQTT interfészhez, a változót pedig utána a modul beállításaiban szerkeszted.

A friendly name (például bedroom_climate) könnyebben olvasható, mint az IEEE cím. Ha a friendly name-et később megváltoztatod a Zigbee2MQTT-ben, a TapHome-ban is frissítened kell a változót.

Eszközfunkciók

A sablon egyetlen eszközt hoz létre Xiaomi WSDCGQ01LM néven, hőmérséklet-érzékelő típussal. Az eszköz a zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1} topicon érkező JSON állapotüzenetből frissül.

Hőmérséklet és páratartalom

A hőmérsékletet °C-ban a temperature tulajdonságból olvassa. A relatív páratartalmat a humidity tulajdonságból olvassa, amelyet a Zigbee2MQTT százalékban publikál. A sablon ezt 100-zal elosztja, mert a TapHome a páratartalmat 0–1 skálán tárolja és százalékként jeleníti meg, így az 54.2 payload a TapHome-ban 54,2 %-ként jelenik meg.

A gyártó kézikönyve szerint az érzékelő mérési adatai:

MennyiségTartományPontosság
Hőmérséklet-20 °C – 50 °C±0,3 °C
Relatív páratartalom10–90 % RH, nem kondenzáló±3 %

Elem- és jelfigyelés

Az eszköznek három szervizattribútuma van, amelyeket ugyanabból a JSON üzenetből olvas:

  • Battery — az elem hátralévő töltöttsége százalékban (0–100 %) a battery tulajdonságból, például 95% formában
  • Battery voltage — az elem feszültsége millivoltban a voltage tulajdonságból, például 3000mV formában
  • Atribút — Zigbee kapcsolatminőség (LQI) a linkquality tulajdonságból, lqi mértékegységgel; a sablon ezt az attribútumot Atribút néven jeleníti meg

A Battery és a Battery voltage - értéket mutat, amíg meg nem érkezik az első, ezeket az értékeket tartalmazó üzenet. A kapcsolatminőség-attribútum kezdőértéke 0lqi.

Műszaki adatok

ParaméterÉrték
ModellWSDCGQ01LM
Vezeték nélküli kapcsolatZigbee, 2405–2480 MHz
ElemCR2032
Méretek36 × 36 × 11,5 mm

Hibaelhárítás

Nem érkeznek adatok a TapHome-ba

  1. Ellenőrizd, hogy az érzékelő megjelenik-e a Zigbee2MQTT eszközlistájában friss „Last seen” időponttal.
  2. Ellenőrizd, hogy a Xiaomi_WSDCGQ01LM_1 változó pontosan megegyezik-e a friendly name-mel vagy az IEEE címmel, és hogy lecserélted-e a 0x00158d0001823a01 példaértéket.
  3. Iratkozz fel MQTT klienssel (például MQTT Explorer) a zigbee2mqtt/# topicra, és győződj meg róla, hogy JSON üzenetek érkeznek a zigbee2mqtt/{friendly_name} topicra.
  4. Ellenőrizd, hogy az importálási paraméterekben megadott broker IP-cím és port elérhető-e a TapHome vezérlőegységről.

Az érzékelő nem küld üzeneteket, vagy kilép a hálózatból

A Xiaomi eszközök nem felelnek meg teljesen a Zigbee szabványnak, és néha lecsatlakoznak a hálózatról. A leggyakoribb okok:

  1. Gyenge jel — a 20 alatti kapcsolatminőség gyengének számít. Helyezd az érzékelőt közelebb a koordinátorhoz vagy egy hálózati tápellátású Zigbee routerhez.
  2. Alacsony elemfeszültség — ez akkor is előfordulhat, ha az elem még telinek látszik. Próbálj ki egy másik CR2032 elemet.
  3. Inkompatibilis router — a Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi és néhány más gyártó routereiről ismert, hogy problémákat okoznak a Xiaomi eszközökkel. Csatlakoztasd az érzékelőt közvetlenül a koordinátorhoz: nyomd meg a reset gombot, miközben az érzékelő fizikailag a koordinátor közelében van.

A páratartalom értéke a smart rule-okban 0 és 1 közé esik

Ez a várt viselkedés. A TapHome a páratartalmat 0–1 skálán tárolja (0,542 = 54,2 %), az alkalmazás pedig százalékban jeleníti meg. A smart rule-okban és a képletekben a 0–1 értéket használd.

Elérhető eszközök 1

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Xiaomi WSDCGQ01LM Modul
Egyéni változók
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Hőmérséklet-érzékelő
Szerviz attribútumok
Battery
Battery voltage
Atribút
Változó: battery, Változó: voltage, Változó: link

Xiaomi WSDCGQ01LM

Figyelő
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
Szerviz attribútumok
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Kapcsolat: Packet Parser → MQTT

Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

Az alkalmazás kériAlapérték
Mqtt Broker IP-cím192.168.0.1
Mqtt Broker port1883

Kapcsolódó dokumentáció

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

Sablon · TapHome portál Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba. Packet Parser → MQTT Megnyitás a TapHome portálon