bestups(8)

1BESTUPS(8)                        NUT Manual                        BESTUPS(8)
2
3
4

NAME

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

NOTE

10       This man page only documents the hardware-specific features of the
11       bestups driver. For information about the core driver, see
12       nutupsdrv(8).
13

NOTE

15       Please note that this driver is deprecated and will not receive new
16       development. If it works for managing your devices — fine, but if you
17       are running it to try setting up a new device, please consider the
18       newer nutdrv_qx(8) instead, which should handle all Q* protocol
19       variants for NUT.
20
21       Please do also report if your device works with this driver, but
22       nutdrv_qx(8) would not actually support it with any subdriver!
23

SUPPORTED HARDWARE

25       bestups was designed to monitor Best Power UPS hardware like the
26       Fortress, Fortress Telecom, Axxium Rackmount and Patriot Pro. It also
27       recognizes and supports SOLA units such as the 325, 520 and 620. In
28       addition, the Best 610 is supported using the ‘ID’ option.
29
30       Other UPS hardware using the Phoenixtec protocol should also work, but
31       they will generate a warning since their battery information is not
32       known.
33
34       This driver does not support some older Best/SOLA units.
35

EXTRA ARGUMENTS

37       This driver supports the following optional settings in the
38       ups.conf(5):
39
40       nombattvolt=num
41           Override the battery float voltage which is normally determined by
42           asking the hardware. This is useful if your UPS constantly reports
43           battery.charge values just below 100% even when it’s completely
44           charged.
45
46           If you have this problem, set this to whatever battery.voltage
47           reports when the UPS is known to be completely charged with a good
48           battery.
49
50           The author’s Best Fortress 750 uses nombattvolt=27.4.
51
52       battvoltmult=num
53           Multiply the reported battery voltage by this number. Some devices
54           report only a fraction of the total battery voltage.
55
56           For example, the SOLA 610 700VA UPS (with a 24V battery) reports
57           the single cell voltage (about 2.27V when fully charged). In this
58           particular case you can set battvoltmult = 12 in ups.conf(8) to fix
59           this.
60
61       ID=string
62           Set the Identification response string. This should only be used
63           with hardware that supports the Phoenixtec protocol status inquiry
64           commands, but not the "ID" command, such as the Best/SOLA 610.
65           Format of the ID string is: AAA,BBBB,CCC,DDD,EE.E,FF.F
66
67           AAA is the three-character identification for the UPS model.
68
69           BBBB is the output power in VA (volt amperes). B is an integer
70           number ranging from 0 to 9.
71
72           CCC is the Nominal Input Voltage. C is an integer number ranging
73           from 0 to 9. The unit is Volts AC.
74
75           DDD is the Nominal Output Voltage. D is an integer number ranging
76           from 0 to 9. The unit is Volts AC.
77
78           EE.E is the Battery Voltage that will cause the UPS to shut itself
79           off. E is an integer number ranging from 0 to 9. Then unit is Volts
80           DC and a decimal point is present.
81
82           FF.F or FFF.F is the Battery Voltage at full charge. F is an
83           integer number ranging from 0 to 9. Then unit is Volts DC.
84           Typically, for 700VA, 1KVA and 1.5KVA units, the format is FF.F.
85           For 2KVA and 3KVA units, the format is FFF.F.
86
87           Example: a Best 610 1.5KVA unit would use the string
88           "610,1500,120,120,10.0,48.0".
89

BUGS

91       The battery charge percentage value (in battery.charge) is derived from
92       the voltage data that the UPS returns, since the UPS doesn’t return
93       that value directly. On some hardware, the charge will remain at 100%
94       for a long time and then drops quickly shortly before the battery runs
95       out. You can confirm from the battery.voltage readings that this is a
96       problem with the UPS and not this driver.
97
98       Similarly, the float from the charger in some models forces the battery
99       charge percentage back up to 100% immediately after the UPS goes back
100       on-line, so you can’t tell when it is really recharged.
101
102       Finally, some models give one value for the battery’s nominal voltage
103       and yet actually have a nominal voltage slightly below that. This leads
104       to things such as the perpetual 98.7% charge on the author’s Fortress
105       750, even when it’s been charging for weeks. You can use nombattvolt=
106       in ups.conf(8) to fix this.
107

AUTHORS

109       •   Russell Kroll
110
111       •   Jason White
112