Provided by: nut_2.0.3-4build1_i386 bug

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):

       linevoltage=value
              An integer specifying  the  mains  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  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:
       nutupsdrv(8)

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

                                Mon Jul 14 2003                    POWERCOM(8)