Imported Upstream version 2.7.2

docs/man/nutdrv_atcl_usb.txt

@@ -0,0 +1,70 @@
+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/