CHANGES FROM PREVIOUS VERSIONS ============================== 0.5 Modified to support the linux 2.0 version kernels. This will be my last update. I don't believe, there is any use in supporting a 1x speed CD-ROM drive in the future, that 4x speed CD-ROM drives have reached the price range of a few bucks ... 0.4.3 Changed names according to new major number and LST-bootkernel-requirements as noted by Ralf Flaxa speedup in timer commandline configuration If you update from an older version of this driver, you will notice, that the major device number has changed. It is now 30, so re-create your device special file. See below for instructions. IMPORTANT NOTE ============== THIS DRIVER SUPPORTS NEITHER 205MS DRIVES NOR 206 DRIVES AND FINALLY NOT ANY CONFIGURATION DIFFERING FROM CM250 HOSTADAPTER WITH 205 DRIVE. There's a 206 driver distributed with the standard linux 2.0 kernel.0). ABOUT THIS FILE: ================ This is a README for the file cm205cd0.5.tar.gz. This tar file contains the files: cm205cd0.5.diff README Use the lmscd0.4?.tar.gz for linux kernels version 1.2. For older versions (kernel < 1.1.92) watch out for lmscd0.3?.tar.gz. That includes the 'pure', the a, b and c-Patches ! For the interims 1.1.77-1.1.81 no patch is available. I couldn't modify as fast as the kernel patches came in :-) In lmscd0.3d.tar.gz is the patch for 1.1.82 till 1.1.92. ABOUT THE DRIVER: ================= cm205cd0.5 is an experimental driver for the LMS/Philips CD-ROM CM 205 connected to the CM 250 adapter. It has lots of enhancements and speed ups versus the 0.2 version of the driver. The 0.5 version runs stable on many machines and is for Linux 2.0. It supports kernel mechanism for allocating I/Os and IRQs. I have not come around to implement support to play audio. However, there is rudimantary audio support built into the CM 205 drive hardware: insert an audio CD, and press the volume knob to play it. Press that knob again to skip forward a sector. This driver should also work with the CM 225 external drive and the (old) CM 202. It does not work with the CM 206. Support for that drive is already included with the standard V 2.0 linux kernel distribution. There is a 'Multisession'-Version of the 205-drive in the stores: LMS205MS. This has a slightly different controller, so it can not be used with this version of driver. I am not aware of a driver for the 205MS! INCLUDING THIS DRIVER INTO YOUR KERNEL: ======================================= Unpack the .tar.gz file, then include the changes into your kernel using the patch command: cd /usr/src/linux make mrproper cat cm205cd0.5.diff | patch -p1 -s There should no hunks fail, but if so, look, if you can fix it by hand. If not, send an e-mail. CONFIGURING DEBUGGING: ====================== There is lots of debugging information, which can be compiled into the driver. By default, most of it is off. To turn on some of it (which I would ask you to do if you have problems, so you can report me more details!), change the values of DLEVEL, CLEVEL and DFUNC. DLEVEL defines the debugging level: #define DLEVEL 0 prints very few messages #define DLEVEL 1 prints some messages whenever an error occurs #define DLEVEL 2 protocolls most action, that is going on #define DLEVEL 3 outputs a real lot CLEVEL is how much double checks should be performed. #define CLEVEL 0 turns all integrity checks off #define CLEVEL 1 does a lot of tests, that really should not fail. #define CLEVEL 2 Reports some more errors about conditions, which are strange, but did not cause errors for me so far. If you set DFUNC to 1, additional information is printed along most debugging data, which tells about what action the driver is performing right now, or what the driver is expecting from the hardware. RECOMPILING YOUR KERNEL: ======================== You have to configure your kernel again to ensure, that the CD-ROM driver is really included. Thus don't forget to type "make config". Type (in directory /usr/src/linux): make mrproper; make config make depend make [zImage | zlilo | ...] When asked about the configuration, ensure, that you answer *yes* to the following two questions: * "LMS/Philips CDROM 202/205 driver support" * "ISO9660 cdrom filesystem support". Then type "make depend", and finally use make with your favourite options to compile a kernel. For further information, like installing your newly compiled kernel, please refer to the linux FAQ. CONFIGURING FOR YOUR HARDWARE: ============================== While 'make config' and answering the CM205-question with 'y' you are asked for your hardware-configuration. Please enter just a 3,4,5 or 6 for the interrupt number. But all other interrupts are possible to enter (if you have modified your card for high interrupts). For the I/O-address just enter the index number. If you do not enter 2 (0x300), 3 (0x310) or 4 (0x330) the default 0x340 is used. CREATING THE DEVICE SPECIAL FILE: ================================= After recompiling and installing your new kernel, you have to reboot. To access the drive, you have to create an entry for it in the /dev file. Type: mknod /dev/cm205cd b 30 0 chown root:disk /dev/cm205cd chmod 440 /dev/cm205cd If you want to give read permissions to anyone, use: chmod 444 /dev/cm205cd instead. MOUNTING A DISK: ================ Type: mkdir /cdrom mount -t iso9660 -o ro /dev/cm205cd /cdrom [Note the '-o ro' ! Since CDROMs are usually read-only you will receive an error, if you forget it.] UNMOUNTING/CHANGING A DISK: =========================== Type: umount -t /dev/cm205cd then change the disk, then do the mount command again. You can safely leave unused disks mounted. REPORTING BUGS: =============== Please report any problems you encounter. You can reach me by e-mail as wpp@marie.physik.tu-berlin.de. Please include all information available. This includes: - Which kernel were you using? - Which other patches had you included? - How did you access the CD-ROM, when the driver failed (eg. were you just mounting/unmounting it, starting an executable, copying a file, etc., etc.)? - Did you just start or finish another program (for example, for a while, this driver kept crashing, when I left X-Windows). - Were you accessing other devices heavily at the same time (like sending bitmaps to the printer, ftp'ing to another host, etc.) - Can you reproduce the error, or does is appear unpredictable? - Please include all the debugging output, which was printed in the last few seconds before a crash or other failure. If you can reproduce the error, please recompile the kernel with higher debugging levels, and retry. PLEASE: Check, if you _really_ have the naked 205 (no MS-type nor 206) ! This driver doesn't work with any other types than the 205. AUTHOR: ======= Kai Petzke, wpp@marie.physik.tu-berlin.de MODIFICATIONS for the 1.1 and 1.2 kernels: ========================================== Martin Seine, martin@erde.gun.de Martin.Seine@FernUni-Hagen.de COPYRIGHT: ========== This file is copyrighted by the author. You may use and distribute it under the terms of the GNU Copyleft. NO GUARANTEE: ============= Lot's of people have been using this driver with different kernels, and noone sent me mail about fatal problems caused by the driver being installed. But that does not mean, that there aren't problems. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.