README revision 1.1.1.4
1 1.1 mrg xf86-video-geode -- AMD Geode GX and LX graphics driver for X.org 2 1.1 mrg ================================================================= 3 1.1.1.3 mrg README last updated: 2011-11-24 4 1.1 mrg 5 1.1.1.3 mrg 1.INTRODUCTION 6 1.1 mrg 7 1.1.1.3 mrg This is the X graphics driver for the AMD Geode GX and LX processors. 8 1.1.1.3 mrg The GX component supports both XAA and EXA for graphics acceleration. 9 1.1.1.3 mrg The LX component supports EXA, including compositing. Both support Xv 10 1.1.1.3 mrg overlay and dynamic rotation with XRandR. Additionally, a V4L2 driver 11 1.1.1.3 mrg for the LX's video input port (VIP) feature is provided as "ztv". 12 1.1 mrg 13 1.1.1.3 mrg 2.DEPENDENCIES 14 1.1 mrg 15 1.1.1.3 mrg Since version 2.9.0, this driver depends on X server 1.3 or greater, 16 1.1.1.3 mrg because it utilizes the new common DDC probing libraries from X.Org. 17 1.1 mrg 18 1.1.1.3 mrg 3.ROADMAP 19 1.1 mrg 20 1.1 mrg Support for old GX1 Geodes by Cyrix and NSC will be reintroduced soon, 21 1.1 mrg at which point xf86-video-cyrix and xf86-video-nsc will be retired. 22 1.1 mrg 23 1.1 mrg Until then, the current situation for Geode coverage is as follow: 24 1.1 mrg 25 1.1 mrg xf86-video-geode 26 1.1 mrg * Geode LX (a.k.a. GX3) PCI ID 0x1022:0x2081 27 1.1.1.3 mrg * Geode GX (a.k.a. GX2) PCI ID 0x100B:0x0030 (re-branded GX2) 28 1.1 mrg 29 1.1 mrg xf86-video-nsc 30 1.1 mrg * Geode GX2 (a.k.a. GX2) PCI ID 0x100B:0x0030 (a.k.a. "Red Cloud") 31 1.1 mrg * Geode SCx200 (a.k.a. GX1) PCI ID 0x100B:0x0504 32 1.1 mrg * Geode SC1400 (a.k.a. GX1) PCI ID 0x100B:0x0104 33 1.1 mrg 34 1.1 mrg xf86-video-cyrix 35 1.1 mrg * Geode MediaGX (a.k.a. GX1) PCI ID 0x1078:0x0104 36 1.1 mrg 37 1.1 mrg Please note that both NSC and GEODE support GX2. This is indeed correct. 38 1.1 mrg However, only GEODE has up-to-date code, while NSC is deprecated. 39 1.1 mrg 40 1.1.1.3 mrg 4.MAXIMUM RESOLUTIONS 41 1.1 mrg 42 1.1.1.3 mrg The driver supports all maximum resolutions advertised by AMD, namely: 43 1.1 mrg 44 1.1.1.3 mrg LX: 1920x1440 (CRT) and 1600x1200 (TFT) 45 1.1.1.3 mrg GX: 1600x1200 (CRT) and 1280x1024 (TFT) 46 1.1.1.3 mrg SC: 1280x1024 (CRT/TFT) *** Currently unsupported by this driver *** 47 1.1 mrg 48 1.1.1.3 mrg 5.CONFIGURATION OPTIONS 49 1.1 mrg 50 1.1.1.3 mrg You can specify driver options in /etc/X11/xorg.conf in the usual fashion: 51 1.1 mrg 52 1.1.1.3 mrg Section "Device" 53 1.1.1.3 mrg Identifier "AMD Geode" 54 1.1.1.3 mrg Driver "geode" 55 1.1.1.3 mrg Option "OptionName" "value" 56 1.1.1.3 mrg ... 57 1.1.1.3 mrg EndSection 58 1.1 mrg 59 1.1.1.3 mrg The following options may be added to such a Device section: 60 1.1 mrg 61 1.1.1.3 mrg 5.1.COMMON OPTIONS 62 1.1 mrg 63 1.1.1.3 mrg FBSize: Specify the size of the video space (in bytes) 64 1.1.1.3 mrg NoAccel: Disable hardware assisted acceleration 65 1.1.1.3 mrg NoCompression: Disable video bandwidth compression 66 1.1.1.3 mrg NoPanel: Disable panel support 67 1.1.1.3 mrg Rotate: Select an initial orientation - LEFT, INVERT, CCW 68 1.1.1.3 mrg SWCursor: Enable software cursors (essentially disabling HW cursor support) 69 1.1.1.2 mrg 70 1.1.1.3 mrg 5.2.GX-SPECIFIC OPTIONS 71 1.1.1.2 mrg 72 1.1.1.3 mrg AccelMethod: "XAA" (default) or "EXA" 73 1.1.1.3 mrg PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>") 74 1.1.1.3 mrg OSMImageBuffers: Set the number of image buffers (XAA only) 75 1.1.1.3 mrg OSMColorExpBuffers: Set the number of color expansion buffers (XAA only) 76 1.1.1.3 mrg 77 1.1.1.3 mrg 5.3.LX-SPECIFIC OPTIONS 78 1.1.1.3 mrg 79 1.1.1.3 mrg ExaScratch: Specify the amount of extra EXA scratch buffer (in bytes) 80 1.1.1.3 mrg 81 1.1.1.3 mrg 6.FREQUENTLY ASKED QUESTIONS (FAQ) 82 1.1.1.3 mrg 83 1.1.1.3 mrg Q: Why doesn't the GEODE driver work at WXGA (wide screen) resolutions? 84 1.1 mrg 85 1.1 mrg A: Make sure that TFT Panel support is disabled in the BIOS settings, 86 1.1 mrg otherwise resolutions will be restricted to traditional VGA modes. 87 1.1 mrg The GEODE offers a choice between CRT-only, CRT+TFT, TFT-only for 88 1.1 mrg output device and selecting CRT-only removes the VGA restriction. 89 1.1 mrg 90 1.1.1.3 mrg Q: How can these hardcoded modes be expanded to support a WXGA laptop? 91 1.1.1.3 mrg 92 1.1.1.3 mrg A: By adding the desired modes to /etc/X11/xorg.conf as follow: 93 1.1.1.3 mrg 94 1.1.1.3 mrg 1) Use either the "cvt" or "gtf" command to determine the modeline: 95 1.1.1.3 mrg 96 1.1.1.3 mrg cvt 1024 600 60 97 1.1.1.3 mrg 98 1.1.1.3 mrg Where 1024x600 is the resolution and 60 the refresh rate. 99 1.1.1.3 mrg The resulting modeline using "gtf" is: 100 1.1.1.3 mrg 101 1.1.1.3 mrg Modeline "1024x600" 48.96 1024 1064 1168 1312 600 601 604 622 -hsync +vsync 102 1.1.1.3 mrg 103 1.1.1.3 mrg 2) Add it to the bottom of the "Monitor" section in /etc/X11/xorg.conf. 104 1.1.1.3 mrg In this example, we created entries for two modes and configured the 105 1.1.1.3 mrg larger resolution to be our preferred choice. 106 1.1.1.3 mrg 107 1.1.1.3 mrg ############################################################# 108 1.1.1.3 mrg # /etc/X11/xorg.conf for 1024x600 and 800x480 laptop panels # 109 1.1.1.3 mrg ############################################################# 110 1.1.1.3 mrg #### By J.KASPER and B.HIBRY #### for Hercules eCafe 800 #### 111 1.1.1.3 mrg ############################################################# 112 1.1.1.3 mrg Section "Module" 113 1.1.1.3 mrg Load "ztv" 114 1.1.1.3 mrg EndSection 115 1.1.1.3 mrg Section "Device" 116 1.1.1.3 mrg Identifier "card0" 117 1.1.1.3 mrg Driver "geode" 118 1.1.1.3 mrg BusID "PCI:0:1:1" 119 1.1.1.3 mrg Option "PanelMode" "33450 800 840 968 1056 480 490 492 525" 120 1.1.1.3 mrg EndSection 121 1.1.1.3 mrg Section "Monitor" 122 1.1.1.3 mrg Identifier "monitor0" 123 1.1.1.3 mrg Modeline "1024x768" 64.56 1024 1056 1296 1328 768 783 791 807 -hsync +vsync 124 1.1.1.3 mrg Modeline "1024x600" 48.96 1024 1064 1168 1312 600 601 604 622 -hsync +vsync 125 1.1.1.3 mrg Modeline "800x480" 33.45 800 840 968 1056 480 490 492 525 -hsync +vsync 126 1.1.1.3 mrg Option "dpms" 127 1.1.1.3 mrg EndSection 128 1.1.1.3 mrg Section "Screen" 129 1.1.1.3 mrg Identifier "Default Screen" 130 1.1.1.3 mrg Monitor "monitor0" 131 1.1.1.3 mrg Device "card0" 132 1.1.1.3 mrg DefaultDepth 24 133 1.1.1.3 mrg Subsection "Display" 134 1.1.1.3 mrg Depth 24 135 1.1.1.3 mrg Modes "1024x600" "1024x768" "800x480" 136 1.1.1.3 mrg EndSubsection 137 1.1.1.3 mrg EndSection 138 1.1.1.3 mrg ### EOF ### 139 1.1.1.3 mrg 140 1.1.1.3 mrg Q: Why doesn't screen rotation work? 141 1.1.1.3 mrg 142 1.1.1.3 mrg A: Make sure that a sufficient amount of video RAM is reserved in the BIOS, 143 1.1.1.3 mrg otherwise rotation will fail and this error message appear in Xorg.log: 144 1.1.1.3 mrg 145 1.1.1.3 mrg Couldn't allocate the shadow memory for rotation 146 1.1.1.3 mrg You need XX bytes, but only YY bytes are available 147 1.1.1.3 mrg 148 1.1.1.3 mrg Q: How do I produce useful information whenever submitting a bug report? 149 1.1 mrg 150 1.1.1.4 mrg A: See https://www.x.org/wiki/Development/Documentation/ServerDebugging 151 1.1.1.3 mrg and follow the instructions found there. 152 1.1 mrg 153 1.1 mrg Q: How do I test development snapshots from the upstream GIT repository? 154 1.1 mrg 155 1.1.1.3 mrg A: Run the following commands from a command line interpreter shell: 156 1.1 mrg 1. git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode 157 1.1 mrg 2. Debian/Ubuntu: apt-get install autoconf automake libtool xutils-dev 158 1.1 mrg apt-get install build-dep xserver-xorg-video-geode 159 1.1 mrg Fedora/Red Hat: yum install autoconf automake libtool xorg-x11-util-macros 160 1.1 mrg yum-builddep xorg-x11-drv-geode 161 1.1 mrg 3. cd xf86-video-geode 162 1.1 mrg 4. ./autogen.sh 163 1.1 mrg 5. make distcheck 164 1.1 mrg ...then install the driver manually. 165 1.1 mrg 166 1.1 mrg Q: What is the preferred method for submitting patches to this driver? 167 1.1 mrg 168 1.1.1.4 mrg A: See https://www.x.org/wiki/Development/Documentation/SubmittingPatches 169 1.1.1.4 mrg and submit the patches to the Geode X.org mailing list or to gitlab 170 1.1.1.4 mrg in the xf86-video-geode project. 171 1.1 mrg 172 1.1.1.3 mrg 7.PROJECT CONTACTS 173 1.1 mrg 174 1.1.1.3 mrg Project homepage: 175 1.1.1.4 mrg https://www.x.org/wiki/GeodeDriver 176 1.1 mrg 177 1.1.1.3 mrg Mailing list: 178 1.1.1.4 mrg https://lists.x.org/mailman/listinfo/xorg-driver-geode 179 1.1 mrg 180 1.1.1.3 mrg Bug reports: 181 1.1.1.4 mrg https://gitlab.freedesktop.org/xorg/driver/xf86-video-geode/issues 182 1.1 mrg 183 1.1.1.3 mrg Code repository: 184 1.1.1.4 mrg https://gitlab.freedesktop.org/xorg/driver/xf86-video-geode 185 1.1 mrg 186 1.1.1.3 mrg IRC channel: 187 1.1.1.3 mrg #geode on the Freenode network. 188 1.1 mrg 189 1.1.1.3 mrg .EOF. 190
Indexes created Wed Oct 28 00:26:01 UTC 2026