Provided by: nut_2.0.3-4build1_i386 bug

NAME

       bestups  -  Driver  for  Best  Power  /  SOLA (Phoenixtec protocol) UPS
       equipment

NOTE

       This man page only documents  the  hardware‐specific  features  of  the
       bestups   driver.    For   information   about  the  core  driver,  see
       nutupsdrv(8).

SUPPORTED HARDWARE

       bestups was designed to  monitor  Best  Power  UPS  hardware  like  the
       Fortress,  Fortress Telecom, Axxium Rackmount and Patriot Pro.  It also
       recognizes and supports SOLA units such as the 325, 520  and  620.   In
       addition, the Best 610 is supported using the ‘ID’ option.

       Other  UPS hardware using the Phoenixtec protocol should also work, but
       they will generate a warning since their  battery  information  is  not
       known.

       This driver does not support some older Best/SOLA units.

EXTRA ARGUMENTS

       This   driver   supports   the   following  optional  settings  in  the
       ups.conf(5):

       nombattvolt=num

              Override  the  nominal  battery  voltage   which   is   normally
              determined  by  asking the hardware.  This is useful if your UPS
              constantly reports battery.charge values just  below  100%  even
              when it’s completely charged.

              If  you  have this problem, set this to whatever battery.voltage
              reports when the UPS is known to be completely  charged  with  a
              good battery.

              The author’s Best Fortress 750 uses nombattvolt=27.4.

       ID=string

              Set  the  Identification  response  string.  This should only be
              used with hardware that supports the Phoenixtec protocol  status
              inquiry  commands,  but  not  the  "ID"  command,  such  as  the
              Best/SOLA    610.     Format    of    the    ID    string    is:
              AAA,BBBB,CCC,DDD,EE.E,FF.F

              AAA is the three-character identification for the UPS model.

              BBBB  is  the output power in VA (volt amperes). B is an integer
              number ranging from 0 to 9.

              CCC is the Nominal Input Voltage. C is an integer number ranging
              from 0 to 9. The unit is Volts AC.

              DDD  is  the  Nominal  Output  Voltage.  D  is an integer number
              ranging from 0 to 9. The unit is Volts AC.

              EE.E is the Battery Voltage that will  cause  the  UPS  to  shut
              itself  off.   E  is an integer number ranging from 0 to 9. Then
              unit is Volts DC and a decimal point is present.

              FF.F or FFF.F is the Battery Voltage at full  charge.  F  is  an
              integer  number  ranging  from  0  to  9. Then unit is Volts DC.
              Typically, for 700VA, 1KVA and 1.5KVA units, the format is FF.F.
              For 2KVA and 3KVA units, the format is FFF.F.

              Example:   a   Best   610  1.5KVA  unit  would  use  the  string
              "610,1500,120,120,10.0,48.0".

BUGS

       The battery charge percentage value (in battery.charge) is derived from
       the  voltage  data  that  the UPS returns, since the UPS doesn’t return
       that value directly.  On some hardware, the charge will remain at  100%
       for  a long time and then drops quickly shortly before the battery runs
       out.  You can confirm from the battery.voltage readings that this is  a
       problem with the UPS and not this driver.

       Similarly, the float from the charger in some models forces the battery
       charge percentage back up to 100% immedately after the  UPS  goes  back
       on‐line, so you can’t tell when it is really recharged.

       Finally,  some  models give one value for the battery’s nominal voltage
       and yet actually have a nominal  voltage  slightly  below  that.   This
       leads  to  things  such  as  the perpetual 98.7% charge on the author’s
       Fortress 750, even when it’s been charging  for  weeks.   You  can  use
       nombattvolt= in ups.conf(8) to fix this.

AUTHOR

       Russell Kroll, Jason White

SEE ALSO

   The core driver:
       nutupsdrv(8)

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

                                Wed Jul 28 2004                     BESTUPS(8)