pypwrctrl 0.2.2

Description:

pypwrctrl 0.2.2

# pypwrctrl
## Introduction
This is a library and command line utility for Anel NET-PwrCtrl network
controllable extension leads. It offers the functionality provided by the UDP
protocol. Devices can be found by network discovery and saved into a
configuration file for easy access.
The UDP protocol has to be enabled in the NET-PwrCtrl devices in order to
control them with this tool.
## Security Notes
Enabling the UDP protocol is quite insane from a security standpoint. The user
credentials are tranmitted as plaintext in the commands requiring
authentication. Never use this tool or this protocol if you cannot live with
the plugs being controlled by anyone having access to the network!
## Installation
The program was written on Linux but should also run on Windows, Mac OS X, and
every other operating system supported by Python 3.
Simply run:

easy_install3 –user pypwrctrl

Or checkout the repository and run:

./setup.py install –user

You can remove the ‘–user’ in both methods to install for all users of your
system (requires root privileges).
pypwrctrl depends only on ‘python3’ and ‘python3-setuptools’ for
installation.
## Usage
For simple usage information type:

pypwrctrl –help

This tutorial will give a more detailed introduction with examples.
First configure your NET-PwrCtrl to handle the UDP protocol (please note
Security Notes above) and set both ports to something above the privileged
ports (>1024). These configuration options are in the Lan page of the
webinterface. I am going to assume a sending port of 4165, a receiving port of
4166, and the user ‘ulf’ with the password ‘secret’ in the following examples.
First let us try to discover the device:

pypwrctrl -d -i 4165 -o 4166 -u ulf -p secret show

If you do not see any devices please make sure that UDP is enabled, the right
ports are configured, and the device is reachable from the device you are
testing this on.
The -d is the switch which enables network discovery and the other switches
tell the program which ports and user credentials are used.
Always typing the port options is tiresome. We should save them in the
configuration file:

pypwrctrl -i 4165 -o 4166 -u ulf -p secret save

Now we can discover devices with a simpler command:

pypwrctrl -d show

You can also save the discovered devices and plugs for faster access:

pypwrctrl -d save

Every configuration item can be changed by setting it with its command line
switch and applying the ‘save’ command.
Now to the part you are actually here for: Controlling the state of the power
outlets. Turning a power outlet on is as simple as writing:

pypwrctrl on 192.168.1.50 1

Turning it off again is just as easy:

pypwrctrl off 192.168.1.50 1

Both commands change the state of the socket ‘1’ of the device at
‘192.168.1.50’. You can leave out the address if you have only one device or
want to control all devices with one command.
Did you know that you can assign names to the individual sockets? Set a
sensible name in the webinterface of your device and use it to select the
socket in pypwrctrl:

pypwrctrl on fan

Devices can also be named.
## TODO

resend messages
add ability to control devices without configuration and ‘-d’
test with more than one device and other product versions (used
NET-PwrCtrl HOME)
support Temperature, IO, …

## License
pypwrctrl is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
pypwrctrl is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
pypwrctrl. If not, see
[http://www.gnu.org/licenses/](http://www.gnu.org/licenses/).