mcd (4)

Leading comments

Copyright (c) 1994 Keith E. Walker
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or ot...

(The comments found at the beginning of the groff file "man4/mcd.4freebsd".)

NAME

mcd - 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 ifconfig 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 ifconfig 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 ifconfig 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 ifconfig driver

CDIOCCLRDEBUG

cause the kernel to quit printing debug messages about the ifconfig driver

The Fn ioctl commands defined above are the only ones that the ifconfig 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 ifconfig 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.

SEE ALSO

In sys/cdio.h

HISTORY

An ifconfig 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 .