当前位置：首页 > news >正文

如何快速实现小米智能家居与Home Assistant的无缝集成：从安装到控制的完整指南

news 2026/3/26 21:36:36

如何快速实现小米智能家居与Home Assistant的无缝集成：从安装到控制的完整指南

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

小米智能家居Home Assistant集成是由小米官方支持的Home Assistant组件，它让你能够在Home Assistant中使用小米IoT智能设备。本文将为你提供从安装到配置的详细步骤，帮助新手用户轻松实现小米智能家居设备的集中控制。

准备工作：Home Assistant版本要求

在开始集成前，请确保你的Home Assistant满足以下版本要求：

Core ≥ 2024.4.4
Operating System ≥ 13.0

三种安装方法，总有一种适合你

方法一：通过Git克隆安装（推荐）

这种方法便于后续版本更新，执行以下命令：

cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config

如需更新到特定版本（例如v1.0.0），可使用：

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

方法二：通过HACS安装

HACS提供一键安装功能：

打开HACS
在搜索框中输入"Xiaomi Home"
点击"Xiaomi Home"进入详情页
点击"下载"按钮

方法三：通过Samba/FTPS手动安装

下载项目文件
将custom_components/xiaomi_home文件夹复制到Home Assistant的config/custom_components目录下

简单几步完成配置

账号登录

进入Home Assistant界面，点击设置 > 设备与服务 > 添加集成
搜索"Xiaomi Home"并点击
点击"下一步"，然后点击登录链接
使用小米账号登录

添加MIoT设备

登录成功后，会弹出"选择家庭和设备"对话框。你可以选择要导入到Home Assistant中的设备所在的家庭。

多用户登录

完成一个小米账号的登录和配置后，你可以在已配置的小米Home集成页面继续添加其他小米账号：

进入设置 > 设备与服务 > 已配置 > Xiaomi Home
点击"添加中枢"
按照提示完成新账号的登录

更新配置

你可以在"配置选项"对话框中更改配置，包括更新用户昵称和从小米Home APP导入的设备列表等：

进入设置 > 设备与服务 > 已配置 > Xiaomi Home
点击"配置"
选择要更新的选项

了解小米智能家居的控制方式

小米智能家居与Home Assistant的集成支持两种控制方式：云控制和本地控制。

云控制方式

图：小米智能家居云控制架构

小米Home集成通过在MIoT Cloud的MQTT Broker上订阅感兴趣的设备消息。当设备属性变化或发生事件时，设备会向MIoT Cloud发送上行消息，MQTT Broker将订阅的设备消息推送给小米Home集成。这种消息订阅机制使得小米Home集成在完成集成配置时只需从云端查询一次所有设备的属性，对云端的访问压力很小。

小米Home集成通过MIoT Cloud的HTTP接口向设备发送命令消息来控制设备。设备在收到MIoT Cloud转发的下行消息后做出反应并响应。