小米官方于2014年12月17日发布Home Assistant插件，地址为https://github.com/XiaoMi/ha_xiaomi_home，科技爱好者博客第一时间进行安装了小米官方Home Assistant插件，感觉官方的就是很不错，功能也很强大，并且后续可以支持本地化运行，推荐安装，并且我已经停用了之前的Xiaomi Miot Auto插件。

以下是配置过程：

Home Assistant 版本要求：

• 核心≥2024.11.0
• 操作系统≥13.0

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

我们推荐这种安装方法，因为在更新到xiaomi_home某个版本时可以方便地切换到标签。

例如，更新到版本 v1.0.0

cd config/ha_xiaomi_home
git checkout v1.0.0
./install.sh /config

HACS >菜单 > 自定义仓库 > 仓库：https://github.com/XiaoMi/ha_xiaomi_home.git &

类别：集成 > 添加

xiaomi_home尚未作为默认添加到 HACS 商店。即将推出。

下载 Home Assistant 中的文件夹并将其复制到文件夹。custom_components/xiaomi_homeconfig/custom_components

不好下载的可以从科技爱好者博客网站上下载小米插件：xiaomi_home

一、风险告知

1. 您的小米用户信息和设备信息将会存储在您的 Home Assistant 系统中，小米无法保证 Home Assistant 存储机制的安全性。您需要负责防止您的信息被窃取。
2. 此集成由开源社区维护，可能会出现稳定性问题或其它问题，使用此集成遇到相关问题时，您应当向开源社区寻求帮助，而不是联系小米客服。
3. 您需要有一定的技术能力来维护您的本地运行环境，此集成对新手用户来说并不友好。
4. 在使用此集成前，请仔细阅读README。
5. 为了用户能够稳定地使用集成，避免接口被滥用，此集成仅允许在 Home Assistant 中使用，详情请参考LICENSE。

二、基础配置

登录地区

选择小米账号所在的地区。您可以在 米家APP > 我的（位于底部菜单） > 更多设置 > 关于米家 中查看。

语言

选择设备及实体名称所用的语言。缺少翻译的部分语句将使用英文显示。

OAuth2 认证跳转地址

OAuth2 认证跳转地址为 http://homeassistant.local:8123，Home Assistant 需要与当前操作终端（例如，个人电脑）在同一局域网内，且操作终端能通过该地址访问 Home Assistant 首页，否则登录认证可能会失败。

注意事项

• 对于数百个及以上米家设备的用户，首次添加集成会耗费一些时间，请耐心等待。
• 如果 Home Assistant 运行在docker环境下，请确保docker网络模式为host，否则会导致本地控制功能异常。
• 集成本地控制功能存在一些依赖项，请仔细阅读README。

三、请点击此处进行登录

（登录成功后，将会自动跳转至下一页面）

 

四、使用小米账号登录Xiaomi Home (Home Assistant Integration)

五、选择家庭与设备

使用介绍

控制模式

• 自动：本地局域网内存在可用的小米中枢网关时， Home Assistant 会优先通过中枢网关发送设备控制指令，以实现本地化控制功能。本地局域网不存在中枢时，会尝试通过小米OT协议发送控制指令，以实现本地化控制功能。只有当上述本地化控制条件不满足时，设备控制指令才会通过云端发送。

• 云端：控制指令仅通过云端发送。

导入设备的家庭

集成将添加已选中家庭中的设备。

房间名同步模式

将设备从米家APP同步到 Home Assistant 时，设备在 Home Assistant 中所处区域的名称的命名方式将遵循以下规则。注意，设备同步过程不会改变米家APP中家庭和房间的设置。

• 不同步：设备不会被添加至任何区域。

• 其它选项：设备所添加到的区域以米家APP中的家庭或房间名称命名。

Action 调试模式

对于设备 MIoT-Spec-V2 定义的方法，在生成通知实体之外，还会生成一个文本输入框实体，您可以在调试时用它向设备发送控制指令。

隐藏非标准生成实体

隐藏名称以“*”开头的非标准 MIoT-Spec-V2 实例生成的实体。

六、成功!

已为“Xiaomi: 1****** [中国大陆]”创建了配置。

已发现以下设备:

七、添加完成

接下来可以愉快的玩耍了。