/share/man/man4/ahd.4
https://bitbucket.org/freebsd/freebsd-head/ · Forth · 180 lines · 180 code · 0 blank · 0 comment · 4 complexity · 342ac5e01a2cfd7770965e903d7a105b MD5 · raw file
- .\"
- .\" 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 July 4, 2004
- .Dt AHD 4
- .Os
- .Sh NAME
- .Nm ahd
- .Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver
- .Sh SYNOPSIS
- To compile this driver into the kernel,
- place the following lines in your
- kernel configuration file:
- .Bd -ragged -offset indent
- .Cd "device pci"
- .Cd "device scbus"
- .Cd "device ahd"
- .Pp
- To compile in debugging code:
- .Cd options AHD_DEBUG
- .Cd options AHD_DEBUG_OPTS=<bitmask of options>
- .Cd options AHD_REG_PRETTY_PRINT
- .Pp
- To configure one or more controllers to assume the target role:
- .Cd options AHD_TMODE_ENABLE=<bitmask of units>
- .Ed
- .Pp
- Alternatively, to load the driver as a
- module at boot time, place the following line in
- .Xr loader.conf 5 :
- .Bd -literal -offset indent
- ahd_load="YES"
- .Ed
- .Sh DESCRIPTION
- This driver provides access to the
- .Tn SCSI
- bus(es) connected to Adaptec
- .Tn AIC79xx
- host adapter chips.
- .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
- .Dv AHD_DEBUG_OPTS
- option is used to control which diagnostic messages are printed to the
- console when
- .Dv AHD_DEBUG
- is enabled.
- Logically OR the following bits together:
- .Bl -column -offset indent Value Function
- .Em "Value Function"
- 0x0001 Show miscellaneous 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
- .El
- .Pp
- The
- .Dv AHD_REG_PRETTY_PRINT
- option compiles in support for human-readable bit definitions for each register
- that is printed by the debugging code.
- However, it also bloats the compiled
- size of the driver by approximately 215KB.
- .Pp
- Individual controllers may be configured to operate in the target role
- through the
- .Dv AHD_TMODE_ENABLE
- configuration option.
- The value assigned to this option should be a bitmap
- of all units where target mode is desired.
- For example, a value of 0x25 would enable target mode on units 0, 2, and 5.
- Note that target mode is only supported 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,
- and the host adapter's
- .Tn SCSI
- ID.
- .Sh HARDWARE
- The
- .Nm
- driver supports the following:
- .Pp
- .Bl -bullet -compact
- .It
- Adaptec
- .Tn AIC7901
- host adapter chip
- .It
- Adaptec
- .Tn AIC7901A
- host adapter chip
- .It
- Adaptec
- .Tn AIC7902
- host adapter chip
- .It
- Adaptec
- .Tn 29320
- host adapter
- .It
- Adaptec
- .Tn 39320
- host adapter
- .It
- Many motherboards with on-board
- .Tn SCSI
- support
- .El
- .Sh SEE ALSO
- .Xr ahc 4 ,
- .Xr cd 4 ,
- .Xr da 4 ,
- .Xr sa 4 ,
- .Xr scsi 4
- .Sh HISTORY
- The
- .Nm
- driver first appeared in
- .Fx 4.7 .
- .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 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.