268 lines
8.5 KiB
Groff
268 lines
8.5 KiB
Groff
|
'\" t
|
||
|
|
.\" Title: powercom
|
||
|
|
.\" Author: [see the "AUTHOR" section]
|
||
|
|
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
||
|
|
.\" Date: 12/24/2010
|
||
|
|
.\" Manual: NUT Manual
|
||
|
|
.\" Source: Network UPS Tools
|
||
|
|
.\" Language: English
|
||
|
|
.\"
|
||
|
|
.TH "POWERCOM" "8" "12/24/2010" "Network UPS Tools" "NUT Manual"
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.\" * Define some portability stuff
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
|
.\" http://bugs.debian.org/507673
|
||
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
|
.ie \n(.g .ds Aq \(aq
|
||
|
|
.el .ds Aq '
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.\" * set default formatting
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.\" disable hyphenation
|
||
|
|
.nh
|
||
|
|
.\" disable justification (adjust text to left margin only)
|
||
|
|
.ad l
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.\" * MAIN CONTENT STARTS HERE *
|
||
|
|
.\" -----------------------------------------------------------------
|
||
|
|
.SH "NAME"
|
||
|
|
powercom \- UPS driver for Powercom/Trust/Advice UPS equipment
|
||
|
|
.SH "NOTE"
|
||
|
|
.sp
|
||
|
|
This man page only documents the hardware\-specific features of the powercom driver\&. For information about the core driver, see \fBnutupsdrv\fR(8)\&.
|
||
|
|
.SH "SUPPORTED HARDWARE"
|
||
|
|
.sp
|
||
|
|
This driver supports many similar kinds of UPS hardware\&. The most common ones are the Trust 425/625, Powercom, and Advice Partner/King PR750\&. Others using the same protocol may also work\&.
|
||
|
|
.SH "EXTRA ARGUMENTS"
|
||
|
|
.sp
|
||
|
|
This driver supports the following optional settings in the \fBups.conf\fR(5) file:
|
||
|
|
.PP
|
||
|
|
\fBlinevoltage\fR=\fIvalue\fR
|
||
|
|
.RS 4
|
||
|
|
An integer specifying the mains voltage\&. It can\(cqt be auto detected\&. Acceptable values are in the range of 110\(em120 or 220\(em240\&. The default is
|
||
|
|
\fI230\fR\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBmanufacturer\fR=\fIname\fR
|
||
|
|
.RS 4
|
||
|
|
Specify the manufacturer name, which also can\(cqt be auto detected\&. This is a user defined string, so any name is acceptable\&. The default is
|
||
|
|
\fIPowerCom\fR\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBmodelname\fR=\fIname\fR
|
||
|
|
.RS 4
|
||
|
|
Specify the model name, which also can\(cqt be auto detected\&. This is a user defined string, so any name is acceptable\&. The default is
|
||
|
|
\fIUnknown\fR\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBserialnumber\fR=\fIvalue\fR
|
||
|
|
.RS 4
|
||
|
|
Like modelname above, but for the serial number\&. The default is
|
||
|
|
\fIUnknown\fR\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBtype\fR=\fIname\fR
|
||
|
|
.RS 4
|
||
|
|
The exact type of the communication protocol within the powercom family, that will be used to communicate with the UPS\&. The type is named after the first modelname that was coded with that protocol\&. The acceptable names are
|
||
|
|
\fIKP625AP\fR,
|
||
|
|
\fITrust\fR,
|
||
|
|
\fIEgys\fR,
|
||
|
|
\fIKIN\fR,
|
||
|
|
\fIBNT\fR,
|
||
|
|
\fIIMP\fR
|
||
|
|
and
|
||
|
|
\fIBNT\-other\fR\&. The default is
|
||
|
|
\fITrust\fR\&.
|
||
|
|
.sp
|
||
|
|
\fIBNT\-other\fR
|
||
|
|
is a special type for BNT 100\-120V models\&. For this type you can (I think must!) specify voltage, batteryPercentage, loadPercentage and validationSequence\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBnumOfBytesFromUPS\fR=\fIvalue\fR
|
||
|
|
.RS 4
|
||
|
|
The number of bytes in a UPS frame\&. The default is type\-dependent and is given below\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBmethodOfFlowControl\fR=\fIname\fR
|
||
|
|
.RS 4
|
||
|
|
The method of serial communication flow control that is engaged by the UPS\&. The default is type\-dependent and is given below\&. Acceptable names are
|
||
|
|
\fIdtr0rts1\fR,
|
||
|
|
\fIdtr1\fR
|
||
|
|
or
|
||
|
|
\fIno_flow_control\fR\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBshutdownArguments\fR={{\fIminutes\fR,\fIseconds\fR},\fIwhether_minutes_should_be_used\fR}
|
||
|
|
.RS 4
|
||
|
|
The minutes and seconds that the UPS should wait between receiving the shutdown command and actually shutting off\&. The other argument should be set to the character
|
||
|
|
\fIn\fR
|
||
|
|
only when the minutes value should be skipped and not sent to the UPS\&. The default is type\-dependent and is given below\&. The braces and commas are mandatory\&. Note that there should be no whitespace characters\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBvoltage\fR={\fIcoefficient1\fR,\fIcoefficient2\fR,\fIcoefficient3\fR,\fIcoefficient4\fR}
|
||
|
|
.RS 4
|
||
|
|
(Only for types KP625AP, Trust, Egys, BNT\-other\&.) A quad that is used convert the raw data to a human\-readable voltage reading\&. The default is type\-dependent and is given below\&. Do note that the braces and commas are mandatory, as well as the lack of whitespace characters\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBfrequency\fR={\fIcoefficient1\fR,\fIcoefficient2\fR}
|
||
|
|
.RS 4
|
||
|
|
(Only for types KP625AP, Trust, Egys\&.) A pair to convert the raw data to a human\-readable frequency reading\&. The default is type\-dependent and is given below\&. Do note that the braces and commas are mandatory as well, as the lack of whitespace characters\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBbatteryPercentage\fR={\fIcoefficient1\fR,\fIcoefficient2\fR,\fIcoefficient3\fR,\fIcoefficient4\fR,\fIcoefficient5\fR}
|
||
|
|
.RS 4
|
||
|
|
(Only for KP625AP, Trust, Egys, BNT\-other\&.) A 5 tuple to convert the raw data to a human\-readable battery percentage reading\&. The default is type\-dependent and is given below\&. Do note that the braces and commas are mandatory, as the lack of white space characters\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBloadPercentage\fR={\fIcoefficient1\fR,\fIcoefficient2\fR,\fIcoefficient3\fR,\fIcoefficient4\fR}
|
||
|
|
.RS 4
|
||
|
|
(Only for types KP625AP, Trust, Egys, BNT\-other\&.) A quad to convert the raw data to human readable load percentage reading\&. The default is type\-dependent and is given below\&. Do note that the braces and commas are mandatory, as the lack of white space characters\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fBvalidationSequence\fR={{\fIindex1\fR,\fIvalue1\fR},{\fIindex2\fR,\fIvalue2\fR},{\fIindex3\fR,\fIvalue3\fR}}
|
||
|
|
.RS 4
|
||
|
|
(Only for types KP625AP, Trust, Egys, BNT\-other\&.) 3 pairs to be used for validating the UPS by comparing bytes of the raw data with constant values\&. The default is type\-dependent and is given below\&. The braces and commas are mandatory, as the lack of white space characters\&.
|
||
|
|
.RE
|
||
|
|
.SH "DEFAULT VALUES FOR THE EXTRA ARGUMENTS"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
linevoltage = 230
|
||
|
|
manufacturer = PowerCom
|
||
|
|
modelname = Unknown
|
||
|
|
serialnumber = Unknown
|
||
|
|
type = Trust
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.sp
|
||
|
|
The rest of the default values for the extra arguments are type\-dependent:
|
||
|
|
.SS "Trust"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 11
|
||
|
|
methodOfFlowControl = dtr0rts1
|
||
|
|
validationSequence = {{5,0},{7,0},{8,0}}
|
||
|
|
shutdownArguments = {{0,10},n}
|
||
|
|
frequency = {0\&.00020997,0\&.00020928}
|
||
|
|
loadPercentage = {6\&.1343,\-0\&.3808,4\&.3110,0\&.1811}
|
||
|
|
batteryPercentage = {5\&.0000,0\&.3268,\-825\&.00,4\&.5639,\-835\&.82}
|
||
|
|
voltage = {1\&.9216,\-0\&.0977,0\&.9545,0\&.0000}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "KP625AP"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = dtr0rts1
|
||
|
|
validationSequence = {{5,0x80},{7,0},{8,0}}
|
||
|
|
shutdownArguments = {{0,10},n}
|
||
|
|
frequency = {0\&.00020997,0\&.00020928}
|
||
|
|
loadPercentage = {6\&.1343,\-0\&.3808,4\&.3110,0\&.1811}
|
||
|
|
batteryPercentage = {5\&.0000,0\&.3268,\-825\&.00,4\&.5639,\-835\&.82}
|
||
|
|
voltage = {1\&.9216,\-0\&.0977,0\&.9545,0\&.0000}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "Egys"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = no_flow_control
|
||
|
|
validationSequence = {{5,0x80},{7,0},{8,0}}
|
||
|
|
shutdownArguments = {{0,10},n}
|
||
|
|
frequency = {0\&.00020997,0\&.00020928}
|
||
|
|
loadPercentage = {6\&.1343,\-0\&.3808,1\&.3333,0\&.6667}
|
||
|
|
batteryPercentage = {5\&.0000,0\&.3268,\-825\&.00,2\&.2105,\-355\&.37}
|
||
|
|
voltage = {1\&.9216,\-0\&.0977,0\&.9545,0\&.0000}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "IMP"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = no_flow_control
|
||
|
|
validationSequence = {{5,0xFF},{7,0},{8,0}}
|
||
|
|
shutdownArguments = {{1,30},y}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "KIN"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = no_flow_control
|
||
|
|
validationSequence = {{11,0x4b},{8,0},{8,0}}
|
||
|
|
shutdownArguments = {{1,30},y}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "BNT"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = no_flow_control
|
||
|
|
validationSequence = {{11,0x42},{8,0},{8,0}}
|
||
|
|
shutdownArguments = {{1,30},y}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SS "BNT\-other"
|
||
|
|
.sp
|
||
|
|
.if n \{\
|
||
|
|
.RS 4
|
||
|
|
.\}
|
||
|
|
.nf
|
||
|
|
numOfBytesFromUPS = 16
|
||
|
|
methodOfFlowControl = no_flow_control
|
||
|
|
validationSequence = {{8,0},{8,0},{8,0}}
|
||
|
|
shutdownArguments = {{1,30},y}
|
||
|
|
loadPercentage = {1\&.4474,0\&.0,0\&.8594,0\&.0}
|
||
|
|
batteryPercentage = {5\&.0000,0\&.3268,\-825\&.00,0\&.46511,0}
|
||
|
|
voltage = {1\&.9216,\-0\&.0977,0\&.82857,0\&.0000}
|
||
|
|
.fi
|
||
|
|
.if n \{\
|
||
|
|
.RE
|
||
|
|
.\}
|
||
|
|
.SH "AUTHOR"
|
||
|
|
.sp
|
||
|
|
Peter Bieringer <pb@bieringer\&.de>, Alexey Sidorov <alexsid@altlinux\&.org>
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.SS "The core driver:"
|
||
|
|
.sp
|
||
|
|
\fBnutupsdrv\fR(8)
|
||
|
|
.SS "Internet resources:"
|
||
|
|
.sp
|
||
|
|
The NUT (Network UPS Tools) home page: http://www\&.networkupstools\&.org/
|