---
title: "Aqara Door and Window Sensor"
description: "Zigbee senzor za vrata i prozore preko pristupnika Tasmota. Prepoznaje otvaranje i zatvaranje, prati bateriju i upozorava na slabu bateriju i prekid veze."
url: "https://taphome.com/hr/compatibility/zigbee2tasmota-aqara-door-and-window-sensor/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2tasmota","battery-powered","security"]
  questions: ["Kako integrirati Aqara senzor za vrata i prozore sa sustavom TapHome?","Što prepoznaje predložak Aqara MCCGQ11LM u sustavu TapHome?","Kako upariti Aqara senzor vrata s pristupnikom Zigbee2Tasmota?","Zašto moj Aqara senzor vrata ne javlja stanje kontakta?","Prati li predložak Aqara senzora vrata razinu baterije u sustavu TapHome?","Kako jedan predložak stvara i senzor vrata i senzor prozora?"]
---

# Aqara Door and Window Sensor

Komunikacija: Packet Parser → MQTT

- [Aqara senzor za vrata i prozore](https://www.aqara.com/en/product/door-and-window-sensor)

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

> [!IMPORTANT]
> Ovaj uređaj komunicira preko protokola **Zigbee** putem pristupnika Tasmota. Prije nastavka provjerite jeste li
> uvezli predložak [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/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

| Parametar | Opis | Primjer |
|-----------|-------------|---------|
| **MQTT Broker IP Address** | IP adresa vašeg MQTT brokera | `192.168.1.10` |
| **MQTT Broker Port** | Port brokera (zadano 1883) | `1883` |
| **Gateway name** | MQTT tema uređaja Tasmota (Configuration → MQTT → Topic) | `tasmota_XXXXX` |
| **Device ID** | Kratka Zigbee adresa dobivena pri uparivanju | `0x1234` |

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

| Atribut | Opis |
|-----------|-------------|
| **IEEEAddr** | Jedinstveni 64-bitni hardverski identifikator |
| **ModelId** | Zigbee ID modela (`lumi.sensor_magnet.aq2`) |
| **Proizvođač** | Naziv proizvođača koji javlja uređaj |
| **Endpoints** | Aktivne Zigbee krajnje točke (endpoints) |
| **Config** | Zigbee konfiguracija uređaja |
| **Kvaliteta veze** | Jač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**).

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

> [!TIP]
> 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](https://tasmota.github.io/docs/Getting-Started/)
2. Preko web-sučelja Tasmota spojite pristupnik na svoju Wi-Fi mrežu
3. Idite na **Configuration** → **Configure MQTT** i postavite:
   - **Host:** za ugrađeni broker IP adresu centralne jedinice TapHome Core (s rezervacijom IP adrese u usmjerivaču → [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)), inače IP adresu vašeg 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](https://tasmota.github.io/docs/Zigbee/).

### Korak 2 — Uvezite predložak pristupnika u sustav TapHome

1. Preuzmite predložak pristupnika sa stranice kompatibilnosti [Zigbee2Tasmota Gateway](https://taphome.com/hr/compatibility/zigbee2tasmota-gateway/)
2. U sustavu TapHome idite na **Postavke** → **Hardver** → **Packet Parser** → **Uvoz**
3. Uvezite predložak s ovim parametrima:
   - **MQTT Broker IP Address:** za ugrađeni broker TapHome `127.0.0.1`, inače 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 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Aqara Door and Window Sensor Modul

Servisni atributi

|                 |                                                                            |
|-----------------|----------------------------------------------------------------------------|
| IEEEAddr        | Zigbee IEEE adresa — jedinstveni 64-bitni hardverski identifikator senzora |
| ModelId         |                                                                            |
| Proizvođač      |                                                                            |
| Endpoints       |                                                                            |
| Config          |                                                                            |
| Kvaliteta veze  | Jačina Zigbee signala — od 0 % (nema signala) do 100 % (najbolji)          |
| Napon baterije  | Napon gumbaste baterije CR1632 u voltima                                   |
| Razina baterije | Procijenjena 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

Čitanje (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
```

Servisni atributi

IEEEAddr

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

ModelId

```

```

Manufacturer

```

```

Endpoints

```

```

Config

```

```

Link Quality

```

```

Battery Voltage

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

Battery Percentage

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

Senzor vrata Magnetski kontakt Samo za čitanje

Reed kontakt za prepoznavanje otvaranja i zatvaranja vrata — čita polje Contact iz Zigbee poruke 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
```

Senzor prozora Magnetski kontakt Samo za čitanje

Reed kontakt za prepoznavanje otvaranja i zatvaranja prozora — čita polje Contact iz Zigbee poruke 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
```

**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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji                                        | Zadano          |
|-------------------------------------------------------------|-----------------|
| 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`        |

## Izvori

- 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

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

