Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

tridentfb: documentation update

Make the tridentfb documentation closer to current state of the tridentfb
driver. Fix also some formatting.

Signed-off-by: Krzysztof Helt <krzysztof.h1@wp.pl>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Krzysztof Helt and committed by
Linus Torvalds
a90ed92e 012e2609

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