POWERCOM(8)                       NUT Manual                       POWERCOM(8)



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

NOTE
       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=value
           An 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

       The rest of the default values for the extra arguments are
       type-dependent. However, BNT-other is a special type that can be used
       to override ALL values for ALL models.

   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/



Network UPS Tools                 10/09/2011                       POWERCOM(8)
