Home Assistant Tapo集成

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

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

请帮助我完成新的路线图

赞助商

金牌赞助商

<!-- gold --><!-- gold -->

银牌赞助商

<!-- silver --><a href="https://github.com/jmd-au"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/81511cd6-258b-4f8c-85e0-fb04cbaf5649.png" width="60px" alt="James Mac" /></a><!-- silver -->

警告

Tapo协议

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

本地集成

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

认证

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

功能

发现

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

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

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

<details> <summary>截图</summary>

</details>

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

tapo:
  discovery: false

设备IP跟踪

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

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

支持的设备

• 纯异步Home Assistant方法
• 支持Tapo H100 集线器和警报器
• 对Tapo H200 集线器的支持目前正在进行中!
• 支持 T31x 温度和湿度传感器集线器设备
• 支持 T100 运动传感器集线器设备
• 支持 T110 智能门集线器设备
• 支持 S220、S210 开关集线器设备
• 部分支持 S200B 按钮集线器设备(实际上没有事件报告给HA)
• 支持Tapo电源插排(P300)。特别感谢@alxlk通过最高的一次性贡献支持我购买该设备
• 支持Tapo开关(P100, P110, P105, P115, P125, P110M)
• 支持有或无色彩的Tapo灯泡(L530, L510, L520, L630, L610, L530B, L530E)
• 支持有或无色彩的Tapo灯带(L900)
• 部分支持Tapo灯带(L920, L930 (包括灯光效果))。仅支持RGB,不支持灯带的可寻址功能。
• 支持能源监测(P110, P115, P110M)
• 支持有或无调光器的Tapo灯光开关(S500, S500d, S505d)
• 由@delatt提供的KE100支持
• 支持额外的Tapo传感器:overheat和wifi_signal
• 允许通过配置流从Home Assistant UI进行配置
• 允许从configuration.yaml进行配置。支持的域有switch、light、sensor

其他功能

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

如何安装

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

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

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

使用用户界面

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

通过configuration.yaml配置

[重大变更]

本集成的最新版本移除了通过configuration.yaml进行设备配置的支持。这是为了遵循Home Assistant的最佳实践 https://developers.home-assistant.io/docs/configuration_yaml_index/ 和 https://github.com/home-assistant/architecture/blob/master/adr/0010-integration-configuration.md#decision

Beta版本

要访问Beta版本，您必须将其作为自定义存储库安装

1. 从HACS安装，将此存储库添加为自定义存储库
2. 在HACS商店中搜索Tapo集成并安装
3. 建议完全重启Home Assistant

欢迎贡献！

欢迎提交拉取请求，我们欢迎任何形式的贡献。

---