kernel/linux/Documentation/fb/tgafb.txt

   1 $Id: tgafb.txt,v 1.1.1.1 2006/04/12 06:25:09 michaelc Exp $
   2
   3 What is tgafb?
   4 ===============
   5
   6 This is a driver for DECChip 21030 based graphics framebuffers, a.k.a. TGA
   7 cards, which are usually found in older Digital Alpha systems. The
   8 following models are supported:
   9
  10 ZLxP-E1 (8bpp, 2 MB VRAM)
  11 ZLxP-E2 (32bpp, 8 MB VRAM)
  12 ZLxP-E3 (32bpp, 16 MB VRAM, Zbuffer)
  13
  14 This version is an almost complete rewrite of the code written by Geert
  15 Uytterhoeven, which was based on the original TGA console code written by
  16 Jay Estabrook.
  17
  18 Major new features since Linux 2.0.x:
  19
  20  * Support for multiple resolutions
  21  * Support for fixed-frequency and other oddball monitors
  22    (by allowing the video mode to be set at boot time)
  23
  24 User-visible changes since Linux 2.2.x:
  25
  26  * Sync-on-green is now handled properly
  27  * More useful information is printed on bootup
  28    (this helps if people run into problems)
  29
  30 This driver does not (yet) support the TGA2 family of framebuffers, so the
  31 PowerStorm 3D30/4D20 (also known as PBXGB) cards are not supported. These
  32 can however be used with the standard VGA Text Console driver.
  33
  34
  35 Configuration
  36 =============
  37
  38 You can pass kernel command line options to tgafb with
  39 `video=tgafb:option1,option2:value2,option3' (multiple options should be
  40 separated by comma, values are separated from options by `:').
  41 Accepted options:
  42
  43 font:X    - default font to use. All fonts are supported, including the
  44             SUN12x22 font which is very nice at high resolutions.
  45
  46 mode:X    - default video mode. The following video modes are supported:
  47             640x480-60, 800x600-56, 640x480-72, 800x600-60, 800x600-72,
  48             1024x768-60, 1152x864-60, 1024x768-70, 1024x768-76,
  49             1152x864-70, 1280x1024-61, 1024x768-85, 1280x1024-70,
  50             1152x864-84, 1280x1024-76, 1280x1024-85
  51
  52
  53 Known Issues
  54 ============
  55
  56 The XFree86 FBDev server has been reported not to work, since tgafb doesn't do
  57 mmap(). Running the standard XF86_TGA server from XFree86 3.3.x works fine for
  58 me, however this server does not do acceleration, which make certain operations
  59 quite slow. Support for acceleration is being progressively integrated in
  60 XFree86 4.x.
  61
  62 When running tgafb in resolutions higher than 640x480, on switching VCs from
  63 tgafb to XF86_TGA 3.3.x, the entire screen is not re-drawn and must be manually
  64 refreshed. This is an X server problem, not a tgafb problem, and is fixed in
  65 XFree86 4.0.
  66
  67 Enjoy!
  68
  69 Martin Lucina <mato@kotelna.sk>