小米智能家居集成Home Assistant教程
1. 项目介绍
小米智能家居集成Home Assistant项目是由小米官方支持的一个集成组件,它允许用户在Home Assistant中使用小米的物联网智能设备。通过这个集成,您可以轻松地将小米智能设备添加到Home Assistant中,实现统一的家居自动化控制。
2. 项目快速启动
在开始之前,请确保您的Home Assistant版本为2024.4.4或更高版本,操作系统版本为13.0或更高。
方法1:使用Git克隆
cd config
git clone https://github.com/XiaoMi/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中添加仓库:
- 打开HACS。
- 点击溢出菜单,选择“自定义仓库”。
- 输入仓库URL:
https://github.com/XiaoMi/ha_xiaomi_home.git
。 - 在类别或类型中选择“集成”,然后添加“小米家居”。
小米家居尚未添加到HACS商店中,但很快就会推出。
方法3:通过Samba/FTPS手动安装
下载custom_components/xiaomi_home
文件夹并将其复制到Home Assistant的config/custom_components
文件夹中。
3. 应用案例和最佳实践
登录配置
- 在Home Assistant的“设置”中,选择“设备和服务”。
- 点击“添加集成”,搜索“小米家居”。
- 按照提示登录小米账户。
添加设备
登录成功后,会弹出一个“选择家庭和设备”的对话框。您可以选择包含您想要导入到Home Assistant中的设备家庭。
多用户登录
完成小米账户登录和用户配置后,可以继续在配置的小米家居集成页面添加其他小米账户。
更新配置
在“配置选项”对话框中,您可以更新用户昵称和从小米家居APP导入的设备列表。
调试模式
激活调试模式后,您可以手动发送带有参数的Action命令消息给设备。
4. 典型生态项目
小米家居集成Home Assistant项目是小米智能家居生态中的一个重要组成部分,它与其他小米生态项目如小米中心网关、小米智能设备等紧密协作,为用户提供一个完整的智能家居解决方案。通过Home Assistant的集成,用户可以享受到更加灵活和强大的家居自动化体验。