1.\" $OpenBSD: mpt.4,v 1.3 2004/03/31 03:45:40 marco Exp $ 2.\" 3.\" Copyright (c) 2003 Wasabi Systems, Inc. 4.\" All rights reserved. 5.\" 6.\" Written by Jason R. Thorpe for Wasabi Systems, Inc. 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. All advertising materials mentioning features or use of this software 17.\" must display the following acknowledgement: 18.\" This product includes software developed for the NetBSD Project by 19.\" Wasabi Systems, Inc. 20.\" 4. The name of Wasabi Systems, Inc. may not be used to endorse 21.\" or promote products derived from this software without specific prior 22.\" written permission. 23.\" 24.\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND 25.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 26.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 27.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC 28.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 29.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34.\" POSSIBILITY OF SUCH DAMAGE. 35.\" 36.Dd February 25, 2004 37.Dt MPT 4 38.Os 39.Sh NAME 40.Nm mpt 41.Nd LSI Fusion-MPT SCSI and FibreChannel host adapter driver 42.Sh SYNOPSIS 43.Cd "mpt* at pci? dev ? function ?" 44.Cd "scsibus* at mpt?" 45.Sh DESCRIPTION 46The 47.Nm 48driver provides support 49for the LSI Logic Fusion-MPT family of 50.Tn SCSI 51and 52.Tn Fibre Channel 53controllers: 54.Pp 55.Bl -bullet -compact -offset indent 56.It 5753c1020 58.Pq Single Ultra320 Tn SCSI 59.It 6053c1030 61.Pq Dual Ultra320 Tn SCSI 62.It 63FC909 64.Pq 1Gb/s Tn Fibre Channel 65.It 66FC909A 67.Pq Dual 1Gb/s Tn Fibre Channel 68.It 69FC919 70.Pq 2Gb/s Tn Fibre Channel 71.It 72FC929 73.Pq Dual 2Gb/s Tn Fibre Channel 74.It 75Emulated in VMWare ESX Server 2 76.El 77.Pp 78The LSI Logic SCSI and Fibre Channel controllers contain firmware that presents 79a multiprotocol service layer based on the LSI Logic Fusion-MPT architecture. 80The firmware isolates the host drivers from the hardware and controls the 81device side of the message passing interface to the host device drivers. 82The firmware manages all phases of an I/O request and optimizes the interrupt 83management for the system. 84For Fibre Channel, the firmware also manages all FC-2 through FC-4 services, 85which minimizes the amount of Fibre Channel unique services required with the 86host driver. 87.Pp 88The MPI (Message Passing Interface) defintion includes a register-level 89transport mechanism and a messaging protocol. 90A system doorbell and message queues define the MPI transport interface. 91Inbound Message Frames (MF), allocated in host memory, indentify I/O operations 92to be performed by the IO Controller (IOC). 93These operations are queued on the Request Queue by the host driver. 94Outbound Message Frames, also in host memory, track I/O operations as they 95complete. 96These frames are queued on the Reply Queue by the IOC. 97A doorbell mechanism is provided for IOC configuration, reset management, 98and IOC status. 99.Sh SEE ALSO 100.Xr cd 4 , 101.Xr ch 4 , 102.Xr intro 4 , 103.Xr pci 4 , 104.Xr scsi 4 , 105.Xr sd 4 , 106.Xr siop 4 , 107.Xr \&st 4 , 108.Xr uk 4 109.Sh HISTORY 110The 111.Nm 112driver first appeared in 113.Ox 3.5 . 114.Sh AUTHORS 115The 116.Om 117driver was ported from 118.Nx 119by Milos Urbanek, Kenneth R. Westerback and Marco Peereboom. 120.Sh BUGS 121This driver does not function properly with MPT firmware levels higher than 1221.03.00. 123.Pp 124The runtime MPT firmware is displayed under the REV heading for the 1020/1030 125chips during POST. 126Example: 127.Bd -literal 128HBA ID LUN VENDOR PRODUCT REV SYNC WIDE 129--- -- --- -------- ---------------- -------- ----- ---- 130 0 7 0 LSILogic 1020/1030[ 102] 1013D00 320.0 16 131 1 7 0 LSILogic 1020/1030[ 102] 1013D00 320.0 16 132.Ed 133.Pp 134The version is 1013D00 which translates to 1.01.3D.00. 135The last two digits are normally not used and it is written in decimal notation. 136Thus making this example version 1.01.61. 137