1.\" 2.\" Copyright (c) 1994 Keith E. Walker 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. The name of the author may not be used to endorse or promote products 14.\" derived from this software withough specific prior written permission 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\"
| 1.\" 2.\" Copyright (c) 1994 Keith E. Walker 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. The name of the author may not be used to endorse or promote products 14.\" derived from this software withough specific prior written permission 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\"
|
27.\" $FreeBSD: head/share/man/man4/man4.i386/mcd.4 81622 2001-08-14 10:01:54Z ru $
| 27.\" $FreeBSD: head/share/man/man4/man4.i386/mcd.4 84877 2001-10-13 09:08:37Z yokota $
|
28.\" 29.Dd December 8, 1994 30.Dt MCD 4 i386 31.Os 32.Sh NAME 33.Nm mcd 34.Nd Mitsumi CD-ROM driver 35.Sh SYNOPSIS
| 28.\" 29.Dd December 8, 1994 30.Dt MCD 4 i386 31.Os 32.Sh NAME 33.Nm mcd 34.Nd Mitsumi CD-ROM driver 35.Sh SYNOPSIS
|
36.Cd "device mcd0 at isa? port 0x300 irq 10"
| 36.Cd "device mcd 1" 37.Pp 38In 39.Pa /boot/device.hints : 40.Cd hint.mcd.0.at="isa" 41.Cd hint.mcd.0.port="0x300" 42.Cd hint.mcd.0.irq="10"
|
37.Sh DESCRIPTION 38The 39.Nm 40driver provides a data and audio interface to the Mitsumi-brand CD-ROM 41player. 42The CD-ROM player must be interfaced to the ISA bus through 43one of the Mitsumi proprietary controller boards. 44The controller 45boards supported are the LU002S, LU005S, the FX001 and the quite 46common FX001D. 47.Pp 48The 49.Nm 50driver responds to disk-specific 51.Fn ioctl 52commands, namely the 53.Dv DIOCGDINFO , 54.Dv DIOCGPART , 55.Dv DIOCWDINFO , 56and 57.Dv DIOCSDINFO , 58commands. 59Other disk-specific 60.Fn ioctl 61commands will return an error. 62.Pp 63The 64.Nm 65driver also responds to special CD-ROM 66.Fn ioctl 67commands. 68These commands 69control the CD-ROM player's audio features. 70The commands are: 71.Pp 72.Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent 73.It CDIOCREADSUBCHANNEL 74get sub-channel information on current status of disc playing 75.It CDIOCREADTOCHEADER 76get table of contents header 77.It CDIOCREADTOCENTRYS 78gets all of the table of contents 79.It CDIOCPLAYTRACKS 80begins audio playing at location specified 81.It CDIOCPLAYBLOCKS 82fails with error 83.Er EINVAL 84.It CDIOCPLAYMSF 85begins audio playing at location specified 86.It CDIOCRESUME 87resumes playing a previously paused disc 88.It CDIOCPAUSE 89pauses a playing disc 90.It CDIOCSTART 91begins playing a disc 92.It CDIOCSTOP 93stops a previously playing disc 94.It CDIOCEJECT 95opens the disc tray (there is no support for a corresponding un-eject 96command). 97.It CDIOCRESET 98stops any play and resets the Mitsumi controller board 99.It CDIOCSETDEBUG 100cause the kernel to print debug messages to the console about the 101.Nm 102driver 103.It CDIOCCLRDEBUG 104cause the kernel to quit printing debug messages about the 105.Nm 106driver 107.El 108.Pp 109The 110.Fn ioctl 111commands defined above are the only ones that the 112.Nm 113driver supports. 114There are other CD-ROM related 115.Fn ioctl 116commands (such as 117.Dv CDIOCSETVOL 118and 119.Dv CDIOCSETSTERIO ) 120which are available 121and may be supported by future versions of the driver. 122.Sh FILES 123.Bl -tag -width /dev/(r)mcd0a -compact 124.It Pa /dev/(r)mcd0a 125accesses 126.Bx 127partition on the disc. 128Normally, there is only 129one file system on a CD-ROM disc. 130.It Pa /dev/(r)mcd0c 131accesses raw device. 132.El 133.Sh NOTES 134The character-mode devices for the 135.Nm 136driver should only be used for accessing the audio features of the 137CD-ROM player as the performance on data is abysmal. 138.Pp 139The current version of the driver uses neither the DMA or IRQ 140features of the interface board, although it has an interrupt handler 141for any IRQ requests that are generated. 142Until the DMA features are 143supported, the only interrupts that the board generates are those that 144aren't supported by the driver anyway. 145.Sh SEE ALSO 146.Pa /usr/include/sys/cdio.h 147.Sh AUTHORS 148.An -nosplit 149The driver was written by 150.An Holger Veit 151(data part) and 152.An Brian Moore 153(audio part). 154Changes were provided by 155.An Gary Clark II , 156.An Andrew A. Chernov , 157and 158.An Jordan K. Hubbard . 159.Sh HISTORY 160An 161.Nm 162driver appeared in 163.Fx 1.0 .
| 43.Sh DESCRIPTION 44The 45.Nm 46driver provides a data and audio interface to the Mitsumi-brand CD-ROM 47player. 48The CD-ROM player must be interfaced to the ISA bus through 49one of the Mitsumi proprietary controller boards. 50The controller 51boards supported are the LU002S, LU005S, the FX001 and the quite 52common FX001D. 53.Pp 54The 55.Nm 56driver responds to disk-specific 57.Fn ioctl 58commands, namely the 59.Dv DIOCGDINFO , 60.Dv DIOCGPART , 61.Dv DIOCWDINFO , 62and 63.Dv DIOCSDINFO , 64commands. 65Other disk-specific 66.Fn ioctl 67commands will return an error. 68.Pp 69The 70.Nm 71driver also responds to special CD-ROM 72.Fn ioctl 73commands. 74These commands 75control the CD-ROM player's audio features. 76The commands are: 77.Pp 78.Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent 79.It CDIOCREADSUBCHANNEL 80get sub-channel information on current status of disc playing 81.It CDIOCREADTOCHEADER 82get table of contents header 83.It CDIOCREADTOCENTRYS 84gets all of the table of contents 85.It CDIOCPLAYTRACKS 86begins audio playing at location specified 87.It CDIOCPLAYBLOCKS 88fails with error 89.Er EINVAL 90.It CDIOCPLAYMSF 91begins audio playing at location specified 92.It CDIOCRESUME 93resumes playing a previously paused disc 94.It CDIOCPAUSE 95pauses a playing disc 96.It CDIOCSTART 97begins playing a disc 98.It CDIOCSTOP 99stops a previously playing disc 100.It CDIOCEJECT 101opens the disc tray (there is no support for a corresponding un-eject 102command). 103.It CDIOCRESET 104stops any play and resets the Mitsumi controller board 105.It CDIOCSETDEBUG 106cause the kernel to print debug messages to the console about the 107.Nm 108driver 109.It CDIOCCLRDEBUG 110cause the kernel to quit printing debug messages about the 111.Nm 112driver 113.El 114.Pp 115The 116.Fn ioctl 117commands defined above are the only ones that the 118.Nm 119driver supports. 120There are other CD-ROM related 121.Fn ioctl 122commands (such as 123.Dv CDIOCSETVOL 124and 125.Dv CDIOCSETSTERIO ) 126which are available 127and may be supported by future versions of the driver. 128.Sh FILES 129.Bl -tag -width /dev/(r)mcd0a -compact 130.It Pa /dev/(r)mcd0a 131accesses 132.Bx 133partition on the disc. 134Normally, there is only 135one file system on a CD-ROM disc. 136.It Pa /dev/(r)mcd0c 137accesses raw device. 138.El 139.Sh NOTES 140The character-mode devices for the 141.Nm 142driver should only be used for accessing the audio features of the 143CD-ROM player as the performance on data is abysmal. 144.Pp 145The current version of the driver uses neither the DMA or IRQ 146features of the interface board, although it has an interrupt handler 147for any IRQ requests that are generated. 148Until the DMA features are 149supported, the only interrupts that the board generates are those that 150aren't supported by the driver anyway. 151.Sh SEE ALSO 152.Pa /usr/include/sys/cdio.h 153.Sh AUTHORS 154.An -nosplit 155The driver was written by 156.An Holger Veit 157(data part) and 158.An Brian Moore 159(audio part). 160Changes were provided by 161.An Gary Clark II , 162.An Andrew A. Chernov , 163and 164.An Jordan K. Hubbard . 165.Sh HISTORY 166An 167.Nm 168driver appeared in 169.Fx 1.0 .
|