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