1NUTDRV_ATCL_USB(8) NUT Manual NUTDRV_ATCL_USB(8)
2
3
4
6 nutdrv_atcl_usb - Driver for 'ATCL FOR UPS' equipment
7
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
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. The UPS interface seems to be a
17 generic USB-to-serial chip, and for hardware manufactured by Kanji and
18 Plexus, the microcontroller appears to emulate a traditional
19 contact-closure interface. This translates into only three states in
20 ups.status: OL, OB and OB LB (similar to genericups(8)), with no other
21 dynamic status values reported. Note that these USB identifiers
22 (including the iManufacturer string) have also been seen on devices
23 that are supported by the fuji subdriver of nutdrv_qx(8).
24
26 This driver supports the following optional setting:
27
28 vendor=name
29 In case your iManufacturer (Vendor) string does not exactly match
30 ATCL FOR UPS, you may provide an alternate string here. Note that a
31 more likely case is that your device is handled by another driver
32 for 0001:0000 devices, such as nutdrv_qx(8).
33
35 The UPS returns the same code for "load power is off" as for "on line
36 power". This condition will not be observed if the NUT master is
37 powered by the UPS, but may be an issue if the UPS is monitored by a
38 remote system.
39
40 The time between the shutdown command and removal of power seems to be
41 fixed at 30 seconds. Ensure that the NUT shutdown script is invoked as
42 late as possible in the shutdown procedure (in case some services take
43 longer than others to clean up).
44
45 Most contact-closure UPSes will not power down the load if the line
46 power is present. This can create a race when using slave upsmon(8)
47 systems. See the upsmon(8) man page for more information. The solution
48 to this problem is to upgrade to a smart protocol UPS of some kind that
49 allows detection and proper load cycling on command.
50
52 Charles Lepple
53
55 The core driver:
56 nutupsdrv(8)
57
58 The generic serial driver:
59 genericups(8)
60
61 The Qx driver:
62 nutdrv_qx(8) (fuji subdriver)
63
64 Internet resources:
65 The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
66
67
68
69Network UPS Tools 2.7.3. 03/09/2016 NUTDRV_ATCL_USB(8)