---
title: "Aqara Motion Sensor (RTCGQ11LM)"
description: "Zigbee PIR senzor pokreta Aqara RTCGQ11LM preko Zigbee2MQTT-a i modula MQTT PacketParser. Prisutnost, baterija, napon i kvaliteta veze u sustavu TapHome."
url: "https://taphome.com/hr/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/"
language: hr
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","battery-powered","motion-detection"]
  questions: ["Kako integrirati senzor pokreta Aqara RTCGQ11LM sa sustavom TapHome preko Zigbee2MQTT-a?","Što javlja predložak TapHome za RTCGQ11LM?","Kako u sustavu TapHome postaviti Zigbee2MQTT friendly name ili IEEE adresu za RTCGQ11LM?","Zašto moj RTCGQ11LM nakon jednog otkrivanja javlja pokret još 60 sekundi?","Javlja li predložak za RTCGQ11LM razinu baterije i kvalitetu veze?","Zašto se moj RTCGQ11LM ponekad odspaja od Zigbee2MQTT-a?"]
---

# Aqara Motion Sensor (RTCGQ11LM)

Komunikacija: Packet Parser → MQTT

- [Zigbee2MQTT — stranica uređaja RTCGQ11LM](https://www.zigbee2mqtt.io/devices/RTCGQ11LM.html)

> 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

Aqara RTCGQ11LM (na nekim tržištima prodaje se kao Xiaomi Mi Motion Sensor) kompaktan je Zigbee 3.0 PIR senzor prisutnosti na bateriju koji koristi gumbastu bateriju CR2450. Sa sustavom TapHome komunicira neizravno: senzor se uparuje s koordinatorom Zigbee2MQTT (npr. Sonoff ZBDongle-P/E ili USB stick s čipom CC2652), koji Zigbee poruke prosljeđuje na MQTT teme. TapHome se na te MQTT teme pretplaćuje preko modula PacketParser MQTT.

Predložak prikazuje senzor kao binarni ulaz prisutnosti (pokret / nema pokreta), a postotak baterije, neobrađeni napon baterije i kvalitetu Zigbee veze daje kao servisne atribute.

## Konfiguracija

### Postavljanje Zigbee2MQTT

Prije uvoza predloška TapHome senzor RTCGQ11LM mora biti uparen s koordinatorom Zigbee2MQTT:

1. Otvorite web-sučelje Zigbee2MQTT i uključite način uparivanja (**Permit join**)
2. Na senzoru RTCGQ11LM pritisnite i držite tipku za resetiranje oko 5 sekundi, dok plava LED dioda ne počne treptati
3. Uređaj se pojavljuje na popisu uređaja Zigbee2MQTT s IEEE adresom (npr. `0x00158d00036cd3e2`). Po želji mu u web-sučelju Zigbee2MQTT u postavkama uređaja postavite friendly name.

Ako uparivanje ne uspije, umjesto dugog držanja pokušajte jedan kratki pritisak tipke. Kod koordinatora s čipom CC2531 zaglavljeno uparivanje često se riješi tako da USB stick izvadite i ponovno umetnete prije ponovnog pokretanja Zigbee2MQTT-a.

### Varijabla modula

Nakon uvoza predloška u TapHome postavite korisničku varijablu `XiaomiRTCGQ11LM` kojom se uređaj prepoznaje na MQTT brokeru:

| Varijabla | Opis | Kako je dobiti | Primjer |
|----------|-------------|---------------|---------|
| `XiaomiRTCGQ11LM` | Zigbee2MQTT friendly name ili IEEE adresa ovog senzora RTCGQ11LM | Web-sučelje Zigbee2MQTT → Devices → pronađite RTCGQ11LM → kopirajte IEEE adresu ili friendly name | `0x00158d00036cd3e2` |

Zadana privremena vrijednost u predlošku (`0x00158d00036cd3e2`) samo je primjer i **mora** se zamijeniti stvarnom adresom vašeg senzora. Listener skripta pretplaćuje se na `zigbee2mqtt/{XiaomiRTCGQ11LM}` i raščlanjuje JSON poruku stanja.

> [!TIP]
> Ako umjesto IEEE adrese koristite naziv (friendly name) (npr. `hallway_motion`), konfiguracija je preglednija i ostaje ista i ako senzor jednom ponovno uparite.

## Mogućnosti uređaja

### Otkrivanje pokreta

Predložak u sustavu TapHome prikazuje senzor kao uređaj vrste „Magnetski kontakt” (Reed Contact). Naziv „Magnetski kontakt” samo je konvencija predloška, a senzor se ponaša kao standardni PIR ulaz prisutnosti. Događaji pokreta stižu na temu `zigbee2mqtt/{id}` kao JSON i preslikavaju se na brojčano stanje:

| Poruka Zigbee2MQTT | Vrijednost u sustavu TapHome |
|--------------------|---------------|
| `"occupancy": true` | 1 (pokret) |
| `"occupancy": false` | 0 (mirovanje) |
| drugo / nedostaje | NaN |

Prva poruka `occupancy: true` objavljuje se pri prvom pokretu nakon što se uređaj pridruži mreži, a ne po završetku uparivanja.

> [!IMPORTANT]
> Hardver senzora RTCGQ11LM nakon svakog otkrivanja nameće **mrtvo vrijeme od 60 sekundi**: kada javi pokret, senzor 60 sekundi zanemaruje daljnje kretanje. Zato opciju `occupancy_timeout` u Zigbee2MQTT-u ostavite na zadanih 90 s (ili više). Vrijednosti ispod 60 s stvarale bi poruku `occupancy: false` dok je osoba još prisutna. To se ograničenje ne može zaobići bez izmjene hardvera.

### Baterija, napon i kvaliteta veze

Senzor ima tri servisna atributa samo za čitanje koja se raščlanjuju iz iste JSON poruke stanja:

- **Baterija**: preostali postotak baterije (0–100 %), u obliku `"N%"`. Nakon uparivanja može proći do 24 sata dok stigne prva vrijednost. Dok ne stigne prva poruka, prikazuje se `"-"`.
- **Napon**: neobrađeni napon baterije u milivoltima (obično ~3000 mV kod nove baterije CR2450), u obliku `"N mV"`. Koristan je kao neovisan pokazatelj slabe baterije: postotak baterije može izgledati dobro dok je ćelija već preslaba za pouzdan Zigbee prijenos.
- **LinkQuality**: pokazatelj kvalitete Zigbee veze (0–255 LQI), u obliku `"N lqi"`. Vrijednosti ispod 20 obično znače nepouzdanu vezu.

### Mogućnosti koje trenutačno nisu podržane

RTCGQ11LM preko Zigbee2MQTT-a objavljuje i sljedeće entitete koje ovaj predložak **ne** raščlanjuje. Mogu se dodati proširenjem skripte slušatelja u nekoj budućoj reviziji predloška:

- `illuminance` / `illuminance_lux`: razina okolnog svjetla u luksima (korisno za automatizacije pokreta ovisne o osvijetljenosti)
- `device_temperature`: unutarnja temperatura čipa u °C (samo za dijagnostiku, nije temperatura prostorije)
- `power_outage_count`: brojač vađenja baterije

Predložak ne obrađuje ni temu dostupnosti Zigbee2MQTT (`zigbee2mqtt/{id}/availability`) ni konfiguracijsku opciju `occupancy_timeout` (`zigbee2mqtt/bridge/request/device/options`). Za ovaj uređaj koji prelazi u stanje mirovanja kao znak da je aktivan preporučuju se LinkQuality i Baterija.

## Rješavanje problema

### Senzor ne javlja nikakvo stanje

1. Provjerite je li RTCGQ11LM na popisu uređaja Zigbee2MQTT sa zelenim statusom.
2. Provjerite odgovara li varijabla `XiaomiRTCGQ11LM` točno nazivu uređaja (friendly name) ili IEEE adresi. Kod friendly name razlikuju se velika i mala slova.
3. Izazovite pokret ispred senzora. Prva poruka stanja objavljuje se tek pri prvom otkrivanju nakon pridruživanja mreži.
4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na `zigbee2mqtt/#` i provjerite pojavljuju li se poruke na `zigbee2mqtt/{your_name}` kada izazovete pokret.

### Pokret je i dalje aktivan dugo nakon što je osoba otišla

To je očekivano hardversko mrtvo vrijeme od 60 sekundi u kombinaciji s opcijom `occupancy_timeout` u Zigbee2MQTT-u (zadano 90 s). Senzor ne javlja `occupancy: false` dok vrijeme ne istekne bez novog pokreta. Kraća vremena nisu pouzdana jer senzor prvih 60 s nakon otkrivanja jednostavno zanemaruje pokret.

### Nasumična odspajanja

Česti razlozi zbog kojih krajnji uređaji Aqara/Xiaomi ispadaju iz Zigbee mesh mreže:

1. **Slab signal**: provjerite LinkQuality. Vrijednosti ispod 20 obično znače da senzoru treba bliži Zigbee usmjerivač s mrežnim napajanjem.
2. **Nizak napon baterije**: atribut Napon bolji je pokazatelj od postotka. Zigbee2MQTT izričito navodi da senzor može ispasti iz mreže i dok javljeni postotak baterije još izgleda dobro. Pratite primjetan pad s vrijednosti ~3000 mV nove ćelije i zamijenite bateriju CR2450 kada veza postane nepouzdana.
3. **Nekompatibilni usmjerivači**: poznato je da usmjerivači Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, SmartThings i Securifi uzrokuju probleme sa zadržavanjem starijih uređaja Xiaomi/Aqara u mreži. Izravno povezivanje senzora s koordinatorom (resetirajte senzor dok je uz koordinator) često rješava problem.

> [!WARNING]
> Zigbee krajnji uređaji Aqara ne podržavaju pinganje u standardnom načinu dostupnosti Zigbee2MQTT i mogu se prikazivati kao izvan mreže čak i kada rade normalno. Ne oslanjajte se na temu dostupnosti Zigbee2MQTT kao znak da je uređaj aktivan, nego kao pokazatelje stanja koristite LinkQuality i Bateriju.

## 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 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Aqara Motion Sensor (RTCGQ11LM) Modul

Prilagođene varijable

|                                                 |                                                                                                                                                                                                                                                  |
|-------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `XiaomiRTCGQ11LM` (string) = 0x00158d00036cd3e2 | Zigbee2MQTT friendly name ili IEEE adresa (0x… 16 heksadecimalnih znakova) ovog senzora RTCGQ11LM — koristi se kao sufiks MQTT teme zigbee2mqtt/{this}. Zadanu privremenu vrijednost nakon uparivanja treba zamijeniti stvarnom adresom senzora. |

Senzor pokreta Magnetski kontakt Samo za čitanje

PIR otkrivanje prisutnosti — javlja pokret (1) pri otkrivanju, a mirovanje (0) nakon isteka hardverskog mrtvog vremena od 60 s i vremena occupancy\_timeout u Zigbee2MQTT-u.

boolean JSON (PARSEJSON on occupancy key)

Servisni atributi

|             |                                                                                                                                                 |
|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| Baterija    | Preostali postotak baterije (gumbasta baterija CR2450, 0–100 %). U obliku 'N%'; nakon uparivanja može proći do 24 h dok stigne prva vrijednost. |
| Napon       | Neobrađeni napon baterije u milivoltima (~3000 mV kod nove baterije CR2450). Precizniji pokazatelj slabe baterije od postotka.                  |
| LinkQuality | Pokazatelj kvalitete Zigbee veze (0–255 LQI). Vrijednosti ispod 20 obično znače nepouzdanu vezu i česta odspajanja.                             |

Čitanje (modul)

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Listener

```taphome
IF (COMPARE(RECEIVEDMSG.TOPIC, "zigbee2mqtt/"+ XiaomiRTCGQ11LM, CompareOptions.IgnoreCase) = 0)
    VAR value := TOSTRING(PARSEJSON(RECEIVEDMSG.PAYLOAD, "occupancy")); 
    IF (COMPARE(value, "true", CompareOptions.IgnoreCase) = 0)
        Rc := 1; 
    ELSEIF (COMPARE(value, "false", CompareOptions.IgnoreCase) = 0)
        Rc := 0;
    ELSE
        Rc := NaN;
    END   
    battery := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery", true);
    voltage := PARSEJSON(RECEIVEDMSG.PAYLOAD,"voltage", true);
    link := PARSEJSON(RECEIVEDMSG.PAYLOAD,"linkquality", true);
END;
```

Servisni atributi

Battery

```taphome
IF(ISNAN(battery),"-",battery+"%");
```

Voltage

```taphome
IF(ISNAN(voltage),"-",voltage+"mV");
```

LinkQuality

```taphome
IF(ISNAN(link),"-",link+"lqi");
```

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (5)

- Illuminance — illuminance / illuminance\_lux JSON key (unit lx, 0+). Ambient light level reported alongside occupancy. Could drive lux-gated motion automations (e.g. only switch lights below 50 lx). Not parsed by the current listener script — would require an additional PARSEJSON call plus a service\_attribute entry.
- Device Temperature — device\_temperature JSON key (unit °C). Internal chip temperature — not ambient room temperature. Useful for diagnostic alerts (overheating, direct sunlight on the sensor) but not for climate control. Not parsed by the current listener script.
- Power Outage Count — power\_outage\_count JSON key (integer). Increments when the battery is removed/reinserted or the device loses power. Could detect tampering or battery swaps. Not parsed by the current listener script.
- Availability (LWT) — online / offline string payload published by Z2M if availability is enabled globally or per device (availability: true in configuration.yaml). Could detect dropped sensors. Not subscribed by the current template.
- Occupancy Timeout Configuration — occupancy\_timeout (seconds, minimum 60, default 90) controls how long after motion the sensor waits before reporting occupancy: false. Currently set via Z2M frontend / configuration.yaml — TapHome template does not expose this as a setting and does not publish to bridge/request topics.

## 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`        |

## Izvori

- Aqara RTCGQ11LM — Zigbee2MQTT device page
  
  [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/RTCGQ11LM.html) 2026-04-24
- Aqara Motion Sensor — official product specs
  
  [www.aqara.com](https://www.aqara.com/en/product/human-motion-sensor/specs/) 2026-04-24
- Aqara Motion Sensor — user manual
  
  [www.aqara.com](https://www.aqara.com/en/product/human-motion-sensor/) 2026-04-24

## 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/)

