intelfb.rst 3.8 KB

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