Matter & Aqara
Overview
Matter is handled by the Matter Server add-on (v9.0.2). The Aqara ecosystem provides the majority of Matter-bridged devices — two hubs bridge 15+ Aqara devices (water leak sensors, motion sensors, smart locks, wireless switch, temp/humidity sensor) into Home Assistant.
Matter Hubs
| Hub | Model | Firmware | Purpose |
|---|---|---|---|
| Aqara Hub M2 | Aqara Hub M2 | 4.3.8 | Primary bridge hub (most devices) |
| Aqara Camera Hub G3 | Aqara Camera Hub G3 | 4.5.30 | Secondary bridge + camera |
Both hubs act as Thread/Matter border routers and connect to HA via the Matter integration.
Matter Devices
Via Aqara Hub M2
| Device | Model | Area |
|---|---|---|
| Aqara Water Leak Sensor (×4) | Aqara Water Leak Sensor (sw v6) | (unassigned — multiple locations) |
| Garage Smart Lock | Aqara Smart Lock U100 (sw 31) | Garage |
Via Aqara Camera Hub G3
| Device | Model | Area |
|---|---|---|
| Aqara Water Leak Sensor (×2) | Aqara Water Leak Sensor (sw v6) | (unassigned) |
| Guest Bathroom Water Leak Sensor | Aqara Water Leak Sensor (sw v6) | Guest Bathroom |
| Bedroom Temp / Humidity Sensor | Aqara Temp/Humidity Sensor (sw v5) | Bedroom |
| Aqara Wireless Mini Switch | Aqara Wireless Mini Switch (sw v2) | (unassigned) |
| Upstairs Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Upstairs Hallway |
| Garage Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Garage |
| Kitchen Smart Lock | Aqara Smart Lock U100 (sw 300) | Kitchen |
| Downstairs Motion Sensor | Aqara Motion Sensor P1 (sw v10) | Media Room |
| Hallway Aqara Motion Sensor P1 | Aqara Motion Sensor P1 (sw v10) | Hallway |
Key Entity Types
Water Leak Sensors
Each sensor provides:
binary_sensor.*.water_leak— triggersWater Leak Alertautomation- Battery sensors (CR2032 type, voltage, %)
Deployed locations: multiple bathroom, kitchen, utility areas (exact sensor-to-location mapping should be labelled on the physical devices).
Motion Sensors (Aqara P1)
Each provides:
binary_sensor.*.occupancy— used in motion lighting automations- Battery sensors
| Sensor | Area | Automation |
|---|---|---|
| Upstairs Motion Sensor | Upstairs Hallway | Motion Activation Upstairs Hallway 2 |
| Garage Motion Sensor | Garage | Motion Activation Garage |
| Downstairs Motion Sensor | Media Room | — |
| Hallway Aqara Motion Sensor P1 | Hallway | Motion Activation Hallway Lights |
Smart Locks (Aqara U100)
| Lock | Area | State |
|---|---|---|
| Kitchen Smart Lock | Kitchen | locked |
| Garage Smart Lock | Garage | unlocked |
Both provide:
lock.*control entitybinary_sensor.*_actuator— physical bolt status- Operating mode selector
Automation: Smart Lock Unlocked 30 Min Alert monitors all locks.
Wireless Mini Switch (Aqara)
event.aqara_wireless_mini_switch_button— single, double, long press events- Area: unassigned (portable button)
Thread
The Thread integration is loaded (entry: 890ec7b4) and supports Thread networking. The Aqara hubs function as Thread border routers, enabling Thread-based device connectivity in future expansions.
Notes / Gotchas
- If either Aqara hub goes offline, all devices bridged through it become unavailable in HA. The Hub M2 and Hub G3 are both critical infrastructure.
- The 4 unassigned water leak sensors should be physically labelled and area-assigned in HA (Settings → Devices) to improve observability.
- Kitchen Smart Lock shows
sw v300while Garage Smart Lock showssw v31— different firmware tracks (U100 has multiple hardware revisions).
Last Updated
2026-06-24
No comments to display
No comments to display