/share/man/man4/bt.4

  1.\"
  2.\" Copyright (c) 1994 Jordan Hubbard
  3.\" All rights reserved.
  4.\"
  5.\" Redistribution and use in source and binary forms, with or without
  6.\" modification, are permitted provided that the following conditions
  7.\" are met:
  8.\" 1. Redistributions of source code must retain the above copyright
  9.\"    notice, this list of conditions and the following disclaimer.
 10.\" 2. Redistributions in binary form must reproduce the above copyright
 11.\"    notice, this list of conditions and the following disclaimer in the
 12.\"    documentation and/or other materials provided with the distribution.
 13.\" 3. The name of the author may not be used to endorse or promote products
 14.\"    derived from this software without specific prior written permission
 15.\"
 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 26.\"
 27.\" $FreeBSD$
 28.\"
 29.Dd June 18, 2006
 30.Dt BT 4
 31.Os
 32.Sh NAME
 33.Nm bt
 34.Nd Buslogic/Mylex MultiMaster SCSI host adapter driver
 35.Sh SYNOPSIS
 36To compile this driver into the kernel,
 37place the following lines in your
 38kernel configuration file:
 39.Bd -ragged -offset indent
 40.Cd "device isa"
 41.Cd "device scbus"
 42.Cd "device bt"
 43.Pp
 44In
 45.Pa /boot/device.hints :
 46.Cd hint.bt.0.at="isa"
 47.Cd hint.bt.0.port="0x330"
 48.Ed
 49.Sh DESCRIPTION
 50This driver provides access to the
 51.Tn SCSI
 52bus connected to a Buslogic/Mylex MultiMaster or compatible controller:
 53.Bd -ragged -offset indent
 54MultiMaster "W" Series Host Adapters:
 55.Bl -column "BT-956CD " "ISA " "Commands " "Description"
 56.Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
 57BT-948	PCI	192	Ultra SCSI-3
 58BT-958	PCI	192	Wide Ultra SCSI-3
 59BT-958D	PCI	192	Wide Differential Ultra SCSI-3
 60.El
 61.Pp
 62MultiMaster "C" Series Host Adapters:
 63.Bl -column "BT-956CD " "ISA " "Commands " "Description"
 64.Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
 65BT-946C	PCI	100	Fast SCSI-2
 66BT-956C	PCI	100	Wide Fast SCSI-2
 67BT-956CD	PCI	100	Wide Differential Fast SCSI-2
 68BT-445C	VLB	100	Fast SCSI-2
 69BT-747C	EISA	100	Fast SCSI-2
 70BT-757C	EISA	100	Wide Fast SCSI-2
 71BT-757CD	EISA	100	Wide Differential Fast SCSI-2
 72BT-545C	ISA	50	Fast SCSI-2
 73BT-540CF	ISA	50	Fast SCSI-2
 74.El
 75.Pp
 76MultiMaster "S" Series Host Adapters:
 77.Bl -column "BT-956CD " "ISA " "Commands " "Description"
 78.Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
 79BT-445S	VLB	30	Fast SCSI-2
 80BT-747S	EISA	30	Fast SCSI-2
 81BT-747D	EISA	30	Differential Fast SCSI-2
 82BT-757S	EISA	30	Wide Fast SCSI-2
 83BT-757D	EISA	30	Wide Differential Fast SCSI-2
 84BT-545S	ISA	30	Fast SCSI-2
 85BT-542D	ISA	30	Differential Fast SCSI-2
 86BT-742A	EISA	30	SCSI-2 (742A revision H)
 87BT-542B	ISA	30	SCSI-2 (542B revision H)
 88.El
 89.Pp
 90MultiMaster "A" Series Host Adapters:
 91.Bl -column "BT-956CD " "ISA " "Commands " "Description"
 92.Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
 93BT-742A	EISA	30	SCSI-2 (742A revisions A - G)
 94BT-542B	ISA	30	SCSI-2 (542B revisions A - G)
 95.El
 96.Ed
 97.Pp
 98Tagged queueing is supported on 'W' series adapters, 'C' series adapters
 99with firmware of rev 4.42 and higher, and 'S' series adapters with firmware
100of rev 3.35 and higher.
101.Pp
102Boards with certain firmware revisions may lock up under heavy load to
103certain devices, especially if tagged queueing is used.
104Should you encounter
105a problem with your adapter, contact Mylex technical support and ensure you
106have the latest firmware for your controller.
107.Sh HARDWARE
108The
109.Nm
110driver supports the following BusLogic MultiMaster
111.Dq W ,
112.Dq C ,
113.Dq S ,
114and
115.Dq A
116series and compatible SCSI host adapters:
117.Pp
118.Bl -bullet -compact
119.It
120BusLogic BT-445C
121.It
122BusLogic BT-445S
123.It
124BusLogic BT-540CF
125.It
126BusLogic BT-542B
127.It
128BusLogic BT-542B
129.It
130BusLogic BT-542D
131.It
132BusLogic BT-545C
133.It
134BusLogic BT-545S
135.It
136BusLogic/BusTek BT-640
137.It
138BusLogic BT-742A
139.It
140BusLogic BT-742A
141.It
142BusLogic BT-747C
143.It
144BusLogic BT-747D
145.It
146BusLogic BT-747S
147.It
148BusLogic BT-757C
149.It
150BusLogic BT-757CD
151.It
152BusLogic BT-757D
153.It
154BusLogic BT-757S
155.It
156BusLogic BT-946C
157.It
158BusLogic BT-948
159.It
160BusLogic BT-956C
161.It
162BusLogic BT-956CD
163.It
164BusLogic BT-958
165.It
166BusLogic BT-958D
167.It
168Storage Dimensions SDC3211B / SDC3211F
169.El
170.Pp
171AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones
172are also supported by the
173.Nm
174driver.
175.Sh SEE ALSO
176.Xr cd 4 ,
177.Xr da 4 ,
178.Xr sa 4 ,
179.Xr scsi 4
180.Sh HISTORY
181The
182.Nm
183driver first appeared in the
184.Bx 386
185patch kit.
186.Sh AUTHORS
187.An -nosplit
188.An Julian Elischer
189wrote a driver for the Multimaster cards that appeared in the
190.Bx 386
191patch kit.
192The driver was rewritten by
193.An Justin T. Gibbs
194to take advantage of new board features and work with the CAM SCSI framework in
195.Fx 3.0 .
196.Pp
197Special thanks to
198.An Leonard N. Zubkoff
199for writing such a complete and well documented Mylex/BusLogic MultiMaster
200driver for Linux.
201Support in this driver for the wide range of MultiMaster
202controllers and firmware revisions, with their otherwise undocumented quirks,
203would not have been possible without his efforts.