---
title: "Aqara Vibration Sensor"
description: "Prepoznavanje vibracija, naginjanja i pada preko Zigbee pristupnika Tasmota. Kut nagiba u stupnjevima, način vibracije, praćenje baterije i veze."
url: "https://taphome.com/hr/compatibility/zigbee2tasmota-aqara-vibration-sensor/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","battery-powered","vibration-detection"]
  questions: ["Kako integrirati Aqara senzor vibracija DJT11LM sa sustavom TapHome?","Što prepoznaje predložak TapHome za Aqara senzor vibracija?","Kako povezati Aqara senzor vibracija sa sustavom TapHome preko uređaja Tasmota?","Zašto se moj Aqara senzor vibracija u sustavu TapHome prikazuje kao nedostupan?","Kako upariti Aqara DJT11LM s pristupnikom Zigbee2Tasmota?","Prikazuje li TapHome kut nagiba Aqara senzora vibracija?"]
---

# Aqara Vibration Sensor

Komunikacija: Packet Parser → MQTT

- [Stranica proizvoda Aqara](https://www.aqara.com/eu/product/vibration-sensor)

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

> [!IMPORTANT]
> Ovaj uređaj komunicira preko protokola **Zigbee** putem pristupnika Tasmota. Prije nastavka provjerite jeste li
> uvezli predložak [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/)
> i uparili uređaj.

Aqara DJT11LM je kompaktan Zigbee senzor vibracija na bateriju koji prepoznaje tri vrste pokreta: vibraciju, naginjanje i pad. Sa sustavom TapHome komunicira preko protokola MQTT putem pristupnika Zigbee2Tasmota. Senzor šalje podatke o događajima na temu `tele/{gateway}/SENSOR`, a predložak iz JSON poruke `ZbReceived` čita vlasnička polja `AqaraVibrationsOrAngle` i `AqaraVibrationMode`.

Senzor se napaja gumbastom baterijom CR2032 (trajanje oko 2 godine). Predložak prati razinu i napon baterije putem servisnih atributa, upozorava kad razina baterije padne ispod 30 % i prepoznaje kad je uređaj izvan mreže (upozorenje nakon 12 sati, pogreška nakon 24 sata).

## Konfiguracija

### Uparivanje senzora

1. Na pristupniku Zigbee2Tasmota uključite **Permit Join** (sklopkom u predlošku pristupnika u sustavu TapHome ili naredbom `ZbPermitJoin 1` u konzoli Tasmota)
2. Pritisnite i držite tipku na Aqara senzoru vibracija dok plava LED dioda ne počne treptati, a zatim je otpustite
3. Senzor bi se trebao upariti u roku od 60 sekundi
4. Zapišite dodijeljeni Device ID (npr. `0xC9A9`) iz servisnih atributa pristupnika ili iz konzole Tasmota

### Parametri uvoza

Nakon uparivanja uvezite predložak uređaja s ovim parametrima:

| Parametar | Opis | Primjer |
|-----------|-------------|---------|
| MQTT Broker IP Address | IP adresa MQTT brokera | `192.168.1.10` |
| MQTT Broker Port | Port brokera (zadano 1883) | `1883` |
| Gateway name | MQTT tema uređaja Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| Device ID | Kratka Zigbee adresa dobivena pri uparivanju | `0xC9A9` |

> [!WARNING]
> Zigbee uređaji Aqara/Xiaomi ne poštuju u potpunosti Zigbee standard pa s nekim Zigbee usmjerivačima (routerima) mogu imati problema s vezom. Poznati nekompatibilni usmjerivači su Centralite, General Electric, OSRAM, Sylvania, SmartThings i Securifi. Koristite usmjerivače za koje je potvrđena kompatibilnost s uređajima Xiaomi (npr. IKEA TRADFRI).

## Mogućnosti uređaja

### Kut nagiba

Uređaj Kut nagiba čita polje `AqaraVibrationsOrAngle` iz JSON poruke `ZbReceived`. Vrijednost se javlja u stupnjevima i izravno se preuzima. Skripta za primanje (listener) čita kut iz svake poruke `SENSOR` i odmah ažurira vrijednost senzora.

Kut nagiba pokazuje trenutačni položaj senzora u odnosu na površinu na koju je pričvršćen. Ažurira se svaki put kad senzor prepozna naginjanje i pošalje poruku `SENSOR`.

### Način vibracije

Uređaj Način vibracije čita polje `AqaraVibrationMode` iz JSON poruke `ZbReceived`. Tekstualne vrijednosti pretvara u brojčana stanja pomoću izraza SWITCH:

| Stanje | Vrijednost | Opis |
|-------|-------|-------------|
| Drop | 0 | Prepoznat slobodan pad ili ispuštanje |
| Tilt | 1 | Prepoznato naginjanje ili promjena kuta |
| Vibrate | 2 | Prepoznata vibracija ili dodir |

Način se ažurira pri svakom pokretu. Stanja 3–9 u predlošku su definirana kao rezervirana mjesta, ali ih skripta za primanje ne mapira. Vrijednost 4 koristi se kao zadana zamjenska vrijednost za svaki neprepoznati način.

### Baterija i stanje uređaja

Modul prikazuje nekoliko servisnih atributa čije vrijednosti ažurira periodični upit `ZbInfo` (svakih sat vremena putem skripte ReadScript):

- **Razina baterije** — procijenjena razina baterije CR2032. Kad razina padne ispod 30 %, pojavljuje se upozorenje.
- **Napon baterije** — trenutačni napon baterije u voltima.
- **Kvaliteta veze** — jačina Zigbee signala preračunata iz raspona 0–254 u 0–100 %.
- **IEEEAddr**, **ModelId**, **Proizvođač**, **Endpoints**, **Config** — identifikacija uređaja i metapodaci Zigbee konfiguracije.

Predložak prati i `LastSeenEpoch` iz odgovora ZbInfo. Ako se senzor nije javio dulje od 12 sati, pojavljuje se upozorenje. Nakon 24 sata pojavljuje se pogreška, što znači da je senzor možda izvan mreže, izvan dometa ili mu je baterija ispražnjena.

> [!TIP]
> Osvježavanje podataka o bateriji CR2032 iz Zigbee uređaja može potrajati do 24 sata. Nagli pad ne znači nužno da je baterija pri kraju. Pričekajte sljedeći ciklus javljanja.

### Dodatne mogućnosti

DJT11LM podržava i 3 razine osjetljivosti (niska, srednja, visoka) koje se postavljaju Zigbee naredbama specifičnima za proizvođača (`ZbSend` s `Manuf: 0x115F`). Neke Zigbee platforme uz kut nagiba prikazuju i zasebnu vrijednost jačine ili broja vibracija. Ove mogućnosti mogu se dodati u nekom od budućih ažuriranja predloška.

## Rješavanje problema

### Senzor ne šalje podatke

1. Provjerite je li pristupnik Zigbee2Tasmota spojen na MQTT broker i prima li poruke (provjerite `tele/{GWname}/SENSOR` u MQTT klijentu)
2. Provjerite odgovara li Device ID u predlošku kratkoj adresi dodijeljenoj pri uparivanju (npr. `0xC9A9`)
3. Provjerite servisni atribut Kvaliteta veze. Vrijednosti ispod 20 % znače slab Zigbee signal. Približite senzor pristupniku ili dodajte kompatibilan Zigbee usmjerivač
4. Jednom pritisnite tipku senzora kako biste potaknuli slanje poruke i provjerite prima li je pristupnik

### Način vibracije ostaje na zamjenskoj vrijednosti

1. Provjerite verziju firmvera Zigbee2Tasmota. Polje `AqaraVibrationMode` koristi vlasničke Aqara Zigbee atribute za koje je potreban ažuran firmver
2. Provjerite sadrži li poruka `ZbReceived` polje `AqaraVibrationMode` (neobrađene poruke `tele/{GWname}/SENSOR` pregledajte MQTT klijentom)
3. Ako Način vibracije uvijek ima vrijednost 4 (zamjenska vrijednost), uređaj možda šalje neprepoznatu vrstu događaja. Cijelu JSON poruku provjerite u konzoli Tasmota

### Uređaj prikazuje upozorenje da je izvan mreže

1. Provjerite razinu baterije. Kad je CR2032 ispražnjena, senzor prestaje slati podatke
2. Aqara senzor vibracija je Zigbee krajnji uređaj (end device, nije usmjerivač) i komunicira preko obližnjih Zigbee usmjerivača. Ako usmjerivač ode izvan mreže, senzor može postati nedostupan
3. Pritisnite tipku senzora kako biste ga probudili i potaknuli ponovno povezivanje sa Zigbee mrežom
4. Ako problem i dalje postoji, ponovno uparite uređaj tako da držite tipku dok plava LED dioda ne trepne

### Ručno podešavanje osjetljivosti

Predložak TapHome ne sadrži postavke osjetljivosti. Osjetljivost promijenite izravno u konzoli Tasmota:

- **Niska osjetljivost:** `ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":21}}`
- **Srednja osjetljivost:** `ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":11}}`
- **Visoka osjetljivost (zadano):** `ZbSend {"Device":"0xC9A9","Manuf":"0x115F","Write":{"0000/FF0D%20":1}}`

Umjesto `0xC9A9` upišite stvarni Device ID senzora.

## Kako ga instalirati u TapHome

### Preduvjeti

- Zigbee pristupnik s firmverom Tasmota (npr. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker koji radi u vašoj lokalnoj mreži (ugrađeni broker TapHome ili vanjski)
- TapHome CCU u istoj mreži

> [!TIP]
> TapHome ima ugrađeni MQTT broker — uključite ga u **Postavke** → **Hardver** → **MQTT Broker**. Nije potreban nikakav dodatni softver.

### Korak 1 — Postavite Tasmota Zigbee pristupnik

1. Na podržani Zigbee koordinator (npr. Sonoff ZBBridge, eWeLink ZB-GW03) učitajte [firmver Tasmota](https://tasmota.github.io/docs/Getting-Started/)
2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
3. Idite na **Configuration** → **Configure MQTT** i postavite:
   - **Host:** za ugrađeni broker IP adresu centralne jedinice TapHome Core (s rezervacijom IP adrese u usmjerivaču → [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)), inače IP adresu vašeg brokera (npr. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapišite naziv teme (npr. `tasmota_XXXXX`) — trebat će vam pri uvozu predloška

Detaljne upute potražite u [dokumentaciji Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Korak 2 — Uvezite predložak pristupnika u sustav TapHome

1. Preuzmite predložak pristupnika sa stranice kompatibilnosti [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/)
2. U sustavu TapHome idite na **Postavke** → **Hardver** → **Packet Parser** → **Uvoz**
3. Uvezite predložak s ovim parametrima:
   - **MQTT Broker IP Address:** za ugrađeni broker TapHome `127.0.0.1`, inače IP adresa vašeg brokera (npr. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT tema iz koraka 1 (npr. `tasmota_XXXXX`)

Nakon uvoza vidjet ćete dva uređaja: **Permit Join** (sklopka) i **Pronađeni uređaji** (brojač).

### Korak 3 — Uparite Zigbee uređaj

1. U sustavu TapHome uključite sklopku **Permit Join** — otvara se razdoblje od 60 sekundi za uparivanje
2. Na Zigbee uređaju pokrenite postupak uparivanja (obično držite tipku za resetiranje 5 sekundi, dok LED ne počne treptati)
3. Pratite brojač **Pronađeni uređaji** — povećava se kada se pridruži novi uređaj
4. U **Servisnim atributima** pristupnika pogledajte ID novog uređaja (npr. `0x1234`), proizvođača i model
5. Način uparivanja automatski se isključuje nakon isteka vremena

### Korak 4 — Uvezite predložak uređaja

1. Preuzmite predložak za konkretni uređaj s odgovarajuće stranice kompatibilnosti
2. Uvezite predložak s ovim parametrima:
   - **MQTT Broker IP Address:** ista kao za pristupnik
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** ista Tasmota MQTT tema kao gore
   - **Device ID:** kratka adresa iz uparivanja (npr. `0x1234`)

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Aqara Vibration Sensor Modul

Servisni atributi

|                 |                                                                   |
|-----------------|-------------------------------------------------------------------|
| IEEEAddr        |                                                                   |
| ModelId         |                                                                   |
| Proizvođač      |                                                                   |
| Endpoints       |                                                                   |
| Config          |                                                                   |
| Kvaliteta veze  | Jačina Zigbee signala — od 0 % (nema signala) do 100 % (izvrstan) |
| Napon baterije  |                                                                   |
| Razina baterije | Procijenjena razina baterije CR2032 — upozorenje ispod 30 %       |

Prilagođene varijable

`GWname` (string) Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic) 

`ID` (string) = 0xC9A9 Kratka Zigbee adresa senzora (dodjeljuje se pri uparivanju)

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

Čitanje (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
```

Servisni atributi

IEEEAddr

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

```taphome
BatteryVoltage + " V"
```

Battery Percentage

```taphome
BatteryPercentage + "%"
```

Kut nagiba Varijabla Samo za čitanje

Trenutačni kut nagiba u stupnjevima — čita AqaraVibrationsOrAngle iz poruke Zigbee senzora

numeric Jedinica: °

Listener

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".AqaraVibrationsOrAngle", true);
    if(!ISNULL(val), Va := val);
end
```

Način vibracije Prekidač s više vrijednosti Samo za čitanje

Vrsta prepoznatog pokreta — Drop (0), Tilt (1) ili Vibrate (2) iz polja AqaraVibrationMode

string → enum SWITCH mapping

Vrijednosti / stanja: 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
```

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (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).

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji                                        | Zadano          |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Izvori

- 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

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

