TapHome
Deutsch
Slovenčina Čeština Magyar Italiano Polski

Deutsch

Română Hrvatski English
Offiziell · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Runder Zigbee-Temperatur- und Feuchtigkeitssensor Xiaomi WSDCGQ01LM (CR2032) in TapHome über MQTT mit einer Zigbee2MQTT-Bridge. Meldet Temperatur, relative Luftfeuchtigkeit, Batteriestand, Batteriespannung und Zigbee-Verbindungsqualität. Kopplung in Zigbee2MQTT mit Permit join und der Reset-Taste.

Zigbee2MQTTPacket Parser → MQTT1 GerätRevision 1.0 Zuletzt aktualisiert: 10. November 2026

Import in die TapHome AppHardware › Packet Parser › Aus Vorlage hinzufügen

Vorlage herunterladen
Auf dieser Seite

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 oder der Aqara-Bewegungsmelder 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).

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:

OptionBeschreibung
temperature_calibrationAbsoluter Offset, der zum Temperaturwert addiert wird
temperature_precisionAnzahl der Dezimalstellen der Temperatur (0–3, kann die Genauigkeit nur verringern)
humidity_calibrationAbsoluter Offset, der zum Feuchtigkeitswert addiert wird
humidity_precisionAnzahl 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:

ParameterBeschreibungStandardwert
Mqtt Broker ipAddressIP-Adresse des MQTT-Brokers192.168.0.1
Mqtt Broker portTCP-Port des MQTT-Brokers1883

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:

VariableBeschreibungWie ermittelnStandardwert in der Vorlage
Xiaomi_WSDCGQ01LM_1Zigbee2MQTT-Friendly-Name oder IEEE-Adresse des SensorsZigbee2MQTT-Weboberfläche → Devices → WSDCGQ01LM → Friendly Name oder IEEE-Adresse kopieren0x00158d0001823a01

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.

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ößeBereichGenauigkeit
Temperatur-20 °C bis 50 °C±0,3 °C
Relative Luftfeuchtigkeit10–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

ParameterWert
ModellWSDCGQ01LM
FunkverbindungZigbee, 2405–2480 MHz
BatterieCR2032
Abmessungen36 × 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

Xiaomi WSDCGQ01LM

Listener
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
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Verbindung: Packet Parser → MQTT

Importparameter

Diese Werte geben Sie beim Import des XML ein.

In der App abgefragtStandard
Mqtt Broker IP-Adresse192.168.0.1
Mqtt Broker port1883

Verwandte Dokumentation

Haben Sie ein Problem mit dieser Gerätevorlage gefunden?

Sagen Sie uns, was nicht funktioniert, was fehlt oder wie sich die Vorlage verhalten sollte. Ihr Feedback hilft uns, den Katalog genau zu halten.

Vorlage · TapHome-Portal Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Öffne diese Vorlage im Kundenportal, um sie auf eine deiner Wohnungen anzuwenden, oder entwirf eine Anpassung und reiche sie an den Katalog ein. Packet Parser → MQTT Im TapHome-Portal ansehen