1.\" $OpenBSD: ahd.4,v 1.18 2012/08/14 01:08:19 dlg Exp $ 2.\" 3.\" Copyright (c) 1995, 1996, 1997, 1998, 2000 4.\" Justin T. Gibbs. All rights reserved. 5.\" Copyright (c) 2002 6.\" Scott Long. All rights reserved. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in the 15.\" documentation and/or other materials provided with the distribution. 16.\" 3. The name of the author may not be used to endorse or promote products 17.\" derived from this software without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 20.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 21.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 22.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 23.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 24.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 28.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29.\" 30.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/ahd.4,v 1.5 2004/07/04 14:17:41 simon Exp $ 31.\" 32.Dd $Mdocdate: August 14 2012 $ 33.Dt AHD 4 34.Os 35.Sh NAME 36.Nm ahd 37.Nd Adaptec PCI/PCI-X AIC79xx-based Ultra320 SCSI interface 38.Sh SYNOPSIS 39.Cd "ahd* at pci?" 40.Sh DESCRIPTION 41.Nm 42provides access to the 43.Tn SCSI 44bus(es) connected to Adaptec 45.Tn AIC79xx 46host adapter chips. 47.Pp 48.Nm 49supports narrow and wide buses; synchronous and 50asynchronous operation; fast, ultra, ultra2, ultra160, and ultra320 51(packetized) transfers; tagged queuing and 512 SCBs. 52.Pp 53.Nm 54does not support target mode operation. 55.Pp 56The 57.Nm 58driver supports the following: 59.Pp 60.Bl -bullet -compact -offset indent 61.It 62Adaptec 63.Tn AIC7901 64host adapter chip 65.It 66Adaptec 67.Tn AIC7901A 68host adapter chip 69.It 70Adaptec 71.Tn AIC7902 72host adapter chip 73.It 74Adaptec 75.Tn 29320 76host adapter 77.It 78Adaptec 79.Tn 39320 80host adapter 81.It 82Many motherboards with on-board 83.Tn SCSI 84support 85.El 86.Pp 87To compile in debugging code: 88.Bd -ragged -offset indent 89.Cd option AHD_DEBUG 90.Cd option AHD_DEBUG_OPTS=<bitmask of options> 91.Ed 92.Pp 93The 94.Dv AHD_DEBUG_OPTS 95option is used to control which diagnostic messages are printed to the 96console when 97.Dv AHD_DEBUG 98is enabled. 99Logically OR the following bits together: 100.Bl -column "0x0001" "Function" -offset indent 101.It Em Value Ta Em Function 102.It 0x0001 Ta "Show miscellaneous information" 103.It 0x0002 Ta "Show sense data" 104.It 0x0004 Ta "Show Serial EEPROM contents" 105.It 0x0008 Ta "Show bus termination settings" 106.It 0x0010 Ta "Show host memory usage" 107.It 0x0020 Ta "Show SCSI protocol messages" 108.It 0x0040 Ta "Show mode pointer of the chip register window" 109.It 0x0080 Ta "Show selection timeouts" 110.It 0x0100 Ta "Show FIFO usage messages" 111.It 0x0200 Ta "Show Queue Full status" 112.It 0x0400 Ta "Show SCB queue status" 113.It 0x0800 Ta "Show inbound packet information" 114.It 0x1000 Ta "Show S/G list information" 115.It 0x2000 Ta "Enable extra diagnostic code in the firmware" 116.El 117.Pp 118Per target configuration performed in the 119.Tn SCSI-Select 120menu, accessible at boot, 121is honored by this driver. 122This includes synchronous/asynchronous transfers, 123maximum synchronous negotiation rate, 124wide transfers, 125disconnection, 126and the host adapters 127.Tn SCSI 128ID. 129.Sh SEE ALSO 130.Xr ahc 4 , 131.Xr cd 4 , 132.Xr ch 4 , 133.Xr intro 4 , 134.Xr pci 4 , 135.Xr scsi 4 , 136.Xr sd 4 , 137.Xr st 4 , 138.Xr uk 4 139.Sh HISTORY 140The 141.Nm 142driver was ported from 143.Fx 4.7 144and first appeared in 145.Ox 3.6 . 146.Sh AUTHORS 147The 148.Nm 149driver, the 150.Tn AIC7xxx 151sequencer-code assembler, 152and the firmware running on the aic79xx chips was written by 153.An Justin T. Gibbs . 154.Pp 155.Ox 156port by Milos Urbanek, Kenneth R. Westerback & Marco Peereboom. 157