NOTE

       This man page only documents  the  hardware-specific  features  of  the
       bestups  driver.   For  information  about the core driver, see nutups-
       drv(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  deter-
              mined  by  asking the hardware.  This is useful if your UPS con-
              stantly 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.


              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 nom-
       battvolt= 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)