Blame view

Documentation/fb/intelfb.txt 3.66 KB
d463d34e7   Christian Merkle   intelfb: update d...
1
  Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
2
3
4
  ================================================================
  
  A. Introduction
d463d34e7   Christian Merkle   intelfb: update d...
5
  	This is a framebuffer driver for various Intel 8xx/9xx compatible
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
6
7
8
  graphics devices.  These would include:
  
  	Intel 830M
d463d34e7   Christian Merkle   intelfb: update d...
9
  	Intel 845G
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
10
11
12
13
  	Intel 852GM
  	Intel 855GM
  	Intel 865G
  	Intel 915G
d463d34e7   Christian Merkle   intelfb: update d...
14
15
16
  	Intel 915GM
  	Intel 945G
  	Intel 945GM
3f7a26b4b   Phil Endecott   intelfb: support ...
17
  	Intel 945GME
0e170c72c   Maik Broemme   fbdev: intelfb: a...
18
19
  	Intel 965G
  	Intel 965GM
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
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
  
  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:
d463d34e7   Christian Merkle   intelfb: update d...
86
  video=intelfb:option1,option2=value2
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
87
88
89
90
91
  
  Sample Usage
  ------------
  
  In /etc/lilo.conf, add the line:
6bf1d73d7   Ph. Marek   [PATCH] intelfb: ...
92
  append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8"
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
93
94
95
96
  
  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.
6bf1d73d7   Ph. Marek   [PATCH] intelfb: ...
97
98
99
100
101
102
  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.
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
103
104
105
106
107
108
109
110
111
112
113
114
115
116
  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
970e24864   Lucas De Marchi   Documentation: re...
117
  Or just add the following to a configuration file in /etc/modprobe.d/
4ff45f515   Sylvain Meyer   [PATCH] intelfb d...
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
  
  	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