annotate drivers/README @ 22671:99db91e74443

Remove remnants of Linux 2.6 support, the mga_vid.c part was made to disappear in Limbo with 'cvs admin -o' ages ago.
author diego
date Sat, 17 Mar 2007 13:53:15 +0000
parents 57cf28cd0285
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
22658
6d257bd87fce Merge README.linux.2.6 into general README.
diego
parents: 1
diff changeset
1 The code in this directory is the old mga_vid driver for Linux kernels
6d257bd87fce Merge README.linux.2.6 into general README.
diego
parents: 1
diff changeset
2 prior to 2.6. It does _not_ compile for version 2.6.x.
6d257bd87fce Merge README.linux.2.6 into general README.
diego
parents: 1
diff changeset
3
6d257bd87fce Merge README.linux.2.6 into general README.
diego
parents: 1
diff changeset
4 For Linux kernel 2.6.x please get the newest version of the 2.6 port from
6d257bd87fce Merge README.linux.2.6 into general README.
diego
parents: 1
diff changeset
5 http://attila.kinali.ch/mga/
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
6
22660
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
7
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
8 mga_vid - MGA G200/G400 YUV Overlay kernel module
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
9
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
10 Author:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
11 Aaron Holtzman <aholtzma@ess.engr.uvic.ca>, Oct 1999
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
12
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
13 Contributions by:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
14 Fredrik Vraalsen <vraalsen@cs.uiuc.edu>
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
15 Alan Cox <alan@lxorguk.ukuu.org.uk>
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
16
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
17 WARNING ----- WARNING
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
18
22660
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
19 This code messes with your video card and your X server. It will probably
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
20 lock up your box, format your hard drive, and cause your brand new G400
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
21 MAX to spout 6 inch flames. You have been warned.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
22
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
23 WARNING ----- WARNING
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
24
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
25 What does this code do?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
26
22660
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
27 mga_vid is a kernel module that utilitizes the Matrox G200/G400/G550
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
28 video scaler/overlay unit to perform YUV->RGB colorspace conversion
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
29 and arbitrary video scaling.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
30
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
31 mga_vid is also a monster hack.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
32
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
33 How does mga_vid work?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
34
22660
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
35 This kernel module sets up the BES (backend scaler) with appropriate
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
36 values based on parameters supplied via ioctl. It also maps a chunk of
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
37 video memory into userspace via mmap. This memory is stolen from X
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
38 (which may decide to write to it later). The application can then write
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
39 image data directly to the framebuffer (if it knows the right padding,
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
40 etc).
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
41
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
42
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
43 How do I know if mga_vid works on my system?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
44
22660
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
45 There is a test application called mga_vid_test. This test code should
57cf28cd0285 wording/spelling/cosmetics
diego
parents: 22658
diff changeset
46 draw some nice 256x256 images for you if all is working well.