Aqara Door and Window Sensors use a magnetic reed switch to detect when doors or windows open/close. Available in standard Zigbee and Matter-compatible P2 variants. This guide covers detection and connectivity issues.
Sensor Not Pairing
Symptoms
- LED doesn't flash during pairing
- Hub can't find sensor
- Pairing times out
Solutions
- Reset sensor - Hold the reset button (small hole) for 5 seconds with a pin until LED flashes.
- Fresh battery - Install a new CR1632 (standard) or CR2450 (P2) battery before pairing.
- Distance - During pairing, keep sensor within 10 feet of your Zigbee hub.
- For Matter P2 - Use the Matter code on the sensor to pair directly with Apple Home, Google Home, or SmartThings.
- Hub compatibility - Standard model works with Aqara hubs; P2 Matter works with any Matter controller.
Open/Close State Not Updating
Symptoms
- Shows stuck on open or closed
- State updates delayed
- Automations not triggering
Solutions
- Check magnet alignment - The small magnet must be within 20mm of the sensor body when closed.
- Verify orientation - Install with the side indicator marks aligned. Mounting direction matters.
- Check battery - Low battery causes slow or missed reports. Replace if below 20%.
- Re-pair sensor - Remove from hub and re-add to reset the connection.
- Check Zigbee mesh - Ensure there are Zigbee routers (powered devices) between sensor and hub.
Installation Issues
Symptoms
- Sensor falls off
- Doesn't work on metal doors
- Gap too large between sensor parts
Solutions
- Clean surface - Remove dust and grease before applying adhesive tape.
- Metal doors - Mount sensor on the door frame instead of the metal door, or use a spacer.
- Reduce gap - Magnet must be within 20mm. Use spacers to bring sensor and magnet closer.
- Alternative mounting - Consider screw mounting for heavy doors or high-traffic areas.
HomeKit/Matter Not Working
Symptoms
- Not appearing in Apple Home
- Matter pairing fails
- Status not syncing
Solutions
- Standard model - Requires Aqara Hub with HomeKit support. Sensor appears via the hub.
- P2 Matter - Pairs directly using Matter code without needing Aqara hub.
- Check hub - Ensure Aqara Hub is connected to HomeKit/Matter controller.
- Re-add sensor - Remove and re-add to refresh the connection.