TapHome

Aqara Vibration Sensor

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 03. 2026

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Vibration Sensor

Toto zariadenie komunikuje cez Zigbee prostredníctvom brány Tasmota. Uistite sa, že máte importovanú šablónu Zigbee2Tasmota Gateway a vaše zariadenie je spárované.

Aqara DJT11LM je kompaktný batériovo napájaný Zigbee vibračný senzor, ktorý deteguje tri typy pohybu: vibrácie, náklon a pád. S TapHome komunikuje cez MQTT prostredníctvom brány Zigbee2Tasmota — senzor odosiela údaje o udalostiach cez topic tele/{gateway}/SENSOR a šablóna parsuje proprietárne polia AqaraVibrationsOrAngle a AqaraVibrationMode z JSON payloadu ZbReceived.

Senzor je napájaný gombíkovou batériou CR2032 (životnosť približne 2 roky). Šablóna monitoruje úroveň a napätie batérie cez servisné atribúty, upozorní pri poklese pod 30 % a deteguje offline stavy zariadenia (varovanie po 12 hodinách, chyba po 24 hodinách).

Konfigurácia

Spárovanie senzora
  1. Na bráne Zigbee2Tasmota aktivujte Permit Join (cez prepínač šablóny brány v TapHome alebo príkazom ZbPermitJoin 1 v konzole Tasmota)
  2. Stlačte a podržte tlačidlo na vibračnom senzore Aqara, kým nezačne blikať modrá LED, potom pustite
  3. Senzor by sa mal spárovať do 60 sekúnd
  4. Poznačte si pridelené Device ID (napr. 0xC9A9) zo servisných atribútov brány alebo z konzoly Tasmota
Parametre importu

Po spárovaní importujte šablónu zariadenia s týmito parametrami:

ParameterPopisPríklad
MQTT Broker IP AddressIP adresa MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolene 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátka Zigbee adresa z párovania0xC9A9

Zariadenia Aqara/Xiaomi Zigbee nie sú plne kompatibilné so štandardom Zigbee a môžu mať problémy s pripojením k niektorým Zigbee routerom. Medzi známe nekompatibilné routery patria Centralite, General Electric, OSRAM, Sylvania, SmartThings a Securifi. Používajte routery potvrdené ako kompatibilné so zariadeniami Xiaomi (napr. IKEA TRADFRI).

Funkcie zariadenia

Uhol náklonu

Zariadenie Tilt Angle číta pole AqaraVibrationsOrAngle z JSON payloadu ZbReceived. Hodnota sa hlási v stupňoch priamym priradením — listener skript parsuje uhol z každej správy SENSOR a okamžite aktualizuje hodnotu senzora.

Uhol náklonu odráža aktuálnu orientáciu senzora voči povrchu, na ktorom je pripevnený. Aktualizuje sa vždy, keď senzor zaznamená udalosť náklonu a odošle správu SENSOR.

Režim vibrácií

Zariadenie Vibration Mode číta pole AqaraVibrationMode z JSON payloadu ZbReceived. Mapuje textové hodnoty na číselné stavy pomocou výrazu SWITCH:

StavHodnotaPopis
Drop0Detegovaný voľný pád alebo upadnutie
Tilt1Detegovaný náklon alebo zmena uhla
Vibrate2Detegované vibrácie alebo dotyk

Režim sa aktualizuje pri každej udalosti pohybu. Stavy 3–9 sú v šablóne definované ako zástupné, ale nie sú aktívne mapované listener skriptom — hodnota 4 sa používa ako predvolený fallback pre nerozpoznaný režim.

Batéria a stav zariadenia

Modul poskytuje niekoľko servisných atribútov napĺňaných mechanizmom ZbInfo (interval 1 hodina cez ReadScript):

  • Battery Percentage — odhadovaná úroveň batérie CR2032. Varovanie sa zobrazí pri poklese pod 30 %.
  • Battery Voltage — aktuálne napätie batérie vo voltoch.
  • Link Quality — sila Zigbee signálu škálovaná z 0–254 na 0–100 %.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — identifikácia zariadenia a metadáta konfigurácie Zigbee.

Šablóna tiež sleduje LastSeenEpoch z odpovedí ZbInfo. Ak senzor nebol videný viac ako 12 hodín, zobrazí sa varovanie. Po 24 hodinách sa zobrazí chyba — čo indikuje, že senzor môže byť offline, mimo dosahu alebo má vybitú batériu.

Aktualizácie batérie CR2032 zo Zigbee zariadení môžu trvať až 24 hodín. Náhly pokles nemusí nevyhnutne znamenať zlyhanie batérie — počkajte na ďalší reportovací cyklus.

Ďalšie funkcie

DJT11LM tiež podporuje 3 úrovne citlivosti (nízka, stredná, vysoká) konfigurovateľné cez výrobcom špecifické Zigbee príkazy (ZbSend s Manuf: 0x115F). Niektoré Zigbee platformy navyše poskytujú samostatnú hodnotu intenzity/počtu vibrácií popri uhle náklonu. Tieto funkcie môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Senzor nehlási údaje
  1. Overte, že brána Zigbee2Tasmota je pripojená k MQTT brokerovi a prijíma správy (skontrolujte tele/{GWname}/SENSOR v MQTT klientovi)
  2. Potvrďte, že Device ID v šablóne zodpovedá krátkej adrese pridelenej pri párovaní (napr. 0xC9A9)
  3. Skontrolujte servisný atribút Link Quality — hodnoty pod 20 % indikujú slabý Zigbee signál. Presuňte senzor bližšie k bráne alebo pridajte kompatibilný Zigbee router
  4. Stlačte tlačidlo senzora raz pre vynútenie prenosu a overte, že brána prijala správu
Režim vibrácií zaseknutý na fallback hodnote
  1. Skontrolujte verziu firmvéru Zigbee2Tasmota — pole AqaraVibrationMode používa proprietárne Zigbee atribúty Aqara, ktoré vyžadujú aktuálny firmvér
  2. Overte, že JSON payload ZbReceived obsahuje pole AqaraVibrationMode (použite MQTT klienta na kontrolu surových správ tele/{GWname}/SENSOR)
  3. Ak režim vždy hlási hodnotu 4 (fallback), zariadenie môže odosielať nerozpoznaný typ udalosti — skontrolujte konzolu Tasmota pre kompletný JSON payload
Zariadenie zobrazuje offline varovanie
  1. Skontrolujte úroveň batérie — vybitá CR2032 spôsobí, že senzor prestane vysielať
  2. Vibračný senzor Aqara je Zigbee koncové zariadenie (nie router) a komunikuje cez najbližšie Zigbee routery. Ak router vypadne, senzor sa môže stať nedostupným
  3. Skúste stlačiť tlačidlo senzora pre zobudenie a vynútenie opätovného pripojenia k Zigbee sieti
  4. Ak problém pretrváva, znovu spárujte zariadenie podržaním tlačidla, kým nezačne blikať modrá LED
Manuálne nastavenie citlivosti

Šablóna TapHome neobsahuje konfiguráciu citlivosti. Pre zmenu citlivosti použite priamo konzolu Tasmota:

  • Nízka citlivosť: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":21}}
  • Stredná citlivosť: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":11}}
  • Vysoká citlivosť (predvolená): ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":1}}

Nahraďte 0xC9A9 skutočným Device ID senzora.

Ako nainštalovať v TapHome

Predpoklady

  • Zigbee brána s firmvérom Tasmota (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker bežiaci vo vašej lokálnej sieti (vstavaný TapHome broker alebo externý)
  • TapHome CCU v rovnakej sieti

TapHome má vstavaný MQTT broker — aktivujte ho v Nastavenia → Hardware → MQTT Broker. Nie je potrebný žiadny ďalší softvér.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmvér Tasmota na podporovaný Zigbee koordinátor (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Pripojte bránu k vašej Wi-Fi sieti cez webové rozhranie Tasmota
  3. Prejdite na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vášho MQTT brokera (napr. 192.168.1.10)
    • Port: 1883
    • Topic: zapíšte si názov topicu (napr. tasmota_XXXXX) — budete ho potrebovať pri importe šablóny

Podrobné pokyny nájdete v dokumentácii Tasmota Zigbee.

Krok 2 — Importujte šablónu brány v TapHome

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: IP adresa vášho brokera (napr. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (napr. tasmota_XXXXX)

Po importe uvidíte dve zariadenia: Permit Join (prepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zariadenie

  1. V TapHome zapnite prepínač Permit Join — otvorí sa 60-sekundové okno pre párovanie
  2. Na Zigbee zariadení spustite proces párovania (zvyčajne podržte tlačidlo reset 5 sekúnd, kým LED nezačne blikať)
  3. Sledujte počítadlo Devices Found — zvýši sa, keď sa pripojí nové zariadenie
  4. Skontrolujte Service Attributes brány, kde uvidíte ID nového zariadenia (napr. 0x1234), výrobcu a model
  5. Režim párovania sa automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablónu zariadenia

  1. Stiahnite si šablónu konkrétneho zariadenia z príslušnej stránky kompatibility
  2. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: rovnaká ako pre bránu
    • MQTT Broker Port: 1883
    • Gateway name: rovnaký Tasmota MQTT topic ako vyššie
    • Device ID: krátka adresa z párovania (napr. 0x1234)

Dostupné zariadenia

Aqara Vibration Sensor Modul
Servisné atribúty
IEEEAddr
ModelId
Výrobca
Endpoints
Config
Kvalita signáluSila Zigbee signálu — 0 % (žiadny signál) až 100 % (výborný)
Napätie batérie
Úroveň batérieOdhadovaná úroveň batérie CR2032 — varovanie pod 30 %
Vlastné premenné
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

Čítanie (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
Servisné atribúty
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Uhol náklonu Premenná Len na čítanie

Aktuálny uhol náklonu v stupňoch — číta AqaraVibrationsOrAngle z payloadu Zigbee senzora

numeric Jednotka: °

Uhol náklonu

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".AqaraVibrationsOrAngle", true);
    if(!ISNULL(val), Va := val);
end
Režim vibrácií Viacstavový prepínač Len na čítanie

Typ detegovaného pohybu — Drop (0), Tilt (1) alebo Vibrate (2) z poľa AqaraVibrationMode

string → enum SWITCH mapping
Hodnoty / Stavy: Drop · Tilt · Vibrate · ???

Režim vibrácií

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
Pripojenie: Packet Parser → MQTT
Možné vylepšenia (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).

Zdroje