TapHome

Aqara Vibration Sensor

Packet Parser → MQTT
Přidal
Poslední aktualizace: 03. 2026

Vyžaduje externí bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Vibration Sensor

Toto zařízení komunikuje přes Zigbee prostřednictvím brány Tasmota. Ujistěte se, že máte importovanou šablonu Zigbee2Tasmota Gateway a vaše zařízení je spárované.

Aqara DJT11LM je kompaktní bateriově napájený Zigbee vibrační senzor, který detekuje tři typy pohybu: vibrace, náklon a pád. S TapHome komunikuje přes MQTT prostřednictvím brány Zigbee2Tasmota — senzor odesílá data o událostech přes topic tele/{gateway}/SENSOR a šablona parsuje proprietární pole AqaraVibrationsOrAngle a AqaraVibrationMode z JSON payloadu ZbReceived.

Senzor je napájen knoflíkovou baterií CR2032 (životnost přibližně 2 roky). Šablona monitoruje úroveň a napětí baterie přes servisní atributy, upozorní při poklesu pod 30 % a detekuje offline stavy zařízení (varování po 12 hodinách, chyba po 24 hodinách).

Konfigurace

Spárování senzoru
  1. Na bráně Zigbee2Tasmota aktivujte Permit Join (přes přepínač šablony brány v TapHome nebo příkazem ZbPermitJoin 1 v konzoli Tasmota)
  2. Stiskněte a podržte tlačítko na vibračním senzoru Aqara, dokud nezačne blikat modrá LED, pak uvolněte
  3. Senzor by se měl spárovat do 60 sekund
  4. Poznamenejte si přidělené Device ID (např. 0xC9A9) ze servisních atributů brány nebo z konzole Tasmota
Parametry importu

Po spárování importujte šablonu zařízení s těmito parametry:

ParametrPopisPříklad
MQTT Broker IP AddressIP adresa MQTT brokeru192.168.1.10
MQTT Broker PortPort brokeru (výchozí 1883)1883
Gateway nameMQTT topic Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKrátká Zigbee adresa z párování0xC9A9

Zařízení Aqara/Xiaomi Zigbee nejsou plně kompatibilní se standardem Zigbee a mohou mít problémy s připojením k některým Zigbee routerům. Mezi známé nekompatibilní routery patří Centralite, General Electric, OSRAM, Sylvania, SmartThings a Securifi. Používejte routery potvrzené jako kompatibilní se zařízeními Xiaomi (např. IKEA TRADFRI).

Funkce zařízení

Úhel náklonu

Zařízení Tilt Angle čte pole AqaraVibrationsOrAngle z JSON payloadu ZbReceived. Hodnota se hlásí ve stupních přímým přiřazením — listener skript parsuje úhel z každé zprávy SENSOR a okamžitě aktualizuje hodnotu senzoru.

Úhel náklonu odráží aktuální orientaci senzoru vůči povrchu, na kterém je připevněn. Aktualizuje se vždy, když senzor zaznamená událost náklonu a odešle zprávu SENSOR.

Režim vibrací

Zařízení Vibration Mode čte pole AqaraVibrationMode z JSON payloadu ZbReceived. Mapuje textové hodnoty na číselné stavy pomocí výrazu SWITCH:

StavHodnotaPopis
Drop0Detekován volný pád nebo upuštění
Tilt1Detekován náklon nebo změna úhlu
Vibrate2Detekovány vibrace nebo dotyk

Režim se aktualizuje při každé události pohybu. Stavy 3–9 jsou v šabloně definovány jako zástupné, ale nejsou aktivně mapovány listener skriptem — hodnota 4 se používá jako výchozí fallback pro nerozpoznaný režim.

Baterie a stav zařízení

Modul poskytuje několik servisních atributů naplňovaných mechanismem ZbInfo (interval 1 hodina přes ReadScript):

  • Battery Percentage — odhadovaná úroveň baterie CR2032. Varování se zobrazí při poklesu pod 30 %.
  • Battery Voltage — aktuální napětí baterie ve voltech.
  • Link Quality — síla Zigbee signálu škálovaná z 0–254 na 0–100 %.
  • IEEEAddr, ModelId, Manufacturer, Endpoints, Config — identifikace zařízení a metadata konfigurace Zigbee.

Šablona také sleduje LastSeenEpoch z odpovědí ZbInfo. Pokud senzor nebyl viděn více než 12 hodin, zobrazí se varování. Po 24 hodinách se zobrazí chyba — což indikuje, že senzor může být offline, mimo dosah nebo má vybitou baterii.

Aktualizace baterie CR2032 ze Zigbee zařízení mohou trvat až 24 hodin. Náhlý pokles nemusí nutně znamenat selhání baterie — počkejte na další reportovací cyklus.

Další funkce

DJT11LM také podporuje 3 úrovně citlivosti (nízká, střední, vysoká) konfigurovatelné přes výrobcem specifické Zigbee příkazy (ZbSend s Manuf: 0x115F). Některé Zigbee platformy navíc poskytují samostatnou hodnotu intenzity/počtu vibrací vedle úhlu náklonu. Tyto funkce mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Senzor nehlásí data
  1. Ověřte, že brána Zigbee2Tasmota je připojena k MQTT brokeru a přijímá zprávy (zkontrolujte tele/{GWname}/SENSOR v MQTT klientovi)
  2. Potvrďte, že Device ID v šabloně odpovídá krátké adrese přidělené při párování (např. 0xC9A9)
  3. Zkontrolujte servisní atribut Link Quality — hodnoty pod 20 % indikují slabý Zigbee signál. Přesuňte senzor blíže k bráně nebo přidejte kompatibilní Zigbee router
  4. Stiskněte tlačítko senzoru jednou pro vynucení přenosu a ověřte, že brána přijala zprávu
Režim vibrací zaseknutý na fallback hodnotě
  1. Zkontrolujte verzi firmwaru Zigbee2Tasmota — pole AqaraVibrationMode používá proprietární Zigbee atributy Aqara, které vyžadují aktuální firmware
  2. Ověřte, že JSON payload ZbReceived obsahuje pole AqaraVibrationMode (použijte MQTT klienta pro kontrolu surových zpráv tele/{GWname}/SENSOR)
  3. Pokud režim vždy hlásí hodnotu 4 (fallback), zařízení může odesílat nerozpoznaný typ události — zkontrolujte konzoli Tasmota pro kompletní JSON payload
Zařízení zobrazuje offline varování
  1. Zkontrolujte úroveň baterie — vybitá CR2032 způsobí, že senzor přestane vysílat
  2. Vibrační senzor Aqara je Zigbee koncové zařízení (ne router) a komunikuje přes nejbližší Zigbee routery. Pokud router vypadne, senzor se může stát nedostupným
  3. Zkuste stisknout tlačítko senzoru pro probuzení a vynucení opětovného připojení k Zigbee síti
  4. Pokud problém přetrvává, znovu spárujte zařízení podržením tlačítka, dokud nezačne blikat modrá LED
Manuální nastavení citlivosti

Šablona TapHome neobsahuje konfiguraci citlivosti. Pro změnu citlivosti použijte přímo konzoli Tasmota:

  • Nízká citlivost: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":21}}
  • Střední citlivost: ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":11}}
  • Vysoká citlivost (výchozí): ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":1}}

Nahraďte 0xC9A9 skutečným Device ID senzoru.

Jak nainstalovat v TapHome

Předpoklady

  • Zigbee brána s firmwarem Tasmota (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  • MQTT broker běžící ve vaší lokální síti (vestavěný TapHome broker nebo externí)
  • TapHome CCU ve stejné síti

TapHome má vestavěný MQTT broker — aktivujte ho v Nastavení → Hardware → MQTT Broker. Není potřeba žádný další software.

Krok 1 — Nastavte Tasmota Zigbee bránu

  1. Nahrajte firmware Tasmota na podporovaný Zigbee koordinátor (např. Sonoff ZBBridge, eWeLink ZB-GW03)
  2. Připojte bránu k vaší Wi-Fi síti přes webové rozhraní Tasmota
  3. Přejděte na Configuration → Configure MQTT a nastavte:
    • Host: IP adresa vašeho MQTT brokeru (např. 192.168.1.10)
    • Port: 1883
    • Topic: zapište si název topicu (např. tasmota_XXXXX) — budete ho potřebovat při importu šablony

Podrobné pokyny naleznete v dokumentaci Tasmota Zigbee.

Krok 2 — Importujte šablonu brány v TapHome

  1. Stáhněte si šablonu brány ze stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome přejděte na Nastavení → Hardware → Packet Parser → Import
  3. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: IP adresa vašeho brokeru (např. 192.168.1.10)
    • MQTT Broker Port: 1883
    • Gateway name: Tasmota MQTT topic z kroku 1 (např. tasmota_XXXXX)

Po importu uvidíte dvě zařízení: Permit Join (přepínač) a Devices Found (počítadlo).

Krok 3 — Spárujte Zigbee zařízení

  1. V TapHome zapněte přepínač Permit Join — otevře se 60sekundové okno pro párování
  2. Na Zigbee zařízení spusťte proces párování (typicky podržte tlačítko reset 5 sekund, dokud LED nezačne blikat)
  3. Sledujte počítadlo Devices Found — zvýší se, když se připojí nové zařízení
  4. Zkontrolujte Service Attributes brány, kde uvidíte ID nového zařízení (např. 0x1234), výrobce a model
  5. Režim párování se automaticky deaktivuje po uplynutí časového limitu

Krok 4 — Importujte šablonu zařízení

  1. Stáhněte si šablonu konkrétního zařízení z příslušné stránky kompatibility
  2. Importujte šablonu s těmito parametry:
    • MQTT Broker IP Address: stejná jako pro bránu
    • MQTT Broker Port: 1883
    • Gateway name: stejný Tasmota MQTT topic jako výše
    • Device ID: krátká adresa z párování (např. 0x1234)

Dostupná zařízení

Aqara Vibration Sensor Modul
Servisní atributy
IEEEAddr
ModelId
Výrobce
Endpoints
Config
Kvalita signáluSíla Zigbee signálu — 0 % (žádný signál) až 100 % (výborný)
Napětí baterie
Úroveň baterieOdhadovaná úroveň baterie CR2032 — varování pod 30 %
Vlastní proměnné
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

Čtení (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í atributy
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Úhel náklonu Proměnná Pouze ke čtení

Aktuální úhel náklonu ve stupních — čte AqaraVibrationsOrAngle z payloadu Zigbee senzoru

numeric Jednotka: °

Úhel 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 vibrací Vícestavový přepínač Pouze ke čtení

Typ detekovaného pohybu — Drop (0), Tilt (1) nebo Vibrate (2) z pole AqaraVibrationMode

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

Režim vibrací

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
Připojení: Packet Parser → MQTT
Možná vylepšení (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