Aqara Door and Window Sensor T1 (DW-S03D) – compatibility & pairing guide
The Aqara Door and Window Sensor T1 (model DW-S03D) is a two-part magnetic contact sensor. It reports "open" when the magnet moves more than 22 mm away from the sensor, which makes it suitable for doors, windows, drawers, cabinets, letterboxes and even gas-meter wheels.
Branding: the device and box may carry a different brand name, shown as small grey text on the side of the device. Hardware, model number, Zigbee stack and functionality are identical to the Aqara original.

Compatibility at a glance
| Platform | Works? | What you need | Notes |
|---|---|---|---|
| Aqara Home app | Yes | Aqara Zigbee 3.0 hub (e.g. Hub M3, M2, M1S Gen 2, E1, Camera Hub G3 / G2H Pro) | Full feature set, automations, firmware updates |
| Apple Home (HomeKit) | Yes, via Aqara hub | HomeKit-compatible Aqara hub | Appears as: Contact sensor |
| Matter (Google Home, Alexa, SmartThings, Apple Home) | Yes, via Aqara hub | Matter-compatible Aqara hub (Matter bridge) + the ecosystem's Matter controller | Features depend on hub firmware and controller |
| Home Assistant – ZHA | Yes | Zigbee coordinator (USB dongle) | Device ID lumi.magnet.agl02 |
| Zigbee2MQTT | Yes | Zigbee coordinator + Zigbee2MQTT | Model MCCGQ12LM |
| deCONZ / Phoscon | Confirmed (community) | ConBee / RaspBee | Listed on zigbee.blakadder.com |
What the sensor reports (Zigbee2MQTT)
contactbatteryvoltage
Pairing with an Aqara hub (Aqara Home app)
- Set up your Aqara Zigbee 3.0 hub in the Aqara Home app.
- Tap "+" › Add device, choose the product and select the hub.
- Press and hold the reset button for about 5 seconds until the blue LED starts blinking, then release.
- Name the device, assign a room and, if you use Apple Home, it appears there automatically through the hub.
Pairing with Zigbee2MQTT
- Click "Permit join (All)" in the Zigbee2MQTT front end.
- Press and hold the reset button for about 5 seconds until the blue LED starts blinking, then release.
- Wait until the interview has completed and the device shows as supported (MCCGQ12LM).
- Rename it and use the exposed values in Home Assistant via MQTT discovery.
Pairing with Home Assistant (ZHA)
- Settings › Devices & services › Zigbee Home Automation › Add device.
- Press and hold the reset button for about 5 seconds until the blue LED starts blinking, then release.
- Keep the device awake until ZHA finishes the configuration; it should be identified as lumi.magnet.agl02.
- If no entities appear, update Home Assistant and the coordinator firmware, factory-reset the device and pair again close to the coordinator.
Tips & known issues
- Mount the magnet on the moving part (door leaf or window sash) and the sensor on the frame, with the alignment marks facing each other. The gap must stay under 22 mm when closed.
- On sliding doors with a horizontal slide the sensor can send several conflicting states. In Zigbee2MQTT, set the device option debounce: 1 to filter them.
- This model identifies itself as lumi.magnet.agl02. Older ZHA setups that only knew the previous model (lumi.sensor_magnet.aq2) showed no open/close state; current zha-quirks support it, so update Home Assistant and your coordinator firmware before pairing.
- During pairing with a third-party coordinator, keep the sensor awake by briefly pressing the button or moving the magnet until the interview finishes.
Battery, battery replacement & reset
Battery: 1 × CR1632 (included).
Factory reset / re-pairing: Press and hold the reset button for about 5 seconds until the blue LED starts blinking, then release.
Frequently asked questions
Does the Aqara Door and Window Sensor T1 work with Home Assistant?
Yes. It is supported by ZHA (device lumi.magnet.agl02) and by Zigbee2MQTT (model MCCGQ12LM), which exposes contact, battery and voltage. You need a Zigbee coordinator or an Aqara hub.
Which battery does the DW-S03D use?
One CR1632 coin cell, included. Open the sensor housing to replace it.
Can I use it without the Aqara hub?
Yes, with any Zigbee 3.0 coordinator running Zigbee2MQTT, ZHA or deCONZ. Apple Home, Alexa and Matter integration through Aqara do need an Aqara hub.
Buy the Aqara Door and Window Sensor T1
€7.95 per unit from 20 units, €6.45 from 100 and €4.95 from 500 (incl. VAT, plus DHL shipping).
Packs: 20-pack · 100-pack · 500-pack
Device and box may carry a different brand name (small grey text on the side); hardware, model number, Zigbee stack and functionality are identical to the Aqara original.
Sources: zigbee2mqtt.io device page, zigbee.blakadder.com, zha-device-handlers and the Aqara product page. Checked 18 Nov 2026. Feature support in third-party software can change with new versions. zigbee2mqtt.io/MCCGQ12LM · aqara.com
More guides
- Aqara Motion Sensor P1 – Compatibility & pairing guide
- Aqara Smoke Detector – Compatibility & pairing guide
- Aqara Temperature and Humidity Sensor T1 – Compatibility & pairing guide
- Aqara Wireless Mini Switch T1 – Compatibility & pairing guide
- Which Aqara sensor do I need?
- Using Aqara sensors without the Aqara hub
- Aqara wholesale: bulk prices from 20 units