Home Assistant TP-Link 路由器集成指南

1. 项目介绍

本项目是一个为Home Assistant开发的TP-Link和Mercusys路由器管理组件，基于TP-Link Router API。它提供了对路由器的管理功能，包括传感器、重启按钮、开关和设备追踪等。通过该组件，用户可以轻松地监控和管理家庭网络中的设备。

2. 项目快速启动

安装

使用HACS安装
  1. 确保你的Home Assistant已经安装了HACS。
  2. 打开HACS，搜索"TP-Link Router"。
  3. 点击安装。
手动安装
  1. 在Home Assistant的配置目录下找到或创建custom_components目录。
  2. 将custom_components/tplink_router目录复制到custom_components目录中。
  3. 重启Home Assistant。

配置

  1. 进入Home Assistant的设置，点击"设备和服务"。
  2. 点击"+"添加集成，搜索"TP-Link Router"。
  3. 填写密码并点击"提交"。

注意： 如果使用HTTPS连接到路由器，可能会遇到证书验证错误。此时，取消选中"验证SSL"。

3. 应用案例和最佳实践

事件通知

要接收新设备加入网络或设备上线/下线的通知，可以在configuration.yaml文件中添加以下内容：

automation:
  - alias: "新网络设备"
    trigger:
      platform: event
      event_type: tplink_router_new_device
    action:
      service: notify.mobile_app_<device_name>
      data:
        content: "新设备出现 {{ trigger.event.data.hostname }}，IP地址 {{ trigger.event.data.ip_address }}"

发送短信

对于支持发送短信的MR LTE路由器，可以在自动化中添加以下内容：

...
action:
  - service: tplink_router.send_sms
    data:
      number: "+1234567890"
      text: "Hello World"
      device: "pass_tplink_router_device_id_here"

注意： device字段需要替换为实际的路由器设备ID。

4. 典型生态项目

Home Assistant生态系统中还有许多其他与TP-Link Router组件协同工作的项目，例如：

  • Deco M4、Deco M5等Deco系列分布式WiFi系统。
  • TL-WA1201、TL-WA3001等TP-Link无线接入点。
  • 多种型号的Archer系列路由器。

通过集成这些设备，用户可以构建一个更加智能和高效的家庭网络管理系统。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考