1mge-utalk(8) Network UPS Tools (NUT) mge-utalk(8)
2
3
4
6 mge‐utalk - Driver for MGE UPS SYSTEMS UTalk protocol hardware
7
9 This man page only documents the hardware‐specific features of the mge‐
10 utalk driver. For information about the core driver, see nutupsdrv(8).
11
12
14 mge‐utalk supports the following legacy units, using the MGE UTalk pro‐
15 tocol:
16
17 Pulsar ESV+,
18 Pulsar ES+,
19 Pulsar EL,
20 Pulsar EX,
21 Pulsar EXtreme,
22 Comet EXtreme,
23 Comet (Utalk Serial Card, ref 66060),
24 Galaxy (Utalk Serial Card, ref 66060).
25
26 This driver also support some newer models with backward UTalk compati‐
27 bility, such as Pulsar Evolution and Pulsar EXtreme C. As these models
28 also support the SHUT protocol, prefer mge-shut for serial communica‐
29 tion, or use the USB port, if available, with the newhidups driver.
30
31
33 This driver supports the following optional settings in the
34 ups.conf(5):
35
36
37 lowbatt=value
38 Low battery level below which LB is raised, in % (default 30%)
39
40
41 ondelay=value
42 Set delay before startup, in minutes (default 1 minute)
43
44
45 offdelay=value
46 Delay before shutdown, in seconds (default 120 seconds)
47
48
49 oldmac Set this flag if you are running Linux on an Oldworld Macintosh
50 box (all beige Apple Macintosh). This might also be needed for
51 other OSs (like *BSD) running on PowerMac.
52
53
55 Not all MGE UPS models provide all possible information, settings and
56 commands. mge‐utalk checks on startup which variables and commands are
57 available from the UPS, and re‐reads these regularly. Thus, startup is
58 a bit slow, but this should not matter much.
59
60 mge‐utalk.h defines a struct array that tells the driver how to read
61 variables from the UPS and publish them as NUT data.
62
63 "ups.status" variable is not included in this array, since it contains
64 information that requires several calls to the UPS and more advanced
65 analysis of the reponses. The function get_ups_status does this job.
66
67 Note that MGE enumerates the status "bits" from right to left, i.e., if
68 buf[] contains the reponse to command "Ss" (read system status), then
69 buf[0] contains "bit" Ss.1.7 (General alarm), while buf[7] contains
70 "bit" Ss.1.0 (Load unprotected).
71
72 enable_ups_comm() is called before each attempt to read/write data
73 from/to the UPS to re synchronise the communication.
74
75
77 Repetitive stale status ‐ Loss of communication
78 Older models, such as ES/ESV ones, might report repetitive "data stale"
79 errors. This is due to the fact that these models doesn't support too
80 much polling. To solve this problem, add "pollinterval=20" in ups.conf,
81 and change the value of MAXAGE to 25 in upsd.conf, and DEADTIME to 25
82 in upsmon.conf.
83
84
86 Sort out OFF/OL issues
87 OFF is set according to Ls.2.7, but maybe this interpretation is
88 in conflict with the NUT interpretation of the OFF flag?
89
90
91 Add PowerShare / PowerSave support (selectable plug number for com‐
92 mands)
93 ON/OFF/REBOOT commands can act either on outlet 1, 2 or main (1
94 + 2). This features depends on the UPS model. This would also
95 allow to support UM‐Switch (smart outlet).
96
97
98 Enhance the model name exposure
99 A table, named Si1_models_names, has been created to format
100 finelly the UPSs model names, but it is not yet being used.
101
102
104 Arnaud Quette, Hans Ekkehard Plesser, Martin Loyer, Patrick Agrain,
105 Nicholas Reilly, Dave Abbott, Marek Kralewski
106
107
109 The core driver:
110 nutupsdrv(8)
111
112
113 Internet resources:
114 The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
115
116
117
118 Mon Jan 16 2006 mge-utalk(8)