TapHome

Aqara Temperature, Humidity and Pressure Sensor

Packet Parser → MQTT
Trimis de
Ultima actualizare: 10. 2026

Necesită gateway extern

tasmota zigbee2tasmota-gateway — pagina produsului

Aqara Temperature, Humidity and Pressure Sensor

Acest dispozitiv comunică prin Zigbee printr-un gateway Tasmota. Înainte de a continua, asigurați-vă că ați importat șablonul Zigbee2Tasmota Gateway și ați împerecheat dispozitivul.

Aqara WSDCGQ11LM este un senzor Zigbee compact, alimentat cu baterie, care măsoară temperatura ambiantă, umiditatea relativă și presiunea atmosferică. Comunică cu TapHome prin MQTT, printr-un gateway Zigbee2Tasmota — senzorul trimite periodic citirile pe topicul tele/{gateway}/SENSOR, iar șablonul procesează payloadul JSON ZbReceived.

Senzorul este alimentat de o baterie tip monedă CR2032. Șablonul monitorizează nivelul și tensiunea bateriei prin atribute de service, avertizează când nivelul bateriei scade sub 30 % și detectează starea offline a dispozitivului (avertisment după 12 ore, eroare după 24 de ore).

Configurare

Împerecherea senzorului
  1. Pe gateway-ul Zigbee2Tasmota, activați Permit Join (prin comutatorul șablonului gateway-ului în TapHome sau cu comanda ZbPermitJoin 1 în consola Tasmota)
  2. Țineți apăsat butonul de resetare al senzorului Aqara aproximativ 5 secunde, până când LED-ul albastru clipește
  3. Eliberați butonul — senzorul ar trebui să se împerecheze în 60 de secunde
  4. Notați Device ID-ul atribuit (de ex. 0x1234) din atributele de service ale gateway-ului sau din consola Tasmota
Parametrii de import

După împerechere, importați șablonul dispozitivului cu acești parametri:

ParametruDescriereExemplu
MQTT Broker IP AddressAdresa IP a brokerului MQTT192.168.1.10
MQTT Broker PortPortul brokerului (implicit 1883)1883
Gateway nameTopicul MQTT Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDAdresa scurtă Zigbee de la împerechere0x1234

Dispozitivele Zigbee Aqara/Xiaomi nu respectă pe deplin standardul Zigbee și pot avea probleme de conectivitate cu anumite routere Zigbee. Routerele incompatibile cunoscute sunt Centralite, General Electric, OSRAM, Sylvania, SmartThings și Securifi. Folosiți routere confirmate ca fiind compatibile cu dispozitivele Xiaomi (de ex. IKEA TRADFRI).

Funcțiile dispozitivului

Temperatură și umiditate

Dispozitivul Temperatură și umiditate citește câmpurile Temperature și Humidity din payloadul JSON ZbReceived. Temperatura este raportată în °C, ca valoare directă. Umiditatea este raportată ca număr întreg brut (de ex. 4520 pentru 45,20 %) și este împărțită la 100 în scriptul listener, pentru a obține raportul pe care TapHome îl afișează ca procent.

Ambele valori se actualizează de fiecare dată când senzorul transmite un mesaj SENSOR — de obicei la câteva minute sau la o schimbare semnificativă.

Presiune atmosferică

Dispozitivul Presiune citește câmpul Pressure din payloadul JSON ZbReceived. Valoarea este raportată în hPa (hectopascali) și este mapată prin ValueLogTypeConversion din tipul brut 62 în tipul de presiune 25, cu o scală liniară 1:1.

Presiunea atmosferică poate fi folosită pentru monitorizarea tendințelor meteo sau pentru smart rules bazate pe altitudine.

Bateria și starea dispozitivului

Modulul pune la dispoziție mai multe atribute de service, completate prin mecanismul de interogare ZbInfo (interval de 1 oră, prin ReadScript):

  • Nivelul bateriei — nivelul estimat al bateriei CR2032. Se generează un avertisment când nivelul scade sub 30 %.
  • Tensiunea bateriei — tensiunea curentă a bateriei, în volți.
  • Calitatea legăturii — puterea semnalului Zigbee, scalată de la 0–254 la 0–100 %.
  • IEEEAddr, ModelId, Producător, Endpointuri, Config — identificarea dispozitivului și metadatele configurației Zigbee.

Șablonul urmărește și LastSeenEpoch din răspunsurile ZbInfo. Dacă senzorul nu a mai trimis niciun mesaj de mai mult de 12 ore, se generează un avertisment. După 24 de ore se generează o eroare — senzorul poate fi offline, în afara razei de acoperire sau cu bateria descărcată.

Actualizarea informațiilor despre bateria CR2032 de la dispozitivele Zigbee poate dura până la 24 de ore. O scădere bruscă nu înseamnă neapărat că bateria se defectează — așteptați următorul ciclu de raportare.

Funcții suplimentare

WSDCGQ11LM acceptă și decalaje de calibrare separate pentru citirile de temperatură, umiditate și presiune (disponibile în zigbee2mqtt). În unele stive Zigbee, tensiunea bateriei este pusă la dispoziție și ca entitate separată la nivel de dispozitiv. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

Rezolvarea problemelor

Senzorul nu raportează date
  1. Verificați dacă gateway-ul Zigbee2Tasmota este conectat la brokerul MQTT și primește mesaje (verificați tele/{GWname}/SENSOR într-un client MQTT)
  2. Verificați dacă Device ID-ul din șablon corespunde adresei scurte atribuite la împerechere (de ex. 0x1234)
  3. Verificați atributul de service Calitatea legăturii — valorile sub 20 % indică un semnal Zigbee slab. Apropiați senzorul de gateway sau adăugați un dispozitiv router Zigbee compatibil
  4. Apăsați o dată butonul senzorului pentru a forța o transmisie și verificați dacă gateway-ul primește mesajul
Valoarea umidității pare incorectă

Șablonul împarte valoarea Humidity la 100 (de ex. 45.2 devine 0,452 și se afișează ca 45,2 %). Dacă valoarea este de 100 de ori prea mare sau prea mică, verificați valoarea Humidity în consola Tasmota — șablonul o așteaptă în procente.

Dispozitivul afișează avertismentul offline
  1. Verificați nivelul bateriei — o baterie CR2032 descărcată face ca senzorul să nu mai transmită
  2. Senzorul Aqara este un dispozitiv final Zigbee (nu un router) și comunică prin dispozitivele router Zigbee din apropiere. Dacă un router devine offline, senzorul poate deveni inaccesibil
  3. Încercați să apăsați butonul senzorului pentru a-l trezi și a forța reasocierea cu rețeaua Zigbee
  4. Dacă problema persistă, împerecheați din nou dispozitivul ținând apăsat butonul de resetare 5 secunde, până când LED-ul albastru clipește

Cum se instalează în TapHome

Cerințe preliminare

  • Gateway Zigbee cu firmware Tasmota (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  • Broker MQTT care rulează în rețeaua dvs. locală (brokerul integrat TapHome sau unul extern)
  • TapHome CCU în aceeași rețea

TapHome are un broker MQTT integrat — activați-l în Setări → Hardware → MQTT Broker. Nu este necesar niciun software suplimentar.

Pasul 1 — Configurați gateway-ul Zigbee Tasmota

  1. Încărcați firmware-ul Tasmota pe un coordonator Zigbee acceptat (de ex. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Conectați gateway-ul la rețeaua dvs. Wi-Fi prin interfața web Tasmota
  3. Accesați Configuration → Configure MQTT și setați:
    • Host: adresa IP a brokerului dvs. MQTT (de ex. 192.168.1.10)
    • Port: 1883
    • Topic: notați numele topicului (de ex. tasmota_XXXXX) — veți avea nevoie de el la importul șablonului

Pentru instrucțiuni detaliate, consultați documentația Tasmota Zigbee.

Pasul 2 — Importați șablonul gateway-ului în TapHome

  1. Descărcați șablonul gateway-ului de pe pagina de compatibilitate Zigbee2Tasmota Gateway
  2. În TapHome, accesați Setări → Hardware → Packet Parser → Import
  3. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: adresa IP a brokerului dvs. (de ex. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: topicul MQTT Tasmota de la pasul 1 (de ex. tasmota_XXXXX)

După import veți vedea două dispozitive: Permit Join (comutator) și Dispozitive găsite (contor).

Pasul 3 — Împerecheați un dispozitiv Zigbee

  1. În TapHome, porniți comutatorul Permit Join — se deschide o fereastră de împerechere de 60 de secunde
  2. Pe dispozitivul Zigbee, porniți procedura de împerechere (de obicei țineți apăsat butonul de resetare 5 secunde, până când LED-ul clipește)
  3. Urmăriți contorul Dispozitive găsite — crește când se conectează un dispozitiv nou
  4. Verificați atributele de service ale gateway-ului pentru a vedea ID-ul noului dispozitiv (de ex. 0x1234), producătorul și modelul
  5. Modul de împerechere se dezactivează automat după expirarea timpului

Pasul 4 — Importați șablonul dispozitivului

  1. Descărcați șablonul specific dispozitivului de pe pagina de compatibilitate corespunzătoare
  2. Importați șablonul cu acești parametri:
    • MQTT Broker IP Address: aceeași ca la gateway
    • MQTT Broker Port: 1883
    • Gateway name: același topic MQTT Tasmota ca mai sus
    • Device ID: adresa scurtă de la împerechere (de ex. 0x1234)

Dispozitive disponibile

Aqara Temperature, Humidity and Pressure Sensor Modul
Atribute de service
IEEEAddrAdresa IEEE Zigbee — identificatorul hardware unic de 64 de biți al senzorului
ModelId
Producător
Endpointuri
Config
Calitatea legăturiiPuterea semnalului Zigbee — de la 0 % (fără semnal) la 100 % (excelent)
Tensiunea bateriei
Nivelul baterieiNivelul estimat al bateriei CR2032 — avertisment sub 30 %
Variabile personalizate
GWname (string)Numele topicului MQTT Tasmota al gateway-ului Zigbee (se găsește în Configuration → MQTT → Topic)
ID (string)Adresa scurtă Zigbee a senzorului (atribuită la împerechere)
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

Citire (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Ascultător
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
Atribute de service
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Presiune Variabilă Doar citire

Presiunea atmosferică în hPa — utilă pentru urmărirea vremii și pentru automatizări bazate pe altitudine

numeric Unitate: hPa

Presiune

Ascultător
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Pressure", true);
    if(!ISNULL(val), Va := val);
end
Temperatură și umiditate Senzor de temperatură Doar citire

Temperatura aerului (°C) și umiditatea relativă (%) de la un singur senzor Zigbee

temperature + humidity Unitate: °C / %

Temperatură și umiditate

Ascultător
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
Conexiune: Packet Parser → MQTT
Îmbunătățiri posibile (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.

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal