energizerups(8)

1ENERGIZERUPS(8)             Network UPS Tools (NUT)            ENERGIZERUPS(8)
2
3
4

NAME

6       energizerups  -  Driver  for  Energizer  (Megatec protocol over "USB To
7       RS232 Interface (V1.0) BaudRate 2400bps") UPS equipment
8

NOTE

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

SUPPORTED HARDWARE

16       energizerups supports Energizer models such as the ER‐HMOF600  and  ER‐
17       OF800.
18
19       At  the time of this writing, the driver was tested only with these two
20       models. Other Energizer models that use the same USB  interface  should
21       also work, but they have not been tested for compatibility.
22
23

PREREQUISITES

25       This  driver  is  Linux‐specific.  It  is not designed to work on other
26       operating systems.
27
28       In order for this driver to work, USB and HID support must  be  present
29       on  your  system.  As  a  minimum, this means that the following kernel
30       drivers must be loaded:
31
32              hid
33              usb‐uhci
34              usbcore
35
36
37       In place of usb‐uhci, you  may  have  another  host  controller  module
38       loaded, as appropriate for your hardware.
39
40       In  version 2.4.21 and possibly other versions of the Linux kernel, the
41       hiddev driver refuses to take control of HID devices that are also rec‐
42       ognized as input peripherals. Unfortunately, this also applies to these
43       Energizer UPS models. One solution to this problem is to compile a ker‐
44       nel  with  the CONFIG_HID_USBINPUT option turned off. An alternative is
45       to modify the kernel with a simple patch.  In drivers/usb/hiddev.c,  in
46       the function hiddev_connect(), the line
47
48              if (!IS_INPUT_APPLICATION(hid‐>application[i]))
49
50
51       must be removed or commented out, and the driver and/or the kernel must
52       be recompiled.
53
54       energizerups also requires that device nodes for the UPS HID device  be
55       created. If these don't exist on your system, you can create them using
56       the following commands:
57
58              mkdir /dev/usb
59              mkdir /dev/usb/hid
60              mknod /dev/usb/hid/hiddev0 c 180 96
61              mknod /dev/usb/hid/hiddev1 c 180 97
62              mknod /dev/usb/hid/hiddev2 c 180 98
63              mknod /dev/usb/hid/hiddev3 c 180 99
64
65
66       If your system uses the devfs file system, the appropriate node may  be
67       created automatically by the system when the UPS is connected.
68
69

CHECKING THE HARDWARE

71       You  can verify that the UPS is connected and recognized by your system
72       by mounting the usbfs file system (if it is not  mounted  already)  and
73       then listing all USB devices:
74
75              mount none /proc/bus/usb -t usbfs
76              cat /proc/bus/usb/devices
77
78
79       In this file, the following line should be seen:
80
81       S:  Product=USB To RS232 Interface (V1.0) BaudRate 2400bps
82
83
84       This line indicates the presence of the USB‐to‐serial converter that is
85       used by these Energizer UPS models.
86
87

EXTRA ARGUMENTS

89       This driver does not support any extra settings in the ups.conf(5).
90
91

BUGS

93       The battery percentage is derived from the voltage data  that  the  UPS
94       returns,  since  the  UPS  doesn't return that value directly.  On some
95       hardware, the charge will remain at 100% for a long time and then drops
96       quickly  shortly before the battery runs out.  You can confirm from the
97       battery.voltage readings that this is a problem with the  UPS  and  not
98       this driver.
99
100       Voltage/charge  characteristics  are  derived from a manual calibration
101       with an ER‐HMOF600. Due to hardware differences, the charge  percentage
102       reports may be very inaccurate.
103
104       Dead/broken  batteries  can't  be reported reliably.  If your UPS kills
105       the load instantly or within seconds of  starting  the  inverter,  your
106       batteries probably need to be replaced.
107
108

AUTHOR

110       Viktor Toth (http://www.vttoth.com/)
111
112