14.12.2015 Stefan Wendler [email protected]
Simple Python class to access a "EDIMAX Smart Plug Switch SP1101W/SP2101W". Supports simple switching as well as programming the schedule of the plug and reading power and current consumption. The class could be used as an API or as command line utility:
- Python 2.7
- The requests library (e.g. use
pip install requests
)
General:
- To specify the hostname or IP addres of the plug us the
-H <host-or-ip>
parameter. - To pass along the login for the plug use
-l <login>
. - To set the password for the login user
-p <password>
Get device info:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -i
Turn plug on:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -s ON
Turn plug off:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -s OFF
Get plug state:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -g
Get power consumption (only SP2101W)
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -w
Get current consumption (only SP2101W)
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -a
Get schedule of the whole week (human readable):
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -G
Get schedule of the whole week (python array):
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -P
Set schedule for one day:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -S "{'state': u'ON', 'sched': [[[11, 0], [11, 45]]], 'day': 6}"
Set schedule for the whole week:
python smartplug.py -H 172.16.100.75 -l admin -p 1234 -S "[
{'state': u'ON', 'sched': [[[1, 0], [1, 1]]], 'day': 0},
{'state': u'ON', 'sched': [[[2, 0], [2, 2]]], 'day': 1},
{'state': u'ON', 'sched': [[[3, 0], [3, 3]]], 'day': 2},
{'state': u'ON', 'sched': [[[4, 0], [4, 4]]], 'day': 3},
{'state': u'ON', 'sched': [[[5, 0], [5, 5]]], 'day': 4},
{'state': u'ON', 'sched': [[[6, 0], [6, 6]]], 'day': 5},
{'state': u'ON', 'sched': [[[7, 0], [7, 7]]], 'day': 6},
]"
Import:
from ediplug.smartplug import SmartPlug
Create plug object:
p = SmartPlug("172.16.100.75", ('admin', '1234'))
Get device info
print(p.info)
Turn plug off:
p.state = "OFF"
Turn plug on:
p.state = "ON"
Query and print current state of plug:
print(p.state)
Get power consumption (only SP2101W)
print(p.power)
Get current consumption (only SP2101W)
print(p.current)
Read and print complete week schedule from plug:
print(p.schedule.__str__())
Write schedule for on day to plug (Saturday, 11:15 - 11:45):
p.schedule = {'state': u'ON', 'sched': [[[11, 15], [11, 45]]], 'day': 6}
Note: 0 - Sunday, 6 - Saturday
Write schedule for the whole week:
p.schedule = [
{'state': u'ON', 'sched': [[[0, 3], [0, 4]]], 'day': 0},
{'state': u'ON', 'sched': [[[0, 10], [0, 20]], [[10, 16], [11, 55]], [[15, 19], [15, 32]], [[21, 0], [23, 8]], [[23, 17], [23, 59]]], 'day': 1},
{'state': u'OFF', 'sched': [[[19, 59], [21, 1]]], 'day': 2},
{'state': u'OFF', 'sched': [[[20, 59], [21, 12]]], 'day': 3},
{'state': u'OFF', 'sched': [], 'day': 4},
{'state': u'OFF', 'sched': [[[0, 0], [0, 30]], [[11, 14], [14, 31]]], 'day': 5},
{'state': u'ON', 'sched': [[[1, 42], [2, 41]]], 'day': 6}]
Complete examples could be found in the examples
directory. Don't forget to set your python path properly. E.g. when
running the 1st exmaple from the projects main directory:
PYTHONPATH=./src
python ./src/examples/sample_01.py
Some more information on the plug and its XML API is provided on my website:
- [Operating from Python] (http://gpio.kaltpost.de/?p=2112)
- [Scheduling] (http://gpio.kaltpost.de/?p=2224)
- 2015-12-15: added 'power' and 'current' functionality (SP2101W only, thanks Robin Grundei for the XML request/response and the testing).
- 2015-10-28: added 'info' property to get device info (thanks Andreas Kainz for the patch!)
- 2014-12-27: re-wrote scheduling to correct various scheduling bugs
- 2014-09-12: first version