summaryrefslogtreecommitdiff
path: root/GeodeDriver.mdwn
blob: 95720694090ad51bab5825bc27e0034bfac28db1 (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
# 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)
* 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]]