radeonhd - the X.org X11 driver for AMD GPG r5xx/r6xx chipsets ============================================================== radeonhd is the X.org X11 driver for AMD GPG (ATI) r5xx/r6xx chipsets. Main development is driven by Novell at the time of writing, in close relationship to AMD which provides free documentation for the chipsets. More detailed notes about * supported chipsets * radeonhd driver options * troubleshooting are available in the included radeonhd(4) man page. Further information about * known radeonhd bugs & limitations * frequently asked questions (FAQ) * how to configure RandR * configuration examples is available on the wiki at http://wiki.x.org/wiki/radeonhd This README file contains the following sections: * Recent changes * More Resources * Installation * Common problems during builds * Getting and updating the radeonhd source code * Feeding back source code Major Changes ============= Read ChangeLog for a complete list. - Version 1.1.0 - Added Support for RS600, preliminary RV670. - Allow panning in RandR mode. - Preliminary (read: untested) support for HDMI connectors. - Lots of bugfixes, e.g. - Better monitor detection. - Gamma + palette fixes. - Mode stability + textmode restore. - RandR mode selection fixes. - Version 1.0.0 - First released version. - Full modesetting driver, capable of driving multiple monitors. - Support for VGA, DVI, DMS-59, and laptop panels. - Support for monitor hotplug detection, DDC, and dynamic reconfiguration. - Full RandR 1.2 compatibility. - AtomBIOS support for initialization, data tables, etc. - Early RandR 1.3 property support (subject to change). - Hardware cursor support. - No 2D & 3D acceleration, no XVideo yet. No TV, Component, and HDMI yet. More Resources ============== The official radeonhd wiki: http://wiki.x.org/wiki/radeonhd The mailing list on radeonhd: http://lists.opensuse.org/radeonhd/ Overview over recent updates to radeonhd: http://gitweb.freedesktop.org/?p=xorg/driver/xf86-video-radeonhd The git repository with the radeonhd source code: git://anongit.freedesktop.org/git/xorg/driver/xf86-video-radeonhd Report bugs at: https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver/radeonhd Installation ============ With X.Org 7.0 and later: $ ./autogen.sh $ make $ make install This will litter all kinds of compiled files throughout your source tree. With X.Org prior to 7.0: $ xmkmf -a $ make EXTRA_INCLUDES="-I/usr/include/xorg" all $ make install This uses imake and is for compatibility with older systems. To avoid building in your source tree, do: $ mkdir _b && cd _b $ ../autogen.sh $ make $ make install Runs the build in _b/ - and if something is completely messed up, you can safely remove the _b/ directory and create a new one without affecting any source files. Hint: If you happen to have multiple branches in your git source tree, you can have per-branch _b-BRANCH/ build trees and _i-BRANCH/ install trees. ("... configure/autogen.sh ... --prefix=$PWD/_i-BRANCH") Note that none of these methods will install the rhd_conntest tool. The "xmkmf" method always requires a separate "make" run in utils/conntest. The other two will build rhd_conntest by default if its requirements are met. Common problems during builds ============================= Problem: -------- ,----[ output of ./autogen.sh ]---- |autoreconf: running: /usr/bin/autoconf |configure.ac:35: error: possibly undefined macro: XORG_DRIVER_CHECK_EXT | If this token and others are legitimate, please use m4_pattern_allow. | See the Autoconf documentation. |autoreconf: /usr/bin/autoconf failed with exit status: 1 `---- Solution: --------- Your system lacks one or more of these files in /usr/share/aclocal: xorg-macros.m4 xorg-server.m4 xorgversion.m4 Make sure you have all required X.org development packages installed. These may be called xorg-dev, xorg-x11-server-sdk and xorg-x11-util-macros, or something similar. Getting and updating the radeonhd source code ============================================= Released radeonhd tarballs can be downloaded from ftp://ftp.freedesktop.org/pub/individual/driver/ The name of the tarball will be xf86-video-radeonhd-.tar.bz2 The developer version of radeonhd is maintained in the git repository found at git://anongit.freedesktop.org/git/xorg/driver/xf86-video-radeonhd You can find information on using git at the git website http://git.or.cz/ and a short intro at http://www.freedesktop.org/wiki/Infrastructure/git/Developers You can get a copy of the repository like this: $ git clone git://anongit.freedesktop.org/git/xorg/driver/xf86-video-radeonhd This will create a directory xf86-video-radeonhd in the current directory. If you have not made any local changes and want to update you source code with the newest stuff from the official radeonhd repository, you can run this: $ git pull If you HAVE made local changes and committed them locally to your master branch (with "git commit -a"), you will be better off running $ git fetch $ git rebase origin If you're using more branches, or run into a conflict during rebasing, read the git docs. Feeding back source code ======================== You can easily create patches to send to the developers using git. $ vi some_file.c $ git status $ git diff $ git commit -a $ git format-patches origin Then you can sift through the 0*.patch files and choose a few to send to the radeonhd mailing list.