TapHome

Aqara Door and Window Sensor

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

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

tasmota zigbee2tasmota-gateway — termékoldal

Aqara Door and Window Sensor

Ez az eszköz Zigbee-n keresztül kommunikál egy Tasmota gateway-en át. Győződj meg róla, hogy a Zigbee2Tasmota Gateway sablon importálva van és az eszközöd párosítva van.

Az Aqara Door and Window Sensor (MCCGQ11LM) egy kompakt, elemes Zigbee kontaktérzékelő. Mágneses reed kontaktus segítségével érzékeli, hogy az ajtó vagy ablak nyitva vagy zárva van-e. A TapHome MQTT-n keresztül kommunikál az érzékelővel egy Zigbee2Tasmota gateway-en át — az érzékelő a ZbReceived JSON üzenetben publikálja a kontaktállapotát minden állapotváltozáskor.

Ez a sablon két eszközt hoz létre egyetlen fizikai érzékelőből: egy Ajtóérzékelőt és egy Ablakérzékelőt. Mindkettő ugyanazt a Contact mezőt olvassa a Zigbee üzenetből. A felhasználó így az egyiket ajtókontaktként, a másikat ablakkontaktként rendelheti hozzá a TapHome-ban, vagy csak azt használhatja, amelyik a tényleges telepítésnek megfelel. A nem használt eszközöket a TapHome beállításaiban el lehet rejteni.

Konfiguráció

Az érzékelő párosítása
  1. A TapHome-ban kapcsold be a Permit Join kapcsolót a Zigbee2Tasmota Gateway modulban
  2. Az érzékelőn tartsd nyomva a kis gombot, amíg a kék LED villogni nem kezd, majd engedd el
  3. Várd meg, amíg a Devices Found számláló növekszik — az érzékelő Device ID-ja (pl. 0x1234) megjelenik a gateway szervizattribútumaiban
  4. Importáld ezt az eszközsablont a párosításból származó Device ID-val
Import paraméterek
ParaméterLeírásPélda
MQTT Broker IP AddressAz MQTT broker IP-címe192.168.1.10
MQTT Broker PortBroker port (alapértelmezett 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee rövid cím a párosításból0x1234

Eszközképességek

Ajtó- és ablakkontaktus-érzékelés

A sablon két reed kontaktus eszközt biztosít — Ajtóérzékelő és Ablakérzékelő — mindkettő PacketParserReedContact-ként van mappolva biztonsági funkcióval. Minden eszköz a Contact mezőt parszolja a ZbReceived.{DeviceID}-ből az MQTT SENSOR üzenetben:

  • Contact = true → zárva (ajtó/ablak be van csukva)
  • Contact = false → nyitva (ajtó/ablak ki van nyitva)

Az érzékelő azonnal jelenti a kontaktállapotot minden változáskor, lehetővé téve a valós idejű automatizálási triggereket (pl. lámpa bekapcsolása ajtónyitáskor, riasztás küldése váratlan ablaknyitáskor).

Akkumulátorfigyelés

A modul két szervizattribútumon keresztül követi az akkumulátor állapotát:

  • Battery Percentage — becsült töltöttségi szint; alacsony akkumulátor figyelmeztetés aktiválódik, ha a szint 30 % alá esik
  • Battery Voltage — a CR1632 cella nyers feszültsége voltban

Az akkumulátoradatok a ZbReceived üzenet BatteryPercentage és BatteryVoltage mezőiből kerülnek kiolvasásra.

Offline észlelés

A sablon a LastSeenEpoch időbélyeg alapján figyeli az eszköz elérhetőségét a ZbInfo lekérdezésből (óránként):

  • Figyelmeztetés — az eszköz több mint 12 órája nem látható
  • Hiba — az eszköz több mint 24 órája nem látható

Ez segít felismerni azokat a helyzeteket, amikor az érzékelő elvesztette a Zigbee kapcsolatot, vagy az elem teljesen lemerült.

Diagnosztikai szervizattribútumok

A modul további Zigbee metaadatokat tesz elérhetővé az órás ZbInfo lekérdezésen keresztül:

AttribútumLeírás
IEEEAddrEgyedi 64 bites hardverazonosító
ModelIdZigbee modell ID (lumi.sensor_magnet.aq2)
ManufacturerAz eszköz által jelentett gyártói karakterlánc
EndpointsAktív Zigbee végpontok
ConfigZigbee eszközkonfiguráció
Link QualityJelerősség 0–100 % skálán
További képességek

Az Aqara MCCGQ11LM a belső eszközhőmérsékletet is jelenti Zigbee-n keresztül. Az üzenetenkénti jelminőség (LQI) minden SENSOR payloadban elérhető, de jelenleg csak modulmezőn az órás ZbInfo lekérdezésen keresztül van kiajánlva. Ezek a képességek egy jövőbeli sablonfrissítésben kerülhetnek hozzáadásra.

Hibaelhárítás

Az érzékelő nem jelenti a kontaktállapotot
  1. Ellenőrizd, hogy az érzékelő párosítva van a Zigbee2Tasmota gateway-jel — nézd meg a ZbStatus-t a Tasmota konzolban
  2. Győződj meg róla, hogy a sablonban szereplő Device ID megegyezik a párosításból származó rövid címmel (pl. 0x1234)
  3. Nyisd ki és csukd be az ajtót/ablakot az állapotváltozás kiváltásához — az érzékelő csak változáskor publikál, nem folyamatosan
  4. Használj MQTT klienst (pl. MQTT Explorer) a tele/{GWname}/SENSOR topicra való feliratkozáshoz, és ellenőrizd, hogy az érzékelő ZbReceived üzeneteket publikál Contact mezővel
Offline figyelmeztetés működő érzékelő mellett
  1. Az offline észlelés a ZbInfo lekérdezésre támaszkodik (óránként). Ha az érzékelő 12 órán belül nem küldött üzenetet, figyelmeztetés jelenik meg
  2. Az elemes Zigbee eszközök alvó üzemmódban vannak az események között — ez normális viselkedés. A figyelmeztetés általában eltűnik a következő kontaktállapot-változás vagy ZbInfo lekérdezés után
  3. Ha a figyelmeztetés 24 óránál tovább fennáll, ellenőrizd az elemet (CR1632), és szükség esetén párosítsd újra az eszközt
Ajtóérzékelő és ablakérzékelő ugyanazt az állapotot mutatja

Ez várható — mindkét eszköz ugyanannak a fizikai érzékelőnek a Contact mezőjét olvassa. Rejtsd el a nem használt eszközt a TapHome-ban (Settings → Devices → válaszd ki az eszközt → Hide).

Az Aqara MCCGQ11LM CR1632 gombelemet használ. Az elem élettartama normál használat mellett általában 2+ év. Gyakori állapotváltozások (pl. forgalmas ajtók) vagy gyenge Zigbee jel (amely üzenet-újraküldést igényel) csökkenthetik az elem élettartamát.

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 Door and Window Sensor Modul
Szerviz attribútumok
IEEEAddrZigbee IEEE cím — az érzékelő egyedi 64 bites hardverazonosítója
ModelId
Gyártó
Endpoints
Config
JelminőségZigbee jelerősség — 0% (nincs jel) – 100% (legjobb)
Elem feszültségCR1632 gombelem feszültsége voltban
AkkumulátorszintBecsült akkumulátorszint — figyelmeztetés 30% alatt
Egyéni változók
GWname (string)A Zigbee gateway Tasmota MQTT topic neve (Configuration → MQTT → Topic alatt)
ID (string)Az érzékelő Zigbee rövid címe (párosítás során kiosztva)
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

Olvasás (modul)
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
Figyelő
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
Szerviz attribútumok
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Ajtóérzékelő Reed kontaktus Csak olvasható

Reed kontaktus ajtó nyitás/zárás érzékelésére — a Zigbee szenzorüzenet Contact mezőjét olvassa

boolean

Ajtóérzékelő

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
Ablakérzékelő Reed kontaktus Csak olvasható

Reed kontaktus ablak nyitás/zárás érzékelésére — a Zigbee szenzorüzenet Contact mezőjét olvassa

boolean

Ablakérzékelő

Figyelő
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
Kapcsolat: Packet Parser → MQTT
Lehetséges fejlesztések (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.

Források