This archive holds the driver for the Mitsumi CD-ROM drive.
It has been tested with the Mitsumi models FX001D double speed and
FX001 high speed; it should also work with models LU005 and FX001 single speed.
Note that this works with the Mitsumi drive through its own controllers, both
the 16-bit and 8-bit cards has been tested.  It has not yet been tested
with a Mitsumi CD-ROM plugged into a Soundblaster card.  (If you wish to try
it out, please mail your experience to beta@mwc.com!)

Note that this driver works only with COHERENT 4.2.10 or later.  If
you have COHERENT 4.2.05, write to support@mwc.com and request an update:
it is free.

To install the driver into your kernel, do the following as user root:

- Copy contents of this archive into directory /etc/conf/mcd.

- The driver uses major number 16.  Modify the appropriate line in
  /usr/include/sys/devices.h:

	#define MCD_MAJOR	16	/* Mitsumi CD-ROM drive	*/

  An example "devices.h" is in the directory ./src.  If "devices.h" isn't
  already modified, copy this file to directory "/usr/include".

- Look at file "Space.c".  The I/O address for the Mitsumi controller
  must be changed to the right value.  Space.c comes with an I/O address
  of 0x300, which is the default I/O address for this controller.  If you
  jumpered it to another address it must be changed in Space.c appropriate.
  Also the interrupt must be set correct, the default is IRQ 10.  The
  driver doesn't use DMA yet, a later release might do.  The controller
  comes with the default of DMA channel 5, which is very bad because 5
  is used by Soundblaster cards by default.  I jumpered my controller to
  channel 6 and in Space.h 6 also is configured.  This is not essential
  with this release of the driver, but I would suggest to jumper the
  card to a free DMA channel and configure it correct in Space.c, this
  will save you trouble later.

- Copy the file "cdrom.h" into the directory src to /usr/include/sys.  This
  header file includes ioctl functions and structures for the audio
  support.   The definitions are common for all supported CD-ROM drives.
  This header file will become part of a future COHERENT distribution.
  It is a good idea to check if this file doesn't exist already in
  /usr/include/sys. If it already is there don't copy this version and
  overwrite the official version, which probably was distributed with
  your Coherent or an upgrade.

- Add the following line into the section "old-style Coherent drivers"
  in the file /etc/conf/mdevice:

  mcd	-	CGHo	mcd	16	16	0	255	-1	-1

- Add the following line into the section "old-style Coherent drivers"
  in the file /etc/conf/sdevice:

  mcd	Y	0	0	0	0	0x0	0x0	0x0	0x0

- Now build a new kernel including this driver:

	cd /etc/conf
	bin/idmkcoh -o /coh.test

- To create the special files in "/dev" needed for the drive, run the
  shell script "mkdev".  The script also creates a link to /dev/cdrom
  if this file doesn't exist already.  This is the default device used
  by the applications xcdplayer and cdview, it can be linked to other
  CD-ROM drivers when more then one drive is installed in the machine.

Now reboot the machine with the new kernel coh.test.  The driver prints
the release message to the console and some informations about the
used Mitsumi CD-ROM if one was found.  If the driver doesn't find a CD-ROM
drive it print the message "No Mitsumi CD-ROM drive recognized" instead.
This means that either the I/O address in Space.c is wrong or the driver
isn't compatible to the used CD-ROM drive.

If the message looks like "Unknown Mitsumi CD-ROM type x found" this means
that the driver doesn't know exactely which model you are using. The driver
uses a minimal common command set then, probably it will work OK with this
drive, but you should email the exact message and the model number of the
drive you are using to support@mwc.com, so that we can improve the device
driver.
