This package contains 3 drivers :
- mgacore : a basic driver for Matrox cards (G-series)
- mgayuv  : a sample V4L overlay driver using 'mgacore' features
- mgadvd  : a driver for the DVD addon card (Zoran chipset) using
	    'mgacore' as well 

This package also comes with a sample application : vobcat, a command
line tool to send a VOB file to the driver.

How to install the software

(from mgadvd home directory) :

1. Copy the microcode files from the Windows driver :
(assuming your Windows partition is mounted on /mnt/dosc)
$ cp /mnt/dosc/Program\ Files/Matrox\ DVD/*.adp
$ cp /mnt/dosc/Program\ Files/Matrox\ DVD/*.dvp
$ cp /mnt/dosc/Program\ Files/Matrox\ DVD/*.prg

2. Build the kernel drivers
$ make
If you see error messages like "No rule to make target `340eac3.adp',
then you've probably omitted step 1...

3. Load the modules inside the kernel (still as root) :
# ./i 		# this shell script takes
		# care of loading all the
		# necessary modules
# tail -f /var/log/messages
Jun 24 14:32:39 localhost kernel: Matrox core interface v0.1 (c) David Barth
Jun 24 14:32:39 localhost kernel: mgacore: Found MGA G200 AGP
Jun 24 14:32:39 localhost kernel: mgacore: 8 MB detected
Jun 24 14:32:39 localhost kernel: Matrox G200/G400 YUV
Jun 24 14:32:40 localhost kernel: Matrox DVD interface v0.4 (c) David Barth
Jun 24 14:32:40 localhost kernel: mgacore: alloc 263168 (0x40400)
Jun 24 14:32:40 localhost kernel: mgadvd: Reset
Jun 24 14:32:40 localhost kernel: mgadvd: Reset
Jun 24 14:32:40 localhost kernel: mgadvd: Found ZR367x0 rev. 0x11, good !
Jun 24 14:32:40 localhost kernel: mgacore: alloc 829696 (0xca900)

If the driver fails to detect you card, it will say something like
mgadvd: PLL's NOT locked ---> xxxxx
mgadvd: mgadvd: no chipset found (codec response: xxxxxx)

You can revert to you normal user account from now on, or watch
/var/log/messages from this shell, and go on with another shell
window.

5. At this moment, all the kernel modules are built. You also
   have a sample application : vobcat. It displays a VOB file
   directly on screen. You need to have a BLACK area to see
   the video (like an xterm with a modified background color)

$ vobcat
usage: ./vobcat <vob_file|-> [video sid] [audio sid] [subpic sid] [lba offset]
$ vobcat \
/mnt/cdrom/video_ts/my_favourite_unencrypted_vob_file \
0 0 0 200
