2002-09-01 07:34:47 +00:00
|
|
|
.\"
|
|
|
|
.\" Copyright (c) 1995, 1996, 1997, 1998, 2000
|
|
|
|
.\" Justin T. Gibbs. All rights reserved.
|
|
|
|
.\" Copyright (c) 2002
|
|
|
|
.\" Scott Long. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
|
|
.\" derived from this software without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" $FreeBSD$
|
|
|
|
.\"
|
|
|
|
.Dd September 1, 2002
|
|
|
|
.Dt AHD 4
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm ahd
|
|
|
|
.Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
For one or more PCI/PCI-X cards:
|
2002-12-10 14:21:55 +00:00
|
|
|
.Bd -ragged -offset indent -compact
|
2002-09-01 07:34:47 +00:00
|
|
|
.Cd device pci
|
2002-09-01 22:07:24 +00:00
|
|
|
.Cd device ahd
|
2002-12-10 14:21:55 +00:00
|
|
|
.Ed
|
2002-09-01 07:34:47 +00:00
|
|
|
.Pp
|
2002-12-10 14:21:55 +00:00
|
|
|
To compile in debugging code:
|
|
|
|
.Bd -ragged -offset indent -compact
|
2002-09-01 07:34:47 +00:00
|
|
|
.Cd options AHD_DEBUG
|
2002-09-01 22:07:24 +00:00
|
|
|
.Cd options AHD_DEBUG_OPTS=<bitmask of options>
|
2002-09-01 07:34:47 +00:00
|
|
|
.Cd options AHD_REG_PRETTY_PRINT
|
2002-12-10 14:21:55 +00:00
|
|
|
.Ed
|
2002-09-01 07:34:47 +00:00
|
|
|
.Pp
|
|
|
|
To configure one or more controllers to assume the target role:
|
2002-12-10 14:21:55 +00:00
|
|
|
.Bd -ragged -offset indent -compact
|
2002-09-01 22:07:24 +00:00
|
|
|
.Cd options AHD_TMODE_ENABLE=<bitmask of units>
|
2002-12-10 14:21:55 +00:00
|
|
|
.Ed
|
2002-09-01 07:34:47 +00:00
|
|
|
.Pp
|
2002-12-10 14:21:55 +00:00
|
|
|
For one or more
|
|
|
|
.Tn SCSI
|
|
|
|
busses:
|
|
|
|
.Bd -ragged -offset indent -compact
|
2002-09-01 07:34:47 +00:00
|
|
|
.Cd device scbus
|
2002-12-10 14:21:55 +00:00
|
|
|
.Ed
|
2002-09-01 07:34:47 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
This driver provides access to the
|
|
|
|
.Tn SCSI
|
|
|
|
bus(es) connected to Adaptec
|
|
|
|
.Tn AIC7901
|
|
|
|
and
|
|
|
|
.Tn AIC7902
|
|
|
|
host adapter chips.
|
|
|
|
These chips are found on many motherboards as well as the
|
|
|
|
.Tn 29320
|
|
|
|
and
|
|
|
|
.Tn 39320
|
2002-12-10 14:21:55 +00:00
|
|
|
Adaptec
|
|
|
|
.Tn SCSI
|
|
|
|
controller cards.
|
2002-09-01 07:34:47 +00:00
|
|
|
.Pp
|
|
|
|
Driver features include support for narrow and wide busses,
|
|
|
|
fast, ultra, ultra2, ultra160, and ultra320 synchronous transfers,
|
|
|
|
packetized transfers, tagged queueing, 512 SCB's, and target mode.
|
|
|
|
.Pp
|
|
|
|
The
|
2002-12-10 14:21:55 +00:00
|
|
|
.Dv AHD_DEBUG_OPTS
|
2002-09-01 07:34:47 +00:00
|
|
|
option is used to control which diagnostic messages are printed to the
|
|
|
|
console when
|
2002-12-10 14:21:55 +00:00
|
|
|
.Dv AHD_DEBUG
|
|
|
|
is enabled.
|
|
|
|
Logically OR the following bits together:
|
|
|
|
.Bl -column -offset indent Value Function
|
|
|
|
.Em "Value Function"
|
|
|
|
0x0001 Show miscellanious information
|
|
|
|
0x0002 Show sense data
|
|
|
|
0x0004 Show Serial EEPROM contents
|
|
|
|
0x0008 Show bus termination settings
|
|
|
|
0x0010 Show host memory usage
|
|
|
|
0x0020 Show SCSI protocol messages
|
|
|
|
0x0040 Show mode pointer of the chip register window
|
|
|
|
0x0080 Show selection timeouts
|
|
|
|
0x0100 Show FIFO usage messages
|
|
|
|
0x0200 Show Queue Full status
|
|
|
|
0x0400 Show SCB queue status
|
|
|
|
0x0800 Show inbound packet information
|
|
|
|
0x1000 Show S/G list information
|
|
|
|
0x2000 Enable extra diagnostic code in the firmware
|
2002-09-01 07:34:47 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
The
|
2002-12-10 14:21:55 +00:00
|
|
|
.Dv AHD_REG_PRETTY_PRINT
|
2002-09-01 07:34:47 +00:00
|
|
|
option compiles in support for human-readable bit definitions for each register
|
2002-12-10 14:21:55 +00:00
|
|
|
that is printed by the debugging code.
|
|
|
|
However, it also bloats the compiled
|
2002-09-01 07:34:47 +00:00
|
|
|
size of the driver by approximately 215KB.
|
|
|
|
.Pp
|
|
|
|
Individual controllers may be configured to operate in the target role
|
|
|
|
through the
|
2002-12-10 14:21:55 +00:00
|
|
|
.Dv AHD_TMODE_ENABLE
|
|
|
|
configuration option.
|
|
|
|
The value assigned to this option should be a bitmap
|
2002-09-01 07:34:47 +00:00
|
|
|
of all units where target mode is desired.
|
2002-12-10 14:21:55 +00:00
|
|
|
For example, a value of 0x25 would enable target mode on units 0, 2, and 5.
|
2002-09-01 07:34:47 +00:00
|
|
|
Note that target mode is only supoprted for ultra160 speeds and below.
|
|
|
|
.Pp
|
|
|
|
Per target configuration performed in the
|
|
|
|
.Tn SCSI-Select
|
|
|
|
menu, accessible at boot,
|
|
|
|
is honored by this driver.
|
|
|
|
This includes synchronous/asynchronous transfers,
|
|
|
|
maximum synchronous negotiation rate,
|
|
|
|
wide transfers,
|
|
|
|
disconnection,
|
2002-12-10 14:21:55 +00:00
|
|
|
and the host adapter's
|
|
|
|
.Tn SCSI
|
|
|
|
ID.
|
2002-09-01 22:07:24 +00:00
|
|
|
.Sh BUGS
|
|
|
|
The current generation of 79xx chips do not support target mode in Ultra320
|
|
|
|
mode.
|
|
|
|
Target mode in general has not been well tested in this driver.
|
2002-09-01 07:34:47 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr ahc 4 ,
|
|
|
|
.Xr cd 4 ,
|
|
|
|
.Xr da 4 ,
|
|
|
|
.Xr sa 4 ,
|
|
|
|
.Xr scsi 4
|
|
|
|
.Sh AUTHORS
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver, the
|
|
|
|
.Tn AIC7xxx
|
|
|
|
sequencer-code assembler,
|
|
|
|
and the firmware running on the aic79xx chips was written by
|
|
|
|
.An Justin T. Gibbs .
|
|
|
|
This manual page is based on the
|
|
|
|
.Xr ahc 4
|
|
|
|
manual page.
|
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver first appeared in
|
|
|
|
.Fx 4.7 .
|