patch-1.3.63 linux/Documentation/cdrom/sjcd

Next file: linux/Documentation/modules.txt
Previous file: linux/Documentation/cdrom/isp16
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v1.3.62/linux/Documentation/cdrom/sjcd linux/Documentation/cdrom/sjcd
@@ -1,4 +1,4 @@
- -- README.sjcd
+ -- Documentation/cdrom/sjcd
 				80% of the work takes 20% of the time,
 				20% of the work takes 80% of the time...
 						(Murphy law)
@@ -6,57 +6,24 @@
 				Once started, training can not be stopped...
 						(StarWars)
 
-This is the README for the sjcd cdrom driver, version 1.5.
+This is the README for the sjcd cdrom driver, version 1.6.
 
 This file is meant as a tips & tricks edge for the usage of the SANYO CDR-H94A
 cdrom drive. It will grow as the questions arise. ;-)
-Since the drive often comes with an ISP16 soundcard, which can be used
-as cdrom interface, this is also the place for ISP16 related issues.
+For info on configuring the ISP16 sound card look at Documetation/cdrom/isp16.
 
-The driver should work with any SoundBlaster/Panasonic style CDROM interface,
-including the "soft configurable" MediaMagic sound card.
-To make this sound card (and others like "Mozart") working, it has to get 
-"configured" by software.
-The suggestion to configure the ISP16 soundcard by booting DOS and 
-a warm reboot to boot Linux somehow doesn't work, at least not
-on Eric's machine (IPC P90), with the version of the ISP16
-card he has (there appear to be at least two versions: Eric's card with
-no jumpered IDE support and OPTi 82C928 chip, and Vadim's version
-with a jumper to enable IDE support, probably with a OPTi 82C929 chip).
-Therefore detection and configuration of the ISP16 interfaces is included
-in the driver.
-If we should support any other interfaces (which cannot be configured
-through DOS) or if there are any more ISP16 types, please let us
-know (maarel@marin.nl) and we'll see.
-
-Otherwise, you should boot DOS once (and by this, run the "configuration driver")
-and then switch to Linux by use of CTRL-ALT-DEL. Each use of the RESET
-button or the power switch makes this procedure necessary again.
-If no ISP16 is detected, there's no harm done; a card configured trough DOS
-may still work as expected.
-
-As of version 1.4 sound through the speakers is supported; only for MSS-mode 
-and no volume controle yet.
-
-PAUSE and STOP ioctl commands don't seem to work yet.
-
-ISP16 configuration routines reside at Vadim's server
-      ftp.rbrf.ru:/linux/mediamagic/
-and at Eberhard's mirror
-      ftp.gwdg.de:/pub/linux/cdrom/drivers/sanyo/
-
-Leo Spiekman's configuration routines for the ISP-16 card can get found at
-      dutette.et.tudelft.nl:/pub/linux/
-and at Eberhard's mirror
-      ftp.gwdg.de:/pub/linux/cdrom/drivers/optics/
-
-Eric van der Maarel's routines are included in sjcd.c.
-This, and any related stuff may be found by anonymous ftp at
-      ftp.gwdg.de:/pub/linux/cdrom/drivers/sanyo/
+The driver should work with any of the Panasonic, Sony or Mitsum style
+CDROM interface.
+The cdrom interface on Media Magic's soft configurable sound card ISP16,
+which used to be included in the driver, is now supported in a separate module.
+This initilisation module will probably also work with other interfaces
+based on an OPTi 82C928 or 82C929 chip (like MAD16 and Mozart): see the
+documentation Documentation/cdrom/isp16.
 
 The device major for sjcd is 18, and minor is 0. Create a block special
 file in your /dev directory (e.g., /dev/sjcd) with these numbers.
-(For those who don't know, being root and doing the following should do the trick:
+(For those who don't know, being root and doing the following should do
+the trick:
   mknod -m 644 /dev/sjcd b 18 0
 and mount the cdrom by /dev/sjcd).
 
@@ -64,17 +31,30 @@
   base address 0x340
   no irq
   no dma
-As of version 1.2, setting base address, irq and dma at boot time is supported
+(Acctulay the CDR-H94A doesn't know how to use irq and dma.)
+As of version 1.2, setting base address at boot time is supported
 through the use of command line options: type at the "boot:" prompt:
-  linux sjcd=<base address>,<irq>,<dma>
-(where your kernel is assumed to be called by saying "linux" to
-the boot manager).
+  linux sjcd=<base_address>
+(where you would use the kernel labeled "linux" in lilo's configuration
+file /etc/lilo.conf). You could also use 'append="sjcd=<configuration_info>"'
+in the appropriate section of /etc/lilo.conf
+If you're building a kernel yourself you can set your default base
+i/o address with SJCD_BASE_ADDR in include/linux/sjcd.h.
+
+The sjcd driver supports beng loaded as a module. The following
+command will set the base i/o address on the fly (assuming you
+have installed the module in an appropriate place).
+  insmod sjcd.o sjcd_base=<base_address>
 
-If something is wrong, e-mail to		vadim@rbrf.ru
+
+Have fun!
+
+If something is wrong, please email to		vadim@rbrf.ru
 					or 	vadim@ipsun.ras.ru
 					or	model@cecmow.enet.dec.com
+					or	H.T.M.v.d.Maarel@marin.nl
 
 It happens sometimes that Vadim is not reachable by mail. For these
-instances, Eric van der Maarel (maarel@marin.nl) will help, too.
+instances, Eric van der Maarel will help too.
 
 		Vadim V. Model, Eric van der Maarel, Eberhard Moenkeberg

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