powerpanel - Driver for PowerPanel Plus compatible UPS equipment
This man page only documents the hardware-specific features of the powerpanel
driver. For information about the core driver, see nutupsdrv
This driver supports CyberPower BC1200, PR2200 and many other similar devices,
both for the text and binary protocols. The driver will autodetect which
protocol is used.
This driver supports the following optional settings in ups.conf
Override the default autodetection of the
If you don’t like the autodetected
value, you can override this by setting it here.
Like manufacturer above.
Like manufacturer above.
Time to wait before switching on the UPS (1 -
9999 minutes, 0=indefinite). Only available with the text protocol driver (see
Time to wait before shutting down the UPS (6 -
600 seconds). Values below 60 seconds will be truncated to 6 seconds
intervals, values above 60 seconds to 60 seconds intervals. Only available
with the text protocol driver (see Support Status).
Depending on the type of your UPS unit, some of the following variables may be
changed with upsrw
(8). If the driver can’t read a variable from
the UPS, it will not be made available.
writable: high transfer voltage point in
writable: low transfer voltage point in
writable: remaining battery charge percentage
for low battery warning
writable: nominal output voltage in V
writable: allow cold start from battery
Depending on the type of your UPS unit, some of the following commands may be
On many devices, these commands are unreliable, so before using them you must
verify that these work as expected (see Shutdown Issues).
Vendor support is absent for this driver, so if you need some features that are
currently not available, provide ample documentation on what the driver should
sent to the UPS in order to make this work. If more information would be
available on the binary protocol, it would probably be possible to make
configurable. So far, nobody has taken the
time to investigate what we should tell the UPS to make this work, and
CyberPower isn’t willing to share this with us.
If the shutdown.return
command on your UPS doesn’t seem to work,
chances are that your UPS is an older model. Try a couple of different
settings for offdelay
. If no value in the range 6..600 works, your UPS
likely doesn’t support this. In order to get the expected behaviour, it
(when on battery) and shutdown.reboot
(when on mains). The driver will automatically fallback to these commands if
fails, and tries to detect which one should be used
when called with the -k
option (or through upsdrvctl shutdown
This isn’t bullet-proof, however, and you should be prepared that the
power will either not be shutdown or that it doesn’t return when the
power comes back. All models supported by the binary protocol and many
supported through the text protocol are affected by this.
The CyberPower OP series don’t offer direct voltage, charge, frequency
and temperature readings. Instead, they will return a binary value that needs
conversion to the actual value.
The exact conversion needed is unknown at the time of this writing, hence an
estimation was made based om readings from actual devices. This may (probably
will) be off, possibly a lot. Unless you can tell us the exact mapping between
values from the UPS and actual readings, don’t bother to complain.
We’ve done the best we can based on the limited information available.
Remember, a UPS isn’t a measuring instrument.
Arjen de Korte <firstname.lastname@example.org>, Doug Reynolds
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/