mcd(4) Mitsumi CD-ROM driver

SYNOPSIS

device mcd

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

DESCRIPTION

The 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 driver responds to disk-specific Fn ioctl commands, namely the DIOCGDINFO DIOCGPART DIOCWDINFO and DIOCSDINFO commands. Other disk-specific Fn ioctl commands will return an error.

The driver also responds to special CD-ROM Fn 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 Er 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 driver
CDIOCCLRDEBUG
cause the kernel to quit printing debug messages about the driver

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

FILES

/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

The character-mode devices for the 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 are not supported by the driver anyway.

HISTORY

An driver appeared in Fx 1.0 .

AUTHORS

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