Skip to main content

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

  1. Reset sensor - Hold the reset button (small hole) for 5 seconds with a pin until LED flashes.
  2. Fresh battery - Install a new CR1632 (standard) or CR2450 (P2) battery before pairing.
  3. Distance - During pairing, keep sensor within 10 feet of your Zigbee hub.
  4. For Matter P2 - Use the Matter code on the sensor to pair directly with Apple Home, Google Home, or SmartThings.
  5. 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

  1. Check magnet alignment - The small magnet must be within 20mm of the sensor body when closed.
  2. Verify orientation - Install with the side indicator marks aligned. Mounting direction matters.
  3. Check battery - Low battery causes slow or missed reports. Replace if below 20%.
  4. Re-pair sensor - Remove from hub and re-add to reset the connection.
  5. 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

  1. Clean surface - Remove dust and grease before applying adhesive tape.
  2. Metal doors - Mount sensor on the door frame instead of the metal door, or use a spacer.
  3. Reduce gap - Magnet must be within 20mm. Use spacers to bring sensor and magnet closer.
  4. 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

  1. Standard model - Requires Aqara Hub with HomeKit support. Sensor appears via the hub.
  2. P2 Matter - Pairs directly using Matter code without needing Aqara hub.
  3. Check hub - Ensure Aqara Hub is connected to HomeKit/Matter controller.
  4. Re-add sensor - Remove and re-add to refresh the connection.