summaryrefslogtreecommitdiff
path: root/Documentation/fb/gxfb.rst
blob: 5738709bccbbf357e38d1d69b11134e685d3ac7e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
=============
What is gxfb?
=============

.. [This file is cloned from VesaFB/aty128fb]

This is a graphics framebuffer driver for AMD Geode GX2 based processors.

Advantages:

 * No need to use AMD's VSA code (or other VESA emulation layer) in the
   BIOS.
 * It provides a nice large console (128 cols + 48 lines with 1024x768)
   without using tiny, unreadable fonts.
 * You can run XF68_FBDev on top of /dev/fb0
 * Most important: boot logo :-)

Disadvantages:

 * graphic mode is slower than text mode...


How to use it?
==============

Switching modes is done using  gxfb.mode_option=<resolution>... boot
parameter or using `fbset` program.

See Documentation/fb/modedb.rst for more information on modedb
resolutions.


X11
===

XF68_FBDev should generally work fine, but it is non-accelerated.


Configuration
=============

You can pass kernel command line options to gxfb with gxfb.<option>.
For example, gxfb.mode_option=800x600@75.
Accepted options:

================ ==================================================
mode_option	 specify the video mode.  Of the form
		 <x>x<y>[-<bpp>][@<refresh>]
vram		 size of video ram (normally auto-detected)
vt_switch	 enable vt switching during suspend/resume.  The vt
		 switch is slow, but harmless.
================ ==================================================

Andres Salomon <dilinger@debian.org>