---
title: "Aqara Door and Window Sensor"
description: "Zigbee ajtó- és ablakérzékelő Tasmota gateway-en át. Nyitás/zárás érzékelése, akkumulátorfigyelés alacsony töltöttségi szint esetén."
url: "https://taphome.com/hu/compatibility/zigbee2tasmota-aqara-door-and-window-sensor/"
language: hu
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","security"]
  questions: ["Hogyan integrálhatom az Aqara ajtó- és ablakérzékelőt a TapHome-mal?","Mit érzékel az Aqara MCCGQ11LM TapHome sablon?","Hogyan párosíthatom az Aqara ajtóérzékelőt egy Zigbee2Tasmota gateway-jel?","Miért nem jelenti az Aqara ajtóérzékelőm a kontaktállapotot?","Figyeli az Aqara ajtóérzékelő sablon az akkumulátorszintet a TapHome-ban?","Hogyan hoz létre egy sablon egyszerre ajtó- és ablakérzékelőt?"]
---

# Aqara Door and Window Sensor

Kommunikáció: Packet Parser → MQTT

- [Aqara ajtó- és ablakérzékelő](https://www.aqara.com/en/product/door-and-window-sensor)

> 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ó

> [!IMPORTANT]
> 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](https://taphome.com/hu/compatibility/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éter | Leírás | Példa |
|-----------|--------|-------|
| **MQTT Broker IP Address** | Az MQTT broker IP-címe | `192.168.1.10` |
| **MQTT Broker Port** | Broker port (alapértelmezett 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Zigbee rövid cím a párosításból | `0x1234` |

## 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útum | Leírás |
|------------|--------|
| **IEEEAddr** | Egyedi 64 bites hardverazonosító |
| **ModelId** | Zigbee modell ID (`lumi.sensor_magnet.aq2`) |
| **Manufacturer** | Az eszköz által jelentett gyártói karakterlánc |
| **Endpoints** | Aktív Zigbee végpontok |
| **Config** | Zigbee eszközkonfiguráció |
| **Link Quality** | Jelerő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**).

> [!WARNING]
> 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

> [!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 2

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Aqara Door and Window Sensor Modul

Szerviz attribútumok

|                  |                                                                  |
|------------------|------------------------------------------------------------------|
| IEEEAddr         | Zigbee IEEE cím — az érzékelő egyedi 64 bites hardverazonosítója |
| ModelId          |                                                                  |
| Gyártó           |                                                                  |
| Endpoints        |                                                                  |
| Config           |                                                                  |
| Jelminőség       | Zigbee jelerősség — 0% (nincs jel) – 100% (legjobb)              |
| Elem feszültség  | CR1632 gombelem feszültsége voltban                              |
| Akkumulátorszint | Becsü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

Olvasás (modul)

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

Figyelő

```taphome
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

```taphome
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
```

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

```taphome
BatteryVoltage + " V"
```

Battery Percentage

```taphome
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

Figyelő

```taphome
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

Figyelő

```taphome
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.

## 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`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Források

- Tasmota Zigbee Documentation
  
  [tasmota.github.io](https://tasmota.github.io/docs/Zigbee/)
- Zigbee Compatible Devices Database
- Blakadder Device Entry — Aqara MCCGQ11LM
  
  [zigbee.blakadder.com](https://zigbee.blakadder.com/Aqara_MCCGQ11LM.html) 2026-03-29
- Aqara Product Page — Door and Window Sensor
  
  [www.aqara.com](https://www.aqara.com/en/product/door-and-window-sensor) 2026-03-29
- Aqara MCCGQ11LM — Product Specifications Datasheet
  
  [cdn-reichelt.de](https://cdn-reichelt.de/documents/datenblatt/R800/AQARA_MCCGQ11LM_DB-EN.pdf) 2026-03-29

A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket.

## 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/)