NAME

radeonhd - AMD GPG (ATI) R5xx/R6xx/R7xx video driver

SYNOPSIS

Section"Device"Identifier"devname"Driver"radeonhd"
...
EndSection

DESCRIPTION

radeonhd is an Xorg driver for AMD GPG (ATI) R5xx/R6xx/R7xx based video
cards.
At the time of this writing, radeonhd 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 fglrx driver, radeonhd 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.

CONFIGURATIONDETAILS

Please refer to xorg.conf(5) for general configuration details.
This section only covers configuration options specific to this driver,
for Section"Device". Some options may be deprecated and considered to
be removed or replaced by better implementations soon.
Option"AccelMethod""none|default|shadowfb|xaa|exa"
Use the indicated accleration method.
none does not accelerate anything at all. Discouraged.
shadowfb is a software-only acceleration technique. Does not
work together with DRI at the moment.
xaa is the older but stable hardware-based acceleration
technique.
exa is the newer but more experimental hardware-based
acceleration technique.
The default is dependingonthechipset, driver version, and
state of acceleration techniques and tries to give the best user
experience.
Rotation isn’t supported for the AccelMethods "none" and
"shadowfb".
Option"DRI"
Use this option to enable 3D and Xv acceleration using DRI.
Currently, the default is on on R5xx and RS6xx chips, and off on
all others.
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 is 10%.
Option"ScaleType""none|center|scale|scale_keep_aspect_ratio|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.
none 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.
center 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.
scale means to always scale to the resolution of the external
display filling the entire panel.
scale_keep_aspect_ratio
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.
default keeps the aspect ratio, but does not to scale
otherwise.
The default is to keep the aspect ratio.
Option"NoRandr"
Disable RandR 1.2 support. This turns the driver back to use
standard modesetting behavior. The default is to enable 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
off.
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 off.
Option"UnverifiedFeatures""boolean"
The radeonhd 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"RandRmodesettingonly.
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 list-of-outputs. Typically only the
first (primary) output has to be listed, remaining outputs are
added automatically. The default is none.
Option"IgnoreConnector""string"Standard(non-RandR)modesettingonly.
Connector to be ignored during non-RandR modesetting. The
default is none.
Option"UseConfiguredMonitor""boolean"Standard(non-RandR)modesettingonly.
Use or ignore the monitor section in xorg.conf. In standard
modesetting radeonhd 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 off (i.e. ignore).
Option"NoAccel"
Disable all hardware acceleration. The default is to enable
hardware acceleration.
NOTE: Use of this option is considered deprecated. The
AccelMethod 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.
Auto Select method depending on chipset and board
Off Don’t use HPD pins. Some connectors might not be able to
detect connections at all
Normal Use connector table information as-is
Swap Swap HPD pin 1 and 2 in connector table
NOTE: 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 Auto.
Option"ForceDPI""integer"
Force the use of the specified pixel density in Dots Per Inch.
The default is tousethemonitorsuppliedvalues.
NOTE: 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 chipsetdependent.
NOTE: 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 mailing list.
Option"Audio""boolean"
This option enables the audio hardware, which is responsible for
delivering audio data to the different HDMI capable conntectors
and used to communicate with the audio driver of the operation
system. The default is off.
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 <output_transmitter>=on|off. Possible values
for <output_transmitter> are: TMDS_A,TMDS_B,UNIPHY_A,UNIPHY_B,AtomOutputTMDSA,AtomOutputLVTMA,AtomOutputKldskpLvtma,AtomOutputUniphyA,AtomOutputUniphyB.
The log file should be consulted on which ones to use. The line:
Option"Coherent""TMDS_A=offTMDS_B=on" will set coherent mode
to off for TMDS A and to on for TMDS B. The default for all
outputs is off.
Option"TVMode""tv-mode"
The TV standard to use on the TV output.
NTSCNTSCJPALPALMPALCNPALNPAL60SECAMCV Composite Video
NOTE: This option isn’t implemented yet and has no effect.

RANDROUTPUTPROPERTIES

The following properties can be queried with xrandr--prop 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.
SignalFormat Read-Only
Type: string
Range/List: unknown VGA TMDS LVDS DisplayPort
Signal format / physical protocol format that is used for the
specified output.
ConnectorType Read-Only Static
Type: string
Range/List: unknown VGA DVI DVI-I DVI-A DVI-D HDMI Panel
DisplayPort
Connector type, as far as known to the driver. Panel describes
laptop-internal (normally LVDS) displays.
ConnectorNumber Read-Only Static
Type: int32
Range/List: 0-
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 connectivity.
_OutputNumber Read-Only Static
Type: int32
Range/List: 0-
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 unknown.
_PanningAreaType: string
Format: <width>x<height>[+<xoffset>+<yoffset>]
Specifies the panning area in RandR mode per output.
It actually is a Crtc-specific property, but RandR doesn’t
support that yet. As the xrandr application typically always
resets the framebuffer size with every action, --fb
<width>x<height> 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.
NOTE: Use of this option is considered deprecated. The driver
supports RandR1.3 panning, which is included in Xserver 1.6.
It is considerable more flexible, and should support rotated
pans.
_BacklightType: int32
Range/List: 0-255
Specifies the backlight intensity on laptop panels, if
controlable by the driver.
_CoherentType: int32
Range/List: 0-1
Sets the coherent flag for TMDS signals. See also OptionCoherent.

KNOWNBUGS

As the radeonhd 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
https://bugs.freedesktop.org/query.cgi?product=xorg&component=Driver/radeonhd
and the mailing list archives at http://lists.opensuse.org/radeonhd/
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 updating xrandr(1).
Alternatively, you can try to always specify different CRTCs for all
monitors by explicitly selecting them with --crtc[0|1] on the
xrandr(1) command line.