# 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` — triggers `Water Leak Alert` automation
- 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 entity
- `binary_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 v300` while Garage Smart Lock shows `sw v31` — different firmware tracks (U100 has multiple hardware revisions).

## Last Updated

2026-06-24