# Geode Driver


## Hardware Support

**NOTE**: the **cyrix** and **nsc** drivers are seriously rotting and some distributions have chosen not to ship them. As such, we have set a milestone to import GX1 support into **geode** and then deprecate **cyrix** and **nsc**. Help is welcome! See below for details. 

* AMD Geode NX is not supported by any known driver. 

### xf86-video-geode

This driver was previously called **amd**. It was renamed **geode** to avoid confusion with ATI chipsets acquired by AMD. 

* AMD Geode LX (a.k.a. GX3) PCI ID: 0x1022:0x2081 
* AMD Geode GX (a.k.a. GX2) PCI ID: 0x100B:0x0030 
This is not a typo; both **nsc** and **geode** support GX2. However, only **geode** has up-to-date code, while **nsc** is deprecated. 


### xf86-video-nsc

* NSC Geode Media GX (a.k.a. GX2) PCI ID: 0x100B:0x0030 
* NSC Geode SCx200 (a.k.a. GX1) PCI ID: 0x100B:0x0504 
* NSC Geode SC1400 (a.k.a. GX1) PCI ID: 0x100B:0x0104 

### xf86-video-cyrix

* Cyrix Geode Media GX (a.k.a. GX1) PCI ID: 0x1078:0x0104 

### AutoConfig support

* LX  works since X server 1.5. 
* GX2 works since X server 1.7. 
* GX1 works since X server 1.7. 
See patches on the [[Ubuntu BTS|https://bugs.launchpad.net/ubuntu/+source/xorg-server/+bug/423866]] to implement this on 1.4 and 1.6; should also work on 1.3 and 1.5 with minor adjustments. 


## Current Status: xf86-video-geode 2.11.14 (released: 2012-11-25)


### Server-specific bugs

* With X server 1.7 and up: 
   * (no known issue) 
* With X server 1.5 and X server 1.6: 
   * EXA Composite rendering bug: Black boxes [[X.org BTS|https://bugs.freedesktop.org/show_bug.cgi?id=15700]] 
   * [[AutoConfig|AutoConfig]] only implemented for LX. 
* With X server 1.3 and X server 1.4: 
   * Some platforms will freeze when using _X -configure_: [[Ubuntu BTS|https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-amd/+bug/140051]]. 
      * Attachments include two patches against **x86emu** (port blacklist, PCI bus access) that resolve this issue. 
         * _blacklist patch rejected_ 
         * _PCI patch merged into X core 1.5 tree_ 
* With X server 1.2: 
   * Cannot compile since 2.9.0 (see below). 
   * Switching to a console using CTRL+ALT+Fx fails on some platforms: [[Debian BTS|http://bugs.debian.org/451089]] [[Ubuntu BTS|https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-amd/+bug/180742]]. 
      * Attachments include a patch against **x86emu** (CPUID) that resolves the issue. 
         * _CPU ID patch merged into X core 1.5 tree_ 
* With X server 1.1 and a static xorg.conf configuration file: 
   * Cannot compile since 2.9.0 (see below). 

### Known Regression

* Compilation against X server << 1.3 fails since **geode** 2.9.0 because of a missing header: [[!format txt """
 geode_ddc.c:31:23: error: xf86Modes.h: No such file or directory
 geode_ddc.c:158:50: error: missing binary operator before token "("
"""]]Might be fixable following [[Intel driver autoconf|http://lists.freedesktop.org/archives/xorg-commit/2007-February/010341.html]] methods. 

### Bug Trackers

* [[X.org BTS|https://bugs.freedesktop.org/buglist.cgi?query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Driver/cyrix&component=Driver/geode&component=Driver/nsc&product=xorg]] 
* [[Debian BTS|http://bugs.debian.org/xserver-xorg-video-geode]] 
* [[Fedora BTS|https://bugzilla.redhat.com/buglist.cgi?component=xorg-x11-drv-geode&component=xorg-x11-drv-amd&component=xorg-x11-drv-cyrix&component=xorg-x11-drv-nsc]] 
* [[Ubuntu BTS|https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-geode]] 

## Download

* [[Tarballs|http://xorg.freedesktop.org/releases/individual/driver/]] 
* [[Git Web|http://cgit.freedesktop.org/xorg/driver/xf86-video-geode/]] 
* git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-geode 

## Mailing Lists

* X.org xf86-video-geode [[list|http://lists.x.org/mailman/listinfo/xorg-driver-geode]] 
* AMD Geode Linux list [[archive|http://geode.insideo.net/info-linux_archives/maillist.html]] 

## IRC channel

#geode on the Freenode network. 


## Development Roadmap

The following details the current development roadmap.  Please [[create a bug|https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver/geode]] to make a suggestion for new features. 


### 2.11.15

Next bug fix release. Release date unknown. Please link to specific patches on the X.org BTS that you think should be reviewed for inclusion. 
[[!table header="no" class="mointable" data="""
**Feature**  | **Developer**  | **Status**  | **Notes** 
 DDC pin bit-banging  |   |   |  Xorg: #22100, Debian #637778, Ubuntu #873942, Red Hat #642766 
"""]]


### 2.12.0

Next major release. Release date unknown. 
[[!table header="no" class="mointable" data="""
**Feature**  | **Developer**  | **Status**  | **Notes** 
Merge GX1 support, then deprecate **cyrix** and **nsc** drivers  | OPEN  | Planned  | [[see X.org BTS wishlist bug|https://bugs.freedesktop.org/show_bug.cgi?id=2737]] 
Port to Linux >= 2.6.30 kernel mode setting (KMS)  | OPEN  | Planned  |  
"""]]


# Contributors

* Daniel Drake (OLPC) 
* Hunk Cui (AMD) 
* Frank Huang (AMD) 
* Priit Laes (Gentoo) 
* Martin-Éric Racine (Debian, Ubuntu) 
* Mart Raudsepp (Freelance, Gentoo) 
* Otavio Salvador (Debian) 

## Previous Contributors

* Chris Ball (OLPC) 
* Jordan Crouse (AMD) 
* Bernardo Innocenti (OLPC) 
* Adam Jackson (Red Hat) 
* Gideon Romm (Symbio Technologies) 
* Warren Togami (Red Hat) 
* Bart Trojanowski (Symbio Technologies) 

# X.org HOWTO

* [[Various developer-oriented FAQ and HOWTO|http://www.x.org/wiki/Development]]