Xiaomi Mi and Aqara Air Conditioning Companion
syssi/xiaomi_airconditioningcompanion · v2025.12.0.0
Xiaomi Mi and Aqara Air Conditioning Companion integration for Home Assistant
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 |
|---|---|---|
climate | Thermostat |
2 reports below say how a device from this integration behaves in the Home app.
What people report
Xiaomi/Aqara AC Partner works locally with some AC remotes but several users report only power-off working. Early HomeKit-via-HA reports show state sync and instant switch-off problems.
- Partly works2
- Not working2
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Aqara AC Partner v2 (lumi.acpartner.v2) | Partly works Local | Broken in Home Climate sends off signal right after any command; AC cannot be turned on | Works in HA, but turns off right after any command when exposed to HomeKitSaved copySuccessfully added my acpartner.v2 device to the homekit.app with homeassistant native homekit component but when operate the climate, it always send off signal right after any signal, so the ac can not be turned on homekit component log as below [code] Excerpt saved from GitHub on 2026-10-23. | Issue #35 · 2018-08 |
| Aqara AC Partner v2 (MW300, fw 1.4.1_153) | Partly works | Target temperature sensor ID is required even when sensor is only in Mijia/HomeKitSaved copy@syssi thanks for the reply. The model info is as follows: Model: lumi.acpartner.v2 Hardware version: MW300 Firmware version: 1.4.1_153 Excerpt saved from GitHub on 2026-10-23. | Issue #121 · 2021-01 | |
| Aqara AC Partner v3 (acpartner.v3) | Not working Local | Only turn-off works; Haier AC fine but Xiaomi AC does not respondSaved copy我也遇到此问题，只能关闭，不能进行其他操作。 The same problem here, only turn off, the other doesn't work. 1.型号：aqara空调伴侣升级版（应该是acpartner.v3） 1.Model: acpartner.v3, not sure. 2.我有两个空调，海尔的可以正常工作，小米的不能。 2.I used it control two AC and two companions. It works with haier AC but not can't work with xiaomi AC. 3.米家工作正常 3.It could be controled in Mi Home App, and also works in Xiaomi MIoT ( @https://github.com/ha0y/xiaomi_miot_raw) logs: 2021-07-09 22:27:05 DEBUG (SyncWorker_6) [miio.miioprotocol] 192.168.5.163:54321 >>: {'id': 13, 'method': 'send_cmd', 'params': ['010000798814301DA1']} 2021-07-09 22:27:06 DEBUG … Excerpt saved from GitHub on 2026-10-23. | Issue #127 · 2021-05 | |
| Xiaomi Mi AC Companion v3 | Not working | Broken in Home On state does not propagate to HomeKit | Device state (on) does not synchronize to HomeKitSaved copyAnother "homekit issue" for reference: https://github.com/syssi/xiaomi_airconditioningcompanion/issues/35 Excerpt saved from GitHub on 2026-10-23. | Issue #33 · 2018-08 |
| Aqara AC Partner LAN gateway function | Won’t be supported Local | Gateway sub-device protocol not usable; port 9898 behavior unclear on firmware 1.41Saved copyOne more issue that needs further digging, AC partner has Gateway function. Actually LAN mode can be turned on at the latest version of firmware (2.49.3). But unlike normal gateway, it seems follow new Aqara protocol and didn't open TCP/UDP port we know for communication with sub-devices. Without knowledge of protocol, we can't do anything now. Generally speaking, this issue should be assigned to `Pyxiaomigateway` repository. But if we do so then this device actually would be divided into 3 parts. One - gateway, two - climate, three - IR Remote. Even we followed this method, maybe use this … Excerpt saved from GitHub on 2026-10-23. | Issue #6 · 2018-02 |
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 polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 47 (0.01%) |
|---|---|
| GitHub stars | 410 |
| Latest version | 2025.12.0.0 (2026-10-01) |
| Set up in the UI | No, YAML |
| Maintainers | @syssi |
| License | Apache-2.0 |
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.
