Home Assistant Tapo集成

这是一个自定义集成,用于从Home Assistant控制Tapo设备。

该集成的核心由plugp100 Python库提供,该库基于@K4CZP3R的工作。

请帮助我完成新的路线图

赞助商

金牌赞助商

银牌赞助商

警告

Tapo协议

Tapo正在用一种名为KLAP的新协议更新其设备固件。此集成支持该协议,但如果您运行的是旧版本,您的设备可能无法工作。请使用HACS保持此集成的最新状态!

本地集成

尽管该集成可以在局域网中工作,但Tapo设备需要互联网访问以与Tapo云同步,特别是凭据,缺少互联网访问可能会导致"无效认证错误"。必须为设备设置静态IP。

认证

由于某些未知原因,包含大写字母的电子邮件会引发"无效认证"错误。在开启新问题之前,请检查Tapo应用程序设置中的电子邮件地址。如果您的电子邮件包含大写字母,该集成将无法工作。我已经开启了一个解释这一问题的issue #122,我将尽快修复。作为临时解决方案,您可以创建一个新账户,使用全小写字母的电子邮件地址。

功能

发现

该集成现在支持原生Tapo设备发现!要启用它,您必须至少添加一个Tapo设备或在Tapo配置文件中添加以下行:

tapo:
  discovery: true # 您可以省略"discovery",默认情况下使用"tapo:"将自动启用发现。

这将启用Tapo设备发现。并非所有Tapo设备都支持Tapo发现,因此如果找不到设备,请尝试手动添加。 Tapo集成发现会过滤掉不受支持的设备!

截图

您可以通过以下方式编辑configuration.yaml来禁用集成发现:

tapo:
  discovery: false

设备IP跟踪

使用DHCP Home Assistant发现时,MAC地址跟踪功能现在被禁用,因为HA现在可以自动跟踪MAC地址。请确保在configuration.yaml中启用DHCP发现(默认启用)。

[重大变更] MAC地址跟踪功能现已禁用,因为HA不推荐使用。现在由HA自身执行跟踪。

支持的设备

其他功能

手动更改IP地址。现在您可以更改Tapo设备的IP地址,而无需删除并重新添加它。
诊断设置
固件更新控制

如何安装

此集成是HACS商店的一部分,因此您不再需要将此存储库添加为自定义存储库。您可以直接在HACS商店中找到它:搜索tapo,您会找到Tapo Controller。(需要HACS >= 1.6.0)

这个视频展示了安装步骤:

如何添加Tapo设备（在安装集成后）

使用用户界面

确保集成已成功安装
进入集成菜单
搜索"Tapo"集成
输入主机（IP地址）、用户名和密码以控制您的Tapo设备（与Tapo应用程序使用的相同）。如果在此阶段遇到问题，比如"无效认证"错误，请查看#122，如果错误仍然存在，请在同一问题下留言
等待连接。集成将自动识别Tapo设备是开关、灯具还是其他设备 :)