Toshiba 3101 CD-ROM audio support device driver

Version 0.12 - 94/06/06
Copyright (C) 1994  Ramon de Klein

This driver is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This driver 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.

You should have received a copy of the GNU General Public License
along with this driver; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Installation:
-------------
The following instructions should be followed to correctly apply the
patch to the kernel. It is relative to the v1.0.9 kernel, but it works
with some other kernels as well (maybe after a slight modification).

 - Type 'make mrproper' in the /usr/src/linux directory.
 - Type 'patch -p0 < tosh3101.patch' in the /usr/src directory.
 - Type 'make config' in the /usr/src/linux directory and answer YES
   to the question about the Toshiba 3101 support. After that, type
   'make dep' to create the new dependencies.
 - Type 'make zlilo' or something like that to create and install the
   new kernel. Make sure you keep having a working kernel available to
   avoid frustration, when the new kernel doesn't work.

Applying the patch to other kernels:
------------------------------------
This patch was created against the v1.0.9 kernel and therefore may not
work directly with your kernel. Check for any rejected file while
applying the patch and if there is one, apply the patch by hand. For the
v1.1.16 kernel you'll need to patch 'config.in' by hand, because it's
rejected. You can just add the following line after the
'Matsushita/Panasonic CDROM driver support' to make it work:

	bool 'Toshiba 3101 CDROM audio driver support' CONFIG_TOSH3101 y

If 'make config' asks about the Toshiba drive, then everything is OK. If not
check what you did wrong.

Known bugs:
-----------
This is preliminary alpha-code, so it may have some bugs. Please,
mail any unlisted bugs to the author. If the listed bugs don't occur
with your setup please mail a message to me.

- Workman gets confused after playing the last frame of a CD. It
  refuses to perform most commands. I don't really know what the
  problem is, but I'll first want to investigate what other CD
  players do. I suspect it has something to do with remapping
  the Toshiba audio status to the SCSI-2 format. Playing a CD with
  Workbone will reset the audio status and then Workman plays well
  again.
- The CDROMPLAYTRKIND command completely ignores the index
  field, because I don't know how to find an index fast. I really
  have no idea how to fix this. Anyone?!?

Warning:
--------
This driver sends commands direct to the SCSI controller, so if
there is something wrong it could end up at corrupting data on
your harddisk (assuming you have a SCSI harddisk). I don't think
this would ever occur, but I can't be sure.

Thanks to:
----------
Ti Kan (ti@amb.org) for supplying information about some of the
Toshiba specifics commands, which are also used in his 'xmcd'
program.

How to reach the author:
------------------------
If you have any questions, bugreports, fixes, hints, etc. you can
reach me at one of the following addresses:

        Fidonet: Ramon.de.Klein@p21.f7.n283.z2.fidonet.org
        Internet: ramon.via@sni.de

History:
--------
 v0.12    94/06/06    The CDROMPLAYTRKIND command will play the
		      last specified track too. The index is
		      still ignored. Some comments were added too.
 v0.11    94/06/03    Fixed a bug, because CDROMSUBCHNL didn't set
                      the 'cdsc_audiostatus' field correct. This
                      caused most of the Workman/Workbone bugs.
 v0.10    94/06/02    Initial release.
