xref: /linux/Documentation/fb/gxfb.rst (revision 0898782247ae533d1f4e47a06bc5d4870931b284)
1*ab42b818SMauro Carvalho Chehab=============
2*ab42b818SMauro Carvalho ChehabWhat is gxfb?
3*ab42b818SMauro Carvalho Chehab=============
4*ab42b818SMauro Carvalho Chehab
5*ab42b818SMauro Carvalho Chehab.. [This file is cloned from VesaFB/aty128fb]
6*ab42b818SMauro Carvalho Chehab
7*ab42b818SMauro Carvalho ChehabThis is a graphics framebuffer driver for AMD Geode GX2 based processors.
8*ab42b818SMauro Carvalho Chehab
9*ab42b818SMauro Carvalho ChehabAdvantages:
10*ab42b818SMauro Carvalho Chehab
11*ab42b818SMauro Carvalho Chehab * No need to use AMD's VSA code (or other VESA emulation layer) in the
12*ab42b818SMauro Carvalho Chehab   BIOS.
13*ab42b818SMauro Carvalho Chehab * It provides a nice large console (128 cols + 48 lines with 1024x768)
14*ab42b818SMauro Carvalho Chehab   without using tiny, unreadable fonts.
15*ab42b818SMauro Carvalho Chehab * You can run XF68_FBDev on top of /dev/fb0
16*ab42b818SMauro Carvalho Chehab * Most important: boot logo :-)
17*ab42b818SMauro Carvalho Chehab
18*ab42b818SMauro Carvalho ChehabDisadvantages:
19*ab42b818SMauro Carvalho Chehab
20*ab42b818SMauro Carvalho Chehab * graphic mode is slower than text mode...
21*ab42b818SMauro Carvalho Chehab
22*ab42b818SMauro Carvalho Chehab
23*ab42b818SMauro Carvalho ChehabHow to use it?
24*ab42b818SMauro Carvalho Chehab==============
25*ab42b818SMauro Carvalho Chehab
26*ab42b818SMauro Carvalho ChehabSwitching modes is done using  gxfb.mode_option=<resolution>... boot
27*ab42b818SMauro Carvalho Chehabparameter or using `fbset` program.
28*ab42b818SMauro Carvalho Chehab
29*ab42b818SMauro Carvalho ChehabSee Documentation/fb/modedb.rst for more information on modedb
30*ab42b818SMauro Carvalho Chehabresolutions.
31*ab42b818SMauro Carvalho Chehab
32*ab42b818SMauro Carvalho Chehab
33*ab42b818SMauro Carvalho ChehabX11
34*ab42b818SMauro Carvalho Chehab===
35*ab42b818SMauro Carvalho Chehab
36*ab42b818SMauro Carvalho ChehabXF68_FBDev should generally work fine, but it is non-accelerated.
37*ab42b818SMauro Carvalho Chehab
38*ab42b818SMauro Carvalho Chehab
39*ab42b818SMauro Carvalho ChehabConfiguration
40*ab42b818SMauro Carvalho Chehab=============
41*ab42b818SMauro Carvalho Chehab
42*ab42b818SMauro Carvalho ChehabYou can pass kernel command line options to gxfb with gxfb.<option>.
43*ab42b818SMauro Carvalho ChehabFor example, gxfb.mode_option=800x600@75.
44*ab42b818SMauro Carvalho ChehabAccepted options:
45*ab42b818SMauro Carvalho Chehab
46*ab42b818SMauro Carvalho Chehab================ ==================================================
47*ab42b818SMauro Carvalho Chehabmode_option	 specify the video mode.  Of the form
48*ab42b818SMauro Carvalho Chehab		 <x>x<y>[-<bpp>][@<refresh>]
49*ab42b818SMauro Carvalho Chehabvram		 size of video ram (normally auto-detected)
50*ab42b818SMauro Carvalho Chehabvt_switch	 enable vt switching during suspend/resume.  The vt
51*ab42b818SMauro Carvalho Chehab		 switch is slow, but harmless.
52*ab42b818SMauro Carvalho Chehab================ ==================================================
53*ab42b818SMauro Carvalho Chehab
54*ab42b818SMauro Carvalho ChehabAndres Salomon <dilinger@debian.org>
55