^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) What is pvr2fb?
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) This is a driver for PowerVR 2 based graphics frame buffers, such as the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) one found in the Dreamcast.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Advantages:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) * It provides a nice large console (128 cols + 48 lines with 1024x768)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) without using tiny, unreadable fonts (NOT on the Dreamcast)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) * You can run XF86_FBDev on top of /dev/fb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) * Most important: boot logo :-)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Disadvantages:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * Driver is largely untested on non-Dreamcast systems.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Configuration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) =============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) You can pass kernel command line options to pvr2fb with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) `video=pvr2fb:option1,option2:value2,option3` (multiple options should be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) separated by comma, values are separated from options by `:`).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Accepted options:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ========== ==================================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) font:X default font to use. All fonts are supported, including the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) SUN12x22 font which is very nice at high resolutions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) mode:X default video mode with format [xres]x[yres]-<bpp>@<refresh rate>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) The following video modes are supported:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 640x640-16@60, 640x480-24@60, 640x480-32@60. The Dreamcast
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) defaults to 640x480-16@60. At the time of writing the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 24bpp and 32bpp modes function poorly. Work to fix that is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) ongoing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Note: the 640x240 mode is currently broken, and should not be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) used for any reason. It is only mentioned here as a reference.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) inverse invert colors on screen (for LCD displays)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) nomtrr disables write combining on frame buffer. This slows down driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) but there is reported minor incompatibility between GUS DMA and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) XFree under high loads if write combining is enabled (sound
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) dropouts). MTRR is enabled by default on systems that have it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) configured and that support it.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) cable:X cable type. This can be any of the following: vga, rgb, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) composite. If none is specified, we guess.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) output:X output type. This can be any of the following: pal, ntsc, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) vga. If none is specified, we guess.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) ========== ==================================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) X11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) ===
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) XF86_FBDev has been shown to work on the Dreamcast in the past - though not yet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) on any 2.6 series kernel.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) Paul Mundt <lethal@linuxdc.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) Updated by Adrian McMenamin <adrian@mcmen.demon.co.uk>