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

Română

Hrvatski English
Oficial · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Senzor rotund Zigbee de temperatură și umiditate Xiaomi WSDCGQ01LM (CR2032) în TapHome prin MQTT, cu ajutorul punții Zigbee2MQTT. Raportează temperatura, umiditatea relativă, nivelul și tensiunea bateriei și calitatea legăturii Zigbee. Se asociază în Zigbee2MQTT cu Permit join și butonul de resetare.

Zigbee2MQTTPacket Parser → MQTT1 dispozitivRevizia 1.0 Ultima actualizare: 10 noiembrie 2026

Import în aplicația TapHomeHardware › Packet Parser › Adăugați din șablon

Descărcați șablon
Pe această pagină

Ghid de integrare

Xiaomi Mi Temperature and Humidity Sensor (model WSDCGQ01LM) este un senzor Zigbee mic, rotund, alimentat cu baterie, destinat utilizării în interior. Măsoară temperatura ambiantă și umiditatea relativă și funcționează cu o baterie tip monedă CR2032. Zigbee2MQTT îl listează și sub denumirile white-label Xiaomi YTC4042GL, YTC4007CN și YTC4018CN. Nu este același dispozitiv cu senzorul pătrat Aqara WSDCGQ11LM, care măsoară și presiunea atmosferică.

TapHome comunică indirect cu senzorul. WSDCGQ01LM se asociază cu un coordonator Zigbee gestionat de o punte Zigbee2MQTT, care publică valorile măsurate ca JSON pe topicuri MQTT. TapHome se abonează la aceste topicuri printr-un modul Packet Parser MQTT și le atribuie unui singur dispozitiv de tip senzor de temperatură, cu valori de umiditate, baterie și calitate a legăturii. Alți senzori Zigbee2MQTT, de exemplu Tuya TS0201 sau senzorul de mișcare Aqara RTCGQ11LM, se configurează la fel.

Cerințe

  • Coordonator Zigbee — un adaptor Zigbee compatibil cu Zigbee2MQTT
  • Punte Zigbee2MQTT — rulează pe un host aflat lângă coordonator
  • Broker MQTT — accesibil atât de pe hostul Zigbee2MQTT, cât și de pe unitatea de control TapHome
  • Unitate de control TapHome cu suport Packet Parser MQTT

Senzorul în sine nu are conexiune Wi-Fi sau Ethernet. Întreaga comunicație în rețeaua IP are loc între brokerul MQTT, Zigbee2MQTT și unitatea de control TapHome. Șablonul presupune topicul de bază implicit al Zigbee2MQTT, zigbee2mqtt.

Asocierea cu Zigbee2MQTT

WSDCGQ01LM trebuie asociat cu coordonatorul Zigbee2MQTT înainte de importul șablonului:

  1. Așezați senzorul aproape de coordonatorul Zigbee.
  2. Deschideți interfața web Zigbee2MQTT și activați modul de asociere (Permit join).
  3. Țineți apăsat butonul de resetare aproximativ 5 secunde, până când lumina albastră începe să clipească. Butonul de resetare este butonul mic de pe partea superioară a dispozitivului.
  4. Senzorul se conectează automat și apare în lista de dispozitive Zigbee2MQTT cu adresa sa IEEE. Opțional, îi puteți atribui un friendly name în setările dispozitivului (de exemplu bedroom_climate).

Procentul bateriei poate apărea abia după până la 24 de ore de la asociere — senzorul îl raportează doar periodic.

Amplasare

Senzorul este destinat exclusiv utilizării în interior. Poate sta liber în locul dorit sau poate fi fixat cu autocolantul adeziv, după îndepărtarea foliei de protecție (în cutie este inclus un autocolant suplimentar). Suprafața trebuie să fie curată și uscată. Nu montați senzorul pe o suprafață metalică.

Opțiunile dispozitivului în Zigbee2MQTT

Zigbee2MQTT oferă opțiuni specifice pentru acest senzor. Ele intră în vigoare la următorul raport al dispozitivului:

OpțiuneDescriere
temperature_calibrationDecalaj absolut adăugat la valoarea temperaturii
temperature_precisionNumărul de zecimale pentru temperatură (0–3, poate doar reduce precizia)
humidity_calibrationDecalaj absolut adăugat la valoarea umidității
humidity_precisionNumărul de zecimale pentru umiditate (0–3, poate doar reduce precizia)

Configurare

Parametri de import

La importul șablonului, introduceți adresa brokerului MQTT:

ParametruDescriereImplicit
Mqtt Broker ipAddressAdresa IP a brokerului MQTT192.168.0.1
Mqtt Broker portPortul TCP al brokerului MQTT1883

Modulul se abonează la topicul rădăcină zigbee2mqtt/#.

Variabila modulului

După import, setați variabila modulului Xiaomi_WSDCGQ01LM_1 la identitatea senzorului în Zigbee2MQTT:

VariabilăDescriereCum se obțineImplicit în șablon
Xiaomi_WSDCGQ01LM_1Friendly name-ul Zigbee2MQTT sau adresa IEEE a senzoruluiInterfața web Zigbee2MQTT → Devices → WSDCGQ01LM → copiați friendly name-ul sau adresa IEEE0x00158d0001823a01

Valoarea implicită 0x00158d0001823a01 este doar un exemplu. Înlocuiți-o cu friendly name-ul sau adresa IEEE a senzorului dvs., altfel șablonul nu primește date.

Scriptul listener reacționează doar la mesajele de pe topicul zigbee2mqtt/ urmat de valoarea acestei variabile, de aceea valoarea trebuie să corespundă exact numelui din Zigbee2MQTT. În aplicația TapHome, șablonul se adaugă la interfața MQTT cu acești parametri de import, iar variabila se editează apoi în setările modulului.

Un friendly name (de exemplu bedroom_climate) este mai ușor de citit decât adresa IEEE. Dacă friendly name-ul se schimbă ulterior în Zigbee2MQTT, trebuie actualizată și variabila din TapHome.

Capabilitățile dispozitivului

Șablonul creează un singur dispozitiv, Xiaomi WSDCGQ01LM, de tip senzor de temperatură. Acesta se actualizează din mesajul de stare JSON de pe zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}.

Temperatură și umiditate

Temperatura în °C se citește din proprietatea temperature. Umiditatea relativă se citește din proprietatea humidity, pe care Zigbee2MQTT o publică în procente. Șablonul o împarte la 100, deoarece TapHome păstrează umiditatea pe o scară 0–1 și o afișează ca procent; astfel, un payload 54.2 apare în TapHome ca 54,2 %.

Conform manualului producătorului, senzorul măsoară:

MărimeDomeniuPrecizie
Temperatură-20 °C până la 50 °C±0,3 °C
Umiditate relativă10–90 % RH, fără condensare±3 %

Monitorizarea bateriei și a semnalului

Dispozitivul are trei atribute de service, citite din același mesaj JSON:

  • Battery — nivelul rămas al bateriei în procente (0–100 %) din proprietatea battery, afișat de exemplu ca 95%
  • Battery voltage — tensiunea bateriei în milivolți din proprietatea voltage, afișată de exemplu ca 3000mV
  • Atribút — calitatea legăturii Zigbee (LQI) din proprietatea linkquality, afișată cu unitatea lqi; șablonul afișează acest atribut sub numele Atribút

Battery și Battery voltage afișează - până la sosirea primului mesaj cu aceste valori. Atributul pentru calitatea legăturii pornește de la 0lqi.

Specificații tehnice

ParametruValoare
ModelWSDCGQ01LM
Conectivitate wirelessZigbee, 2405–2480 MHz
BaterieCR2032
Dimensiuni36 × 36 × 11,5 mm

Depanare

Nu sosesc date în TapHome

  1. Verificați dacă senzorul apare în lista de dispozitive Zigbee2MQTT cu o oră „Last seen” recentă.
  2. Verificați dacă variabila Xiaomi_WSDCGQ01LM_1 corespunde exact friendly name-ului sau adresei IEEE și dacă valoarea de exemplu 0x00158d0001823a01 a fost înlocuită.
  3. Abonați-vă la zigbee2mqtt/# cu un client MQTT (de exemplu MQTT Explorer) și confirmați că sosesc mesaje JSON pe zigbee2mqtt/{friendly_name}.
  4. Verificați dacă adresa IP și portul brokerului din parametrii de import sunt accesibile de pe unitatea de control TapHome.

Senzorul nu mai trimite mesaje sau iese din rețea

Dispozitivele Xiaomi nu respectă pe deplin standardul Zigbee și uneori se deconectează de la rețea. Cele mai frecvente cauze sunt:

  1. Semnal slab — o calitate a legăturii sub 20 este considerată slabă. Mutați senzorul mai aproape de coordonator sau de un router Zigbee alimentat de la rețea.
  2. Tensiune scăzută a bateriei — se poate întâmpla chiar și când bateria pare încă plină. Încercați o altă baterie CR2032.
  3. Router incompatibil — routerele Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi și ale altor câțiva producători sunt cunoscute pentru problemele pe care le cauzează dispozitivelor Xiaomi. Conectați senzorul direct la coordonator, apăsând butonul de resetare în timp ce senzorul se află fizic aproape de coordonator.

Valoarea umidității în smart rules este între 0 și 1

Este un comportament normal. TapHome păstrează umiditatea pe o scară 0–1 (0,542 = 54,2 %), iar aplicația o afișează în procente. Folosiți valoarea 0–1 în smart rules și în formule.

Dispozitive disponibile 1

Aceste dispozitive apar în TapHome după import.

Xiaomi WSDCGQ01LM Modul
Variabile personalizate
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Senzor de temperatură
Atribute de service
Battery
Battery voltage
Atribút
Variabilă: battery, Variabilă: voltage, Variabilă: link

Xiaomi WSDCGQ01LM

Ascultător
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
Atribute de service
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Conexiune: Packet Parser → MQTT

Parametri de import

Introduceți aceste valori când importați XML-ul.

Solicitat în aplicațieImplicit
Mqtt Broker Adresă IP192.168.0.1
Mqtt Broker port1883

Documentație asociată

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Șablon · portalul TapHome Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog. Packet Parser → MQTT Vezi în portalul TapHome