The powerbars from annejan

powerbars's Introduction

= Powerbars for TechInc =

We have multiple powerbars, controllable over serial. Each of these bars has
power sockets that can be turned on/off individually. The plan is to use these
throughout to space to be able to remotely control the lights and other
machinery.

== Design ==

Since we don't care about where the bars are and how many we have, the most
basic component we consider in a socket. A socket can be turned on or off.
A socket can be part of a group. As such, a group consists of a set of sockets.
Groups can be turned on or off as a whole. Finally, there will be prefixes,
which consist of a set of groups. A prefix can be turned on or off as a whole,
thus turning on or off and the groups in said prefix, and all the sockets in all
said groups.

== Security ==

The plan is to use serial cables to connect the bars together,
but optionally we can put a cheap device with serial in front of
every powerbar and have them communicate over HTTPS.
The inter-device communication (where required) will happen over HTTPS, using
certificates for authentication.

ACL's will be used, to "secure" certain groups if deemed necessary.

The main supported API is listed below. Some other interfaces (with possibly
access to all components) will follow.

== API ==

export HOST=10.0.20.30
export PORT=5000

for i in $(seq 0 19) ; do curl -d state=On http://$HOST:$PORT/0/$i ; done

Extra POST var, kill=graceful or force

Current examples:

    # Off
    curl -d state=On http://$HOST:$PORT/group/lights
    # On
    curl -d state=Off http://$HOST:$PORT/group/lights

Recommend Projects