ftp.nice.ch/pub/next/system/driver/scsi/BusLogicFamily.1.20.I.bd.tar.gz#/BusLogicFamily_1.20/BusLogicFamily_NS3.3 4.0.rtf

This is BusLogicFamily_NS3.3 4.0.rtf in view mode; [Download] [Up]

BusLogic Family SCSI Adapter Device Driver
by
Tomas Hurka, Hukatronic  tom@hukatronic.cz



Version 1.20 of BusLogic Family SCSI Adapter Device Driver for NEXTSTEP Release 3.2 and 3.3 for Intel Processors and OPENSTEP 4.0 /Mach


OVERVIEW:

BusLogic Family SCSI adapter device driver lets you take advantage of the following SCSI adapters:
Manufacturer	Adapter	PC Bus	Tested firmware
Bus Logic	445S	VL-Bus	3.31C, 3.36 , 3.37
Bus Logic	445C	VL-Bus	4.21
Bus Logic	747S	EISA	3.31C, 3.37
Bus Logic	946C	PCI	4.22

Note: There is a very high probability that other version of firmware mentioned above will work with driver.
 
WARRANTY:

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

COPYING:
The BusLogicFamily is shareware. You can freely distribute without changing or removing any parts of the package. If you found the driver reliable, please, register the driver. For more details see document Registration.rtf.
	
Changes between version 1.0 and 1.13:
1.	The driver was tested and works with these versions of the firmware on BT445S:
	3.31C,
	3.36,
	3.37.
2.	The driver was tested and works with these versions of the firmware on BT747S:
	3.37.
3.	The driver works correctly with Toshiba XM-3401 CD-ROM and CDPlayer.app. The only thing you need is a program called XAmode, which switchs TOSHIBA to XAmode. This also enables you to read KodakPhotoCD. XAmode is available from anonymous ftp ftp.uni-stuttgart.de:/pub/systems/next/Tools .
4.	Better timeout handling.
5.	Copying policy of the driver was changed from freeware to shareware.
6. 	The name of the driver was changed from BusLogicBT445S to BusLogicFamily.

Changes between version 1.13 and 1.16:
1.	The version 1.13 of the driver was tested and works with these versions of the firmware on BT445C:
	4.21
2.	The driver was adapted to work with PCI BT946C and was tested with these versions of the firmware:
	4.22
3.	The driver now uses the disconnect flag from scsiReq to determine the correct disconnection setting.
4.	The SCSI selection timeout was extended from a of default 250 ms to 500 ms.

Changes between version 1.16 and 1.20:
1.	Driver now supports SCSI command queuing. Driver automatically detects SCSI devices supporting command queuing and it is enabled only for devices which supports it. For better compatibility the command queueing is enabled after establishing the Synchronous transfer mode (if enabled), since most devices that support command queuing may not be able to handle an ID message, followed by a Tag Message, followed by a Synchronous Transfer Negotiations message.
2.	BusLogic_PCI.table for PCI BT946 card was added. This will enable BT946C cards, from revision C on up, to use NeXTSTEP PCI support. This entry is unfortunately untested, but should work.

Release 1.0 notes:
1.	We have found at least one particular configuration (Gateway 4DX2/66V board, PAS-16 sound adapter, Logitech bus mouse, ATI UltraPro graphics, SEAGATE ST3600N hard disk) where this driver doesn't work properly. Anyway, even NeXT's universal Adaptec154x Driver doesn't work with the same configuration. Should you experience any difficulties, we welcome your feedback so that we can remove the problems.

Release 1.13 notes:
1.	The BusLogic BT946C PCI card does not work yet. :-(

Release 1.16 notes:
1.	The BusLogic BT946C PCI card is finally supported.

Release 1.20 notes:
1.	Driver supports SCSI command queuing.
2.	SCSI command queuing can be disabled/enabled via Configure.app
3.	When you are upgrading from the older version,  you must first remove the old driver from your SCSI devices list. Upgrade the driver and finally add the new driver to your configuration.

INSTALLATION:

These instructions show you how to install the BusLogic SCSI adapter device driver on an Intel-based computer running NEXTSTEPä Release 3.2 and 3.3. The driver is distributed as a file named BusLogicFamily_1.20.tar.gz.

1.	If you received the BusLogicFamily_1.20.tar.gz file via NeXTmailä or downloaded via FTP or another electronic source, place a copy of the file in a location where you can access it when you log in as root.
2.	Log in as root.
	Only the superuser, root, can install the device drivers. If you're not sure how to log in as root, see your system administrator.
3.	Double-click the BusLogicFamily_1.20.tar.gz file to uncompress and unarchive it.
4.	Double-click the BusLogicFamily.config. It automatically launches Configure.app and copies the driver into /NextLibary/Devices directory.
5.	Add the Buslogic driver as a SCSI device, and configure IRQ and port address according to the card setting. The default setting is the same as Adaptec's setting and should be okay for most cases. 
6.	Save configuration and quit Configure.app.
7.	Reboot computer.
8.	See NeXTanswer #1824 for general information on installing and configuring device drivers.

INSTALLATION of the NSFIP from the scratch with BusLogic card:

These instructions show you how to install NEXSTEP with the BusLogic SCSI adapter and BusLogicFamily device driver on an Intel-based computer running NEXTSTEPä Release 3.3 or OPENSTEPä 4.0/Mach. The driver is distributed as a file named BusLogicFamily_1.20.tar.gz.

1.	The driver BusLogicFamily.config must be on a NeXT formatted floppy in directory /private/Drivers/i386/
2.	See NeXTanswer #1824 for general information on installing and configuring device drivers.

Notes about hardware setting of BT-445S:
1.	In order to achieve a 10MBytes/sec transfer rate, the 'Maximim Synchronous Data Rate Allowed' option must be enabled (switch 7 -Off) and the 'Adapter Initiate Synchronous Negotiation must be enabled (switch€6€-€Off). 
2.	Some older SCSI drives that can only support a data rate of up to 5 MB/s may misinform the BT-445S during the negotiation that it can transfer data above 5 MB/s. When the BT-445S is connected to such drives, the 5 MB/s option must be used (switch 7 - On) . Otherwise, it will cause data transfer failure!

Notes about hardware setting of BT-946C:
1.	Try to use newly supplied BT946C entry. This entry is untested, but should wok. If it fails, use following steps to run the card in compatibility mode.
2.	The BusLogic card must run in compatibility mode. This require that a jumper be installed on at least one of the JP4/JP5 switches in order to use BIOS and to instruct the card to run in compatibility mode.
3.	Boot the computer. Enter AutoSCSI utility with Ctrl-B and configure the adapter. The best way is to use default setting :
		port: 0x330,
		irq: 11,
		DMA channel: none,
4.	Very important is the setting of 'Host adapter interrupt PIN'. It depends on the PCI slots. The slot close to the edge of the board uses PIN A, the slot in the middle uses PIN B and the slot close to the 3.3V connector uses PIN C. The best way to check if your machine works OK with interrupts, is to setup an MS-DOS bootable disk with DEVICE=BTDOSM.SYS /D in the config.sys file. If you can boot to an MS-DOS keyboard prompt, the system IRQ setting is safe. If it hangs, just after the BTDOSM banner, check your setting. Note that a system using only BIOS (not BTDOSM.SYS) to access the hard disk should always work, because the BIOS doesn't use an IRQ.
5.	If the driver will not work, first try to get the newest version of both the motherboard BIOS and the BusLogic BIOS & firmware.


BUGS:
Send all bug reports and any other suggestion via e-mail to tom@hukatronic.cz. Please, don't forget to write us your configuration.


Special thanks to: 
Daniel Docekal	Coda Eletronic, Czech Republic
Thyl Engelhardt	<gast@informatik.uni-muenchen.de>
Gary Finley	<gfin@psych.ualberta.ca>
Denis Gesbert 	<dgesbert@cdphot.u-strasbg.fr>
Axel Habermann	<kiwi@belly.in-berlin.de>
Gilles Leguebe	BusLogic Europe
Tibor Lorincz 	<clt@kiss.sk>
Robert Naumann	<rna@software-ag.de>
Peter Pflaeging 	<Peter.Pflaeging@aeneas.adv.magwien.gv.at>
Marc Salvatori	<salvo@accessone.com>


Conntact:
Tomas Hurka
Hukatronic (H.C.C.)
Kankovskeho 8
182 00 Praha 8
Czech Republic
Email: tom@hukatronic.cz

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.