TapHome

Aqara Motion Sensor (RTCGQ11LM)

Packet Parser → MQTT
Autor
Posljednje ažuriranje: 04. 2026

Potreban je vanjski pristupnik (gateway)

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

Aqara Motion Sensor (RTCGQ11LM)

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:

VarijablaOpisKako je dobitiPrimjer
XiaomiRTCGQ11LMZigbee2MQTT friendly name ili IEEE adresa ovog senzora RTCGQ11LMWeb-sučelje Zigbee2MQTT → Devices → pronađite RTCGQ11LM → kopirajte IEEE adresu ili friendly name0x00158d00036cd3e2

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

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 Zigbee2MQTTVrijednost u sustavu TapHome
"occupancy": true1 (pokret)
"occupancy": false0 (mirovanje)
drugo / nedostajeNaN

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

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.

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

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
  2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
  3. Idite na Configuration → Configure MQTT i postavite:
    • Host: IP adresu vašeg MQTT 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.

Korak 2 — Uvezite predložak pristupnika u sustav TapHome

  1. Preuzmite predložak pristupnika sa stranice kompatibilnosti Zigbee2Tasmota Gateway
  2. U sustavu TapHome idite na Postavke → Hardver → Packet Parser → Uvoz
  3. Uvezite predložak s ovim parametrima:
    • MQTT Broker IP Address: 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

Aqara Motion Sensor (RTCGQ11LM) Modul
Prilagođene varijable
XiaomiRTCGQ11LM (string) = 0x00158d00036cd3e2Zigbee2MQTT 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
BaterijaPreostali postotak baterije (gumbasta baterija CR2450, 0–100 %). U obliku 'N%'; nakon uparivanja može proći do 24 h dok stigne prva vrijednost.
NaponNeobrađeni napon baterije u milivoltima (~3000 mV kod nove baterije CR2450). Precizniji pokazatelj slabe baterije od postotka.
LinkQualityPokazatelj kvalitete Zigbee veze (0–255 LQI). Vrijednosti ispod 20 obično znače nepouzdanu vezu i česta odspajanja.

Senzor pokreta

Čitanje (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;
Servisni atributi
Battery
IF(ISNAN(battery),"-",battery+"%");
Voltage
IF(ISNAN(voltage),"-",voltage+"mV");
LinkQuality
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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu