1.\" $NetBSD: dpt.4,v 1.18 2002/02/07 03:15:08 ross 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 31DPT EATA 32.Tn SCSI 33adapter driver 34.Sh SYNOPSIS 35.Cd "dpt* at isa? port ? irq ? dma ?" 36.Cd "dpt* at eisa? slot ?" 37.Cd "dpt* at pci? dev ? function ?" 38.Cd "scsibus* at dpt?" 39.Sh DESCRIPTION 40The 41.Nm 42driver provides support for third and fourth generation DPT 43.Tn SCSI 44controllers. All communication with the controllers is conducted via the 45EATA (Enhanced AT Bus Attachment) protocol. 46.Pp 47DPT adapters examine and interpret all 48.Tn SCSI 49commands received before passing them to any underlying physical device(s). 50In this way, caching, RAID and other transformations are achieved while 51remaining transparent to the host operating system. 52.Sh HARDWARE 53The 54.Nm 55driver provides support for the adapters listed below. Later models are 56supported by the 57.Nm iop 58driver. 59.Pp 60.Bl -tag -width Dv -offset indent -compact 61.It Tn DPT SmartCache III 62.It Tn DPT SmartCache IV 63.It Tn DPT SmartRAID III 64.It Tn DPT SmartRAID IV 65.El 66.Sh DIAGNOSTICS 67None of these messages should be encountered under normal circumstances. It 68should be noted that the list below is not complete. 69.Pp 70.Bl -tag -width indent 71.It dpt%d: readcfg failed - see dpt(4) 72.br 73The EATA configuration data did not appear upon request. This may be caused 74by older firmware. Generally the solution is to power-cycle the affected 75machine. 76.br 77.It dpt%d: spurious intr 78.br 79A spurious interrupt was received from the HBA. 80.br 81.It dpt%d: bogus status (returned CCB id NNNN) 82.br 83A corrupt or incomplete status packet was received from the HBA. 84.El 85.Sh SEE ALSO 86.Xr cd 4 , 87.Xr ch 4 , 88.Xr intro 4 , 89.Xr iop 4 , 90.Xr scsi 4 , 91.Xr sd 4 , 92.Xr st 4 93.Pp 94CAM committee standard CAM/89-004 - the EATA (Enhanced AT Bus Attachment) 95protocol. 96.Sh HISTORY 97The 98.Nm dpt 99driver first appeared in 100.Nx 1.4.2 . 101.Sh AUTHORS 102The 103.Nm 104driver was written by 105.An Andrew Doran Aq ad@netbsd.org , 106based upon the 107.Nm uha 108and 109.Nm bha 110drivers, which are the work of others. 111.Sh BUGS 112EATA adapters other than listed may function correctly with the 113.Nm 114driver, however a definitive list is not available. 115.Pp 116Older firmware may prove problematic. It is recommended that the latest 117available firmware be used. Contact DPT for a firmware update. 118.Pp 119Older boards that do not support scatter-gather I/O or DMA are not supported. 120.Pp 121The number of queued commands available on ISA devices is clamped. 122.Pp 123ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not 124work correctly with the PM2041 and certain firmware revisions of the PM3334. 125