昨天(12 月 16 日)消息,小米日前在 GitHub 发布了 Home Assistant 米家集成项目,这是一个由小米官方提供支持的 Home Assistant1 的集成组件,它可以让用户在 Home Assistant 中使用小米 IoT 智能设备。
项目简介
米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件,如本文标题的意思一样,它可以让您在 Home Assistant 中使用小米 IoT 智能设备。
安装
core ≥ 2024.11.0
OS ≥ 13.0
- 方法 1:使用 git clone 命令从 GitHub 下载
cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config
- 方法 2:HACS商店
米家集成暂未添加到 HACS 商店,所以只能等待米家集成上架
- 方法 3:通过 Samba 或 FTPS 手动安装
下载并将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 文件夹下。
配置
登录
设置 > 设备与服务 > 添加集成 > 搜索“Xiaomi Home” > 下一步 > 请点击此处进行登录 > 使用小米账号登录
添加 MIoT 设备
登录成功后,当弹出会话框“选择家庭与设备”,可以选择需要添加的米家家庭,该家庭内的所有设备将导入 Home Assistant 。
多账号登录
设置 > 设备与服务 > 已配置 > Xiaomi Home > 添加中枢 > 下一步 > 请点击此处进行登录 > 使用小米账号登录
修改配置项
设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 选择需要变更的配置项
Action 调试模式
设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > Action 调试模式
安全性
由于米家集成依赖小米官方云端接口,通过小米账号获取设备信息。采用 OAuth 2.0 安全登录,不存储密码。但又因 Home Assistant 限制,登录信息将以 明文形式 存于配置文件。用户须妥善保管此文件,以防身份被盗用。
小米局域网控制功能不受地区限制,在全球范围内均可用。如果 Home Assistant 所在的局域网内存在中枢网关,那么即便米家集成开启了小米局域网控制功能,该功能也不会生效。米家集成所用的云服务接口已部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区的机房。由于用户数据在不同地区的小米云上相互隔离,您需要在配置 Home Assistant 时选择用户所在地区,才能导入相应的米家设备。米家集成支持将不同地区的米家设备添加至同一个 Home Assistant 区域。
多语言支持
简体中文、繁体中文、英文、西班牙语、俄语、法语、德语、日语等八种语言
- Home Assistant 是一个基于 Python 3 开发的开源家庭自动化平台,可以跟踪和控制家庭中的所有设备,并实现自动化控制。 ↩︎