1 ================================
2 Intel 810/815 Framebuffer driver
3 ================================
4
5 Tony Daplas <adaplas@pol.net>
6
7 http://i810fb.sourceforge.net
8
9 March 17, 2002
10
11 First Released: July 2001
12 Last Update: September 12, 2005
13
14 A. Introduction
15 ===============
16
17 This is a framebuffer driver for vario
18 graphics devices. These include:
19
20 - Intel 810
21 - Intel 810E
22 - Intel 810-DC100
23 - Intel 815 Internal graphics only, 10
24 - Intel 815 Internal graphics only
25 - Intel 815 Internal graphics and AGP
26
27 B. Features
28 ============
29
30 - Choice of using Discrete Video Timin
31 Formula, or a framebuffer specific d
32
33 - Supports a variable range of horizon
34 vertical refresh rates if the VESA G
35 enabled.
36
37 - Supports color depths of 8, 16, 24 a
38
39 - Supports pseudocolor, directcolor, o
40
41 - Full and optimized hardware accelera
42
43 - Robust video state save and restore
44
45 - MTRR support
46
47 - Utilizes user-entered monitor specif
48 calculate required video mode parame
49
50 - Can concurrently run with xfree86 ru
51
52 - Hardware Cursor Support
53
54 - Supports EDID probing either by DDC/
55
56 C. List of available options
57 =============================
58
59 a. "video=i810fb"
60 enables the i810 driver
61
62 Recommendation: required
63
64 b. "xres:<value>"
65 select horizontal resolution in pixels
66 ignored if 'mode_option' is specified.
67
68 Recommendation: user preference
69 (default = 640)
70
71 c. "yres:<value>"
72 select vertical resolution in scanline
73 is enabled, this will be ignored and c
74 parameter will be ignored if 'mode_opt
75 below)
76
77 Recommendation: user preference
78 (default = 480)
79
80 d. "vyres:<value>"
81 select virtual vertical resolution in
82 is specified, this will be computed ag
83
84 Recommendation: do not set
85 (default = 480)
86
87 e. "vram:<value>"
88 select amount of system RAM in MB to a
89
90 Recommendation: 1 - 4 MB.
91 (default = 4)
92
93 f. "bpp:<value>"
94 select desired pixel depth
95
96 Recommendation: 8
97 (default = 8)
98
99 g. "hsync1/hsync2:<value>"
100 select the minimum and maximum Horizon
101 monitor in kHz. If using a fixed freq
102 be equal to hsync2. If EDID probing is
103 ignored and values will be taken from
104
105 Recommendation: check monitor manual f
106 (default = 29/30)
107
108 h. "vsync1/vsync2:<value>"
109 select the minimum and maximum Vertica
110 in Hz. You can also use this option to
111 rate. If EDID probing is successful, t
112 will be taken from the EDID block.
113
114 Recommendation: check monitor manual f
115 (default = 60/60)
116
117 IMPORTANT: If you need to clamp your
118 leeway for computational errors (over/
119 using vsync1/vsync2 = 60/60, make sure
120 a 1 unit difference, and vice versa.
121
122 i. "voffset:<value>"
123 select at what offset in MB of the log
124 framebuffer memory. The intent is to
125 used by standard graphics applications
126 offset (16 MB for a 64 MB aperture, 8
127 avoid XFree86's usage and allows up to
128 memory. Depending on your usage, adju
129 (0 for maximum usage, 31/63 MB for the
130 arbitrary setting may conflict with XF
131
132 Recommendation: do not set
133 (default = 8 or 16 MB)
134
135 j. "accel"
136 enable text acceleration. This can be
137 by using 'fbset -accel true/false'.
138
139 Recommendation: enable
140 (default = not set)
141
142 k. "mtrr"
143 enable MTRR. This allows data transfe
144 to occur in bursts which can significa
145 Not very helpful with the i810/i815 be
146
147 Recommendation: do not set
148 (default = not set)
149
150 l. "extvga"
151 if specified, secondary/external VGA o
152 Useful if the BIOS turns off the VGA p
153 The external VGA monitor can then be a
154
155 Recommendation: do not set
156 (default = not set)
157
158 m. "sync"
159 Forces the hardware engine to do a "sy
160 to finish before starting another inst
161 more stable setup, but will be slower.
162
163 Recommendation: do not set
164 (default = not set)
165
166 n. "dcolor"
167 Use directcolor visual instead of true
168 than 8 bpp. Useful for color tuning,
169
170 Recommendation: do not set
171 (default = not set)
172
173 o. <xres>x<yres>[-<bpp>][@<refresh>]
174 The driver will now accept specificati
175 is specified, the options 'xres' and '
176 Documentation/fb/modedb.rst for usage.
177
178 D. Kernel booting
179 =================
180
181 Separate each option/option-pair by commas (,)
182 with a colon (:) as in the following::
183
184 video=i810fb:option1,option2:value2
185
186 Sample Usage
187 ------------
188
189 In /etc/lilo.conf, add the line::
190
191 append="video=i810fb:vram:2,xres:1024,yres:7
192 vsync1:50,vsync2:85,accel,mtrr"
193
194 This will initialize the framebuffer to 1024x7
195 will use 2 MB of System RAM. MTRR support will
196 will be computed based on the hsync1/hsync2 an
197
198 IMPORTANT:
199 You must include hsync1, hsync2, vsync1 and
200 better than 640x480 at 60Hz. HOWEVER, if you
201 supports I2C and has an EDID block, you can
202 vsync1 and vsync2 parameters. These paramet
203 block.
204
205 E. Module options
206 ==================
207
208 The module parameters are essentially similar
209 parameters. The main difference is that you ne
210 (1 for TRUE, and 0 for FALSE) for those option
211
212 Example, to enable MTRR, include "mtrr=1".
213
214 Sample Usage
215 ------------
216
217 Using the same setup as described above, load
218
219 modprobe i810fb vram=2 xres=1024 bpp=8
220 vsync2=85 accel=1 mtrr=1
221
222 Or just add the following to a configuration f
223
224 options i810fb vram=2 xres=1024 bpp=16
225 vsync2=85 accel=1 mtrr=1
226
227 and just do a::
228
229 modprobe i810fb
230
231
232 F. Setup
233 =========
234
235 a. Do your usual method of configuring
236
237 make menuconfig/xconfig/config
238
239 b. Under "Code maturity level options"
240 and/or incomplete code/drivers".
241
242 c. Enable agpgart support for the Inte
243 This is required. The option is un
244
245 d. Under "Graphics Support", select "I
246 or as a module. Choose "use VESA G
247 you need to maximize the capability
248 safe side, you can leave this unsel
249
250 e. If you want support for DDC/I2C pro
251 set 'Enable DDC Support' to 'y'. To
252 'use VESA Generalized Timing Formul
253
254 f. If you want a framebuffer console,
255 Drivers".
256
257 g. Compile your kernel.
258
259 h. Load the driver as described in sec
260
261 i. Try the DirectFB (http://www.direc
262 patch to see the chipset in action
263
264 G. Acknowledgment:
265 ===================
266
267 1. Geert Uytterhoeven - his excellent
268 framebuffer driver code made this
269
270 2. Jeff Hartmann for his agpgart code
271
272 3. The X developers. Insights were p
273 XFree86 source code.
274
275 4. Intel(c). For this value-oriented
276 providing documentation.
277
278 5. Matt Sottek. His inputs and ideas
279 optimizations possible.
280
281 H. Home Page:
282 ==============
283
284 A more complete, and probably updated
285 http://i810fb.sourceforge.net.
286
287 Tony
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.