Christian Merkle | d463d34 | 2006-08-22 10:07:01 +1000 | [diff] [blame] | 1 | Intel 830M/845G/852GM/855GM/865G/915G/945G Framebuffer driver |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 2 | ================================================================ |
| 3 | |
| 4 | A. Introduction |
Christian Merkle | d463d34 | 2006-08-22 10:07:01 +1000 | [diff] [blame] | 5 | This is a framebuffer driver for various Intel 8xx/9xx compatible |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 6 | graphics devices. These would include: |
| 7 | |
| 8 | Intel 830M |
Christian Merkle | d463d34 | 2006-08-22 10:07:01 +1000 | [diff] [blame] | 9 | Intel 845G |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 10 | Intel 852GM |
| 11 | Intel 855GM |
| 12 | Intel 865G |
| 13 | Intel 915G |
Christian Merkle | d463d34 | 2006-08-22 10:07:01 +1000 | [diff] [blame] | 14 | Intel 915GM |
| 15 | Intel 945G |
| 16 | Intel 945GM |
Maik Broemme | 0e170c7 | 2008-04-28 02:15:43 -0700 | [diff] [blame] | 17 | Intel 965G |
| 18 | Intel 965GM |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 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 | |
Christian Merkle | d463d34 | 2006-08-22 10:07:01 +1000 | [diff] [blame] | 86 | video=intelfb:option1,option2=value2 |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 87 | |
| 88 | Sample Usage |
| 89 | ------------ |
| 90 | |
| 91 | In /etc/lilo.conf, add the line: |
| 92 | |
Ph. Marek | 6bf1d73 | 2006-10-03 01:14:38 -0700 | [diff] [blame] | 93 | append="video=intelfb:mode=800x600-32@75,accel,hwcursor,vram=8" |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 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 | |
Ph. Marek | 6bf1d73 | 2006-10-03 01:14:38 -0700 | [diff] [blame] | 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 | |
Sylvain Meyer | 4ff45f5 | 2005-06-21 17:17:03 -0700 | [diff] [blame] | 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 |