table of contents
POWERCOM(8) | NUT Manual | POWERCOM(8) |
NAME¶
powercom - UPS driver for Powercom/Trust/Advice UPS equipmentNOTE¶
This man page only documents the hardware-specific features of the powercom driver. For information about the core driver, see nutupsdrv(8).SUPPORTED HARDWARE¶
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.EXTRA ARGUMENTS¶
This driver supports the following optional settings in the ups.conf(5) file: linevoltage=valueAn integer specifying the line voltage. It
can’t be auto detected. Acceptable values are in the range of 110-120 or
220-240. The default is 230.
manufacturer=name
Specify the manufacturer name, which also
can’t be auto detected. This is a user defined string, so any name is
acceptable. The default is PowerCom.
modelname=name
Specify the model name, which also can’t
be auto detected. This is a user defined string, so any name is acceptable.
The default is Unknown.
serialnumber=value
Like modelname above, but for the serial
number. The default is Unknown.
type=name
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 Trust, Egys, KP625AP, IMP,
KIN, BNT, and BNT-other. The default is Trust.
BNT-other is a special type for other BNT models (such as the 1500A at
120V and can be used to override ALL models using ALL of the following
values.
shutdownArguments={{minutes,seconds},whether_minutes_should_be_used}
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 n 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.
numOfBytesFromUPS=value
The number of bytes in a UPS frame: 16 is
common, 11 for Trust. The default is type-dependent and is given
below.
methodOfFlowControl=name
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 dtr0rts1, dtr1 or
no_flow_control.
validationSequence={{index1,value1},{index2,value2},{index3,value3}}
(Only for types KP625AP, Trust, Egys.) 3 pairs
to be used for validating the UPS by comparing bytes of the raw data with
constant values. The index selects the byte from the UPS (see
numOfBytesFromUPS) and the value is for matching to the byte. The default is
type-dependent and is given below. The braces and commas are mandatory, as the
lack of white space characters.
frequency={A,B}
(Only for types KP625AP, Trust, Egys.) A pair
to convert the raw frequency data to a human-readable frequency reading using
the function 1/(A*x+B). If the raw value x IS the frequency, then set
A=1/(x^2) and B=0. 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.
loadPercentage={BatteryA,BatteryB,LineA,LineB}
(Only for types KP625AP, Trust, Egys.) A quad
to convert the raw load data to human readable load percentage reading using
the function A*x+B. If the raw value x IS the Load Percent, then set A=1 and
B=0. 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.
batteryPercentage={Battery1,Battery2,Battery3,Line4,Line5}
(Only for KP625AP, Trust, Egys.) A 5 tuple to
convert the raw battery and line data to a human-readable battery and line
percentage reading using the functions (Battery) A*x+B*y+C and (Line) D*x+E.
If the raw value x IS the Battery Percent, then set A=1, B=0, C=0, D=1, E=0.
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.
voltage={240A,240B,120A,120B}
(Only for types KP625AP, Trust, Egys.) A quad
that is used convert the raw voltage data to a human-readable voltage reading
using the function A*x+B. If the raw value x IS HALF the Voltage, then set
A=2, B=0. 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.
DEFAULT VALUES FOR THE EXTRA ARGUMENTS¶
linevoltage = 230 manufacturer = PowerCom modelname = Unknown serialnumber = Unknown type = Trust
Trust¶
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}
KP625AP¶
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}
Egys¶
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}
IMP¶
numOfBytesFromUPS = 16 methodOfFlowControl = no_flow_control validationSequence = {{5,0xFF},{7,0},{8,0}} shutdownArguments = {{1,30},y}
KIN¶
numOfBytesFromUPS = 16 methodOfFlowControl = no_flow_control validationSequence = {{11,0x4b},{8,0},{8,0}} shutdownArguments = {{1,30},y}
BNT¶
numOfBytesFromUPS = 16 methodOfFlowControl = no_flow_control validationSequence = {{11,0x42},{8,0},{8,0}} shutdownArguments = {{1,30},y}
BNT-other¶
numOfBytesFromUPS = 16 methodOfFlowControl = no_flow_control validationSequence = {{8,0},{8,0},{8,0}} shutdownArguments = {{1,30},y} frequency = {0.00027778,0.0000} loadPercentage = {1.0000,0.0,1.0000,0.0} batteryPercentage = {1.0000,0.0000,0.0000,1.0000,0.0000} voltage = {2.0000,0.0000,2.0000,0.0000}
AUTHOR¶
Peter Bieringer <pb@bieringer.de>, Alexey Sidorov <alexsid@altlinux.org>, Keven L. Ates <atescomp@gmail.com>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 |