--- title: "Aqara Mozgásérzékelő (RTCGQ11LM)" description: "Aqara RTCGQ11LM Zigbee PIR mozgásérzékelő Zigbee2MQTT és MQTT PacketParser-rel. Mozgás, elem, feszültség és kapcsolatminőség a TapHome-ban." url: "https://taphome.com/hu/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/" language: hu lastmod: 2026-04-24 generator: hugo ai: topics: ["mqtt","sensor","zigbee","zigbee2mqtt","battery-powered","motion-detection"] questions: ["Hogyan integrálható az Aqara RTCGQ11LM mozgásérzékelő a TapHome-ba Zigbee2MQTT-n keresztül?","Mit jelent a RTCGQ11LM TapHome sablon?","Hogyan állítható be a RTCGQ11LM Zigbee2MQTT friendly name vagy IEEE címe a TapHome-ban?","Miért marad aktív a mozgás a RTCGQ11LM-nél 60 másodpercig egyetlen észlelés után?","Jelenti a RTCGQ11LM sablon az elem állapotát és a kapcsolat minőségét?","Miért szakad meg néha a RTCGQ11LM kapcsolata a Zigbee2MQTT-vel?"] --- # Aqara Mozgásérzékelő (RTCGQ11LM) Kommunikáció: Packet Parser → MQTT - [Zigbee2MQTT — RTCGQ11LM eszközoldal](https://www.zigbee2mqtt.io/devices/RTCGQ11LM.html) > Hálózati cím > > A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató Az Aqara RTCGQ11LM (egyes piacokon Xiaomi Mi Motion Sensor néven forgalmazott) kompakt, elemes Zigbee 3.0 PIR foglaltság-érzékelő, amely CR2450 gombelemmel működik. A TapHome-mal közvetetten kommunikál — az érzékelő egy Zigbee2MQTT koordinátorral (pl. Sonoff ZBDongle-P/E vagy CC2652 alapú stick) van párosítva, amely a Zigbee üzeneteket MQTT topicokra fordítja. A TapHome ezekre a MQTT topicokra egy PacketParser MQTT modulon keresztül iratkozik fel. A sablon az érzékelőt bináris foglaltsági bemenetként (mozgás / nincs mozgás) térképezi le, és szolgáltatás-attribútumként kiteszi az elem százalékos szintjét, a nyers elemfeszültséget és a Zigbee kapcsolat minőségét. ## Konfiguráció ### Zigbee2MQTT beállítás A TapHome sablon importálása előtt a RTCGQ11LM-et párosítani kell egy Zigbee2MQTT koordinátorral: 1. Nyissa meg a Zigbee2MQTT webes felületét, és engedélyezze a párosítási módot (**Permit join**) 2. A RTCGQ11LM-en tartsa lenyomva a reset gombot kb. 5 másodpercig, amíg a kék LED villogni nem kezd 3. Az eszköz megjelenik a Zigbee2MQTT eszközlistájában egy IEEE címmel (pl. `0x00158d00036cd3e2`). Opcionálisan a Zigbee2MQTT webes felületén az eszközbeállításokban friendly name-et rendelhet hozzá. Ha a párosítás nem sikerül, próbálkozzon hosszú nyomás helyett egyetlen rövid gombnyomással. CC2531 alapú koordinátorok esetén általában segít az USB stick kihúzása és visszadugása a Zigbee2MQTT újraindítása előtt. ### Modul változó A sablon TapHome-ba történő importálása után állítsa be a `XiaomiRTCGQ11LM` egyéni változót, amely az eszközt azonosítja az MQTT brokeren: | Változó | Leírás | Hogyan szerezhető meg | Példa | |---------|--------|------------------------|-------| | `XiaomiRTCGQ11LM` | Zigbee2MQTT friendly name vagy IEEE cím ehhez a RTCGQ11LM-hez | Zigbee2MQTT web UI → Devices → keresse meg a RTCGQ11LM-et → másolja az IEEE-t vagy friendly name-et | `0x00158d00036cd3e2` | A sablonban lévő alapértelmezett helykitöltő (`0x00158d00036cd3e2`) csak példa, és azt **kötelező** lecserélni az Ön érzékelőjének tényleges címére. A listener script a `zigbee2mqtt/{XiaomiRTCGQ11LM}` topicra iratkozik fel, és a JSON állapot payloadot értelmezi. > [!TIP] > A friendly name (pl. `folyoso_mozgas`) használata a nyers IEEE cím helyett olvashatóbbá teszi a konfigurációt, és stabil marad akkor is, ha az érzékelőt később újrapárosítják. ## Eszközképességek ### Mozgásérzékelés A sablon az érzékelőt Reed Contact eszközként térképezi le a TapHome-ban. A „reed contact" elnevezés csak sablon-konvenció; a viselkedés szabványos PIR foglaltsági bemenet. A mozgásesemények a `zigbee2mqtt/{id}` topicon érkeznek JSON formátumban, és numerikus állapotra képezik le: | Zigbee2MQTT payload | TapHome érték | |---------------------|---------------| | `"occupancy": true` | 1 (mozgás) | | `"occupancy": false` | 0 (nyugalmi) | | egyéb / hiányzik | NaN | Az első `occupancy: true` üzenet csak akkor jelenik meg, amikor az eszköz a hálózatba lépés után először észlel mozgást — nem a párosítás befejezésekor. > [!IMPORTANT] > A RTCGQ11LM hardvere minden észlelés után **60 másodperces holt zónát** kényszerít ki: amint mozgást jelent, az érzékelő 60 másodpercig figyelmen kívül hagy minden további mozgást. A Zigbee2MQTT `occupancy_timeout` opcióját ezért az alapértelmezett 90 s-on (vagy fölötte) kell hagyni — a 60 s alatti értékek `occupancy: false` üzenetet generálnának még akkor is, ha még van valaki a szobában. Ezt a korlátozást hardveres módosítás nélkül nem lehet megkerülni. ### Elem, feszültség és kapcsolatminőség Az érzékelő példány három, csak olvasható szolgáltatás-attribútumot tesz közzé, amelyek ugyanabból a JSON állapotüzenetből kerülnek kinyerésre: - **Battery** — hátralévő elemszázalék (0–100 %), `"N%"` formátumban. Az első érték jelentése akár 24 óráig is eltarthat a párosítás után. Amíg az első üzenet meg nem érkezik, `"-"` jelenik meg. - **Voltage** — nyers elemfeszültség millivoltban (új CR2450-en jellemzően ~3000 mV), `"N mV"` formátumban. Hasznos független alacsony elem-indikátor — a százalék még egészségesnek tűnhet, miközben a cella már túl gyenge a megbízható Zigbee átvitelhez. - **LinkQuality** — Zigbee kapcsolatminőség-mutató (0–255 LQI), `"N lqi"` formátumban. A 20 alatti értékek általában megbízhatatlan kapcsolatot jeleznek. ### A sablon által jelenleg nem kezelt képességek A RTCGQ11LM Zigbee2MQTT-n keresztül további entitásokat is közzétesz, amelyeket a sablon **nem dolgoz fel** — ezek egy jövőbeli sablonfrissítésben a listener script kiterjesztésével pótolhatók: - `illuminance` / `illuminance_lux` — környezeti fényszint luxban (lux-vezérelt mozgás-automatizációkhoz hasznos) - `device_temperature` — belső chip-hőmérséklet °C-ban (csak diagnosztikai, nem a szoba hőmérséklete) - `power_outage_count` — elem eltávolítási események számlálója A Zigbee2MQTT elérhetőségi topic (`zigbee2mqtt/{id}/availability`) és az `occupancy_timeout` konfigurációs opció (`zigbee2mqtt/bridge/request/device/options`) szintén nem érhető el a sablonból; ennek az alvó eszköznek az élet jeleként a LinkQuality és a Battery ajánlott. ## Hibaelhárítás ### Az érzékelő egyáltalán nem jelent állapotot 1. Ellenőrizze, hogy a RTCGQ11LM zöld státusszal szerepel-e a Zigbee2MQTT eszközlistájában. 2. Győződjön meg arról, hogy a `XiaomiRTCGQ11LM` változó pontosan megegyezik a friendly name-mel vagy IEEE címmel — friendly name-eknél a kis-nagybetű számít. 3. Váltson ki mozgást az érzékelő előtt. Az első állapotüzenet csak a hálózatba lépés utáni első észleléskor kerül közzétételre. 4. MQTT kliens (pl. MQTT Explorer) használatával iratkozzon fel a `zigbee2mqtt/#` topicra, és ellenőrizze, hogy mozgáskor megjelennek-e üzenetek a `zigbee2mqtt/{az_on_neve}` topicon. ### A mozgás a személy elhagyása után is aktív marad Ez a várható 60 másodperces hardveres holt zóna a Zigbee2MQTT `occupancy_timeout`-jával (alapértelmezés: 90 s) kombinálva. Az érzékelő csak akkor jelent `occupancy: false`-t, ha a számláló további mozgás nélkül lejár. A rövidebb timeoutok nem megbízhatóak — az érzékelő az észlelés utáni első 60 s-ban egyszerűen figyelmen kívül hagy minden mozgást. ### Véletlenszerű kapcsolatszakadások Gyakori okok, amiért Aqara/Xiaomi végeszközök kiesnek a Zigbee hálóból: 1. **Gyenge jel** — ellenőrizze a LinkQuality-t; a 20 alatti értékek általában azt jelentik, hogy az érzékelőnek közelebbi hálózati tápellátású Zigbee routerre van szüksége. 2. **Alacsony elemfeszültség** — a Voltage attribútum jobb mutató, mint a százalék. A Zigbee2MQTT kifejezetten jelzi, hogy az érzékelő akkor is kieshet a hálózatból, ha a százalékos érték még egészségesnek tűnik — figyelje tehát az új cella ~3000 mV-jához képesti érzékelhető csökkenést, és cserélje a CR2450-et, amint a kapcsolat megbízhatatlanná válik. 3. **Inkompatibilis routerek** — a Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, SmartThings és Securifi routerek közismertek arról, hogy régebbi Xiaomi/Aqara eszközöket „kidobnak" a mesh-ből. Gyakran segít az érzékelőt közvetlenül a koordinátorral párosítani (reset közvetlenül a koordinátor mellett). > [!WARNING] > Az Aqara Zigbee végeszközök nem támogatják a szabványos Zigbee2MQTT availability ping-et, és tévesen offline-nak tűnhetnek, miközben normálisan működnek. Ne bízza az élet jelét az availability topicra — a LinkQuality-t és a Battery-t használja egészség-indikátorként. ## Telepítés a TapHome-ban ### Előfeltételek - Zigbee átjáró Tasmota firmware-rel (pl. Sonoff ZBBridge, eWeLink ZB-GW03) - MQTT broker a helyi hálózaton (TapHome beépített broker vagy külső) - TapHome CCU ugyanazon a hálózaton > [!TIP] > A TapHome rendelkezik beépített MQTT brokerrel — aktiválja a **Beállítások** → **Hardware** → **MQTT Broker** menüpontban. Nincs szükség további szoftverre. ### 1. lépés — Tasmota Zigbee átjáró beállítása 1. Telepítse a [Tasmota firmware-t](https://tasmota.github.io/docs/Getting-Started/) egy támogatott Zigbee koordinátorra (pl. Sonoff ZBBridge, eWeLink ZB-GW03) 2. Csatlakoztassa az átjárót a Wi-Fi hálózathoz a Tasmota webes felületén 3. Navigáljon a **Configuration** → **Configure MQTT** menüpontra és állítsa be: - **Host:** a beépített brokerhez a TapHome Core IP-címe (IP-foglalással a routerben → [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)), egyébként a broker IP-címe (pl. `192.168.1.10`) - **Port:** `1883` - **Topic:** jegyezze fel a topic nevét (pl. `tasmota_XXXXX`) — szükség lesz rá a sablon importálásakor Részletes útmutatót a [Tasmota Zigbee dokumentációban](https://tasmota.github.io/docs/Zigbee/) talál. ### 2. lépés — Átjáró sablon importálása a TapHome-ba 1. Töltse le az átjáró sablont a [Zigbee2Tasmota Gateway](https://taphome.com/hu/compatibility/zigbee2tasmota-gateway/) kompatibilitási oldalról 2. A TapHome-ban lépjen a **Beállítások** → **Hardware** → **Packet Parser** → **Import** menüpontra 3. Importálja a sablont ezekkel a paraméterekkel: - **MQTT Broker IP Address:** a beépített TapHome brokerhez `127.0.0.1`, egyébként a broker IP-címe (pl. `192.168.1.10`) - **MQTT Broker Port:** `1883` - **Gateway name:** a Tasmota MQTT topic az 1. lépésből (pl. `tasmota_XXXXX`) Importálás után két eszköz jelenik meg: **Permit Join** (kapcsoló) és **Devices Found** (számláló). ### 3. lépés — Zigbee eszköz párosítása 1. A TapHome-ban kapcsolja be a **Permit Join** kapcsolót — megnyílik egy 60 másodperces párosítási ablak 2. A Zigbee eszközön indítsa el a párosítási folyamatot (jellemzően tartsa lenyomva a reset gombot 5 másodpercig, amíg a LED villogni nem kezd) 3. Figyelje a **Devices Found** számlálót — növekszik, amikor új eszköz csatlakozik 4. Ellenőrizze az átjáró **Service Attributes** részét az új eszköz azonosítójának (pl. `0x1234`), gyártójának és modelljének megtekintéséhez 5. A párosítási mód automatikusan deaktiválódik az időkorlát lejártakor ### 4. lépés — Eszközsablon importálása 1. Töltse le az eszközspecifikus sablont a megfelelő kompatibilitási oldalról 2. Importálja a sablont ezekkel a paraméterekkel: - **MQTT Broker IP Address:** ugyanaz, mint az átjáróé - **MQTT Broker Port:** `1883` - **Gateway name:** ugyanaz a Tasmota MQTT topic, mint fentebb - **Device ID:** a párosításból kapott rövid cím (pl. `0x1234`) ## Elérhető eszközök 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Aqara Motion Sensor (RTCGQ11LM) Modul Egyéni változók | | | |-------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `XiaomiRTCGQ11LM` (string) = 0x00158d00036cd3e2 | Ennek a RTCGQ11LM-nek a Zigbee2MQTT friendly name-je vagy IEEE címe (0x… 16-hex) — MQTT topic utótagként használva zigbee2mqtt/{this}. Az alapértelmezett helykitöltőt párosítás után kötelező cserélni az érzékelő valódi címére. | Mozgásérzékelő Reed kontaktus Csak olvasható PIR foglaltság-érzékelés — mozgást (1) jelez észleléskor, nyugalmi állapotot (0) a 60 s hardveres holtzóna és a Zigbee2MQTT occupancy\_timeout lejárta után. boolean JSON (PARSEJSON on occupancy key) Szerviz attribútumok | | | |-------------|---------------------------------------------------------------------------------------------------------------------------------------------| | Akkumulátor | Hátralévő elemszázalék (CR2450 gombelem, 0–100 %). 'N%' formátumban; az első érték jelentése a párosítás után akár 24 óráig is eltarthat. | | Feszültség | Nyers elemfeszültség millivoltban (új CR2450-en ~3000 mV). Pontosabb gyenge-elem indikátor, mint a százalék. | | LinkQuality | Zigbee kapcsolatminőség-mutató (0–255 LQI). A 20 alatti értékek általában megbízhatatlan kapcsolatot és gyakori szétkapcsolásokat jeleznek. | Olvasás (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"); ``` Figyelő ```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; ``` Szerviz attribútumok Battery ```taphome IF(ISNAN(battery),"-",battery+"%"); ``` Voltage ```taphome IF(ISNAN(voltage),"-",voltage+"mV"); ``` LinkQuality ```taphome IF(ISNAN(link),"-",link+"lqi"); ``` **Kapcsolat:** Packet Parser → MQTT Lehetséges fejlesztések (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. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |--------------------|---------------| | Mqtt Broker IP-cím | `192.168.0.1` | | Mqtt Broker port | `1883` | ## Források - 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 ## Kapcsolódó dokumentáció - [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/) - [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/) - [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)