HomeAssistant添加小米官方集成
最低版本
- IC6P白金版/MIXN二代大主机，2025-08-08及以上的版本
- Home Assistant 2025.1.4及以上的版本
- 主机配置工具（点我下载）2025-08-08及以上的版本
- 购新主机请注明：对接米家，以免误发旧固件版本。
- 旧主机（内存 4g）支持寄回刷机，大主机 mixbox2 支持寄回刷机。其它设备此服务咨询销售进一步确认！
- 不支持远程更新固件。
米家配置
- 添加米家网关至米家APP
- 如果小爱音箱、小爱触屏音箱，则先添加至小爱音箱APP，开启蓝牙网关功能，则可以在同账号的米家APP中查看此网关。
- 在米家APP中，添加米家设备至米家网关或小爱音箱
添加米家官方集成
注：添加米家官方集成时，请确保局域网中没有其它Home Assistant主机（http://homeassistant.local:8123/）在运行，以免米家账户登录之后误跳转至http://homeassistant.local:8123/，导致主机内置HA无法接收到登录跳转。
- 如果内置HA未启动，可按如下步骤启动主机内置HA
- 使用最新版本的主机配置工具（点我下载），点击HA配置，即可启动HA。
- 如果内置HA已启动，可忽略此步骤
- 打开主机内置HA界面
- 使用chrome浏览器打开http://主机IP:8123
- 输入用户名
d-controls和密码dcs123456，登录成功
- 登录HA界面后，点击
配置=>设置与服务=>+添加集成=>搜索品牌=>Xiaomi Home（注：Xiaomi Home，不是Xiaomi，不要搞错了，参考示意图xiaomi_home_1.png） - 风险告知，勾选同意后，点击下一步
- 基础配置，保持默认，点击下一步。参考示意图xiaomi_home_2.png
- 点击
请点击此处进行登录，参考示意图xiaomi_home_3.png - 如果是首次登录小米账户，可选择用户名/密码登录，或米家APP扫码登录。登录成功后进入下一个界面。
- 此处，请确保局域网中没有其它Home Assistant主机（http://homeassistant.local:8123/）在运行，以免米家账户登录之后误跳转至http://homeassistant.local:8123/，导致主机内置HA无法接收到登录跳转。
- 可点击
Switch accounts切换账号，确认账户后，点击Agree and link，跳转到下一个界面。参考示意图xiaomi_home_4.png - 此处跳转后，会打开一个
无法访问此网站的页面，是正常现象。网页的当前地址的格式是http://homeassistant.local:8123/api/webhook/5023963226387839725?code=&state=。参考示意图xiaomi_home_5.png - 点击浏览器地址栏，将
homeassistant.local修改为主机的实际IP，例如10.0.0.24，地址的其余部分保持原样，按回车。参考示意图xiaomi_home_6.png - 界面跳转至HA添加集成的界面，参考示意图xiaomi_home_7.png。
- 在
导入设备的家庭中，选择需要导入的家庭，其他选项保持默认，点击下一步。显示成功！后，选择区域后，点击完成。 - 主机HA备份 - 打开主机配置工具，登录后点击`HA配置`，点击`HA备份` - 或打开3000配置网页，点击`手动备份数据库和HA` - 若此处未备份HA，切勿重启主机、重新导入EXCEL，否则将恢复至上一次备份的状态，且需要重新添加此集成
添加米家设备至主机
- 打开主机配置工具，登录主机。
- 点击
设备列表，右上角点击+，点击添加HA设备。 - 配置工具将自动搜索所有支持的HA设备，并弹出搜索结果
- 点击
更新设备，将搜索到的设备添加到设备列表。 设备列表右下角，导出EXCEL文件。此处，将自动触发一次主机HA备份。- 将EXCEL文件通过主机3000配置页面，导入到主机中，并使用APP测试相应的设备。