【保姆级教程】UIOT官方插件无痛接入HA，智能联动不是梦！

今天给大家带来一篇超级干货！很多值友家里可能已经用上了UIOT（欧瑞博）的全屋智能，体验确实不错，APP操作也简单。但玩着玩着，你是不是也跟我一样，有了更高的追求？

• “我想让小米的门窗传感器，联动UIOT的窗帘！”

• “我想让家里的网络波动时，智能家居依然稳如老狗！”

• “我想要更极致的自动化，所有设备都由我本地的‘大脑’统一指挥，而不是依赖云端！”

如果你有以上任何一个想法，那么恭喜你，这篇文章就是为你量身定做的！今天，我们就来把UIOT这个“正规军”请进Home Assistant（简称HA）这个“开源神器”里，实现真正意义上的本地化、高阶智能家居！

话不多说，发车！

一、准备工作：你需要什么？

1. 一套正在运行的UIOT智能家居系统：你得有个正常可用的UIOT主机，并且账号下已经添加了设备。

2. 一个正常运行的Home Assistant环境：无论是用虚拟机、Docker还是树莓派安装的都可以。

3. HACS (Home Assistant Community Store)：强烈建议安装HACS，这是HA的“应用商店”，后续安装集成会方便一万倍。UIOT的集成官方推荐使用HACS安装。

但为了大大降低入门门槛，这里更推荐使用由 Smart Home Fans 团队出品的“智趣盒子普惠版”。该盒子已为您预装好 Home Assistant (HAOS) 操作系统，并集成了包含了本次需要用到的UIOT插件还有小米官方插件、美的插件等在内的多种实用工具。您几乎无需进行复杂的配置，只需插上电源，按照配套的说明进行简单设置即可开始使用。

目前官方搞活动，他们是硬件工厂原价直出，168元的价格可以PK目前平台上258-358元的性能，性价比极高，同时还提供免费的技术指引。

智趣盒子购买链接：

https://item.taobao.com/item.htm?id=934944608705

二、安装UIOT Home集成：两大战法，任君选择

官方提供了两种安装方式，我们首推HACS方式，简单无脑。

战法一：HACS商店安装（强烈推荐）

这个方法就像在手机应用商店里装APP一样简单。

首先确保你已经给HA装好了HACS--智趣盒子已经预装，直接使用即可。

然后，在HA侧边栏进入HACS，点击右上角的三个点，选择 [自定义存储库/Custom repositories]。

1. 在弹出的窗口中，输入以下信息：

   • 存储库地址：https://github.com/uiotlink/ha_uiot_home

   • 类别：选择 [集成 (Integration)]

   点击“添加”按钮。

2. 添加后，在HACS的集成页面搜索“Uiot Home”，找到它，点击下载。

3. 下载完成后，务必重启Home Assistant！ 这一步非常关键，重启大法好！

战法二：手动安装（高手或HACS网络不佳时使用）

如果你的网络环境访问GitHub有困难，或者就是喜欢“自己动手”的快感，可以选择手动安装。

1. 从UIOT官方GitHub的 Latest Release页面 下载最新的uiot_home.zip文件。

2. 解压下载的文件，你会得到一个名为uiot_home的文件夹。

3. 将整个uiot_home文件夹，上传到你HA配置文件夹下的custom_components目录中。 (如果custom_components目录不存在，就自己新建一个)

4. 再次强调：重启Home Assistant！

三、配置集成：把你的UIOT设备“认领”回家

安装完成并重启后，我们就可以开始配置了。

1. 在HA中，进入 [设置] > [设备与服务]。

2. 点击右下角的 [添加集成] 按钮，搜索“Uiot Home”，然后点击它。

3. 接下来会弹出一个窗口，提示“UIOT账号”，请点击“下一步”。

4. 在登录界面，输入你的UIOT账号和密码。 注意：这个账号下必须已经添加了正常可用的UIOT主机。

5. 登录成功后，神奇的事情发生了！集成会自动列出你账号下所有的“家”，选择你要绑定的那个“家”。

6. 点击“提交”，稍等片刻，UIOT集成就会自动把你家里所有支持的设备同步到Home Assistant中！大功告成！

四、成果展示：看看你的新玩具！

完成配置后，你就可以在“设备与服务”中看到所有来自UIOT的设备和实体了。

灯光、开关、窗帘、各种传感器……应有尽有！

官方支持的设备非常全，这里简单列举一些：

• 开关面板：零火单开、双开、三开、四开等。

• 灯光控制：智能灯带、色温灯、调光控制器、智能筒射灯等，亮度、色温、颜色都能调！

• 窗帘电机：普通窗帘、卷帘、梦幻帘等，不仅能开关暂停，还能精确控制开合度！

• 各类传感器：

  • 门窗传感器（看开合状态、电量）

  • 红外、AI超级传感器（看光照、有没有人）

  • 温湿度传感器

  • 各种多合一空气盒子（PM2.5, CO2, 甲醛, TVOC, 噪音，要啥有啥）

• 暖通空调：各种三合一温控器、中央空调网关、地暖面板等，模式、温度、风速尽在掌握。

• 场景同步：你在UIOT APP里设置的场景，也能同步到HA里一键触发！

现在，你可以开始发挥想象力，创建各种强大的自动化场景了。比如：

• 用一个非UIOT品牌的温湿度传感器，当温度高于28度时，自动打开UIOT的空调。

• 根据HA里的日出日落信息，自动打开或关闭UIOT的窗帘。

• 当AI超级传感器检测到“无人”状态超过30分钟，自动关闭全屋的UIOT灯光和开关。

这一切，都在你的本地HA主机上完成，响应飞快，再也不用担心云端服务器抽风啦！

五、常见问题解答 (FAQ)

官方也贴心地准备了常见问题，我这里搬运一下，方便大家排查：

• Q1: 4.0账号登录提示获取token失败？

  • A: 这个问题通常是因为你用同一个手机号注册了4.0（UIOT智能家居App）和5.0（超级智慧家App）的账号。你需要登录“超级智慧家App”去注销5.0版本的账号。

• Q2: 选择家的界面不显示主机名称，提交后提示"Unkown error occurred"？

  • A: 检查一下你的UIOT App里，在“关于”页面，是否给你的主机服务器设置了一个别名。如果没有，需要去设置一个，然后再回来重新登录提交。

总结

总的来说，UIOT官方推出的这款Home Assistant集成，绝对是广大UIOT用户和HA玩家的福音。它打通了官方生态和开源社区之间的壁垒，让你花一份硬件的钱，享受到两种系统的乐趣和优势。

通过这篇教程，你可以轻松地将UIOT设备无缝接入Home Assistant，实现更稳定、更快速、更个性化的本地智能控制。摆脱云端束缚，让你的智能家居真正为你所有、由你掌控！

还在等什么？赶紧动手试试吧！如果你觉得这篇文章对你有帮助，别忘了点赞、收藏、评论三连哦！