1
xf86-video-geode -- AMD Geode GX and LX graphics driver for X.org
2
=================================================================
3
README last updated: 2011-11-24
7
This is the X graphics driver for the AMD Geode GX and LX processors.
8
The GX component supports both XAA and EXA for graphics acceleration.
9
The LX component supports EXA, including compositing. Both support Xv
10
overlay and dynamic rotation with XRandR. Additionally, a V4L2 driver
11
for the LX's video input port (VIP) feature is provided as "ztv".
15
Since version 2.9.0, this driver depends on X server 1.3 or greater,
16
because it utilizes the new common DDC probing libraries from X.Org.
20
Support for old GX1 Geodes by Cyrix and NSC will be reintroduced soon,
21
at which point xf86-video-cyrix and xf86-video-nsc will be retired.
23
Until then, the current situation for Geode coverage is as follow:
26
* Geode LX (a.k.a. GX3) PCI ID 0x1022:0x2081
27
* Geode GX (a.k.a. GX2) PCI ID 0x100B:0x0030 (re-branded GX2)
30
* Geode GX2 (a.k.a. GX2) PCI ID 0x100B:0x0030 (a.k.a. "Red Cloud")
31
* Geode SCx200 (a.k.a. GX1) PCI ID 0x100B:0x0504
32
* Geode SC1400 (a.k.a. GX1) PCI ID 0x100B:0x0104
35
* Geode MediaGX (a.k.a. GX1) PCI ID 0x1078:0x0104
37
Please note that both NSC and GEODE support GX2. This is indeed correct.
38
However, only GEODE has up-to-date code, while NSC is deprecated.
42
The driver supports all maximum resolutions advertised by AMD, namely:
44
LX: 1920x1440 (CRT) and 1600x1200 (TFT)
45
GX: 1600x1200 (CRT) and 1280x1024 (TFT)
46
SC: 1280x1024 (CRT/TFT) *** Currently unsupported by this driver ***
48
5.CONFIGURATION OPTIONS
50
You can specify driver options in /etc/X11/xorg.conf in the usual fashion:
53
Identifier "AMD Geode"
55
Option "OptionName" "value"
59
The following options may be added to such a Device section:
63
FBSize: Specify the size of the video space (in bytes)
64
NoAccel: Disable hardware assisted acceleration
65
NoCompression: Disable video bandwidth compression
66
NoPanel: Disable panel support
67
Rotate: Select an initial orientation - LEFT, INVERT, CCW
68
SWCursor: Enable software cursors (essentially disabling HW cursor support)
70
5.2.GX-SPECIFIC OPTIONS
72
AccelMethod: "XAA" (default) or "EXA"
73
PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>")
74
OSMImageBuffers: Set the number of image buffers (XAA only)
75
OSMColorExpBuffers: Set the number of color expansion buffers (XAA only)
77
5.3.LX-SPECIFIC OPTIONS
79
ExaScratch: Specify the amount of extra EXA scratch buffer (in bytes)
81
6.FREQUENTLY ASKED QUESTIONS (FAQ)
83
Q: Why doesn't the GEODE driver work at WXGA (wide screen) resolutions?
85
A: Make sure that TFT Panel support is disabled in the BIOS settings,
86
otherwise resolutions will be restricted to traditional VGA modes.
87
The GEODE offers a choice between CRT-only, CRT+TFT, TFT-only for
88
output device and selecting CRT-only removes the VGA restriction.
90
Q: How can these hardcoded modes be expanded to support a WXGA laptop?
92
A: By adding the desired modes to /etc/X11/xorg.conf as follow:
94
1) Use either the "cvt" or "gtf" command to determine the modeline:
98
Where 1024x600 is the resolution and 60 the refresh rate.
99
The resulting modeline using "gtf" is:
101
Modeline "1024x600" 48.96 1024 1064 1168 1312 600 601 604 622 -hsync +vsync
103
2) Add it to the bottom of the "Monitor" section in /etc/X11/xorg.conf.
104
In this example, we created entries for two modes and configured the
105
larger resolution to be our preferred choice.
107
#############################################################
108
# /etc/X11/xorg.conf for 1024x600 and 800x480 laptop panels #
109
#############################################################
110
#### By J.KASPER and B.HIBRY #### for Hercules eCafe 800 ####
111
#############################################################
119
Option "PanelMode" "33450 800 840 968 1056 480 490 492 525"
122
Identifier "monitor0"
123
Modeline "1024x768" 64.56 1024 1056 1296 1328 768 783 791 807 -hsync +vsync
124
Modeline "1024x600" 48.96 1024 1064 1168 1312 600 601 604 622 -hsync +vsync
125
Modeline "800x480" 33.45 800 840 968 1056 480 490 492 525 -hsync +vsync
129
Identifier "Default Screen"
135
Modes "1024x600" "1024x768" "800x480"
140
Q: Why doesn't screen rotation work?
142
A: Make sure that a sufficient amount of video RAM is reserved in the BIOS,
143
otherwise rotation will fail and this error message appear in Xorg.log:
145
Couldn't allocate the shadow memory for rotation
146
You need XX bytes, but only YY bytes are available
148
Q: How do I produce useful information whenever submitting a bug report?
150
A: See http://www.x.org/wiki/Development/Documentation/ServerDebugging
151
and follow the instructions found there.
153
Q: How do I test development snapshots from the upstream GIT repository?
155
A: Run the following commands from a command line interpreter shell:
156
1. git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode
157
2. Debian/Ubuntu: apt-get install autoconf automake libtool xutils-dev
158
apt-get install build-dep xserver-xorg-video-geode
159
Fedora/Red Hat: yum install autoconf automake libtool xorg-x11-util-macros
160
yum-builddep xorg-x11-drv-geode
161
3. cd xf86-video-geode
164
...then install the driver manually.
166
Q: What is the preferred method for submitting patches to this driver?
168
A: See http://www.x.org/wiki/Development/Documentation/SubmittingPatches
169
and submit the patches to the Geode X.org mailing list or to Bugzilla
170
against product "xorg" component "Driver/geode".
175
http://www.x.org/wiki/GeodeDriver
178
http://lists.freedesktop.org/mailman/listinfo/xorg-driver-geode
181
https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver%2Fgeode
184
http://cgit.freedesktop.org/xorg/driver/xf86-video-geode
187
git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode
190
#geode on the Freenode network.