--- title: "Aqara Vibration Sensor" description: "Detekcia vibrácií, náklonu a pádu cez Zigbee s bránou Tasmota. Uhol náklonu v stupňoch, režim vibrácií s monitoringom batérie a offline stavu." url: "https://taphome.com/sk/compatibility/zigbee2tasmota-aqara-vibration-sensor/" language: sk lastmod: 2026-03-29 generator: hugo ai: topics: ["mqtt","sensor","zigbee","battery-powered","vibration-detection"] questions: ["Ako integrovať vibračný senzor Aqara DJT11LM s TapHome?","Čo deteguje šablóna vibračného senzora Aqara v TapHome?","Ako pripojiť vibračný senzor Aqara k TapHome cez Tasmota?","Prečo sa vibračný senzor Aqara zobrazuje ako offline v TapHome?","Ako spárovať Aqara DJT11LM s bránou Zigbee2Tasmota?","Zobrazuje TapHome uhol náklonu z vibračného senzora Aqara?"] --- # Aqara Vibration Sensor Komunikácia: Packet Parser → MQTT - [Produktová stránka Aqara](https://www.aqara.com/eu/product/vibration-sensor) > Adresa v sieti > > Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu > [!IMPORTANT] > Toto zariadenie komunikuje cez **Zigbee** prostredníctvom brány Tasmota. Uistite sa, že máte > importovanú šablónu [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/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: | Parameter | Popis | Príklad | |-----------|-------|---------| | MQTT Broker IP Address | IP adresa MQTT brokera | `192.168.1.10` | | MQTT Broker Port | Port brokera (predvolene 1883) | `1883` | | Gateway name | MQTT topic Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` | | Device ID | Krátka Zigbee adresa z párovania | `0xC9A9` | > [!WARNING] > 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: | Stav | Hodnota | Popis | |------|---------|-------| | Drop | 0 | Detegovaný voľný pád alebo upadnutie | | Tilt | 1 | Detegovaný náklon alebo zmena uhla | | Vibrate | 2 | Detegované 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. > [!TIP] > 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 > [!TIP] > 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](https://tasmota.github.io/docs/Getting-Started/) 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:** pre vstavaný broker IP adresa TapHome Core (s rezerváciou IP v routeri → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)), inak IP adresa vášho 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](https://tasmota.github.io/docs/Zigbee/). ### Krok 2 — Importujte šablónu brány v TapHome 1. Stiahnite si šablónu brány zo stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/) 2. V TapHome prejdite na **Nastavenia** → **Hardware** → **Packet Parser** → **Import** 3. Importujte šablónu s týmito parametrami: - **MQTT Broker IP Address:** pre vstavaný broker TapHome `127.0.0.1`, inak 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 2 Tieto zariadenia sa po importe zobrazia v TapHome. Aqara Vibration Sensor Modul Servisné atribúty | | | |-----------------|--------------------------------------------------------------| | IEEEAddr | | | ModelId | | | Výrobca | | | Endpoints | | | Config | | | Kvalita signálu | Sila Zigbee signálu — 0 % (žiadny signál) až 100 % (výborný) | | Napätie batérie | | | Úroveň batérie | Odhadovaná úroveň batérie CR2032 — varovanie pod 30 % | Vlastné premenné `GWname` (string) Názov Tasmota MQTT topicu Zigbee gateway (nájdete v Configuration → MQTT → Topic) `ID` (string) = 0xC9A9 Zigbee krátka adresa senzora (priradená počas párovania) 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 Čítanie (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é atribúty IEEEAddr ```taphome MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID) ``` ModelId ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome BatteryPercentage + "%" ``` Uhol náklonu Premenná Len na čítanie Aktuálny uhol náklonu v stupňoch — číta AqaraVibrationsOrAngle z payloadu Zigbee senzora 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 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 · ??? 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 ``` **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). ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |-------------------------------------------------------------|-----------------| | 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 ## Súvisiaca dokumentácia - [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/) - [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)