--- title: "Aqara Vibration Sensor" description: "Detekce vibrací, náklonu a pádu přes Zigbee s bránou Tasmota. Úhel náklonu ve stupních, režim vibrací s monitoringem baterie a offline stavu." url: "https://taphome.com/cs/compatibility/zigbee2tasmota-aqara-vibration-sensor/" language: cs lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","sensor","zigbee","battery-powered","vibration-detection"] questions: ["Jak integrovat vibrační senzor Aqara DJT11LM s TapHome?","Co detekuje šablona vibračního senzoru Aqara v TapHome?","Jak připojit vibrační senzor Aqara k TapHome přes Tasmota?","Proč se vibrační senzor Aqara zobrazuje jako offline v TapHome?","Jak spárovat Aqara DJT11LM s bránou Zigbee2Tasmota?","Zobrazuje TapHome úhel náklonu z vibračního senzoru Aqara?"] --- # Aqara Vibration Sensor Komunikace: Packet Parser → MQTT - [Produktová stránka Aqara](https://www.aqara.com/eu/product/vibration-sensor) > Adresa v síti > > U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru. > > [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/) ## Návod na integraci > [!IMPORTANT] > Toto zařízení komunikuje přes **Zigbee** prostřednictvím brány Tasmota. Ujistěte se, že máte > importovanou šablonu [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/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: | Parametr | Popis | Příklad | |----------|-------|---------| | MQTT Broker IP Address | IP adresa MQTT brokeru | `192.168.1.10` | | MQTT Broker Port | Port brokeru (výchozí 1883) | `1883` | | Gateway name | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | Device ID | Krátká Zigbee adresa z párování | `0xC9A9` | > [!WARNING] > 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: | Stav | Hodnota | Popis | |------|---------|-------| | Drop | 0 | Detekován volný pád nebo upuštění | | Tilt | 1 | Detekován náklon nebo změna úhlu | | Vibrate | 2 | Deteková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. > [!TIP] > 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 > [!TIP] > 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](https://tasmota.github.io/docs/Getting-Started/) 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:** pro vestavěný broker IP adresa TapHome Core (s rezervací IP v routeru → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)), jinak IP adresa vašeho 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](https://tasmota.github.io/docs/Zigbee/). ### Krok 2 — Importujte šablonu brány v TapHome 1. Stáhněte si šablonu brány ze stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/cs/compatibility/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:** pro vestavěný broker TapHome `127.0.0.1`, jinak 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í 2 Tato zařízení se po importu zobrazí v TapHome. Aqara Vibration Sensor Modul Servisní atributy | | | |-----------------|-------------------------------------------------------------| | IEEEAddr | | | ModelId | | | Výrobce | | | Endpoints | | | Config | | | Kvalita signálu | Síla Zigbee signálu — 0 % (žádný signál) až 100 % (výborný) | | Napětí baterie | | | Úroveň baterie | Odhadovaná úroveň baterie CR2032 — varování pod 30 % | Vlastní proměnné `GWname` (string) Název Tasmota MQTT topicu Zigbee gateway (najdete v Configuration → MQTT → Topic) `ID` (string) = 0xC9A9 Zigbee krátká adresa senzoru (přiřazená během párování) 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 Čtení (modul) ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` Listener ```taphome 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 ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome 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: ° Listener ```taphome 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 · ??? Listener ```taphome 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). ## Parametry importu Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |-------------------------------------------------------------|-----------------| | Mqtt Broker IP adresa | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway name (Tasmota->Configuration->MQTT->Topic) | `tasmota_XXXXX` | | Device ID | `0xFFFF` | ## Zdroje - Tasmota Zigbee Documentation [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/) - Zigbee Compatible Devices Database - Blakadder Device Entry — Aqara DJT11LM [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_DJT11LM.html) 2026-03-29 - Aqara Product Page — Vibration Sensor [www.aqara.com](https://www.aqara.com/eu/product/vibration-sensor) 2026-03-29 ## Související dokumentace - [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)