---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Zigbee snímač Xiaomi WSDCGQ01LM cez Zigbee2MQTT a MQTT: TapHome číta teplotu, vlhkosť, batériu, napätie a kvalitu spojenia. Vrátane postupu párovania."
url: "https://taphome.com/sk/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: sk
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Ako integrovať snímač teploty a vlhkosti Xiaomi WSDCGQ01LM s TapHome cez Zigbee2MQTT?","Ako spárovať Xiaomi WSDCGQ01LM s koordinátorom Zigbee2MQTT?","Čo meria šablóna TapHome pre Xiaomi WSDCGQ01LM?","Akú hodnotu musí obsahovať premenná modulu Xiaomi_WSDCGQ01LM_1 v TapHome?","Prečo Xiaomi WSDCGQ01LM prestane posielať dáta alebo opustí Zigbee sieť?","Prečo je vlhkosť WSDCGQ01LM v smart rules TapHome medzi 0 a 1?","Aký je rozdiel medzi Xiaomi WSDCGQ01LM a Aqara WSDCGQ11LM?"]
---

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

Komunikácia: Packet Parser → MQTT

## Návod na integráciu

Snímač teploty a vlhkosti Xiaomi Mi (model WSDCGQ01LM) je malý okrúhly Zigbee snímač na batériu, určený do interiéru. Meria teplotu okolia a relatívnu vlhkosť a napája ho gombíková batéria CR2032. Zigbee2MQTT ho uvádza aj pod white-label názvami Xiaomi YTC4042GL, YTC4007CN a YTC4018CN. Nejde o hranatý Aqara WSDCGQ11LM, ktorý meria aj tlak vzduchu.

TapHome so snímačom komunikuje nepriamo. WSDCGQ01LM sa páruje so Zigbee koordinátorom, ktorý spravuje brána Zigbee2MQTT, a tá publikuje namerané hodnoty ako JSON na MQTT topikoch. TapHome sa na tieto topiky prihlasuje cez modul Packet Parser MQTT a mapuje ich na jedno zariadenie typu teplotný senzor s hodnotami vlhkosti, batérie a kvality spojenia. Rovnako sa nastavujú aj ďalšie Zigbee2MQTT snímače, napríklad [Tuya TS0201](https://taphome.com/sk/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) alebo [snímač pohybu Aqara RTCGQ11LM](https://taphome.com/sk/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/).

## Požiadavky

- **Zigbee koordinátor** — Zigbee adaptér podporovaný v Zigbee2MQTT
- **Brána Zigbee2MQTT** — beží na hostiteľskom počítači pri koordinátore
- **MQTT broker** — dostupný z hostiteľa Zigbee2MQTT aj z riadiacej jednotky TapHome
- **Riadiaca jednotka TapHome** s podporou Packet Parser MQTT

Samotný snímač nemá pripojenie cez Wi-Fi ani Ethernet. Celá IP komunikácia prebieha medzi MQTT brokerom, Zigbee2MQTT a riadiacou jednotkou TapHome. Šablóna očakáva predvolený základný topik Zigbee2MQTT `zigbee2mqtt`.

## Párovanie so Zigbee2MQTT

WSDCGQ01LM je potrebné spárovať s koordinátorom Zigbee2MQTT ešte pred importom šablóny:

1. Umiestnite snímač blízko Zigbee koordinátora.
2. Otvorte webové rozhranie Zigbee2MQTT a zapnite režim párovania (**Permit join**).
3. Stlačte a podržte resetovacie tlačidlo približne 5 sekúnd, kým nezačne blikať modré svetlo. Resetovacie tlačidlo je malé tlačidlo na vrchnej strane zariadenia.
4. Snímač sa pripojí automaticky a zobrazí sa v zozname zariadení Zigbee2MQTT so svojou IEEE adresou. Voliteľne mu v nastaveniach zariadenia priraďte friendly name (napríklad `bedroom_climate`).

> [!NOTE]
> Percento batérie sa po spárovaní môže zobraziť až po 24 hodinách — snímač ho hlási len periodicky.

### Umiestnenie

Snímač je určený len do interiéru. Môže voľne stáť na požadovanom mieste, alebo sa dá po odstránení ochrannej fólie prilepiť lepiacou nálepkou (náhradná nálepka je súčasťou balenia). Povrch musí byť čistý a suchý. Snímač neupevňujte na kovový povrch.

### Voľby zariadenia v Zigbee2MQTT

Zigbee2MQTT ponúka pre tento snímač voľby špecifické pre zariadenie. Prejavia sa pri ďalšom reporte zo zariadenia:

| Voľba | Popis |
|--------|-------------|
| `temperature_calibration` | Absolútny posun pripočítaný k hodnote teploty |
| `temperature_precision` | Počet desatinných miest teploty (0–3, presnosť môže len znížiť) |
| `humidity_calibration` | Absolútny posun pripočítaný k hodnote vlhkosti |
| `humidity_precision` | Počet desatinných miest vlhkosti (0–3, presnosť môže len znížiť) |

## Konfigurácia

### Parametre importu

Pri importe šablóny zadajte adresu MQTT brokera:

| Parameter | Popis | Predvolená hodnota |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | IP adresa MQTT brokera | `192.168.0.1` |
| `Mqtt Broker port` | TCP port MQTT brokera | `1883` |

Modul sa prihlasuje na koreňový topik `zigbee2mqtt/#`.

### Premenná modulu

Po importe nastavte premennú modulu `Xiaomi_WSDCGQ01LM_1` na identitu snímača v Zigbee2MQTT:

| Premenná | Popis | Ako ju získať | Predvolená hodnota v šablóne |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Friendly name alebo IEEE adresa snímača v Zigbee2MQTT | Webové rozhranie Zigbee2MQTT → Devices → WSDCGQ01LM → skopírujte friendly name alebo IEEE adresu | `0x00158d0001823a01` |

> [!WARNING]
> Predvolená hodnota `0x00158d0001823a01` je len príklad. Nahraďte ju friendly name alebo IEEE adresou vášho snímača, inak šablóna nedostane žiadne dáta.

Listener skript reaguje len na správy na topiku `zigbee2mqtt/`, za ktorým nasleduje hodnota tejto premennej, preto sa hodnota musí presne zhodovať s názvom v Zigbee2MQTT. V aplikácii TapHome sa šablóna pridáva do MQTT rozhrania s týmito parametrami importu a premenná sa potom upravuje v nastaveniach modulu.

> [!TIP]
> Friendly name (napríklad `bedroom_climate`) sa číta ľahšie ako IEEE adresa. Ak sa friendly name neskôr v Zigbee2MQTT zmení, je potrebné aktualizovať aj premennú v TapHome.

## Možnosti zariadenia

Šablóna vytvorí jedno zariadenie **Xiaomi WSDCGQ01LM** typu teplotný senzor. Aktualizuje sa zo stavovej JSON správy na `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}`.

### Teplota a vlhkosť

Teplota v °C sa číta z vlastnosti `temperature`. Relatívna vlhkosť sa číta z vlastnosti `humidity`, ktorú Zigbee2MQTT publikuje v percentách. Šablóna ju delí 100, pretože TapHome uchováva vlhkosť v rozsahu 0–1 a zobrazuje ju v percentách, takže payload `54.2` sa v TapHome zobrazí ako 54,2 %.

Podľa návodu výrobcu snímač meria:

| Veličina | Rozsah | Presnosť |
|----------|-------|----------|
| Teplota | -20 °C až 50 °C | ±0,3 °C |
| Relatívna vlhkosť | 10–90 % RH, bez kondenzácie | ±3 % |

### Monitorovanie batérie a signálu

Zariadenie má tri servisné atribúty, ktoré sa čítajú z tej istej JSON správy:

- **Battery** — zostávajúca kapacita batérie v percentách (0–100 %) z vlastnosti `battery`, zobrazuje sa napríklad ako `95%`
- **Battery voltage** — napätie batérie v milivoltoch z vlastnosti `voltage`, zobrazuje sa napríklad ako `3000mV`
- **Atribút** — kvalita Zigbee spojenia (LQI) z vlastnosti `linkquality`, zobrazuje sa s jednotkou `lqi`; šablóna tento atribút zobrazuje pod názvom `Atribút`

Battery a Battery voltage zobrazujú `-`, kým nepríde prvá správa s týmito hodnotami. Atribút kvality spojenia začína na hodnote `0lqi`.

## Technické parametre

| Parameter | Hodnota |
|-----------|-------|
| Model | WSDCGQ01LM |
| Bezdrôtové pripojenie | Zigbee, 2405–2480 MHz |
| Batéria | CR2032 |
| Rozmery | 36 × 36 × 11,5 mm |

## Riešenie problémov

### Žiadne dáta v TapHome

1. Overte, či sa snímač zobrazuje v zozname zariadení Zigbee2MQTT s nedávnym časom „Last seen“.
2. Overte, či sa premenná `Xiaomi_WSDCGQ01LM_1` presne zhoduje s friendly name alebo IEEE adresou a či bola vzorová hodnota `0x00158d0001823a01` nahradená.
3. Prihláste sa MQTT klientom (napríklad MQTT Explorer) na `zigbee2mqtt/#` a overte, že na `zigbee2mqtt/{friendly_name}` prichádzajú JSON správy.
4. Overte, či sú IP adresa a port brokera z parametrov importu dostupné z riadiacej jednotky TapHome.

### Snímač prestane posielať správy alebo opustí sieť

Zariadenia Xiaomi úplne nedodržiavajú štandard Zigbee a občas sa od siete odpoja. Najčastejšie príčiny sú:

1. **Slabý signál** — kvalita spojenia pod 20 sa považuje za slabú. Presuňte snímač bližšie ku koordinátoru alebo k Zigbee routeru napájanému zo siete.
2. **Nízke napätie batérie** — môže sa to stať, aj keď sa batéria stále javí ako plná. Vyskúšajte inú batériu CR2032.
3. **Nekompatibilný router** — o routeroch od výrobcov Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi a niektorých ďalších je známe, že spôsobujú problémy so zariadeniami Xiaomi. Pripojte snímač priamo ku koordinátoru tak, že stlačíte resetovacie tlačidlo, keď je snímač fyzicky blízko koordinátora.

### Hodnota vlhkosti v smart rules je medzi 0 a 1

Je to očakávané správanie. TapHome uchováva vlhkosť v rozsahu 0–1 (0,542 = 54,2 %) a aplikácia ju zobrazuje v percentách. V smart rules a vzorcoch používajte hodnotu v rozsahu 0–1.

## Dostupné zariadenia 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Xiaomi WSDCGQ01LM Modul

Vlastné premenné

|                                                     |
|-----------------------------------------------------|
| `Xiaomi_WSDCGQ01LM_1` (string) = 0x00158d0001823a01 |

Xiaomi WSDCGQ01LM Teplotný senzor

Servisné atribúty

|                 |
|-----------------|
| Battery         |
| Battery voltage |
| Atribút         |

Premenná: `battery`, Premenná: `voltage`, Premenná: `link`

Listener

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

Servisné atribúty

Battery

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

Battery voltage

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

Atribút

```taphome
IF (ISNAN(link), "-", link + "lqi");
```

**Pripojenie:** Packet Parser → MQTT

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii   | Predvolené    |
|-----------------------|---------------|
| Mqtt Broker IP adresa | `192.168.0.1` |
| Mqtt Broker port      | `1883`        |

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)