TapHome

Aqara Mozgásérzékelő (RTCGQ11LM)

Packet Parser → MQTT
Beküldő
Utoljára frissítve: 06. 2026

Külső átjáró szükséges

Zigbee2MQTT Zigbee2MQTT bridge (any supported Zigbee coordinator — e.g. Sonoff ZBDongle-E/P, CC2652, ConBee II) — termékoldal

Aqara Mozgásérzékelő (RTCGQ11LM)

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ásHogyan szerezhető megPélda
XiaomiRTCGQ11LMZigbee2MQTT friendly name vagy IEEE cím ehhez a RTCGQ11LM-hezZigbee2MQTT web UI → Devices → keresse meg a RTCGQ11LM-et → másolja az IEEE-t vagy friendly name-et0x00158d00036cd3e2

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.

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 payloadTapHome érték
"occupancy": true1 (mozgás)
"occupancy": false0 (nyugalmi)
egyéb / hiányzikNaN

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.

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

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

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 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: az MQTT 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 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 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 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

Aqara Motion Sensor (RTCGQ11LM) Modul
Egyéni változók
XiaomiRTCGQ11LM (string) = 0x00158d00036cd3e2Ennek 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átorHá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égNyers elemfeszültség millivoltban (új CR2450-en ~3000 mV). Pontosabb gyenge-elem indikátor, mint a százalék.
LinkQualityZigbee kapcsolatminőség-mutató (0–255 LQI). A 20 alatti értékek általában megbízhatatlan kapcsolatot és gyakori szétkapcsolásokat jeleznek.

Mozgásérzékelő

Olvasás (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");
Figyelő
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
IF(ISNAN(battery),"-",battery+"%");
Voltage
IF(ISNAN(voltage),"-",voltage+"mV");
LinkQuality
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.

Források

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

TapHome által hitelesítve

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon