-----------------------------------------------------------------------------
readme.os2 -- README file for
              PCMCIA SCSI Bus Toaster Adapter Device Driver  V1.00
              for OS/2 Warp: Operating System/2 Version 3

Released: Fri Jul 21 18:35:00 PDT 1995
-----------------------------------------------------------------------------


-----------------------------------------------------------------------------
DESCRIPTION
-----------------------------------------------------------------------------

BTOS2.ADD is the SCSI Bus Toaster's Adapter Device Driver (ADD) for OS/2
Warp.  It is designed to provide OS/2 with a standardized API for
support of all SCSI devices including hard disks, removable hard disks,
tape drives, CD-ROMs, optical disks, scanners, etc.

This driver requires the PCMCIA Card Services supplied with OS/2 Warp.
You cannot use your real-mode Card Services drivers.  Previous versions
of OS/2 are not supported.

Since OS/2 does not provide a way to install OS/2 Warp from the CD-ROM
connected to a PCMCIA adapter, support for this type of installation is
not supported.  You must install OS/2 and PCMCIA Card Services from
floppies.  You can make floppy disks from the CD-ROM under DOS.


-----------------------------------------------------------------------------
Compatibility Warning
-----------------------------------------------------------------------------

There may be partition compatibility problems for hard disks and
removables.  Testing has shown that drives partitioned by OS/2's FDISK
will work under OS/2.  Partitions created by EZ-SCSI or CorelSCSI may
not work.  This SCSI ADD cannot remedy this incompatibility, and you
will need to re-partition using OS/2's FDISK.


-----------------------------------------------------------------------------
Command Line Options
-----------------------------------------------------------------------------

BASEDEV=BTOS2.ADD globalopts [/A:#] adapteropts deviceopts

globalopts:
 [/V]			Verbose (default=quiet)

/A:#			Adapter index (only 0 is valid)
adapteropts:
 [/V]			Verbose [default=quiet]
 [/P:###]		Base I/O port address (32 ports will used)
 [/Q:#]			IRQ
 [/I]			Ignore adapter
 [/H:#]			Host SCSI ID [default=7]
 [/[!]F]		Fast-SCSI negotiation [default=on]
 [/[!]TA]		Termination always on [default=power saving mode]
 [/[!]TD]		Termination detect (Type II cards only) [default=on]
 [/[!]Y]		Parity checking [default=on]
 [/[!]DM]		DASD manager support [default=on]
 [/[!]SM]		SCSI manager support [default=on]
 [/[!]SN]		Synchronous negotiation [default=on]
 [/[!]ET]		Embedded targets [default=off]
 [/[!]DR]		Disconnect/Reselect [default=on]
deviceopts:
 [/[!]DM]:unit_list	DASD manager support [default=on]
 [/[!]SM]:unit_list	SCSI manager support [default=on]
 [/[!]SN]:unit_list	Synchronous negotiation [default=on]
 [/[!]ET]:unit_list	Embedded targets [default=off]
 [/[!]DR]:unit_list	Disconnect/Reselect [default=on]
unit_list:
 unit[,unit_list]
unit:
 t | (t,l)
t			Target ID
l			Target LUN

Options are case-insensitive.


OS/2 queues and displays our messages long after BTOS2.ADD completes
loading.  All attempts to insert delays to prolong the message display
time happen under the OS/2 banner before the messages are actually on
the screen.

-----------------------------------------------------------------------------
CorelSCSI
-----------------------------------------------------------------------------

ASPI has been tested using CorelSCSI 2.04 for OS/2.  It works, but we
don't recommend it.  The copyright date on it is 1993.  Drive icons will
show a removable hard disk regardless if it is a fixed disk or CD-ROM.

If you have a built-in SCSI adapter, CorelSCSI will not work with
anything other than the first adapter.  This can be verified by
reversing the load order of the SCSI ADDs in CONFIG.SYS.  Do not do this
to your boot partition however.  The boot partition must remain first.


-----------------------------------------------------------------------------
DRIVER INSTALLATION
-----------------------------------------------------------------------------

You cannot use this driver to install OS/2 Warp on your laptop because
the necessary Card & Socket Services files are compressed on the CD-ROM.
IBM requires that the operating system and PCMCIA Card Services are
already installed and running.

Your SCSI bus is also assumed to be valid.  You should test it out under
DOS first.

If you only have the CD-ROM version of OS/2 Warp, you will need to
create disk images under DOS.  Install OS/2 and PCMCIA Card Services
from the disk images.  You will need to contact IBM to determine how to
install PCMCIA Card Services for OS/2 if your system is not on OS/2's
Hardware Compatibility List _before_ you attempt to install this SCSI
driver.

Once you have Card Services running under OS/2, you can prove it to
yourself by inserting a PCMCIA modem.  Use HyperTerm to test the modem.
If everything works, you are now ready to install the SCSI driver.

1.  Run Device Driver Install from the System Setup folder
    (DDINSTALL.EXE).  The source directory should be A:\OS2.  The
    destination directory should be C:\, the root directory of the drive
    you installed OS/2 to.  This will copy BTOS2.ADD to \OS2\BOOT and
    add a BASEDEV statement to the end of C:\CONFIG.SYS.

    An example CONFIG.SYS:
      rem AST PowerExec Socket Services
      rem Card Status Change Interrupt = 0x0A
      BASEDEV=PCMCIA.SYS
      BASEDEV=IBM2AST1.SYS /S0=2
      rem PCMCIA SCSI Bus Toaster Adapter Device Driver V1.00
      BASEDEV=BTOS2.ADD /V 

2.  Make sure the Bus Toaster is inserted in one of the PCMCIA sockets.
    Try out the default BASEDEV loading of BTOS2.ADD by rebooting OS/2.

3.  You should see a list of your SCSI devices when the driver loads.

4.  If your CD-ROM drive does not show up, you may need to install it.
    Run Selective Install and choose your CD-ROM drive model.

    The SCSI Adapter Support field will show None.  Do not modify this
    field.  Leave it None.  Only SCSI adapters with device drivers in
    the OS/2 distribution disks or CD-ROM will be listed here.

    To install the CD audio player, you need to check the Multimedia
    Software Support on the second page of Selective Install.  This
    will reconfigure your Multimedia Pack to support the new CD-ROM.

IBM requires that PCMCIA SCSI adapters must be inserted, all SCSI
targets must be powered on, and the SCSI bus must be properly terminated
before booting OS/2.
