mge-utalk(8)

1mge-utalk(8)                Network UPS Tools (NUT)               mge-utalk(8)
2
3
4

NAME

6       mge‐utalk - Driver for MGE UPS SYSTEMS UTalk protocol hardware
7

NOTE

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

SUPPORTED HARDWARE

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

EXTRA ARGUMENTS

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

IMPLEMENTATION DETAILS

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

KNOWN ISSUES

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

TODO LIST

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

AUTHORS

104       Arnaud Quette, Hans Ekkehard Plesser,  Martin  Loyer,  Patrick  Agrain,
105       Nicholas Reilly, Dave Abbott, Marek Kralewski
106
107