小米开源智能家居平台 ha_xiaomi_home 使用示例

程序笔记 2024年12月21日09:07

小米近期在 GitHub 上开源了名为“ha_xiaomi_home”的项目，即 Home Assistant 米家集成组件。该组件由小米官方支持，旨在让用户在 Home Assistant 中集成和控制小米 IoT 智能设备。

主要特点：

官方支持：由小米官方开发和维护，提供更安全、稳定的设备控制与管理方案。多账号与多地区支持：允许多个小米账号同时登录，管理来自不同地区的米家设备。云端与本地控制：支持通过小米中枢网关实现本地控制，提升设备响应速度和稳定性。多语言支持：提供简体中文、繁体中文、英文等多种语言，满足全球用户需求。

安装要求：

Home Assistant Core：版本需 ≥ 2024.11.0。

Home Assistant 操作系统：版本需 ≥ 13.0。

安装方法：

使用 Git 克隆：在 Home Assistant 的配置目录中执行以下命令：

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

通过 HACS：在 HACS 中添加自定义仓库，URL 为 https://github.com/XiaoMi/ha_xiaomi_home.git，类别选择“Integration”。

手动安装：下载并将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 目录下。

配置步骤：

登录：在 Home Assistant 中，依次进入“设置” > “设备与服务” > “添加集成”，搜索并选择“Xiaomi Home”，然后使用小米账号登录。添加设备：登录成功后，选择需要添加的米家家庭，相关设备将自动导入。多账号支持：可在集成页面中继续添加其他小米账号，管理不同账号的设备。修改配置：在集成设置中，可更新设备列表、修改用户昵称等。

注意事项：

安全性：米家集成使用 OAuth 2.0 登录方式，不会在 Home Assistant 中保存您的小米账号密码。但登录成功后，您的小米用户信息（包括设备信息、证书、token 等）会明文保存在 Home Assistant 的配置文件中。请妥善保管这些配置文件，防止信息泄露。

设备支持范围：目前支持大部分米家设备，但蓝牙、红外及虚拟设备可能不在支持范围内。

本地控制：需要小米中枢网关（固件版本 3.4.0_000 以上）或内置中枢网关（软件版本 0.8.0 以上）的设备支持。

开源地址：

您可以在 GitHub 上查看该项目的详细信息和源码： https://github.com/XiaoMi/ha_xiaomi_home

通过该集成，用户可以在 Home Assistant 中更灵活地使用小米 IoT 智能设备，实现更丰富的智能家居自动化场景。