upscode2



XXX
XXX WARNING: old character encoding and/or character set
XXX
UPSCODE2(8)                 Network UPS Tools (NUT)                UPSCODE2(8)




NAME

       upscode2 - Driver for UPScode II compatible UPS equipment


NOTE

       This  man  page  only  documents  the hardware-specific features of the
       upscode2 driver.  For information about the core  driver,  see  nutups-
       drv(8).



SUPPORTED HARDWARE

       This  driver  supports  UPS  equipment  which can be controlled via teh
       UPScode II protocol.  This is mainly Fiskars, Powerware equipment,  but
       also some (probably OEM’ed) products from Compaq.



EXTRA ARGUMENTS

       This   driver   supports   the   following  optional  settings  in  the
       ups.conf(5):


       manufacturer=value
              Autodetection of this parameter is  not  possible  yet  (and  it
              probably  never  will  be).  Therefore  this user defined string
              accepts any name. The default is unknown.


       input_timeout=value
              The timeout waiting for a response from the UPS. Some UPS models
              have  shown  to  be  rather slow, resulting in frequent messages
              about empty responses  from  the  UPS.  If  you  see  this,  try
              incresing this value.


       output_pace=value
              Delay  between  characters  sent  to the UPS. This was added for
              completenes with the above parameter. It has  not  shown  to  be
              needed yet.


       baudrate=value
              The  default  baudrate  is  1200,  which is the standard for the
              UPScode II protocol.


       full_update_timer=value
              Number of seconds between collection of normative values.


       use_crlf
              Flag to set if commands towards to UPS  need  to  be  terminated
              with CR-LF, and not just CR.


       use_pre_lf
              Flag  to  set  if  commands towards to UPS need to be introduced
              with an LF.  A Compaq T1500h is known to need this.



UPSCMD

       The driver supports the following commands for those UPSen that support
       them.   The  available commands are autodetected during initialization,
       so you should check availability with upscmd -l.

       test.panel.start - Start UPS self test

       test.battery.start - Start battery self test

       beeper.on - Enable UPS beeper

       beeper.off - Disable UPS beeper

       shutdown.return - Shut down in 1 second and wait for power to return

       shutdown.stayoff - Shut down in 1 seconds

       shutdown.reboot - Shut down in 1 seconds and reboot after 1 minute

       shutdown.reboot.graceful - Shut down in 20 seconds and reboot  after  1
       minute



NOTES

       The Powerware UPS models that this driver has been tested against until
       now has not returned a value for battery.charge. Therefore  the  driver
       will  guesstimate  a value based on the nominal battery min/max and the
       current battery voltage.



AUTHOR

       Håvard Lygre <hklygre@online.no>, Niels Baggesen <niels@baggesen.net>



SEE ALSO

   The core driver:
       nutupsdrv(8)


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



                                Tue Oct 19 2004                    UPSCODE2(8)

Man(1) output converted with man2html