The tp-link Wi-Fi Smart Plug model HS100 is an embedded Linux computer with a Wifi chip, a 110/220 V AC relay with a 15 A current limit, and a US-style grounded electrical socket. You pair with it by establishing an ad-hoc network between the plug and a smartphone (also called Wifi direct). After giving your router's SSID and access information, the plug connects to it and you can control the plug with the app provided by tp-link, called Kasa. One downside of using Kasa is that it's really not much more than a wall-switch in an app, though it does have pretty rich timer features which are nice. But you can't do things like turn the light on or off in response to events on the internet. Tp-link does provide a network control mode, but you have to pass control of your plug over to them, which isn't particularly great if you endeavor to remain the master of your own domain, haha only serious.
The script below was graciously provided by @ggeorgovassilis in his linux scripts repo, with help from Thomas Baust. You can read a great description of the reverse engineering process and the development of the script at George's blog here.
Script to connect over TCP/IP to an hs100/hs110 smart plug, switch it on and off and query status information. You'll need the IP address and port (was 9999 in my tests) and a command, e.g.:
Print what IP your HS100 has:
hs100.sh discoverDiscover IP, and save it for later:
- if you use sudo, then an entry is written into
/etc/hostsfor the HS100, if it is found - if you don't do this, you must add an
-i 192.168.1.20arguments to all otherhs100.shcommands, e.g.hs100.sh -i 192.168.1.20 on
sudo hs100.sh discover
Switch plug on:
hs100.sh onSwitch plug off:
hs100.sh onCheck if plug is on or off:
hs100.sh checkPrint plug system status:
hs100.sh statusPrint power consumption (not supported with my hs100 so not tested):
hs100.sh emeter