intelfb.txt 3.66 KB
Newer Older
1
Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver
Sylvain Meyer's avatar
Sylvain Meyer committed
2 3 4
================================================================

A. Introduction
5
	This is a framebuffer driver for various Intel 8xx/9xx compatible
Sylvain Meyer's avatar
Sylvain Meyer committed
6 7 8
graphics devices.  These would include:

	Intel 830M
9
	Intel 845G
Sylvain Meyer's avatar
Sylvain Meyer committed
10 11 12 13
	Intel 852GM
	Intel 855GM
	Intel 865G
	Intel 915G
14 15 16
	Intel 915GM
	Intel 945G
	Intel 945GM
17
	Intel 945GME
18 19
	Intel 965G
	Intel 965GM
Sylvain Meyer's avatar
Sylvain Meyer committed
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86

B.  List of available options

   a. "video=intelfb"
	enables the intelfb driver

	Recommendation: required

   b. "mode=<xres>x<yres>[-<bpp>][@<refresh>]"
	select mode

	Recommendation: user preference
	(default = 1024x768-32@70)

   c. "vram=<value>"
	select amount of system RAM in MB to allocate for the video memory
	if not enough RAM was already allocated by the BIOS.

	Recommendation: 1 - 4 MB.
	(default = 4 MB)

   d. "voffset=<value>"
        select at what offset in MB of the logical memory to allocate the
	framebuffer memory.  The intent is to avoid the memory blocks
	used by standard graphics applications (XFree86). Depending on your
        usage, adjust the value up or down, (0 for maximum usage, 63/127 MB
        for the least amount).  Note, an arbitrary setting may conflict
        with XFree86.

	Recommendation: do not set
	(default = 48 MB)

   e. "accel"
	enable text acceleration.  This can be enabled/reenabled anytime
	by using 'fbset -accel true/false'.

	Recommendation: enable
	(default = set)

   f. "hwcursor"
	enable cursor acceleration.

	Recommendation: enable
	(default = set)

   g. "mtrr"
	enable MTRR.  This allows data transfers to the framebuffer memory
	to occur in bursts which can significantly increase performance.
	Not very helpful with the intel chips because of 'shared memory'.

	Recommendation: set
	(default = set)

   h. "fixed"
	disable mode switching.

	Recommendation: do not set
	(default = not set)

   The binary parameters can be unset with a "no" prefix, example "noaccel".
   The default parameter (not named) is the mode.

C. Kernel booting

Separate each option/option-pair by commas (,) and the option from its value
with an equals sign (=) as in the following:

87
video=intelfb:option1,option2=value2
Sylvain Meyer's avatar
Sylvain Meyer committed
88 89 90 91 92 93

Sample Usage
------------

In /etc/lilo.conf, add the line:

94
append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8"
Sylvain Meyer's avatar
Sylvain Meyer committed
95 96 97 98 99

This will initialize the framebuffer to 800x600 at 32bpp and 75Hz. The
framebuffer will use 8 MB of System RAM. hw acceleration of text and cursor
will be enabled.

100 101 102 103 104 105 106 107
Remarks
-------

If setting this parameter doesn't work (you stay in a 80x25 text-mode),
you might need to set the "vga=<mode>" parameter too - see vesafb.txt
in this directory.


Sylvain Meyer's avatar
Sylvain Meyer committed
108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
D.  Module options

	The module parameters are essentially similar to the kernel
parameters. The main difference is that you need to include a Boolean value
(1 for TRUE, and 0 for FALSE) for those options which don't need a value.

Example, to enable MTRR, include "mtrr=1".

Sample Usage
------------

Using the same setup as described above, load the module like this:

	modprobe intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1

123
Or just add the following to a configuration file in /etc/modprobe.d/
Sylvain Meyer's avatar
Sylvain Meyer committed
124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149

	options intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1

and just do a

	modprobe intelfb


E.  Acknowledgment:

	1.  Geert Uytterhoeven - his excellent howto and the virtual
                                 framebuffer driver code made this possible.

	2.  Jeff Hartmann for his agpgart code.

	3.  David Dawes for his original kernel 2.4 code.

	4.  The X developers.  Insights were provided just by reading the
	    XFree86 source code.

	5.  Antonino A. Daplas for his inspiring i810fb driver.

	6.  Andrew Morton for his kernel patches maintenance.

###########################
Sylvain