xref: /dragonfly/share/man/man4/adw.4 (revision 479ab7f0)
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/adw.4,v 1.5.4.6 2001/10/01 13:07:22 dd Exp $
25.\" $DragonFly: src/share/man/man4/adw.4,v 1.5 2007/09/30 06:10:43 swildner Exp $
26.\"
27.Dd September 29, 2007
28.Dt ADW 4
29.Os
30.Sh NAME
31.Nm adw
32.Nd Advansys PCI 16bit SCSI Host adapter driver
33.Sh SYNOPSIS
34.Cd device pci
35.Cd device adw
36.Pp
37For one or more SCSI busses:
38.Cd device scbus0 at adw0
39.Pp
40To allow PCI adapters to use memory mapped I/O if enabled:
41.Cd options ADW_ALLOW_MEMIO
42.Sh DESCRIPTION
43This driver provides access to the 16bit
44.Tn SCSI
45bus connected to the Advanced Systems Products, Inc.
46.Tn ASC3550 Ultra ,
47and
48.Tn ASC38C0800 Ultra2 ,
49SCSI Host Adapter chips.
50AdvanSys products incorporating these chips include the
51.Tn ABP[3]940UW ,
52.Tn ABP950UW ,
53.Tn ABP970UW ,
54.Tn ABP3940U2W ,
55and
56.Tn ABP3950U2W .
57Both chips support, synchronous transfers
58(20MHz and 40MHz max respectively),
5916bit transfers, tagged queueing,
60and up to 253 concurrent SCSI transactions.
61.Pp
62Per target configuration performed in the
63.Tn AdvanceWare
64menu, which is accessible at boot,
65is honored by this driver.
66This includes synchronous/asynchronous transfers,
67maximum synchronous negotiation rate, wide transfers, disconnection,
68tagged queueing, and the host adapter's SCSI ID.
69The global setting for the maximum number of tagged transactions allowed
70per target is not honored as the CAM SCSI system will automatically determine
71the maximum number of tags a device can receive as well as guarantee fair
72resource allocation among devices.
73.Pp
74Memory mapped I/O can be enabled with the
75.Dq Dv ADW_ALLOW_MEMIO
76configuration option.
77Memory mapped I/O is more efficient than the alternative, programmed I/O.
78Most PCI BIOSes will map devices so that either technique for communicating
79with the card is available.
80.Sh SEE ALSO
81.Xr adv 4 ,
82.Xr cd 4 ,
83.Xr da 4 ,
84.Xr sa 4 ,
85.Xr scsi 4
86.Sh HISTORY
87The
88.Nm
89driver appeared in
90.Fx 3.0 .
91.Sh AUTHORS
92.An -nosplit
93The
94.Nm
95driver was ported by
96.An Justin T. Gibbs
97from the Linux driver written by
98.An Bob Frey
99of Advanced System Products, Inc.
100Many thanks to AdvanSys for providing the original driver
101under a suitable license for use in
102.Fx .
103