.TH BESTUPS 8 "Fri Dec 26 2003" "" "Network UPS Tools (NUT)" 
.SH NAME  
bestups \- Driver for Best Power / SOLA (Phoenixtec protocol) UPS equipment
.SH NOTE
This man page only documents the hardware-specific features of the
bestups driver.  For information about the core driver, see  
\fBnutupsdrv\fR(8).

.SH 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.  

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.

.SH EXTRA ARGUMENTS

This driver supports the following optional settings in the
\fBups.conf\fR(5):

.IP "nombattvolt=\fInum\fR"

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.

.SH 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 
\fBups.conf\fR(8) to fix this.

.SH AUTHOR
Russell Kroll

.SH SEE ALSO

.SS The core driver:
\fBnutupsdrv\fR(8)

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