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

NAME

6       mge‐shut - Driver for MGE UPS serial SHUT Protocol UPS equipment
7

NOTE

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

SUPPORTED HARDWARE

14       mge‐shut support all recent MGE UPS models which use the  SHUT  (Serial
15       HID UPS Transfer) protocol at 2400 bps. Supported models are:
16
17           Pulsar Ellipse S,
18           Pulsar Ellipse USBS
19           Pulsar Ellipse Premium S,
20           Pulsar Ellipse Premium USBS
21           Pulsar EXtreme C,
22           Pulsar Esprit,
23           Pulsar Evolution,
24           NOVA AVR (Serial),
25           Galaxy 3000 / PW (with RS232 HID COM ports card, ref 66066).
26
27       Older models, such as Pulsar ESV+, Pulsar EX and Pulsar ES+, use the U‐
28       Talk protocol and should use the mge‐utalk driver.
29
30

EXTRA ARGUMENTS

32       This  driver  supports  the  following   optional   settings   in   the
33       ups.conf(5):
34
35
36       lowbatt=num
37              Set  the low battery warning threshold at which shutdown is ini‐
38              tiated by upsmon(8).  The factory default value is 30  (in  per‐
39              centage), and only be settable depending on the exact model.
40
41
42       offdelay=num
43              Set  the timer before the UPS is turned off after the kill power
44              command is sent (via the -k switch).  The default  value  is  20
45              (in seconds), and MUST BE LOWER than ondelay.
46
47
48       ondelay=num
49              Set the timer for the UPS to switch on in case the power returns
50              after the kill power command had been sent but before the actual
51              switch  off. This ensures the machines connected to the UPS are,
52              in all cases, rebooted after a power failure.  The default value
53              is  3 (in 10 seconds units, which means 30 seconds), and MUST BE
54              GREATER than offdelay.
55
56
57       notification=num
58              Set notification type to 1 (no), 2  (light)  or  3  (yes).   The
59              default  value  is  3 (yes) because of some early Ellipse models
60              which need it.
61
62

KNOWN ISSUES

64   Pulsar Ellipse S: Repetitive stale status ‐ Loss of communication
65       Several users have reported "data stale"  errors  with  Pulsar  Ellipse
66       equipment.   This  lasts  around  10 seconds and happens once every few
67       hours.  This is due to the fact that the SHUT protocol is verbose,  and
68       the driver sometimes does not handle all of it during the usual polling
69       interval in upsd.  To solve this problem, change the value of MAXAGE to
70       25  in  upsd.conf.   Also  add  "notification=3" in ups.conf (thanks to
71       Julien Lesaint and Fabien).
72
73
74

AUTHOR

76       Arnaud Quette <arnaud.quette@free.fr> or <arnaud.quette@mgeups.com>
77
78       Philippe Marzouk <philm@users.sourceforge.net>
79
80

SEE ALSO

82   The core driver:
83       nutupsdrv(8)
84
85
86   Internet resources:
87       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
88
89       MGE UPS SYSTEMS  SHUT  protocol  information:  http://random.networkup
90       stools.org/protocols/mge/
91
92
93
94                                Fri Dec 16 2005                    mge-shut(8)
Impressum