[PATCH] Documentation fixes in intel810.txt

Signed-off-by: Reiner Herrmann <reiner@reiner-h.de>
Acked-by: Randy Dunlap <rdunlap@xenotime.net>
Cc: "Antonino A. Daplas" <adaplas@pol.net>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
This commit is contained in:
Reiner Herrmann 2006-10-03 01:15:08 -07:00 committed by Linus Torvalds
parent b98fc9a34b
commit 9b262144a1

View file

@ -9,8 +9,9 @@ Intel 810/815 Framebuffer driver
================================================================ ================================================================
A. Introduction A. Introduction
This is a framebuffer driver for various Intel 810/815 compatible This is a framebuffer driver for various Intel 810/815 compatible
graphics devices. These would include: graphics devices. These include:
Intel 810 Intel 810
Intel 810E Intel 810E
@ -21,22 +22,22 @@ graphics devices. These would include:
B. Features B. Features
- Choice of using Discrete Video Timings, VESA Generalized Timing - Choice of using Discrete Video Timings, VESA Generalized Timing
Formula, or a framebuffer specific database to set the video mode Formula, or a framebuffer specific database to set the video mode
- Supports a variable range of horizontal and vertical resolution, and - Supports a variable range of horizontal and vertical resolution and
vertical refresh rates if the VESA Generalized Timing Formula is vertical refresh rates if the VESA Generalized Timing Formula is
enabled. enabled.
- Supports color depths of 8, 16, 24 and 32 bits per pixel - Supports color depths of 8, 16, 24 and 32 bits per pixel
- Supports pseudocolor, directcolor, or truecolor visuals - Supports pseudocolor, directcolor, or truecolor visuals
- Full and optimized hardware acceleration at 8, 16 and 24 bpp - Full and optimized hardware acceleration at 8, 16 and 24 bpp
- Robust video state save and restore - Robust video state save and restore
- MTRR support - MTRR support
- Utilizes user-entered monitor specifications to automatically - Utilizes user-entered monitor specifications to automatically
calculate required video mode parameters. calculate required video mode parameters.
@ -91,12 +92,12 @@ C. List of available options
g. "hsync1/hsync2:<value>" g. "hsync1/hsync2:<value>"
select the minimum and maximum Horizontal Sync Frequency of the select the minimum and maximum Horizontal Sync Frequency of the
monitor in KHz. If a using a fixed frequency monitor, hsync1 must monitor in kHz. If using a fixed frequency monitor, hsync1 must
be equal to hsync2. If EDID probing is successful, these will be be equal to hsync2. If EDID probing is successful, these will be
ignored and values will be taken from the EDID block. ignored and values will be taken from the EDID block.
Recommendation: check monitor manual for correct values Recommendation: check monitor manual for correct values
default (29/30) (default = 29/30)
h. "vsync1/vsync2:<value>" h. "vsync1/vsync2:<value>"
select the minimum and maximum Vertical Sync Frequency of the monitor select the minimum and maximum Vertical Sync Frequency of the monitor
@ -113,12 +114,12 @@ C. List of available options
a 1 unit difference, and vice versa. a 1 unit difference, and vice versa.
i. "voffset:<value>" i. "voffset:<value>"
select at what offset in MB of the logical memory to allocate the select at what offset in MB of the logical memory to allocate the
framebuffer memory. The intent is to avoid the memory blocks framebuffer memory. The intent is to avoid the memory blocks
used by standard graphics applications (XFree86). The default used by standard graphics applications (XFree86). The default
offset (16 MB for a 64MB aperture, 8 MB for a 32MB aperture) will offset (16 MB for a 64 MB aperture, 8 MB for a 32 MB aperture) will
avoid XFree86's usage and allows up to 7MB/15MB of framebuffer avoid XFree86's usage and allows up to 7 MB/15 MB of framebuffer
memory. Depending on your usage, adjust the value up or down, memory. Depending on your usage, adjust the value up or down
(0 for maximum usage, 31/63 MB for the least amount). Note, an (0 for maximum usage, 31/63 MB for the least amount). Note, an
arbitrary setting may conflict with XFree86. arbitrary setting may conflict with XFree86.
@ -162,6 +163,7 @@ C. List of available options
Recommendation: do not set Recommendation: do not set
(default = not set) (default = not set)
o. <xres>x<yres>[-<bpp>][@<refresh>] o. <xres>x<yres>[-<bpp>][@<refresh>]
The driver will now accept specification of boot mode option. If this The driver will now accept specification of boot mode option. If this
is specified, the options 'xres' and 'yres' will be ignored. See is specified, the options 'xres' and 'yres' will be ignored. See
@ -195,7 +197,7 @@ block.
E. Module options E. Module options
The module parameters are essentially similar to the kernel The module parameters are essentially similar to the kernel
parameters. The main difference is that you need to include a Boolean value 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. (1 for TRUE, and 0 for FALSE) for those options which don't need a value.
@ -225,11 +227,11 @@ F. Setup
make menuconfig/xconfig/config make menuconfig/xconfig/config
b. Under "Code Maturity Options", enable "Prompt for experimental/ b. Under "Code maturity level options" enable "Prompt for development
incomplete code/drivers". and/or incomplete code/drivers".
c. Enable agpgart support for the Intel 810/815 on-board graphics. c. Enable agpgart support for the Intel 810/815 on-board graphics.
This is required. The option is under "Character Devices" This is required. The option is under "Character Devices".
d. Under "Graphics Support", select "Intel 810/815" either statically d. Under "Graphics Support", select "Intel 810/815" either statically
or as a module. Choose "use VESA Generalized Timing Formula" if or as a module. Choose "use VESA Generalized Timing Formula" if
@ -241,11 +243,11 @@ F. Setup
'use VESA Generalized Timing Formula' to 'y'. 'use VESA Generalized Timing Formula' to 'y'.
f. If you want a framebuffer console, enable it under "Console f. If you want a framebuffer console, enable it under "Console
Drivers" Drivers".
g. Compile your kernel. g. Compile your kernel.
h. Load the driver as described in section D and E. h. Load the driver as described in sections D and E.
i. Try the DirectFB (http://www.directfb.org) + the i810 gfxdriver i. Try the DirectFB (http://www.directfb.org) + the i810 gfxdriver
patch to see the chipset in action (or inaction :-). patch to see the chipset in action (or inaction :-).
@ -253,7 +255,7 @@ F. Setup
G. Acknowledgment: G. Acknowledgment:
1. Geert Uytterhoeven - his excellent howto and the virtual 1. Geert Uytterhoeven - his excellent howto and the virtual
framebuffer driver code made this possible. framebuffer driver code made this possible.
2. Jeff Hartmann for his agpgart code. 2. Jeff Hartmann for his agpgart code.
@ -261,15 +263,15 @@ G. Acknowledgment:
XFree86 source code. XFree86 source code.
4. Intel(c). For this value-oriented chipset driver and for 4. Intel(c). For this value-oriented chipset driver and for
providing documentation. providing documentation.
5. Matt Sottek. His inputs and ideas helped in making some 5. Matt Sottek. His inputs and ideas helped in making some
optimizations possible. optimizations possible.
H. Home Page: H. Home Page:
A more complete, and probably updated information is provided at A more complete, and probably updated information is provided at
http://i810fb.sourceforge.net. http://i810fb.sourceforge.net.
########################### ###########################
Tony Tony