TapHome

Aqara Temperature, Humidity and Pressure Sensor

Packet Parser → MQTT
Autor
Posljednje ažuriranje: 10. 2026

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Aqara Temperature, Humidity and Pressure Sensor

Ovaj uređaj komunicira preko protokola Zigbee putem pristupnika Tasmota. Prije nastavka provjerite jeste li uvezli predložak Zigbee2Tasmota Gateway i uparili uređaj.

Aqara WSDCGQ11LM je kompaktan Zigbee senzor na bateriju koji mjeri temperaturu okoline, relativnu vlažnost i atmosferski tlak. Sa sustavom TapHome komunicira preko protokola MQTT putem pristupnika Zigbee2Tasmota. Senzor periodično šalje očitanja na temu tele/{gateway}/SENSOR, a predložak raščlanjuje JSON poruku ZbReceived.

Senzor se napaja gumbastom baterijom CR2032. Predložak prati razinu i napon baterije putem servisnih atributa, upozorava kad razina baterije padne ispod 30 % i prepoznaje kad je uređaj izvan mreže (upozorenje nakon 12 sati, pogreška nakon 24 sata).

Konfiguracija

Uparivanje senzora
  1. Na pristupniku Zigbee2Tasmota uključite Permit Join (sklopkom u predlošku pristupnika u sustavu TapHome ili naredbom ZbPermitJoin 1 u konzoli Tasmota)
  2. Pritisnite i držite tipku za resetiranje na Aqara senzoru oko 5 sekundi, dok plava LED dioda ne trepne
  3. Otpustite tipku. Senzor bi se trebao upariti u roku od 60 sekundi
  4. Zapišite dodijeljeni Device ID (npr. 0x1234) iz servisnih atributa pristupnika ili iz konzole Tasmota
Parametri uvoza

Nakon uparivanja uvezite predložak uređaja s ovim parametrima:

ParametarOpisPrimjer
MQTT Broker IP AddressIP adresa MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (zadano 1883)1883
Gateway nameMQTT tema uređaja Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKratka Zigbee adresa dobivena pri uparivanju0x1234

Zigbee uređaji Aqara/Xiaomi ne poštuju u potpunosti Zigbee standard pa s nekim Zigbee usmjerivačima (routerima) mogu imati problema s vezom. Poznati nekompatibilni usmjerivači su Centralite, General Electric, OSRAM, Sylvania, SmartThings i Securifi. Koristite usmjerivače za koje je potvrđena kompatibilnost s uređajima Xiaomi (npr. IKEA TRADFRI).

Mogućnosti uređaja

Temperatura i vlaga

Uređaj Temperatura i vlaga čita polja Temperature i Humidity iz JSON poruke ZbReceived. Temperatura se javlja izravno u °C. Vlažnost se javlja kao neobrađeni cijeli broj (npr. 4520 za 45,20 %) i u skripti za primanje (listener) dijeli se sa 100, čime nastaje omjer koji TapHome prikazuje kao postotak.

Obje vrijednosti ažuriraju se svaki put kad senzor pošalje poruku SENSOR, obično svakih nekoliko minuta ili pri značajnoj promjeni.

Atmosferski tlak

Uređaj Tlak čita polje Pressure iz JSON poruke ZbReceived. Vrijednost se javlja u hPa (hektopaskalima) i pomoću ValueLogTypeConversion pretvara se iz neobrađenog tipa 62 u tip tlaka 25 s linearnim omjerom 1:1.

Atmosferski tlak može se koristiti za praćenje promjena vremenskih prilika ili za smart rules prema nadmorskoj visini.

Baterija i stanje uređaja

Modul prikazuje nekoliko servisnih atributa čije vrijednosti ažurira periodični upit ZbInfo (svakih sat vremena putem skripte ReadScript):

  • Razina baterije — procijenjena razina baterije CR2032. Kad razina padne ispod 30 %, pojavljuje se upozorenje.
  • Napon baterije — trenutačni napon baterije u voltima.
  • Kvaliteta veze — jačina Zigbee signala preračunata iz raspona 0–254 u 0–100 %.
  • IEEEAddr, ModelId, Proizvođač, Endpoints, Config — identifikacija uređaja i metapodaci Zigbee konfiguracije.

Predložak prati i LastSeenEpoch iz odgovora ZbInfo. Ako se senzor nije javio dulje od 12 sati, pojavljuje se upozorenje. Nakon 24 sata pojavljuje se pogreška, što znači da je senzor možda izvan mreže, izvan dometa ili mu je baterija ispražnjena.

Osvježavanje podataka o bateriji CR2032 iz Zigbee uređaja može potrajati do 24 sata. Nagli pad ne znači nužno da je baterija pri kraju. Pričekajte sljedeći ciklus javljanja.

Dodatne mogućnosti

WSDCGQ11LM podržava i korekciju (kalibracijski pomak) za očitanja temperature, vlažnosti i tlaka za svaki senzor posebno (dostupno u zigbee2mqtt). Napon baterije u nekim Zigbee sustavima dostupan je i kao zaseban entitet na razini uređaja. Ove mogućnosti mogu se dodati u nekom od budućih ažuriranja predloška.

Rješavanje problema

Senzor ne šalje podatke
  1. Provjerite je li pristupnik Zigbee2Tasmota spojen na MQTT broker i prima li poruke (provjerite tele/{GWname}/SENSOR u MQTT klijentu)
  2. Provjerite odgovara li Device ID u predlošku kratkoj adresi dodijeljenoj pri uparivanju (npr. 0x1234)
  3. Provjerite servisni atribut Kvaliteta veze. Vrijednosti ispod 20 % znače slab Zigbee signal. Približite senzor pristupniku ili dodajte kompatibilan Zigbee usmjerivač
  4. Jednom pritisnite tipku senzora kako biste potaknuli slanje poruke i provjerite prima li je pristupnik
Očitanje vlažnosti čini se netočnim

Predložak dijeli vrijednost Humidity sa 100 (npr. 45.2 postaje 0,452 i prikazuje se kao 45,2 %). Ako je očitanje 100 puta previsoko ili prenisko, provjerite vrijednost Humidity u konzoli Tasmota: predložak je očekuje u postocima.

Uređaj prikazuje upozorenje da je izvan mreže
  1. Provjerite razinu baterije. Kad je CR2032 ispražnjena, senzor prestaje slati podatke
  2. Aqara senzor je Zigbee krajnji uređaj (end device, nije usmjerivač) i komunicira preko obližnjih Zigbee usmjerivača. Ako usmjerivač ode izvan mreže, senzor može postati nedostupan
  3. Pritisnite tipku senzora kako biste ga probudili i potaknuli ponovno povezivanje sa Zigbee mrežom
  4. Ako problem i dalje postoji, ponovno uparite uređaj tako da 5 sekundi držite tipku za resetiranje dok plava LED dioda ne trepne

Kako ga instalirati u TapHome

Preduvjeti

  • Zigbee pristupnik s firmverom Tasmota (npr. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker koji radi u vašoj lokalnoj mreži (ugrađeni broker TapHome ili vanjski)
  • TapHome CCU u istoj mreži

TapHome ima ugrađeni MQTT broker — uključite ga u Postavke → Hardver → MQTT Broker. Nije potreban nikakav dodatni softver.

Korak 1 — Postavite Tasmota Zigbee pristupnik

  1. Na podržani Zigbee koordinator (npr. Sonoff ZBBridge, eWeLink ZB-GW03) učitajte firmver Tasmota
  2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
  3. Idite na Configuration → Configure MQTT i postavite:
    • Host: IP adresu vašeg MQTT brokera (npr. 192.168.1.10)
    • Port: 1883
    • Topic: zapišite naziv teme (npr. tasmota_XXXXX) — trebat će vam pri uvozu predloška

Detaljne upute potražite u dokumentaciji Tasmota Zigbee.

Korak 2 — Uvezite predložak pristupnika u sustav TapHome

  1. Preuzmite predložak pristupnika sa stranice kompatibilnosti Zigbee2Tasmota Gateway
  2. U sustavu TapHome idite na Postavke → Hardver → Packet Parser → Uvoz
  3. Uvezite predložak s ovim parametrima:
    • MQTT Broker IP Address: IP adresa vašeg brokera (npr. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT tema iz koraka 1 (npr. tasmota_XXXXX)

Nakon uvoza vidjet ćete dva uređaja: Permit Join (sklopka) i Pronađeni uređaji (brojač).

Korak 3 — Uparite Zigbee uređaj

  1. U sustavu TapHome uključite sklopku Permit Join — otvara se razdoblje od 60 sekundi za uparivanje
  2. Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
  3. Pratite brojač Pronađeni uređaji — povećava se kada se pridruži novi uređaj
  4. U Servisnim atributima pristupnika pogledajte ID novog uređaja (npr. 0x1234), proizvođača i model
  5. Način uparivanja automatski se isključuje nakon isteka vremena

Korak 4 — Uvezite predložak uređaja

  1. Preuzmite predložak za konkretni uređaj s odgovarajuće stranice kompatibilnosti
  2. Uvezite predložak s ovim parametrima:
    • MQTT Broker IP Address: ista kao za pristupnik
    • MQTT Broker Port: 1883
    • Gateway name: ista Tasmota MQTT tema kao gore
    • Device ID: kratka adresa iz uparivanja (npr. 0x1234)

Dostupni uređaji

Aqara Temperature, Humidity and Pressure Sensor Modul
Servisni atributi
IEEEAddrZigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator senzora
ModelId
Proizvođač
Endpoints
Config
Kvaliteta vezeJačina Zigbee signala — od 0 % (nema signala) do 100 % (izvrstan)
Napon baterije
Razina baterijeProcijenjena razina baterije CR2032 — upozorenje ispod 30 %
Prilagođene varijable
GWname (string)Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic)
ID (string)Kratka Zigbee adresa senzora (dodjeljuje se pri uparivanju)
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

Čitanje (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
Servisni atributi
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Tlak Varijabla Samo za čitanje

Atmosferski tlak u hPa — koristan za praćenje vremenskih prilika i automatizaciju prema nadmorskoj visini

numeric Jedinica: hPa

Tlak

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Pressure", true);
    if(!ISNULL(val), Va := val);
end
Temperatura i vlaga Senzor temperature Samo za čitanje

Temperatura zraka (°C) i relativna vlažnost (%) iz jednog Zigbee senzora

temperature + humidity Jedinica: °C / %

Temperatura i vlaga

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
Povezivanje: Packet Parser → MQTT
Moguća poboljšanja (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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu