Category : OS/2 Files
Archive   : MITFX.ZIP
Filename : README.MIT

23 November 1993
------------
| OVERVIEW |
------------

This README describes an OS/2 device driver (MITFX001.ADD) for the
Mitsumi CD-ROM drives. The device driver supports the new
FX series of Mitsumi drives: the single speed CRMC-FX001 and the
double-speed CRMC-FX001D. The device driver also supports the
older Mitsumi CRMC-LU005 and CRMC-LU002 (also known as the Tandy CDR-1000
or BSR-6800).


Supported Features
------------------
The OS/2 Mitsumi CD-ROM device driver (MITFX001.ADD) supports the
following features:

* Reads data from CD-ROM discs conforming to the High Sierra/ISO-9660
file formats.

* Plays audio from standard audio CDs or mixed mode CD-ROM discs
containing both data and audio

* Multisession photo CD (except for CRMC-LU002)

* Reads data from Mode 2 Form 1 or Mode 2 Form 2 sector formats

* MMPM/2 Software Motion Video

* MMPM/2 CD Audio Player

* Software lock, unlock and eject (Models FX001 and FX001D only)

* Data transfer via software polling or interrupts


THIS CD-ROM DEVICE DRIVER IS DESIGNED TO BE USED WITH THE OS/2 2.1 PRODUCT
AND IS GOVERNED BY THE TERMS AND CONDITIONS OF THE OS/2 PROGRAM LICENSE
AGREEMENT.





----------------
| INSTALLATION |
----------------

Before starting the installation procedure, you should unzip the
files included in the MITFX.ZIP file and copy them to a diskette.
The diskette you created will be referred to as the "Mitsumi CD-ROM Device
Driver Diskette" in the following installation instructions.

The following files are included in the MITFX.ZIP file:

MITFX001.ADD - OS/2 device driver for Mitsumi FX001, FX001D, LU005
MITFX001.DDP - Mitsumi device driver installation profile
README.MIT - This README file.



Installation if OS/2 2.1 is already installed on your fixed disk
----------------------------------------------------------------

1. Run the Device Driver installation program

a. Open the OS/2 System folder on the desktop.
b. Open the System Setup folder.
c. Open Device Driver Install.
d. Insert the "Mitsumi CD-ROM Device Driver Diskette"
e. Select Install
f. Select the device driver to install from the list
g. Select OK.

(Note: You do not need to reboot OS/2 before starting step 2 below).

2. After the Device Driver Installation is complete, you must run
Selective Install to install the files for the OS/2 CD-ROM Device
Manager and OS/2 CD-ROM File System.

a. Open the OS/2 System folder on the desktop.
b. Open the System Setup folder.
c. Open Selective Install
d. Select the CD-ROM Device Support check box
e. Select OK
f. Scroll to the bottom of the CD-ROM device list table and
select the choice OTHER
g. Select OK
h. Select the OK push button to proceed from the System Configuration
screen to the OS/2 Setup and Installation window
i. Select Install
j. When prompted to do so, insert the numbered installation diskettes
or installation CD-ROM from the OS/2 2.1 product.


3. If you have changed the base I/O port address on your CD-ROM
host adapter card from the default value of 300, you must edit
your CONFIG.SYS file and add the /P:nnn parameter on the
BASEDEV=MITFX001.ADD statement in your CONFIG.SYS file. Refer to
the "Mitsumi Device Driver Parameters" section below.


4. Shut down and restart your system




Installation from the CD-ROM version of OS/2 2.1
------------------------------------------------

1. Make a copy of the OS/2 2.1 diskette labeled "Diskette 1"

2. Copy the file MITFX001.ADD from the "Mitsumi CD-ROM Device Driver
Diskette" to the root directory on the copy of the OS/2 2.1 Diskette 1.

(Note: If there is not enough room on the copy of OS/2 2.1
Diskette 1, then delete the file IBM2SCSI.ADD. If you delete
IBM2SCSI.ADD, you must also edit the CONFIG.SYS file and delete
the line BASEDEV=IBM2SCSI.ADD)

3. Edit the CONFIG.SYS file located on the copy of Diskette 1.
At the end of the file, add the following statement.

BASEDEV=MITFX001.ADD /P:nnn

where "/P:nnn" is the base I/O port address selected on the
CD-ROM host interface card. The default base I/O port address
for the Mitsumi interface card is 300, so the statement would
appear as follows if the card is set to address 300:


BASEDEV=MITFX001.ADD /P:300


4. Begin the installation by inserting the Installation Diskette
into drive A and restarting the system. When prompted to insert
Diskette 1, insert the copy that you modifed.

5. When the System Configuration screen is displayed during installation,
the CD-ROM Device Support field will display "None". Do not modify
the choice and continue with the installation.

6. After installation is complete, and you have rebooted your system,
you will not be able to access your CD-ROM drive. This is due
to a defect in the OS/2 2.1 install program. To access your
CD-ROM drive, perform the following steps:

a. Copy the following files from the OS/2 2.1 Diskette 1
to the drive which OS/2 was installed.
(Note: the example assume C:, change if different)

COPY A:OS2CDROM.DMD C:\OS2
COPY A:CDFS.IFS C:\OS2

b. Edit the CONFIG.SYS file on drive which OS/2 was installed
and add the following statements to the end of the file:
(Note: the example assume C:, change if different)

DEVICE=C:\OS2\OS2CDROM.DMD /Q
IFS=C:\OS2\CDFS.IFS /Q

c. Shut down and reboot the system


7. You will need to run Selective Install to copy over some remaining
system files.

a. Open the OS/2 System folder on the desktop.
b. Open the System Setup folder.
c. Open Selective Install
d. Select the CD-ROM Device Support check box
e. Select OK
f. Scroll to the bottom of the CD-ROM device list table and
select the choice OTHER
g. Select OK
h. Select the OK push button to proceed from the System Configuration
screen to the OS/2 Setup and Installation window
i. Select Install
j. When prompted to do so, insert the installation CD-ROM
from the OS/2 2.1 product.



Installation from the diskette version of OS/2 2.1
--------------------------------------------------

1. Install the OS/2 2.1 product from the diskettes

2. Go to the section above titled "Installation if OS/2 2.1 is already
installed on your fixed disk".




------------------------------------
| Mitsumi Device Driver Parameters |
------------------------------------

This section lists the parameters which are supported for the
Mitsumi CD-ROM device driver. The parameters can be changed by modifying
the BASEDEV=MITFX001.ADD line in config.sys. It is recommended
to change the transfer mode from it default, software polling transfer,
to software interrupt transfer. This will help lower the CPU utilization
of CD-ROM applications, enabling better performance for other tasks
while the CD-ROM drive is being accessed. See the /I parameter below.


For the MITFX001.ADD device driver, the syntax for the line in config.sys
is as follows:

BASEDEV=MITFX001.ADD [/P:nnn] [I:nn] [/V]


[/P:nnn]

Specifies the base I/O port address of the interface card.
This must be the same number as specified by the DIP switch
on the interface card.


[/I:nn]

Specifies the interrupt request (IRQ) channel number. This must
match the value specified on the jumper setting on the interface
card. If this parameter is not specified, the device driver will
use software polling transfer.


[/V]

The device driver will display the device driver revision level
and CD-ROM product information at boot time.



Mitsumi CD-ROM Device Driver Parameter Examples
-----------------------------------------------

1. Mitsumi CD-ROM drive attached to Mitsumi host adapter:

If the Mitsumi host adapter is set to a base I/O port address
of 320, the line in config.sys should be:

BASEDEV=MITFX001.ADD /P:320


2. Mitsumi CD-ROM drive attached to Creative Labs Sound Blaster 16 MultiCD

If the Mitsumi CD-ROM port on the Sound Blaster 16 MultiCD is set
to I/O port address of 340, the line in config.sys should be:


BASEDEV=MITFX001.ADD /P:340


3. To enable interrupt transfer mode, which improves performance,
the /I parameter must be specified. For example to enable
interrupt transfer mode for IRQ channel 10 at I/O port address
of 320h, the line in config.sys should appear as follows:


BASEDEV=MITFX001.ADD /P:320 /I:10



--------------------
| Trouble shooting |
--------------------

1. If you are not able to access the CD-ROM drive:


a. Add the /V parameter switch to the BASEDEV=MITFX001.ADD statement
in your CONFIG.SYS file. For example:

BASEDEV=MITFX001.ADD /P:300 /V


After rebooting, the device driver will display the list of
drives it has identified. For example:

IBM OS/2 MITFX001.ADD 0.11
MITSUMI CD-ROM LU005S M14 Port:0300 IRQ:Polled


If no units were detected, the following message is displayed:

IBM OS/2 MITFX001.ADD
No units detected.


If no units were detected, see step 1b below.
If units were detected, see step 1c below.



b. Make sure the Base I/O Port Address specified by the /P parameter
in the config.sys file matches the Base Port Address selected
with the DIP switch on the interface card.

The default Base I/O Port Address for the Mitsumi interface card is
address 0x0300. If you have changed the Base I/O Port Address on
the card, you must change the /P parameter on the BASEDEV=MITFX001.ADD
statement in config.sys.

For example, if you changed the Base I/O Port Address to 0x0310, the
statement in config.sys should be as follows:

BASEDEV=MITFX001.ADD /P:310


c. Make sure all the required files to operate the CD-ROM drive have
been installed. You should have the appropriate BASEDEV=
statement in CONFIG.SYS for your CD-ROM device driver. You
should also have the following statements for the CD-ROM system
files in your config.sys:


DEVICE=C:\OS2\OS2CDROM.DMD /Q
IFS=C:\OS2\CDFS.IFS /Q
DEVICE=C:\OS2\MDOS\VCDROM.SYS
BASEDEV=MITFX001.ADD /P:300


If you do not have the above statements in your config.sys, you
must use the OS/2 2.1 Selective Install to install the CD-ROM
support files.



2. If the performance of background OS/2 tasks seems slow when the CD-ROM
drive is accessed. Or, if the performance of the MMPM/2 Software Motion
Video clips seems slow or jerky.

a. The MITFX001.ADD device driver should be run using the Software
Interrupt transfer option to enable the best performance in OS/2.
The IRQ (interrupt request) channel assigned by the jumper on the
interface card must match the the interrupt channel specified using
the /I parameter on the BASEDEV=MITFX001.ADD statement in config.sys.
You must assign an IRQ channel that is not being used by any other
interface cards on your computer.

For example, to enable the Software Interrupt transfer option for
IRQ channel 10 (which is the default IRQ for the card), the
statement in config.sys should be as follows:

BASEDEV=MITFX001.ADD /P:300 /I:10


3. If the drive letter assigned to the CD-ROM drive under OS/2 is
different than the drive letter assigned under DOS.

The CD-ROM drive is assigned the next available drive
letter after drive letters have been assigned for the
floppy drives and fixed disk drives.

The drive letter is also assigned after any installable block
device drivers which are located in config.sys before the
DEVICE=C:\OS2\OS2CDROM.DMD statement (i.e. DEVICE=C:\OS2\VDISK.SYS).

There is currently no mechanism in OS/2 for assigning a specific
drive letter for the CD-ROM drive. The drive letter assignment
under DOS can be controlled by using the /L switch on MSCDEX.EXE
command line.


----------------------
| Reporting Problems |
----------------------

Problem reports should include the following information:

CD-ROM Product ID: i.e. FX001D
CD-ROM Firmware Level:
Device Driver Transfer Mode: Software Polling or Interrupt driven
Host Adapter: i.e. Mitsumi CD-ROM Interface card
Host CPU type and speed: i.e. 25MZ 486
First letter of CD-ROM drive serial number: For LU005 models, this should
be either B, C or D.


The CD-ROM product ID and firmware level can be displayed at
boot time by adding the /V switch to the BASEDEV=MITFX001.ADD line
in config.sys. For example, the following line may be displayed at boot
time after the OS/2 logo screen is displayed:


MITSUMI CD-ROM LU005S M14 Port:0300 IRQ: 000A


The firmware level in the example above is M14.