is an Xorg driver for AMD GPG (ATI) R5xx/R6xx/R7xx based video cards.
At the time of this writing,
has the following limitations:
Support for hardware-based 2D acceleration and Xvideo needs more testing on
R6xx and R7xx based cards.
No TV and Component connector support so far.
After using the
might fail to work properly. This combination is not and probably will never be
supported. A reboot fixes problems in most cases, sometimes a powercycle is
necessary. Unloading the kernel module is typically not enough.
A more up-to-date list can be found on the wiki page.
driver supports video cards based on the following ATI chips:
does not accelerate anything at all. Discouraged.
is a software-only acceleration technique. Does not work together with
DRI at the moment.
is the older but stable hardware-based acceleration technique.
is the newer but more experimental hardware-based acceleration technique.
depends on the chipset
and the acceleration techniques available for that chipset, and is chosen to
give the best user experience.
Note that R600 and above require
to be enabled for "exa".
Rotation isn't supported for the AccelMethods "none" and "shadowfb".
Use this option to enable 3D and Xv acceleration using DRI.
Option "OffscreenSize" "<integer>M|<integer>%"
Specify the amount of framebuffer memory used for offscreen pixmaps, in
megabytes or percent of available memory. This amount of memory is not
available for DRI. Certain hardware and software limits apply. The default
Sets the scaling mode for laptop flat panels when used together with an external
screen. The scaling engine is capable of scaling both up and down.
means to not scale at all, i.e. the image will be displayed in the top left
corner of the panel if the resolution of the external display is lower than
the panel resolution.
means not to scale but center the image on the panel i.e. apply a black frame
around the image on the panel if the resolution of the external display is
lower than the panel resolution.
means to always scale to the resolution of the external display filling
the entire panel.
scales the panel display but keeps the aspect ratio of the external display,
which means if the external display has a different aspect ratio than the
panel it black borders will be added to the top and bottom or left and right.
keeps the aspect ratio, but does not to scale otherwise.
is to keep the aspect ratio.
Disable RandR 1.2 support. This turns the driver back to use standard
modesetting behavior. The default is to
RandR 1.2 support.
Option "SWcursor" "boolean"
Enable or disable the software cursor. The hardware cursor is inactive
when the software cursor is enabled. The default is
Option "ForceReduced" "boolean"
Force the use of reduced blanking modes. Use this if your LCD monitor does not
provide correct EDID data and you need a reduced blanking mode to drive a high
resolution mode over a single link DVI connection. The default is
Option "UnverifiedFeatures" "boolean"
driver sometimes relies on unverified graphics card features. You can add
Option "UnverifiedFeatures" "off"
to disable those when you run into difficulties.
Option "RROutputOrder" "list-of-outputs"
RandR modesetting only.
Several legacy application rely on the Xinerama extension to determine the
primary screen. RandR returns the viewport displayed on the first attached
output of the internal table as the first Xinerama screen.
If your outputs are ordered in the wrong way, you can reorder them by adding
their names (separated by spaces or commas) to the
Typically only the first (primary) output has to be listed, remaining
outputs are added automatically. The default is
Option "IgnoreConnector" "string"
Standard (non-RandR) modesetting only.
Connector to be ignored during non-RandR modesetting. The default is
Option "UseConfiguredMonitor" "boolean"
Standard (non-RandR) modesetting only.
Use or ignore the monitor section in
In standard modesetting
ignores the EDID data if a monitor section is configured. This is different
to what most drivers behave like and a common source of configuration problems.
Thus the default is
Disable all hardware acceleration. The default is to
Use of this option is considered deprecated. The
option is considered to be more flexible.
Option "HPD" "auto|off|normal|swap"
Change the use of the hot plug detection (HPD) pins. On R5xx the according
connector tables are often broken and have to be worked around.
Select method depending on chipset and board
Don't use HPD pins. Some connectors might not be able to detect connections
Use connector table information as-is
Swap HPD pin 1 and 2 in connector table
Use of this option is discouraged. Whenever this option is needed to detect
connected monitors correctly, please report to the mailing list.
The default is
Option "ForceDPI" "integer"
Force the use of the specified pixel density in Dots Per Inch.
The default is
to use the monitor supplied values.
Use of this option is discouraged. Monitors should return valid DPI values,
and the Xserver should honour them correctly.
Option "UseAtomBIOS" "boolean"
Selects the mode setting path. The default is
Use of this option is discouraged. The driver should select the right path. If
this option is needed to get your card working correctly, please report to the
Option "Audio" "boolean"
This option enables the audio hardware, which is responsible for delivering audio data
to the different HDMI capable connectors and used to communicate with the audio
driver of the operation system. The default is
Option "HDMI" "string"
Possible values are "DVI-I_0", "DVI-I_1"..,"DVI-D_0","DVI-I_1",.., "all".
This option enables HDMI-Audio and HDMI-Info packets on the specified connector.
This is the only way enabling HDMI at the moment, since decoding E-EDID data
to check if monitor supports HDMI is not implemented (yet).
Option "Coherent" "string"
There are two different ways to program the TMDS encoder in an output
for best signal quality for the transmitter chip used inside a digital
monitor. This option may be used to set the programming for each output
individually. The string is a space separated list of
Possible values for
The log file should be consulted
on which ones to use. The line:
Option "Coherent" "TMDS_A=off TMDS_B=on"
will set coherent mode to
for TMDS A and to
for TMDS B.
The default for all outputs is
Option "TVMode" "tv-mode"
The TV standard to use on the TV output.
This option isn't implemented yet and has no effect.
Option "ForceLowPowerMode" "boolean"
Enable to statically set GPU engine clock to a lower than default value. This
can help reduce power consumption. The default is
Option "LowPowerModeEngineClock" "integer"
Engine clock frequency to use when ForceLowPowerMode is enabled, in Hz. If not
set, the minimum known working frequency is used. If integer is negative,
validation is skipped, and the absolute value is used for the engine clock.
RANDR OUTPUT PROPERTIES
The following properties can be queried with
and some of them can be set with
xrandr --output <output> --set <property> <value> .
Those not starting with an underscore '_' are RandR 1.3 standard properties.
See the RandR 1.3 protocol description for more details. Properties marked
Read-Only are provided by the driver for informational purpose only, those
marked Static won't change during runtime.
unknown VGA TMDS LVDS DisplayPort
Signal format / physical protocol format that is used for the specified
ConnectorType Read-Only Static
unknown VGA DVI DVI-I DVI-A DVI-D HDMI Panel DisplayPort
Connector type, as far as known to the driver.
describes laptop-internal (normally LVDS) displays.
ConnectorNumber Read-Only Static
Outputs that route their signal to the same connector MUST have the same
connector number. Outputs with the same connector number MUST route their
signal to the same connector, except if it is 0, which indicates unknown
_OutputNumber Read-Only Static
A card may route one internal output to several connectors. Connectors that
are driven by the same output cannot be driven by different Crtcs and are thus
only allowed to be used in clone mode. The driver SHOULD emit an error message
and continue as gracefully as possible if using different Crtcs for the same
internal output is requested.
Internal outputs are numbered from 1, 0 indicates that output routing is
Specifies the panning area in RandR mode per output.
It actually is a Crtc-specific property, but RandR doesn't support that yet.
application typically always resets the framebuffer size with every action,
has to be added on every invocation, unless there is an additional output
configured that is using this size as its resolution.
This property cannot be changed when in a rotated mode.
Use of this option is considered deprecated. The driver supports
panning, which is included in Xserver 1.6. It is considerable more flexible,
and should support rotated pans.
Specifies the backlight intensity on laptop panels, if controllable by the driver.
Sets the coherent flag for TMDS signals. See also
On R600 and above, the following XVideo attributes are supported.
to query and set these values at runtime.
Select the Y'CbCr color space of the source video. Accepted values
are 'auto-detect'(0), 'Rec.601'(1), and 'Rec.709'(2).
Rec.709 is the standard which applies to high-definition television
broadcasting and "HD" digital video in general; Rec.601 applies to all
other digital video.
When 'auto-detect' is selected, Rec.709 is used for videos encoded
at least 928px wide, and Rec.601 is used otherwise.
This cut-off is lower than 720p so that the correct color space can be
applied to some media with non-standard resolutions that have high-probability
of having originated from Rec.709 encoded content.
driver is still in development, some non-obvious things might not work yet. A
list of major known bugs is maintained on the wiki. Other places to check for
known bugs and solutions are the bugtracker at
radeonhd development caused a few bugs in Xorg and a number
of bugs in xrandr(1) to be discovered. If you are using
xrandr(1) versions older than 2007-11-10, you should try
Alternatively, you can try to always specify different CRTCs for
all monitors by explicitly selecting them with
on the xrandr(1) command line.