man powercom (Administration système) - UPS driver for Powercom/Trust/Advice UPS equipment

NAME

powercom - UPS driver for Powercom/Trust/Advice UPS equipment

NOTE

This man page only documents the hardwarespecific 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):

linevoltage=value
An integer specifying the mains voltage. It can't be auto detected. Acceptable values are in the range of 110120 or 220240. 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 KP625AP, Trust, KIN2200AP, Egys, KIN525AP or KIN1500AP. The default is Trust.
numOfBytesFromUPS=value
The number of bytes in a UPS frame. The default is type dependant and is given below.
voltage={coefficient1,coefficient2,coefficient3,coefficient4}
A quad that is used convert the raw data to human readable voltage reading. The default is type dependant and is given below. Do note that the braces and commas are mandatory, as well as the lack of white space characters.
methodOfFlowControl=name
The method of serial communication flow control that is engaged by the UPS. The default is type dependant and is given below. Acceptable names are dtr0rts1, dtr1 or no_flow_control.
frequency={coefficient1,coefficient2}
A pair to convert the raw data to human readable frequency reading. The default is type dependant and is given below. Do note that the braces and commas are mandatory as well, as the lack of white space characters.
batteryPercentage={coefficient1,coefficient2,coefficient3,coefficient4,coefficient5}
A 5 tuple to convert the raw data to human readable battery percentage reading. The default is type dependant and is given below. Do note that the braces and commas are mandatory, as the lack of white space characters.
loadPercentage={coefficient1,coefficient2,coefficient3,coefficient4}
A quad to convert the raw data to human readable load percentage reading. The default is type dependant and is given below. Do note that the braces and commas are mandatory, as the lack of white space characters.
validationSequence={{index1,value1},{index2,value2},{index3,value3}}
3 pairs to be used for validating the UPS by comparing bytes of the raw data with constant values. The default is type dependant and is given below. The braces and commas are mandatory, as the lack of white space characters.
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 dependant and is given below. The braces and commas are mandatory. Note that there should be no white space characters.

DEFAULT VALUES FOR THE EXTRA ARGUMENTS

linevoltage = 230
manufacturer = PowerCom
modelname = Unknown
serialnumber = Unknown
type = Trust

The rest of the default values for the extra arguments are type dependant:

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}
KIN2200AP
numOfBytesFromUPS = 16
methodOfFlowControl = dtr0rts1
validationSequence = {{7,0},{8,0},{8,0}}
shutdownArguments = {{0,10},n}
frequency = {0.00020997,0.0}
loadPercentage = {6.1343,-0.3808,1.075,0.1811}
batteryPercentage = {5.0000,0.3268,-825.00,0.46511,0}
voltage = {1.9216,-0.0977,0.82857,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}
KIN525AP
numOfBytesFromUPS = 16
methodOfFlowControl = dtr1
validationSequence = {{5,0x80},{7,0},{8,0}}
shutdownArguments = {{0,10},y}
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}
KIN1500AP
numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{7,0},{8,0},{8,0}}
shutdownArguments = {{0,10},n}
frequency = {0.00020997,0.0}
loadPercentage = {6.1343,-0.3808,1.075,0.1811}
batteryPercentage = {5.0000,0.3268,-825.00,0.46511,0}
voltage = {1.9216,-0.0977,0.82857,0.0000}

AUTHOR

Peter Bieringer <pb@bieringer.de>

SEE ALSO

The core driver:

Internet resources:

The NUT (Network UPS Tools) home page: http://www.networkupstools.org/