1.\" 2.\" Copyright (c) 1995, 1996, 1997, 1998, 2000 3.\" Justin T. Gibbs. All rights reserved. 4.\" Copyright (c) 2002 5.\" Scott Long. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. The name of the author may not be used to endorse or promote products 16.\" derived from this software without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 19.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 20.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 21.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 22.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 23.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 24.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 25.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 27.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28.\" 29.\" $FreeBSD$ 30.\" 31.Dd September 1, 2002 32.Dt AHD 4 33.Os 34.Sh NAME 35.Nm ahd 36.Nd Adaptec PCI/PCI-X Ultra320 SCSI host adapter driver 37.Sh SYNOPSIS 38For one or more PCI/PCI-X cards: 39.Cd device pci 40.Cd device ahd 41.Pp 42To compile in debugging code. 43.Cd options AHD_DEBUG 44.Cd options AHD_DEBUG_OPTS=<bitmask of options> 45.Cd options AHD_REG_PRETTY_PRINT 46.Pp 47To configure one or more controllers to assume the target role: 48.Cd options AHD_TMODE_ENABLE=<bitmask of units> 49.Pp 50For one or more SCSI busses: 51.Cd device scbus 52.Sh DESCRIPTION 53This driver provides access to the 54.Tn SCSI 55bus(es) connected to Adaptec 56.Tn AIC7901 57and 58.Tn AIC7902 59host adapter chips. 60These chips are found on many motherboards as well as the 61.Tn 29320 62and 63.Tn 39320 64Adaptec SCSI controller cards. 65.Pp 66Driver features include support for narrow and wide busses, 67fast, ultra, ultra2, ultra160, and ultra320 synchronous transfers, 68packetized transfers, tagged queueing, 512 SCB's, and target mode. 69.Pp 70The 71.Dq Dv AHD_DEBUG_OPTS 72option is used to control which diagnostic messages are printed to the 73console when 74.Dq Dv AHD_DEBUG 75is enabled. Logically 'or' the following bits together: 76.Pp 77.Bd -ragged -offset indent 78.Bl -column "Value " Function 79.Em "Value Function" 800x0001 Show miscellanious information 810x0002 Show sense data 820x0004 Show Serial EEPROM contents 830x0008 Show bus termination settings 840x0010 Show host memory usage 850x0020 Show SCSI protocol messages 860x0040 Show mode pointer of the chip register window 870x0080 Show selection timeouts 880x0100 Show FIFO usage messages 890x0200 Show Queue Full status 900x0400 Show SCB queue status 910x0800 Show inbound packet information 920x1000 Show S/G list information 930x2000 Enable extra diagnostic code in the firmware 94.El 95.Ed 96.Pp 97The 98.Dq Dv AHD_REG_PRETTY_PRINT 99option compiles in support for human-readable bit definitions for each register 100that is printed by the debugging code. However, it also bloats the compiled 101size of the driver by approximately 215KB. 102.Pp 103Individual controllers may be configured to operate in the target role 104through the 105.Dq Dv AHD_TMODE_ENABLE 106configuration option. The value assigned to this option should be a bitmap 107of all units where target mode is desired. 108For example, a value of 0x25, would enable target mode on units 0, 2, and 5. 109Note that target mode is only supoprted for ultra160 speeds and below. 110.Pp 111Per target configuration performed in the 112.Tn SCSI-Select 113menu, accessible at boot, 114is honored by this driver. 115This includes synchronous/asynchronous transfers, 116maximum synchronous negotiation rate, 117wide transfers, 118disconnection, 119and the host adapter's SCSI ID. 120.Pp 121.Sh BUGS 122The current generation of 79xx chips do not support target mode in Ultra320 123mode. 124Target mode in general has not been well tested in this driver. 125.Pp 126.Sh SEE ALSO 127.Xr ahc 4 , 128.Xr cd 4 , 129.Xr da 4 , 130.Xr sa 4 , 131.Xr scsi 4 132.Sh AUTHORS 133The 134.Nm 135driver, the 136.Tn AIC7xxx 137sequencer-code assembler, 138and the firmware running on the aic79xx chips was written by 139.An Justin T. Gibbs . 140This manual page is based on the 141.Xr ahc 4 142manual page. 143.Sh HISTORY 144The 145.Nm 146driver first appeared in 147.Fx 4.7 . 148