米家设备轻松接入Home Assistant：智能家居控制全攻略

ha_xiaomi_home项目是小米官方为Home Assistant开发的米家设备集成组件，解决了用户在Home Assistant中统一管理和控制小米智能设备的核心痛点，让不同品牌的智能家居设备能够互联互通，打造更便捷的智能生活体验。

如何选择适合你的安装方式

Git命令行安装步骤

1. 打开终端，进入Home Assistant的config目录
2. 克隆项目仓库：git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
3. 进入项目目录：cd ha_xiaomi_home
4. 执行安装脚本：./install.sh /config ✅ 完成安装后，重启Home Assistant使组件生效

其他安装方案对比

安装方式	难度	适用人群	优势
Git命令行	中等	技术用户	便于版本管理和更新
HACS安装	简单	普通用户	操作直观，适合新手
手动文件复制	较复杂	进阶用户	可自定义文件内容

如何配置米家设备接入

初始配置指南

1. 在Home Assistant界面中，点击"设置" > "设备与服务" > "添加集成"
2. 搜索并选择"Xiaomi Home"集成
3. 使用OAuth 2.0方式登录小米账号
4. 选择需要接入的米家家庭和设备 ✅ 完成配置后，设备将自动显示在Home Assistant中

多账号管理方法

1. 在集成配置页面点击"添加账号"
2. 使用新的小米账号登录
3. 选择该账号下的家庭和设备
4. 重复以上步骤可添加多个账号 ✅ 所有账号下的设备将统一显示和管理

本地控制与云端控制有何区别

云端控制工作原理

云端控制就像通过中介来管理设备，所有指令都需要经过小米云服务器转发。

特点：

• 依赖互联网连接
• setup简单，无需额外设备
• 支持远程控制，出门在外也能操作

本地控制工作原理

本地控制则是设备与Home Assistant直接对话，不需要经过云端服务器。

特点：

• 不依赖互联网，断网也能控制
• 响应速度更快，操作更流畅
• 需要小米中枢网关支持

两种控制方式对比

对比项目	云端控制	本地控制
网络要求	需要互联网	仅需局域网
响应速度	中等	快速
稳定性	受网络影响	局域网内稳定
设备要求	无额外设备	需要小米中枢网关

如何提升设备接入成功率

网络环境优化

1. 确保Home Assistant与米家设备在同一局域网
2. 减少网络拥堵，避免多个设备同时连接
3. 网关设备尽量放置在信号良好的位置
4. 定期重启路由器和网关设备

设备准备工作

1. 确保设备已在米家APP中正常添加
2. 更新设备固件到最新版本
3. 确认设备支持MIoT协议（可在米家APP设备详情中查看）
4. 部分设备需要先在米家APP中开启"局域网控制"选项

常见故障排除步骤

设备无法发现怎么办

1. 检查设备是否已在米家APP中正常工作
2. 确认Home Assistant与设备在同一网络
3. 重启Home Assistant和设备
4. 尝试重新配置集成

控制指令无响应如何解决

1. 检查网络连接状态
2. 切换控制模式（云端/本地）
3. 检查设备是否在线
4. 重启设备和Home Assistant

⚠️ 安全提示：

• 定期检查应用授权情况
• 不要分享Home Assistant配置文件
• 发现异常活动及时撤销账号授权

不同型号网关适配指南

小米中枢网关

• 支持型号：MJSG01YL、MJSG02YL
• 固件要求：v3.4.0及以上
• 支持设备数量：最多300台
• 特色功能：本地自动化、断网可用

内置网关设备

• 支持型号：米家智能多模网关、米家空调伴侣2等
• 软件要求：v0.8.0及以上
• 支持设备数量：最多50台
• 特色功能：即插即用，无需额外配置

多品牌设备协同控制案例

场景一：回家模式

1. 小米门锁识别到主人回家
2. 自动打开客厅灯光（Yeelight智能灯）
3. 调整空调温度至26度（米家空调）
4. 拉开窗帘（绿米智能窗帘）

场景二：离家模式

1. 检测到手机离开家庭网络
2. 关闭所有灯光
3. 关闭空调和电视
4. 启动扫地机器人
5. 锁上智能门锁

数据备份与迁移方案

配置备份步骤

1. 进入Home Assistant配置目录
2. 找到.storage文件夹
3. 复制以下文件到安全位置：
   • core.config_entries（设备配置）
   • core.entity_registry（实体信息）
   • xiaomi_home相关文件 ✅ 建议定期备份，避免配置丢失

迁移到新系统

1. 在新系统安装ha_xiaomi_home组件
2. 将备份的配置文件复制到新系统对应目录
3. 重启Home Assistant
4. 检查设备状态，必要时重新加载集成

通过本指南，你已经掌握了将米家设备接入Home Assistant的全部要点。无论是选择合适的安装方式，还是优化控制体验，都能让你的智能家居系统更加智能、稳定。记得定期关注组件更新，获取更多新功能和设备支持。