ASW-1410 Ver. 3.1
ASPI DOS Manager
with ASPI Disk Module

Installation Guide


Preface

COPYRIGHT

Copyright 1991 Adaptec, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or
transmitted, d, in any form or by any means, electronic, mechanical, photocopying,
recording, or otherwise, without the prior written consent of Adaptec, Inc. 691
South Milpitas Blvd., Milpitas, CA 95035

CHANGES

The material in this manual is for information only and is subject to change
without notice.

While reasonable efforts have been taken in the preparation of this manual to
assure its accuracy, Adaptee, Inc. assumes no liability resulting from any errors
or omissions in this manual, or from the use of the information contained herein.

Adaptec reserves the right to make changes in the product design without
reservation and without notification to its users.

Additional information may be obtained from:

            adaptec
   
Literature Department (408) 945-8600
    691 South Milpitas Blvd.
       Milpitas, CA 95035


Table of Contents

1.0 INTRODUCTION  
  ASPI DOS MANAGER  
  ASPI4DOS.SYS AND ASPIEDOS.SYS 
                               
2.0 INSTALLATION 

   ASPI4DOS.SYS INSTALLATION
   SAMPLE CONFIG.SYS             
   COMMAND LINE OPTIONS  
   ADVANCED COMMAND LINE OPTIONS  
   ASPIEDOS.SYS INSTALLATION  
   COMMAND LINE OPTIONS  
   ASPIDISK.SYS INSTALLATION
   COMMAND LINE OPTIONS  
   AFDISK INSTALLATION 

3.0 SOFTWARE CONSIDERATIONS 
       WINDOWS 3.0

4.0 USING MULTIPLE HOST ADAPTERS 

5,0 COMMONLY ASKED QUESTIONS  

6.0 ERROR MESSAGES  
   ASPI4DOS.SYS  
   ASPIEDOS.SYS  
   AFDISK.EXE  




Section One

Introduction

This document provides installation information on Adaptec's Advanced
SCSI Programming Interface (ASPl) DOS Manager for Adaptec's bus
master line of SCSI host adapters. These host adapters currently include
the AHA-I540B/1542B, AHA-1640, and AHA-1740/1744 SCSI host
adapters. Also included is the ASPI disk driver ASPIDISK.SYS, and the
SCSI hard disk partitioning program AFDISK, with full support for
removable media (512 bytes/sector media only).

The DOS versions supported are MS and IBM 3.30, Compaq 3.31, MS or
IBM 4.0x, and MS 5.0.

ASPI DOS MANAGER

There are two ASPI DOS Managers included with the ASW-1410, named
ASPI4DOS.SYS and ASPIEDOS.SYS. The ASPI4DOS.SYS driver is used
on the AHA-I540B/1542B, AHA-1640, and the AHA-1740/1744 (in the
standard mode only). The ASPIEDOS.SYS Manager is used on the AHA-
740/1744 when in the enhanced mode.

ASPI4DOS.SYS AND ASPIEDOS.SYS

The DOS operating system uses the ASPI DOS Manager to communicate
with the SCSI host adapter and allow access to additional SCSI devices
connected to the host adapter. The ASPI DOS Manager is typically
installed:

     -when more than two hard disk drives are already installed (see
      section on ASPIDISK.SYS installation)

     -to install a SCSI drive that is configured at a SCSI ID other than 0 or 1
      (see section on ASPIDISK.SYS installation)

     - to install removable media (see section on ASPIDISK.SYS installation)

     - when interfacing to ASPI modules, which include modules for SCSI
       tape (SY-TOS and Sytos Plus), CD-ROM, removable media, printers,
       plotters, and other SCSI devices

     - to support programs that use virtual mode (i.e.,Windows 3.O,
       Quarterdeck QEMM 386, Qualitas 386MAX)

     - to support programs that write large amounts of data directly to
       video memory (AI AHA-1540/1542/1640 only)

     - change the host adapter configuration

     - to increase performance (ASPI4DOS.SYS only).

The managers fully conform to the Virtual DMA services (VDS) specification
(described later on, in the "Commonly Asked Questions" section of this
document).

ASPIDISK.SYS

ASPIDISK.SYS is used to install valid DOS partitions as logical drives
with SCSI disk drives that are not installed under the host adapter BIOS.
A drive will not be installed under the host adapter BIOS if:

  -the host adapter BIOS is disabled
  -more than two hard disk drives are already installed
  -the SCSI ID is something other than 0 or 1 (except for the AI IA-
                               1740/1744 in the enhanced mode).

Valid DOS partitions are created with DOS FDISK or Adaptec's
AFDISK.EXE.

Removable media hard disks should only be installed with the
ASPIDISK.SYS driver, and not with the host adapter BIOS. If the removable-
able media hard disk is installed trader the host adapter BIOS, do not
change media or unpredictable results may occur and data may be lost
Only media with 512 Bytes/sector is supported.

If no AFDISK or DOS partitions are found, the ASPI[)ASPIDISK.SYS driver will
not install. 1 however, if a removable media hard disk is found and not
installed under the BIOS, a minimum of one logical drive will be re-
served.




If only a total of two or less hard drives is in the system (e.g., two standard-
 hard disks, one standard hard disk and one SCSI hard disk, or two
SCSI hard disks), ASPIDlSK.SYS is not needed. ASPIDISK.SYS can be
loaded in the CONFIG.SYS because it will not install and take up
memory unless valid partitions are found. Do not be concerned that
ASPIDISK.SYS does not load if it is known that no valid partitions exist.

AFDISK.EXE

AFDISK.EXE is an Adaptec SCSI disk partitioning and high-level format-
ting utility. SCSI disks not installed under the host adapter BIOS must
be partitioned with AFDISK. AFDISK will allow you to add or delete a
DOS partition, as well as delete a non-DOS partition. AFDISK partitions
are installed with the ASPIDISK.SYS driver. AFDISK partitions are
completely compatible with DOS partitions (i.e., partitions created with
DOS FDISK can later be installed with the ASPIDISK.SYS driver). Also,
partitions created by AFDISK can be moved to control of the host
adapter BIOS. These partitions will be bootable if previously high-level
formatted with the system's files (e.g., using the/s option on DOS
FORMAT.COM). The DOS version used must be 3.3 or newer.

ASPI4DOS.SYS and ASPIDISK.SYS are written to the Advanced SCSI
Programming Interface. This is a modular approach to writing SCSI
device drivers. Drivers are written to the ASPI interface instead of to the
host adapter hardware. The advantage is that a program need only be
written once; if the ASPI Manager for a particular host adapter is loaded,
it will work with all ASPI modules.

      

Section Two

Installation

The first installation step is to copy the files from the ASW-1410 program
diskette to a directory on drive C using the DOS COPY command.

ASPI4DOS.SYS INSTALLATION

The ASPI4DOS.SYS Manager should only be used with the AHA-]540/
1542, the AHA-1640, and the AHA-1740/1744 (standard mode only). If
the AHA-1740/1744 is in the enhanced mode, the ASPIEDOS.SYS driver
should be used, and installation is described in the ASPIEDOS.SYS
INSTALLATION section.

In order for the ASPI MS-DOS Manager files to be loaded whenever the
system is booted, the CONFIG.SYS file must contain the following
DEVICE= command:

DEVICE = [{path] ASPI4DOS.SYS [optional switches]

Using any ASCII file editor, add the individual device driver commands
to an existing CONFIG.SYS file, or follow the instructions in the MS-DOS
Operations Reference Manual to create a new CONFIG.SYS file. The
driver should precede the loading of all ASH modules and any disk
caching drivers.

SAMPLE CONFIG.SYS

A sample CONFIG.SYS should look similar to:

buffers=20
files=20
DEVICE=ASPI4DOS.SYS
DEVICE=ASPIDISK.SYS
DEVICE=HIMEM. SYS
DEVICE=SMARTDRV.SYS 2048 512


  Notes:

;Things like DOS buffers and files can be
;before or after, the ASPI Manager
;In general, the ASPI Manager should be the
;first in line in the CONFIG.SYS
;This is an ASH Module, and should be
;loaded after the ASPI Manager in the
;CONFIG.SYS
;Memory managers for Windows and other
,'third party software, such as 386MAX and
,QEMM should be loaded after the ASPI
;Manager
,Caching device drivers should be loaded
;after the ASPI Manager





COMMAND LINE OPTIONS

The following command line options may be added to the
ASPI4DOS.SYS driver to change the parameters of the host adapter:

DEVICE= [pathname] ASPI4DOS.SYS ]/P<port address>] [/S<slot num-
ber>] ]/D] l/L] [/W] [/WM] I/Vl} [/VM] l/X<speed>] I/N <bus on time>]
[/F<bus off time>] [/1] [/NORST]

Notes:  /S is for the AHA-1640 only
    / P <port address>,/X <sped>,/N <bus on t/me>,/F<bus off
     time> are for the AHA-1540/1542 and the AHA-1740/1744 (in
     standard mode) only.
     Use either/W,/WM, or neither, but do not use both
     Use either/V,/VM, or neither, but do not use both


Section Two

/P <port address>


Sets the port address that the driver uses to
communicate with the host adapter. This value is
in hex. Valid addresses are:

130, 134, 230, 234, 330, 334 (e.g.,/I'334)

The AHA-1540/1542 should be jumpered accord-
ingly, or the AHA-1740/1744 should be config-
ured accordingly. The host adapter BIOS should
be disabled if a port address other than 330 is
used since the BIOS only works at port 330.



/S<slot number>

Installation
Sets the slot number where the driver will find
your AHA-1640 host adapter. The valid slot
values are:

1, 2, 3, 4, 5, O, 7, 8 (e.g.,/$3)

If this option is not used, the driver will scan the
slots starting with slot one and install all of the
AHA-1640 that it finds.


/D

This option will display useful information about
the host adapter and attached SCSI devices
during boot (see earlier example).


/L

This option will enable support for SCSI logical
units other than zero. The driver can recognize
all eight possible SCSI LUNs on each target. If
this option is not specified, the driver will only
recognize LUN 0 for each SCSI device.


/W

This option will enable virtual mode buffering.
The driver will attempt to allocate a 64K virtual
buffer from extended memory; if no extended
memory is available, the driver will allocate 64K
from main memory. Do not use this option if the
/WM switch is used. Virtual mode buffering is
required for applications such as Windows 386
v2.x. Virtual mode buffering is not required for
MS Windows v.3.0 or later. See section "Software
Considerations."


/WM

This option has the same function as the/W
option except that this will always allocate the
64K virtual buffer from main memory. Do not
use the/W switch and the/WM switch at the
same time. Use the/WM switch if the/W
switch does not work, or if no extended memory
is available.

/V

This option will enable video buffering. The
driver will attempt to allocate a 64K video buffer
from extended memory; if no extended memory
is available, the driver will allocate 64K from
main memory. Do not use this option if the/VM
switch is used. Video buffering is required for
applications or programs that write large
amounts of data directly to video memory. This
switch is only required if using an AHA-1540/
1542A. If used in conjunction with/W or/WM,
only a single 64K buffer will be allocated.

/VM

This option has the same function as the/V
option except that this will always allocate the
64K video buffer from main memory. Do not use
the/V switch and the/VM switch at the same
time. Use the/VM switch if the/V switch does
not work or no extended memory is available. If
used in conjunction with/W or/WM, only a
single 64K buffer will be allocated.

ADVANCED COMMAND LINE OPTIONS

/X<speed>

This option sets the AT Bus Master transfer speed
of the AHA 1540/1542 and AHA-1740/1744
(standard mode) host adapter only. This option
overrides the host adapter jumpers. If this option
is not used, the speed will be determined by the
jumpers or programmed settings of the host
adapter. Normally the host adapter is configured
for 5.7 MBytes/second. The hex value is what is
sent directly to the host adapter during a "Set
Transfer Speed" (Opcode=9) command.

   Five values are predefined:

00 - 5.0 MB/sec (i.e.,/X00)
01 - 6.7 MB/sec
02 - 8.0 MB/sec
03 - 10.0 MB/sec
04 - 5.7 MB/sec

WARNING: AT BUS MASTER TRANSFER
SPEEDS OF GREATER THAN 5.7 MBYTES/
SECOND ARE NOT SUPPORTED IN ALL AT
SYSTEMS. INCREASING THE TRANSFER
SPEED TO A SPEED GREATER THAN THAN- AT
CAN HANDLE MAY CAUSE A HANG CONDI-
TION.

A VALUE OF FF (E.G.,/XFF) WILL SET THE
HOST ADAPTER TO THE SLOWEST AND MOST
COMPATIBLE TRANSFER SPEED OF 3.3
MBYTES/SECOND.           



/N<bus on time>

This option sets the BUS ON time for the AHA-
1540/1542 host adapter only. Valid BUS ON
times are between 02 and 15 usecs. The default
time is 11 usecs (i.e.,/N11). The value is in
decimal.

/F<bus off time>

This option sets the BUS OFF time for the AHA-
1540/1542 host adapter only. Valid BUS OFF
times are between 01 and 64 usecs. The default
time is 4 usecs (i.e.,/F4). The value is in decimal.

/I

This option will disable the loading of the embed-
ded INT 13 module. When specified, INT 13 calls
are routed through the host adapter BIOS instead
of the INT 13 code in ASPI4DOS.SYS (only for
SCSI disks installed with the host adapter BIOS).
This option is for debugging purposes and should
normally not be used.


/NORST

This option will cause the driver to not issue a
hard reset to the host adapter during initialization
only if the BIOS is disabled. If the BIOS is en-
abled, no hard reset is ever issued by the driver
because the BIOS resets the board during its
initialization phase. If not specified with the BIOS
disabled, all devices on the SCSI bus will be reset.

ASPIEDOS.SYS INSTALLATION

ASPIEDOS.SYS is only used with the AHA-1740/1744 in enhanced
mode.

In order for the ASPI MS-DOS Manager files to be loaded whenever the
system is booted, the CONFIG.SYS file must contain the following
DEVICE= command:

DEVICE = [path] ASPIEDOS.SYS [optional switches]

Using any ASCII file editor, add the individual device driver commands
to an existing CONFIG.SYS file, or follow the instructions in the MS-DOS
Operations Reference Manual to create a new CONFIG.SYS file. The
driver should precede the loading of all ASPI modules.

When the driver is loaded, the display should look similar to:

AHA-1740/I744  (enhanced mode)  ASPI Manager for DOS
Version 1.0
Copyright  1991 Adaptec,  Inc.

ASPIEDOS.SYS Installation SUCCESSFUL]


COMMAND LINE OPTIONS

The following command line options may be added to the
ASPIEDOS.SYS driver to change the parameters of the host adapter:

DEVICE= [pathname]ASPIEDOS.SYS [/S<slot number>] [/D] [/L]

/S<slot number>

Sets the slot number where the driver will find
your AHA-1740/1744 host adapters. The valid
slot values are:

1,2,3,4,5,6,7,8,9,10, ll,12,13,]4,15(e.g.,/S3)

If this option is not used, the driver will scan the
slots starting with slot one and install all the
AHA-1740/1744 host adapters that it finds.

/D

This option will display useful information about
the host adapter and attached SCSI devices
during boot.

/L

This option will enable support for SCSI logical
units other than zero. The driver can recognize
all eight possible SCSI LUNs on each target. If
this option is not specified, the driver will only
recognize LUN 0 for each SCSI device.



ASPIDISK.SYS INSTALLATION

In order for the ASPIDISK.SYS driver to recognize logical drives partitioned
with AFDISK, the CONFIG.SYS file must contain the following DEVICE=
command:

DEVICE = [path] ASPI4DOS.SYS [optional switches]
DEVICE = [path] ASPIDISK.SYS [optional switches]
or
DEVlCE = [path] ASPIEDOS.SYS [optional switches]
DEVICE = [path] ASPIDISK.SYS [optional switches]

Note: The ASPIDISK. SYS driver must be loaded after the ASPI4DOS.SYS or
ASPIEDOS.SYS drivers for proper operation.

COMMAND LINE OPTIONS

The following command line option may be added to the ASPIDISK.SYS
driver.

/D

This displays useful information during boot


/R<# of reserved logical drives>

This determines the number of logical drives that
will be reserved for removable media. This com-
mand is ignored if the hard disk is the nonremov-
able type. If not specified, the default number of
reserved logical drives is one. Valid values are 1 to
24.

When both the ASPI4DOS.SYS driver and the ASPIDISK.SYS driver are
loaded, the display should look similar to:

AHA-1540/1542/1640 ASPI Manager  for DOS
Version 3.0
Copyright  1992  Adaptec,  Inc.

Int 13H routed through ASPI manager
ASPI4DOS.SYS  installation  Successful

ASPI Disk Driver  for DOS
Version 3.0
Copyright  1992  Adaptec,  Inc.

2  SCSI disk drive(s)  ,handled by ASPIDISK
5  Logical drive(s]  installed
ASPIDISK.SYS Installation Successful





AFDISK INSTALLATION

Make sure that all the AFIDSK support files are in the same directory as
AFDISK.EXE. The files and their functions arc, listed below:

File                    Function

AFDISK.EXE       SCSI disk partition and format utility
AFDISK.HLP       AFDISK HELP file
AFDISK.CWA       AFDlSK system file




To invoke AFDISK, simply type AFDISK at the DOS prompt. Currently,
three slash options are available with AFDISK. These are:

	/M or/MONO		;Run AFDISK in black and white mode
	/?			;Display currently supported / options

	
	

AFDISK may need to run in black and white mode in some laptops, with
some monochrome VGA monitors, and other systems that do not
properly display AFDISK in color mode.

If "/M" is not working currently, try "MODE BW80" before running
AFDISK.

The displayed list shows all installed SCSI disk drives, including removable-
able media devices. The "HA#" field indicates the host adapter number.
If running a single host adapter, this number will be zero. The "Target"
field indicates the SCSI devices target ID. Select the SCSI disk to parti-
tion, and format, and press <Enter>. 

Logical drive information will be displayed in the lower left-hand corner
of the screen. Since Adaptec SCSi host adapters use a 64-head/32-spt
translation scheme, the number of cylinders will equal the number of
megabytes of capacity available. The number of SCSI logical blocks is
also displayed.



The existing partitions on the drive will be displayed on the upper right
hand corner of the screen. Both DOS and non-DOS partitions can be
deleted by pressing the <Delete> key and answering "yes" to the
prompt. 

When the desired cylinder numbers have been entered, press the <Esc>
key. 

A "Create a DOS Partition" window will appear in the lower right-hand
corner of the screen. The "Start Cylinder" and "End Cylinder" will
default to the maximum allowed. For DOS 3.30 the limit is 32 megabytes
per partition, for COMPAQ DOS 3.31 the limit is 512 megabytes per
partition, and for DOS 4.0x and newer the limit is 1 gigabyte per parti-
tion.  AFDISK does not currently support the extended translation scheme,
so drives with a capacity of greater than one gigabyte are limited to one
gigabyte. These values can, be changed. AFDISK will not
allow illegal values to be entered.

Use the down arrow key to select "Yes" and press the <Enter> key. If
additional partitions are desired, hit the <Insert> key and repeat the
instructions described above.

After partitions have been created, the partitions will be displayed. 

Press the <Esc> key to return to the "Select SCSI Device to Partition"
screen. Select any other valid SCSI drives to partition.


A drive that was installed with the host adapter BIOS cannot be parti-
rioned with AFDISK. 

AFDISK will allow the drive's partitions to be displayed, but not altered.
Simply press the <Esc> key to continue.

To quit AFDISK, press the <Esc> key and select "yes" when prompted
on whether or not to quit. It is necessary to reboot the system in order
for the partitions that have just been created to be installed.

On-line help is always available by pressing <F1 >.



Section Three                Software Considerations

Some programs that use the virtual mode of the .186 sometimes require a virtual
buffer allocated to run correctly with the AHA-1540/1542, the AHA-1640, and
the AHA-1740/1744 (standard mode). A virtual buffer can be allocated with the
command line switch/W or/WM after the ASPI4DOS.SYS driver. See the
table below to determine if a separate buffer is required.

The AHA-1740/1744 (enhanced mode) BIOS fully conforms to the VDS
specification (described in Section 5, "Commonly Asked Questions" of this
document, and a separate buffer Ls never required.

Program              Version      Note

MS Windows 286     All          No buffer required

MS Windows 386     2.x          /W or/WM required

MS Windows*        3.0          No buffer required
		   or newer

DOS      	   5.0       	No buffer required. Driver can be loaded into
         		 	"high" memory except when booting from a
         		 	SCSI drive controlled by the host adapter
         		 	BIOS.

QEMM 386*          5.0        No buffer required. Driver can be loaded into
by Quarterdeck     or newer   "high" memory except when booting from a
                              SCSI dri