TapHome
Hrvatski
Slovenčina Čeština Magyar Italiano Polski Deutsch Română

Hrvatski

English
Službeni · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Okrugli Zigbee senzor temperature i vlage Xiaomi WSDCGQ01LM (CR2032) u sustavu TapHome preko MQTT-a putem mosta Zigbee2MQTT. Javlja temperaturu, relativnu vlažnost, razinu baterije, napon baterije i kvalitetu Zigbee veze. Uparuje se u Zigbee2MQTT-u pomoću opcije Permit join i tipke za resetiranje.

Zigbee2MQTTPacket Parser → MQTT1 uređajRevizija 1.0 Posljednje ažuriranje: 10. studenoga 2026.

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Upute za integraciju

Xiaomi Mi Temperature and Humidity Sensor (model WSDCGQ01LM) mali je okrugli Zigbee senzor na bateriju za unutarnju upotrebu. Mjeri temperaturu okoline i relativnu vlažnost, a napaja ga gumbasta baterija CR2032. Zigbee2MQTT ga navodi i pod white label nazivima Xiaomi YTC4042GL, YTC4007CN i YTC4018CN. Nije riječ o četvrtastom senzoru Aqara WSDCGQ11LM, koji mjeri i tlak zraka.

TapHome sa senzorom komunicira neizravno. WSDCGQ01LM se uparuje sa Zigbee koordinatorom kojim upravlja most Zigbee2MQTT, a most očitanja objavljuje kao JSON na MQTT temama. TapHome se na te teme pretplaćuje preko modula Packet Parser MQTT i preslikava ih na jedan uređaj tipa senzor temperature s vrijednostima vlažnosti, baterije i kvalitete veze. Drugi Zigbee2MQTT senzori, na primjer Tuya TS0201 ili senzor pokreta Aqara RTCGQ11LM, postavljaju se na isti način.

Preduvjeti

  • Zigbee koordinator: Zigbee adapter koji podržava Zigbee2MQTT
  • Most Zigbee2MQTT: radi na računalu uz koordinator
  • MQTT broker: dostupan i s računala na kojem radi Zigbee2MQTT i s centralne jedinice TapHome
  • Centralna jedinica TapHome s podrškom za Packet Parser MQTT

Sam senzor nema Wi-Fi ni Ethernet vezu. Sva IP komunikacija odvija se između MQTT brokera, mosta Zigbee2MQTT i centralne jedinice TapHome. Predložak očekuje zadanu osnovnu temu Zigbee2MQTT zigbee2mqtt.

Uparivanje sa Zigbee2MQTT-om

WSDCGQ01LM mora biti uparen s koordinatorom Zigbee2MQTT prije uvoza predloška:

  1. Postavite senzor blizu Zigbee koordinatora.
  2. Otvorite web-sučelje Zigbee2MQTT i uključite način uparivanja (Permit join).
  3. Pritisnite i držite tipku za resetiranje oko 5 sekundi, dok plavo svjetlo ne počne treptati. Tipka za resetiranje je mala tipka na vrhu uređaja.
  4. Senzor se automatski pridružuje mreži i pojavljuje se na popisu uređaja Zigbee2MQTT sa svojom IEEE adresom. Po želji mu u postavkama uređaja dodijelite friendly name (na primjer bedroom_climate).

Nakon uparivanja može proći do 24 sata dok se pojavi postotak baterije jer ga senzor javlja samo povremeno.

Postavljanje

Senzor je namijenjen samo za unutarnju upotrebu. Može slobodno stajati na željenom mjestu ili se, nakon uklanjanja zaštitne folije, može pričvrstiti samoljepivom naljepnicom (dodatna naljepnica nalazi se u pakiranju). Površina mora biti čista i suha. Senzor ne postavljajte na metalnu površinu.

Opcije uređaja u Zigbee2MQTT-u

Zigbee2MQTT za ovaj senzor nudi opcije specifične za uređaj. Primjenjuju se pri sljedećem javljanju uređaja:

OpcijaOpis
temperature_calibrationApsolutni pomak koji se dodaje vrijednosti temperature
temperature_precisionBroj decimalnih mjesta temperature (0–3, preciznost se može samo smanjiti)
humidity_calibrationApsolutni pomak koji se dodaje vrijednosti vlažnosti
humidity_precisionBroj decimalnih mjesta vlažnosti (0–3, preciznost se može samo smanjiti)

Konfiguracija

Parametri uvoza

Pri uvozu predloška unesite adresu MQTT brokera:

ParametarOpisZadano
Mqtt Broker ipAddressIP adresa MQTT brokera192.168.0.1
Mqtt Broker portTCP port MQTT brokera1883

Modul se pretplaćuje na korijensku temu zigbee2mqtt/#.

Varijabla modula

Nakon uvoza postavite varijablu modula Xiaomi_WSDCGQ01LM_1 na identitet senzora u Zigbee2MQTT-u:

VarijablaOpisKako je dobitiZadano u predlošku
Xiaomi_WSDCGQ01LM_1Zigbee2MQTT friendly name ili IEEE adresa senzoraWeb-sučelje Zigbee2MQTT → Devices → WSDCGQ01LM → kopirajte friendly name ili IEEE adresu0x00158d0001823a01

Zadana vrijednost 0x00158d0001823a01 samo je primjer. Umjesto nje upišite friendly name ili IEEE adresu svojeg senzora, inače predložak ne prima podatke.

Listener skripta reagira samo na poruke na temi zigbee2mqtt/ iza koje slijedi vrijednost ove varijable, pa vrijednost mora točno odgovarati nazivu u Zigbee2MQTT-u. U aplikaciji TapHome predložak se s ovim parametrima uvoza dodaje u MQTT sučelje, a varijabla se zatim uređuje u postavkama modula.

Friendly name (na primjer bedroom_climate) čitljiviji je od IEEE adrese. Ako se friendly name kasnije promijeni u Zigbee2MQTT-u, treba ažurirati i varijablu u sustavu TapHome.

Mogućnosti uređaja

Predložak stvara jedan uređaj, Xiaomi WSDCGQ01LM, tipa senzor temperature. Uređaj se ažurira iz JSON poruke stanja na temi zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}.

Temperatura i vlažnost

Temperatura u °C čita se iz svojstva temperature. Relativna vlažnost čita se iz svojstva humidity, koje Zigbee2MQTT objavljuje u postocima. Predložak je dijeli sa 100 jer TapHome vlažnost drži na ljestvici 0–1 i prikazuje je kao postotak, pa se vrijednost 54.2 iz poruke u sustavu TapHome prikazuje kao 54,2 %.

Prema priručniku proizvođača senzor mjeri:

VeličinaRasponTočnost
Temperatura-20 °C do 50 °C±0,3 °C
Relativna vlažnost10–90 % RH, bez kondenzacije±3 %

Praćenje baterije i signala

Uređaj ima tri servisna atributa koji se čitaju iz iste JSON poruke:

  • Battery: preostali kapacitet baterije u postocima (0–100 %) iz svojstva battery, prikazuje se na primjer kao 95%
  • Battery voltage: napon baterije u milivoltima iz svojstva voltage, prikazuje se na primjer kao 3000mV
  • Atribút: kvaliteta Zigbee veze (LQI) iz svojstva linkquality, prikazuje se s jedinicom lqi; predložak ovaj atribut prikazuje pod nazivom Atribút

Battery i Battery voltage prikazuju - dok ne stigne prva poruka s tim vrijednostima. Atribut kvalitete veze počinje s vrijednošću 0lqi.

Tehničke specifikacije

ParametarVrijednost
ModelWSDCGQ01LM
Bežična vezaZigbee, 2405–2480 MHz
BaterijaCR2032
Dimenzije36 × 36 × 11,5 mm

Rješavanje problema

Nema podataka u sustavu TapHome

  1. Provjerite je li senzor na popisu uređaja Zigbee2MQTT s nedavnim vremenom „Last seen”.
  2. Provjerite odgovara li varijabla Xiaomi_WSDCGQ01LM_1 točno nazivu (friendly name) ili IEEE adresi i je li primjer 0x00158d0001823a01 zamijenjen.
  3. MQTT klijentom (na primjer MQTT Explorer) pretplatite se na zigbee2mqtt/# i provjerite stižu li JSON poruke na zigbee2mqtt/{friendly_name}.
  4. Provjerite jesu li IP adresa i port brokera iz parametara uvoza dostupni s centralne jedinice TapHome.

Senzor prestaje slati poruke ili napušta mrežu

Xiaomi uređaji ne poštuju u potpunosti standard Zigbee i ponekad se odspajaju s mreže. Najčešći uzroci su:

  1. Slab signal: kvaliteta veze ispod 20 smatra se slabom. Približite senzor koordinatoru ili Zigbee usmjerivaču s mrežnim napajanjem.
  2. Nizak napon baterije: može se dogoditi i kad se baterija još čini punom. Pokušajte s drugom baterijom CR2032.
  3. Nekompatibilan usmjerivač: poznato je da usmjerivači tvrtki Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi i nekih drugih proizvođača uzrokuju probleme s Xiaomi uređajima. Spojite senzor izravno na koordinator tako da pritisnete tipku za resetiranje dok je senzor fizički blizu koordinatora.

Vrijednost vlažnosti u smart rules je između 0 i 1

To je očekivano. TapHome vlažnost drži na ljestvici 0–1 (0,542 = 54,2 %), a aplikacija je prikazuje u postocima. U smart rules i formulama koristite vrijednost 0–1.

Dostupni uređaji 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Xiaomi WSDCGQ01LM Modul
Prilagođene varijable
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Senzor temperature
Servisni atributi
Battery
Battery voltage
Atribút
Varijabla: battery, Varijabla: voltage, Varijabla: 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
Servisni atributi
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Povezivanje: Packet Parser → MQTT

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883

Povezana dokumentacija

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → MQTT Pogledaj u TapHome portalu