71 lines
2.2 KiB
Text
71 lines
2.2 KiB
Text
|
NUTDRV_ATCL_USB(8)
|
||
|
==================
|
||
|
|
||
|
NAME
|
||
|
----
|
||
|
nutdrv_atcl_usb - Driver for 'ATCL FOR UPS' equipment
|
||
|
|
||
|
NOTE
|
||
|
----
|
||
|
This man page only documents the specific features of the nutdrv_atcl_usb
|
||
|
driver. For information about the core driver, see linkman:nutupsdrv[8].
|
||
|
|
||
|
SUPPORTED HARDWARE
|
||
|
------------------
|
||
|
This driver is for UPS hardware which identifies itself as USB idVendor 0001
|
||
|
and idProduct 0000, and iManufacturer +ATCL FOR UPS+. Known manufacturers
|
||
|
include Kanji and Plexus. The UPS interface seems to be a USB frontend to a
|
||
|
traditional contact-closure interface, which translates into only three states
|
||
|
in ups.status: *OL*, *OB* and *OB LB*. See also linkman:genericups[8].
|
||
|
|
||
|
EXTRA ARGUMENTS
|
||
|
---------------
|
||
|
|
||
|
This driver supports the following optional setting:
|
||
|
|
||
|
*vendor*='name'::
|
||
|
In case your iManufacturer (Vendor) string does not exactly match
|
||
|
+ATCL FOR UPS+, you may provide an alternate string here. Note that a more
|
||
|
likely case is that your device is handled by another driver for +0001:0000+
|
||
|
devices, such as linkman:nutdrv_qx[8].
|
||
|
|
||
|
BUGS
|
||
|
----
|
||
|
The UPS returns the same code for "load power is off" as for "on line power".
|
||
|
This condition will not be observed if the NUT master is powered by the UPS,
|
||
|
but may be an issue if the UPS is monitored by a remote system.
|
||
|
|
||
|
The time between the shutdown command and removal of power seems to be fixed at
|
||
|
30 seconds. Ensure that the NUT shutdown script is invoked as late as possible
|
||
|
in the shutdown procedure (in case some services take longer than others to
|
||
|
clean up).
|
||
|
|
||
|
Most contact-closure UPSes will not power down the load if the line power
|
||
|
is present. This can create a race when using slave linkman:upsmon[8] systems.
|
||
|
See the linkman:upsmon[8] man page for more information. The solution to this
|
||
|
problem is to upgrade to a smart protocol UPS of some kind that allows
|
||
|
detection and proper load cycling on command.
|
||
|
|
||
|
AUTHORS
|
||
|
-------
|
||
|
Charles Lepple
|
||
|
|
||
|
SEE ALSO
|
||
|
--------
|
||
|
|
||
|
The core driver:
|
||
|
~~~~~~~~~~~~~~~~
|
||
|
linkman:nutupsdrv[8]
|
||
|
|
||
|
The generic serial driver:
|
||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
linkman:genericups[8]
|
||
|
|
||
|
The Qx driver:
|
||
|
~~~~~~~~~~~~~~
|
||
|
linkman:nutdrv_qx[8]
|
||
|
|
||
|
Internet resources:
|
||
|
~~~~~~~~~~~~~~~~~~~
|
||
|
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|