RADEONHD(4) | Kernel Interfaces Manual | RADEONHD(4)

# 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.

# SUPPORTED HARDWARE

The radeonhd driver supports video cards based on the following ATI chips:

RV505
  Radeon X1550, X1550 64bit

RV515
  Radeon X1300, X1550, X1600; FireGL V3300, V3350

RV516
  Radeon X1300, X1550, X1550 64-bit, X1600; FireMV 2250

R520
  Radeon X1800; FireGL V5300, V7200, V7300, V7350

RV530
  Radeon X1300 XT, X1600, X1600 Pro, X1650; FireGL V3400, V5200

RV535
  Radeon X1300, X1650

RV550
  Radeon X2300 HD

RV560
  Radeon X1650

RV570
  Radeon X1950, X1950 GT; FireGL V7400

R580
  Radeon X1900, X1950; AMD Stream Processor

R600
  Radeon HD 2900 GT/Pro/XT; FireGL V7600/V8600/V8650

RV610
  Radeon HD 2350, HD 2400 Pro/XT, HD 2400 Pro AGP; FireGL V4000

RV620
  Radeon HD 3450, HD 3470

RV630
  Radeon HD 2600 LE/Pro/XT, HD 2600 Pro/XT AGP; Gemini RV630; FireGL V3600/V5600

RV635
  Radeon HD 3650, HD 3670

RV670
  Radeon HD 3690, 3850, HD 3870, FireGL V7700, FireStream 9170

R680
  Radeon HD 3870 X2

M52
  Mobility Radeon X1300

M54
  Mobility Radeon X1400; M54-GL

M56
  Mobility Radeon X1600; Mobility FireGL V5200

M58
  Mobility Radeon X1800, X1800 XT; Mobility FireGL V7100, V7200

M62
  Mobility Radeon X1350

M64
  Mobility Radeon X1450, X2300

M66
  Mobility Radeon X1700, X1700 XT; FireGL V5250

M68
  Mobility Radeon X1900

M71
  Mobility Radeon HD 2300

M72
  Mobility Radeon HD 2400; Radeon E2400

M74
  Mobility Radeon HD 2400 XT

M76
  Mobility Radeon HD 2600; (Gemini ATI) Mobility Radeon HD 2600 XT

M82
  Mobility Radeon HD 3400

M86
  Mobility Radeon HD 3650, HD 3670, Mobility FireGL V5700

M88
  Mobility Radeon HD 3850, HD 3850 X2, HD 3870, HD3870 X2

RS600
  Radeon Xpress 1200, Xpress 1250

RS690
  Radeon X1200, X1250, X1270

RS740
  RS740, RS740M

RS780
  Radeon HD 3100/3200/3300 Series

R700
  Radeon R700

RV710
  Radeon HD4570, HD4350

RV730
  Radeon HD4670, HD4650

RV740
  Radeon HD4770. EXPERIMENTAL AND UNTESTED

RV770
  Radeon HD 4800 Series; Everest, K2, Denali ATI FirePro

RV790
  Radeon HD 4890

M92
  Mobility Radeon HD4330, HD4530, HD4570. EXPERIMENTAL

M93
  Mobility Radeon M93. EXPERIMENTAL AND UNTESTED

M96
  Mobility Radeon HD4600

M97
  Mobility Radeon HD4860. EXPERIMENTAL AND UNTESTED

M98
  Mobility Radeon HD4850, HD4870

# CONFIGURATION DETAILS

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.

Default value 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 DRI to be enabled for "exa".

Rotation isn't supported for the AccelMethods "none" and "shadowfb".

Option "DRI"
  Use this option to enable 3D and Xv acceleration using DRI. Default is on.

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"
  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 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) modesetting only.
  Connector to be ignored during non-RandR modesetting. The default is none.

Option "UseConfiguredMonitor" "boolean"
  Standard (non-RandR) modesetting only.
  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 to use the monitor supplied values.

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 chipset dependent.

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 connectors 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=off TMDS_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.

  NTSC

NTSCJ

PAL

PALM

PALCN

PALN

PAL60

SECAM

CV
  Composite Video

NOTE: 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 off.

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 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.

_PanningArea

  Type: 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 RandR 1.3 panning, which is included in Xserver 1.6. It is considerable more flexible, and should support rotated pans.

Backlight

  Type: int32

Range/List:
  0-255

Specifies the backlight intensity on laptop panels, if controllable by the driver.

_Coherent

  Type: int32

Range/List:
  0-1

Sets the coherent flag for TMDS signals. See also Option Coherent.

# XVIDEO ATTRIBUTES

On R600 and above, the following XVideo attributes are supported. Use xvattr to query and set these values at runtime.

XV_COLORSPACE
  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.

Default is 'auto-detect'(0).

# KNOWN BUGS

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.

# SEE ALSO

Xorg(1), xorg.conf(5), Xserver(1), X(7)

1.
  The official radeonhd wiki

http://wiki.x.org/wiki/radeonhd

2.
  The radeonhd mailing list

http://lists.opensuse.org/radeonhd/

3.
  Overview about radeonhd development code

http://cgit.freedesktop.org/xorg/driver/xf86-video-radeonhd/

4.
  Query the bugtracker for radeonhd bugs

https://bugs.freedesktop.org/query.cgi?:product=:xorg&:component=:Driver/radeonhd

# AUTHORS

Egbert Eich, Luc Verhaegen, Matthias Hopf, Hans Ulrich Niedermann, Christian Koenig, Alexander Deucher, and others.

X Version 11 |