| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame^] | 1 | $Id: tgafb.txt,v 1.1.2.2 2000/04/04 06:50:18 mato 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> |