小米智能家居设备接入 HomeAssistant 配置指南
hass-xiaomi-miot 是目前较强大的小米设备集成方案，支持通过 miot-spec 自动识别并接入小米生态链设备，涵盖 Wi-Fi、BLE、ZigBee 等类型。
准备工作
在开始安装之前，请确保满足以下条件：
- HomeAssistant 已正常运行
- HACS 已安装完成（如未安装请先配置）
- 小米设备已联网并正常工作
安装教程
第一步：通过 HACS 添加集成
- 打开 HomeAssistant 侧边栏找到 HACS
- 点击'集成'选项
- 点击右上角的"+"按钮
- 搜索"Xiaomi Miot Auto"
- 点击'下载此存储库'
HACS 会自动处理依赖关系，等待下载完成即可。
第二步：重启 HomeAssistant
下载完成后，系统会提示需要重启 HomeAssistant。点击重启按钮，等待系统重新启动。
第三步：添加设备集成
重启完成后，按以下步骤操作：
- 进入'配置' → '设备与服务' → '集成'
- 点击'添加集成'按钮
- 搜索"Xiaomi Miot Auto"
- 选择添加方式：
- 小米账号集成：输入小米账号密码，自动发现所有设备
- 设备直连：输入设备 IP 和 token（适合局域网设备）
不同安装方法对比
| 安装方式 | 优点 | 缺点 | 推荐指数 |
|---|---|---|---|
| HACS 安装 | 一键安装、自动更新、图形界面 | 需要先安装 HACS | ⭐⭐⭐⭐⭐ |
| 手动安装 | 不需要额外工具 | 操作复杂、更新麻烦 | ⭐⭐⭐ |
| 命令行安装 | 适合熟悉命令行的用户 | 对新手不友好 | ⭐⭐ |
常见问题解答
Q: 为什么我的设备没有显示？
A: 请检查设备是否在线，如果是小米账号集成，确保账号密码正确。
Q: 如何获取设备的 token？
A: 可以使用米家 APP 的开发者模式或者相关工具获取。
Q: 插件支持哪些小米设备？
A: 支持几乎所有小米生态链设备，包括 Wi-Fi、蓝牙、ZigBee 等不同类型的设备。
Q: 更新插件需要注意什么？
A: 通过 HACS 更新时，记得重启 HomeAssistant 使更新生效。
使用技巧
- 批量控制：可以创建场景，同时控制多个设备
- 自动化设置：结合 HomeAssistant 的自动化功能，实现智能联动
- 状态监控：实时查看设备状态，及时发现异常
总结
通过 hass-xiaomi-miot 插件，可以轻松接入所有小米智能设备，实现跨品牌设备联动，享受更智能的家居体验。整个安装过程简单快捷，即使是智能家居新手也能快速完成。
