1.\" $NetBSD: dpt.4,v 1.12 2000/07/05 15:17:38 msaitoh Exp $ 2.\" 3.\" Copyright (c) 1999, 2000 Andy Doran <ad@NetBSD.org> 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. The name of the author may not be used to endorse or promote products 12.\" derived from this software without specific prior written permission 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 16.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 18.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 19.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 20.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 21.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 23.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24.\" 25.Dd September 28, 1999 26.Dt DPT 4 27.Os 28.Sh NAME 29.Nm dpt 30.Nd 31.Tn DPT EATA SCSI adapter driver 32.Sh SYNOPSIS 33.Cd "dpt* at isa? port ? irq ? dma ?" 34.Cd "dpt* at eisa? slot ?" 35.Cd "dpt* at pci? dev ? function ?" 36.Cd "scsibus* at dpt?" 37.Sh DESCRIPTION 38The 39.Nm 40driver provides support for third and fourth generation DPT SCSI 41controllers. All communication with the controllers is conducted via the 42EATA (Enhanced AT Bus Attachment) protocol (CAM committee standard 43CAM/89-004). 44.Pp 45DPT adapters examine and interpret all SCSI commands received before passing 46them to any underlying physical device(s). In this way, caching, RAID and 47other transformations are achieved while remaining transparent to the host 48operating system. 49.Sh HARDWARE 50The 51.Nm 52driver provides support for the following 53.Tn SCSI 54adapters: 55.Pp 56.Bl -tag -width -offset indent -compact 57.It Tn DPT SmartCache III 58.It Tn DPT SmartCache IV 59.It Tn DPT SmartRAID III 60.It Tn DPT SmartRAID IV 61.El 62.Sh DIAGNOSTICS 63None of these messages should be encountered under normal circumstances. It 64should be noted that the list below is not complete. 65.Pp 66.Bl -tag -width indent 67.It dpt%d: readcfg failed - see dpt(4) 68.br 69The EATA configuration data did not appear upon request. This may be caused 70by older firmware. Generally the solution is to power-cycle the affected 71machine. 72.br 73.It dpt%d: spurious intr 74.br 75A spurious interrupt was recieved from the HBA. 76.br 77.It dpt%d: bogus status (returned CCB id NNNN) 78.br 79A corrupt or incomplete status packet was recieved from the HBA. 80.El 81.Sh SEE ALSO 82.Xr intro 4 , 83.Xr cd 4 , 84.Xr ch 4 , 85.Xr scsi 4 , 86.Xr sd 4 , 87.Xr st 4 88.Sh AUTHOR 89The 90.Nm 91driver was written by Andy Doran 92.Aq ad@netbsd.org , 93based upon the 94.Nm uha 95and 96.Nm bha 97drivers, which are the work of others. 98.Sh HISTORY 99The 100.Nm dpt 101driver first appeared in 102.Nx 1.4.2 . 103.Sh BUGS 104EATA adapters other than listed may function correctly with the 105.Nm 106driver, however a definitive list is not avaiable. 107.Pp 108Older firmware may prove problematic. It is recommended that the latest 109available firmware be used. Contact DPT for a firmware update. 110.Pp 111Older boards that do not suppport scatter-gather I/O or DMA are not supported. 112.Pp 113The number of queued commands available on ISA devices is clamped. 114.Pp 115The current SCSI subsystem can not take full advantage of the capabilities 116provided by DPT adapters. 117.Pp 118ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not 119work correctly with the PM2041 and certain firmware revisions of the PM3334. 120