Readme for DXR2 driver v0.9b

This is still a DEVELOPMENT driver, because parts of it are still not properly
tested, and a few parts are missing (see "Todo"). The player program could do
with some more user friendliness :)

The driver is being actively developed by adq@tardis.ed.ac.uk, and 
lucien@martincurrie.com

****************************************************************************
Also, VGA overlay is not yet supported.... output is to a TV connected to the
video output of the card.
****************************************************************************

The current IOCTL interface is TEMPORARY and WILL change... probably to be 
compatable with the prototype DVD interface on linuxtv.org's web pages.

The current major device number (120) is TEMPORARY, and only for development 
purposes. It WILL change when the driver is finished.

It has been tested with kernels 2.2.5, 2.2.9, 2.2.12


To use:

1) compile each of the following modules 

	anp82, bt865, dxr2, pcm1723, tc6807af, vxp524, zivaDS

   Note: If you're using SMP, you'll need to uncomment -D__SMP__ in the 
   makefiles, or you'll get a compiler warning.

2) insert the modules into your kernel:
	
	insmod anp82
	insmod bt865
	insmod pcm1723
	insmod tc6807af
	insmod vxp524
	insmod zivaDS
	insmod dxr2

	(it doesn't matter which order the first 6 are in, but the dxr2 module
	 MUST be loaded last)

3) Make the device file "mknod /dev/dxr2 c 120 0"

4) Extract the DVD microcode from Creative's windows driver. You can get this
   by installing the windows version (say into 
   "c:\Program Files\Creative\DXR2"), and copying the file "dvd1.ux" from the
   install directory. Currently, put this file in the driver's "test" 
   directory.

5) Get a sample .VOB file (it is set up to play the sample 
   "CREATIVE.VOB" from the driver CD), and put it in the driver's "test" 
   directory.

6) Compile and run the test program in the test directory. 
   "cd test; ./test CREATIVE.VOB"

   The test program is currently set up to output PAL. look for 
   DXR2_IOC_SET_OUTPUT_TV_FORMAT, in test.c, and change the argument to 
   DXR2_TVFORMAT_NTSC (as indicated in comment) if you want to
   change the TV output to NTSC.

Note: To switch between MPEG1 (VCD) / or MPEG2 (DVD) mode, you'll have to edit
      and recompile test.c. There are lots of comments in there. (look for 
      "CHANGEME" for things which are interesting to change)

If all goes well, you should see the test video on the TV screen..