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