POWERPANEL(8) | NUT Manual | POWERPANEL(8) |
NAME¶
powerpanel - Driver for PowerPanel Plus compatible UPS equipmentNOTE¶
This man page only documents the hardware-specific features of the powerpanel driver. For information about the core driver, see nutupsdrv(8).SUPPORTED HARDWARE¶
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.EXTRA ARGUMENTS¶
This driver supports the following optional settings in ups.conf(5): protocol=[text,binary]Override the default autodetection of the
protocol.
manufacturer=value
If you don’t like the autodetected
value, you can override this by setting it here.
model=value
Like manufacturer above.
serial=value
Like manufacturer above.
ondelay=value
Time to wait before switching on the UPS (1 -
9999 minutes, 0=indefinite). Only available with the text protocol driver (see
Support Status).
offdelay=value
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).
VARIABLES¶
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. input.transfer.highwritable: high transfer voltage point in
V
input.transfer.low
writable: low transfer voltage point in
V
battery.charge.low
writable: remaining battery charge percentage
for low battery warning
output.voltage.nominal
writable: nominal output voltage in V
ups.start.battery
writable: allow cold start from battery
COMMANDS¶
Depending on the type of your UPS unit, some of the following commands may be available.•test.battery.start.quick,
test.battery.stop
•beeper.enable, beeper.disable,
beeper.toggle
•shutdown.return, shutdown.reboot,
shutdown.stayoff
•shutdown.stop
SUPPORT STATUS¶
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 ondelay and offdelay 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.SHUTDOWN ISSUES¶
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 requires shutdown.stayoff (when on battery) and shutdown.reboot (when on mains). The driver will automatically fallback to these commands if shutdown.return fails, and tries to detect which one should be used when called with the -k option (or through upsdrvctl shutdown).KNOWN PROBLEMS¶
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.AUTHORS¶
Arjen de Korte <arjen@de-korte.org>, Doug Reynolds <mav@wastegate.net>SEE ALSO¶
The core driver:¶
nutupsdrv(8)Internet resources:¶
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/05/21/2012 | Network UPS Tools |