---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Zigbee senzor Xiaomi WSDCGQ01LM přes Zigbee2MQTT a MQTT: TapHome čte teplotu, vlhkost, baterii, napětí a kvalitu spojení. Včetně postupu párování."
url: "https://taphome.com/cs/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: cs
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Jak integrovat senzor teploty a vlhkosti Xiaomi WSDCGQ01LM s TapHome přes Zigbee2MQTT?","Jak spárovat Xiaomi WSDCGQ01LM s koordinátorem Zigbee2MQTT?","Co měří šablona TapHome pro Xiaomi WSDCGQ01LM?","Jakou hodnotu musí obsahovat proměnná modulu Xiaomi_WSDCGQ01LM_1 v TapHome?","Proč Xiaomi WSDCGQ01LM přestane posílat data nebo opustí Zigbee síť?","Proč je vlhkost WSDCGQ01LM ve smart rules TapHome mezi 0 a 1?","Jaký je rozdíl mezi Xiaomi WSDCGQ01LM a Aqara WSDCGQ11LM?"]
---

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

Komunikace: Packet Parser → MQTT

## Návod na integraci

Senzor teploty a vlhkosti Xiaomi Mi (model WSDCGQ01LM) je malý kulatý Zigbee snímač na baterii, určený do interiéru. Měří teplotu okolí a relativní vlhkost a napájí ho knoflíková baterie CR2032. Zigbee2MQTT ho uvádí také pod white-label názvy Xiaomi YTC4042GL, YTC4007CN a YTC4018CN. Nejde o hranatý Aqara WSDCGQ11LM, který měří i tlak vzduchu.

TapHome komunikuje se snímačem nepřímo. WSDCGQ01LM se páruje se Zigbee koordinátorem, který spravuje brána Zigbee2MQTT, a ta publikuje naměřené hodnoty jako JSON na MQTT topicích. TapHome se k těmto topicům přihlašuje přes modul Packet Parser MQTT a mapuje je na jedno zařízení typu teplotní senzor s hodnotami vlhkosti, baterie a kvality spojení. Stejně se nastavují i další Zigbee2MQTT snímače, například [Tuya TS0201](https://taphome.com/cs/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) nebo [snímač pohybu Aqara RTCGQ11LM](https://taphome.com/cs/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/).

## Požadavky

- **Zigbee koordinátor** — Zigbee adaptér podporovaný v Zigbee2MQTT
- **Brána Zigbee2MQTT** — běží na hostitelském počítači u koordinátoru
- **MQTT broker** — dostupný z hostitele Zigbee2MQTT i z řídicí jednotky TapHome
- **Řídicí jednotka TapHome** s podporou Packet Parser MQTT

Samotný snímač nemá připojení přes Wi-Fi ani Ethernet. Veškerá IP komunikace probíhá mezi MQTT brokerem, Zigbee2MQTT a řídicí jednotkou TapHome. Šablona očekává výchozí základní topic Zigbee2MQTT `zigbee2mqtt`.

## Párování se Zigbee2MQTT

WSDCGQ01LM je nutné spárovat s koordinátorem Zigbee2MQTT ještě před importem šablony:

1. Umístěte snímač blízko Zigbee koordinátoru.
2. Otevřete webové rozhraní Zigbee2MQTT a zapněte režim párování (**Permit join**).
3. Stiskněte a podržte resetovací tlačítko přibližně 5 sekund, dokud nezačne blikat modré světlo. Resetovací tlačítko je malé tlačítko na horní straně zařízení.
4. Snímač se připojí automaticky a zobrazí se v seznamu zařízení Zigbee2MQTT se svou IEEE adresou. Volitelně mu v nastavení zařízení přiřaďte friendly name (například `bedroom_climate`).

> [!NOTE]
> Procento baterie se po spárování může zobrazit až po 24 hodinách — snímač ho hlásí jen periodicky.

### Umístění

Snímač je určen pouze do interiéru. Může volně stát na požadovaném místě, nebo ho lze po odstranění ochranné fólie přilepit lepicí samolepkou (náhradní samolepka je součástí balení). Povrch musí být čistý a suchý. Snímač neupevňujte na kovový povrch.

### Volby zařízení v Zigbee2MQTT

Zigbee2MQTT nabízí pro tento snímač volby specifické pro zařízení. Projeví se při dalším reportu ze zařízení:

| Volba | Popis |
|--------|-------------|
| `temperature_calibration` | Absolutní posun přičtený k hodnotě teploty |
| `temperature_precision` | Počet desetinných míst teploty (0–3, přesnost může pouze snížit) |
| `humidity_calibration` | Absolutní posun přičtený k hodnotě vlhkosti |
| `humidity_precision` | Počet desetinných míst vlhkosti (0–3, přesnost může pouze snížit) |

## Konfigurace

### Parametry importu

Při importu šablony zadejte adresu MQTT brokeru:

| Parametr | Popis | Výchozí hodnota |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | IP adresa MQTT brokeru | `192.168.0.1` |
| `Mqtt Broker port` | TCP port MQTT brokeru | `1883` |

Modul se přihlašuje ke kořenovému topicu `zigbee2mqtt/#`.

### Proměnná modulu

Po importu nastavte proměnnou modulu `Xiaomi_WSDCGQ01LM_1` na identitu snímače v Zigbee2MQTT:

| Proměnná | Popis | Jak ji získat | Výchozí hodnota v šabloně |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Friendly name nebo IEEE adresa snímače v Zigbee2MQTT | Webové rozhraní Zigbee2MQTT → Devices → WSDCGQ01LM → zkopírujte friendly name nebo IEEE adresu | `0x00158d0001823a01` |

> [!WARNING]
> Výchozí hodnota `0x00158d0001823a01` je pouze příklad. Nahraďte ji friendly name nebo IEEE adresou vašeho snímače, jinak šablona nedostane žádná data.

Listener skript reaguje jen na zprávy na topicu `zigbee2mqtt/`, za kterým následuje hodnota této proměnné, proto se hodnota musí přesně shodovat s názvem v Zigbee2MQTT. V aplikaci TapHome se šablona přidává do MQTT rozhraní s těmito parametry importu a proměnná se pak upravuje v nastavení modulu.

> [!TIP]
> Friendly name (například `bedroom_climate`) se čte snáz než IEEE adresa. Pokud se friendly name později v Zigbee2MQTT změní, je nutné aktualizovat i proměnnou v TapHome.

## Možnosti zařízení

Šablona vytvoří jedno zařízení **Xiaomi WSDCGQ01LM** typu teplotní senzor. Aktualizuje se ze stavové JSON zprávy na `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}`.

### Teplota a vlhkost

Teplota v °C se čte z vlastnosti `temperature`. Relativní vlhkost se čte z vlastnosti `humidity`, kterou Zigbee2MQTT publikuje v procentech. Šablona ji dělí 100, protože TapHome uchovává vlhkost v rozsahu 0–1 a zobrazuje ji v procentech, takže payload `54.2` se v TapHome zobrazí jako 54,2 %.

Podle návodu výrobce snímač měří:

| Veličina | Rozsah | Přesnost |
|----------|-------|----------|
| Teplota | -20 °C až 50 °C | ±0,3 °C |
| Relativní vlhkost | 10–90 % RH, bez kondenzace | ±3 % |

### Monitorování baterie a signálu

Zařízení má tři servisní atributy, které se čtou ze stejné JSON zprávy:

- **Battery** — zbývající kapacita baterie v procentech (0–100 %) z vlastnosti `battery`, zobrazuje se například jako `95%`
- **Battery voltage** — napětí baterie v milivoltech z vlastnosti `voltage`, zobrazuje se například jako `3000mV`
- **Atribút** — kvalita Zigbee spojení (LQI) z vlastnosti `linkquality`, zobrazuje se s jednotkou `lqi`; šablona tento atribut zobrazuje pod názvem `Atribút`

Battery a Battery voltage zobrazují `-`, dokud nepřijde první zpráva s těmito hodnotami. Atribut kvality spojení začíná na hodnotě `0lqi`.

## Technické parametry

| Parametr | Hodnota |
|-----------|-------|
| Model | WSDCGQ01LM |
| Bezdrátové připojení | Zigbee, 2405–2480 MHz |
| Baterie | CR2032 |
| Rozměry | 36 × 36 × 11,5 mm |

## Řešení problémů

### Žádná data v TapHome

1. Ověřte, že se snímač zobrazuje v seznamu zařízení Zigbee2MQTT s nedávným časem „Last seen“.
2. Ověřte, že se proměnná `Xiaomi_WSDCGQ01LM_1` přesně shoduje s friendly name nebo IEEE adresou a že byla vzorová hodnota `0x00158d0001823a01` nahrazena.
3. Přihlaste se MQTT klientem (například MQTT Explorer) k `zigbee2mqtt/#` a ověřte, že na `zigbee2mqtt/{friendly_name}` přicházejí JSON zprávy.
4. Ověřte, že jsou IP adresa a port brokeru z parametrů importu dostupné z řídicí jednotky TapHome.

### Snímač přestane posílat zprávy nebo opustí síť

Zařízení Xiaomi plně nedodržují standard Zigbee a občas se od sítě odpojí. Nejčastější příčiny jsou:

1. **Slabý signál** — kvalita spojení pod 20 se považuje za slabou. Přesuňte snímač blíž ke koordinátoru nebo k Zigbee routeru napájenému ze sítě.
2. **Nízké napětí baterie** — může se to stát, i když se baterie stále jeví jako plná. Vyzkoušejte jinou baterii CR2032.
3. **Nekompatibilní router** — o routerech od výrobců Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi a některých dalších je známo, že způsobují problémy se zařízeními Xiaomi. Připojte snímač přímo ke koordinátoru tak, že stisknete resetovací tlačítko, když je snímač fyzicky blízko koordinátoru.

### Hodnota vlhkosti ve smart rules je mezi 0 a 1

Jde o očekávané chování. TapHome uchovává vlhkost v rozsahu 0–1 (0,542 = 54,2 %) a aplikace ji zobrazuje v procentech. Ve smart rules a vzorcích používejte hodnotu v rozsahu 0–1.

## Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Xiaomi WSDCGQ01LM Modul

Vlastní proměnné

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

Xiaomi WSDCGQ01LM Teplotní senzor

Servisní atributy

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

Proměnná: `battery`, Proměnná: `voltage`, Proměnná: `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í atributy

Battery

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

Battery voltage

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

Atribút

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

**Připojení:** Packet Parser → MQTT

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci     | Výchozí       |
|-----------------------|---------------|
| Mqtt Broker IP adresa | `192.168.0.1` |
| Mqtt Broker port      | `1883`        |

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)