222 lines
6.2 KiB
Plaintext
222 lines
6.2 KiB
Plaintext
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.2.1
|
|
|
|
- Build-fixes for systems without -NDEBUG, and for rhd_dump
|
|
- Added two new RV670 devices.
|
|
|
|
- Version 1.2.0
|
|
|
|
- Added support for RV620, RV635, and R680.
|
|
- Added 2D acceleration for R5xx (including RS6xx), both XAA and EXA.
|
|
- Added support for DDIA block (second digital output) on RS690.
|
|
- Added support for interlaced modes
|
|
- Added additional layers for splitting outputs into encoders and
|
|
transmitters as needed for new hardware.
|
|
- Added support for DragonFly BSD.
|
|
- Improved RandR corner cases.
|
|
- Improved handling of secondary cards.
|
|
- Implemented foundation work for future TV support.
|
|
- Huge number of bugfixes and minor updates.
|
|
|
|
- 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-<version>.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.
|
|
|