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>