1.\" $OpenBSD: ahd.4,v 1.17 2011/09/03 22:59:08 jmc 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: September 3 2011 $ 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.Cd "scsibus* at ahd?" 41.Sh DESCRIPTION 42.Nm 43provides access to the 44.Tn SCSI 45bus(es) connected to Adaptec 46.Tn AIC79xx 47host adapter chips. 48.Pp 49.Nm 50supports narrow and wide buses; synchronous and 51asynchronous operation; fast, ultra, ultra2, ultra160, and ultra320 52(packetized) transfers; tagged queuing and 512 SCBs. 53.Pp 54.Nm 55does not support target mode operation. 56.Pp 57The 58.Nm 59driver supports the following: 60.Pp 61.Bl -bullet -compact -offset indent 62.It 63Adaptec 64.Tn AIC7901 65host adapter chip 66.It 67Adaptec 68.Tn AIC7901A 69host adapter chip 70.It 71Adaptec 72.Tn AIC7902 73host adapter chip 74.It 75Adaptec 76.Tn 29320 77host adapter 78.It 79Adaptec 80.Tn 39320 81host adapter 82.It 83Many motherboards with on-board 84.Tn SCSI 85support 86.El 87.Pp 88To compile in debugging code: 89.Bd -ragged -offset indent 90.Cd option AHD_DEBUG 91.Cd option AHD_DEBUG_OPTS=<bitmask of options> 92.Ed 93.Pp 94The 95.Dv AHD_DEBUG_OPTS 96option is used to control which diagnostic messages are printed to the 97console when 98.Dv AHD_DEBUG 99is enabled. 100Logically OR the following bits together: 101.Bl -column "0x0001" "Function" -offset indent 102.It Em Value Ta Em Function 103.It 0x0001 Ta "Show miscellaneous information" 104.It 0x0002 Ta "Show sense data" 105.It 0x0004 Ta "Show Serial EEPROM contents" 106.It 0x0008 Ta "Show bus termination settings" 107.It 0x0010 Ta "Show host memory usage" 108.It 0x0020 Ta "Show SCSI protocol messages" 109.It 0x0040 Ta "Show mode pointer of the chip register window" 110.It 0x0080 Ta "Show selection timeouts" 111.It 0x0100 Ta "Show FIFO usage messages" 112.It 0x0200 Ta "Show Queue Full status" 113.It 0x0400 Ta "Show SCB queue status" 114.It 0x0800 Ta "Show inbound packet information" 115.It 0x1000 Ta "Show S/G list information" 116.It 0x2000 Ta "Enable extra diagnostic code in the firmware" 117.El 118.Pp 119Per target configuration performed in the 120.Tn SCSI-Select 121menu, accessible at boot, 122is honored by this driver. 123This includes synchronous/asynchronous transfers, 124maximum synchronous negotiation rate, 125wide transfers, 126disconnection, 127and the host adapters 128.Tn SCSI 129ID. 130.Sh SEE ALSO 131.Xr ahc 4 , 132.Xr cd 4 , 133.Xr ch 4 , 134.Xr intro 4 , 135.Xr pci 4 , 136.Xr scsi 4 , 137.Xr sd 4 , 138.Xr st 4 , 139.Xr uk 4 140.Sh HISTORY 141The 142.Nm 143driver was ported from 144.Fx 4.7 145and first appeared in 146.Ox 3.6 . 147.Sh AUTHORS 148The 149.Nm 150driver, the 151.Tn AIC7xxx 152sequencer-code assembler, 153and the firmware running on the aic79xx chips was written by 154.An Justin T. Gibbs . 155.Pp 156.Ox 157port by Milos Urbanek, Kenneth R. Westerback & Marco Peereboom. 158