Commit | Line | Data |
---|---|---|
d463d34e | 1 | Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver |
4ff45f51 SM |
2 | ================================================================ |
3 | ||
4 | A. Introduction | |
d463d34e | 5 | This is a framebuffer driver for various Intel 8xx/9xx compatible |
4ff45f51 SM |
6 | graphics devices. These would include: |
7 | ||
8 | Intel 830M | |
d463d34e | 9 | Intel 845G |
4ff45f51 SM |
10 | Intel 852GM |
11 | Intel 855GM | |
12 | Intel 865G | |
13 | Intel 915G | |
d463d34e CM |
14 | Intel 915GM |
15 | Intel 945G | |
16 | Intel 945GM | |
0e170c72 MB |
17 | Intel 965G |
18 | Intel 965GM | |
4ff45f51 SM |
19 | |
20 | B. List of available options | |
21 | ||
22 | a. "video=intelfb" | |
23 | enables the intelfb driver | |
24 | ||
25 | Recommendation: required | |
26 | ||
27 | b. "mode=<xres>x<yres>[-<bpp>][@<refresh>]" | |
28 | select mode | |
29 | ||
30 | Recommendation: user preference | |
31 | (default = 1024x768-32@70) | |
32 | ||
33 | c. "vram=<value>" | |
34 | select amount of system RAM in MB to allocate for the video memory | |
35 | if not enough RAM was already allocated by the BIOS. | |
36 | ||
37 | Recommendation: 1 - 4 MB. | |
38 | (default = 4 MB) | |
39 | ||
40 | d. "voffset=<value>" | |
41 | select at what offset in MB of the logical memory to allocate the | |
42 | framebuffer memory. The intent is to avoid the memory blocks | |
43 | used by standard graphics applications (XFree86). Depending on your | |
44 | usage, adjust the value up or down, (0 for maximum usage, 63/127 MB | |
45 | for the least amount). Note, an arbitrary setting may conflict | |
46 | with XFree86. | |
47 | ||
48 | Recommendation: do not set | |
49 | (default = 48 MB) | |
50 | ||
51 | e. "accel" | |
52 | enable text acceleration. This can be enabled/reenabled anytime | |
53 | by using 'fbset -accel true/false'. | |
54 | ||
55 | Recommendation: enable | |
56 | (default = set) | |
57 | ||
58 | f. "hwcursor" | |
59 | enable cursor acceleration. | |
60 | ||
61 | Recommendation: enable | |
62 | (default = set) | |
63 | ||
64 | g. "mtrr" | |
65 | enable MTRR. This allows data transfers to the framebuffer memory | |
66 | to occur in bursts which can significantly increase performance. | |
67 | Not very helpful with the intel chips because of 'shared memory'. | |
68 | ||
69 | Recommendation: set | |
70 | (default = set) | |
71 | ||
72 | h. "fixed" | |
73 | disable mode switching. | |
74 | ||
75 | Recommendation: do not set | |
76 | (default = not set) | |
77 | ||
78 | The binary parameters can be unset with a "no" prefix, example "noaccel". | |
79 | The default parameter (not named) is the mode. | |
80 | ||
81 | C. Kernel booting | |
82 | ||
83 | Separate each option/option-pair by commas (,) and the option from its value | |
84 | with an equals sign (=) as in the following: | |
85 | ||
d463d34e | 86 | video=intelfb:option1,option2=value2 |
4ff45f51 SM |
87 | |
88 | Sample Usage | |
89 | ------------ | |
90 | ||
91 | In /etc/lilo.conf, add the line: | |
92 | ||
6bf1d73d | 93 | append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8" |
4ff45f51 SM |
94 | |
95 | This will initialize the framebuffer to 800x600 at 32bpp and 75Hz. The | |
96 | framebuffer will use 8 MB of System RAM. hw acceleration of text and cursor | |
97 | will be enabled. | |
98 | ||
6bf1d73d PM |
99 | Remarks |
100 | ------- | |
101 | ||
102 | If setting this parameter doesn't work (you stay in a 80x25 text-mode), | |
103 | you might need to set the "vga=<mode>" parameter too - see vesafb.txt | |
104 | in this directory. | |
105 | ||
106 | ||
4ff45f51 SM |
107 | D. Module options |
108 | ||
109 | The module parameters are essentially similar to the kernel | |
110 | parameters. The main difference is that you need to include a Boolean value | |
111 | (1 for TRUE, and 0 for FALSE) for those options which don't need a value. | |
112 | ||
113 | Example, to enable MTRR, include "mtrr=1". | |
114 | ||
115 | Sample Usage | |
116 | ------------ | |
117 | ||
118 | Using the same setup as described above, load the module like this: | |
119 | ||
120 | modprobe intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1 | |
121 | ||
122 | Or just add the following to /etc/modprobe.conf | |
123 | ||
124 | options intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1 | |
125 | ||
126 | and just do a | |
127 | ||
128 | modprobe intelfb | |
129 | ||
130 | ||
131 | E. Acknowledgment: | |
132 | ||
133 | 1. Geert Uytterhoeven - his excellent howto and the virtual | |
134 | framebuffer driver code made this possible. | |
135 | ||
136 | 2. Jeff Hartmann for his agpgart code. | |
137 | ||
138 | 3. David Dawes for his original kernel 2.4 code. | |
139 | ||
140 | 4. The X developers. Insights were provided just by reading the | |
141 | XFree86 source code. | |
142 | ||
143 | 5. Antonino A. Daplas for his inspiring i810fb driver. | |
144 | ||
145 | 6. Andrew Morton for his kernel patches maintenance. | |
146 | ||
147 | ########################### | |
148 | Sylvain |