The wall-mount version of the Smart-UPS VT and MGE Galaxy 3500 MBP combines bypass functionality with power distribution capability in a common enclosure.The lower section of the MBP contains switches that facilitate the transfer of power from the UPS to bypass operation to allow maintenance to be performed on the UPS. UPS Driver:(release 1.5) For Evolution, EXtreme C, Pulsar and Comet EXtreme, Pulsar EX RT (2200, 3200), Pulsar EX RT 700/1000/1500 US. Page 1 MGE UPS SYSTEMS Pulsar EXtreme 2200C / 3200C Installation and user manual - Page 1 34007532EN/AA.; Page 2 Pulsar EXtreme C at the end of its service life. To discover the entire range of MGE UPS SYSTEMS products and the options available for the Pulsar EXtreme C range, we invite you to visit our web site at www.mgeups.com or contact your MGE UPS SYSTEMS representative.
usbhid-ups: Driver for USB/HID UPS equipment
Command to display usbhid-ups manual in Linux: $ man 8 usbhid-ups
NAME
usbhid-ups - Driver for USB/HID UPS equipment
NOTE
This man page only documents the hardware-specific features of the usbhid-ups driver. For information about the core driver, see nutupsdrv(8).
This driver, formerly called newhidups, replaces the legacy hidups driver, which only supported Linux systems.
SUPPORTED HARDWARE
usbhid-ups brings USB/HID UPS monitoring to NUT on all platform supporting USB through libusb. It should detect any UPS that uses the HID power device class, but the amount of data will vary depending on the manufacturer and model.
Mge Ups Driver
At the present time, usbhid-ups supports:
- •all MGE USB models,
- •some Belkin models,
Mge Pulsar Ex30 Manual
- •some TrippLite models
For a more complete list, refer to the NUT hardware compatibility list, available in the source distribution as data/drivers.list, or on the NUT website. You may use the 'explore' driver option to gather information from HID UPSes which are not yet supported; see below for details.
This driver is known to work on:
- •FreeBSD (beta stage) and maybe other *BSD,
- •Solaris 10.
EXTRA ARGUMENTS
This driver also supports the following optional settings:
offdelay=num
Set the timer before the UPS is turned off after the kill power command is sent (via the-kswitch).The default value is 20 (in seconds). Usually thismust be lowerthanondelay, but the driver willnotwarn you upon startup if it isn't.
ondelay=num
Set the timer for the UPS to switch on in case the power returns after the kill power command had been sent but before the actual switch off. This ensures the machines connected to the UPS are, in all cases, rebooted after a power failure.The default value is 30 (in seconds). Usually thismust be greaterthan offdelay, but the driver willnotwarn you upon startup if it isn't. Some UPS'es will restart no matter what, even if the power is (still) out at the moment this timer elapses. In that case, you could try if settingondelay = -1inups.confhelps.
pollfreq=num
- If this flag is set, the driver will ignore interrupts it receives from the UPS (not recommended, but needed if these reports are broken on your UPS).
vendor=regex, product=regex, serial=regex, vendorid=regex, productid=regex
Select a specific UPS, in case there is more than one connected via USB Each option specifies an extended regular expression (see regex(7)) that must match the UPS's entire vendor/product/serial string (minus any surrounding whitespace), or the whole 4-digit hexadecimal code for vendorid and productid. Try-DDfor finding out the strings to match.Examples:
•-x vendor='Foo.Corporation.*'
•-x vendorid=051d*(APC)
•-x product='.*(Smart|Back)-?UPS.*'
bus=regex
explore
maxreport
- usbhid-dump (8) - dump USB HID device report descriptors and streams
- usb-creator-gtk (8) - Ubuntu startup disk creation tool for Gtk+
- usbguard-daemon (8) - USBGuard daemon
- usbguard-dbus (8) - USBGuard D-Bus interface service
- usbmodules_selinux (8) - Security Enhanced Linux Policy for the usbmodules processes
- usbmuxd (8) - Expose a socket to multiplex connections from and to iOS devices.
- usbmuxd_selinux (8) - Security Enhanced Linux Policy for the usbmuxd processes
You also need to install manually the legacy hotplug files (libhidups and libhid.usermap, generally in /etc/hotplug/usb/), or the udev file (nut-usbups.rules, generally in /etc/udev/rules.d/) to address the permission settings problem. For more information, refer to the README file in nut/scripts/hotplug or nut/scripts/udev.
On Linux with MGE equipment, you will need at least a 2.4.25 or 2.6.2 kernel as well as libusb-0.1.8 or later to disable hiddev support and avoid conflict.
IMPLEMENTATION
The driver ignores the 'port' value in ups.conf. Unlike previous versions of this driver, it is now possible to control multiple UPS units simultaneously with this driver, provided they can be distinguished by setting some combination of the 'vendor', 'product', 'serial', 'vendorid', and 'productid' options. For instance:
KNOWN ISSUES AND BUGS
Repetitive timeout and staleness
Some models tends to be unresponsive with the default polling frequency. The result is that your system log will have lots of messages like:
In this case, simply modify the general parameter 'pollinterval' to a higher value (like 10 for 10 seconds). This should solve the issue.
Got EPERM: Operation not permitted upon driver startup
You have forgotten to install the hotplug files, as explained in the INSTALLATION section above. Don't forget to restart hotplug so that it applies these changes.
Unattended shutdowns
The hardware which was used for development of this driver is almost certainly different from what you have, and not all manufacturers follow the USB HID Power Device Class specifications to the letter. You don't want to find out that yours has issues here when a power failure hits your server room and you're not around to manually restart your servers.
If you rely on the UPS to shutdown your systems in case of mains failure and to restart them when the power returns, you must test this. You can do so by running upsmon -c fsd. With the mains present, this should bring your systems down and then cycle the power to restart them again. If you do the same without mains present, it should do the same, but in this case, the outputs shall remain off until mains power is applied again.
AUTHORS
Originally sponsored by MGE UPS SYSTEMS. Now sponsored by Eaton http://opensource.eaton.com Arnaud Quette, Peter Selinger, Arjen de Korte
SEE ALSO
The core driver
nutupsdrv(8)
Internet resources
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
Pages related to usbhid-ups