SCO Unix Boot-Time Loadable Driver For
BusLogic MultiMaster SCSI Host Adapters
SCO Unix ODT and OpenServer 2.x/3.x
Version 4.00
Introduction
============
The BusLogic Boot-time Loadable Driver (BTLD) Diskette for SCO Unix
consists of two device drivers supporting the following BusLogic
family of SCSI host adapters:
Driver Models Supported Description
------ ---------------- -----------
blc BT-445 VESA Fast SCSI
BT-54x ISA Fast SCSI
BT-64x MicroChannel Fast SCSI
BT-74x EISA Fast SCSI
BT-75x EISA Fast & Wide SCSI
BT-946 PCI Fast SCSI
BT-948 PCI Ultra SCSI
BT-956 PCI Fast & Wide SCSI
BT-958 PCI Ultra Wide SCSI
flashpt FlashPoint LT PCI Ultra SCSI
The 'blc' driver is commonly referred to as the MultiMaster driver,
and the 'flashpt' driver is referred to as the FlashPoint driver.
This version of the drivers support the following features:
- Plug & Play PCI Configuration
- SCO MPX support
- SCSI Bus Reset handling
- I/O Port Address selectability at installation time (blc only)
- Tag Queueing option
- Command Timeout handling
- Reset Delay configurability at link time
- BIOS Drive-Mapping support for up to 8GB hard disks
- Extended device support for BT-75xC and BT-95xC Wide
SCSI host adapters (blc only)
Please refer to the Feature Notes below for more detail.
Generating a BTLD Diskette
==========================
This section describes the method for generating a BusLogic Boot-time
Loadable Driver (BTLD) diskette for SCO Unix ODT and OpenServer 2.x/3.x
using the downloaded MMODT.EXE DOS self-extracting file.
When you execute the MMODT.EXE in DOS, the following files are
automatically extracted:
UNIX.TXT
ODT.EXE
UNIX.TXT is the readme text file. ODT.EXE is the file that you use on
a DOS system to generate the BTLD diskette.
To generate the BTLD diskette, do the following:
1. Execute the MMODT.EXE to extract files
2. Insert a blank formatted 3.5"(1.44MB) diskette in floppy drive A:
and type the following:
odt a: (where "a:" is the floppy drive letter)
Note: This is the command that creates the BTLD diskette
3. Label the diskette as "BusLogic BTLD for SCO Unix ODT and
OpenServer 2.x/3.x Version 4.00".
Installation Procedure
======================
The installation procedure allows you to dynamically load the BusLogic
Boot-time Loadable Driver (BTLD) during SCO Unix installation and
permanently configure the driver into your kernel. The procedure
below describes the installation on SCO Open Desktop (ODT) and may
differ slightly from your installation.
1. For MultiMaster adapters, configure the BusLogic SCSI Host Adapter
to any supported I/O port address, IRQ, and DMA settings that you
prefer. This version of the BusLogic driver installation allows you
to specify the I/O port address mapping.
2. Boot system with the N1 Boot Diskette.
3. At the boot prompt, type "link" and press Enter.
Boot: link
4. When the system prompts for the package name, enter "blc" for
MultiMaster adapter and "flashpt" for FlashPoint adapter installation.
This example will use blc. For FlashPoint installation, simply
replace "blc" with "flashpt" in the procedures below.
What packages do you need linked in the system,
or q to quit?: blc
5. The screen displays a series of progress messages before you are
prompted to insert the BusLogic BTLD diskette.
Please insert the fd(60)blc volume and press <Return>,
or 'q' to quit:
Insert the diskette and press Enter. The screen displays the
following messages:
blc.blc: Loading module fd(60)/blc/driver/blc/Driver.o .text
......
blc.blc: Loading module fd(60)/blc/driver/blc/Driver.o .data
...
blc.blc: Loading module fd(60)/blc/driver/blc/Driver.o .data
.
blc: Driver "blc" successfully loaded.
character major = 6
6. Follow the installation instructions until you are requested to
re-insert the BusLogic BTLD diskette.
The BTLD packages will now be extracted.
Please insert the floppy for BTLD package: blc
and press <ENTER>:
Insert the diskette and press Enter. The screen displays the
following messages:
Extracting BTLD distribution for blc ... Done.
After the SCO Unix files have been read from the installation media
(floppy, tape, or CD-ROM), the installation procedure to statically
link the BusLogic driver into the kernel is started.
7. You are presented with a list of packages on the BTLD diskette.
The following packages are on this disk:
NAME DESCRIPTION
blc BusLogic MultiMaster SCSI HBA driver for SCO UNIX
flashpt BusLogic FlashPoint SCSI HBA driver for SCO UNIX
and UnixWare 2.x
Please enter the names of the packages you
wish to install, or q to quit:
[default: blc]: blc
Type "blc" and press Enter.
8. You are then requested to select whether or not you want to replace
the "auto" entries in mscsi with "blc".
Would you like to replace the 'auto' entries
in mscsi with BusLogic driver 'blc'? (y/n):
Type "y" and press Enter.
9. Flashpoint installation, skip to step 10. By default, the BusLogic
driver will be statically configured in the kernel at I/O port
address 0x330. The next prompt allows you to select another address.
The BusLogic driver defaults to I/O port address
0x330. Do you want to change the I/O port address?
(y/n):
Type "n" to accept the default address of 0x330. If you wish to use
another address, type "y" and press Enter. For PCI card installation,
select "y". When you select "y", you are prompted to select the I/O
port address you wish to use.
The BusLogic SCSI host adapter can be set for
the following I/O port addresses:
1. 0x330 (default) 5. 0x130
2. 0x334 6. 0x134
3. 0x230 7. PCI
4. 0x234
Please enter your selection:
Enter the number corresponding to the I/O port address and press Enter.
Select option 7 if the driver is being configured for a PCI-compliant
adapter (i.e. BT-946, BT-956.)
10. The next prompt allows you to specify if you want the driver to enable
Tag Queueing support. If you enable this option, tag commands are sent
only to hard disks supporting Tag Queueing.
Tag Queuing allows hard disks to queue and sort
multiple I/O requests from the BusLogic host adapter,
possibly resulting in enhanced performance.
Some hard disks, however, do not thoroughly support
Tag Queuing, and may have problems if this option
is enabled.
If you decide not to turn on Tag Queuing now, you can
do so later by setting 'blc_do_tag = 1' in
/etc/conf/pack.d/blc/space.c
Do you want to enable Tag Queuing now? (y/n):
11. Flashpoint and OpenServer installation, skip to step 12. The driver
contains support for the BusLogic BT-75xC and BT-95xC Wide SCSI host
adapters which allow access to 16 target ID's (0-15) and 64 LUN's
(0-63). A couple of mkdev scripts do need to be modified to bypass
the current 0-7 limitations for both ID's and LUN's. The next prompt
allows you to make the necessary changes to these shell scripts
automatically if you are using the BT-75xC or BT-95xC and wish to
take advantage of the extended device support.
BusLogic BT-75xC amd BT-95xC Wide SCSI Host Adapters
are capable of supporting up to 15 devices with up
to 64 LUNs. To support the extended devices, the
following files need to be modified:
/usr/lib/mkdev/hd
/usr/lib/mkdev/.scsi
The original files will be backed up in the following
directory:
/usr/lib/mkdev/Orig
If you have a BT-75xC or BT-95xC and wish to provide
support for extended devices, type 'y'; otherwise,
type 'n'. (y/n):
Type "y" to make the necessary modification for extended device support.
12. At this point, you are given the opportunity to rebuild the kernel.
You will need to rebuild the kernel for the changes
to take effect.
Do you want to rebuild the kernel now? (y/n):
You can type "n" here, as SCO Unix installation performs a kernel
rebuild soon after the BusLogic driver installation is complete.
This option is presented for users upgrading to the new BusLogic
driver.
13. The installation of the BusLogic device driver is complete.
Upgrade Procedure
=================
The upgrade procedure allows you to upgrade the older version of the
BusLogic driver, "btk", or replace the Adaptec 1542 configuration and
driver that you may have used previously with your BusLogic MultiMaster
SCSI Host Adapter. This procedure is not applicable for FlashPoint.
1. Boot the system into single-user mode.
2. Insert the BusLogic BTLD diskette in the floppy drive and type
"installpkg" at the shell prompt.
# installpkg
3. You are presented with a list of packages on the BTLD diskette.
The following packages are on this disk:
NAME DESCRIPTION
blc BusLogic MultiMaster SCSI HBA driver for SCO UNIX
flashpt BusLogic FlashPoint SCSI HBA driver for SCO UNIX
Please enter the names of the packages you
wish to install, or q to quit:
Type "blc" and press Enter.
4. If you are upgrading from the Adaptec 1542 driver, "ad", you are
prompted as follows:
Would you like to replace the 'ad' entries
in mscsi with BusLogic driver 'blc'? (y/n):
Type "y" and press Enter to replace the Adaptec driver entries in
mscsi with BusLogic. You are then asked if you wish to keep the
same settings as the Adaptec driver.
Would you like to use the BusLogic driver with
the same I/O port addresses settings as 'ad'?
(y/n):
Type "y" and press Enter if the BusLogic host adapter is configured
with the same I/O port setting as the Adaptec card, or "n" if you
wish to specify another port address.
5. If you are upgrading from the older BusLogic driver, "btk", you are
prompted as follows:
The current 'btk' driver will be replaced with the
new BusLogic 'blc' driver.
Do you want to set up the new BusLogic 'blc' driver
with the same settings as the 'btk' driver?
(y/n):
Type "y" to keep old setup, or n to specify a new I/O port setting.
6. The next prompt allows you to specify if you want the driver to
enable Tag Queueing support. If you enable this option, tag commands
are sent only to hard disks supporting Tag Queueing.
Tag Queuing allows hard disks to queue and sort
multiple I/O requests from the BusLogic host adapter,
possibly resulting in enhanced performance.
Some hard disks, however, do not thoroughly support
Tag Queuing, and may have problems if this option
is enabled.
If you decide not to turn on Tag Queuing now, you can
do so later by setting 'blc_do_tag = 1' in
/etc/conf/pack.d/blc/space.c
Do you want to enable Tag Queuing now? (y/n):
7. OpenServer installation, skip to step 8. The driver contains support
for the BusLogic BT-75xC and BT-95xC Wide SCSI host adapters which allow
access to 16 target ID's (0-15) and 64 LUN's (0-63). A couple of mkdev
scripts do need to be modified to bypass the current 0-7 limitations for
both ID's and LUN's. The next prompt allows you to make the necessary
changes to these shell scripts automatically if you are using the
BT-75xC or BT-95xC and wish to take advantage of the extended device
support.
BusLogic BT-75xC amd BT-95xC Wide SCSI Host Adapters
are capable of supporting up to 15 devices with up
to 64 LUNs. To support the extended devices, the
following files need to be modified:
/usr/lib/mkdev/hd
/usr/lib/mkdev/.scsi
The original files will be backed up in the following
directory:
/usr/lib/mkdev/Orig
If you have a BT-75xC or BT-95xC and wish to provide
support for extended devices, type 'y'; otherwise,
type 'n'. (y/n):
Type "y" to make the necessary modification for extended device support.
8. At this point, you are given the opportunity to rebuild the kernel.
You will need to rebuild the kernel for the changes
to take effect.
Do you want to rebuild the kernel now? (y/n):
Type "y" and press Enter to permanently link the BusLogic driver with
the kernel. Reboot the system after the rebuild is complete.
9. The installation of the BusLogic device driver is complete.
Configuring Driver for Additional BusLogic Cards
================================================
Up to four BusLogic SCSI host adapters can be configured simply by
modifying the /etc/conf/sdevice.d/blc file and rebuilding the kernel.
By default, the /etc/conf/sdevice.d/blc file contains one entry and looks
like:
blc Y 1 5 0 0 330 333 0 0
This represents a BusLogic host adapter configured at I/O port 0x330-0x333.
There is no need to specify other characteristics of the host adapter,
such as IRQ, DMA, or BIOS memory range, as these information are obtained
at boot time using the I/O port addresses.
To configure a second BusLogic card, copy the first line and append it to
the file, changing only the I/O port address settings. For example, if
the second controller is configured at port address 0x334-0x337, the
/etc/conf/sdevice.d/blc file would be:
blc Y 1 5 0 0 330 333 0 0
blc Y 1 5 0 0 334 337 0 0
The third and fourth controller entries can be added in a similar way.
Once you have finished with the changes, save the file and rebuild the
kernel as follows:
# /etc/conf/cf.d/link_unix
Reboot the system and run the appropriate "mkdev" script (hd, tape, cdrom)
to add devices to the newly configured host adapter.
Feature Notes
=============
This section describes in brief detail some of the features that of this
BusLogic BTLD package release. For FlashPoint driver, replace the space.c
symbols starting with "blc_" to "fpt_".
I/O Port Addressing selectability at installation time
------------------------------------------------------
The BusLogic MultiMaster BTLD scans the range of supported I/O port
addresses at installation time in order of PCI-compliant I/O address
(dynamic), 0x330, 0x334, 0x230, 0x234, 0x130, and 0x134, and selects the
first one found as the boot controller.
Tag Queueing option
-------------------
The Tag Queuing option allows multiple disk requests to be sent to and
sorted by devices that supports this feature. Note that tag queuing may
not improve performance in some environments; however, the driver provides
an option to enable the Tag Queuing feature for those environments that
benefits from tag queuing. To enable this option, set blc_do_tag in
/etc/conf/pack.d/blc/space.c to 1 and relink the kernel.
int blc_do_tag = 0; /* 1 = do command queuing */
Command Timeout handling
------------------------
By default, an I/O request is given 15 seconds (user configurable) to
complete. A request that does not return in that time limit will be
aborted and retried up to 2 times (user configurable). If there is still
no response, the controller is reset and any pending I/O requests are
resent. The following tunable parameters can be changed in
/etc/conf/pack.d/blc/space.c to your desired values.
int blc_timeout = 1; /* 1 = do timeout handling */
int blc_timeout_period = 15; /* number of secs to wait for I/O */
/* request before timing out */
int blc_retry_max = 2; /* number of times to retry request */
/* before resetting the controller*/
Note: If the I/O request is started just after the timer is called, the
actual timeout period can be up to twice that specified in
blc_timeout_period.
Boot-time Hard Reset ON/OFF selectability at link time
-------------------------------------------------------
By default, the driver will not perform Hard/SCSI reset at boot-time. If
your application requires reset at boot-time, set blc_inittime_hard_reset
to 1 in /etc/conf/pack.d/blc/space.c and relink the kernel.
int blc_inittime_hard_reset = 0; /* 1 = do hard reset at boot-time */
Reset Delay configurability at link time
----------------------------------------
By default, the driver will delay three seconds after a hard reset is
generated at boot-time or during error recovery as part of the command
timeout feature. Certain devices requiring a longer delay can be
accomodated by modifying the blc_reset_delay parameter in
/etc/conf/pack.d/blc/space.c and relinking the kernel.
int blc_reset_delay = 3; /* number of secs to wait after */
/* hard reset is performed */
Extended device support for BT-75xC and BT-95xC Wide SCSI controllers
---------------------------------------------------------------------
The MultiMaster driver provides support for up to 16 SCSI ID's and 64 LUN's
on the BusLogic BT-75xC and BT-95xC Wide SCSI host adapters.
/usr/lib/mkdev/hd and /usr/lib/mkdev/.scsi files are modified during
installation, if requested, to allow user to specify SCSI ID and LUN
beyond 7.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.