---
title: "Aqara Door and Window Sensor"
description: "Zigbee dverový a okenný kontaktný senzor cez Tasmota gateway. Detekcia otvorenia/zatvorenia, monitoring batérie s upozornením na nízky stav."
url: "https://taphome.com/sk/compatibility/zigbee2tasmota-aqara-door-and-window-sensor/"
language: sk
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","security"]
  questions: ["Ako integrovať Aqara dverový a okenný senzor s TapHome?","Čo detekuje šablóna Aqara MCCGQ11LM v TapHome?","Ako spárovať Aqara dverový senzor so Zigbee2Tasmota gateway?","Prečo môj Aqara dverový senzor nehlási kontaktný stav?","Monitoruje šablóna Aqara dverového senzora úroveň batérie v TapHome?","Ako jedna šablóna vytvorí dverový aj okenný senzor?"]
---

# Aqara Door and Window Sensor

Komunikácia: Packet Parser → MQTT

- [Aqara dverový a okenný senzor](https://www.aqara.com/en/product/door-and-window-sensor)

> Adresa v sieti
> 
> Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

> [!IMPORTANT]
> Toto zariadenie komunikuje cez **Zigbee** prostredníctvom Tasmota gateway. Uistite sa, že máte
> importovanú šablónu [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/)
> a vaše zariadenie je spárované.

Aqara Door and Window Sensor (MCCGQ11LM) je kompaktný, batériovo napájaný Zigbee kontaktný senzor. Detekuje, či sú dvere alebo okno otvorené alebo zatvorené pomocou magnetického jazýčkového kontaktu. TapHome komunikuje so senzorom cez MQTT prostredníctvom Zigbee2Tasmota gateway — senzor publikuje svoj kontaktný stav v JSON správe `ZbReceived` pri každej zmene stavu.

Táto šablóna vytvára **dve zariadenia** z jedného fyzického senzora: **Dverový senzor** a **Okenný senzor**. Obe čítajú rovnaké pole `Contact` zo Zigbee správy. Používateľ tak môže jedno zariadenie priradiť ako dverový kontakt a druhé ako okenný kontakt v TapHome, alebo použiť len to, ktoré zodpovedá skutočnej inštalácii. Nepoužívané zariadenia je možné skryť v nastaveniach TapHome.

## Konfigurácia

### Spárovanie senzora

1. V TapHome zapnite prepínač **Permit Join** v module Zigbee2Tasmota Gateway
2. Na senzore stlačte a podržte malé tlačidlo, kým nezačne blikať modrá LED, potom pustite
3. Počkajte, kým sa zvýši počítadlo **Devices Found** — Device ID senzora (napr. `0x1234`) sa zobrazí v servisných atribútoch gateway
4. Importujte túto šablónu zariadenia s Device ID z párovania

### Parametre importu

| Parameter | Popis | Príklad |
|-----------|-------|---------|
| **MQTT Broker IP Address** | IP adresa vášho MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (predvolene 1883) | `1883` |
| **Gateway name** | Tasmota MQTT topic (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Zigbee krátka adresa z párovania | `0x1234` |

## Schopnosti zariadenia

### Detekcia kontaktu dverí a okien

Šablóna poskytuje dve zariadenia s jazýčkovým kontaktom — **Dverový senzor** a **Okenný senzor** — obe mapované ako `PacketParserReedContact` s bezpečnostnou funkciou. Každé zariadenie parsuje pole `Contact` z `ZbReceived.{DeviceID}` v MQTT SENSOR správe:

- **Contact = true** → zatvorené (dvere/okno sú zavreté)
- **Contact = false** → otvorené (dvere/okno sú otvorené)

Senzor hlási kontaktný stav okamžite pri každej zmene, čo umožňuje automatizačné triggery v reálnom čase (napr. zapnutie svetla pri otvorení dverí, odoslanie upozornenia pri neočakávanom otvorení okna).

### Monitoring batérie

Modul sleduje stav batérie prostredníctvom dvoch servisných atribútov:

- **Battery Percentage** — odhadovaná úroveň nabitia; **upozornenie na nízku batériu** sa aktivuje, keď úroveň klesne pod 30 %
- **Battery Voltage** — nespracované napätie článku CR1632 vo voltoch

Údaje o batérii sa parsujú z polí `BatteryPercentage` a `BatteryVoltage` v správe `ZbReceived`.

### Detekcia offline stavu

Šablóna monitoruje dostupnosť zariadenia pomocou časovej značky `LastSeenEpoch` z periodického dopytovania `ZbInfo` (každú 1 hodinu):

- **Varovanie** — zariadenie nebolo videné viac ako **12 hodín**
- **Chyba** — zariadenie nebolo videné viac ako **24 hodín**

Pomáha to odhaliť situácie, keď senzor stratil Zigbee pripojenie alebo je batéria úplne vybitá.

### Diagnostické servisné atribúty

Modul poskytuje ďalšie Zigbee metadáta získané cez periodické dopytovanie `ZbInfo`:

| Atribút | Popis |
|---------|-------|
| **IEEEAddr** | Unikátny 64-bitový hardvérový identifikátor |
| **ModelId** | Zigbee model ID (`lumi.sensor_magnet.aq2`) |
| **Manufacturer** | Reťazec výrobcu hlásený zariadením |
| **Endpoints** | Aktívne Zigbee endpointy |
| **Config** | Zigbee konfigurácia zariadenia |
| **Link Quality** | Sila signálu v rozsahu 0–100 % |

### Ďalšie schopnosti

Aqara MCCGQ11LM tiež hlási internú teplotu zariadenia cez Zigbee. Kvalita spojenia (LQI) pre jednotlivé správy je dostupná v každom SENSOR payloade, ale momentálne je sprístupnená len na úrovni modulu cez hodinové dopytovanie `ZbInfo`. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### Senzor nehlási kontaktný stav

1. Overte, že senzor je spárovaný so Zigbee2Tasmota gateway — skontrolujte `ZbStatus` v Tasmota konzole
2. Potvrďte, že **Device ID** v šablóne zodpovedá krátkej adrese z párovania (napr. `0x1234`)
3. Otvorte a zatvorte dvere/okno pre vyvolanie zmeny stavu — senzor publikuje len pri zmene, nie priebežne
4. Použite MQTT klienta (napr. MQTT Explorer) na prihlásenie na topic `tele/{GWname}/SENSOR` a overte, že senzor publikuje správy `ZbReceived` s poľom `Contact`

### Upozornenie na offline stav napriek funkčnému senzoru

1. Detekcia offline stavu sa spolieha na dopytovanie `ZbInfo` (hodinové). Ak senzor neodoslal žiadnu správu za 12 hodín, zobrazí sa varovanie
2. Batériové Zigbee zariadenia spia medzi udalosťami — toto je normálne správanie. Varovanie sa zvyčajne vymaže po ďalšej zmene kontaktného stavu alebo `ZbInfo` dopytu
3. Ak varovanie pretrváva dlhšie ako 24 hodín, skontrolujte batériu (CR1632) a v prípade potreby zariadenie znovu spárujte

### Dverový senzor aj okenný senzor zobrazujú rovnaký stav

Toto je očakávané — obe zariadenia čítajú pole `Contact` z rovnakého fyzického senzora. Skryte nepoužívané zariadenie v TapHome (**Settings** → **Devices** → vyberte zariadenie → **Hide**).

> [!WARNING]
> Aqara MCCGQ11LM používa gombíkovú batériu CR1632. Životnosť batérie je zvyčajne 2+ roky pri bežnom používaní. Časté zmeny stavu (napr. frekventované dvere) alebo slabý Zigbee signál (vyžadujúci opätovné prenosy správ) môžu životnosť batérie skrátiť.

## Ako nainštalovať v TapHome

### Predpoklady

- Zigbee brána s firmvérom Tasmota (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
- MQTT broker bežiaci vo vašej lokálnej sieti (vstavaný TapHome broker alebo externý)
- TapHome CCU v rovnakej sieti

> [!TIP]
> TapHome má vstavaný MQTT broker — aktivujte ho v **Nastavenia** → **Hardware** → **MQTT Broker**. Nie je potrebný žiadny ďalší softvér.

### Krok 1 — Nastavte Tasmota Zigbee bránu

1. Nahrajte [firmvér Tasmota](https://tasmota.github.io/docs/Getting-Started/) na podporovaný Zigbee koordinátor (napr. Sonoff ZBBridge, eWeLink ZB-GW03)
2. Pripojte bránu k vašej Wi-Fi sieti cez webové rozhranie Tasmota
3. Prejdite na **Configuration** → **Configure MQTT** a nastavte:
   - **Host:** pre vstavaný broker IP adresa TapHome Core (s rezerváciou IP v routeri → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)), inak IP adresa vášho brokera (napr. `192.168.1.10`)
   - **Port:** `1883`
   - **Topic:** zapíšte si názov topicu (napr. `tasmota_XXXXX`) — budete ho potrebovať pri importe šablóny

Podrobné pokyny nájdete v [dokumentácii Tasmota Zigbee](https://tasmota.github.io/docs/Zigbee/).

### Krok 2 — Importujte šablónu brány v TapHome

1. Stiahnite si šablónu brány zo stránky kompatibility [Zigbee2Tasmota Gateway](https://taphome.com/sk/compatibility/zigbee2tasmota-gateway/)
2. V TapHome prejdite na **Nastavenia** → **Hardware** → **Packet Parser** → **Import**
3. Importujte šablónu s týmito parametrami:
   - **MQTT Broker IP Address:** pre vstavaný broker TapHome `127.0.0.1`, inak IP adresa vášho brokera (napr. `192.168.1.10`)
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** Tasmota MQTT topic z kroku 1 (napr. `tasmota_XXXXX`)

Po importe uvidíte dve zariadenia: **Permit Join** (prepínač) a **Devices Found** (počítadlo).

### Krok 3 — Spárujte Zigbee zariadenie

1. V TapHome zapnite prepínač **Permit Join** — otvorí sa 60-sekundové okno pre párovanie
2. Na Zigbee zariadení spustite proces párovania (zvyčajne podržte tlačidlo reset 5 sekúnd, kým LED nezačne blikať)
3. Sledujte počítadlo **Devices Found** — zvýši sa, keď sa pripojí nové zariadenie
4. Skontrolujte **Service Attributes** brány, kde uvidíte ID nového zariadenia (napr. `0x1234`), výrobcu a model
5. Režim párovania sa automaticky deaktivuje po uplynutí časového limitu

### Krok 4 — Importujte šablónu zariadenia

1. Stiahnite si šablónu konkrétneho zariadenia z príslušnej stránky kompatibility
2. Importujte šablónu s týmito parametrami:
   - **MQTT Broker IP Address:** rovnaká ako pre bránu
   - **MQTT Broker Port:** `1883`
   - **Gateway name:** rovnaký Tasmota MQTT topic ako vyššie
   - **Device ID:** krátka adresa z párovania (napr. `0x1234`)

## Dostupné zariadenia 2

Tieto zariadenia sa po importe zobrazia v TapHome.

Aqara Door and Window Sensor Modul

Servisné atribúty

|                  |                                                                          |
|------------------|--------------------------------------------------------------------------|
| IEEEAddr         | Zigbee IEEE adresa — unikátny 64-bitový hardvérový identifikátor senzora |
| ModelId          |                                                                          |
| Výrobca          |                                                                          |
| Endpoints        |                                                                          |
| Config           |                                                                          |
| Kvalita spojenia | Sila Zigbee signálu — 0 % (žiadny signál) až 100 % (najlepší)            |
| Napätie batérie  | Napätie gombíkovej batérie CR1632 vo voltoch                             |
| Úroveň batérie   | Odhadovaná úroveň batérie — upozornenie pri poklese pod 30 %             |

Vlastné premenné

`GWname` (string) Názov Tasmota MQTT topicu Zigbee gateway (nájdete v Configuration → MQTT → Topic) 

`ID` (string) Zigbee krátka adresa senzora (priradená počas párovania)

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

Čítanie (modul)

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

Listener

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

Servisné atribúty

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

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

Battery Percentage

```taphome
BatteryPercentage + "%"
```

Dverový senzor Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na detekciu otvorenia/zatvorenia dverí — číta pole Contact zo Zigbee správy senzora

boolean

Listener

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
```

Okenný senzor Jazýčkový kontakt Len na čítanie

Jazýčkový kontakt na detekciu otvorenia/zatvorenia okna — číta pole Contact zo Zigbee správy senzora

boolean

Listener

```taphome
if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0
    var val := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Contact", true);
    if(!ISNULL(val), Rc := val);
end
```

**Pripojenie:** Packet Parser → MQTT

Možné vylepšenia (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.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii                                         | Predvolené      |
|-------------------------------------------------------------|-----------------|
| Mqtt Broker IP adresa                                       | `192.168.0.1`   |
| Mqtt Broker port                                            | `1883`          |
| Gateway name (Tasmota-&gt;Configuration-&gt;MQTT-&gt;Topic) | `tasmota_XXXXX` |
| Device ID                                                   | `0xFFFF`        |

## Zdroje

- 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

Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely.

## Súvisiaca dokumentácia

- [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)
- [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)