TapHome

Aqara Door and Window Sensor

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

Potreban je vanjski pristupnik (gateway)

tasmota zigbee2tasmota-gateway — stranica proizvoda

Aqara Door and Window Sensor

Ovaj uređaj komunicira preko protokola Zigbee putem pristupnika Tasmota. Prije nastavka provjerite jeste li uvezli predložak Zigbee2Tasmota Gateway i uparili uređaj.

Aqara Door and Window Sensor (MCCGQ11LM) je kompaktan Zigbee kontaktni senzor na baterije. Pomoću magnetskog reed kontakta prepoznaje jesu li vrata ili prozor otvoreni ili zatvoreni. TapHome komunicira sa senzorom preko protokola MQTT putem pristupnika Zigbee2Tasmota. Senzor pri svakoj promjeni stanja objavljuje stanje kontakta u JSON poruci ZbReceived.

Ovaj predložak od jednog fizičkog senzora stvara dva uređaja: Senzor vrata i Senzor prozora. Oba čitaju isto polje Contact iz Zigbee poruke. Korisnik tako u sustavu TapHome jedan uređaj može dodijeliti kao kontakt vrata, a drugi kao kontakt prozora, ili koristiti samo onaj koji odgovara stvarnoj ugradnji. Uređaje koji se ne koriste moguće je sakriti u postavkama sustava TapHome.

Konfiguracija

Uparivanje senzora
  1. U sustavu TapHome uključite sklopku Permit Join u modulu Zigbee2Tasmota Gateway
  2. Na senzoru pritisnite i držite malu tipku dok plava LED dioda ne počne treptati, a zatim je otpustite
  3. Pričekajte da se brojač Devices Found poveća. Device ID senzora (npr. 0x1234) prikazuje se u servisnim atributima pristupnika
  4. Uvezite ovaj predložak uređaja s Device ID-jem dobivenim pri uparivanju
Parametri uvoza
ParametarOpisPrimjer
MQTT Broker IP AddressIP adresa vašeg MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (zadano 1883)1883
Gateway nameMQTT tema uređaja Tasmota (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDKratka Zigbee adresa dobivena pri uparivanju0x1234

Mogućnosti uređaja

Prepoznavanje kontakta vrata i prozora

Predložak sadrži dva uređaja s reed kontaktom, Senzor vrata i Senzor prozora. Oba su mapirana kao PacketParserReedContact sa sigurnosnom funkcijom security. Svaki uređaj čita polje Contact iz ZbReceived.{DeviceID} u MQTT poruci SENSOR:

  • Contact = true → zatvoreno (vrata/prozor su zatvoreni)
  • Contact = false → otvoreno (vrata/prozor su otvoreni)

Senzor javlja stanje kontakta odmah pri svakoj promjeni, pa automatizacije mogu reagirati u stvarnom vremenu (npr. uključiti svjetlo kad se vrata otvore ili poslati upozorenje kad se prozor neočekivano otvori).

Praćenje baterije

Modul prati stanje baterije putem dva servisna atributa:

  • Razina baterije — procijenjena razina napunjenosti; upozorenje na slabu bateriju pojavljuje se kad razina padne ispod 30 %
  • Napon baterije — neobrađena vrijednost napona članka CR1632 u voltima

Podaci o bateriji čitaju se iz polja BatteryPercentage i BatteryVoltage u poruci ZbReceived.

Prepoznavanje prekida veze

Predložak prati dostupnost uređaja pomoću vremenske oznake LastSeenEpoch iz periodičnog upita ZbInfo (svakih sat vremena):

  • Upozorenje — uređaj se nije javio dulje od 12 sati
  • Pogreška — uređaj se nije javio dulje od 24 sata

Tako se mogu otkriti situacije u kojima je senzor izgubio Zigbee vezu ili je baterija potpuno ispražnjena.

Dijagnostički servisni atributi

Modul prikazuje dodatne Zigbee metapodatke dobivene periodičnim upitom ZbInfo:

AtributOpis
IEEEAddrJedinstveni 64-bitni hardverski identifikator
ModelIdZigbee ID modela (lumi.sensor_magnet.aq2)
ProizvođačNaziv proizvođača koji javlja uređaj
EndpointsAktivne Zigbee krajnje točke (endpoints)
ConfigZigbee konfiguracija uređaja
Kvaliteta vezeJačina signala u rasponu 0–100 %
Dodatne mogućnosti

Aqara MCCGQ11LM preko protokola Zigbee javlja i unutarnju temperaturu uređaja. Kvaliteta veze (LQI) dostupna je u svakoj poruci SENSOR, ali se zasad prikazuje samo na razini modula putem upita ZbInfo svakih sat vremena. Ove mogućnosti mogu se dodati u nekom od budućih ažuriranja predloška.

Rješavanje problema

Senzor ne javlja stanje kontakta
  1. Provjerite je li senzor uparen s pristupnikom Zigbee2Tasmota. Provjerite ZbStatus u konzoli Tasmota
  2. Provjerite odgovara li Device ID u predlošku kratkoj adresi dobivenoj pri uparivanju (npr. 0x1234)
  3. Otvorite i zatvorite vrata/prozor kako biste izazvali promjenu stanja. Senzor objavljuje poruke samo pri promjeni, a ne neprekidno
  4. Pomoću MQTT klijenta (npr. MQTT Explorer) pretplatite se na temu tele/{GWname}/SENSOR i provjerite objavljuje li senzor poruke ZbReceived s poljem Contact
Upozorenje o prekidu veze iako senzor radi
  1. Prepoznavanje prekida veze oslanja se na upit ZbInfo (svakih sat vremena). Ako senzor u 12 sati nije poslao nijednu poruku, pojavljuje se upozorenje
  2. Zigbee uređaji na baterije između događaja su u stanju mirovanja. To je normalno. Upozorenje obično nestaje nakon sljedeće promjene stanja kontakta ili sljedećeg upita ZbInfo
  3. Ako upozorenje traje dulje od 24 sata, provjerite bateriju (CR1632) i po potrebi ponovno uparite uređaj
Senzor vrata i Senzor prozora prikazuju isto stanje

To je očekivano, jer oba uređaja čitaju polje Contact istog fizičkog senzora. Uređaj koji ne koristite sakrijte u sustavu TapHome (Postavke → Uređaji → odaberite uređaj → Sakrij).

Aqara MCCGQ11LM koristi gumbastu bateriju CR1632. Pri uobičajenoj upotrebi baterija obično traje više od 2 godine. Česte promjene stanja (npr. vrata kroz koja se često prolazi) ili slab Zigbee signal (zbog kojeg se poruke moraju ponovno slati) mogu skratiti trajanje baterije.

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 Door and Window Sensor Modul
Servisni atributi
IEEEAddrZigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator senzora
ModelId
Proizvođač
Endpoints
Config
Kvaliteta vezeJačina Zigbee signala — od 0 % (nema signala) do 100 % (najbolji)
Napon baterijeNapon gumbaste baterije CR1632 u voltima
Razina baterijeProcijenjena razina baterije — upozorenje ispod 30 %
Prilagođene varijable
GWname (string)Naziv MQTT teme Zigbee pristupnika u sustavu Tasmota (nalazi se u Configuration → MQTT → Topic)
ID (string)Kratka Zigbee adresa senzora (dodjeljuje se pri uparivanju)
After pairing the sensor via Permit Join, find the device short address in the gateway's Devices Found service attribute or via Tasmota console command ZbStatus

Aqara - Door and Window Sensor

Čitanje (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
	var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true);
    var bat := PARSEJSON(ZbReceived, "BatteryPercentage", true);
    if(!ISNULL(bat), BatteryPercentage := bat);
    var volt := PARSEJSON(ZbReceived, "BatteryVoltage", true);
    if(!ISNULL(volt), BatteryVoltage := volt);
    
    var deviceInfo := PARSEJSON(RECEIVEDMSG.Payload, "ZbInfo." + ID, true);
    if !ISNULL(deviceInfo)
    	LastSeenEpoch := PARSEJSON(deviceInfo, "LastSeenEpoch");
        COMPLETESERVICEATTRIBUTE("IEEEAddr", PARSEJSON(deviceInfo, "IEEEAddr"));
        COMPLETESERVICEATTRIBUTE("ModelId", PARSEJSON(deviceInfo, "ModelId"));
        COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer"));
        COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints"));
        COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config"));
        COMPLETESERVICEATTRIBUTE("Link Quality", ROUND(LINEAR(PARSEJSON(deviceInfo, "LinkQuality"), 0,0, 254, 100)) + "%");
    end
end

if BatteryPercentage < 30
	ADDWARNING("Low battery (<30%)");
end

if !ISNAN(LastSeenEpoch)
	DATETIME now := NOW();
	var secondsSeen := now.UNIXTIME - LastSeenEpoch;
	if secondsSeen > 12 * 60 * 60
		if secondsSeen > 24 * 60 * 60
			ADDERROR("Device is offline > 24H");
		else
			ADDWARNING("Device is offline > 12H");        
		end
	end
end
Servisni atributi
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Senzor vrata Magnetski kontakt Samo za čitanje

Reed kontakt za prepoznavanje otvaranja i zatvaranja vrata — čita polje Contact iz Zigbee poruke senzora

boolean

Senzor vrata

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
Senzor prozora Magnetski kontakt Samo za čitanje

Reed kontakt za prepoznavanje otvaranja i zatvaranja prozora — čita polje Contact iz Zigbee poruke senzora

boolean

Senzor prozora

Listener
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
Povezivanje: Packet Parser → MQTT
Moguća poboljšanja (3)
  • Device Temperature — Blakadder lists device temperature measurement as an exposed feature. The Aqara MCCGQ11LM reports internal temperature via Zigbee, but the TapHome template does not parse it.
  • Link Quality (device-level) — LinkQuality is available per SENSOR message but only exposed as a module-level service attribute via ZbInfo polling.
  • Sensor Calibration — Some Zigbee platforms support per-sensor calibration offsets. Not configurable in TapHome template.

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