0814102ee35aff67afce99931dd6c3c3a883fba0
[dragonfly.git] / share / man / man4 / adv.4
1 .\"
2 .\" Copyright (c) 1998, 2000
3 .\"     Justin T. Gibbs.  All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. The name of the author may not be used to endorse or promote products
11 .\"    derived from this software without specific prior written permission.
12 .\"
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 .\"
24 .\" $FreeBSD: src/share/man/man4/adv.4,v 1.7.4.6 2001/10/01 13:07:22 dd Exp $
25 .\"
26 .Dd February 13, 2000
27 .Dt ADV 4
28 .Os
29 .Sh NAME
30 .Nm adv
31 .Nd Advansys ISA/VL/PCI 8bit SCSI Host adapter driver
32 .Sh SYNOPSIS
33 For one or more ISA or VL cards:
34 .Cd device isa
35 .Cd device "adv0 at isa? port ? irq ? drq ?"
36 .Pp
37 For one or more PCI cards:
38 .Cd device pci
39 .Cd device adv
40 .Pp
41 For one or more SCSI busses:
42 .Cd device scbus0 at adv0
43 .Sh DESCRIPTION
44 This driver provides access to the 8bit
45 .Tn SCSI
46 bus connected to the Advanced Systems Products, Inc.
47 .Tn ASC900 ,
48 .Tn ASC1000 ,
49 .Tn ASC1090 ,
50 .Tn ASC1200 ,
51 .Tn ASC3030 ,
52 .Tn ASC3050 ,
53 and
54 .Tn ASC3150
55 host adapter chips.
56 The following tables list the AdvanSys products using these chips,
57 their bus attachment type, maximum sync rate, and the maximum number of
58 commands that can be handled by the adapter concurrently.
59 .Bd -ragged -offset indent
60 Connectivity Products:
61 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Footnotes "
62 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Footnotes
63 .It ABP510/5150 Ta ISA Ta \&No Ta 10MHz Ta 240 Ta 1
64 .It ABP5140 Ta ISA PnP Ta \&No Ta 10MHz Ta 16 Ta "1,3"
65 .It ABP5142 Ta ISA PnP Ta Yes Ta 10MHz Ta 16 Ta 4
66 .It ABP[3]902 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
67 .It ABP3905 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
68 .It ABP915 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
69 .It ABP920 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
70 .It ABP3922 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
71 .It ABP3925 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
72 .It ABP930 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta 5
73 .It ABP930U Ta PCI Ta \&No Ta 20MHz Ta 16 Ta ""
74 .It ABP930UA Ta PCI Ta \&No Ta 20MHz Ta 16 Ta ""
75 .It ABP960 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta ""
76 .It ABP960U Ta PCI Ta \&No Ta 20MHz Ta 16 Ta ""
77 .El
78 .Pp
79 Footnotes:
80 .Bl -enum -compact
81 .It
82 This board has been shipped by HP with the 4020i CD-R drive.
83 The board has no BIOS so it cannot control a boot device, but
84 it can control any secondary SCSI device.
85 .It
86 This board has been sold by Iomega as a Jaz Jet PCI adapter.
87 .It
88 This board has been sold by SIIG as the i540 SpeedMaster.
89 .It
90 This board has been sold by SIIG as the i542 SpeedMaster.
91 .It
92 This board has been sold by SIIG as the Fast SCSI Pro PCI.
93 .El
94 .Ed
95 .Bd -ragged -offset indent
96 Single Channel Products:
97 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands "
98 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands
99 .It ABP542 Ta ISA Ta Yes Ta 10MHz Ta 240
100 .It ABP842 Ta VL Ta Yes Ta 10MHz Ta 240
101 .It ABP940 Ta PCI Ta \&No Ta 10MHz Ta 240
102 .It ABP[3]940UA Ta PCI Ta \&No Ta 20MHz Ta 240
103 .It ABP940U Ta PCI Ta \&No Ta 20MHz Ta 240
104 .It ABP3960UA Ta PCI Ta \&No Ta 20MHz Ta 240
105 .It ABP970 Ta PCI Ta \&No Ta 10MHz Ta 240
106 .It ABP970U Ta PCI Ta \&No Ta 20MHz Ta 240
107 .El
108 .Ed
109 .Bd -ragged -offset indent
110 Multi Channel Products (Commands are per-channel):
111 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Channels "
112 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Channels
113 .It ABP852 Ta VL Ta Yes Ta 10MHz Ta 240 Ta 2
114 .It ABP950 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 2
115 .It ABP980 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 4
116 .It ABP980U Ta PCI Ta \&No Ta 20MHz Ta 240 Ta 4
117 .It ABP[3]980UA Ta PCI Ta \&No Ta 20MHz Ta 16 Ta 4
118 .El
119 .Ed
120 .Pp
121 For ISA or Vesa Local Bus adapters, one kernel config entry is required
122 for every card to be attached by the system.  Specific values for the port
123 address, irq, and drq may be specified.  If wildcard values are used, the
124 driver will query the device for its current settings and use those.  If
125 the port address is a wildcard, the driver consults an internal table of
126 possible port address locations and attaches to the first unattached card
127 it finds.  The possible port addresses for these card are 0x110, 0x130,
128 0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
129 .Pp
130 Per target configuration performed in the
131 .Tn AdvanceWare
132 menu, which is accessible at boot,
133 is honored by this driver.
134 This includes synchronous/asynchronous transfers,
135 maximum synchronous negotiation rate, disconnection, tagged queueing,
136 and the host adapter's SCSI ID.
137 The global setting for the maximum number of tagged transactions allowed
138 per target is not honored as the CAM SCSI system will automatically determine
139 the maximum number of tags a device can receive as well as guarantee fair
140 resource allocation among devices.
141 .Sh SEE ALSO
142 .Xr adw 4 ,
143 .Xr ahc 4 ,
144 .Xr cd 4 ,
145 .Xr da 4 ,
146 .Xr sa 4 ,
147 .Xr scsi 4
148 .Sh HISTORY
149 The
150 .Nm
151 driver appeared in
152 .Fx 3.0 .
153 .Sh AUTHORS
154 .An -nosplit
155 The
156 .Nm
157 driver was ported by
158 .An Justin T. Gibbs
159 from the Linux driver
160 written by
161 .An Bob Frey
162 of Advanced System Products, Inc.
163 Many thanks to AdvanSys for providing the original driver under a suitable
164 license for use in
165 .Fx .