diff options
Diffstat (limited to 'share/man/man4/man4.i386/matcd.4')
-rw-r--r-- | share/man/man4/man4.i386/matcd.4 | 109 |
1 files changed, 47 insertions, 62 deletions
diff --git a/share/man/man4/man4.i386/matcd.4 b/share/man/man4/man4.i386/matcd.4 index 56b799a..e13b021 100644 --- a/share/man/man4/man4.i386/matcd.4 +++ b/share/man/man4/man4.i386/matcd.4 @@ -91,13 +91,9 @@ .Nm matcd .Nd Matsushita (Panasonic) CD-ROM driver .Sh SYNOPSIS -.Pp .Cd "device matcd[0-4] at isa? port [?| addr]" -.br .Cd "/dev/[r]matcd[0-15][a|c] -.br .Cd "/dev/[r]matcdl[0-15][a|c] -.Pp .Sh DESCRIPTION The .Nm @@ -106,44 +102,42 @@ Matsushita-Kotobuki Electronics Industries, or Matsushita for short. These CD-ROM drives have been sold under the Panasonic (which is a trade name for Matsushita), Creative Labs (omniCD) and Reveal names, and have been included in computers made by Tandy, AST, Packard Bell and many others. - +.Pp These drives connect to the PC ISA bus through a proprietary host interface. This interface can exist as a stand-alone ISA card, or can be included on a sound card. - .Sh DRIVER CONFIGURATION The .Nm driver supports up to four host interfaces with up to four drives on each interface. Audio activity may occur on all drives simultaneously. Data read operations are limited to one drive per host interface at any instant. - +.Pp To support multiple host interfaces, it is necessary to modify the entries in the kernel configuration file. Normally your system comes with the file \fI/usr/src/sys/i386/conf/GENERIC\fR. You should make a copy of this file and give it the name of your system. You can then edit the new file to include devices you want the system to support and delete the device entries that you don't want. - +.Pp In this file, you will find an entry like: - - device matcd0 at isa? port ? - +.Bd -literal -offset indent +device matcd0 at isa? port ? +.Ed +.Pp To support two host interfaces, change the file so it reads: - - device matcd0 at isa? port ? -.br - device matcd1 at isa? port ? -.br - +.Bd -literal -offset indent +device matcd0 at isa? port ? +device matcd1 at isa? port ? +.Ed +.Pp (If you want to support up to three or four host interfaces, add additional entries). -.if n .bp -.if t .sp +.Pp Note that the kernel configuration does not need to be modified to support up to four drives on a single host interface. It is also not necessary to have four drives on a single interface before adding a second interface. - +.Pp By default, .Nm searches for the CD-ROM host interface adapters by using a table of known I/O @@ -153,8 +147,7 @@ that are located at the I/O ports that .Nm is checking for CD-ROM host interfaces. In addition, checking multiple locations can cause the boot process to take longer than it could. -.if t .bp -.if n .sp +.Pp If you are having these problems, you can solve them by explicitly specifying where the CD-ROM host interfaces are located. For example, by default most SoundBlaster cards have the Matsushita CD-ROM host interface @@ -166,20 +159,20 @@ opportunity to change settings for any of the devices included the kernel. For example, to change the I/O port for .Nm adapter zero to 0x340, you would type - - config> port matcd0c 0x340 - +.Pp +.Dl "config> port matcd0c 0x340" +.Pp If you recompile the kernel, you can change the entry in the kernel configuration file to specify a specific address by changing an entry like this: - - device matcd0 at isa? port 0x230 - +.Pp +.Dl "device matcd0 at isa? port 0x230" +.Pp With this change, the .Nm driver will only look at I/O port 0x230 for the first CD-ROM host interface and will not disturb any other I/O ports. - +.Pp Once you have adjusted the kernel configuration file, it is necessary to configure and recompile the kernel, install it and reboot for the changes to take effect. @@ -187,40 +180,38 @@ changes to take effect. At this time, there are only two known drive models that work with the .Nm driver: -.Bl -tag -width CR-123-X -compact -offset indent -.br -.It Matsushita CR-562-x -.br -.It Matsushita CR-563-x -.br +.Bl -item -width CR-123-X -compact -offset indent +.It +Matsushita CR-562-x +.It +Matsushita CR-563-x .El Most resellers leave these original markings on the drives since the label also has the FCC, VDE, CSA and RU certification marks. - +.Pp Both of these drive models have motorized trays. There is also a custom version of these drives that does not have the volume control or headphone jack (seen on some Tandy computers), but this drive also works with .Nm . - +.Pp The Matsushita CR-522-x and CR-523-x CD-ROM drive is not usable with .Nm . The CR-522 and CR-523 can also be identified from the front as it requires a CD-caddy. - +.Pp Drives with IDE interfaces must use an IDE driver. - +.Pp The TEAC CD-55 4X CD-ROM drive also uses the Creative/Panasonic interface but the TEAC drive is \fInot\fR compatible with the Matsushita CR-56x drives. The TEAC drive cannot be used with .Nm . -.if t .sp -.if n .bp +.Pp The most common source of host interface adapters for the Panasonic drives are found in products from Creative Labs, including SoundBlaster sound cards. There are numerous models of SoundBlaster sound cards, and most of the newer cards provide the appropriate interface, sometimes labeled as the "Creative/Panasonic" interface. - +.Pp The following host interface adapters are known to work with the .Nm driver: @@ -244,28 +235,26 @@ PhoneBlaster SB16 + Sierra 14.4K Voice/FAX/Data/Speakerphone modem combo (CT3100 .It Reveal (SC400) .El - +.Pp Caution: Some of these sound boards can be optionally manufactured to not include the Panasonic/Creative interface, so check the board before buying solely based on model number. - +.Pp This is by no means a complete list as Creative Labs and other vendors that produce sound cards with an identical Creative/Panasonic drive interface release new versions of their adapters all the time. - +.Pp In addition to Creative Labs adapters, adapters that are compatible with Media Vision, IBM and Lasermate adapters are also supported. However, these adapters use a wide range of I/O port addresses, so the driver must be reconfigured to locate these adapters. - +.Pp It is important to understand that some manufacturers have a different host interface implementation. If you have a board that won't communicate with the drives under MS-DOS using the genuine Creative Labs drivers, then .Nm may not work with that host adapter. -.br -.if t .bp -.if n .sp +.Pp .Sh SUPPORTED OPERATIONS The .Nm @@ -274,15 +263,14 @@ driver supports block and character access. Partition "a" returns 2352-byte Frames from any type of CD, including audio CDs. (Partition "c" cannot be "mounted" with cd9660 or other filesystem emulators.) No other partitions are supported. - +.Pp The .Nm matcdl devices work the same as the normal .Nm devices except that the drive trays are locked and remain locked until all of the devs on that drive are closed. -.if n .bp -.if t .sp +.Pp .Nm Matcd accepts numerous .Fn ioctl @@ -356,7 +344,6 @@ The commands defined above are the only ones that the .Nm driver supports. -.bp .Sh FILES .Bl -tag -width /dev/(r)matcd0a_/dev/(r)matcdl0a -compact .It Pa /dev/[r]matcd0a /dev/[r]matcdl0a @@ -369,7 +356,7 @@ recorded in any format. Source code and compilation options for .Nm . .El - +.Pp The file \fIoptions.h\fR contains all of the compilation options. By default, the driver is configured to run on the current version of .Fx . @@ -377,21 +364,21 @@ By default, the driver is configured to run on the current version of .Pp The Creative/Panasonic interface does not use interrupts or DMA although the drives themselves are capable of using both. - +.Pp If the disc tray is opened while one or more partitions are open, further I/O to all partitions on the drive will be rejected until all partitions are closed. - +.Pp There must be a drive on each host interface that is addressed as physical drive 0. If this isn't the case, the driver will be unable to find the host interface or any of the connected drives. - +.Pp Drives on a second host interface start are considered logical drives 4-7, 8-11 on the third interface and 12-15 on the fourth. - +.Pp The first drive on the second host interface is logical drive 4 regardless of how many drives are present on the first host interface. - +.Pp Host interfaces are numbered in the order they are declared in the kernel configuration file, or in the order they are found if the kernel configuration file uses "?" for the port address. Host interface @@ -401,7 +388,7 @@ numbers are always contiguous. .Sh AUTHORS The driver and documentation was written by .An Frank Durda IV . -.br +.Pp Program and Documentation are Copyright 1994, 1995, All rights reserved. .Sh HISTORY @@ -409,5 +396,3 @@ The .Nm driver appeared in .Fx 2.0.5 . - -509253 |