NAME    [Toc]    [Back]

     mcd -- Mitsumi CD-ROM driver

SYNOPSIS    [Toc]    [Back]

     device mcd 1

     In /boot/device.hints:
     hint.mcd.0.at="isa"
     hint.mcd.0.port="0x300"
     hint.mcd.0.irq="10"

DESCRIPTION    [Toc]    [Back]

     The mcd driver provides a data and audio interface to the Mitsumi-brand
     CD-ROM player.  The CD-ROM player must be interfaced to the ISA bus
     through one of the Mitsumi proprietary controller boards.	The controller
     boards supported are the LU002S, LU005S, the FX001 and the quite common
     FX001D.

     The mcd driver responds to disk-specific ioctl() commands, namely the
     DIOCGDINFO, DIOCGPART, DIOCWDINFO, and DIOCSDINFO, commands.  Other diskspecific
 ioctl() commands will return an error.

     The mcd driver also responds to special CD-ROM ioctl() commands.  These
     commands control the CD-ROM player's audio features.  The commands are:

	   CDIOCREADSUBCHANNEL	get sub-channel information on current status
				of disc playing
	   CDIOCREADTOCHEADER	get table of contents header
	   CDIOCREADTOCENTRYS	gets all of the table of contents
	   CDIOCPLAYTRACKS	begins audio playing at location specified
	   CDIOCPLAYBLOCKS	fails with error EINVAL
	   CDIOCPLAYMSF 	begins audio playing at location specified
	   CDIOCRESUME		resumes playing a previously paused disc
	   CDIOCPAUSE		pauses a playing disc
	   CDIOCSTART		begins playing a disc
	   CDIOCSTOP		stops a previously playing disc
	   CDIOCEJECT		opens the disc tray (there is no support for a
				corresponding un-eject command).
	   CDIOCRESET		stops any play and resets the Mitsumi controller
 board
	   CDIOCSETDEBUG	cause the kernel to print debug messages to
				the console about the mcd driver
	   CDIOCCLRDEBUG	cause the kernel to quit printing debug messages
 about the mcd driver

     The ioctl() commands defined above are the only ones that the mcd driver
     supports.	There are other CD-ROM related ioctl() commands (such as
     CDIOCSETVOL and CDIOCSETSTERIO) which are available and may be supported
     by future versions of the driver.

FILES    [Toc]    [Back]

     /dev/(r)mcd0a  accesses BSD partition on the disc.  Normally, there is
		    only one file system on a CD-ROM disc.
     /dev/(r)mcd0c  accesses raw device.

NOTES    [Toc]    [Back]

     The character-mode devices for the mcd driver should only be used for
     accessing the audio features of the CD-ROM player as the performance on
     data is abysmal.

     The current version of the driver uses neither the DMA or IRQ features of
     the interface board, although it has an interrupt handler for any IRQ
     requests that are generated.  Until the DMA features are supported, the
     only interrupts that the board generates are those that aren't supported
     by the driver anyway.

SEE ALSO    [Toc]    [Back]

     <sys/cdio.h>

AUTHORS    [Toc]    [Back]

     The driver was written by Holger Veit (data part) and Brian Moore (audio
     part).  Changes were provided by Gary Clark II, Andrew A. Chernov, and
     Jordan K. Hubbard.

HISTORY    [Toc]    [Back]

     An mcd driver appeared in FreeBSD 1.0.


FreeBSD 5.2.1		       December 8, 1994 		 FreeBSD 5.2.1