.\" radeonhd.man based on formatting used in the xf86-video-{ati,nv} radeon.man, nv.man .\" shorthand for double quote that works everywhere. .ds q \N'34' .\" .\" .TH RADEONHD __drivermansuffix__ __vendorversion__ .\" .\" .SH NAME radeonhd \- AMD GPG (ATI) R5xx/R6xx video driver .\" .\" .SH SYNOPSIS .nf .B "Section \*qDevice\*q" .BI " Identifier \*q" devname \*q .B " Driver \*qradeonhd\*q" \ \ ... .B EndSection .fi .\" .\" .SH DESCRIPTION .B radeonhd is an __xservername__ driver for AMD GPG (ATI) R5xx/R6xx based video cards. .B "RADEONHD is still very much work in progress." At the time of this writing, .B radeonhd has the following major limitations: .\".TP "\w'\fB\(bu\fR'u+1n" .TP 2 \(bu .B NO support for 2D & 3D acceleration, no support for Xvideo. .TP \(bu No TV, Component, and HDMI connector support so far. .TP \(bu Suspend & Resume is pretty much untested. Often it just works, but your milage may vary. .TP \(bu After using the .I fglrx driver, the display can get very jittery with .BR radeonhd . Also suspend & resume will probably fail. A reboot fixes this problem in most cases, sometimes a powercycle is necessary. Unloading the kernel module is typically not enough. .PP A more up-to-date list can be found on the wiki page. .PP .\" .SH SUPPORTED HARDWARE The .B radeonhd driver supports video cards based on the following ATI chips: .\" The following list was generated from "X -logverbose 7" by the following command: .\" sed -n '/^\t[RM][A-Z0-9]\+ * : /{ s/\.$//; s/^\t\([A-Z0-9]\+\) \+: \(.*\)/.TP 8\n.B \1\n\2/; p};' /var/log/Xorg.0.log .\" TODO: Note that this line doesn't deal with multi-line output correctly .\" The list replicates the output of RHDIdentify() in src/rhd_id.c. .PP .PD 0 .TP 8 .B RV505 Radeon X1550, X1550 64bit .TP 8 .B RV515 Radeon X1300, X1550, X1600; FireGL V3300, V3350 .TP 8 .B RV516 Radeon X1300, X1550, X1550 64-bit, X1600; FireMV 2250 .TP 8 .B R520 Radeon X1800; FireGL V5300, V7200, V7300, V7350 .TP 8 .B RV530 Radeon X1300 XT, X1600, X1600 Pro, X1650; FireGL V3400, V5200 .TP 8 .B RV535 Radeon X1300, X1650 .TP 8 .B RV550 Radeon X2300 HD .TP 8 .B RV560 Radeon X1650 .TP 8 .B RV570 Radeon X1950, X1950 GT; FireGL V7400 .TP 8 .B R580 Radeon X1900, X1950; AMD Stream Processor .TP 8 .B R600 Radeon HD 2900 GT/Pro/XT; FireGL V7600/V8600/V8650 .TP 8 .B RV610 Radeon HD 2350, HD 2400 Pro/XT, HD 2400 Pro AGP; FireGL V4000 .TP 8 .B RV620 Radeon HD 3450, HD 3470 .TP 8 .B RV630 Radeon HD 2600 LE/Pro/XT, HD 2600 Pro/XT AGP; Gemini RV630; FireGL V3600/V5600 .TP 8 .B RV635 Radeon HD 3650, HD 3670 .TP 8 .B RV670 Radeon HD 3850, HD 3870, FireGL V7700 .TP 8 .B R680 Radeon HD 3870 X2 .TP 8 .B M52 Mobility Radeon X1300 .TP 8 .B M54 Mobility Radeon X1400; M54-GL .TP 8 .B M56 Mobility Radeon X1600; Mobility FireGL V5200 .TP 8 .B M58 Mobility Radeon X1800, X1800 XT; Mobility FireGL V7100, V7200 .TP 8 .B M62 Mobility Radeon X1350 .TP 8 .B M64 Mobility Radeon X1450, X2300 .TP 8 .B M66 Mobility Radeon X1700, X1700 XT; FireGL V5250 .TP 8 .B M68 Mobility Radeon X1900 .TP 8 .B M71 Mobility Radeon HD 2300 .TP 8 .B M72 Mobility Radeon HD 2400; Radeon E2400 .TP 8 .B M74 Mobility Radeon HD 2400 XT .TP 8 .B M76 Mobility Radeon HD 2600; (Gemini ATI) Mobility Radeon HD 2600 XT .TP 8 .B M82 Mobility Radeon HD 3400 .TP 8 .B M86 Mobility Radeon HD 3600 .TP 8 .B RS600 Radeon Xpress 1200, Xpress 1250 .TP 8 .B RS690 Radeon X1200, X1250, X1270 .PD .\" .\" .PP .SH CONFIGURATION DETAILS Please refer to __xconfigfile__(__filemansuffix__) for general configuration details. This section only covers configuration options specific to this driver. Some options may be deprecated and considered to be removed or replaced by better implementations soon. .\" .TP .BI "Option \*qSWcursor\*q \*q" boolean \*q Enable or disable the software cursor. The hardware cursor is inactive when the software cursor is enabled. The default is .BR off . .TP .BI "Option \*qAccelMethod\*q \*q" none|default|shadowfb|xaa|exa \*q Use the indicated accleration method. The .B default is depending on chipset version and state of acceleration techniques and tries to give the best user experience. .B shadowfb is a software-only acceleration technique, while .B xaa and .B exa are hardware-based acceleration techniques. .br .TP .BI "Option \*qNoRandr\*q Disable RandR 1.2 support. This turns the driver back to use standard modesetting behavior. The default is to .B enable RandR 1.2 support. .TP .BI "Option \*qForceReduced\*q \*q" boolean \*q 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 .BR off . .TP .BI "Option \*qHPD\*q \*q" "hpd-mode" \*q 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. .RS .TP 8 .PD 0 .B Auto Select method depending on chipset and board .TP .B Off Don't use HPD pins. Some connectors might not be able to detect connections at all .TP .B Normal Use connector table information as-is .TP .B Swap Swap HPD pin 1 and 2 in connector table .RE .RS .PD .PP .B 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 .BR Auto . .RE .TP .BI "Option \*qOffscreenSize\*q \*q" M|% \*q 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 .BR 10% . .TP .BI "Option \*qRROutputOrder\*q \*q" "list-of-outputs" \*q .IR "RandR modesetting only" . .br 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 .IR list-of-outputs . Typically only the first (primary) output has to be listed, remaining outputs are added automatically. The default is .BR none . .TP .BI "Option \*qIgnoreConnector\*q \*q" string \*q .IR "Standard (non-RandR) modesetting only" . .br Connector to be ignored during non-RandR modesetting. The default is .BR none . .TP .BI "Option \*qUseConfiguredMonitor\*q \*q" boolean \*q .IR "Standard (non-RandR) modesetting only" . .br Use or ignore the monitor section in .IR xorg.conf . In standard modesetting .B 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 .B off (i.e. ignore). .TP .BI "Option \*qNoAccel\*q Disable all hardware acceleration. The default is to .B enable hardware acceleration. .br .B NOTE: Use of this option is considered deprecated. The .B AccelMethod option is considered to be more flexible. .TP .BI "Option \*qShadowFB\*q \*q" boolean \*q Enable or disable shadow framebuffer support. This greatly improves the speed of unaccelerated drivers. The default depends on chipset and acceleration state. .br .B NOTE: Use of this option is considered deprecated. The .B AccelMethod option is considered to be more flexible. .TP .BI "Option \*qRRUseXF86Edid\*q \*q" boolean \*q .IR "RandR modesetting only" . .br Enable or disable the use of xf86OutputGetEDID() and xf86OutputGetEDIDModes() instead of the default routines from .BR radeonhd , which are better adapted to the chipset. Panels will often fail to work with these calls. The default is .BR off . .br .B NOTE: Use of this option is considered deprecated. Report to the mailing list if this is needed for your configuration. .RE .\" .\" .SH RANDR OUTPUT PROPERTIES The following properties can be queried with .B xrandr --prop and some of them can be set with .BR "xrandr --output" " " --set " ." Those marked with RR13 are probably merged into a RandR 1.3 standard. Properties marked Read-Only are provided by the driver for informational purpose only, those marked Static won't change during runtime. .TP .BR RANDR_SIGNAL_FORMAT " Read-Only RR13" .RS .TP 16 .PD 0 .IR Type : string .TP .IR Range/List : unknown VGA TMDS LVDS FBAS FBAS-PAL FBAS-NTSC FBAS-SECAM SVideo YPbPr DisplayPort .RE .RS .PD .PP Signal format / physical protocol format that is used for the specified output. .br A driver MAY change this property of an output if the underlying hardware indicates a protocol change (e.g. TV formats). Values with dashes .RI ( FBAS-PAL ) describe more specific versions of the base values .RI ( FBAS ) and SHOULD be used if known to the driver. .RE .TP .BR RANDR_CONNECTOR_TYPE " Read-Only Static RR13" .RS .TP 16 .PD 0 .IR Type : string .TP .IR Range/List : unknown VGA DVI DVI-I DVI-A DVI-D HDMI PANEL TV TV-FBAS TV-SVideo TV-YPbPr TV-SCART TV-C4 DisplayPort .RE .RS .PD .PP Connector type, as far as known to the driver. .br Values with dashes .RI ( TV-FBAS ) describe more specific versions of the base values .RI ( TV ). The former SHOULD be used if the connector is not capable of producing other signal formats. The later SHOULD be used if the exact connector is unknown, or the connector is a multi-format connector that is not described otherwise. .IR DVI , for instance, SHOULD be handled like a .I DVI-I connector, unless additional information is available to the user agent. .I PANEL describes laptop-internal (normally LVDS) displays. .IR TV , .IR TV-SCART , .IR TV-YPbPr , and .I TV-C4 with signal format .I VGA are valid combinations and describe RGB TV signals. .RE .TP .BR RANDR_CONNECTOR_NUMBER " Read-Only Static RR13" .RS .TP 16 .PD 0 .IR Type : int32 .TP .IR Range/List : 0- .RE .RS .PD .PP 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. 1 is called the primary connector, 2 the secondary. 3 is often a TV connector, but that is completely driver / hardware dependent. .br Outputs with the same connector number SHOULD have the same connector type. Meaning and client behavior for mismatching connector types is undefined at the moment. .RE .TP .BR RANDR_OUTPUT_NUMBER " Read-Only Static RR13" .RS .TP 16 .PD 0 .IR Type : int32 .TP .IR Range/List : 0- .RE .RS .PD .PP 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. .br Internal outputs are numbered from 1, 0 indicates that output routing is unknown. .RE .TP .B RANDR_PANNING_AREA .RS .TP 16 .PD 0 .IR Type : string .TP .IR Format : .RB x [ + + ] .RE .RS .PD .PP Specifies the panning area in RandR mode per output. .br It actually is a Crtc-specific property, but RandR doesn't support that yet. As the .B xrandr application typically always resets the framebuffer size with every action, .BR --fb " " x has to be added on every invocation, unless there is an additional output configured that is using this size as its resolution. .\" .\" .SH KNOWN BUGS As the .B radeonhd driver is still in an early stage of development, many non-obvious things do 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 .br .nf \%https://bugs.freedesktop.org/query.cgi?product=xorg&component=Driver/radeonhd .br .fi and the mailing list archives at \%http://lists.opensuse.org/radeonhd/ .PP radeonhd development caused a few bugs in __xservername__ and a number of bugs in xrandr(__appmansuffix__) to be discovered. If you are using xrandr(__appmansuffix__) versions older than 2007-11-10, you should try updating xrandr(__appmansuffix__). .br Alternatively, you can try to always specify different CRTCs for all monitors by explicitly selecting them with .I --crtc [0|1] on the xrandr(__appmansuffix__) command line. .\" .\" .SH SEE ALSO __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__) .IP " 1." 4 The official radeonhd wiki .RS 4 \%http://wiki.x.org/wiki/radeonhd .RE .IP " 2." 4 The radeonhd mailing list .RS 4 \%http://lists.opensuse.org/radeonhd/ .RE .IP " 3." 4 Overview about radeonhd development code .RS 4 \%http://gitweb.freedesktop.org/?p=xorg/driver/xf86-video-radeonhd .RE .IP " 4." 4 Query the bugtracker for radeonhd bugs .RS 4 .nf \%https://bugs.freedesktop.org/query.cgi?\:product=\:xorg&\:component=\:Driver/radeonhd .fi .RE .\" .\" .SH AUTHORS Driver written by Egbert Eich, Luc Verhaegen, Matthias Hopf, and others. .PP Man page written by Hans Ulrich Niedermann, Matthias Hopf, and others. .\" vim: syntax=nroff