README revision 1.1.1.2
1 1.1 mrg xf86-video-geode -- AMD Geode GX and LX graphics driver for X.org 2 1.1 mrg ================================================================= 3 1.1 mrg README last updated: 2009-09-09 4 1.1 mrg 5 1.1 mrg GIT repository: 6 1.1 mrg git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode 7 1.1 mrg 8 1.1 mrg Gitweb browser: 9 1.1 mrg http://cgit.freedesktop.org/xorg/driver/xf86-video-geode 10 1.1 mrg 11 1.1 mrg Project homepage: 12 1.1 mrg http://www.x.org/wiki/GeodeDriver 13 1.1 mrg 14 1.1 mrg = Introduction = 15 1.1 mrg 16 1.1 mrg This is the X graphics driver for the AMD Geode GX and LX processors. 17 1.1 mrg The GX driver features XAA and EXA support for graphics acceleration, 18 1.1 mrg and the LX driver supports EXA (including compositing). Both drivers 19 1.1 mrg support dynamic rotation with XRandR, and Xv overlay support. 20 1.1 mrg 21 1.1 mrg = Roadmap = 22 1.1 mrg 23 1.1 mrg Support for X servers older than 1.4 is expected to be dropped in the 24 1.1 mrg near future. If your distribution still hasn't upgraded, please urge 25 1.1 mrg them to get around it soon. 26 1.1 mrg 27 1.1 mrg Support for old GX1 Geodes by Cyrix and NSC will be reintroduced soon, 28 1.1 mrg at which point xf86-video-cyrix and xf86-video-nsc will be retired. 29 1.1 mrg 30 1.1 mrg Until then, the current situation for Geode coverage is as follow: 31 1.1 mrg 32 1.1 mrg xf86-video-geode 33 1.1 mrg * Geode LX (a.k.a. GX3) PCI ID 0x1022:0x2081 34 1.1 mrg * Geode GX (a.k.a. GX2) PCI ID 0x100B:0x0030 (rebranded GX2) 35 1.1 mrg 36 1.1 mrg xf86-video-nsc 37 1.1 mrg * Geode GX2 (a.k.a. GX2) PCI ID 0x100B:0x0030 (a.k.a. "Red Cloud") 38 1.1 mrg * Geode SCx200 (a.k.a. GX1) PCI ID 0x100B:0x0504 39 1.1 mrg * Geode SC1400 (a.k.a. GX1) PCI ID 0x100B:0x0104 40 1.1 mrg 41 1.1 mrg xf86-video-cyrix 42 1.1 mrg * Geode MediaGX (a.k.a. GX1) PCI ID 0x1078:0x0104 43 1.1 mrg 44 1.1 mrg Please note that both NSC and GEODE support GX2. This is indeed correct. 45 1.1 mrg However, only GEODE has up-to-date code, while NSC is deprecated. 46 1.1 mrg 47 1.1 mrg = Dependencies = 48 1.1 mrg 49 1.1 mrg As of version 2.11.4, this driver depends upon X server 1.5 or newer, 50 1.1 mrg because the GX Randr code utilizes dixSetPrivate whose API was modified 51 1.1 mrg in a non backward-compatible way. 52 1.1 mrg 53 1.1 mrg #ifdef'ing the changes from f1268f3ba8404129d358db3bb1e66f3841f7018a 54 1.1 mrg and b28abde0276ddd7f687242f3886f98b0e49a7fc2 might make it possible 55 1.1 mrg to build this driver against older X servers. Patches are welcome. 56 1.1 mrg 57 1.1 mrg As of version 2.9.0, this driver depends on X server 1.3 or newer, 58 1.1 mrg because it utilizes the new common DDC probing libraries from X.Org. 59 1.1 mrg 60 1.1 mrg If necessary, it might be possible to create autoconf macros to make 61 1.1 mrg this driver compile against older X servers, following this example: 62 1.1 mrg 63 1.1 mrg http://lists.freedesktop.org/archives/xorg-commit/2007-February/010341.html 64 1.1 mrg 65 1.1 mrg Patches accomplishing the same trick for the Geode driver are welcome. 66 1.1 mrg 67 1.1 mrg = FAQ = 68 1.1 mrg 69 1.1.1.2 mrg Q: Why doesn't screen rotation work? 70 1.1.1.2 mrg 71 1.1.1.2 mrg A: Make sure that a sufficient amount of video RAM is reserved in the BIOS, 72 1.1.1.2 mrg otherwise rotation will fail and this error message appear in Xorg.log: 73 1.1.1.2 mrg Couldn't allocate the shadow memory for rotation 74 1.1.1.2 mrg You need XX bytes, but only YY bytes are available 75 1.1.1.2 mrg 76 1.1 mrg Q: Why doesn't this GEODE driver work at WXGA (wide screen) resolutions? 77 1.1 mrg 78 1.1 mrg A: Make sure that TFT Panel support is disabled in the BIOS settings, 79 1.1 mrg otherwise resolutions will be restricted to traditional VGA modes. 80 1.1 mrg The GEODE offers a choice between CRT-only, CRT+TFT, TFT-only for 81 1.1 mrg output device and selecting CRT-only removes the VGA restriction. 82 1.1 mrg 83 1.1 mrg Q: How do I produce useful information whenever submiting a bug report? 84 1.1 mrg 85 1.1 mrg A: See http://www.x.org/wiki/Development/Documentation/ServerDebugging 86 1.1 mrg and follow the instructions. 87 1.1 mrg 88 1.1 mrg Q: How do I test development snapshots from the upstream GIT repository? 89 1.1 mrg 90 1.1 mrg A: Run the following commands from a command line interpreter shell... 91 1.1 mrg 1. git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode 92 1.1 mrg 2. Debian/Ubuntu: apt-get install autoconf automake libtool xutils-dev 93 1.1 mrg apt-get install build-dep xserver-xorg-video-geode 94 1.1 mrg Fedora/Red Hat: yum install autoconf automake libtool xorg-x11-util-macros 95 1.1 mrg yum-builddep xorg-x11-drv-geode 96 1.1 mrg 3. cd xf86-video-geode 97 1.1 mrg 4. ./autogen.sh 98 1.1 mrg 5. make distcheck 99 1.1 mrg ...then install the driver manually. 100 1.1 mrg 101 1.1 mrg Q: What is the preferred method for submitting patches to this driver? 102 1.1 mrg 103 1.1 mrg A: See http://www.x.org/wiki/Development/Documentation/SubmittingPatches 104 1.1 mrg and submit the patches as attachments to the Geode X.org mailing list 105 1.1 mrg or to the X.org Bugzilla against component "Driver/geode". 106 1.1 mrg 107 1.1 mrg = Configuration options = 108 1.1 mrg 109 1.1 mrg You can specify the Geode driver in the normal fashion: 110 1.1 mrg 111 1.1 mrg Section "Device" 112 1.1 mrg Identifier "AMD Geode" 113 1.1 mrg Driver "geode" 114 1.1 mrg Option "blah" "blah" 115 1.1 mrg ... 116 1.1 mrg EndSection 117 1.1 mrg 118 1.1 mrg The following options may be added to the section: 119 1.1 mrg 120 1.1.1.2 mrg == Common options == 121 1.1 mrg 122 1.1.1.2 mrg FBSize: Specify the size of the video space (in bytes) 123 1.1 mrg NoAccel: Disable hardware assisted acceleration 124 1.1.1.2 mrg NoCompression: Disable video bandwidth compression 125 1.1 mrg NoPanel: Disable panel support 126 1.1.1.2 mrg Rotate: Select a orientation to start with - LEFT, INVERT, CCW 127 1.1.1.2 mrg SWCursor: Enable software cursors (essentially disabling HW cursor support) 128 1.1.1.2 mrg 129 1.1.1.2 mrg == GX-specific options == 130 1.1.1.2 mrg 131 1.1.1.2 mrg AccelMethod: "XAA" (default) or "EXA" 132 1.1.1.2 mrg PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>") 133 1.1 mrg OSMImageBuffers: Set the number of image buffers (XAA only) 134 1.1 mrg OSMColorExpBuffers: Set the number of color expansion buffers (XAA only) 135 1.1 mrg 136 1.1.1.2 mrg == LX-specific options == 137 1.1 mrg 138 1.1 mrg ExaScratch: Specify the amount of extra EXA scratch buffer (in bytes) 139 1.1 mrg 140 1.1 mrg = EOF = 141
Indexes created Wed Oct 28 00:26:01 UTC 2026