---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Senzor Zigbee Xiaomi WSDCGQ01LM prin Zigbee2MQTT și MQTT: TapHome citește temperatura, umiditatea, bateria, tensiunea și calitatea legăturii."
url: "https://taphome.com/ro/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: ro
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Cum se integrează senzorul de temperatură și umiditate Xiaomi WSDCGQ01LM cu TapHome prin Zigbee2MQTT?","Cum se asociază Xiaomi WSDCGQ01LM cu un coordonator Zigbee2MQTT?","Ce măsoară șablonul TapHome pentru Xiaomi WSDCGQ01LM?","Ce valoare trebuie să conțină variabila modulului Xiaomi_WSDCGQ01LM_1 în TapHome?","De ce Xiaomi WSDCGQ01LM nu mai trimite date sau iese din rețeaua Zigbee?","De ce umiditatea WSDCGQ01LM este între 0 și 1 în smart rules TapHome?","Care este diferența dintre Xiaomi WSDCGQ01LM și Aqara WSDCGQ11LM?"]
---

# Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Comunicație: Packet Parser → MQTT

## 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](https://taphome.com/ro/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) sau [senzorul de mișcare Aqara RTCGQ11LM](https://taphome.com/ro/compatibility/zigbee2mqtt-xiaomi-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`).

> [!NOTE]
> 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țiune | Descriere |
|--------|-------------|
| `temperature_calibration` | Decalaj absolut adăugat la valoarea temperaturii |
| `temperature_precision` | Numărul de zecimale pentru temperatură (0–3, poate doar reduce precizia) |
| `humidity_calibration` | Decalaj absolut adăugat la valoarea umidității |
| `humidity_precision` | Numărul de zecimale pentru umiditate (0–3, poate doar reduce precizia) |

## Configurare

### Parametri de import

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

| Parametru | Descriere | Implicit |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | Adresa IP a brokerului MQTT | `192.168.0.1` |
| `Mqtt Broker port` | Portul TCP al brokerului MQTT | `1883` |

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ă | Descriere | Cum se obține | Implicit în șablon |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Friendly name-ul Zigbee2MQTT sau adresa IEEE a senzorului | Interfața web Zigbee2MQTT → Devices → WSDCGQ01LM → copiați friendly name-ul sau adresa IEEE | `0x00158d0001823a01` |

> [!WARNING]
> 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.

> [!TIP]
> 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ărime | Domeniu | Precizie |
|----------|-------|----------|
| 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

| Parametru | Valoare |
|-----------|-------|
| Model | WSDCGQ01LM |
| Conectivitate wireless | Zigbee, 2405–2480 MHz |
| Baterie | CR2032 |
| Dimensiuni | 36 × 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`

Ascultător

```taphome
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

```taphome
IF (ISNAN(battery), "-", battery + "%");
```

Battery voltage

```taphome
IF (ISNAN(voltage), "-", voltage + "mV");
```

Atribút

```taphome
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ție | Implicit      |
|------------------------|---------------|
| Mqtt Broker Adresă IP  | `192.168.0.1` |
| Mqtt Broker port       | `1883`        |

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)