You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A proof-of-concept python client to talk to a TP-Link device using the **TP-Link Device Debug Protocol (TDDP)**.
64
64
65
65
TDDP is implemented across a whole range of TP-Link devices including routers, access points, cameras and smartplugs.
66
-
TDDP can read and write a device's configuration and issue special commands. On the HS110 SmartPlug it uses UDP port 1040, but might use different ports on other devices.
66
+
TDDP can read and write a device's configuration and issue special commands. UDP port 1040 is used to send commands, replies come back on UDP port 61000. This client has been tested with a TP-Link Archer C9 Wireless Router and a TP-Link HS-110 WiFi Smart Plug.
67
67
68
68
TDDP is a binary protocol documented in patent [CN102096654A](https://www.google.com/patents/CN102096654A?cl=en).
69
69
@@ -72,8 +72,17 @@ Data is returned DES-encrypted and requires the username and password of the dev
Provide the target IP using -t. You can provide a username and password, otherwise admin/admin is used as a default. They are necessary to decrypt the data that is returned.
78
78
79
-
Only three basic data readout commands (`test1, test2, test3`) are implemented. They are named test since it is unclear what type of data they might read out on different type of devices.
79
+
Provide the command as a two-character hex string, e.g. -c 0A. What type of data a command might read out will be different for various TP-Link devices.
80
+
81
+
#### Example ####
82
+
Reading out the WAN link status on an Archer C9 in default configuration shows the link is down (0):
83
+
```
84
+
./tddp-client.py -t 192.168.0.1 -c 0E
85
+
Request Data: Version 02 Type 03 Status 00 Length 00000000 ID 0001 Subtype 0e
86
+
Reply Data: Version 02 Type 03 Status 00 Length 00000018 ID 0001 Subtype 0e
0 commit comments