Lighting

Xiaomi Home

XiaoMi/ha_xiaomi_home · vv0.5.0

HACSCloud polling

Xiaomi Home 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
`light`	Light
`switch`	Switch or outlet
`cover`	Blind, garage door, window or door
`climate`	Thermostat
`fan`	Fan
`humidifier`	Humidifier or dehumidifier
`media_player`	TV, receiver or media switches	Needs its own HomeKit Bridge in accessory mode
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`vacuum`	Vacuum (as a switch)
`water_heater`	Water heater (as a thermostat)
`button`	Button (as a switch)
`select`	Mode picker (as switches)
`device_tracker`	Presence (as an occupancy sensor)

3 reports below say how a device from this integration behaves in the Home app.

What people report

Official Xiaomi integration is cloud-based with optional LAN control that needs a central hub gateway. Offline operation, state reporting on older locks, and HomeKit mode mapping of air conditioners have caused complaints.

Works2
Partly works7
Not working2
Requested1

Device	In Home Assistant	In Apple Home	What they said	Source
iSleep electric blanket	Works		Added as climate entity Saved copy Add support for `electric-blanket` as `climate`. Tested with device `isleep.blanket.hs2401` Excerpt saved from GitHub on 2026-10-23.	PR #781 · 2025-02
Xiaomi electric toothbrush	Works		Brush head level sensor added Saved copy Device: 米家多向扫振电动牙刷 (xiaomi.toothbrush.p001) Add unit: `DAYS` Excerpt saved from GitHub on 2026-10-23.	PR #1588 · 2026-01
Loock Xiaomi Smart Lock Pro	Partly works Cloud	Works in Home Lock state works when added directly to Apple Home	Only reports closed, never open; HomeKit shows true state Saved copy loock.lock.t1pro 这个设备有点老了，未完全支持 MIoT-Spec-V2 协议。“门工作状态”属性（siid=5 piid=1）只上报 value=2 (close), 不上报 value=1 (open)，因此 xiaomi_home 只能显示 close ，无法显示 open 。并且，设备也不是立即上报 value=2 (close) ，实际 12:48:32 关门，而设备在 12:49:02 才上报 value=2 (close) ： [code] 12:48:03 开门、12:48:32关门，设备上报了相应的 profile 协议消息，米家 APP 可以显示对应的锁事件。xiaomi_home 不支持 profile 协议，因而无法处理这些消息： ``` 2025-11-06 12:48:03.559 DEBUG (6a0 Excerpt saved from GitHub on 2026-10-23.	Issue #1480 · 2025-10
Narwal vacuum	Partly works		Unsupported MIoT-Spec instances removed Saved copy … xiaomi.airer.pro3. In #1295, xiaomi_home does not subscribe the device upstream message topics of lumi.acpartner.mcn02. In these issues, users both import a Narwal vacuum which has a large number of MIoT-Spec-V2 readable properties. The request to get the latest property values of Narwal vacuum cost as long as 17 seconds and most of the property values are failed to fetch with the third party cloud error "property not supported". I suspect that thread blocking prevented the subscription operation. narwa.vacuum.001 only supports MIoT-Spec-V2 property of 2.2, 2.3, 2.17, 2.18, 2.71, 11.1 and … Excerpt saved from GitHub on 2026-10-23.	PR #1355 · 2025-08
Tofan WK01 thermostat	Partly works Cloud		Power state and target temperature not synced from cloud Saved copy Problem For thermostat devices (e.g. tofan-wk01 models) connected via `xiaomi_home` cloud integration: - ✅ Preset mode (制冷/制热/送风) syncs correctly - ✅ Fan mode syncs correctly - ❌ hvac_mode (on/off) never updates, stays stuck at `off` - ❌ target_temperature never updates ## Root Cause The `Thermostat` class relies solely on the MIoT `on` property (`thermostat` service → `Switch Status`, bool format) to determine `hvac_mode`. However, the Xiaomi Home cloud does not push `on` property changes for this thermostat model, the power state is likely encoded in other fields. ## Fix Two fallback … Excerpt saved from GitHub on 2026-10-23.	PR #1742 · 2026-06
Xiaomi air conditioner KFR-50GW/N2A1 and KFR-26GW/V1A1	Partly works Cloud	Partly in Home No fan or dehumidify mode, fan speed not adjustable	Fan speed and dry/fan modes missing in HomeKit Saved copy Describe the Bug / 描述问题小米空调桥接至HomeKit后功能缺失，缺少送风模式、除湿模式，且空调风速不可控。 ### How to Reproduce / 复现步骤 KFR-50GW/N2A1 风速调节送风和除湿模式 KFR-26GW/V1A1 风速调节 > PS: 「KFR-26GW/V1A1」这个型号在home assistant中有一个风速档位是null 送风和除湿模式 ### Expected Behavior / 预期结果 HomeKit中的空调支持调节风速以及送风和除湿模式 ### Reproduce Time / 问题复现的时间点 2026-05-24 20:38:51 ### Home Assistant Logs / 系统日志 _No response_ ### Log Timezone / 日志时区 Asia/Shanghai ### Home Assistant Core Version / Home Assistant Core 版本 2026.5.4 ### Home Assistant Operation System Version / Home Assistant Operation System 版本 17.3 ### Xiaomi Home Integration Version / 米家集成版本 v0.4.7 ### … Excerpt saved from GitHub on 2026-10-23.	Issue #1722 · 2026-05
Xiaomi air conditioner KFR35GW/N1A1	Partly works Cloud	Partly in Home Shows heat/cool as Heat/Cool thermostat modes, not cooling/heating	Works in Home Assistant; modes differ in HomeKit Saved copy 如题小米空调KFR35GW/N1A1 通过homekit brige 到apple homekit 后，模式不对，只有升温降温，而不是制冷制热，但是homeassistant 里面是好的，请问是我那边设置不对嘛？ Excerpt saved from GitHub on 2026-10-23.	Discussion #1457 · 2025-10
Xiaomi Smart Home Hub 2 (Aqara)	Partly works Cloud		Devices go offline when internet is lost despite LAN Saved copy Describe the Bug / 描述问题 Environment Gateway: Model: lumi.gateway.mgl001 (Xiaomi Smart Home Hub 2) Manufacturer: Aqara Firmware: 1.0.8_0007 Integration: Version: 0.4.2 Region: Europe LAN Control: Disabled Home Assistant: Version: 2025.9.4 Container, network: host Current Behavior When internet connection is lost (LAN still active), all devices connected through the integration show as offline in Home Assistant Questions Does lumi.gateway.mgl001 (Xiaomi Smart Home Hub 2) support local control? The documentation mentions "Xiaomi Central Hub Gateway" but doesn't clarify if this model qualifies. … Excerpt saved from GitHub on 2026-10-23.	Issue #1438 · 2025-09
Xiaomi Smart Plug 2	Partly works Local		On/off works locally but energy monitoring stops without internet Saved copy I just tested the cuco.plug.v2eur socket in local mode without internet using a third-party integration https://github.com/al-one/hass-xiaomi-miot I can state with absolute certainty and unequivocality that the energy monitoring system can operate locally, without internet access. Current energy consumption data is updated instantly, without any delays. I kindly ask you to please implement the ability to operate the energy monitoring function in local mode, without the need for an Internet connection. Moreover, after I reconnected to the internet, the … Excerpt saved from GitHub on 2026-10-23.	Issue #1482 · 2025-10
Huoman Smart Litter Box CS106	Not working Cloud		Skipped when cloud response lacks spec_type Saved copy Describe the Bug / 描述问题 A third-party cloud device, Huoman Smart Litter Box CS106 (`huoman.litter_box.cs106`), is visible and working normally in the Mi Home app, but it does not appear in the Xiaomi Home integration device-selection list in Home Assistant. This device had been imported into Home Assistant successfully before. With debug logging enabled, Xiaomi Home receives the device from the cloud, but logs `missing the urn\|model field` and skips it. The returned device data contains a valid `model`, but no `spec_type` / URN. ### How to Reproduce / 复现步骤 1. Add Huoman Smart Litter Box CS106 … Excerpt saved from GitHub on 2026-10-23.	Issue #1785 · 2026-08
Xiaomi kettle ym3pro and Dmaker fan p23 with hub1	Not working Cloud		Wi-Fi devices do not update locally without internet Saved copy Describe the Bug / 描述问题 I purchased the central gateway xiaomi.gateway.hub1 (firmware 3.4.0_0023) so that Wi-Fi-connected devices receive full support for local operating mode. I have 2 devices that can update their status using push messages, sending them to a central gateway over a local connection: 2026915567 - xiaomi.kettle.ym3pro 749276437 - dmaker.fan.p23 And these devices work fine in local mode, but only as long as the Internet is connected. Without the Internet, devices do not update their states if they are controlled using buttons on the device itself. From the logs, I noticed that … Excerpt saved from GitHub on 2026-10-23.	Issue #1586 · 2026-01
Xiaomi Robot Vacuum S40 Pro	Requested		Complete support proposed in open pull request Saved copy Based on https://home.miot-spec.com/spec/xiaomi.vacuum.ov71gl Actions example: [code] Excerpt saved from GitHub on 2026-10-23.	PR #1702 · 2026-04

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

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Found automatically over

Bonjour (zeroconf)

Details

Installs (analytics)	20,074 (2.83%)
GitHub stars	22,240
Latest version	v0.5.0 (2026-09-28)
Set up in the UI	Yes
Maintainers	@XiaoMi

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
caibinqing/ha_xiaomi_home	★ 3	2026-10-15	Xiaomi Home Integration for Home Assistant

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.

Sources

Documentation: https://github.com/XiaoMi/ha_xiaomi_home/blob/main/README.md
Source code: https://github.com/XiaoMi/ha_xiaomi_home
Issues: https://github.com/XiaoMi/ha_xiaomi_home/issues
HACS: https://hacs.xyz