如何快速接入小米智能家居设备到Home Assistant：从安装到设备兼容全指南

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

Xiaomi Home Integration是小米官方支持的Home Assistant集成组件，它让你能够在Home Assistant中使用小米IoT智能设备，实现智能家居平台的无缝对接。无论是通过云端控制还是本地网络管理，本指南将帮助你快速完成从安装到设备兼容的全过程。

准备工作：Home Assistant环境要求

在开始集成小米智能家居前，请确保你的Home Assistant环境满足以下要求：

• Core版本 ≥ 2024.4.4
• 操作系统版本 ≥ 13.0

这些版本要求确保你能获得最佳的兼容性和最新功能支持。如果你的版本较低，建议先升级Home Assistant核心系统。

三种安装方法，总有一款适合你

方法1：Git克隆安装（推荐）

这种方法便于版本控制和更新，适合有一定技术基础的用户：

cd config
git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

如需更新到特定版本（例如v1.0.0），只需执行：

cd config/ha_xiaomi_home
git fetch
git checkout v1.0.0
./install.sh /config

方法2：HACS一键安装

对于希望简化安装流程的用户，HACS提供了便捷的一键安装：

1. 打开HACS
2. 在搜索框中输入"Xiaomi Home"
3. 点击"Xiaomi Home"进入详情页
4. 点击"下载"按钮完成安装

方法3：手动安装

如果你偏好手动操作，可以通过Samba或FTPS将文件复制到Home Assistant：

1. 下载custom_components/xiaomi_home文件夹
2. 将其复制到Home Assistant的config/custom_components目录下

简单几步完成配置

登录小米账号

1. 进入Home Assistant设置 > 设备与服务 > 添加集成
2. 搜索"Xiaomi Home"并点击下一步
3. 点击登录链接，使用小米账号登录

添加MIoT设备

成功登录后，会弹出"选择家庭和设备"对话框，你可以选择要导入到Home Assistant中的设备所在家庭。

多用户登录设置

完成一个小米账号的登录配置后，你可以继续添加其他小米账号：

1. 进入设置 > 设备与服务 > 已配置 > Xiaomi Home
2. 点击"添加中心" > 下一步
3. 点击登录链接，使用其他小米账号登录

更新配置选项

你可以在"配置选项"对话框中更改配置，包括更新用户昵称和从小米家庭APP导入的设备列表等：

1. 进入设置 > 设备与服务 > 已配置 > Xiaomi Home
2. 点击"配置"
3. 选择要更新的选项

两种控制方式：云端与本地

云端控制架构

小米智能家居集成通过MIoT Cloud中的MQTT Broker订阅感兴趣的设备消息。当设备属性变化或发生事件时，设备会向MIoT Cloud发送上游消息，MQTT Broker将订阅的设备消息推送到Xiaomi Home Integration。

图：小米智能家居云端控制架构示意图，展示了设备如何通过MIoT Cloud与Home Assistant通信

控制命令通过MIoT Cloud的HTTP接口发送到设备，设备在收到MIoT Cloud转发的下游消息后做出反应并响应。

本地控制架构

本地模式需要小米中枢网关（固件版本3.3.0_0023及以上）或内置中枢网关功能的小米智能设备（软件版本0.8.9及以上）。

图：小米智能家居本地控制架构示意图，展示了设备如何通过小米中枢网关在本地网络中与Home Assistant通信

小米中枢网关包含标准MQTT Broker，实现完整的发布-订阅机制。Xiaomi Home Integration通过小米中枢网关订阅设备消息，控制命令直接发布到本地MQTT Broker，由网关转发给设备。

设备兼容性详解

支持的设备类型

Xiaomi Home Integration目前支持大多数类别的智能设备，但以下几类暂不支持：

• 蓝牙设备
• 红外设备
• 虚拟设备

地域可用性

小米智能家居集成可在以下地区使用：中国大陆、欧洲、印度、俄罗斯、新加坡和美国。由于不同地区小米云的用户数据是隔离的，在配置过程中导入MIoT设备时需要选择你的地区。

本地模式限制

• 小米中枢网关仅在中国大陆地区可用
• 小米LAN控制功能可控制与Home Assistant在同一局域网内的IP设备（通过WiFi或以太网连接的设备）
• LAN控制功能不能控制BLE Mesh、ZigBee等设备
• 如果Home Assistant所在局域网中有中枢网关，即使启用了LAN控制功能，它也不会生效

常见问题解答

Q: 小米智能家居集成是否支持所有小米智能设备？
A: 目前支持大多数类别，但蓝牙设备、红外设备和虚拟设备暂不支持。

Q: 是否支持多个小米账号？
A: 是的，支持多个小米账号，不同账号的设备可以添加到同一区域。

Q: 本地模式和云端模式有什么区别？
A: 本地模式通过小米中枢网关在本地网络中通信，响应速度更快且不依赖互联网；云端模式通过小米云服务通信，需要互联网连接。

Q: 如何更新实体转换规则？
A: 如果你编辑了custom_components/xiaomi_home/miot/specs目录中的任何文件，需要在集成的配置页面更新实体转换规则：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 更新实体转换规则

通过本指南，你已经了解了如何将小米智能家居设备快速接入Home Assistant，包括安装方法、配置步骤、控制方式和设备兼容性等关键信息。现在，你可以开始打造属于自己的智能家庭系统了！

【免费下载链接】ha_xiaomi_home Xiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home