---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Xiaomi WSDCGQ01LM über Zigbee2MQTT und MQTT: TapHome liest Temperatur, Feuchte, Batterie, Spannung und Verbindungsqualität. Mit Kopplungsanleitung."
url: "https://taphome.com/de/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: de
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Wie integriert man den Xiaomi WSDCGQ01LM Temperatur- und Feuchtigkeitssensor über Zigbee2MQTT in TapHome?","Wie koppelt man den Xiaomi WSDCGQ01LM mit einem Zigbee2MQTT-Koordinator?","Was misst die TapHome-Vorlage für den Xiaomi WSDCGQ01LM?","Welchen Wert muss die Modulvariable Xiaomi_WSDCGQ01LM_1 in TapHome enthalten?","Warum sendet mein Xiaomi WSDCGQ01LM keine Daten mehr oder verlässt das Zigbee-Netzwerk?","Warum liegt die Feuchtigkeit des WSDCGQ01LM in TapHome smart rules zwischen 0 und 1?","Was ist der Unterschied zwischen dem Xiaomi WSDCGQ01LM und dem Aqara WSDCGQ11LM?"]
---

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

Kommunikation: Packet Parser → MQTT

## Integrationsanleitung

Der Xiaomi Mi Temperature and Humidity Sensor (Modell WSDCGQ01LM) ist ein kleiner, runder, batteriebetriebener Zigbee-Sensor für den Innenbereich. Er misst die Umgebungstemperatur und die relative Luftfeuchtigkeit und wird mit einer CR2032-Knopfzelle betrieben. Zigbee2MQTT führt ihn auch unter den White-Label-Namen Xiaomi YTC4042GL, YTC4007CN und YTC4018CN. Er ist nicht der quadratische Aqara WSDCGQ11LM, der zusätzlich den Luftdruck misst.

TapHome kommuniziert mit dem Sensor indirekt. Der WSDCGQ01LM wird mit einem Zigbee-Koordinator gekoppelt, den eine Zigbee2MQTT-Bridge verwaltet; diese veröffentlicht die Messwerte als JSON auf MQTT-Topics. TapHome abonniert diese Topics über ein Packet-Parser-MQTT-Modul und bildet sie auf ein Temperatursensor-Gerät mit Werten für Feuchtigkeit, Batterie und Verbindungsqualität ab. Andere Zigbee2MQTT-Sensoren, zum Beispiel der [Tuya TS0201](https://taphome.com/de/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) oder der [Aqara-Bewegungsmelder RTCGQ11LM](https://taphome.com/de/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/), werden auf die gleiche Weise eingerichtet.

## Voraussetzungen

- **Zigbee-Koordinator** — ein von Zigbee2MQTT unterstützter Zigbee-Adapter
- **Zigbee2MQTT-Bridge** — läuft auf einem Host neben dem Koordinator
- **MQTT-Broker** — erreichbar sowohl vom Zigbee2MQTT-Host als auch von der TapHome-Steuereinheit
- **TapHome-Steuereinheit** mit Unterstützung für Packet Parser MQTT

Der Sensor selbst hat keine WLAN- oder Ethernet-Verbindung. Die gesamte IP-Kommunikation läuft zwischen MQTT-Broker, Zigbee2MQTT und der TapHome-Steuereinheit. Die Vorlage erwartet das Standard-Basis-Topic von Zigbee2MQTT, `zigbee2mqtt`.

## Kopplung mit Zigbee2MQTT

Der WSDCGQ01LM muss vor dem Import der Vorlage mit dem Zigbee2MQTT-Koordinator gekoppelt werden:

1. Platzieren Sie den Sensor in der Nähe des Zigbee-Koordinators.
2. Öffnen Sie die Zigbee2MQTT-Weboberfläche und aktivieren Sie den Kopplungsmodus (**Permit join**).
3. Halten Sie die Reset-Taste etwa 5 Sekunden lang gedrückt, bis das blaue Licht zu blinken beginnt. Die Reset-Taste ist der kleine Knopf oben am Gerät.
4. Der Sensor tritt dem Netzwerk automatisch bei und erscheint in der Zigbee2MQTT-Geräteliste mit seiner IEEE-Adresse. Optional können Sie in den Geräteeinstellungen einen Friendly Name vergeben (zum Beispiel `bedroom_climate`).

> [!NOTE]
> Bis der Batterieprozentsatz nach der Kopplung erscheint, können bis zu 24 Stunden vergehen — der Sensor meldet ihn nur in regelmäßigen Abständen.

### Platzierung

Der Sensor ist nur für den Innenbereich bestimmt. Er kann frei am gewünschten Ort stehen oder nach dem Abziehen der Schutzfolie mit dem Klebepad befestigt werden (ein zusätzliches Klebepad liegt der Verpackung bei). Die Oberfläche muss sauber und trocken sein. Montieren Sie den Sensor nicht auf einer Metalloberfläche.

### Zigbee2MQTT-Geräteoptionen

Zigbee2MQTT bietet für diesen Sensor gerätespezifische Optionen. Sie werden mit dem nächsten Report des Geräts wirksam:

| Option | Beschreibung |
|--------|-------------|
| `temperature_calibration` | Absoluter Offset, der zum Temperaturwert addiert wird |
| `temperature_precision` | Anzahl der Dezimalstellen der Temperatur (0–3, kann die Genauigkeit nur verringern) |
| `humidity_calibration` | Absoluter Offset, der zum Feuchtigkeitswert addiert wird |
| `humidity_precision` | Anzahl der Dezimalstellen der Feuchtigkeit (0–3, kann die Genauigkeit nur verringern) |

## Konfiguration

### Import-Parameter

Geben Sie beim Import der Vorlage die Adresse des MQTT-Brokers ein:

| Parameter | Beschreibung | Standardwert |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | IP-Adresse des MQTT-Brokers | `192.168.0.1` |
| `Mqtt Broker port` | TCP-Port des MQTT-Brokers | `1883` |

Das Modul abonniert das Root-Topic `zigbee2mqtt/#`.

### Modulvariable

Setzen Sie nach dem Import die Modulvariable `Xiaomi_WSDCGQ01LM_1` auf die Identität des Sensors in Zigbee2MQTT:

| Variable | Beschreibung | Wie ermitteln | Standardwert in der Vorlage |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Zigbee2MQTT-Friendly-Name oder IEEE-Adresse des Sensors | Zigbee2MQTT-Weboberfläche → Devices → WSDCGQ01LM → Friendly Name oder IEEE-Adresse kopieren | `0x00158d0001823a01` |

> [!WARNING]
> Der Standardwert `0x00158d0001823a01` ist nur ein Beispiel. Ersetzen Sie ihn durch den Friendly Name oder die IEEE-Adresse Ihres Sensors, sonst empfängt die Vorlage keine Daten.

Das Listener-Skript reagiert nur auf Nachrichten auf dem Topic `zigbee2mqtt/`, gefolgt vom Wert dieser Variable. Der Wert muss daher exakt mit dem Namen in Zigbee2MQTT übereinstimmen. In der TapHome-App wird die Vorlage mit diesen Import-Parametern zur MQTT-Schnittstelle hinzugefügt; die Variable bearbeiten Sie anschließend in den Moduleinstellungen.

> [!TIP]
> Ein Friendly Name (zum Beispiel `bedroom_climate`) ist leichter lesbar als die IEEE-Adresse. Wenn Sie den Friendly Name später in Zigbee2MQTT ändern, müssen Sie auch die Variable in TapHome anpassen.

## Gerätefunktionen

Die Vorlage erstellt ein Gerät, **Xiaomi WSDCGQ01LM**, vom Typ Temperatursensor. Es wird aus der JSON-Statusnachricht auf `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}` aktualisiert.

### Temperatur und Feuchtigkeit

Die Temperatur in °C wird aus der Eigenschaft `temperature` gelesen. Die relative Luftfeuchtigkeit wird aus der Eigenschaft `humidity` gelesen, die Zigbee2MQTT in Prozent veröffentlicht. Die Vorlage teilt sie durch 100, weil TapHome die Feuchtigkeit auf einer Skala von 0–1 führt und als Prozentwert anzeigt; ein Payload von `54.2` erscheint in TapHome also als 54,2 %.

Laut Bedienungsanleitung des Herstellers misst der Sensor:

| Messgröße | Bereich | Genauigkeit |
|----------|-------|----------|
| Temperatur | -20 °C bis 50 °C | ±0,3 °C |
| Relative Luftfeuchtigkeit | 10–90 % rF, nicht kondensierend | ±3 % |

### Batterie- und Signalüberwachung

Das Gerät hat drei Service-Attribute, die aus derselben JSON-Nachricht gelesen werden:

- **Battery** — verbleibende Batteriekapazität in Prozent (0–100 %) aus der Eigenschaft `battery`, angezeigt zum Beispiel als `95%`
- **Battery voltage** — Batteriespannung in Millivolt aus der Eigenschaft `voltage`, angezeigt zum Beispiel als `3000mV`
- **Atribút** — Zigbee-Verbindungsqualität (LQI) aus der Eigenschaft `linkquality`, angezeigt mit der Einheit `lqi`; die Vorlage zeigt dieses Attribut unter dem Namen `Atribút` an

Battery und Battery voltage zeigen `-`, bis die erste Nachricht mit diesen Werten eintrifft. Das Attribut für die Verbindungsqualität startet bei `0lqi`.

## Technische Daten

| Parameter | Wert |
|-----------|-------|
| Modell | WSDCGQ01LM |
| Funkverbindung | Zigbee, 2405–2480 MHz |
| Batterie | CR2032 |
| Abmessungen | 36 × 36 × 11,5 mm |

## Fehlerbehebung

### Keine Daten in TapHome

1. Prüfen Sie, ob der Sensor in der Zigbee2MQTT-Geräteliste mit einer aktuellen „Last seen“-Zeit erscheint.
2. Prüfen Sie, ob die Variable `Xiaomi_WSDCGQ01LM_1` exakt mit dem Friendly Name oder der IEEE-Adresse übereinstimmt und ob der Beispielwert `0x00158d0001823a01` ersetzt wurde.
3. Abonnieren Sie `zigbee2mqtt/#` mit einem MQTT-Client (zum Beispiel MQTT Explorer) und prüfen Sie, ob JSON-Nachrichten auf `zigbee2mqtt/{friendly_name}` eintreffen.
4. Prüfen Sie, ob die IP-Adresse und der Port des Brokers aus den Import-Parametern von der TapHome-Steuereinheit erreichbar sind.

### Sensor sendet keine Nachrichten mehr oder verlässt das Netzwerk

Xiaomi-Geräte halten den Zigbee-Standard nicht vollständig ein und trennen sich manchmal vom Netzwerk. Die häufigsten Ursachen sind:

1. **Schwaches Signal** — eine Verbindungsqualität unter 20 gilt als schwach. Platzieren Sie den Sensor näher am Koordinator oder an einem netzbetriebenen Zigbee-Router.
2. **Niedrige Batteriespannung** — das kann auch dann auftreten, wenn die Batterie noch voll erscheint. Probieren Sie eine andere CR2032-Batterie aus.
3. **Inkompatibler Router** — Router von Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi und einigen anderen Herstellern verursachen bekanntermaßen Probleme mit Xiaomi-Geräten. Verbinden Sie den Sensor direkt mit dem Koordinator, indem Sie die Reset-Taste drücken, während er sich physisch nah am Koordinator befindet.

### Feuchtigkeitswert in smart rules liegt zwischen 0 und 1

Das ist so beabsichtigt. TapHome führt die Feuchtigkeit auf einer Skala von 0–1 (0,542 = 54,2 %), und die App zeigt sie in Prozent an. Verwenden Sie in smart rules und Formeln den Wert von 0–1.

## Verfügbare Geräte 1

Diese Geräte erscheinen nach dem Import in TapHome.

Xiaomi WSDCGQ01LM Modul

Benutzerdefinierte Variablen

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

Xiaomi WSDCGQ01LM Temperatursensor

Serviceattribute

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

Variable: `battery`, Variable: `voltage`, Variable: `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
```

Serviceattribute

Battery

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

Battery voltage

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

Atribút

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

**Verbindung:** Packet Parser → MQTT

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

| In der App abgefragt   | Standard      |
|------------------------|---------------|
| Mqtt Broker IP-Adresse | `192.168.0.1` |
| Mqtt Broker port       | `1883`        |

## Verwandte Dokumentation

- [MQTT Integration](https://taphome.com/de/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/)
- [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/)
- [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)
- [MQTT-Broker](https://taphome.com/de/docs/integration/packet-parser/mqtt-broker/)
- [Listener-Skripte](https://taphome.com/de/docs/script/listener-scripts/)