patch-pre2.0.7 linux/Documentation/cdrom/mcdx

Next file: linux/Documentation/isdn/README
Previous file: linux/Documentation/Configure.help
Back to the patch index
Back to the overall index

diff -u --recursive --new-file pre2.0.6/linux/Documentation/cdrom/mcdx linux/Documentation/cdrom/mcdx
@@ -1,44 +1,46 @@
-This is a first attempt to create an `improved' driver for the Mitsumi drives.
-It is able to "live together" with mcd.c, if you have at least two Mitsumi
-drives: each driver can use his own drive.
-
-To allow this "coexistence" as long as mcdx.c is not a superset of mcd.c,
-this driver has to use its own device files. We use MAJOR 20 for it. So,
-you have to do
+This actually is an `improved' driver for the Mitsumi CD-ROM drives. 
 
- # mknod /dev/mcdx0 b 20 0
- # mknod /dev/mcdx1 b 20 1
+We are using the major device number 20 for it. So, you have to do
+
+~# mknod /dev/mcdx0 b 20 0
+~# mknod /dev/mcdx1 b 20 1
 
 and so on, one entry for each drive to support, once.
 
-If you are using the driver as a module, you can specify your ports and IRQs
-like
+If you are using the driver as a module, you can specify the ports and IRQs
+like:
+
+ # insmod mcdx.o mcdx=0x300,11
 
- # insmod mcdx.o mcdx=0x300,11,0x304,5
+and so on ("address,IRQ" pairs). When You intend to use more then one
+drive, it's necessary to edit the mcdx.h file found in
+/usr/src/linux/include/linux. Instead of providing the values on the
+command line, You can "hardwire" them all in mcdx.h. The command line
+values take precedence over the values in mcdx.h. 
 
-and so on ("address,IRQ" pairs).
-This will override the configuration in mcdx.h.
+WARNING: BE CAREFUL TO SUPPLY THE CORRECT VALUES OTHERWISE THE WHOLE SYSTEM
+WILL HANG DURING BOOT-UP OR LOADING OF THE DRIVER!!!
 
 This driver:
 
-	o	handles XA (and hopefully) multi session CDs as well as
-		ordinary CDs;
-	o	supports up to 5 drives (of course, you'll need free 
-		IRQs, i/o ports and slots);
-	o	uses much less kernel memory than the standard mcd driver
-		(no extra driver internal buffers!).
-    o   plays audio (like the `old' driver, I hope)
+	o	Handles XA and multi session CDs as well as ordinary CDs.
+	o	Supports up to 5 drives (of course, you'll need free 
+		IRQs, i/o ports and slots).
+	o	Uses *much* less kernel memory than the standard mcd driver.
+	o 	Plays audio like the `old' driver.
 
 This version doesn't support yet:
 
-	o	shared IRQs (but it seems to be possible - I've successfully
-                connected two drives to the same irq.  So it's `only' a 
-                problem of the driver.)
+	o	Shared IRQs, due to the fact that otherwise it wouldn't be
+		possible to distinguish the drives issuing the interrupt in the 
+		corresponding handling routine.
 
 This driver never will:
 
 	o	Read digital audio (i.e. copy directly), due to missing
 		hardware features. 
+	o	Do DMA transfers. This is simply far less efficient with such 
+		a slow device. Further, the SoundBlaster interfaces doesn't
+		support it, so it's not worth the effort.
 
-
-heiko@lotte.sax.de
+1996/05/20 Marcin Dalecki <dalecki@namu03.gwdg.de>

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen, slshen@lbl.gov with Sam's (original) version
of this