Xiaomi Gateway (Aqara)
xiaomi_aqara
The Xiaomi Sensor integration allows you to get data from your Xiaomi sensors.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
cover | Blind, garage door, window or door | |
lock | Lock | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (carbon monoxide, contact, leak, motion, smoke) | |
sensor | Sensor (air quality, humidity, light level, temperature) |
2 reports below say how a device from this integration behaves in the Home app.
What people report
Local-push Aqara gateway integration supports many older Xiaomi Zigbee sensors. Newer gateways such as lumi.gateway.acn004 are not supported here.
- Works3
- Not working1
- Won’t be supported2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Xiaomi Aqara temperature sensor | Works | Broken in Home Blocked HomeKit setup until friendly_name was changed to a string | Workaround: set a string friendly_nameSaved copyhome-assistant.log Here is the log. As far as I can tell, it's getting stuck on Xiaomi Aqara temp sensors. Excerpt saved from GitHub on 2026-10-23. | Issue #13457 · 2018-03 |
| Xiaomi Vibration Sensor | Works Local | Support addedSaved copyDescription: Adds support for Xiaomi Vibration Sensor ## Example entry for `configuration.yaml` (if applicable): [code] ## Checklist: - [x] The code change is tested and works locally. - [x] Local tests pass with `tox`. Your PR cannot be merged unless tests pass If user exposed functionality or configuration variables are added/changed: - [x] Documentation added/updated in home-assistant.github.io If the code communicates with devices, web services, or third-party tools: - [x] New dependencies have been added to the `REQUIREMENTS` variable ([example][ex-requir]). - Excerpt saved from GitHub on 2026-10-23. | PR #16422 · 2018-09 | |
| Xiaomi Wireless Wall Switch WXKG02LM | Works Local | double_both click type addedSaved copy…aomi aqara Wireless Wall Switch (remote.b286acn01) ## Description: The binary_sensor component for xiaomi_qara does not support a click_type `double_both` for WXKG02LM, model b286acn01. This pull request will add the `double_both`. Not sure how to prepare this pull request (first time for me within this project). Related issue (if applicable): https://community.home-assistant.io/t/no-xiaomi-aqara-wireless-switch-long-click-both-double-click-and-both-long-click-support/86746/2 Pull request in home-assistant.io with documentation (if applicable): home-assistant/home-assistant.io#7952 ## … Excerpt saved from GitHub on 2026-10-23. | PR #19578 · 2018-12 | |
| Xiaomi Aqara sensors | Not working Local | Broken in Home Sensors duplicated and show No Response in Home app | Work in HA; appear twice and unresponsive in HomeKit since 0.73Saved copy… known): 0.72 (thanks @semjef) Operating environment (Hass.io/Docker/Windows/etc.): Hassbian Component/platform: https://www.home-assistant.io/components/xiaomi_aqara/ https://www.home-assistant.io/components/homekit/ Description of problem: The connection to the gateway/sensors are stable but after 1-2 days (since 2 weeks or so) the sensors are twice in Apple HomeKit. One of them is still with the custom name/type and doesn't work. The newly added ones doesn't work either and have the "No Response"-tag.. No change after restart. But in Home Assistant the sensors are working perfectly fine … Excerpt saved from GitHub on 2026-10-23. | Issue #15518 · 2018-07 |
| Aqara gateway lumi.gateway.acn004 | Won’t be supported | Not in supported gateway list; child sensors worked via xiaomi_miioSaved copy… Bridged network in the VM, I’m full access to all devices to my Firewall (which monitors traffic and non-has been blocked). I initially configured the aqara hub and sensors in the aqara app, but realized it did not have integration with Home Assistant so added it as a bridge through home controller integration. However, I quickly realized I would not get the functionality I need this way and that I would need to use xiaomi Mi app installation to get what I need. This includes luminance information needed for automation. More importantly even, without the proper integration, my goal of using … Excerpt saved from GitHub on 2026-10-23. | Issue #94567 · 2023-06 | |
| Lumi Air Condition Controller | Won’t be supported Local | Sub-device unsupported by gateway firmware at time of reportSaved copy… device is here "http://docs.opencloud.aqara.com/en/development/gateway-LAN-communication/#thermostat" so, pls make these device models : ctrl_hvac.aq1/airrtc.tcpecn01 available, i just need the basic control such as on/off and status monitor. thanks!!! Problem-relevant `configuration.yaml` entries and (fill out even if it seems unimportant): [code] Traceback (if applicable): [code] Additional information: Excerpt saved from GitHub on 2026-10-23. | Issue #24276 · 2019-06 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 2,473 (0.35%) |
|---|---|
| Added in | Home Assistant 0.50 |
| Set up in the UI | Yes |
| Maintainers | @danielhiversen, @syssi |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.