---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Xiaomi WSDCGQ01LM Zigbee érzékelő Zigbee2MQTT és MQTT útján: a TapHome hőmérsékletet, páratartalmat, elemet, feszültséget és jelminőséget olvas."
url: "https://taphome.com/hu/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: hu
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Hogyan integrálható a Xiaomi WSDCGQ01LM hőmérséklet- és páratartalom-érzékelő a TapHome rendszerrel Zigbee2MQTT-n keresztül?","Hogyan párosítható a Xiaomi WSDCGQ01LM egy Zigbee2MQTT koordinátorral?","Mit mér a Xiaomi WSDCGQ01LM TapHome-sablonja?","Milyen értéket kell tartalmaznia a Xiaomi_WSDCGQ01LM_1 modulváltozónak a TapHome-ban?","Miért nem küld adatot a Xiaomi WSDCGQ01LM, vagy miért lép ki a Zigbee hálózatból?","Miért 0 és 1 közötti a WSDCGQ01LM páratartalma a TapHome smart rule-jaiban?","Mi a különbség a Xiaomi WSDCGQ01LM és az Aqara WSDCGQ11LM között?"]
---

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

Kommunikáció: Packet Parser → MQTT

## Integrációs útmutató

A Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM modell) kicsi, kerek, elemes Zigbee érzékelő beltéri használatra. A környezeti hőmérsékletet és a relatív páratartalmat méri, és CR2032 gombelemmel működik. A Zigbee2MQTT Xiaomi YTC4042GL, YTC4007CN és YTC4018CN white label néven is felsorolja. Nem azonos a szögletes Aqara WSDCGQ11LM érzékelővel, amely a légnyomást is méri.

A TapHome közvetve kommunikál az érzékelővel. A WSDCGQ01LM egy Zigbee koordinátorral párosodik, amelyet Zigbee2MQTT híd kezel, és ez a mért értékeket JSON formátumban publikálja MQTT topicokon. A TapHome egy Packet Parser MQTT modulon keresztül iratkozik fel ezekre a topicokra, és egyetlen hőmérséklet-érzékelő eszközre képezi le őket páratartalom-, elem- és kapcsolatminőség-értékekkel. Más Zigbee2MQTT érzékelők, például a [Tuya TS0201](https://taphome.com/hu/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) vagy az [Aqara RTCGQ11LM mozgásérzékelő](https://taphome.com/hu/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/), ugyanígy állíthatók be.

## Követelmények

- **Zigbee koordinátor** — a Zigbee2MQTT által támogatott Zigbee adapter
- **Zigbee2MQTT híd** — a koordinátor melletti hoston fut
- **MQTT broker** — elérhető a Zigbee2MQTT hostról és a TapHome vezérlőegységről is
- **TapHome vezérlőegység** Packet Parser MQTT támogatással

Magának az érzékelőnek nincs Wi-Fi- vagy Ethernet-kapcsolata. Minden IP-hálózati kommunikáció az MQTT broker, a Zigbee2MQTT és a TapHome vezérlőegység között zajlik. A sablon a Zigbee2MQTT alapértelmezett `zigbee2mqtt` alaptopicját (base topic) várja.

## Párosítás a Zigbee2MQTT-vel

A WSDCGQ01LM-et a sablon importálása előtt párosítani kell a Zigbee2MQTT koordinátorral:

1. Helyezd az érzékelőt a Zigbee koordinátor közelébe.
2. Nyisd meg a Zigbee2MQTT webes felületét, és engedélyezd a párosítási módot (**Permit join**).
3. Tartsd nyomva a reset gombot körülbelül 5 másodpercig, amíg a kék fény villogni nem kezd. A reset gomb az eszköz tetején lévő kis gomb.
4. Az érzékelő automatikusan csatlakozik, és az IEEE címével megjelenik a Zigbee2MQTT eszközlistájában. Az eszköz beállításaiban opcionálisan friendly name-et is adhatsz neki (például `bedroom_climate`).

> [!NOTE]
> Az elem százalékos töltöttsége a párosítás után akár 24 órával később jelenik meg — az érzékelő ugyanis csak időnként jelenti.

### Elhelyezés

Az érzékelő kizárólag beltéri használatra készült. Szabadon állhat a kívánt helyen, vagy a védőfólia eltávolítása után az öntapadó matricával rögzíthető (a dobozban egy tartalék matrica is van). A felületnek tisztának és száraznak kell lennie. Ne szereld az érzékelőt fémfelületre.

### Zigbee2MQTT eszközopciók

A Zigbee2MQTT eszközspecifikus opciókat kínál ehhez az érzékelőhöz. Ezek az eszköz következő jelentésétől lépnek életbe:

| Opció | Leírás |
|--------|-------------|
| `temperature_calibration` | A hőmérséklet-értékhez hozzáadott abszolút eltolás |
| `temperature_precision` | A hőmérséklet tizedesjegyeinek száma (0–3, csak csökkentheti a pontosságot) |
| `humidity_calibration` | A páratartalom-értékhez hozzáadott abszolút eltolás |
| `humidity_precision` | A páratartalom tizedesjegyeinek száma (0–3, csak csökkentheti a pontosságot) |

## Konfiguráció

### Importálási paraméterek

A sablon importálásakor add meg az MQTT broker címét:

| Paraméter | Leírás | Alapérték |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | Az MQTT broker IP-címe | `192.168.0.1` |
| `Mqtt Broker port` | Az MQTT broker TCP portja | `1883` |

A modul a `zigbee2mqtt/#` gyökértopicra iratkozik fel.

### Modulváltozó

Az importálás után állítsd be a `Xiaomi_WSDCGQ01LM_1` modulváltozót az érzékelő Zigbee2MQTT-beli azonosítójára:

| Változó | Leírás | Hogyan szerezhető meg | Alapérték a sablonban |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Az érzékelő Zigbee2MQTT friendly name-je vagy IEEE címe | Zigbee2MQTT webes felület → Devices → WSDCGQ01LM → másold ki a friendly name-et vagy az IEEE címet | `0x00158d0001823a01` |

> [!WARNING]
> A `0x00158d0001823a01` alapérték csak példa. Cseréld le az érzékelőd friendly name-jére vagy IEEE címére, különben a sablon nem kap adatot.

A listener szkript csak azokra az üzenetekre reagál, amelyek topicja `zigbee2mqtt/`, majd ennek a változónak az értéke, ezért az értéknek pontosan meg kell egyeznie a Zigbee2MQTT-beli névvel. A TapHome alkalmazásban a sablont ezekkel az importálási paraméterekkel adod hozzá az MQTT interfészhez, a változót pedig utána a modul beállításaiban szerkeszted.

> [!TIP]
> A friendly name (például `bedroom_climate`) könnyebben olvasható, mint az IEEE cím. Ha a friendly name-et később megváltoztatod a Zigbee2MQTT-ben, a TapHome-ban is frissítened kell a változót.

## Eszközfunkciók

A sablon egyetlen eszközt hoz létre **Xiaomi WSDCGQ01LM** néven, hőmérséklet-érzékelő típussal. Az eszköz a `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}` topicon érkező JSON állapotüzenetből frissül.

### Hőmérséklet és páratartalom

A hőmérsékletet °C-ban a `temperature` tulajdonságból olvassa. A relatív páratartalmat a `humidity` tulajdonságból olvassa, amelyet a Zigbee2MQTT százalékban publikál. A sablon ezt 100-zal elosztja, mert a TapHome a páratartalmat 0–1 skálán tárolja és százalékként jeleníti meg, így az `54.2` payload a TapHome-ban 54,2 %-ként jelenik meg.

A gyártó kézikönyve szerint az érzékelő mérési adatai:

| Mennyiség | Tartomány | Pontosság |
|----------|-------|----------|
| Hőmérséklet | -20 °C – 50 °C | ±0,3 °C |
| Relatív páratartalom | 10–90 % RH, nem kondenzáló | ±3 % |

### Elem- és jelfigyelés

Az eszköznek három szervizattribútuma van, amelyeket ugyanabból a JSON üzenetből olvas:

- **Battery** — az elem hátralévő töltöttsége százalékban (0–100 %) a `battery` tulajdonságból, például `95%` formában
- **Battery voltage** — az elem feszültsége millivoltban a `voltage` tulajdonságból, például `3000mV` formában
- **Atribút** — Zigbee kapcsolatminőség (LQI) a `linkquality` tulajdonságból, `lqi` mértékegységgel; a sablon ezt az attribútumot `Atribút` néven jeleníti meg

A Battery és a Battery voltage `-` értéket mutat, amíg meg nem érkezik az első, ezeket az értékeket tartalmazó üzenet. A kapcsolatminőség-attribútum kezdőértéke `0lqi`.

## Műszaki adatok

| Paraméter | Érték |
|-----------|-------|
| Modell | WSDCGQ01LM |
| Vezeték nélküli kapcsolat | Zigbee, 2405–2480 MHz |
| Elem | CR2032 |
| Méretek | 36 × 36 × 11,5 mm |

## Hibaelhárítás

### Nem érkeznek adatok a TapHome-ba

1. Ellenőrizd, hogy az érzékelő megjelenik-e a Zigbee2MQTT eszközlistájában friss „Last seen” időponttal.
2. Ellenőrizd, hogy a `Xiaomi_WSDCGQ01LM_1` változó pontosan megegyezik-e a friendly name-mel vagy az IEEE címmel, és hogy lecserélted-e a `0x00158d0001823a01` példaértéket.
3. Iratkozz fel MQTT klienssel (például MQTT Explorer) a `zigbee2mqtt/#` topicra, és győződj meg róla, hogy JSON üzenetek érkeznek a `zigbee2mqtt/{friendly_name}` topicra.
4. Ellenőrizd, hogy az importálási paraméterekben megadott broker IP-cím és port elérhető-e a TapHome vezérlőegységről.

### Az érzékelő nem küld üzeneteket, vagy kilép a hálózatból

A Xiaomi eszközök nem felelnek meg teljesen a Zigbee szabványnak, és néha lecsatlakoznak a hálózatról. A leggyakoribb okok:

1. **Gyenge jel** — a 20 alatti kapcsolatminőség gyengének számít. Helyezd az érzékelőt közelebb a koordinátorhoz vagy egy hálózati tápellátású Zigbee routerhez.
2. **Alacsony elemfeszültség** — ez akkor is előfordulhat, ha az elem még telinek látszik. Próbálj ki egy másik CR2032 elemet.
3. **Inkompatibilis router** — a Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi és néhány más gyártó routereiről ismert, hogy problémákat okoznak a Xiaomi eszközökkel. Csatlakoztasd az érzékelőt közvetlenül a koordinátorhoz: nyomd meg a reset gombot, miközben az érzékelő fizikailag a koordinátor közelében van.

### A páratartalom értéke a smart rule-okban 0 és 1 közé esik

Ez a várt viselkedés. A TapHome a páratartalmat 0–1 skálán tárolja (0,542 = 54,2 %), az alkalmazás pedig százalékban jeleníti meg. A smart rule-okban és a képletekben a 0–1 értéket használd.

## Elérhető eszközök 1

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Xiaomi WSDCGQ01LM Modul

Egyéni változók

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

Xiaomi WSDCGQ01LM Hőmérséklet-érzékelő

Szerviz attribútumok

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

Változó: `battery`, Változó: `voltage`, Változó: `link`

Figyelő

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

Szerviz attribútumok

Battery

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

Battery voltage

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

Atribút

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

**Kapcsolat:** Packet Parser → MQTT

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri | Alapérték     |
|--------------------|---------------|
| Mqtt Broker IP-cím | `192.168.0.1` |
| Mqtt Broker port   | `1883`        |

## Kapcsolódó dokumentáció

- [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)
- [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/)
- [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)