---
title: "Aqara Snímač pohybu (RTCGQ11LM)"
description: "Aqara Mi / RTCGQ11LM Zigbee PIR snímač pohybu cez Zigbee2MQTT a MQTT PacketParser. Detekcia pohybu, stav batérie, napätia a kvality spojenia v TapHome."
url: "https://taphome.com/sk/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/"
language: sk
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","battery-powered","motion-detection"]
  questions: ["Ako integrovať Aqara RTCGQ11LM snímač pohybu do TapHome cez Zigbee2MQTT?","Čo šablóna RTCGQ11LM v TapHome hlási?","Ako nastaviť Zigbee2MQTT friendly name alebo IEEE adresu RTCGQ11LM v TapHome?","Prečo má môj RTCGQ11LM po jednej detekcii pohyb aktívny celých 60 sekúnd?","Hlási šablóna RTCGQ11LM stav batérie a kvalitu spojenia?","Prečo sa mi RTCGQ11LM občas odpája od Zigbee2MQTT?"]
---

# Aqara Snímač pohybu (RTCGQ11LM)

Komunikácia: Packet Parser → MQTT

- [Zigbee2MQTT — stránka zariadenia RTCGQ11LM](https://www.zigbee2mqtt.io/devices/RTCGQ11LM.html)

> 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

Aqara RTCGQ11LM (na niektorých trhoch predávaný ako Xiaomi Mi Motion Sensor) je kompaktný batériový Zigbee 3.0 PIR snímač obsadenosti napájaný gombíkovou batériou CR2450. S TapHome komunikuje nepriamo — snímač sa spáruje s koordinátorom Zigbee2MQTT (napr. Sonoff ZBDongle-P/E alebo stick založený na CC2652), ktorý premosťuje Zigbee správy do MQTT topicov. TapHome sa na tieto MQTT topicy pripája cez modul PacketParser MQTT.

Šablóna mapuje snímač ako binárny vstup obsadenosti (pohyb / bez pohybu) a vystavuje percento batérie, surové napätie batérie a kvalitu Zigbee spojenia ako servisné atribúty.

## Konfigurácia

### Nastavenie Zigbee2MQTT

Pred importom šablóny do TapHome musí byť RTCGQ11LM spárovaný s koordinátorom Zigbee2MQTT:

1. Otvorte webové UI Zigbee2MQTT a zapnite párovací režim (**Permit join**)
2. Na RTCGQ11LM podržte reset tlačidlo približne 5 sekúnd, kým nezačne blikať modrá LED
3. Zariadenie sa zobrazí v zozname zariadení Zigbee2MQTT s IEEE adresou (napr. `0x00158d00036cd3e2`). Voliteľne mu vo webovom UI Zigbee2MQTT v nastaveniach zariadenia priraďte friendly name.

Ak sa párovanie nepodarí, skúste namiesto dlhého podržania jedno krátke stlačenie. Na koordinátoroch typu CC2531 zvyčajne pomôže vytiahnuť a znova zasunúť USB stick pred reštartom Zigbee2MQTT.

### Premenná modulu

Po importe šablóny v TapHome nastavte vlastnú premennú `XiaomiRTCGQ11LM`, ktorá identifikuje zariadenie na MQTT brokeri:

| Premenná | Popis | Kde získať | Príklad |
|----------|-------|------------|---------|
| `XiaomiRTCGQ11LM` | Zigbee2MQTT friendly name alebo IEEE adresa tohto RTCGQ11LM | Zigbee2MQTT web UI → Devices → nájdite RTCGQ11LM → skopírujte IEEE alebo friendly name | `0x00158d00036cd3e2` |

Predvolený zástupný text v šablóne (`0x00158d00036cd3e2`) je iba príklad a **musí** byť nahradený skutočnou adresou vášho snímača. Skript listeneru sa prihlasuje k topicu `zigbee2mqtt/{XiaomiRTCGQ11LM}` a parsuje JSON payload stavu.

> [!TIP]
> Použitie friendly name (napr. `chodba_pohyb`) namiesto surovej IEEE adresy robí konfiguráciu čitateľnejšou a zostane stabilná aj pri prípadnom opätovnom spárovaní snímača.

## Schopnosti zariadenia

### Detekcia pohybu

Šablóna mapuje snímač ako Reed Contact zariadenie v TapHome. Názov "reed contact" je konvencia šablóny; správanie je štandardný PIR vstup obsadenosti. Udalosti pohybu prichádzajú na topic `zigbee2mqtt/{id}` v JSON formáte a mapujú sa na číselný stav:

| Payload Zigbee2MQTT | Hodnota v TapHome |
|--------------------|-------------------|
| `"occupancy": true` | 1 (pohyb) |
| `"occupancy": false` | 0 (kľud) |
| iné / chýba | NaN |

Prvá správa `occupancy: true` sa publikuje až pri prvej detekcii pohybu po pripojení zariadenia do siete — nie pri dokončení párovania.

> [!IMPORTANT]
> Hardvér RTCGQ11LM vynucuje **60-sekundovú mŕtvu zónu** po každej detekcii: po nahlásení pohybu snímač ignoruje ďalší pohyb počas 60 sekúnd. Voľbu `occupancy_timeout` v Zigbee2MQTT preto ponechajte na predvolených 90 s (alebo viac) — hodnoty pod 60 s by vygenerovali správu `occupancy: false` ešte počas prítomnosti osoby. Toto obmedzenie sa bez hardvérovej úpravy nedá obísť.

### Batéria, napätie a kvalita spojenia

Inštancia snímača vystavuje tri servisné atribúty iba na čítanie, parsované z tej istej JSON stavovej správy:

- **Battery** — zvyšné percento batérie (0–100 %), formátované ako `"N%"`. Prvú hodnotu po spárovaní môže hlásiť až po 24 hodinách. Kým nepríde prvá správa, zobrazuje sa `"-"`.
- **Voltage** — surové napätie batérie v milivoltoch (typicky ~3000 mV na novom CR2450), formátované ako `"N mV"`. Užitočný nezávislý indikátor slabnúcej batérie — percento môže ešte vyzerať zdravo, keď je článok už príliš slabý pre spoľahlivý prenos Zigbee.
- **LinkQuality** — indikátor kvality Zigbee spojenia (0–255 LQI), formátovaný ako `"N lqi"`. Hodnoty pod 20 spravidla znamenajú nespoľahlivé spojenie.

### Schopnosti, ktoré šablóna zatiaľ nemapuje

RTCGQ11LM cez Zigbee2MQTT publikuje aj tieto entity, ktoré šablóna **nespracováva** — dajú sa doplniť rozšírením skriptu listeneru v budúcej revízii šablóny:

- `illuminance` / `illuminance_lux` — úroveň okolitého osvetlenia v luxoch (vhodné pre lux-filtrované automatizácie pohybu)
- `device_temperature` — vnútorná teplota čipu v °C (iba diagnostická, nie okolitá teplota v miestnosti)
- `power_outage_count` — počítadlo vybratí batérie

Topic dostupnosti Zigbee2MQTT (`zigbee2mqtt/{id}/availability`) ani konfiguračná voľba `occupancy_timeout` (`zigbee2mqtt/bridge/request/device/options`) nie sú šablónou obsluhované; ako indikátor živosti tohto spiaceho zariadenia sa odporúča LinkQuality a Battery.

## Riešenie problémov

### Snímač nehlási žiadny stav

1. Overte, že RTCGQ11LM sa v zozname zariadení Zigbee2MQTT zobrazuje so zeleným stavom.
2. Skontrolujte, či premenná `XiaomiRTCGQ11LM` presne zodpovedá friendly name alebo IEEE adrese — u friendly name záleží na veľkosti písmen.
3. Spustite detekciu pohybom pred snímačom. Prvá stavová správa sa publikuje až pri prvej detekcii po pripojení.
4. Pomocou MQTT klienta (napr. MQTT Explorer) sa prihláste k topicu `zigbee2mqtt/#` a overte, že pri pohybe prichádzajú správy na topic `zigbee2mqtt/{vas_nazov}`.

### Pohyb zostáva aktívny aj po odchode osoby

Ide o očakávanú 60-sekundovú hardvérovú mŕtvu zónu v kombinácii so `occupancy_timeout` v Zigbee2MQTT (predvolene 90 s). Snímač neohlási `occupancy: false`, kým časovač nevyprší bez ďalšieho pohybu. Kratšie timeouty nie sú spoľahlivé — snímač prvých 60 s po detekcii pohyb jednoducho ignoruje.

### Náhodné odpojenia

Bežné príčiny vypadávania Aqara/Xiaomi koncových zariadení zo Zigbee siete:

1. **Slabý signál** — skontrolujte LinkQuality; hodnoty pod 20 zvyčajne znamenajú, že snímač potrebuje bližší mains-powered Zigbee router.
2. **Nízke napätie batérie** — atribút Voltage je lepší ukazovateľ ako percento. Zigbee2MQTT výslovne upozorňuje, že snímač môže vypadnúť zo siete aj pri stále "zdravo" vyzerajúcom percente, sledujte teda citeľný pokles voči ~3000 mV na novej článku a CR2450 vymeňte, keď sa spojenie stane nespoľahlivým.
3. **Nekompatibilné routre** — Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, SmartThings a Securifi routre sú známe tým, že staršie Xiaomi/Aqara zariadenia zo siete "vypadnú". Často pomôže spárovať snímač priamo s koordinátorom (reset snímača s ním v bezprostrednej blízkosti).

> [!WARNING]
> Koncové zariadenia Aqara Zigbee nepodporujú štandardný ping v režime Zigbee2MQTT availability a môžu sa javiť ako offline, aj keď normálne fungujú. Na sledovanie živosti sa nespoliehajte na availability topic — použite LinkQuality a Battery ako ukazovatele zdravia.

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

Tieto zariadenia sa po importe zobrazia v TapHome.

Aqara Motion Sensor (RTCGQ11LM) Modul

Vlastné premenné

|                                                 |                                                                                                                                                                                                                       |
|-------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `XiaomiRTCGQ11LM` (string) = 0x00158d00036cd3e2 | Zigbee2MQTT friendly name alebo IEEE adresa (0x… 16-hex) tohto RTCGQ11LM — používa sa ako prípona MQTT topicu zigbee2mqtt/{this}. Predvolený zástupný text musí byť po spárovaní nahradený skutočnou adresou snímača. |

Snímač pohybu Jazýčkový kontakt Len na čítanie

PIR detekcia obsadenosti — hlási pohyb (1) pri detekcii, kľud (0) po uplynutí 60 s hardvérovej mŕtvej zóny a Zigbee2MQTT occupancy\_timeout.

boolean JSON (PARSEJSON on occupancy key)

Servisné atribúty

|             |                                                                                                                                             |
|-------------|---------------------------------------------------------------------------------------------------------------------------------------------|
| Batéria     | Zvyšné percento batérie (gombíková batéria CR2450, 0–100 %). Formátované ako 'N%'; prvú hodnotu po spárovaní môže hlásiť až po 24 hodinách. |
| Napätie     | Surové napätie batérie v milivoltoch (~3000 mV na novom CR2450). Presnejší indikátor slabnúcej batérie ako percento.                        |
| LinkQuality | Indikátor kvality Zigbee spojenia (0–255 LQI). Hodnoty pod 20 spravidla znamenajú nespoľahlivé spojenie a časté odpojenia.                  |

Čítanie (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;
```

Servisné atribúty

Battery

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

Voltage

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

LinkQuality

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

**Pripojenie:** Packet Parser → MQTT

Možné vylepšenia (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.

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

## Zdroje

- 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

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