Projects/Sysutils/Openupsd

Openupsd 0.3.1

OpenUPSd - a UPS daemon pretty specific to those Belkin serial-connected UPS'

About

OpenUPSd is a UPS daemon, pretty specific to those Belkin serial-connected UPS' that speak the regulator pro smart protocol, as documented on this handy web-page.
I've got a device that reports itself to be a F6C625-220V and it's working with the software quite happily :-). That UPS may now have done its last dance, so I've now got an APC smart UPS. Currently investigating adding support for this; found some handy protocol documentation for it.

This daemon is monitoring only, at the moment anyway. If you want to configure your UPS I suggest using the Belkin tools -- that worked for me. I did this once, a long time ago, and haven't needed to use their tools again since. The daemon supports two types of device:
  • serial: locally connected serial devices.
  • remote: TCP connection to a remote openupsd, that has devices and is listening.
The configuration file is pretty verbose, and the example one supplied (in the tarball) covers what's currently supported. The distribution contains a changelog.

Bugs/Deficiencies

Hupping the daemon to reload the configuration doesn't work either yet. This is likely to be slightly trickier, so will be dealt with later. Manually stopping and restarting the daemon works tho.
There isn't much documentation, like -- no man-page. At some point I'll get around to writing some nice concise documentation, but until then it's this web-page, the README and the example config file.

What it outputs

The traditional method of data grabbing is with the OUTPUT config directive. This can be generated for both local and remote devices. For my desktop, that's powered (via a long bit of wire) off teddy's UPS, this output was recently: 
    teddyUPS.model: F6C625-220V
    teddyUPS.battery-condition: normal
    teddyUPS.battery-is: charging
    teddyUPS.battery-voltage: 13.0
    teddyUPS.battery-temperature: 46
    teddyUPS.battery-charge: 86
    teddyUPS.input-frequency: 49.9
    teddyUPS.input-voltage: 232.0
    teddyUPS.output-from: utility
    teddyUPS.output-frequency: 49.9
    teddyUPS.output-voltage: 231.0
    teddyUPS.output-load: 82
    teddyUPS.status-field: on-line buzzer-alarm-on
If network servers are setup, and clients connected, data is sent to clients (asynchronously). The name of a device can change with each hop, if it helps identify stuff. The UPS on teddy is known as ``UPS1'' to it. The data that flies over the network is pure plain-text (and looks pretty much like the above, but framed a bit), so you can sit back and watch with telnet ;-).

Download

See the README file in the distribution for specifics about compiling. As usual, GPL license. You might also want some of these, that may need fiddling slightly to suit your needs:
  • INITD-openupsd init script (rename as /etc/init.d/openupsd, chmod +x if not and update-rc.d it)

Installation

Using the FreeBSD ports system:
cd /usr/ports/sysutils/openupsd make install clean
Using the FreeBSD pkg system:
pkg install sysutils/openupsd