bcmxcp - Experimental driver for UPS'es supporting the BCM/XCP protocol
This man page only documents the hardware-specific features of the
bcmxcp_usb driver. For information about the core driver, see
nutupsdrv(8). This driver is a variant of the serial driver bcmxcp and
uses the same core code.
This driver should recognize all BCM/XCP-compatible UPS'es that are
connected via USB. It has been developed and tested on Powerware
PW3501 hardware. It also has been tested on PW5110 hardware.
This driver supports the following optional settings in the
The number of seconds that the UPS should wait between receiving
the shutdown command and actually shutting off.
DEFAULT VALUES FOR THE EXTRA ARGUMENTS
shutdown_delay = 120
This driver supports the following Instant Commands:
Turn off the load and return when power is back.
Turn off the load and remain off.
Start a battery test.
Report UPS alarm status
BCM/XCP supports reporting a wide range of UPS alarm conditions.
Report UPS statistics informations
BCM/XCP supports reporting of UPS statistics data.
This driver has been tagged experimental, even if it has been reported
to be stable. Thus it is not suitable for production systems and it is
not built by default. This is mainly due to the fact that it is a new
This driver is not built by default. You can build it by using
"configure --with-usb=yes". Note that it will also install other USB
You also need to install manually the hotplug files (libhidups and
libhid.usermap), generally in etc/hotplug/usb/, to address the
permission settings problem. Lastly note that the libhidups file must
have execution flag set (ie using chmod +x ...).
bcmxcp_usb only supports 1 UPS at this time. You can put the "auto"
value for port in ups.conf, i.e.:
driver = bcmxcp_usb
port = auto
KNOWN ISSUES AND BUGS
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.
Tore Orpetveit <firstname.lastname@example.org>, Wolfgang Ocker <email@example.com>
The core driver:
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
Sun Sep 19 2004