Imported Upstream version 2.6.1
This commit is contained in:
Arnaud Quette
parent
459aaf9392
commit
a367d9bc54
178 changed files with 4651 additions and 3279 deletions
|
|
@ -24,84 +24,85 @@ This driver supports the following optional settings in the
|
|||
linkman:ups.conf[5] file:
|
||||
|
||||
*linevoltage*='value'::
|
||||
An integer specifying the mains voltage. It can't be auto detected.
|
||||
Acceptable values are in the range of 110--120 or 220--240. The default
|
||||
is '230'.
|
||||
An integer specifying the line voltage. It can't be auto detected. Acceptable
|
||||
values are in the range of 110-120 or 220-240. The default is '230'.
|
||||
|
||||
*manufacturer*='name'::
|
||||
Specify the manufacturer name, which also can't be auto detected. This is
|
||||
a user defined string, so any name is acceptable. The default is
|
||||
'PowerCom'.
|
||||
Specify the manufacturer name, which also can't be auto detected. This is a
|
||||
user defined string, so any name is acceptable. The default is 'PowerCom'.
|
||||
|
||||
*modelname*='name'::
|
||||
Specify the model name, which also can't be auto detected. This is a
|
||||
user defined string, so any name is acceptable. The default is
|
||||
'Unknown'.
|
||||
Specify the model name, which also can't be auto detected. This is a user
|
||||
defined string, so any name is acceptable. The default is 'Unknown'.
|
||||
|
||||
*serialnumber*='value'::
|
||||
Like modelname above, but for the serial number. The default is
|
||||
'Unknown'.
|
||||
Like modelname above, but for the serial number. The default is 'Unknown'.
|
||||
|
||||
*type*='name'::
|
||||
The exact type of the communication protocol within the powercom family,
|
||||
that will be used to communicate with the UPS. The type is named after
|
||||
the first modelname that was coded with that protocol. The acceptable
|
||||
names are 'KP625AP', 'Trust', 'Egys', 'KIN', 'BNT', 'IMP' and 'BNT-other'. The
|
||||
default is 'Trust'.
|
||||
The exact type of the communication protocol within the powercom family, that
|
||||
will be used to communicate with the UPS. The type is named after the first
|
||||
modelname that was coded with that protocol. The acceptable names are
|
||||
'Trust', 'Egys', 'KP625AP', 'IMP', 'KIN', 'BNT', and 'BNT-other'.
|
||||
The default is 'Trust'.
|
||||
+
|
||||
'BNT-other' is a special type for BNT 100-120V models.
|
||||
For this type you can (I think must!) specify voltage, batteryPercentage,
|
||||
loadPercentage and validationSequence.
|
||||
|
||||
*numOfBytesFromUPS*='value'::
|
||||
The number of bytes in a UPS frame. The default is type-dependent and
|
||||
is given below.
|
||||
|
||||
*methodOfFlowControl*='name'::
|
||||
The method of serial communication flow control that is engaged by the
|
||||
UPS. The default is type-dependent and is given below. Acceptable names
|
||||
are 'dtr0rts1', 'dtr1' or 'no_flow_control'.
|
||||
'BNT-other' is a special type for other BNT models (such as the 1500A at 120V
|
||||
and can be used to override ALL models using ALL of the following values.
|
||||
|
||||
*shutdownArguments*={{'minutes','seconds'},'whether_minutes_should_be_used'}::
|
||||
The minutes and seconds that the UPS should wait between receiving the
|
||||
shutdown command and actually shutting off. The other argument should
|
||||
be set to the character 'n' only when the minutes value should be
|
||||
skipped and not sent to the UPS. The default is type-dependent and is
|
||||
given below. The braces and commas are mandatory. Note that there should
|
||||
be no whitespace characters.
|
||||
shutdown command and actually shutting off. The other argument should be set
|
||||
to the character 'n' only when the minutes value should be skipped and not
|
||||
sent to the UPS. The default is type-dependent and is given below. The braces
|
||||
and commas are mandatory. Note that there should be no whitespace characters.
|
||||
|
||||
*voltage*={'coefficient1','coefficient2','coefficient3','coefficient4'}::
|
||||
(Only for types KP625AP, Trust, Egys, BNT-other.)
|
||||
A quad that is used convert the raw data to a human-readable voltage
|
||||
reading. The default is type-dependent and is given below. Do note that
|
||||
the braces and commas are mandatory, as well as the lack of whitespace
|
||||
characters.
|
||||
*numOfBytesFromUPS*='value'::
|
||||
The number of bytes in a UPS frame: 16 is common, 11 for 'Trust'. The default
|
||||
is type-dependent and is given below.
|
||||
|
||||
*frequency*={'coefficient1','coefficient2'}::
|
||||
(Only for types KP625AP, Trust, Egys.)
|
||||
A pair to convert the raw data to a human-readable frequency reading. The
|
||||
default is type-dependent and is given below. Do note that the braces
|
||||
and commas are mandatory as well, as the lack of whitespace characters.
|
||||
|
||||
*batteryPercentage*={'coefficient1','coefficient2','coefficient3','coefficient4','coefficient5'}::
|
||||
(Only for KP625AP, Trust, Egys, BNT-other.)
|
||||
A 5 tuple to convert the raw data to a human-readable battery percentage
|
||||
reading. The default is type-dependent and is given below. Do note that
|
||||
the braces and commas are mandatory, as the lack of white space
|
||||
characters.
|
||||
|
||||
*loadPercentage*={'coefficient1','coefficient2','coefficient3','coefficient4'}::
|
||||
(Only for types KP625AP, Trust, Egys, BNT-other.)
|
||||
A quad to convert the raw data to human readable load percentage
|
||||
reading. The default is type-dependent and is given below. Do note that
|
||||
the braces and commas are mandatory, as the lack of white space
|
||||
characters.
|
||||
*methodOfFlowControl*='name'::
|
||||
The method of serial communication flow control that is engaged by the UPS.
|
||||
The default is type-dependent and is given below. Acceptable names are
|
||||
'dtr0rts1', 'dtr1' or 'no_flow_control'.
|
||||
|
||||
*validationSequence*={{'index1','value1'},{'index2','value2'},{'index3','value3'}}::
|
||||
(Only for types KP625AP, Trust, Egys, BNT-other.)
|
||||
3 pairs to be used for validating the UPS by comparing bytes of the raw
|
||||
data with constant values. The default is type-dependent and is given
|
||||
below. The braces and commas are mandatory, as the lack of white space
|
||||
(Only for types KP625AP, Trust, Egys.)
|
||||
3 pairs to be used for validating the UPS by comparing bytes of the raw data
|
||||
with constant values. The index selects the byte from the UPS (see
|
||||
numOfBytesFromUPS) and the value is for matching to the byte. The default is
|
||||
type-dependent and is given below. The braces and commas are mandatory, as
|
||||
the lack of white space characters.
|
||||
|
||||
*frequency*={'A','B'}::
|
||||
(Only for types KP625AP, Trust, Egys.)
|
||||
A pair to convert the raw frequency data to a human-readable frequency
|
||||
reading using the function 1/(A*x+B). If the raw value x IS the frequency,
|
||||
then set A=1/(x^2) and B=0. The default is type-dependent and is given below.
|
||||
Do note that the braces and commas are mandatory as well, as the lack of
|
||||
whitespace characters.
|
||||
|
||||
*loadPercentage*={'BatteryA','BatteryB','LineA','LineB'}::
|
||||
(Only for types KP625AP, Trust, Egys.)
|
||||
A quad to convert the raw load data to human readable load percentage reading
|
||||
using the function A*x+B. If the raw value x IS the Load Percent, then set
|
||||
A=1 and B=0. The default is type-dependent and is given below. Do note that
|
||||
the braces and commas are mandatory, as the lack of white space
|
||||
characters.
|
||||
|
||||
*batteryPercentage*={'Battery1','Battery2','Battery3','Line4','Line5'}::
|
||||
(Only for KP625AP, Trust, Egys.)
|
||||
A 5 tuple to convert the raw battery and line data to a human-readable
|
||||
battery and line percentage reading using the functions (Battery)
|
||||
A*x+B*y+C and (Line) D*x+E. If the raw value x IS the Battery Percent, then
|
||||
set A=1, B=0, C=0, D=1, E=0. The default is type-dependent and is given below.
|
||||
Do note that the braces and commas are mandatory, as the lack of white space
|
||||
characters.
|
||||
|
||||
*voltage*={'240A','240B','120A','120B'}::
|
||||
(Only for types KP625AP, Trust, Egys.)
|
||||
A quad that is used convert the raw voltage data to a human-readable voltage
|
||||
reading using the function A*x+B. If the raw value x IS HALF the Voltage,
|
||||
then set A=2, B=0. The default is type-dependent and is given below. Do note
|
||||
that the braces and commas are mandatory, as well as the lack of whitespace
|
||||
characters.
|
||||
|
||||
DEFAULT VALUES FOR THE EXTRA ARGUMENTS
|
||||
|
|
@ -112,7 +113,9 @@ DEFAULT VALUES FOR THE EXTRA ARGUMENTS
|
|||
serialnumber = Unknown
|
||||
type = Trust
|
||||
|
||||
The rest of the default values for the extra arguments are type-dependent:
|
||||
The rest of the default values for the extra arguments are type-dependent.
|
||||
However, 'BNT-other' is a special type that can be used to override ALL
|
||||
values for ALL models.
|
||||
|
||||
Trust
|
||||
~~~~~
|
||||
|
|
@ -136,10 +139,8 @@ KP625AP
|
|||
batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
|
||||
voltage = {1.9216,-0.0977,0.9545,0.0000}
|
||||
|
||||
|
||||
Egys
|
||||
~~~~
|
||||
|
||||
numOfBytesFromUPS = 16
|
||||
methodOfFlowControl = no_flow_control
|
||||
validationSequence = {{5,0x80},{7,0},{8,0}}
|
||||
|
|
@ -149,49 +150,43 @@ Egys
|
|||
batteryPercentage = {5.0000,0.3268,-825.00,2.2105,-355.37}
|
||||
voltage = {1.9216,-0.0977,0.9545,0.0000}
|
||||
|
||||
|
||||
IMP
|
||||
~~~
|
||||
|
||||
numOfBytesFromUPS = 16
|
||||
methodOfFlowControl = no_flow_control
|
||||
validationSequence = {{5,0xFF},{7,0},{8,0}}
|
||||
shutdownArguments = {{1,30},y}
|
||||
|
||||
|
||||
KIN
|
||||
~~~
|
||||
|
||||
numOfBytesFromUPS = 16
|
||||
methodOfFlowControl = no_flow_control
|
||||
validationSequence = {{11,0x4b},{8,0},{8,0}}
|
||||
shutdownArguments = {{1,30},y}
|
||||
|
||||
|
||||
BNT
|
||||
~~~
|
||||
|
||||
numOfBytesFromUPS = 16
|
||||
methodOfFlowControl = no_flow_control
|
||||
validationSequence = {{11,0x42},{8,0},{8,0}}
|
||||
shutdownArguments = {{1,30},y}
|
||||
|
||||
|
||||
BNT-other
|
||||
~~~~~~~~~
|
||||
|
||||
numOfBytesFromUPS = 16
|
||||
methodOfFlowControl = no_flow_control
|
||||
validationSequence = {{8,0},{8,0},{8,0}}
|
||||
shutdownArguments = {{1,30},y}
|
||||
loadPercentage = {1.4474,0.0,0.8594,0.0}
|
||||
batteryPercentage = {5.0000,0.3268,-825.00,0.46511,0}
|
||||
voltage = {1.9216,-0.0977,0.82857,0.0000}
|
||||
frequency = {0.00027778,0.0000}
|
||||
loadPercentage = {1.0000,0.0,1.0000,0.0}
|
||||
batteryPercentage = {1.0000,0.0000,0.0000,1.0000,0.0000}
|
||||
voltage = {2.0000,0.0000,2.0000,0.0000}
|
||||
|
||||
AUTHOR
|
||||
------
|
||||
Peter Bieringer <pb@bieringer.de>,
|
||||
Alexey Sidorov <alexsid@altlinux.org>
|
||||
Alexey Sidorov <alexsid@altlinux.org>,
|
||||
Keven L. Ates <atescomp@gmail.com>
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue