TapHome

Aqara Door and Window Sensor

Packet Parser → MQTT
Pridal
Posledná aktualizácia: 03. 2026

Vyžaduje externú bránu

tasmota zigbee2tasmota-gateway — stránka produktu

Aqara Door and Window Sensor

Toto zariadenie komunikuje cez Zigbee prostredníctvom Tasmota gateway. Uistite sa, že máte importovanú šablónu 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
ParameterPopisPríklad
MQTT Broker IP AddressIP adresa vášho MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (predvolene 1883)1883
Gateway nameTasmota MQTT topic (Configuration → MQTT → Topic)tasmota_XXXXX
Device IDZigbee krátka adresa z párovania0x1234

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útPopis
IEEEAddrUnikátny 64-bitový hardvérový identifikátor
ModelIdZigbee model ID (lumi.sensor_magnet.aq2)
ManufacturerReťazec výrobcu hlásený zariadením
EndpointsAktívne Zigbee endpointy
ConfigZigbee konfigurácia zariadenia
Link QualitySila 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).

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

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 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: IP adresa vášho MQTT 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.

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

  1. Stiahnite si šablónu brány zo stránky kompatibility Zigbee2Tasmota Gateway
  2. V TapHome prejdite na Nastavenia → Hardware → Packet Parser → Import
  3. Importujte šablónu s týmito parametrami:
    • MQTT Broker IP Address: 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

Aqara Door and Window Sensor Modul
Servisné atribúty
IEEEAddrZigbee IEEE adresa — unikátny 64-bitový hardvérový identifikátor senzora
ModelId
Výrobca
Endpoints
Config
Kvalita spojeniaSila Zigbee signálu — 0 % (žiadny signál) až 100 % (najlepší)
Napätie batérieNapätie gombíkovej batérie CR1632 vo voltoch
Úroveň batérieOdhadovaná ú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

Aqara - Door and Window Sensor

Čítanie (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
Servisné atribúty
IEEEAddr
MQTTPUBLISH("cmnd/" + GWname+ "/ZbInfo", ID)
ModelId
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
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

Dverový senzor

Listener
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

Okenný senzor

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

Zdroje