TapHome

Aqara Snímač pohybu (RTCGQ11LM)

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 05. 2026

Vyžaduje externú bránu

Zigbee2MQTT Zigbee2MQTT bridge (any supported Zigbee coordinator — e.g. Sonoff ZBDongle-E/P, CC2652, ConBee II) — stránka produktu

Aqara Snímač pohybu (RTCGQ11LM)

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áPopisKde získaťPríklad
XiaomiRTCGQ11LMZigbee2MQTT friendly name alebo IEEE adresa tohto RTCGQ11LMZigbee2MQTT web UI → Devices → nájdite RTCGQ11LM → skopírujte IEEE alebo friendly name0x00158d00036cd3e2

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.

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 Zigbee2MQTTHodnota v TapHome
"occupancy": true1 (pohyb)
"occupancy": false0 (kľud)
iné / chýbaNaN

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

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).

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

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 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: IP adresa vášho MQTT 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.

Krok 2 — Importujte šablónu brány v TapHome

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: 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

Aqara Motion Sensor (RTCGQ11LM) Modul
Vlastné premenné
XiaomiRTCGQ11LM (string) = 0x00158d00036cd3e2Zigbee2MQTT 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ériaZvyš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ätieSurové napätie batérie v milivoltoch (~3000 mV na novom CR2450). Presnejší indikátor slabnúcej batérie ako percento.
LinkQualityIndikátor kvality Zigbee spojenia (0–255 LQI). Hodnoty pod 20 spravidla znamenajú nespoľahlivé spojenie a časté odpojenia.

Snímač pohybu

Čítanie (modul)
# 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
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
IF(ISNAN(battery),"-",battery+"%");
Voltage
IF(ISNAN(voltage),"-",voltage+"mV");
LinkQuality
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.

Zdroje

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli