summaryrefslogtreecommitdiff
path: root/GeodeDriver.mdwn
blob: 0269fd3e5f7360037674120364cca57a49ccdbb6 (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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
# Geode

Driver for [[Geode|https://en.wikipedia.org/wiki/Geode_%28processor%29]] single-chip computers' video output. License: MIT with additional manufacturer's responsibility waiver clause.

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

## Documentation

[[!table header="no" class="mointable" data="""
**Geode Model** | **Chipset** | **PCI ID**  | **Driver** | **Notes** 
AMD NX | ? | ? | (unsupported) | Based on Athlon K7 core.
AMD LX | GX3 | 0x1022:0x2081 | xf86-video-geode | OLPC XO-1, ThinCan DBE61/62/63, Linutop 1/2, FIC ION 603A, Viglen, etc.
NSC GX2| GX2 | 0x100B:0x0030 | xf86-video-geode or -nsc | a.k.a. AMD GX after Geode division was bought from NSC; a.k.a. "Red Cloud"
NSC SCx200 | GX1 | 0x100B:0x0504 | xf86-video-nsc | a.k.a. AMD SC after Geode division was bought from NSC.
NSC SC1400 | GX1 | 0x100B:0x0104 | xf86-video-nsc |
Cyrix Media GX | GX1 | 0x1078:0x0104 | xf86-video-cyrix or -nsc |
"""]]

Both **xf86-video-geode** and **xf86-video-nsc** support the "Red Cloud" chipset. However, only **geode** has up-to-date code. 

Please note that **xf86-video-cyrix** and **xf86-video-nsc** are no longer maintained and most software distributions no longer ship them. We have set a milestone to import GX1 support into **geode** then deprecate **cyrix** and **nsc**. See below for details. Help is welcome!

### Release 2.11.19 (published on 2016-12-12)

This release restores compatibility with xserver-1.19.

### Development Roadmap

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

#### 2.11.20

Next bug fix release. Release date unknown. Please link to specific patches on the [[X.Org Bugzilla|https://bugs.freedesktop.org/buglist.cgi?query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Driver/geode&product=xorg]] that you think should be reviewed for inclusion. 
[[!table header="no" class="mointable" data="""
**Feature** | **Developer** | **Status** | **Notes** 
 DDC pin bit-banging | OPEN | Planned | [[X.Org #22100|https://bugs.freedesktop.org/show_bug.cgi?id=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 | [[X.Org #2737|https://bugs.freedesktop.org/show_bug.cgi?id=2737]], [[X.Org #2088|https://bugs.freedesktop.org/show_bug.cgi?id=2088]] 
Port to Linux >= 2.6.30 kernel mode setting (KMS) | OPEN | Planned |  
"""]]

## Support

### IRC Channel

Developers can sometimes be found on #geode on the Freenode network.

### 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]] 

### Bug Trackers

* **[[X.Org|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]]** — Preferably submit bug reports directly to this tracker.
* [[Debian|http://bugs.debian.org/xserver-xorg-video-geode]] 
* [[Fedora|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]] 
* [[Gentoo|https://bugs.gentoo.org/buglist.cgi?quicksearch=x11-drivers%2Fxf86-video-geode]]
* [[Ubuntu|https://bugs.launchpad.net/ubuntu/+source/xserver-xorg-video-geode]] 

## Known Issues

### 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). 

### 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. 

### 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. 

## 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 

## Contributors

* Maarten Lankhorst (Ubuntu)
* Martin-Éric Racine (Debian) 
* Mart Raudsepp (Gentoo) 

### Previous Contributors

* Chris Ball (OLPC) 
* Jordan Crouse (AMD) 
* Hunk Cui (AMD) 
* Daniel Drake (OLPC) 
* Frank Huang (AMD) 
* Bernardo Innocenti (OLPC) 
* Adam Jackson (Red Hat) 
* Priit Laes (Gentoo) 
* Gideon Romm (Symbio Technologies) 
* Otavio Salvador (Debian) 
* Warren Togami (Red Hat) 
* Bart Trojanowski (Symbio Technologies) 

## X.Org HOWTO

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