BCMXCP(8)
=========

NAME
----

bcmxcp - Driver for UPSes supporting the serial BCM/XCP protocol

NOTE
----
This man page only documents the hardware-specific features of the
bcmxcp driver.  For information about the core driver, see
linkman:nutupsdrv[8].

SUPPORTED HARDWARE
------------------
This driver should recognize all serial BCM/XCP-compatible UPSes.  It has
been developed and tested on Powerware PW5115 and PW9120 hardware. If your UPS
has a USB connection, you may also consult the linkman:bcmxcp_usb[8] driver
documentation.

EXTRA ARGUMENTS
---------------
This driver supports the following optional settings in the    
linkman:ups.conf[5].

*shutdown_delay=*'delay'::
The number of seconds that the UPS should wait between receiving the 
shutdown command (`upsdrvctl shutdown`) and actually shutting off.

*baud_rate=*'rate'::
Communication speed for the UPS. If this is set to 9600, it tries to connect
to the UPS at 9600bps. If it fails to communicate, it will go into baud-hunting.
It starts at 1200 and goes up to 19200. If it succeeds, it tell you the speed it
connected with. If not included in the config, it defaults to baud-hunting.
 
DEFAULT VALUES FOR THE EXTRA ARGUMENTS
--------------------------------------
 - *shutdown_delay =* '120'
 - *baud_rate =* 'none'

INSTANT COMMANDS
----------------
This driver supports the following Instant Commands:

*shutdown.return*::
Turn off the load and return when power is back. 

*shutdown.stayoff*::
Turn off the load and remain off.

*test.battery.start*::
Start a battery test.

*outlet.n.shutdown.return*::
Turn off the load on outlet 'n' and return when power is back.
('n' is the outlet number reported by the upsc command) 

TODO LIST
---------

Report UPS statistics informations::
BCM/XCP supports reporting of UPS statistics data.

Change settings::
Access the config register to change settings.

BUGS
----
None known.

AUTHOR
------
Tore Ørpetveit <tore@orpetveit.net>

SEE ALSO
--------
The core driver:
~~~~~~~~~~~~~~~~
linkman:nutupsdrv[8]

The USB BCM/XCP driver:
~~~~~~~~~~~~~~~~~~~~~~~
linkman:bcmxcp_usb[8]

Internet resources:
~~~~~~~~~~~~~~~~~~~
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/