小米智能家居接入 Home Assistant 配置指南
想要将家中的小米智能设备无缝集成到 Home Assistant 智能家居平台吗？本文为您提供一套完整的小米设备集成解决方案，从基础安装到高级配置，手把手指导您实现跨品牌设备的统一管理。通过云端控制与本地控制双模式，您可以获得更稳定、更快速的设备控制体验。
小米设备集成前的准备工作
在开始集成前，请确保您已准备好以下条件：
- 运行 Home Assistant 的设备（版本≥2024.4.4）
- 小米智能设备（支持 Wi-Fi 或蓝牙连接）
- 有效的小米账号（用于云端设备认证）
- 本地网络访问权限（用于局域网设备发现）
小米设备集成的三种安装方式
HACS 一键安装方法
通过 Home Assistant 社区商店进行安装是最便捷的方式：
- 进入 HACS 界面
- 搜索"Xiaomi Home"集成
- 点击安装并重启 Home Assistant
- 在集成页面添加小米设备
Git 仓库克隆安装方法
如果您需要更灵活地管理版本，推荐使用此方法：
cd /config
git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config
手动文件复制安装方法
通过 Samba 或 FTPS 服务，将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 目录下。
小米设备控制模式深度解析
云端控制架构详解
云端控制模式通过小米云服务实现设备管理，其核心优势包括：
- 远程访问支持：无论身在何处都能控制家中设备
- 设备兼容性广：支持更多类型的小米设备
- 配置流程简单：适合初次使用的用户
该模式的核心配置文件位于：custom_components/xiaomi_home/miot/miot_cloud.py
本地控制架构详解
本地控制模式通过小米中枢网关实现局域网内直接通信，主要特点：
- 极速响应：指令在局域网内传输，延迟更低
- 隐私安全：数据不经过云端，保护用户隐私
- 网络独立：无需互联网连接即可控制设备
本地控制核心代码文件：custom_components/xiaomi_home/miot/miot_lan.py
小米设备配置流程逐步指导
小米账号登录与认证
在 Home Assistant 的设置界面中，依次选择"设备与服务" > "添加集成" > 搜索"Xiaomi Home" > 点击"小米账号登录"
设备发现与导入
登录成功后，系统会自动弹出"选择家庭与设备"对话框，您可以选择要导入到 Home Assistant 中的设备。
多账号管理配置
完成第一个小米账号配置后，您可以在已配置的小米 Home 集成页面继续添加其他小米账号，实现多账户设备统一管理。
支持的小米设备类型全览
该项目支持丰富的小米智能设备类型，涵盖：
- ：包括门窗传感器、人体传感器等
