diff options
Diffstat (limited to 'share/man')
| -rw-r--r-- | share/man/man4/ahd.4 | 182 |
1 files changed, 182 insertions, 0 deletions
diff --git a/share/man/man4/ahd.4 b/share/man/man4/ahd.4 new file mode 100644 index 00000000000..bb5b2754a67 --- /dev/null +++ b/share/man/man4/ahd.4 @@ -0,0 +1,182 @@ +.\" $OpenBSD: ahd.4,v 1.1 2004/07/05 21:08:19 marco Exp $ +.\" +.\" 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: /repoman/r/ncvs/src/share/man/man4/ahd.4,v 1.5 2004/07/04 14:17:41 simon Exp $ +.\" +.Dd July 5, 2004 +.Dt AHD 4 +.Os +.Sh NAME +.Nm ahd +.Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver +.Sh SYNOPSIS +.Cd "ahd* at pci? dev ? function ?" +.Cd "scsibus* at ahd?" +.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 queuing, 512 SCB's, and target mode. +.Pp +The +.Nm +driver supports the following: +.Pp +.Bl -bullet -compact -offset indent +.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 +.Pp +To compile in debugging code: +.Bd -ragged -offset indent -compact +.Cd options AHD_DEBUG +.Cd options AHD_DEBUG_OPTS=<bitmask of options> +.Cd options AHD_REG_PRETTY_PRINT +.Ed +.Pp +To configure one or more controllers to assume the target role: +.Bd -ragged -offset indent -compact +.Cd options AHD_TMODE_ENABLE=<bitmask of units> +.Ed +.Pp +.Bd -ragged -offset indent -compact +.Ed +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 adapters +.Tn SCSI +ID. +.Sh BUGS +The current generation of 79xx chips do not support target mode in Ultra320 +mode. +In this driver all target mode code has been commented out. +.Pp +Currently the driver has issues with Rev B of the AIC7902 chip. +.Sh SEE ALSO +.Xr ahc 4 , +.Xr cd 4 , +.Xr ch 4 , +.Xr intro 4 , +.Xr pci 4 , +.Xr scsi 4 , +.Xr sd 4 , +.Xr st 4 , +.Xr uk 4 +.Sh HISTORY +The +.Nm +driver was ported from +.Fx 4.7 +and first appeared in +.Ox 3.6 . +.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 . +.Pp +OpenBSD port by Milos Urbanek, Kenneth R. Westerback & Marco Peereboom. |