Skip to content
Home Assistant TestFlight
Xiaomi

Xiaomi Gateway (Aqara)

xiaomi_aqara

Built inLocal push

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.

EntityShows up asNote
lightLight
switchSwitch or outlet
coverBlind, garage door, window or door
lockLockNeeds its own HomeKit Bridge in accessory mode
binary_sensorSensor (carbon monoxide, contact, leak, motion, smoke)
sensorSensor (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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Xiaomi Aqara temperature sensorWorksBroken in Home
Blocked HomeKit setup until friendly_name was changed to a string
Workaround: set a string friendly_name
Saved copy
home-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 SensorWorks LocalSupport added
Saved copy
Description: 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 WXKG02LMWorks Localdouble_both click type added
Saved 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 sensorsNot working LocalBroken in Home
Sensors duplicated and show No Response in Home app
Work in HA; appear twice and unresponsive in HomeKit since 0.73
Saved 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.acn004Won’t be supportedNot in supported gateway list; child sensors worked via xiaomi_miio
Saved 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 ControllerWon’t be supported LocalSub-device unsupported by gateway firmware at time of report
Saved 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 inHome Assistant 0.50
Set up in the UIYes
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.