小米官方出品:小米智能设备接入Home Assistant

2024-12-17
小米智能
Home Assistant

家里智能设备一直用 Home Assistant 来管理,用第三方插件把小米设备接入了 ha,使用体检还不错,就是偶尔会掉下,不过至少比小米智能多模网关不要稳定太多(小米多模网关现在是设置的每隔 4 小时重启一下,不然经常离线)。

就在刚不久,小米官方出品了 ha 集成插件,虽然目前刚开始,但大多数设备都已经支持了

image.png

米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件,它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

安装方式好几种,选择合适自己的
集成组件,它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

安装

Home Assistant 版本要求:

  • Core \geq 2024.11.0
  • Operating System \geq 13.0

方法 1:使用 git clone 命令从 GitHub 下载

1cd config
2git clone https://github.com/XiaoMi/ha_xiaomi_home.git
3cd ha_xiaomi_home
4./install.sh /config

推荐使用此方法安装米家集成。当您想要更新至特定版本时,只需要切换至相应的 Tag 。

例如,更新米家集成版本至 v1.0.0

1cd config/ha_xiaomi_home
2git checkout v1.0.0
3./install.sh /config

方法 2: HACS

HACS > Overflow Menu > Custom repositories > Repository: https://github.com/XiaoMi/ha_xiaomi_home.git & Category: Integration > ADD

米家集成暂未添加到 HACS 商店,敬请期待。

方法 3:通过 SambaFTPS 手动安装

下载并将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 文件夹下。

重启 ha 后,就可以配置了

登录

设置 > 设备与服务 > 添加集成 > 搜索“Xiaomi Home” > 下一步 > 请点击此处进行登录 > 使用小米账号登录

image.png

image.png

image.png

image.png

添加 MIoT 设备

登录成功后,会弹出会话框“选择家庭与设备”。您可以选择需要添加的米家家庭,该家庭内的所有设备将导入 Home Assistant 。

安全性

米家集成及其使用的云端接口由小米官方提供。您需要使用小米账号登录以获取设备列表。米家集成使用 OAuth 2.0 的登录方式,不会在 Home Assistant 中保存您的小米账号密码。但由于 Home Assistant 平台的限制,登录成功后,您的小米用户信息(包括设备信息、证书、 token 等)会明文保存在 Home Assistant 的配置文件中。因此,您需要保管好自己 Home Assistant 配置文件。一旦该文件泄露,其他人可能会冒用您的身份登录。

当然,如果个别设备还未支持,可以以第三方插件作为补充,期待小米官方的这个 ha 插件越来越好用。

插件地址:https://github.com/XiaoMi/ha_xiaomi_home

关注 “AUTRE” 微信公众号,给我留言
Placeholder Image