summaryrefslogtreecommitdiff
path: root/README
blob: f9f3764de4c2cff614a82b5ff82ad48ec4edf27b (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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
AMD Geode GX and LX graphics driver for X.Org
=============================================
README last updated: 2009-08-04

GIT repository:
        git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode

Gitweb browser:
        http://cgit.freedesktop.org/xorg/driver/xf86-video-geode

Project homepage:
	http://wiki.x.org/wiki/GeodeDriver

= Introduction =

This is the X graphics driver for the AMD Geode GX and LX processors.
The GX driver features XAA and EXA support for graphics acceleration,
and the LX driver supports EXA (including compositing).  Both drivers
support dynamic rotation with XRandR, and Xv overlay support.

= Roadmap =

Support for X servers older than 1.4 is expected to be dropped in the
near future.  If your distribution still hasn't upgraded, please urge 
them to get around it soon.

Support for old GX1 Geodes by Cyrix and NSC will be reintroduced soon,
at which point xf86-video-cyrix and xf86-video-nsc will be retired.

= Dependencies =

As of version 2.9.0, this driver depends on X.Org server 1.3 or newer,
because it utilizes the new common DDC probing libraries from X.Org.

If necessary, it might be possible to create autoconf macros to make 
this driver compile against older X servers, following this example:

http://lists.freedesktop.org/archives/xorg-commit/2007-February/010341.html

Patches accomplishing the same trick for the Geode driver are welcome.

= FAQ =

Q: Why doesn't this GEODE driver work at WXGA (wide screen) resolutions?

A: Make sure that TFT Panel support is disabled in the BIOS settings, 
   otherwise resolutions will be restricted to traditional VGA modes. 
   The GEODE offers a choice between CRT-only, CRT+TFT, TFT-only for
   output device and selecting CRT-only removes the VGA restriction.

Q: How do I produce useful information whenever submiting a bug report?

A: See http://www.x.org/wiki/Development/Documentation/ServerDebugging
   and follow the instructions.

Q: How do I test development snapshots from the upstream GIT repository?

A: Run the following commands from a command line interpreter shell...
   1. git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode 
   2. Debian/Ubuntu:  apt-get install autoconf automake libtool xutils-dev
                      apt-get install build-dep xserver-xorg-video-geode
     Fedora/Red Hat:  yum install autoconf automake libtool xorg-x11-util-macros
                      yum-builddep xorg-x11-drv-geode
   3. cd xf86-video-geode
   4. ./autogen.sh
   5. make distcheck
   ...then install the driver manually.

Q: What is the preferred method for submitting patches to this driver?

A: See http://www.x.org/wiki/Development/Documentation/SubmittingPatches
   and submit the patches as attachments to the Geode X.org mailing list
   or to the X.org Bugzilla against component "Driver/geode".

= Configuration options =

You can specify the Geode driver in the normal fashion:

Section "Device"
	Identifier "AMD Geode"
	Driver "geode"
	Option "blah" "blah"
	...
EndSection

The following options may be added to the section:

== GX ==

SWCursor: Enable software cursors (essentially disabling HW cursor support)
NoCompression: Disable video bandwidth compression
NoAccel: Disable hardware assisted acceleration
AccelMethod: "EXA" (default) or "XAA"
Rotate: Select a orientation to start with - LEFT, INVERT, CCW
NoPanel: Disable panel support
OSMImageBuffers: Set the number of image buffers (XAA only)
OSMColorExpBuffers: Set the number of color expansion buffers (XAA only)
FBSize: Specify the size of the video space (in bytes)
PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>")

== LX ==

SWCursor: Enable software cursors (essentially disabling HW cursor support)
NoCompression: Disable video bandwidth compression
NoAccel: Disable hardware assisted acceleration
Rotate: Select a orientation to start with - LEFT, INVERT, CCW
NoPanel: Disable panel support
ExaScratch: Specify the amount of extra EXA scratch buffer (in bytes)
FBSize: Specify the size of the video space (in bytes)
PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>")

= EOF =