88 lines
2.7 KiB
Groff
88 lines
2.7 KiB
Groff
|
.TH UPSCODE2 8 "Tue Oct 19 2004" "" "Network UPS Tools (NUT)"
|
||
|
|
.SH NAME
|
||
|
|
upscode2 \- Driver for UPScode II compatible UPS equipment
|
||
|
|
.SH NOTE
|
||
|
|
This man page only documents the hardware\(hyspecific features of the
|
||
|
|
upscode2 driver. For information about the core driver, see
|
||
|
|
\fBnutupsdrv\fR(8).
|
||
|
|
|
||
|
|
.SH SUPPORTED HARDWARE
|
||
|
|
This driver supports UPS equipment which can be controlled via
|
||
|
|
the UPScode II protocol.
|
||
|
|
This is mainly Fiskars, Powerware equipment, but also some (probably OEM'ed)
|
||
|
|
products from Compaq.
|
||
|
|
|
||
|
|
.SH EXTRA ARGUMENTS
|
||
|
|
This driver supports the following optional settings in the
|
||
|
|
\fBups.conf\fR(5):
|
||
|
|
|
||
|
|
.IP "manufacturer=\fIvalue\fR"
|
||
|
|
Autodetection of this parameter is not possible yet (and it probably
|
||
|
|
never will be). Therefore this user defined string accepts any name. The
|
||
|
|
default is \fIunknown\fR.
|
||
|
|
|
||
|
|
.IP "input_timeout=\fIvalue\fR"
|
||
|
|
The timeout waiting for a response from the UPS. Some UPS models have
|
||
|
|
shown to be rather slow, resulting in frequent messages about empty
|
||
|
|
responses from the UPS. If you see this, try increasing this value.
|
||
|
|
|
||
|
|
.IP "output_pace=\fIvalue\fR"
|
||
|
|
Delay between characters sent to the UPS. This was added for completeness
|
||
|
|
with the above parameter. It has not shown to be needed yet.
|
||
|
|
|
||
|
|
.IP "baudrate=\fIvalue\fR"
|
||
|
|
The default baudrate is 1200, which is the standard for the UPScode II
|
||
|
|
protocol.
|
||
|
|
|
||
|
|
.IP "full_update_timer=\fIvalue\fR"
|
||
|
|
Number of seconds between collection of normative values.
|
||
|
|
|
||
|
|
.IP "use_crlf"
|
||
|
|
Flag to set if commands towards to UPS need to be terminated with CR-LF,
|
||
|
|
and not just CR.
|
||
|
|
|
||
|
|
.IP "use_pre_lf"
|
||
|
|
Flag to set if commands towards to UPS need to be introduced with an LF.
|
||
|
|
A Compaq T1500h is known to need this.
|
||
|
|
|
||
|
|
.SH UPSCMD
|
||
|
|
|
||
|
|
The driver supports the following commands for those UPSen that support them.
|
||
|
|
The available commands are autodetected during initialization,
|
||
|
|
so you should check availability with \fIupscmd -l\fR.
|
||
|
|
|
||
|
|
test.panel.start \(hy Start UPS self test
|
||
|
|
|
||
|
|
test.battery.start \(hy Start battery self test
|
||
|
|
|
||
|
|
beeper.enable \(hy Enable UPS beeper
|
||
|
|
|
||
|
|
beeper.disable \(hy Disable UPS beeper
|
||
|
|
|
||
|
|
shutdown.return \(hy Shut down in 1 second and wait for power to return
|
||
|
|
|
||
|
|
shutdown.stayoff \(hy Shut down in 1 seconds
|
||
|
|
|
||
|
|
shutdown.reboot \(hy Shut down in 1 seconds and reboot after 1 minute
|
||
|
|
|
||
|
|
shutdown.reboot.graceful \(hy Shut down in 20 seconds and reboot after 1 minute
|
||
|
|
|
||
|
|
.SH NOTES
|
||
|
|
|
||
|
|
The Powerware UPS models that this driver has been tested against until now
|
||
|
|
has not returned a value for \fIbattery.charge\fR. Therefore the driver will
|
||
|
|
guesstimate a value based on the nominal battery min/max and the current
|
||
|
|
battery voltage.
|
||
|
|
|
||
|
|
.SH AUTHOR
|
||
|
|
H\[oa]vard Lygre <hklygre@online.no>,
|
||
|
|
Niels Baggesen <niels@baggesen.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/
|