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

丁慧湘Gwynne

于 2025-04-19 10:26:46 发布

阅读量394

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00402/article/details/147346427

版权

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

home-assistant-tplink-router Home Assistant component for TP-Link router administration with sensors, button reboot, switches and device tracking. 项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-tplink-router

1. 项目介绍

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

2. 项目快速启动

安装

使用HACS安装

确保你的Home Assistant已经安装了HACS。
打开HACS，搜索"TP-Link Router"。
点击安装。

手动安装

在Home Assistant的配置目录下找到或创建custom_components目录。
将custom_components/tplink_router目录复制到custom_components目录中。
重启Home Assistant。

配置

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

注意： 如果使用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。