TapHome

Aqara Temperature, Humidity and Pressure Sensor

Packet Parser → MQTT
Eingereicht von
Zuletzt aktualisiert: 03. 2026

Erfordert externes Gateway

tasmota zigbee2tasmota-gateway — Produktseite

Aqara Temperature, Humidity and Pressure Sensor

Dieses Gerät kommuniziert über Zigbee durch ein Tasmota-Gateway. Stellen Sie sicher, dass die Vorlage 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:

ParameterBeschreibungBeispiel
MQTT Broker IP AddressIP-Adresse des MQTT-Brokers192.168.1.10
MQTT Broker PortBroker-Port (Standard 1883)1883
Gateway nameTasmota MQTT-Topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKurze Zigbee-Adresse vom Koppeln0x1234

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.

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 rohen Humidity-Wert durch 100 (z. B. 4520 wird zu 0,4520, angezeigt als 45,20 %). Wenn der Wert zu niedrig erscheint (z. B. 0,45 % statt 45 %), überprüfen Sie die Zigbee2Tasmota-Firmware-Version — einige Firmware-Versionen melden die Feuchtigkeit bereits im Prozentformat, wodurch die Division unnötig wird.

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

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 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: IP-Adresse Ihres MQTT-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.

Schritt 2 — Gateway-Vorlage in TapHome importieren

  1. Laden Sie die Gateway-Vorlage von der Kompatibilitätsseite 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: 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

Aqara Temperature, Humidity and Pressure Sensor Modul
Serviceattribute
IEEEAddrZigbee IEEE-Adresse — eindeutiger 64-Bit-Hardware-Identifikator des Sensors
ModelId
Manufacturer
Endpoints
Config
VerbindungsqualitätZigbee-Signalstärke — 0 % (kein Signal) bis 100 % (ausgezeichnet)
Batteriespannung
BatteriestandGeschätzter CR2032-Batteriestand — Warnung bei unter 30 %
Benutzerdefinierte Variablen
GWname (string)Tasmota MQTT topic name of the Zigbee gateway (found in Configuration → MQTT → Topic)
ID (string)Zigbee short address of the Aqara Temperature, Humidity and Pressure Sensor (assigned during pairing)
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

Aqara - Temperature, Humidity and Pressure Sensor

Lesen (Modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Listener
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
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Druck Variable Nur lesen

Atmosphärischer Druck in hPa — nützlich für Wetterverfolgung und höhenbasierte Automatisierung

numeric Einheit: hPa

Druck

Listener
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 / %

Temperatur und Luftfeuchtigkeit

Listener
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.

Quellen