TP-Link WiFi 智能插头客户端与Wireshark解码器指南

TP-Link WiFi 智能插头客户端与Wireshark解码器指南

tplink-smartplug TP-Link WiFi SmartPlug Client and Wireshark Dissector 项目地址: https://gitcode.com/gh_mirrors/tp/tplink-smartplug

1. 项目介绍

本项目提供了一个用于控制TP-Link HS100和HS110 WiFi智能插座的Python客户端，以及一个Wireshark解码器，专门用于解密TP-Link智能家居协议(TPLink Smart Home Protocol)包。该协议基于TCP端口9999运行，使用简单的异或自同步加密机制，并且不提供任何实质性的安全保护。通过JSON格式发送命令，无需身份验证，即可操作设备。

2. 项目快速启动

安装客户端

首先，您需要从GitHub克隆这个项目：

git clone https://github.com/softScheck/tplink-smartplug.git
cd tplink-smartplug

使用客户端控制插座

要控制您的智能插座，例如将其打开，可以执行以下命令：

python tplink_smartplug.py -t [IP地址] -c on

替换[IP地址]为您的智能插座的实际IP地址。

配置Wireshark解码器

为了在Wireshark中启用对TPLink Smart Home协议的支持，将tplink-smarthome.lua文件复制到Wireshark的插件目录中：

• Windows: %APPDATA%\Wireshark\plugins
• Linux/MacOS: $HOME/wireshark/plugins

3. 应用案例与最佳实践

场景一：定时开关 创建一个定时任务每天晚上自动关闭客厅的灯。

python tplink_smartplug.py -t [客厅插座IP] -j '{"schedule":{"add_schedule":{"name":"Night Light Off","start_time":"22:00","duration":"00:00","action":"turn_off"}}}'

最佳实践

• 总是检查插座的状态（使用info命令）以确保命令有效。
• 对于复杂的操作，使用JSON格式的命令来确保准确性。

4. 典型生态项目

TP-Link的智能插座也广泛兼容其他生态系统，比如Apple HomeKit、Amazon Alexa和Google Assistant，允许用户通过这些平台直接控制插座，但请注意，此开源项目主要关注于直接通过API控制，而非通过这些第三方平台。

---

通过以上步骤，您可以开始利用此开源工具，实现对TP-Link智能插座的高效管理与监控。对于进阶使用和定制需求，深入阅读项目文档及源代码将是十分必要的。

tplink-smartplug TP-Link WiFi SmartPlug Client and Wireshark Dissector 项目地址: https://gitcode.com/gh_mirrors/tp/tplink-smartplug