Back to home page

OSCL-LXR

 
 

    


0001 ===============
0002 What is pvr2fb?
0003 ===============
0004 
0005 This is a driver for PowerVR 2 based graphics frame buffers, such as the
0006 one found in the Dreamcast.
0007 
0008 Advantages:
0009 
0010  * It provides a nice large console (128 cols + 48 lines with 1024x768)
0011    without using tiny, unreadable fonts (NOT on the Dreamcast)
0012  * You can run XF86_FBDev on top of /dev/fb0
0013  * Most important: boot logo :-)
0014 
0015 Disadvantages:
0016 
0017  * Driver is largely untested on non-Dreamcast systems.
0018 
0019 Configuration
0020 =============
0021 
0022 You can pass kernel command line options to pvr2fb with
0023 `video=pvr2fb:option1,option2:value2,option3` (multiple options should be
0024 separated by comma, values are separated from options by `:`).
0025 
0026 Accepted options:
0027 
0028 ==========  ==================================================================
0029 font:X      default font to use. All fonts are supported, including the
0030             SUN12x22 font which is very nice at high resolutions.
0031 
0032 
0033 mode:X      default video mode with format [xres]x[yres]-<bpp>@<refresh rate>
0034             The following video modes are supported:
0035             640x640-16@60, 640x480-24@60, 640x480-32@60. The Dreamcast
0036             defaults to 640x480-16@60. At the time of writing the
0037             24bpp and 32bpp modes function poorly. Work to fix that is
0038             ongoing
0039 
0040             Note: the 640x240 mode is currently broken, and should not be
0041             used for any reason. It is only mentioned here as a reference.
0042 
0043 inverse     invert colors on screen (for LCD displays)
0044 
0045 nomtrr      disables write combining on frame buffer. This slows down driver
0046             but there is reported minor incompatibility between GUS DMA and
0047             XFree under high loads if write combining is enabled (sound
0048             dropouts). MTRR is enabled by default on systems that have it
0049             configured and that support it.
0050 
0051 cable:X     cable type. This can be any of the following: vga, rgb, and
0052             composite. If none is specified, we guess.
0053 
0054 output:X    output type. This can be any of the following: pal, ntsc, and
0055             vga. If none is specified, we guess.
0056 ==========  ==================================================================
0057 
0058 X11
0059 ===
0060 
0061 XF86_FBDev has been shown to work on the Dreamcast in the past - though not yet
0062 on any 2.6 series kernel.
0063 
0064 Paul Mundt <lethal@linuxdc.org>
0065 
0066 Updated by Adrian McMenamin <adrian@mcmen.demon.co.uk>