Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NUTDRV_ATCL_USB(8)		  NUT Manual		    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
       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
       generic USB-to-serial chip, and for hardware manufactured by Kanji and
       Plexus, the microcontroller appears to emulate a	traditional
       contact-closure interface. This translates into only three states in
       ups.status: OL, OB and OB LB (similar to	genericups(8)),	with no	other
       dynamic status values reported. Note that these USB identifiers
       (including the iManufacturer string) have also been seen	on devices
       that are	supported by the fuji subdriver	of nutdrv_qx(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 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 upsmon in
       primary mode runs on the	box powered by the UPS,	but may	be an issue if
       the UPS is monitored by a remote	(secondary) 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 secondary upsmon(8)
       systems.	See the	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:
       nutupsdrv(8)

   The generic serial driver:
       genericups(8)

   The Qx driver:
       nutdrv_qx(8) (fuji subdriver)

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

Network	UPS Tools 2.7.4.	  08/28/2021		    NUTDRV_ATCL_USB(8)

NAME | NOTE | SUPPORTED HARDWARE | EXTRA ARGUMENTS | BUGS | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nutdrv_atcl_usb&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help