TapHome

Aqara Vibration Sensor

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 03. 2026

Külső átjáró szükséges

tasmota zigbee2tasmota-gateway — termékoldal

Aqara Vibration Sensor

Ez az eszköz Zigbee-n keresztül kommunikál egy Tasmota átjárón át. Győződj meg róla, hogy a Zigbee2Tasmota Gateway sablon importálva van és az eszközöd párosítva van.

Az Aqara DJT11LM egy kompakt, elemes Zigbee rezgésérzékelő, amely háromféle mozgást érzékel: rezgést, dőlést és ejtést. A TapHome-mal MQTT-n keresztül kommunikál egy Zigbee2Tasmota átjárón át — az érzékelő a tele/{gateway}/SENSOR topicon keresztül küldi az eseményadatokat, a sablon pedig a ZbReceived JSON payloadból parszolja a tulajdonosi AqaraVibrationsOrAngle és AqaraVibrationMode mezőket.

Az érzékelő CR2032 gombelelemmel működik (élettartama körülbelül 2 év). A sablon a szervizattribútumokon keresztül figyeli az akkumulátor szintjét és feszültségét, figyelmeztet, ha az szint 30 % alá csökken, és felismeri az eszköz offline állapotait (figyelmeztetés 12 óra, hiba 24 óra után).

Konfiguráció

Az érzékelő párosítása
  1. A Zigbee2Tasmota átjárón engedélyezd a Permit Join funkciót (a TapHome-ban az átjáró sablon kapcsolóján vagy a Tasmota konzolon a ZbPermitJoin 1 paranccsal)
  2. Tartsd nyomva az Aqara rezgésérzékelő gombját, amíg a kék LED villogni nem kezd, majd engedd el
  3. Az érzékelőnek 60 másodpercen belül párosodnia kell
  4. Jegyezd fel a kapott Device ID-t (pl. 0xC9A9) az átjáró szervizattribútumaiból vagy a Tasmota konzolról
Import paraméterek

Párosítás után importáld az eszközsablont ezekkel a paraméterekkel:

ParaméterLeírásPélda
MQTT Broker IP AddressAz MQTT broker IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDRövid Zigbee cím a párosításból0xC9A9

Az Aqara/Xiaomi Zigbee eszközök nem felelnek meg teljes mértékben a Zigbee szabványnak, és csatlakozási problémák léphetnek fel bizonyos Zigbee routerekkel. Az ismert inkompatibilis routerek közé tartozik a Centralite, General Electric, OSRAM, Sylvania, SmartThings és Securifi. Használj olyan routereket, amelyek kompatibilisek a Xiaomi eszközökkel (pl. IKEA TRADFRI).

Eszközképességek

Dőlésszög

A Tilt Angle eszköz a ZbReceived JSON payloadból olvassa az AqaraVibrationsOrAngle mezőt. Az érték fokban, közvetlen hozzárendeléssel kerül jelentésre — a listener szkript minden SENSOR üzenetből parszolja a szöget és azonnal frissíti az érzékelő értékét.

A dőlésszög az érzékelő aktuális orientációját tükrözi ahhoz a felülethez képest, amelyre rögzítve van. Minden alkalommal frissül, amikor az érzékelő dőlési eseményt észlel és SENSOR üzenetet küld.

Rezgésmód

A Vibration Mode eszköz a ZbReceived JSON payloadból olvassa az AqaraVibrationMode mezőt. A szöveges értékeket SWITCH kifejezéssel numerikus állapotokra képezi le:

ÁllapotÉrtékLeírás
Drop0Szabadesés vagy ejtési esemény észlelve
Tilt1Dőlés vagy szögváltozás észlelve
Vibrate2Rezgés vagy érintés észlelve

A mód minden mozgási eseménynél frissül. A 3–9 állapotok a sablonban helyőrzőként vannak definiálva, de a listener szkript nem képezi le őket aktívan — a 4-es érték az ismeretlen módok alapértelmezett fallback értéke.

Akkumulátor és eszközállapot

A modul több szervizattribútumot tesz elérhetővé, amelyeket a ZbInfo lekérdezési mechanizmus tölt fel (1 órás intervallum a ReadScripten keresztül):

  • Battery Percentage — becsült CR2032 akkumulátor szint. Figyelmeztetés jelenik meg, ha 30 % alá csökken.
  • Battery Voltage — aktuális akkumulátor feszültség voltban.
  • Link Quality — Zigbee jelszint 0–254-ről 0–100 %-ra skálázva.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — eszközazonosítás és Zigbee konfigurációs metaadatok.

A sablon a ZbInfo válaszokból a LastSeenEpoch értéket is követi. Ha az érzékelő több mint 12 órája nem volt látható, figyelmeztetés jelenik meg. 24 óra után hiba jelenik meg — ami arra utal, hogy az érzékelő offline lehet, hatótávolságon kívül van vagy lemerült az eleme.

A Zigbee eszközök CR2032 akkumulátor-frissítései akár 24 órát is igénybe vehetnek. A hirtelen csökkenés nem feltétlenül jelenti az elem meghibásodását — várd meg a következő jelentési ciklust.

További képességek

A DJT11LM emellett 3 érzékenységi szintet támogat (alacsony, közepes, magas), amelyek gyártóspecifikus Zigbee parancsokkal konfigurálhatók (ZbSend a Manuf: 0x115F paraméterrel). Egyes Zigbee platformok a dőlésszög mellett külön rezgésintenzitás/számláló értéket is megjeleníthetnek. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az érzékelő nem jelent adatokat
  1. Ellenőrizd, hogy a Zigbee2Tasmota átjáró csatlakozik az MQTT brokerhez és fogadja az üzeneteket (ellenőrizd a tele/{GWname}/SENSOR topicot egy MQTT kliensben)
  2. Győződj meg róla, hogy a sablonban szereplő Device ID megegyezik a párosításkor kiosztott rövid címmel (pl. 0xC9A9)
  3. Ellenőrizd a Link Quality szervizattribútumot — a 20 % alatti értékek gyenge Zigbee jelet jeleznek. Mozgasd az érzékelőt közelebb az átjáróhoz vagy adj hozzá egy kompatibilis Zigbee router eszközt
  4. Nyomd meg egyszer az érzékelő gombját az átvitel kikényszerítéséhez és ellenőrizd, hogy az átjáró fogadta az üzenetet
Rezgésmód fallback értéken ragadt
  1. Ellenőrizd a Zigbee2Tasmota firmware verziót — az AqaraVibrationMode mező tulajdonosi Aqara Zigbee attribútumokat használ, amelyekhez naprakész firmware szükséges
  2. Ellenőrizd, hogy a ZbReceived payload tartalmazza az AqaraVibrationMode mezőt (használj MQTT klienst a nyers tele/{GWname}/SENSOR üzenetek vizsgálatához)
  3. Ha a mód mindig 4-es értéket (fallback) jelez, az eszköz ismeretlen eseménytípust küldhet — ellenőrizd a Tasmota konzolt a teljes JSON payloadért
Az eszköz offline figyelmeztetést mutat
  1. Ellenőrizd az akkumulátor szintet — a lemerült CR2032 az érzékelő adásának leállását okozza
  2. Az Aqara rezgésérzékelő Zigbee végeszköz (nem router), és a közeli Zigbee routereken keresztül kommunikál. Ha egy router leáll, az érzékelő elérhetetlenné válhat
  3. Próbáld megnyomni az érzékelő gombját az ébresztéséhez és a Zigbee hálózathoz való újracsatlakozás kikényszerítéséhez
  4. Ha a probléma fennáll, párosítsd újra az eszközt a gomb nyomva tartásával, amíg a kék LED villogni nem kezd
Érzékenység manuális beállítása

A TapHome sablon nem tartalmaz érzékenységi konfigurációt. Az érzékenység módosításához használd közvetlenül a Tasmota konzolt:

  • Alacsony érzékenység: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":21}}
  • Közepes érzékenység: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":11}}
  • Magas érzékenység (alapértelmezett): ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":1}}

Cseréld ki a 0xC9A9 értéket az érzékelő valódi Device ID-jére.

Telepítés a TapHome-ban

Előfeltételek

  • Zigbee átjáró Tasmota firmware-rel (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker a helyi hálózaton (TapHome beépített broker vagy külső)
  • TapHome CCU ugyanazon a hálózaton

A TapHome rendelkezik beépített MQTT brokerrel — aktiválja a Beállítások → Hardware → MQTT Broker menüpontban. Nincs szükség további szoftverre.

1. lépés — Tasmota Zigbee átjáró beállítása

  1. Telepítse a Tasmota firmware-t egy támogatott Zigbee koordinátorra (pl. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Csatlakoztassa az átjárót a Wi-Fi hálózathoz a Tasmota webes felületén
  3. Navigáljon a Configuration → Configure MQTT menüpontra és állítsa be:
    • Host: az MQTT broker IP-címe (pl. 192.168.1.10)
    • Port: 1883
    • Topic: jegyezze fel a topic nevét (pl. tasmota_XXXXX) — szükség lesz rá a sablon importálásakor

Részletes útmutatót a Tasmota Zigbee dokumentációban talál.

2. lépés — Átjáró sablon importálása a TapHome-ba

  1. Töltse le az átjáró sablont a Zigbee2Tasmota Gateway kompatibilitási oldalról
  2. A TapHome-ban lépjen a Beállítások → Hardware → Packet Parser → Import menüpontra
  3. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: a broker IP-címe (pl. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: a Tasmota MQTT topic az 1. lépésből (pl. tasmota_XXXXX)

Importálás után két eszköz jelenik meg: Permit Join (kapcsoló) és Devices Found (számláló).

3. lépés — Zigbee eszköz párosítása

  1. A TapHome-ban kapcsolja be a Permit Join kapcsolót — megnyílik egy 60 másodperces párosítási ablak
  2. A Zigbee eszközön indítsa el a párosítási folyamatot (jellemzően tartsa lenyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd)
  3. Figyelje a Devices Found számlálót — növekszik, amikor új eszköz csatlakozik
  4. Ellenőrizze az átjáró Service Attributes részét az új eszköz azonosítójának (pl. 0x1234), gyártójának és modelljének megtekintéséhez
  5. A párosítási mód automatikusan deaktiválódik az időkorlát lejártakor

4. lépés — Eszközsablon importálása

  1. Töltse le az eszközspecifikus sablont a megfelelő kompatibilitási oldalról
  2. Importálja a sablont ezekkel a paraméterekkel:
    • MQTT Broker IP Address: ugyanaz, mint az átjáróé
    • MQTT Broker Port: 1883
    • Gateway name: ugyanaz a Tasmota MQTT topic, mint fentebb
    • Device ID: a párosításból kapott rövid cím (pl. 0x1234)

Elérhető eszközök

Aqara Vibration Sensor Modul
Szerviz attribútumok
IEEEAddr
ModelId
Gyártó
Endpoints
Config
JelminőségZigbee jelszint — 0 % (nincs jel) – 100 % (kiváló)
Akkumulátor feszültség
Akkumulátor szintBecsült CR2032 akkumulátor szint — figyelmeztetés 30 % alatt
Egyéni változók
GWname (string)Tasmota MQTT topic name of the Zigbee gateway (found in Configuration → MQTT → Topic)
ID (string) = 0xC9A9Zigbee short address of the Aqara Vibration 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 - Vibration Sensor

Olvasás (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Figyelő
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
Szerviz attribútumok
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Dőlésszög Változó Csak olvasható

Aktuális dőlésszög fokban — AqaraVibrationsOrAngle olvasása a Zigbee érzékelő payloadjából

numeric Egység: °

Dőlésszög

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".AqaraVibrationsOrAngle", true);
    if(!ISNULL(val), Va := val);
end
Rezgésmód Többértékű kapcsoló Csak olvasható

Észlelt mozgás típusa — Drop (0), Tilt (1) vagy Vibrate (2) az AqaraVibrationMode mezőből

string → enum SWITCH mapping
Értékek / Állapotok: Drop · Tilt · Vibrate · ???

Rezgésmód

Figyelő
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
Kapcsolat: Packet Parser → MQTT
Lehetséges fejlesztések (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).

Források