122 lines
4.5 KiB
Groff
122 lines
4.5 KiB
Groff
.TH POWERPANEL 8 "Tue Dec 23 2008" "" "Network UPS Tools (NUT)"
|
|
.SH NAME
|
|
powerpanel \- Driver for PowerPanel Plus compatible UPS equipment
|
|
.SH NOTE
|
|
This man page only documents the hardware\(hyspecific features of the
|
|
powerpanel driver. For information about the core driver, see
|
|
\fBnutupsdrv\fR(8).
|
|
|
|
.SH 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.
|
|
|
|
.SH EXTRA ARGUMENTS
|
|
This driver supports the following optional settings in \fBups.conf\fR(5):
|
|
|
|
.IP "protocol=\fI[text,binary]\fR"
|
|
Override the default autodetection of the protocol.
|
|
|
|
.IP "manufacturer=\fIvalue\fR"
|
|
If you don't like the autodetected value, you can override this by setting
|
|
it here.
|
|
|
|
.IP "model=\fIvalue\fR"
|
|
Like manufacturer above.
|
|
|
|
.IP "serial=\fIvalue\fR"
|
|
Like manufacturer above.
|
|
|
|
.IP "ondelay=\fIvalue\fR"
|
|
Time to wait before switching on the UPS (1 - 9999 minutes, 0 indefinite).
|
|
Only available with the text protocol driver (see \fBSUPPORT STATUS\fR).
|
|
|
|
.IP "offdelay=\fIvalue\fR"
|
|
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
|
|
\fBSUPPORT STATUS\fR).
|
|
|
|
.SH VARIABLES
|
|
Depending on the type of your UPS unit, some of the following variables may
|
|
be changed. If the driver can't read a variable from the UPS, it will not be
|
|
made available.
|
|
.TP 12
|
|
.B input.transfer.high
|
|
writable: high transfer voltage point in V
|
|
.TP
|
|
.B input.transfer.low
|
|
writable: low transfer voltage point in V
|
|
.TP
|
|
.B battery.charge.low
|
|
writable: remaining battery charge percentage for low battery warning
|
|
.TP
|
|
.B output.voltage.nominal
|
|
writable: nominal output voltage in V
|
|
.TP
|
|
.B ups.start.battery
|
|
writable: allow cold start from battery
|
|
.PD
|
|
|
|
.SH COMMANDS
|
|
Depending on the type of your UPS unit, some of the following commands may
|
|
be available.
|
|
.TP 12
|
|
.B test.battery.start.quick, test.battery.stop
|
|
.TP
|
|
.B beeper.enable, beeper.disable, beeper.toggle
|
|
.TP
|
|
.B shutdown.return, shutdown.reboot, shutdown.stayoff
|
|
On many devices, these commands are unreliable, so before using them you
|
|
must verify that these work as expected (see \fBSHUTDOWN ISSUES\fR).
|
|
.TP
|
|
.B shutdown.stop
|
|
.PD
|
|
|
|
.SH 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.
|
|
|
|
.SH SHUTDOWN ISSUES
|
|
If the \fBshutdown.return\fR command on your UPS doesn't seem to work,
|
|
chances are that your UPS is of an older model. Try a couple of different
|
|
settings for \fIoffdelay\fR. 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 \fBshutdown.stayoff\fR (when on battery) and \fBshutdown.reboot\fR
|
|
(when on mains). The driver will automatically fallback to these commands if
|
|
\fBshutdown.return\fR fails and tries to detect which one should be used when
|
|
called with the '\(hyk' option (or through \fBupsdrvctl shutdown\fR).
|
|
|
|
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.
|
|
|
|
.SH 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.
|
|
|
|
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.
|
|
|
|
.SH AUTHORS
|
|
Arjen de Korte <arjen@de\(hykorte.org>, Doug Reynolds <mav@wastegate.net>
|
|
|
|
.SH SEE ALSO
|
|
|
|
.SS The core driver:
|
|
\fBnutupsdrv\fR(8)
|
|
|
|
.SS Internet resources:
|
|
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|