powercom(8)

1POWERCOM(8)                 Network UPS Tools (NUT)                POWERCOM(8)
2
3
4

NAME

6       powercom - UPS driver for Powercom/Trust/Advice UPS equipment
7
8

NOTE

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

SUPPORTED HARDWARE

15       This driver supports many similar kinds of UPS hardware.  The most com‐
16       mon  ones  are  the  Trust  425/625,  Powercom, and Advice Partner/King
17       PR750.  Others using the same protocol may also work.
18
19

EXTRA ARGUMENTS

21       This  driver  supports  the  following   optional   settings   in   the
22       ups.conf(5):
23
24
25       linevoltage=value
26              An  integer  specifying  the  mains  voltage.  It  can't be auto
27              detected.  Acceptable values are in  the  range  of  110‐120  or
28              220‐240. The default is 230.
29
30
31       manufacturer=name
32              Specify   the  manufacturer  name,  which  also  can't  be  auto
33              detected. This is a user defined string so any name  is  accept‐
34              able. The default is PowerCom.
35
36
37       modelname=name
38              Specify  the model name, which also can't be auto detected. This
39              is a user defined string so any name is acceptable. The  default
40              is Unknown.
41
42
43       serialnumber=value
44              Like  modelname above, but for the serial number. The default is
45              Unknown.
46
47
48       type=name
49              The exact type of the communication protocol within the powercom
50              family,  that will be used to communicate with the UPS. The type
51              is named after the first modelname that was coded with that pro‐
52              tocol. The acceptable names are KP625AP, Trust, KIN2200AP, Egys,
53              KIN525AP or KIN1500AP. The default is Trust.
54
55
56       numOfBytesFromUPS=value
57              The number of bytes in a UPS frame. The default is  type  depen‐
58              dant and is given below.
59
60
61       voltage={coefficient1,coefficient2,coefficient3,coefficient4}
62              A quad that is used convert the raw data to human readable volt‐
63              age reading. The default is type dependant and is  given  below.
64              Do note that the braces and commas are mandatory, as well as the
65              lack of white space characters.
66
67
68       methodOfFlowControl=name
69              The method of serial communication flow control that is  engaged
70              by  the  UPS.  The default is type dependant and is given below.
71              Acceptable names are dtr0rts1, dtr1 or no_flow_control.
72
73
74       frequency={coefficient1,coefficient2}
75              A pair to convert the raw data to human readable frequency read‐
76              ing.  The  default is type dependant and is given below. Do note
77              that the braces and commas are mandatory as well, as the lack of
78              white space characters.
79
80
81       batteryPercentage={coefficient1,coefficient2,coefficient3,coeffi‐
82       cient4,coefficient5}
83              A 5 tuple to convert the raw data to human readable battery per‐
84              centage  reading.  The  default  is  type dependant and is given
85              below. Do note that the braces and commas are mandatory, as  the
86              lack of white space characters.
87
88
89       loadPercentage={coefficient1,coefficient2,coefficient3,coefficient4}
90              A quad to convert the raw data to human readable load percentage
91              reading. The default is type dependant and is  given  below.  Do
92              note  that  the  braces and commas are mandatory, as the lack of
93              white space characters.
94
95
96       validationSequence={{index1,value1},{index2,value2},{index3,value3}}
97              3 pairs to be used for validating the UPS by comparing bytes  of
98              the raw data with constant values. The default is type dependant
99              and is given below. The braces and commas are mandatory, as  the
100              lack of white space characters.
101
102
103       shutdownArguments={{minutes,seconds},whether_minutes_should_be_used}
104              The minutes and seconds that the UPS should wait between receiv‐
105              ing the shutdown command and actually shutting  off.  The  other
106              argument  should be set to the character n only when the minutes
107              value should be skipped and not sent to the UPS. The default  is
108              type  dependant  and  is  given below. The braces and commas are
109              mandatory. Note that there should be no white space characters.
110
111

DEFAULT VALUES FOR THE EXTRA ARGUMENTS

113       linevoltage = 230
114
115       manufacturer = PowerCom
116
117       modelname = Unknown
118
119       serialnumber = Unknown
120
121       type = Trust
122
123
124       The rest of the default values for the extra arguments are type  depen‐
125       dant:
126
127
128       Trust
129
130              numOfBytesFromUPS = 11
131
132              methodOfFlowControl = dtr0rts1
133
134              validationSequence = {{5,0},{7,0},{8,0}}
135
136              shutdownArguments = {{0,10},n}
137
138              frequency = {0.00020997,0.00020928}
139
140              loadPercentage = {6.1343,-0.3808,4.3110,0.1811}
141
142              batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
143
144              voltage = {1.9216,-0.0977,0.9545,0.0000}
145
146
147       KP625AP
148
149              numOfBytesFromUPS = 16
150
151              methodOfFlowControl = dtr0rts1
152
153              validationSequence = {{5,0x80},{7,0},{8,0}}
154
155              shutdownArguments = {{0,10},n}
156
157              frequency = {0.00020997,0.00020928}
158
159              loadPercentage = {6.1343,-0.3808,4.3110,0.1811}
160
161              batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
162
163              voltage = {1.9216,-0.0977,0.9545,0.0000}
164
165
166       KIN2200AP
167
168              numOfBytesFromUPS = 16
169
170              methodOfFlowControl = dtr0rts1
171
172              validationSequence = {{7,0},{8,0},{8,0}}
173
174              shutdownArguments = {{0,10},n}
175
176              frequency = {0.00020997,0.0}
177
178              loadPercentage = {6.1343,-0.3808,1.075,0.1811}
179
180              batteryPercentage = {5.0000,0.3268,-825.00,0.46511,0}
181
182              voltage = {1.9216,-0.0977,0.82857,0.0000}
183
184
185       Egys
186
187              numOfBytesFromUPS = 16
188
189              methodOfFlowControl = no_flow_control
190
191              validationSequence = {{5,0x80},{7,0},{8,0}}
192
193              shutdownArguments = {{0,10},n}
194
195              frequency = {0.00020997,0.00020928}
196
197              loadPercentage = {6.1343,-0.3808,1.3333,0.6667}
198
199              batteryPercentage = {5.0000,0.3268,-825.00,2.2105,-355.37}
200
201              voltage = {1.9216,-0.0977,0.9545,0.0000}
202
203
204       KIN525AP
205
206              numOfBytesFromUPS = 16
207
208              methodOfFlowControl = dtr1
209
210              validationSequence = {{5,0x80},{7,0},{8,0}}
211
212              shutdownArguments = {{0,10},y}
213
214              frequency = {0.00020997,0.00020928}
215
216              loadPercentage = {6.1343,-0.3808,4.3110,0.1811}
217
218              batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
219
220              voltage = {1.9216,-0.0977,0.9545,0.0000}
221
222
223       KIN1500AP
224
225              numOfBytesFromUPS = 16
226
227              methodOfFlowControl = no_flow_control
228
229              validationSequence = {{7,0},{8,0},{8,0}}
230
231              shutdownArguments = {{0,10},n}
232
233              frequency = {0.00020997,0.0}
234
235              loadPercentage = {6.1343,-0.3808,1.075,0.1811}
236
237              batteryPercentage = {5.0000,0.3268,-825.00,0.46511,0}
238
239              voltage = {1.9216,-0.0977,0.82857,0.0000}
240
241

AUTHOR

243       Peter Bieringer <pb@bieringer.de>
244
245

NAME

NOTE

SUPPORTED HARDWARE

EXTRA ARGUMENTS

DEFAULT VALUES FOR THE EXTRA ARGUMENTS

AUTHOR

SEE ALSO