Merge branch 'vendor/GDTOA'
[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/EISA/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 EISA cards:
38 .Cd device eisa
39 .Cd device adv
40 .Pp
41 For one or more PCI cards:
42 .Cd device pci
43 .Cd device adv
44 .Pp
45 For one or more SCSI busses:
46 .Cd device scbus0 at adv0
47 .Sh DESCRIPTION
48 This driver provides access to the 8bit
49 .Tn SCSI
50 bus connected to the Advanced Systems Products, Inc.
51 .Tn ASC900 ,
52 .Tn ASC1000 ,
53 .Tn ASC1090 ,
54 .Tn ASC1200 ,
55 .Tn ASC3030 ,
56 .Tn ASC3050 ,
57 and
58 .Tn ASC3150
59 host adapter chips.
60 The following tables list the AdvanSys products using these chips,
61 their bus attachment type, maximum sync rate, and the maximum number of
62 commands that can be handled by the adapter concurrently.
63 .Bd -ragged -offset indent
64 Connectivity Products:
65 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Footnotes "
66 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Footnotes
67 .It ABP510/5150 Ta ISA Ta \&No Ta 10MHz Ta 240 Ta 1
68 .It ABP5140 Ta ISA PnP Ta \&No Ta 10MHz Ta 16 Ta "1,3"
69 .It ABP5142 Ta ISA PnP Ta Yes Ta 10MHz Ta 16 Ta 4
70 .It ABP[3]902 Ta PCI Ta \&No Ta 10MHz Ta 16
71 .It ABP3905 Ta PCI Ta \&No Ta 10MHz Ta 16
72 .It ABP915 Ta PCI Ta \&No Ta 10MHz Ta 16
73 .It ABP920 Ta PCI Ta \&No Ta 10MHz Ta 16
74 .It ABP3922 Ta PCI Ta \&No Ta 10MHz Ta 16
75 .It ABP3925 Ta PCI Ta \&No Ta 10MHz Ta 16
76 .It ABP930 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta 5
77 .It ABP930U Ta PCI Ta \&No Ta 20MHz Ta 16
78 .It ABP930UA Ta PCI Ta \&No Ta 20MHz Ta 16
79 .It ABP960 Ta PCI Ta \&No Ta 10MHz Ta 16
80 .It ABP960U Ta PCI Ta \&No Ta 20MHz Ta 16
81 .El
82 .Pp
83 Footnotes:
84 .Bl -enum -compact
85 .It
86 This board has been shipped by HP with the 4020i CD-R drive.
87 The board has no BIOS so it cannot control a boot device, but
88 it can control any secondary SCSI device.
89 .It
90 This board has been sold by Iomega as a Jaz Jet PCI adapter.
91 .It
92 This board has been sold by SIIG as the i540 SpeedMaster.
93 .It
94 This board has been sold by SIIG as the i542 SpeedMaster.
95 .It
96 This board has been sold by SIIG as the Fast SCSI Pro PCI.
97 .El
98 .Ed
99 .Bd -ragged -offset indent
100 Single Channel Products:
101 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands "
102 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands
103 .It ABP542 Ta ISA Ta Yes Ta 10MHz Ta 240
104 .It ABP742 Ta EISA Ta Yes Ta 10MHz Ta 240
105 .It ABP842 Ta VL Ta Yes Ta 10MHz Ta 240
106 .It ABP940 Ta PCI Ta \&No Ta 10MHz Ta 240
107 .It ABP[3]940UA Ta PCI Ta \&No Ta 20MHz Ta 240
108 .It ABP940U Ta PCI Ta \&No Ta 20MHz Ta 240
109 .It ABP3960UA Ta PCI Ta \&No Ta 20MHz Ta 240
110 .It ABP970 Ta PCI Ta \&No Ta 10MHz Ta 240
111 .It ABP970U Ta PCI Ta \&No Ta 20MHz Ta 240
112 .El
113 .Ed
114 .Bd -ragged -offset indent
115 Multi Channel Products (Commands are per-channel):
116 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Channels "
117 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Channels
118 .It ABP752 Ta EISA Ta Yes Ta 10MHz Ta 240 Ta 2
119 .It ABP852 Ta VL Ta Yes Ta 10MHz Ta 240 Ta 2
120 .It ABP950 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 2
121 .It ABP980 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 4
122 .It ABP980U Ta PCI Ta \&No Ta 20MHz Ta 240 Ta 4
123 .It ABP[3]980UA Ta PCI Ta \&No Ta 20MHz Ta 16 Ta 4
124 .El
125 .Ed
126 .Pp
127 For ISA or Vesa Local Bus adapters, one kernel config entry is required
128 for every card to be attached by the system.  Specific values for the port
129 address, irq, and drq may be specified.  If wildcard values are used, the
130 driver will query the device for its current settings and use those.  If
131 the port address is a wildcard, the driver consults an internal table of
132 possible port address locations and attaches to the first unattached card
133 it finds.  The possible port addresses for these card are 0x110, 0x130,
134 0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
135 .Pp
136 Per target configuration performed in the
137 .Tn AdvanceWare
138 menu, which is accessible at boot,
139 is honored by this driver.
140 This includes synchronous/asynchronous transfers,
141 maximum synchronous negotiation rate, disconnection, tagged queueing,
142 and the host adapter's SCSI ID.
143 The global setting for the maximum number of tagged transactions allowed
144 per target is not honored as the CAM SCSI system will automatically determine
145 the maximum number of tags a device can receive as well as guarantee fair
146 resource allocation among devices.
147 .Sh SEE ALSO
148 .Xr adw 4 ,
149 .Xr aha 4 ,
150 .Xr ahc 4 ,
151 .Xr cd 4 ,
152 .Xr da 4 ,
153 .Xr sa 4 ,
154 .Xr scsi 4
155 .Sh HISTORY
156 The
157 .Nm
158 driver appeared in
159 .Fx 3.0 .
160 .Sh AUTHORS
161 .An -nosplit
162 The
163 .Nm
164 driver was ported by
165 .An Justin T. Gibbs
166 from the Linux driver
167 written by
168 .An Bob Frey
169 of Advanced System Products, Inc.
170 Many thanks to AdvanSys for providing the original driver under a suitable
171 license for use in
172 .Fx .