LSI Logic Home PageHomeBuild Driver DiskettesInstallation InstructionsUtility InformationProduct InformationContact InformationTable of ContentsAbout This CD
The Communications Company (tm)
       SDMS™ ASPI8XX.SYS Device Driver

ASPI8XX.SYS is an Advanced SCSI Programming Interface (ASPI) manager that provides standard ASPI compatibility between your SCSI host adapter hardware and ASPI compatible applications. This document includes these topics:


Features

The ASPI8XX.SYS device driver supports these features:

  • ASPI applications
  • Allows up to eight host adapters
  • Releases initialization code for smaller runtime size
  • Works with or without an SDMS 3.0 or 4.0 BootROM
  • Synchronous negotiation
  • Wide SCSI
  • Has full Virtual DMA Services (VDS) support, including scatter/gather
  • Disconnect/Reselect
  • Adapter exclusion
  • Allows shared interrupts
  • Single-threaded I/O
  • Can read device configuration information from DMI NonVolatile Storage (NVS) when NonVolatile Random Access Memory (NVRAM) on a host adapter is not present
  • LSI Logic usage of PCI Subsystem ID to control various features and configuration settings (See PCI Subsystem ID Definitions for SCSI Class, Revision 1.03, dated 5/28/97)
  • Allows booting from a CD-ROM
  • A 66 MHz PCI bus
  • Up to Ultra160 SCSI (160 Mbytes/s when using Wide SCSI) including:
  • Parallel Protocol Request, Double Transition data transfers, and Cyclic Redundancy Check

back to top


Description

The ASPI8XX.SYS driver is an ASPI manager that provides an interface to popular ASPI applications. Use the ASPI8XX.SYS driver in conjunction with the  SYMDISK.SYS or SYMCD.SYS driver, or whenever you want to run an ASPI application. 

This interface replaces an SDMS BIOS (if present), and fully supports all devices supported by the BIOS. If the SDMS BIOS is not present, only an ASPI interface is provided.

back to top


Installing Your ASPI8XX.SYS Driver

To install the ASPI8XX.SYS driver, either:

  1. Copy the ASPI8XX.SYS driver from the DOS directory on the SDMS Software Device Drivers and Utilities CD-ROM to your boot disk:

{CD-ROM Drive Letter}:\DRIVERS\8XX-1010\DOS

  1. Add this line to your system's CONFIG.SYS file:

DEVICE=C:[PATH]ASPI8XX.SYS

or

  1. Make an SDMS DOS Driver Diskette using the Build Driver Diskettes page. (Select DOS.)
  1. Run the Installation Utility from the diskette you built in step 1 by typing:

A:\INSTALL.EXE

back to top


Command Line Options

The ASPI8XX.SYS driver has several configurable features that are set by using switches on the command line in the CONFIG.SYS file.

The command line options are listed below:

Option Command line Option Command Line
No Reset /NORST Enable/Disable Parity /PARITY
(or /P)
Load Driver /ASK Exclude Adapter /EXCLUDE
(or /X)
Force Width /WIDTH
(or/W)
Set Adapter ID /HOST_ID
(or /ID)
Enable/Disable Disconnects /DISCONNECT (or/DC) Set Max. Sync. Rate /SYNCH_RATE
(or /SR)
Set CMD Timeout /TIMEOUT
(or /T)
Set Max. Sync. Offset /SYNCH_OFFSET
(or /SO)
Display Config Info at Boot /VERBOSE
(or /V)
 

The following conventions are used:

path refers to the adapter number (boot order designation)

id refers to the SCSI ID

[] items in brackets are optional

* means repeat item 0 or more times

IMPORTANT: No spaces are allowed within a single command line option, but spaces are required between different command line options. Use these command line options to override the settings in the SCSI BIOS Configuration Utility.

back to top


Using the /NORST Option

This option prevents a SCSI bus reset during loading of the ASPI8XX.SYS driver.

Option Syntax: /NORST

For example, to prevent a SCSI bus reset during load, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /NORST

back to top


Using the /ASK Option

This option prompts you at system boot-up time whether to load the ASPI8XX.SYS driver.

Option Syntax: /ASK

For example, to activate this option, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /ASK

back to top


Using the /WIDTH (or /W) Option

This option defines the maximum data width negotiated with a device. This is used with host adapters capable of 16-bit data transfers. Valid settings are 8 or 16.

Option Syntax: /WIDTH=n<path[:id]>[,n<path[:id]>]*

For example, if your first host adapter (boot order designation = 0) is a 16-bit adapter, and you wish to force 8-bit transfers to a device at SCSI ID 2, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /WIDTH=8<0:2>

back to top


Using the /DISCONNECT (or /DC) Option

This option allows a device to disconnect since SCSI devices have the ability to disconnect from the bus during an I/O transfer. If a particular host adapter has parity checking disabled, all devices attached to it must have disconnects disabled, since parity is required during the reselection phase. Valid options are ON (allow disconnects) or OFF (do not allow disconnects). The default value is ON for all devices.

Option Syntax: /DISCONNECT=n<path[:id]>[,n<path[:id]>]*

For example, to disable disconnects on the device attached to the first host adapter (boot order designation = 0) at SCSI ID 2, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /DISCONNECT=OFF<0:2>

back to top


Using the /SYNCH_RATE (or /SR) Option

This option sets the maximum synchronous transfer rate (in mega transfers per second) to negotiate with a particular device. The allowable values are 0, 5, 10, 20, 40, and 80 providing the host adapter is capable of the specified speed. Specify 0 to turn off synchronous transfers for a particular device. The default value is the fastest rate supported by your host adapter.

Option Syntax: /SYNCH_RATE=n<path[:id]>[,n<path[:id]>]*

For example, to turn off synchronous transfers to the device attached to the first host adapter (boot order designation = 0) at SCSI ID 3, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /SYNCH_RATE=0<0:3>

Note: When you are doing synchronous transfers using an 8-bit SCSI bus, Mbytes/s = mega transfers per second. When you are doing synchronous transfers using a wide SCSI bus (16 bit), Mbytes/s = 2 * mega transfers per second.

back to top


Using the /SYNCH_OFFSET (or /SO) Option

This option sets the maximum synchronous offset in bytes to negotiate with a particular device. The maximum allowable values are 0, 8, 16, and 31 provided the host adapter is capable of the specified offset. Specify 0 to turn off synchronous transfers for a particular device. The default value is the fastest rate supported by your host adapter.

Option Syntax: /SYNCH_OFFSET=n<path[:id]>[,n<path[:id]>]*

For example, to turn off synchronous transfers to the device attached to the first host adapter (boot order designation = 0) at SCSI ID 3, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /SYNCH_OFFSET=0<0:3>

back to top


Using the /PARITY (or /P) Option

This option tells your host adapter to disable the SCSI bus data integrity checking feature known as parity. Some SCSI devices do not generate parity. Valid options are ON (check parity) or OFF (do not check parity). The default value is ON for all devices.

Warning: When disabling parity checking, you must disable disconnects for that adapter since you cannot disable parity checking for reselection. If a device does not generate parity, and it disconnects, the I/O will never complete.

Option Syntax: /PARITY=n<path[,path]*>[,n<path[,path]*>]*

For example, to turn off parity checking on the first host adapter (boot order designation = 0), the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /PARITY=OFF<0>

back to top


Using the /EXCLUDE (or /X) Option

This option allows you to exclude support for an adapter that does not currently have BIOS support. You may not exclude an adapter that is supported (included) by the BIOS when you boot your system. This option has three required parameters:

  1. PCI Device ID
  2. PCI Bus Number
  3. PCI Device/Function Number

These parameters identify the specific adapter you want to exclude. To obtain these parameters, boot your system using the /VERBOSE command line option (explained later in this section). Your monitor displays the parameters for the adapter or path you wish to exclude.

Option Syntax: /EXCLUDE<a:b:c>[,<a:b:c>]*

For example, if you found the adapter to exclude has PCI Device ID 3, PCI Bus Number 0, and PCI Device/Function Number 68, then the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /EXCLUDE<3:0:68>

back to top


Using the /HOST_ID (or /ID) Option

This option allows you to alter the SCSI ID for a host adapter. On an 8-bit adapter, the SCSI IDs are 0-7. On a 16-bit adapter, the SCSI IDs are 0-15 (LSI Logic recommends that IDs 8-15 not be used for your adapter). This option does not allow anyone to select a SCSI ID already in use.

If the host adapter allows connection of both 8-bit and wide devices to the same bus, and the adapter number is changed to greater than 7, then the 8-bit SCSI devices will not be able to reselect the initiator.

Note: You are not allowed to change the SCSI ID of any adapter currently supported by the BIOS.

Option Syntax: /HOST_ID=n<path>[,n<path>]*

For example, to change the SCSI ID of your second host adapter (path=1) to ID=6 (providing that adapter is not controlled by the BIOS), the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /HOST_ID=6<1>

back to top


Using the /TIMEOUT (or /T) Option

This option provides a timeout mechanism to detect certain errors.  When the driver issues a command to a SCSI device, a timer is started. If the timer expires before the command completes, the driver assumes something has gone wrong, and takes steps to recover. The default for this option is 10 seconds, if the device is BIOS controlled. If the device is not BIOS controlled, the default is 0. Also, NonVolatile Memory settings can alter these defaults. The maximum setting is 0, which is no timeout. The range of allowable values is 0-65535 seconds.

Option Syntax: /TIMEOUT=n<path[:id]>[,n<path[:id]>]*

For example, you might have a particularly slow device (with SCSI ID 3) on the first host adapter (boot order designation = 0). To extend the timeout for this device to 60 seconds, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /TIMEOUT=60<0:3>

back to top


Using the /VERBOSE (or /V) Option

This option causes more detailed information to appear on your monitor during a system boot, after the ASPI8XX.SYS driver has been initialized. This is useful if you have multiple adapters in your system and need to know the PCI Device ID, the PCI Bus number, and the PCI Device/Function number for each adapter. For example, this information is required to use the /EXCLUDE option already described in this section.

Option Syntax: /VERBOSE

For example, to see more detailed adapter information displayed when you boot, the line in the CONFIG.SYS file that loads ASPI8XX.SYS should look like this:

DEVICE=C:[PATH]ASPI8XX.SYS /VERBOSE

back to top


Troubleshooting

Some potential problems and their suggested solutions are:

Problem: System locks up at boot time.

Solution:

  1. Check for conflicts with other ASPI managers.
  1. Check for correct loading sequence in the CONFIG.SYS file.
  1. Boot the system.

Problem: The device driver does not recognize one of the non-boot SCSI peripherals (system may lock up).

Solution:

  1. Make sure the drivers were installed in the correct sequence.
  1. Make sure the drivers' entries in the CONFIG.SYS file have the correct path to the drivers.
  1. Power down all units in the system.
  1. Make sure all SCSI devices have unique ID numbers.
  1. Make sure both ends of the SCSI bus are terminated.
  1. Check all cable and power connections.
  1. Boot the system.

back to top


Back to DOS