~ubuntu-branches/ubuntu/saucy/nut/saucy

« back to all changes in this revision

Viewing changes to man/newapc.8

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2005-07-20 19:48:50 UTC
  • mto: (16.1.1 squeeze)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20050720194850-oo61wjr33rrx2mre
Tags: upstream-2.0.2
ImportĀ upstreamĀ versionĀ 2.0.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH NEWAPC 8 "Tue Oct 22 2002" "" "Network UPS Tools (NUT)" 
2
 
.SH NAME  
3
 
newapc \- Driver for American Power Conversion Smart Protocol UPS equipment
4
 
.SH NOTE
5
 
This man page only documents the hardware-specific features of the
6
 
newapc driver.  For information about the core driver, see  
7
 
\fBnutupsdrv\fR(8).
8
 
 
9
 
.SH SUPPORTED HARDWARE
10
 
newapc should recognize all recent APC models that use a serial protocol at 
11
 
2400 bps.  This is primarily the Smart-UPS, Matrix-UPS and Back-UPS
12
 
Pro lines.  Older APC models may work better with the apcsmart driver.
13
 
 
14
 
The driver attempts to support every bell and whistle of the APC
15
 
reporting interface, whether or not this is strictly sensible.
16
 
 
17
 
Some older hardware may only report a handful of variables.  This is
18
 
usually not a bug - they just don't support anything else.
19
 
 
20
 
.SH CABLING
21
 
 
22
 
This driver expects to see a 940-0024C cable or a clone by default.  You
23
 
can switch to the 940-0095B dual-mode cable support with the cable=
24
 
definition described below.
25
 
 
26
 
If your 940-0024C cable is broken or missing, use this diagram to build
27
 
a clone:
28
 
 
29
 
http://random.networkupstools.org/cables/940-0024C.jpg
30
 
 
31
 
.SH EXTRA ARGUMENTS
32
 
This driver supports the following optional settings in the
33
 
\fBups.conf\fR(5):
34
 
 
35
 
.IP "cable=940-0095B"
36
 
Configure the serial port for the APC 940-0095B dual-mode cable.
37
 
 
38
 
.IP "sdtype=\fInum\fR"
39
 
Use shutdown type \fInum\fR, according to this table:
40
 
 
41
 
0: soft shutdown or powerdown, depending on battery status
42
 
 
43
 
1: soft shutdown followed by powerdown
44
 
 
45
 
2: instant power off
46
 
 
47
 
3: power off with grace period
48
 
 
49
 
Modes 0 and 1 will power up the load when power returns.  Modes 2 and 3
50
 
will keep the load turned off when the power returns.
51
 
 
52
 
.SH BUGS
53
 
Some older APC UPS models return bogus data in the status register during
54
 
a front panel test.  This is usually detected and discarded, but some
55
 
other unexpected values have occasionally slipped through.
56
 
 
57
 
.SH AUTHOR
58
 
Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk> (drawing
59
 
heavily on the apcsmart driver by Russell Kroll).
60
 
 
61
 
.SH SEE ALSO
62
 
 
63
 
.SS The core driver:
64
 
\fBnutupsdrv\fR(8)
65
 
 
66
 
.SS The apcsmart driver:
67
 
\fBapcsmart\fR(8)
68
 
 
69
 
.SS Internet resources:
70
 
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/