TapHome

Aqara Vibration Sensor

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

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Aqara Vibration 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 DJT11LM je kompaktan Zigbee senzor vibracija na bateriju koji prepoznaje tri vrste pokreta: vibraciju, naginjanje i pad. Sa sustavom TapHome komunicira preko protokola MQTT putem pristupnika Zigbee2Tasmota. Senzor šalje podatke o događajima na temu tele/{gateway}/SENSOR, a predložak iz JSON poruke ZbReceived čita vlasnička polja AqaraVibrationsOrAngle i AqaraVibrationMode.

Senzor se napaja gumbastom baterijom CR2032 (trajanje oko 2 godine). 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 na Aqara senzoru vibracija dok plava LED dioda ne počne treptati, a zatim je otpustite
  3. Senzor bi se trebao upariti u roku od 60 sekundi
  4. Zapišite dodijeljeni Device ID (npr. 0xC9A9) 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 uparivanju0xC9A9

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

Kut nagiba

Uređaj Kut nagiba čita polje AqaraVibrationsOrAngle iz JSON poruke ZbReceived. Vrijednost se javlja u stupnjevima i izravno se preuzima. Skripta za primanje (listener) čita kut iz svake poruke SENSOR i odmah ažurira vrijednost senzora.

Kut nagiba pokazuje trenutačni položaj senzora u odnosu na površinu na koju je pričvršćen. Ažurira se svaki put kad senzor prepozna naginjanje i pošalje poruku SENSOR.

Način vibracije

Uređaj Način vibracije čita polje AqaraVibrationMode iz JSON poruke ZbReceived. Tekstualne vrijednosti pretvara u brojčana stanja pomoću izraza SWITCH:

StanjeVrijednostOpis
Drop0Prepoznat slobodan pad ili ispuštanje
Tilt1Prepoznato naginjanje ili promjena kuta
Vibrate2Prepoznata vibracija ili dodir

Način se ažurira pri svakom pokretu. Stanja 3–9 u predlošku su definirana kao rezervirana mjesta, ali ih skripta za primanje ne mapira. Vrijednost 4 koristi se kao zadana zamjenska vrijednost za svaki neprepoznati način.

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

DJT11LM podržava i 3 razine osjetljivosti (niska, srednja, visoka) koje se postavljaju Zigbee naredbama specifičnima za proizvođača (ZbSend s Manuf: 0x115F). Neke Zigbee platforme uz kut nagiba prikazuju i zasebnu vrijednost jačine ili broja vibracija. 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. 0xC9A9)
  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
Način vibracije ostaje na zamjenskoj vrijednosti
  1. Provjerite verziju firmvera Zigbee2Tasmota. Polje AqaraVibrationMode koristi vlasničke Aqara Zigbee atribute za koje je potreban ažuran firmver
  2. Provjerite sadrži li poruka ZbReceived polje AqaraVibrationMode (neobrađene poruke tele/{GWname}/SENSOR pregledajte MQTT klijentom)
  3. Ako Način vibracije uvijek ima vrijednost 4 (zamjenska vrijednost), uređaj možda šalje neprepoznatu vrstu događaja. Cijelu JSON poruku provjerite u konzoli Tasmota
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 vibracija 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 držite tipku dok plava LED dioda ne trepne
Ručno podešavanje osjetljivosti

Predložak TapHome ne sadrži postavke osjetljivosti. Osjetljivost promijenite izravno u konzoli Tasmota:

  • Niska osjetljivost: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":21}}
  • Srednja osjetljivost: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":11}}
  • Visoka osjetljivost (zadano): ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":1}}

Umjesto 0xC9A9 upišite stvarni Device ID senzora.

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 Vibration Sensor Modul
Servisni atributi
IEEEAddr
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) = 0xC9A9Kratka 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 - Vibration 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 + "%"
Kut nagiba Varijabla Samo za čitanje

Trenutačni kut nagiba u stupnjevima — čita AqaraVibrationsOrAngle iz poruke Zigbee senzora

numeric Jedinica: °

Kut nagiba

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".AqaraVibrationsOrAngle", true);
    if(!ISNULL(val), Va := val);
end
Način vibracije Prekidač s više vrijednosti Samo za čitanje

Vrsta prepoznatog pokreta — Drop (0), Tilt (1) ili Vibrate (2) iz polja AqaraVibrationMode

string → enum SWITCH mapping
Vrijednosti / stanja: Drop · Tilt · Vibrate · ???

Način vibracije

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".AqaraVibrationMode", true);
    if (!ISNULL(val), SWITCH(val,
    "drop", Mu := 0,
    "tilt", Mu := 1,
    "vibrate", Mu := 2,
    Mu := 4));
end
Povezivanje: Packet Parser → MQTT
Moguća poboljšanja (3)
  • Vibration Sensitivity — The DJT11LM supports 3 sensitivity levels (low/medium/high) via manufacturer-specific Zigbee commands (Manuf: 0x115F, cluster 0x0000, attribute 0xFF0D). Not configurable in TapHome template — requires manual ZbSend command via Tasmota console.
  • Link Quality (device-level) — LinkQuality is available per SENSOR message but only exposed as a module-level service attribute via ZbInfo polling.
  • Vibration Count / Intensity — Some Zigbee platforms expose a vibration intensity or count value separately from the angle. The TapHome template only parses AqaraVibrationsOrAngle (angle) and AqaraVibrationMode (event type).

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