Imported Upstream version 2.7.3
This commit is contained in:
Arnaud Quette
parent
a356b56d11
commit
fd413a3168
283 changed files with 14978 additions and 6511 deletions
|
|
@ -52,7 +52,7 @@ If you set stayoff in linkman:ups.conf[5] when FSD arises the UPS will call a *s
|
|||
|
||||
*protocol =* 'string'::
|
||||
Skip autodetection of the protocol to use and only use the one specified.
|
||||
Supported values: 'mecer', 'megatec', 'megatec/old', 'mustek', 'q1', 'voltronic', 'voltronic-qs' and 'zinto'.
|
||||
Supported values: 'bestups', 'mecer', 'megatec', 'megatec/old', 'mustek', 'q1', 'voltronic', 'voltronic-qs', 'voltronic-qs-hex' and 'zinto'.
|
||||
+
|
||||
Note that if you end up using the 'q1' protocol, you may want to give a try to the 'mecer', 'megatec' and 'zinto' ones setting the <<old-blazer-protocols-options,*novendor*/*norating* flags>> (only one, or both).
|
||||
|
||||
|
|
@ -103,6 +103,14 @@ If not specified, the driver defaults to 10%.
|
|||
Only used if *runtimecal* is also specified.
|
||||
|
||||
|
||||
BESTUPS, MECER, MEGATAEC, MEGATEC/OLD, MUSTEK, Q1, VOLTRONIC-QS, VOLTRONIC-QS-HEX, ZINTO PROTOCOLS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
*ignoresab*::
|
||||
Some UPSes incorrectly report the `Shutdown Active' bit as always on, consequently making the driver believe the UPS is nearing a shutdown (and, as a result, ups.status always contains +FSD+... and you know what this means).
|
||||
Setting this flag will make the driver ignore the `Shutdown Active' bit.
|
||||
|
||||
|
||||
[[old-blazer-protocols-options]]
|
||||
MECER, MEGATAEC, MEGATEC/OLD, MUSTEK, ZINTO PROTOCOLS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
|
@ -122,6 +130,19 @@ Some UPSes will lock up if you attempt to read vendor information from them.
|
|||
Setting this flag will make the driver skip this step.
|
||||
|
||||
|
||||
BESTUPS PROTOCOL
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
*ondelay*::
|
||||
The acceptable range is +60..599940+ seconds.
|
||||
|
||||
*offdelay*::
|
||||
The acceptable range is +12..5940+ seconds.
|
||||
|
||||
*pins_shutdown_mode =* 'value'::
|
||||
Set http://www.networkupstools.org/protocols/sola.html#_shutdown_set_command[shutdown mode functionality of Pin 1 and Pin 7] on the UPS DB9 communication port (Per Best Power’s EPS-0059) to 'value' [+0..6+].
|
||||
|
||||
|
||||
Q1 PROTOCOL
|
||||
~~~~~~~~~~~
|
||||
|
||||
|
|
@ -132,8 +153,8 @@ The acceptable range is +0..599940+ seconds.
|
|||
The acceptable range is +12..600+ seconds.
|
||||
|
||||
|
||||
VOLTRONIC-QS PROTOCOL
|
||||
~~~~~~~~~~~~~~~~~~~~~
|
||||
VOLTRONIC-QS, VOLTRONIC-QS-HEX PROTOCOLS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
*ondelay*::
|
||||
The acceptable range is +60..599940+ seconds.
|
||||
|
|
@ -215,7 +236,7 @@ If enabled, when the UPS is turned on, it will check if the battery is connected
|
|||
Enable or disable site fault detection [+enabled+/+disabled+].
|
||||
If enabled, the UPS will beep when the input neutral and hot wires are reversed.
|
||||
|
||||
*costant_phase_angle =* 'string'::
|
||||
*constant_phase_angle =* 'string'::
|
||||
Enable or disable Constant Phase Angle Function (output and input phase angles are not equal) [+enabled+/+disabled+].
|
||||
|
||||
*limited_runtime_on_battery =* 'string'::
|
||||
|
|
@ -301,7 +322,7 @@ The argument is a regular expression that must match the bus name where the UPS
|
|||
|
||||
*subdriver =* 'string'::
|
||||
Select a serial-over-USB subdriver to use.
|
||||
You have a choice between *phoenix*, *ippon*, *cypress*, and *krauler*.
|
||||
You have a choice between *cypress*, *fabula*, *fuji*, *ippon*, *krauler* and *phoenix*.
|
||||
When using this option, it is mandatory to also specify the *vendorid* and *productid*.
|
||||
|
||||
*langid_fix =* 'value'::
|
||||
|
|
@ -310,6 +331,21 @@ This is mandatory for some devices to work (LDLC, Dynamix and others).
|
|||
You must provide *value* (+0x409+ or +0x4095+), according to your device entry in NUT hardware compatibility list (HCL).
|
||||
|
||||
|
||||
IMPLEMENTATION NOTES
|
||||
^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
*'fabula' subdriver*::
|
||||
This subdriver, meant to be used with the 'megatec' protocol, does *not* support the various *test.battery* commands.
|
||||
Plus, the *shutdown.return* command ignores the values set in 'ups.delay.start'/*ondelay* and makes the UPS turn on the load as soon as power is back.
|
||||
|
||||
*'fuji' subdriver*::
|
||||
This subdriver, meant to be used with the 'megatec' protocol, does *not* support the *shutdown.stayoff* and *load.off* commands.
|
||||
Plus, the *shutdown.return* command ignores the values set in 'ups.delay.start'/*ondelay* and makes the UPS turn on the load as soon as power is back.
|
||||
|
||||
*'krauler' subdriver*::
|
||||
This subdriver, meant to be used with the 'megatec' protocol, does *not* support the shutdown commands, i.e.: *shutdown.return*, *shutdown.stayoff* and *load.off*.
|
||||
|
||||
|
||||
UPS COMMANDS
|
||||
------------
|
||||
|
||||
|
|
@ -321,6 +357,7 @@ Toggle the UPS beeper.
|
|||
|
||||
*load.on*::
|
||||
Turn on the load immediately.
|
||||
(Not available on some hardware)
|
||||
|
||||
*load.off*::
|
||||
Turn off the load immediately (see <<_known_problems,KNOWN PROBLEMS>>).
|
||||
|
|
@ -348,8 +385,8 @@ Stop a running battery test.
|
|||
(Not available on some hardware)
|
||||
|
||||
|
||||
MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, ZINTO PROTOCOLS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
BESTUPS, MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, ZINTO PROTOCOLS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
*test.battery.start* 'value'::
|
||||
Perform a battery test for the duration of 'value' seconds (truncated to 60 seconds) [+60..5940+].
|
||||
|
|
@ -470,6 +507,21 @@ The following instant command has also been changed:
|
|||
While the old blazer drivers expected a 'value' in minutes, the *nutdrv_qx* driver wants a 'value' in seconds.
|
||||
|
||||
|
||||
NOTES FOR THE PREVIOUS USER OF BESTUPS DRIVER
|
||||
---------------------------------------------
|
||||
|
||||
The *nutdrv_qx* driver having replaced the bestups one, some configuration changes may be required by users switching to *nutdrv_qx*.
|
||||
|
||||
Part of this, the following bestups options, in linkman:ups.conf[5], are no longer supported by this driver:
|
||||
|
||||
*nombattvolt*::
|
||||
*battvoltmult*::
|
||||
See <<_battery_charge,BATTERY CHARGE>>.
|
||||
|
||||
*ID*::
|
||||
Discarded.
|
||||
|
||||
|
||||
NOTES FOR THE PREVIOUS USER OF VOLTRONIC DRIVERS
|
||||
------------------------------------------------
|
||||
|
||||
|
|
@ -593,6 +645,12 @@ After issuing a *shutdown.return* instant command, the UPS won't wait *ondelay*
|
|||
In this case, as soon as mains returns the load will be powered.
|
||||
|
||||
|
||||
VOLTRONIC-QS-HEX UNITS
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
*shutdown.return*, *load.off*, and *shutdown.stayoff* instant commands are known to work as expected only if mains is present, otherwise, as soon as mains returns the load will be powered.
|
||||
|
||||
|
||||
UPS WARNINGS (VOLTRONIC PROTOCOL)
|
||||
---------------------------------
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue