matroxfb.txt

ARM 嵌入式 系统 设计与实例开发 实验教材 二源码

[This file is cloned from VesaFB. Thanks go to Gerd Knorr]

What is matroxfb?
=================

This is a driver for a graphic framebuffer for Matrox devices on
Alpha, Intel and PPC boxes.

Advantages:

 * It provides a nice large console (128 cols + 48 lines with 1024x768)
   without using tiny, unreadable fonts.
 * You can run XF68_FBDev on top of /dev/fb0
 * Most important: boot logo :-)

Disadvantages:

 * graphic mode is slower than text mode... but you should not notice
   if you use same resolution as you used in textmode.


How to use it?
==============

Switching modes is done using the video=matrox:vesa:... boot parameter
or using `fbset' program.

If you want, for example, enable a resolution of 1280x1024x24bpp you should
pass to the kernel this command line: "video=matrox:vesa:0x1BB".
Note that the same line, if 'appended' as a lilo parameter in lilo.conf will
read "video=matrox:vesa:443" because lilo pass integer parameters as decimal
numbers to the kernel.

You should compile in both vgacon (to boot if you remove you Matrox from
box) and matroxfb (for graphics mode). You should not compile-in vesafb
unless you have primary display on non-Matrox VBE2.0 device (see 
Documentation/vesafb.txt for details).

Currently supported video modes are (through vesa:... interface, PowerMac
has [as addon] compatibility code):


[Graphic modes]

bpp | 640x400  640x480  768x576  800x600  960x720
----+--------------------------------------------
  4 |            0x12             0x102            
  8 |  0x100    0x101    0x180    0x103    0x188   
 15 |           0x110    0x181    0x113    0x189   
 16 |           0x111    0x182    0x114    0x18A   
 24 |           0x1B2    0x184    0x1B5    0x18C   
 32 |           0x112    0x183    0x115    0x18B   


[Graphic modes (continued)]

bpp | 1024x768 1152x864 1280x1024 1408x1056 1600x1200
----+------------------------------------------------
  4 |   0x104             0x106
  8 |   0x105    0x190    0x107     0x198     0x11C
 15 |   0x116    0x191    0x119     0x199     0x11D
 16 |   0x117    0x192    0x11A     0x19A     0x11E
 24 |   0x1B8    0x194    0x1BB     0x19C     0x1BF
 32 |   0x118    0x193    0x11B     0x19B


[Text modes]

text | 640x400  640x480  1056x344  1056x400  1056x480
-----+------------------------------------------------
 8x8 |  0x1C0    0x108     0x10A     0x10B     0x10C
8x16 | 2, 3, 7                       0x109

You can enter these number either hexadecimal (leading `0x') or decimal
(0x100 = 256). You can also use value + 512 to achieve compatibility
with your old number passed to vesafb.

Non-listed number can be achieved by more complicated command-line, for
example 1600x1200x32bpp can be specified by `video=matrox:vesa:0x11C,depth:32'.


X11
===

XF68_FBDev should work just fine, but it is non-accelerated. On non-intel
architectures there are some glitches for 24bpp videomodes. 8, 16 and 32bpp
works fine.

Running another (accelerated) X-Server like XF86_SVGA works too. But (at least)
XFree servers have big troubles in multihead configurations (even on first
head, not even talking about second).


SVGALib
=======

Driver contains SVGALib compatibility code. It is turned on by choosing textual
mode for console. You can do it at boot time by using videomode
2,3,7,0x108-0x10C or 0x1C0. At runtime, `fbset -depth 0' does this work.
Unfortunately, after SVGALib application exits, screen contents is corrupted.
Switching to another console and back fixes it. I hope that it is SVGALib's
problem and not mine, but I'm not sure.


Configuration
=============

You can pass kernel command line options to matroxfb with
`video=matrox:option1,option2:value2,option3' (multiple options should be 
separated by comma, values are separated from options by `:'). 
Accepted options:

mem:X    - size of memory (X can be in megabytes, kilobytes or bytes)
           You can only decrease value determined by driver because of
	   it always probe for memory. Default is to use whole detected
	   memory usable for on-screen display (i.e. max. 8 MB).
disabled - do not load driver; you can use also `off', but `disabled'
           is here too.
enabled  - load driver, if you have `video=matrox:disabled' in LILO
           configuration, you can override it by this (you cannot override
	   `off'). It is default.
noaccel  - do not use acceleration engine. It does not work on Alphas.
accel    - use acceleration engine. It is default.
nopan    - create initial consoles with vyres = yres, thus disabling virtual
           scrolling.
pan      - create initial consoles as tall as possible (vyres = memory/vxres).
           It is default.
nopciretry - disable PCI retries. It is needed for some broken chipsets,
           it is autodetected for intel's 82437. In this case device does
	   not comply to PCI 2.1 specs (it will not guarantee that every
	   transaction terminate with success or retry in 32 PCLK).
pciretry - enable PCI retries. It is default, except for intel's 82437.
novga    - disables VGA I/O ports. It is default if BIOS did not enable device.
           You should not use this option, some boards then do not restart
	   without power off.
vga      - preserve state of VGA I/O ports. It is default. Driver does not
           enable VGA I/O if BIOS did not it (it is not safe to enable it in
	   most cases).
nobios   - disables BIOS ROM. It is default if BIOS did not enable BIOS itself.
           You should not use this option, some boards then do not restart
	   without power off.
bios     - preserve state of BIOS ROM. It is default. Driver does not enable
           BIOS if BIOS was not enabled before.
noinit   - tells driver, that devices were already initialized. You should use
           it if you have G100 and/or if driver cannot detect memory, you see
	   strange pattern on screen and so on. Devices not enabled by BIOS
	   are still initialized. It is default.
init     - driver initializes every device it knows about.
memtype  - specifies memory type, implies 'init'. This is valid only for G200 
           and G400 and has following meaning:
             G200: 0 -> 2x128Kx32 chips, 2MB onboard, probably sgram
                   1 -> 2x128Kx32 chips, 4MB onboard, probably sgram
                   2 -> 2x256Kx32 chips, 4MB onboard, probably sgram
                   3 -> 2x256Kx32 chips, 8MB onboard, probably sgram
                   4 -> 2x512Kx16 chips, 8/16MB onboard, probably sdram only
                   5 -> same as above
                   6 -> 4x128Kx32 chips, 4MB onboard, probably sgram
                   7 -> 4x128Kx32 chips, 8MB onboard, probably sgram
             G400: 0 -> 2x512Kx16 SDRAM, 16/32MB
                        2x512Kx32 SGRAM, 16/32MB
                   1 -> 2x256Kx32 SGRAM, 8/16MB
                   2 -> 4x128Kx32 SGRAM, 8/16MB
                   3 -> 4x512Kx32 SDRAM, 32MB
                   4 -> 4x256Kx32 SGRAM, 16/32MB
                   5 -> 2x1Mx32 SDRAM, 32MB
                   6 -> reserved
                   7 -> reserved
           You should use sdram or sgram parameter in addition to memtype 
           parameter.
nomtrr   - disables write combining on frame buffer. This slows down driver but
           there is reported minor incompatibility between GUS DMA and XFree
	   under high loads if write combining is enabled (sound dropouts).
mtrr     - enables write combining on frame buffer. It speeds up video accesses
           much. It is default. You must have MTRR support enabled in kernel
	   and your CPU must have MTRR (f.e. Pentium II have them).
sgram    - tells to driver that you have Gxx0 with SGRAM memory. It has no
           effect without `init'.
sdram    - tells to driver that you have Gxx0 with SDRAM memory.
           It is a default.
inv24    - change timings parameters for 24bpp modes on Millenium and
           Millenium II. Specify this if you see strange color shadows around
	   characters.
noinv24  - use standard timings. It is the default.
inverse  - invert colors on screen (for LCD displays)
noinverse - show true colors on screen. It is default.
dev:X    - bind driver to device X. Driver numbers device from 0 up to N,
           where device 0 is first `known' device found, 1 second and so on.
	   lspci lists devices in this order.
	   Default is `every' known device for driver with multihead support
	   and first working device (usually dev:0) for driver without
	   multihead support.
nohwcursor - disables hardware cursor (use software cursor instead).
hwcursor - enables hardware cursor. It is default. If you are using
           non-accelerated mode (`noaccel' or `fbset -accel false'), software
	   cursor is used (except for text mode).
noblink  - disables cursor blinking. Cursor in text mode always blinks (hw
           limitation).
blink    - enables cursor blinking. It is default.
nofastfont - disables fastfont feature. It is default.
fastfont:X - enables fastfont feature. X specifies size of memory reserved for
             font data, it must be >= (fontwidth*fontheight*chars_in_font)/8.
	     It is faster on Gx00 series, but slower on older cards.
grayscale - enable grayscale summing. It works in PSEUDOCOLOR modes (text,
            4bpp, 8bpp). In DIRECTCOLOR modes it is limited to characters
	    displayed through putc/putcs. Direct accesses to framebuffer