annotate drivers/README @ 4559:5dc383bb1c82

added mga_top_reserved module parameter to skip a configurable amount of space at the top of video memory. this is needed to prevent corruption of the kernel's console font when using the "fastfont" option with matroxfb.
author rfelker
date Thu, 07 Feb 2002 02:07:29 +0000
parents 3b5f5d1c5041
children 6d257bd87fce
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
2 mga_vid - MGA G200/G400 YUV Overlay kernel module
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
3
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
4 Author:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
5 Aaron Holtzman <aholtzma@ess.engr.uvic.ca>, Oct 1999
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
6
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
7 Contributions by:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
8 Fredrik Vraalsen <vraalsen@cs.uiuc.edu>
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
9 Alan Cox <alan@lxorguk.ukuu.org.uk>
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
10
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
11 WARNING ----- WARNING
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
12
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
13 This code messes with your video card and your xserver. It will probably
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
14 lock up your box, format your hard drive, and cause your brand new g400
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
15 MAX to spout 6 inch flames. You have been warned.
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
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
19 What does this code do?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
20
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
21 mga_vid is a kernel module that utilitizes the Matrox g200/g400 video
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
22 scaler/overlay unit to perform YUV->RGB colorspace conversion and
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
23 arbitrary video scaling.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
24
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
25 mga_vid is also a monster hack.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
26
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
27 How does mga_vid work?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
28
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
29 This kernel module sets up the BES (backend scaler) with approriate values
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
30 based on parameters supplied via ioctl. It also maps a chunk of video
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
31 memory into userspace via mmap. This memory is stolen from X (which may
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
32 decide to write to it later). The application can then write image data
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
33 directly to the frame buffer (if it knows the right padding, etc).
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
34
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
35
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
36 How do I know if mga_vid works on my system?
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
37
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
38 There are test applications called mga_vid_test_g400 and mga_vid_test_g200.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
39 Use the appropriate one for your card. This test code should draw some
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
40 nice 256x256 images for you if all is working well.