小米官方出品:小米智能设备接入Home Assistant
家里智能设备一直用 Home Assistant 来管理,用第三方插件把小米设备接入了 ha,使用体检还不错,就是偶尔会掉下,不过至少比小米智能多模网关不要稳定太多(小米多模网关现在是设置的每隔 4 小时重启一下,不然经常离线)。
就在刚不久,小米官方出品了 ha 集成插件,虽然目前刚开始,但大多数设备都已经支持了
米家集成是一个由小米官方提供支持的 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:通过 Samba 或 FTPS 手动安装
下载并将 custom_components/xiaomi_home
文件夹复制到 Home Assistant 的 config/custom_components
文件夹下。
重启 ha 后,就可以配置了
登录
设置 > 设备与服务 > 添加集成 > 搜索“Xiaomi Home
” > 下一步 > 请点击此处进行登录 > 使用小米账号登录
添加 MIoT 设备
登录成功后,会弹出会话框“选择家庭与设备”。您可以选择需要添加的米家家庭,该家庭内的所有设备将导入 Home Assistant 。
安全性
米家集成及其使用的云端接口由小米官方提供。您需要使用小米账号登录以获取设备列表。米家集成使用 OAuth 2.0 的登录方式,不会在 Home Assistant 中保存您的小米账号密码。但由于 Home Assistant 平台的限制,登录成功后,您的小米用户信息(包括设备信息、证书、 token 等)会明文保存在 Home Assistant 的配置文件中。因此,您需要保管好自己 Home Assistant 配置文件。一旦该文件泄露,其他人可能会冒用您的身份登录。
当然,如果个别设备还未支持,可以以第三方插件作为补充,期待小米官方的这个 ha 插件越来越好用。