]>
Commit | Line | Data |
---|---|---|
ab42b818 MCC |
1 | ========= |
2 | Tridentfb | |
3 | ========= | |
4 | ||
1da177e4 LT |
5 | Tridentfb is a framebuffer driver for some Trident chip based cards. |
6 | ||
7 | The following list of chips is thought to be supported although not all are | |
8 | tested: | |
9 | ||
a90ed92e KH |
10 | those from the TGUI series 9440/96XX and with Cyber in their names |
11 | those from the Image series and with Cyber in their names | |
12 | those with Blade in their names (Blade3D,CyberBlade...) | |
13 | the newer CyberBladeXP family | |
14 | ||
15 | All families are accelerated. Only PCI/AGP based cards are supported, | |
16 | none of the older Tridents. | |
17 | The driver supports 8, 16 and 32 bits per pixel depths. | |
18 | The TGUI family requires a line length to be power of 2 if acceleration | |
19 | is enabled. This means that range of possible resolutions and bpp is | |
20 | limited comparing to the range if acceleration is disabled (see list | |
21 | of parameters below). | |
22 | ||
23 | Known bugs: | |
ab42b818 | 24 | |
a90ed92e KH |
25 | 1. The driver randomly locks up on 3DImage975 chip with acceleration |
26 | enabled. The same happens in X11 (Xorg). | |
27 | 2. The ramdac speeds require some more fine tuning. It is possible to | |
28 | switch resolution which the chip does not support at some depths for | |
29 | older chips. | |
1da177e4 LT |
30 | |
31 | How to use it? | |
32 | ============== | |
33 | ||
ab42b818 MCC |
34 | When booting you can pass the video parameter:: |
35 | ||
36 | video=tridentfb | |
1da177e4 | 37 | |
ab42b818 | 38 | The parameters for tridentfb are concatenated with a ':' as in this example:: |
1da177e4 | 39 | |
ab42b818 | 40 | video=tridentfb:800x600-16@75,noaccel |
1da177e4 LT |
41 | |
42 | The second level parameters that tridentfb understands are: | |
43 | ||
ab42b818 MCC |
44 | ======== ===================================================================== |
45 | noaccel turns off acceleration (when it doesn't work for your card) | |
1da177e4 | 46 | |
ab42b818 MCC |
47 | fp use flat panel related stuff |
48 | crt assume monitor is present instead of fp | |
1da177e4 | 49 | |
ab42b818 | 50 | center for flat panels and resolutions smaller than native size center the |
1da177e4 LT |
51 | image, otherwise use |
52 | stretch | |
53 | ||
ab42b818 | 54 | memsize integer value in KB, use if your card's memory size is misdetected. |
1da177e4 | 55 | look at the driver output to see what it says when initializing. |
a90ed92e | 56 | |
ab42b818 | 57 | memdiff integer value in KB, should be nonzero if your card reports |
a90ed92e | 58 | more memory than it actually has. For instance mine is 192K less than |
1da177e4 LT |
59 | detection says in all three BIOS selectable situations 2M, 4M, 8M. |
60 | Only use if your video memory is taken from main memory hence of | |
a90ed92e KH |
61 | configurable size. Otherwise use memsize. |
62 | If in some modes which barely fit the memory you see garbage | |
63 | at the bottom this might help by not letting change to that mode | |
64 | anymore. | |
1da177e4 | 65 | |
ab42b818 | 66 | nativex the width in pixels of the flat panel.If you know it (usually 1024 |
1da177e4 LT |
67 | 800 or 1280) and it is not what the driver seems to detect use it. |
68 | ||
ab42b818 MCC |
69 | bpp bits per pixel (8,16 or 32) |
70 | mode a mode name like 800x600-8@75 as described in | |
71 | Documentation/fb/modedb.rst | |
72 | ======== ===================================================================== | |
1da177e4 LT |
73 | |
74 | Using insane values for the above parameters will probably result in driver | |
75 | misbehaviour so take care(for instance memsize=12345678 or memdiff=23784 or | |
76 | nativex=93) | |
77 | ||
78 | Contact: jani@astechnix.ro |