1NUTDRV_ATCL_USB(8)                NUT Manual                NUTDRV_ATCL_USB(8)
2
3
4

NAME

6       nutdrv_atcl_usb - Driver for 'ATCL FOR UPS' equipment
7

NOTE

9       This man page only documents the specific features of the
10       nutdrv_atcl_usb driver. For information about the core driver, see
11       nutupsdrv(8).
12

SUPPORTED HARDWARE

14       This driver is for UPS hardware which identifies itself as USB idVendor
15       0001 and idProduct 0000, and iManufacturer ATCL FOR UPS. Known
16       manufacturers include Kanji and Plexus.
17
18       The UPS interface seems to be a generic USB-to-serial chip, and for
19       hardware manufactured by Kanji and Plexus, the microcontroller appears
20       to emulate a traditional contact-closure interface. This translates
21       into only three states in ups.status: OL, OB and OB LB (similar to
22       genericups(8)), with no other dynamic status values reported.
23
24       Note that these USB identifiers (including the iManufacturer string)
25       have also been seen on devices that are supported by the fuji subdriver
26       of nutdrv_qx(8).
27

EXTRA ARGUMENTS

29       This driver supports the following optional setting:
30
31       vendor=name
32           In case your iManufacturer (Vendor) string does not exactly match
33           ATCL FOR UPS, you may provide an alternate string here. Note that a
34           more likely case is that your device is handled by another driver
35           for 0001:0000 devices, such as nutdrv_qx(8).
36

BUGS

38       The UPS returns the same code for "load power is off" as for "on line
39       power". This condition will not be observed if the NUT upsmon in
40       primary mode runs on the box powered by the UPS, but may be an issue if
41       the UPS is monitored by a remote (secondary) system.
42
43       The time between the shutdown command and removal of power seems to be
44       fixed at 30 seconds. Ensure that the NUT shutdown script is invoked as
45       late as possible in the shutdown procedure (in case some services take
46       longer than others to clean up).
47
48       Most contact-closure UPSes will not power down the load if the line
49       power is present. This can create a race when using secondary upsmon(8)
50       systems. See the upsmon(8) man page for more information. The solution
51       to this problem is to upgrade to a smart protocol UPS of some kind that
52       allows detection and proper load cycling on command.
53

AUTHOR

55       Charles Lepple
56

SEE ALSO

58   The core driver:
59       nutupsdrv(8)
60
61   The generic serial driver:
62       genericups(8)
63
64   The Qx driver:
65       nutdrv_qx(8) (fuji subdriver)
66
67   Internet resources:
68       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
69
70
71
72Network UPS Tools 2.8.0           04/26/2022                NUTDRV_ATCL_USB(8)
Impressum