--- title: "Aqara Temperature, Humidity and Pressure Sensor" description: "Aqara WSDCGQ11LM über Zigbee und ein Tasmota-Gateway (MQTT): Temperatur, Luftfeuchtigkeit, Luftdruck, Batterie und Offline-Erkennung in TapHome." url: "https://taphome.com/de/compatibility/zigbee2tasmota-aqara-temperature-humidity-and-pressure-sensor/" language: de lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","sensor","zigbee","battery-powered","weather"] questions: ["Wie integriere ich den Aqara WSDCGQ11LM mit TapHome?","Was misst die TapHome-Vorlage für den Aqara Temperatur- und Feuchtigkeitssensor?","Wie verbinde ich einen Aqara Zigbee-Sensor über Tasmota mit TapHome?","Warum wird mein Aqara-Sensor in TapHome als offline angezeigt?","Wie koppele ich den Aqara WSDCGQ11LM mit einem Zigbee2Tasmota-Gateway?","Überwacht TapHome den Batteriestand von Aqara Zigbee-Sensoren?"] --- # Aqara Temperature, Humidity and Pressure Sensor Kommunikation: Packet Parser → MQTT - [Aqara Produktseite](https://www.aqara.com/en/product/temperature-humidity-sensor/) > Netzwerkadresse > > Beim in TapHome integrierten MQTT-Broker geben Sie in TapHome `127.0.0.1` als Broker-Adresse ein. Im Gerät geben Sie die IP-Adresse des TapHome Core ein und richten für den Core eine IP-Reservierung im Router ein. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung > [!IMPORTANT] > Dieses Gerät kommuniziert über **Zigbee** durch ein Tasmota-Gateway. Stellen Sie sicher, dass die > Vorlage [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/zigbee2tasmota-gateway/) > importiert und Ihr Gerät gekoppelt ist. Der Aqara WSDCGQ11LM ist ein kompakter batteriebetriebener Zigbee-Sensor, der Umgebungstemperatur, relative Luftfeuchtigkeit und atmosphärischen Druck misst. Er kommuniziert mit TapHome über MQTT durch ein Zigbee2Tasmota-Gateway — der Sensor sendet periodische Messwerte über das Topic `tele/{gateway}/SENSOR`, und die Vorlage parst den `ZbReceived` JSON-Payload. Der Sensor wird von einer CR2032-Knopfzellenbatterie betrieben. Die Vorlage überwacht Batteriestand und -spannung über Service-Attribute, warnt bei einem Batteriestand unter 30 % und erkennt Offline-Zustände des Geräts (Warnung nach 12 Stunden, Fehler nach 24 Stunden). ## Konfiguration ### Sensor koppeln 1. Aktivieren Sie am Zigbee2Tasmota-Gateway **Permit Join** (über den Gateway-Vorlagen-Schalter in TapHome oder den Tasmota-Konsolenbefehl `ZbPermitJoin 1`) 2. Halten Sie die Reset-Taste am Aqara-Sensor etwa 5 Sekunden lang gedrückt, bis die blaue LED blinkt 3. Lassen Sie die Taste los — der Sensor sollte sich innerhalb von 60 Sekunden koppeln 4. Notieren Sie sich die zugewiesene Device ID (z. B. `0x1234`) aus den Service-Attributen des Gateways oder der Tasmota-Konsole ### Importparameter Importieren Sie nach dem Koppeln die Gerätevorlage mit diesen Parametern: | Parameter | Beschreibung | Beispiel | |-----------|-------------|----------| | MQTT Broker IP Address | IP-Adresse des MQTT-Brokers | `192.168.1.10` | | MQTT Broker Port | Broker-Port (Standard 1883) | `1883` | | Gateway name | Tasmota MQTT-Topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | Device ID | Kurze Zigbee-Adresse vom Koppeln | `0x1234` | > [!WARNING] > Aqara/Xiaomi Zigbee-Geräte entsprechen nicht vollständig dem Zigbee-Standard und können Verbindungsprobleme mit bestimmten Zigbee-Routern aufweisen. Bekannte inkompatible Router sind Centralite, General Electric, OSRAM, Sylvania, SmartThings und Securifi. Verwenden Sie Router, die nachweislich mit Xiaomi-Geräten kompatibel sind (z. B. IKEA TRADFRI). ## Gerätefunktionen ### Temperatur und Luftfeuchtigkeit Das Gerät Temperature and Humidity liest die Felder `Temperature` und `Humidity` aus dem `ZbReceived` JSON-Payload. Die Temperatur wird in °C als direkter Wert gemeldet. Die Luftfeuchtigkeit wird als roher Ganzzahlwert gemeldet (z. B. 4520 für 45,20 %) und im Listener-Skript durch 100 geteilt, um das Verhältnis zu erzeugen, das TapHome als Prozentsatz anzeigt. Beide Werte werden aktualisiert, wenn der Sensor eine `SENSOR`-Nachricht sendet — typischerweise alle paar Minuten oder bei einer signifikanten Änderung. ### Atmosphärischer Druck Das Gerät Pressure liest das Feld `Pressure` aus dem `ZbReceived` JSON-Payload. Der Wert wird in hPa (Hektopascal) gemeldet und über ValueLogTypeConversion vom Rohtyp 62 zum Drucktyp 25 mit einer linearen 1:1-Skala zugeordnet. Der atmosphärische Druck kann zur Überwachung von Wettertrends oder für höhenbasierte Automatisierungsregeln verwendet werden. ### Batterie und Gerätezustand Das Modul stellt mehrere Service-Attribute bereit, die durch den `ZbInfo`-Abfragemechanismus (1-Stunden-Intervall über ReadScript) befüllt werden: - **Battery Percentage** — geschätzter CR2032-Batteriestand. Bei einem Stand unter 30 % wird eine Warnung angezeigt. - **Battery Voltage** — aktuelle Batteriespannung in Volt. - **Link Quality** — Zigbee-Signalstärke, skaliert von 0–254 auf 0–100 %. - **IEEEAddr**, **ModelId**, **Manufacturer**, **Endpoints**, **Config** — Geräteidentifikation und Zigbee-Konfigurations-Metadaten. Die Vorlage verfolgt auch `LastSeenEpoch` aus ZbInfo-Antworten. Wenn der Sensor mehr als 12 Stunden nicht gesehen wurde, wird eine Warnung angezeigt. Nach 24 Stunden wird ein Fehler angezeigt — dies bedeutet, dass der Sensor offline, außer Reichweite oder die Batterie leer sein könnte. > [!TIP] > CR2032-Batterieaktualisierungen von Zigbee-Geräten können bis zu 24 Stunden dauern. Ein plötzlicher Abfall bedeutet nicht unbedingt, dass die Batterie versagt — warten Sie auf den nächsten Meldezyklus. ### Weitere Funktionen Der WSDCGQ11LM unterstützt außerdem Kalibrierungs-Offsets für Temperatur-, Feuchtigkeits- und Druckmessungen pro Sensor (verfügbar in zigbee2mqtt). Die Batteriespannung wird in einigen Zigbee-Stacks zusätzlich als Entität auf Geräteebene bereitgestellt. Diese Funktionen können in einem zukünftigen Vorlagen-Update hinzugefügt werden. ## Fehlerbehebung ### Sensor meldet keine Daten 1. Überprüfen Sie, ob das Zigbee2Tasmota-Gateway mit dem MQTT-Broker verbunden ist und Nachrichten empfängt (prüfen Sie `tele/{GWname}/SENSOR` in einem MQTT-Client) 2. Bestätigen Sie, dass die Device ID in der Vorlage mit der beim Koppeln zugewiesenen Kurzadresse übereinstimmt (z. B. `0x1234`) 3. Prüfen Sie das Service-Attribut Link Quality — Werte unter 20 % weisen auf ein schwaches Zigbee-Signal hin. Bewegen Sie den Sensor näher zum Gateway oder fügen Sie ein kompatibles Zigbee-Router-Gerät hinzu 4. Drücken Sie die Sensor-Taste einmal, um eine Übertragung zu erzwingen, und überprüfen Sie, ob das Gateway die Nachricht empfängt ### Feuchtigkeitsmessung erscheint falsch Die Vorlage teilt den Humidity-Wert durch 100 (z. B. wird `45.2` zu 0,452, angezeigt als 45,2 %). Wenn der Wert 100-mal zu hoch oder zu niedrig ist, prüfen Sie den `Humidity`-Wert in der Tasmota-Konsole — die Vorlage erwartet ihn in Prozent. ### Gerät zeigt Offline-Warnung 1. Überprüfen Sie den Batteriestand — eine leere CR2032 bewirkt, dass der Sensor aufhört zu senden 2. Der Aqara-Sensor ist ein Zigbee-Endgerät (kein Router) und kommuniziert über nahegelegene Zigbee-Router-Geräte. Wenn ein Router ausfällt, kann der Sensor unerreichbar werden 3. Drücken Sie die Sensor-Taste, um ihn aufzuwecken und eine erneute Zuordnung zum Zigbee-Netzwerk zu erzwingen 4. Wenn das Problem weiterhin besteht, koppeln Sie das Gerät erneut, indem Sie die Reset-Taste 5 Sekunden lang gedrückt halten, bis die blaue LED blinkt ## Installation in TapHome ### Voraussetzungen - Zigbee-Gateway mit Tasmota-Firmware (z. B. Sonoff ZBBridge, eWeLink ZB-GW03) - MQTT-Broker in Ihrem lokalen Netzwerk (integrierter TapHome-Broker oder externer) - TapHome CCU im selben Netzwerk > [!TIP] > TapHome hat einen integrierten MQTT-Broker — aktivieren Sie ihn unter **Einstellungen** → **Hardware** → **MQTT Broker**. Keine zusätzliche Software erforderlich. ### Schritt 1 — Tasmota Zigbee-Gateway einrichten 1. Flashen Sie die [Tasmota-Firmware](https://tasmota.github.io/docs/Getting-Started/) auf einen unterstützten Zigbee-Koordinator (z. B. Sonoff ZBBridge, eWeLink ZB-GW03) 2. Verbinden Sie das Gateway über die Tasmota-Weboberfläche mit Ihrem Wi-Fi-Netzwerk 3. Navigieren Sie zu **Configuration** → **Configure MQTT** und konfigurieren Sie: - **Host:** beim integrierten Broker die IP-Adresse des TapHome Core (mit einer IP-Reservierung im Router → [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)), sonst die IP-Adresse Ihres Brokers (z. B. `192.168.1.10`) - **Port:** `1883` - **Topic:** notieren Sie den Topic-Namen (z. B. `tasmota_XXXXX`) — Sie benötigen ihn beim Vorlagenimport Ausführliche Anleitungen finden Sie in der [Tasmota Zigbee-Dokumentation](https://tasmota.github.io/docs/Zigbee/). ### Schritt 2 — Gateway-Vorlage in TapHome importieren 1. Laden Sie die Gateway-Vorlage von der Kompatibilitätsseite [Zigbee2Tasmota Gateway](https://taphome.com/de/compatibility/zigbee2tasmota-gateway/) herunter 2. In TapHome gehen Sie zu **Einstellungen** → **Hardware** → **Packet Parser** → **Import** 3. Importieren Sie die Vorlage mit diesen Parametern: - **MQTT Broker IP Address:** `127.0.0.1` für den integrierten TapHome-Broker, sonst die IP-Adresse Ihres Brokers (z. B. `192.168.1.10`) - **MQTT Broker Port:** `1883` - **Gateway name:** Tasmota-MQTT-Topic aus Schritt 1 (z. B. `tasmota_XXXXX`) Nach dem Import sehen Sie zwei Geräte: **Permit Join** (Schalter) und **Devices Found** (Zähler). ### Schritt 3 — Zigbee-Gerät koppeln 1. In TapHome schalten Sie den **Permit Join**-Schalter ein — es öffnet sich ein 60-Sekunden-Kopplungsfenster 2. Starten Sie am Zigbee-Gerät den Kopplungsvorgang (typischerweise Reset-Taste 5 Sekunden gedrückt halten, bis die LED blinkt) 3. Beobachten Sie den **Devices Found**-Zähler — er erhöht sich, wenn ein neues Gerät beitritt 4. Überprüfen Sie die **Service Attributes** des Gateways, um die ID des neuen Geräts (z. B. `0x1234`), den Hersteller und das Modell zu sehen 5. Der Kopplungsmodus wird nach Ablauf des Zeitlimits automatisch deaktiviert ### Schritt 4 — Geräte-Vorlage importieren 1. Laden Sie die gerätespezifische Vorlage von der entsprechenden Kompatibilitätsseite herunter 2. Importieren Sie die Vorlage mit diesen Parametern: - **MQTT Broker IP Address:** dieselbe wie für das Gateway - **MQTT Broker Port:** `1883` - **Gateway name:** derselbe Tasmota-MQTT-Topic wie oben - **Device ID:** die Kurzadresse aus der Kopplung (z. B. `0x1234`) ## Verfügbare Geräte 2 Diese Geräte erscheinen nach dem Import in TapHome. Aqara Temperature, Humidity and Pressure Sensor Modul Serviceattribute | | | |---------------------|-----------------------------------------------------------------------------| | IEEEAddr | Zigbee IEEE-Adresse — eindeutiger 64-Bit-Hardware-Identifikator des Sensors | | ModelId | | | Manufacturer | | | Endpoints | | | Config | | | Verbindungsqualität | Zigbee-Signalstärke — 0 % (kein Signal) bis 100 % (ausgezeichnet) | | Batteriespannung | | | Batteriestand | Geschätzter CR2032-Batteriestand — Warnung bei unter 30 % | Benutzerdefinierte Variablen `GWname` (string) Tasmota MQTT Topic-Name des Zigbee-Gateways (unter Configuration → MQTT → Topic) `ID` (string) Zigbee-Kurzadresse des Sensors (zugewiesen beim Koppeln) After pairing the sensor via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus Lesen (Modul) ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true); var bat := PARSEJSON(ZbReceived, "BatteryPercentage", true); if(!ISNULL(bat), BatteryPercentage := bat); var volt := PARSEJSON(ZbReceived, "BatteryVoltage", true); if(!ISNULL(volt), BatteryVoltage := volt); var deviceInfo := PARSEJSON(RECEIVEDMSG.Payload, "ZbInfo." + ID, true); if !ISNULL(deviceInfo) LastSeenEpoch := PARSEJSON(deviceInfo, "LastSeenEpoch"); COMPLETESERVICEATTRIBUTE("IEEEAddr", PARSEJSON(deviceInfo, "IEEEAddr")); COMPLETESERVICEATTRIBUTE("ModelId", PARSEJSON(deviceInfo, "ModelId")); COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer")); COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints")); COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config")); COMPLETESERVICEATTRIBUTE("Link Quality", ROUND(LINEAR(PARSEJSON(deviceInfo, "LinkQuality"), 0,0, 254, 100)) + "%"); end end if BatteryPercentage < 30 ADDWARNING("Low battery (<30%)"); end if !ISNAN(LastSeenEpoch) DATETIME now := NOW(); var secondsSeen := now.UNIXTIME - LastSeenEpoch; if secondsSeen > 12 * 60 * 60 if secondsSeen > 24 * 60 * 60 ADDERROR("Device is offline > 24H"); else ADDWARNING("Device is offline > 12H"); end end end ``` Serviceattribute IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome BatteryPercentage + "%" ``` Druck Variable Nur lesen Atmosphärischer Druck in hPa — nützlich für Wetterverfolgung und höhenbasierte Automatisierung numeric Einheit: hPa Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Pressure", true); if(!ISNULL(val), Va := val); end ``` Temperatur und Luftfeuchtigkeit Temperatursensor Nur lesen Kombinierte Lufttemperatur (°C) und relative Luftfeuchtigkeit (%) von einem einzelnen Zigbee-Sensor temperature + humidity Einheit: °C / % Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 var temp := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Temperature", true); var hum := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Humidity", true); if (!ISNULL(temp), Te := temp); if (!ISNULL(hum), Hu := hum/ 100); end ``` **Verbindung:** Packet Parser → MQTT Mögliche Verbesserungen (3) - Battery Voltage (device-level) — Battery voltage in mV exposed as a separate entity in zigbee2mqtt. TapHome template reads it as a module-level service attribute instead. - Sensor Calibration Offsets — zigbee2mqtt supports per-sensor calibration offsets for temperature, humidity, and pressure. Not configurable in TapHome template. - Link Quality (device-level) — LinkQuality is available per SENSOR message but only exposed as a module-level service attribute via ZbInfo polling. ## 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` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Quellen - Tasmota Zigbee Documentation [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) 2026-03-29 - Zigbee Compatible Devices Database 2026-03-29 - Aqara Product Page — Temperature and Humidity Sensor [www.aqara.com](https://www.aqara.com/en/product/temperature-humidity-sensor/) 2026-03-29 - Blakadder — Aqara WSDCGQ11LM [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_WSDCGQ11LM.html) 2026-03-29 - zigbee2mqtt — Aqara WSDCGQ11LM [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/WSDCGQ11LM.html) 2026-03-29 ## 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/)