如何使用tplink_smartplug.py：5分钟快速上手TP-Link智能插座控制

如何使用tplink_smartplug.py：5分钟快速上手TP-Link智能插座控制

【免费下载链接】tplink-smartplugTP-Link WiFi SmartPlug Client and Wireshark Dissector项目地址: https://gitcode.com/gh_mirrors/tp/tplink-smartplug

tplink_smartplug.py是一款功能强大的TP-Link智能插座控制工具，支持HS-100和HS-110等型号，通过简单的命令即可实现智能插座的远程控制与状态查询。本文将带你快速掌握其核心用法，让你轻松玩转智能插座管理。

准备工作：获取工具与环境配置

首先需要获取工具源码，在终端中执行以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/tp/tplink-smartplug cd tplink-smartplug

该工具基于Python 3开发，无需额外安装依赖，直接使用系统自带Python环境即可运行。核心控制脚本为tplink_smartplug.py，同时项目提供了完整的命令参考文档tplink-smarthome-commands.txt。

基础操作：5个常用控制命令

1. 查询设备信息

获取智能插座的详细信息（型号、固件版本、状态等）：

python3 tplink_smartplug.py -t 192.168.1.100 -c info

2. 开关控制

• 打开插座：

python3 tplink_smartplug.py -t 192.168.1.100 -c on

• 关闭插座：

python3 tplink_smartplug.py -t 192.168.1.100 -c off

3. LED状态控制

• 开启LED指示灯：

python3 tplink_smartplug.py -t 192.168.1.100 -c ledon

• 关闭LED指示灯（夜间模式）：

python3 tplink_smartplug.py -t 192.168.1.100 -c ledoff

4. 能耗监测（HS-110专用）

查询实时电力使用情况：

python3 tplink_smartplug.py -t 192.168.1.100 -c energy

5. 高级功能：自定义JSON命令

对于更复杂的操作，可以直接发送JSON命令，例如设置设备别名：

python3 tplink_smartplug.py -t 192.168.1.100 -j '{"system":{"set_dev_alias":{"alias":"客厅灯"}}}'

协议解析：了解智能控制背后的通信

TP-Link智能插座采用专用加密协议进行通信，工具通过XOR加密算法（初始密钥171）实现命令的加解密。下图展示了Wireshark捕获的设备通信数据包，其中包含了加密的控制指令与设备响应：

常见问题解决

连接失败怎么办？

1. 确认智能插座与控制设备在同一局域网
2. 检查目标IP地址是否正确（可通过路由器管理界面查看设备IP）
3. 确保插座已完成配网并正常工作

支持哪些设备型号？

目前工具已验证支持HS-100（基础款）和HS-110（带能耗监测功能），其他TP-Link智能插座型号可能兼容，建议先使用info命令测试兼容性。

总结

通过tplink_smartplug.py工具，你可以摆脱官方APP的限制，直接通过命令行或脚本实现对TP-Link智能插座的灵活控制。无论是日常开关操作、定时任务还是能耗监测，这款轻量级工具都能满足你的需求。更多高级功能可参考项目中的命令列表文件，探索更多智能控制可能性。

【免费下载链接】tplink-smartplugTP-Link WiFi SmartPlug Client and Wireshark Dissector项目地址: https://gitcode.com/gh_mirrors/tp/tplink-smartplug