1BESTUPS(8) Network UPS Tools (NUT) BESTUPS(8)
2
6 bestups - Driver for Best Power / SOLA (Phoenixtec protocol) UPS equip‐
7 ment
8
10 This man page only documents the hardware‐specific features of the
11 bestups driver. For information about the core driver, see nutups‐
12 drv(8).
13
16 bestups was designed to monitor Best Power UPS hardware like the
17 Fortress, Fortress Telecom, Axxium Rackmount and Patriot Pro. It also
18 recognizes and supports SOLA units such as the 325, 520 and 620. In
19 addition, the Best 610 is supported using the `ID' option.
20 Other UPS hardware using the Phoenixtec protocol should also work, but
22 they will generate a warning since their battery information is not
23 known.
24 This driver does not support some older Best/SOLA units.
26
29 This driver supports the following optional settings in the
30 ups.conf(5):
31 nombattvolt=num
34 Override the nominal battery voltage which is normally deter‐
36 mined by asking the hardware. This is useful if your UPS con‐
37 stantly reports battery.charge values just below 100% even when
38 it's completely charged.
39 If you have this problem, set this to whatever battery.voltage
41 reports when the UPS is known to be completely charged with a
42 good battery.
43 The author's Best Fortress 750 uses nombattvolt=27.4.
45 ID=string
48 Set the Identification response string. This should only be
50 used with hardware that supports the Phoenixtec protocol status
51 inquiry commands, but not the "ID" command, such as the
52 Best/SOLA 610. Format of the ID string is:
53 AAA,BBBB,CCC,DDD,EE.E,FF.F
54 AAA is the three-character identification for the UPS model.
56 BBBB is the output power in VA (volt amperes). B is an integer
58 number ranging from 0 to 9.
59 CCC is the Nominal Input Voltage. C is an integer number ranging
61 from 0 to 9. The unit is Volts AC.
62 DDD is the Nominal Output Voltage. D is an integer number rang‐
64 ing from 0 to 9. The unit is Volts AC.
65 EE.E is the Battery Voltage that will cause the UPS to shut
67 itself off. E is an integer number ranging from 0 to 9. Then
68 unit is Volts DC and a decimal point is present.
69 FF.F or FFF.F is the Battery Voltage at full charge. F is an
71 integer number ranging from 0 to 9. Then unit is Volts DC. Typi‐
72 cally, for 700VA, 1KVA and 1.5KVA units, the format is FF.F. For
73 2KVA and 3KVA units, the format is FFF.F.
74 Example: a Best 610 1.5KVA unit would use the string
76 "610,1500,120,120,10.0,48.0".
77
80 The battery charge percentage value (in battery.charge) is derived from
81 the voltage data that the UPS returns, since the UPS doesn't return
82 that value directly. On some hardware, the charge will remain at 100%
83 for a long time and then drops quickly shortly before the battery runs
84 out. You can confirm from the battery.voltage readings that this is a
85 problem with the UPS and not this driver.
86 Similarly, the float from the charger in some models forces the battery
88 charge percentage back up to 100% immedately after the UPS goes back
89 on‐line, so you can't tell when it is really recharged.
90 Finally, some models give one value for the battery's nominal voltage
92 and yet actually have a nominal voltage slightly below that. This
93 leads to things such as the perpetual 98.7% charge on the author's
94 Fortress 750, even when it's been charging for weeks. You can use nom‐
95 battvolt= in ups.conf(8) to fix this.
96
99 Russell Kroll, Jason White
100
103 The core driver:
104 nutupsdrv(8)
105 Internet resources:
108 The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
109 Wed Jul 28 2004 BESTUPS(8)