1mge-shut(8) Network UPS Tools (NUT) mge-shut(8)
2
3
4
6 mge‐shut - Driver for MGE UPS serial SHUT Protocol UPS equipment
7
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
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
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
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
76 Arnaud Quette <arnaud.quette@free.fr> or <arnaud.quette@mgeups.com>
77
78 Philippe Marzouk <philm@users.sourceforge.net>
79
80
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)