1RADEON(4) Kernel Interfaces Manual RADEON(4)
2
6 radeon - ATI RADEON video driver
7
9 Section "Device"
10 Identifier "devname"
11 Driver "radeon"
12 ...
13 EndSection
14
16 radeon is an Xorg driver for ATI RADEON based video cards with the fol‐
17 lowing features:
18 · Full support for 8, 15, 16 and 24 bit pixel depths;
20 · RandR 1.2 and RandR 1.3 support;
21 · TV-out support (only on R/RV/RS1xx, R/RV/RS2xx, R/RV/RS3xx. Experi‐
22 mental support on R/RV5xx, R/RV6xx, and R/RV7xx through the ATOMTvOut
23 option);
24 · Full EXA 2D acceleration;
25 · Full XAA 2D acceleration (only on R/RV/RS1xx, R/RV/RS2xx, R/RV/RS3xx,
26 R/RV/RS4xx, R/RV5xx, RS6xx. XAA Render acceleration supported only on
27 R/RV100, R/RV/RS2xx and RS3xx);
28 · Textured XVideo acceleration including anti-tearing support (Bicubic
29 filtering only available on R/RV3xx, R/RV/RS4xx, R/RV5xx, and
30 RS6xx/RS740);
31 · Overlay XVideo acceleration (only on R/RV/RS1xx, R/RV/RS2xx,
32 R/RV/RS3xx, R/RV/RS4xx);
33 · 3D acceleration;
34
36 The radeon driver supports PCI, AGP, and PCIE video cards based on the
37 following ATI chips:
38 R100 Radeon 7200
40 RV100 Radeon 7000(VE), M6, RN50/ES1000
41 RS100 Radeon IGP320(M)
42 RV200 Radeon 7500, M7, FireGL 7800
43 RS200 Radeon IGP330(M)/IGP340(M)
44 RS250 Radeon Mobility 7000 IGP
45 R200 Radeon 8500, 9100, FireGL 8800/8700
46 RV250 Radeon 9000PRO/9000, M9
47 RV280 Radeon 9200PRO/9200/9200SE/9250, M9+
48 RS300 Radeon 9100 IGP
49 RS350 Radeon 9200 IGP
50 RS400/RS480 Radeon XPRESS 200(M)/1100 IGP
51 R300 Radeon 9700PRO/9700/9500PRO/9500/9600TX, FireGL X1/Z1
52 R350 Radeon 9800PRO/9800SE/9800, FireGL X2
53 R360 Radeon 9800XT
54 RV350 Radeon 9600PRO/9600SE/9600/9550, M10/M11, FireGL T2
55 RV360 Radeon 9600XT
56 RV370 Radeon X300, M22
57 RV380 Radeon X600, M24
58 RV410 Radeon X700, M26 PCIE
59 R420 Radeon X800 AGP
60 R423/R430 Radeon X800, M28 PCIE
61 R480/R481 Radeon X850 PCIE/AGP
62 RV505/RV515/RV516/RV550
63 Radeon X1300/X1400/X1500/X2300
64 R520 Radeon X1800
65 RV530/RV560 Radeon X1600/X1650/X1700
66 RV570/R580 Radeon X1900/X1950
67 RS600/RS690/RS740
68 Radeon X1200/X1250/X2100
69 R600 Radeon HD 2900
70 RV610/RV630 Radeon HD 2400/2600
71 RV620/RV635 Radeon HD 3450/3470
72 RV670 Radeon HD 3850/3870
73 RS780 Radeon HD 3100/3200/3300
74 RV710 Radeon HD 4350/4550
75 RV730 Radeon HD 4650/4670
76 RV770 Radeon HD 4850/4870
77
79 Please refer to xorg.conf(5) for general configuration details. This
80 section only covers configuration details specific to this driver.
81 The driver auto-detects all device information necessary to initialize
83 the card. However, if you have problems with auto-detection, you can
84 specify:
85 VideoRam - in kilobytes
87 MemBase - physical address of the linear framebuffer
88 IOBase - physical address of the MMIO registers
89 ChipID - PCI DEVICE ID
90 In addition, the following driver Options are supported:
92 Option "SWcursor" "boolean"
94 Selects software cursor. The default is off.
95 Option "NoAccel" "boolean"
97 Enables or disables all hardware acceleration.
98 The default is to enable hardware acceleration.
99 Option "Dac6Bit" "boolean"
101 Enables or disables the use of 6 bits per color component when
102 in 8 bpp mode (emulates VGA mode). By default, all 8 bits per
103 color component are used.
104 The default is off.
105 Option "VideoKey" "integer"
107 This overrides the default pixel value for the YUV video overlay
108 key.
109 The default value is 0x1E.
110 Option "ScalerWidth" "integer"
112 This sets the overlay scaler buffer width. Accepted values range
113 from 1024 to 2048, divisible by 64, values other than 1536 and
114 1920 may not make sense though. Should be set automatically, but
115 noone has a clue what the limit is for which chip. If you think
116 quality is not optimal when playing back HD video (with horizon‐
117 tal resolution larger than this setting), increase this value,
118 if you get an empty area at the right (usually pink), decrease
119 it. Note this only affects the "true" overlay via xv, it won't
120 affect things like textured video.
121 The default value is either 1536 (for most chips) or 1920.
122 Option "AGPMode" "integer"
124 Set AGP data transfer rate. (used only when DRI is enabled)
125 1 -- 1x (before AGP v3 only)
126 2 -- 2x (before AGP v3 only)
127 4 -- 4x
128 8 -- 8x (AGP v3 only)
129 others -- invalid
130 The default is to leave it unchanged.
131 Option "AGPFastWrite" "boolean"
133 Enable AGP fast writes. Enabling this is frequently the cause
134 of instability. Used only when the DRI is enabled. If you enable
135 this option you will get *NO* support from developers.
136 The default is off.
137 Option "BusType" "string"
139 Used to replace previous ForcePCIMode option. Should only be
140 used when driver's bus detection is incorrect or you want to
141 force a AGP card to PCI mode. Should NEVER force a PCI card to
142 AGP bus.
143 PCI -- PCI bus
144 AGP -- AGP bus
145 PCIE -- PCI Express bus
146 (used only when DRI is enabled)
147 The default is auto detect.
148 Option "DisplayPriority" "string"
150 Used to prevent flickering or tearing problem caused by display
151 buffer underflow.
152 AUTO -- Driver calculated (default).
153 BIOS -- Remain unchanged from BIOS setting.
154 Use this if the calculation is not correct
155 for your card.
156 HIGH -- Force to the highest priority.
157 Use this if you have problem with above options.
158 This may affect performance slightly.
159 The default value is AUTO.
160 Option "ColorTiling" "boolean"
162 Frame buffer can be addressed either in linear or tiled mode.
163 Tiled mode can provide significant performance benefits with 3D
164 applications, for 2D it shouldn't matter much. Tiling will be
165 disabled if the virtual x resolution exceeds 2048 (3968 for R300
166 and above), or if DRI is enabled the drm module is too old.
167 If this option is enabled, a new dri driver is required for
168 direct rendering too.
169 Color tiling will be automatically disabled in interlaced or
170 doublescan screen modes.
171 The default value is on.
172 Option "IgnoreEDID" "boolean"
174 Do not use EDID data for mode validation, but DDC is still used
175 for monitor detection. This is different from NoDDC option.
176 The default value is off.
177 Option "CustomEDID" "string"
179 Forces the X driver to use the EDID data specified in a file
180 rather than the display's EDID. Also overrides DDC monitor
181 detection.
182 You may specify a semicolon separated list of output name and
183 filename pairs with an optional flag, "digital" or "analog", to
184 override the digital bit in the edid which is used by the driver
185 to determine whether to use the analog or digital encoder asso‐
186 ciated with a DVI-I port. The output name is the randr output
187 name, e.g., "VGA-0" or "DVI-0"; consult the Xorg log for the
188 supported output names of any given system.
189 The file must contain a raw 128-byte EDID block, as captured by
190 get-edid.
191 For example: Option "CustomEDID" "VGA-0:/tmp/edid1.bin;
192 DVI-0:/tmp/edid2.bin:digital" will assign the EDID from the file
193 /tmp/edid1.bin to the output device VGA-0, and the EDID from the
194 file /tmp/edid2.bin to the output device DVI-0 and force the DVI
195 port to use the digital encoder.
196 Note that a output name must always be specified, even if only
197 one EDID is specified.
198 Caution: Specifying an EDID that doesn't exactly match your dis‐
199 play may damage your hardware, as it allows the driver to spec‐
200 ify timings beyond the capabilities of your display. Use with
201 care.
202 Option "PanelSize" "string"
204 Should only be used when driver cannot detect the correct panel
205 size. Apply to both desktop (TMDS) and laptop (LVDS) digital
206 panels. When a valid panel size is specified, the timings col‐
207 lected from DDC and BIOS will not be used. If you have a panel
208 with timings different from that of a standard VESA mode, you
209 have to provide this information through the Modeline.
210 For example, Option "PanelSize" "1400x1050"
211 The default value is none.
212 Option "EnablePageFlip" "boolean"
214 Enable page flipping for 3D acceleration. This will increase
215 performance but not work correctly in some rare cases, hence the
216 default is off. It is currently only supported on R/RV/RS4xx
217 and older hardware.
218 Option "ForceMinDotClock" "frequency"
220 Override minimum dot clock. Some Radeon BIOSes report a minimum
221 dot clock unsuitable (too high) for use with television sets
222 even when they actually can produce lower dot clocks. If this is
223 the case you can override the value here. Note that using this
224 option may damage your hardware. You have been warned. The fre‐
225 quency parameter may be specified as a float value with standard
226 suffixes like "k", "kHz", "M", "MHz".
227 Option "RenderAccel" "boolean"
229 Enables or disables hardware Render acceleration. It is sup‐
230 ported on all Radeon cards when using EXA acceleration and on
231 Radeon R/RV/RS1xx, R/RV/RS2xx and RS3xx when usig XAA. The
232 default is to enable Render acceleration.
233 Option "AccelMethod" "string"
235 Chooses between available acceleration architectures. Valid
236 options are XAA and EXA. XAA is the traditional acceleration
237 architecture and support for it is very stable. EXA is a newer
238 acceleration architecture with better performance for the Render
239 and Composite extensions. The default is EXA.
240 Option "AccelDFS" "boolean"
242 Use or don't use accelerated EXA DownloadFromScreen hook when
243 possible (only when Direct Rendering is enabled, e.g.).
244 Default: off with AGP due to issues with GPU->host transfers
245 with some AGP bridges, on otherwise.
246 Option "FBTexPercent" "integer"
248 Amount of video RAM to reserve for OpenGL textures, in percent.
249 With EXA, the remainder of video RAM is reserved for EXA off‐
250 screen management. Specifying 0 results in all offscreen video
251 RAM being reserved for EXA and only GART memory being available
252 for OpenGL textures. This may improve EXA performance, but
253 beware that it may cause problems with OpenGL drivers from Mesa
254 versions older than 6.4. With XAA, specifying lower percentage
255 than what gets reserved without this option has no effect, but
256 the driver tries to increase the video RAM reserved for textures
257 to the amount specified roughly. Default: 50.
258 Option "DepthBits" "integer"
260 Precision in bits per pixel of the shared depth buffer used for
261 3D acceleration. Valid values are 16 and 24. When this is 24,
262 there will also be a hardware accelerated stencil buffer, but
263 the combined depth/stencil buffer will take up twice as much
264 video RAM as when it's 16. Default: The same as the screen
265 depth.
266 Option "DMAForXv" "boolean"
268 Try or don't try to use DMA for Xv image transfers. This will
269 reduce CPU usage when playing big videos like DVDs, but may
270 cause instabilities. Default: on.
271 Option "SubPixelOrder" "string"
273 Force subpixel order to specified order. Subpixel order is used
274 for subpixel decimation on flat panels.
275 NONE -- No subpixel (CRT like displays)
276 RGB -- in horizontal RGB order (most flat panels)
277 BGR -- in horizontal BGR order (some flat panels)
278 This option is intended to be used in following cases:
280 1. The default subpixel order is incorrect for your panel.
281 2. Enable subpixel decimation on analog panels.
282 3. Adjust to one display type in dual-head clone mode setup.
283 4. Get better performance with Render acceleration on digital
284 panels (use NONE setting).
285 The default is NONE for CRT, RGB for digital panels
286 Option "ClockGating" "boolean"
288 Enable dynamic clock gating. This can help reduce heat and
289 increase battery life by reducing power usage. Some users
290 report reduced 3D performance with this enabled. The default is
291 off.
292 Option "ForceLowPowerMode" "boolean"
294 Enable a static low power mode. This can help reduce heat and
295 increase battery life by reducing power usage at the expense of
296 performance. The default is off.
297 Option "DynamicPM" "boolean"
299 Enable dynamic power mode switching. This can help reduce heat
300 and increase battery life by reducing power usage when the sys‐
301 tem is idle (DPMS active). The default is off.
302 Option "VGAAccess" "boolean"
304 Tell the driver if it can do legacy VGA IOs to the card. This is
305 necessary for properly resuming consoles when in VGA text mode,
306 but shouldn't be if the console is using radeonfb or some other
307 graphic mode driver. Some platforms like PowerPC have issues
308 with those, and they aren't necessary unless you have a real
309 text mode in console. The default is off on PowerPC and SPARC
310 and on on other architectures.
311 Option "ReverseDDC" "boolean"
313 When BIOS connector informations aren't available, use this
314 option to reverse the mapping of the 2 main DDC ports. Use this
315 if the X server obviously detects the wrong display for each
316 connector. This is typically needed on the Radeon 9600 cards
317 bundled with Apple G5s. The default is off.
318 Option "LVDSProbePLL" "boolean"
320 When BIOS panel informations aren't available (like on Power‐
321 Books), it may still be necessary to use the firmware provided
322 PLL values for the panel or flickering will happen. This option
323 will force probing of the current value programmed in the chip
324 when X is launched in that case. This is only useful for LVDS
325 panels (laptop internal panels). The default is on.
326 Option "TVDACLoadDetect" "boolean"
328 Enable load detection on the TV DAC. The TV DAC is used to
329 drive both TV-out and analog monitors. Load detection is often
330 unreliable in the TV DAC so it is disabled by default. The
331 default is off.
332 Option "DefaultTMDSPLL" "boolean"
334 Use the default driver provided TMDS PLL values rather than the
335 ones provided by the bios. This option has no effect on Mac
336 cards. Enable this option if you are having problems with a DVI
337 monitor using the internal TMDS controller. The default is off.
338 Option "DefaultTVDACAdj" "boolean"
340 Use the default driver provided TVDAC Adj values rather than the
341 ones provided by the bios. This option has no effect on Mac
342 cards. Enable this option if you are having problems with a
343 washed out display on the secondary DAC. The default is off.
344 Option "DRI" "boolean"
346 Enable DRI support. This option allows you to enable to disable
347 the DRI. The default is off for RN50/ES1000 and on for others.
348 Option "DefaultConnectorTable" "boolean"
350 Enable this option to skip the BIOS connector table parsing and
351 use the driver defaults for each chip. The default is off
352 Option "MacModel" "string"
354 Used to specify Mac models for connector tables and quirks. If
355 you have a powerbook or mini with DVI that does not work prop‐
356 erly, try the alternate options as Apple does not seem to pro‐
357 vide a good way of knowing whether they use internal or external
358 TMDS for DVI. Only valid on PowerPC. On Linux, the driver will
359 attempt to detect the MacModel automatically.
360 ibook -- ibooks
361 powerbook-external -- Powerbooks with external DVI
362 powerbook-internal -- Powerbooks with integrated DVI
363 powerbook-vga -- Powerbooks with VGA rather than DVI
364 mini-external -- Mac Mini with external DVI
365 mini-internal -- Mac Mini with integrated DVI
366 imac-g5-isight -- iMac G5 iSight
367 emac -- eMac G4
368 The default value is undefined.
369 Option "TVStandard" "string"
371 Used to specify the default TV standard if you want to use some‐
372 thing other than the bios default. Valid options are:
373 ntsc
374 pal
375 pal-m
376 pal-60
377 ntsc-j
378 scart-pal
379 The default value is undefined.
380 Option "ForceTVOut" "boolean"
382 Enable this option to force TV-out to always be detected as
383 attached. The default is off
384 Option "IgnoreLidStatus" "boolean"
386 Enable this option to ignore lid status on laptops and always
387 detect LVDS as attached. The default is on.
388 Option "Int10" "boolean"
390 This option allows you to disable int10 initialization. Set
391 this to False if you are experiencing a hang when initializing a
392 secondary card. The default is on.
393 Option "EXAVSync" "boolean"
395 This option attempts to avoid tearing by stalling the engine
396 until the display controller has passed the destination region.
397 It reduces tearing at the cost of performance and has been know
398 to cause instability on some chips. The default is off.
399 Option "ATOMTvOut" "boolean"
401 This option enables experimental TV-out support for R/RV5xx,
402 R/RV6xx, and R/RV7xx atombios chips. TV-out is experimental and
403 may not function on these chips as well as hoped for. The
404 default is off.
405 Option "R4xxATOM" "boolean"
407 This option enables modesetting on R/RV4xx chips using atombios.
408 The default is off.
409 Option "EXAPixmaps" "boolean"
411 (KMS Only) Under kernel modesetting to avoid thrashing pixmaps
412 in/out of VRAM on low memory cards, we use a heuristic based on
413 VRAM amount, to determine whether to allow EXA to use VRAM for
414 non-essential pixmaps. This option allows us to override the
415 heurisitc. The default is on with > 32MB VRAM, off with < 32MB.
416 Option "ZaphodHeads" "string"
418 Specify the randr output(s) to use with zaphod mode for a par‐
419 ticular driver instance. If you use this option you most use
420 this option for all instances of the driver.
421 For example: Option "ZaphodHeads" "LVDS,VGA-0" will assign
422 xrandr outputs LVDS and VGA-0 to this instance of the driver.
423
426 The driver supports the following X11 Xv attributes for Textured Video.
427 You can use the "xvattr" tool to query/set those attributes at runtime.
428 XV_VSYNC
431 XV_VSYNC is used to control whether textured adapter synchro‐
432 nizes the screen update to the monitor vertical refresh to elim‐
433 inate tearing. It has two values: 'off'(0) and 'on'(1). The
434 default is 'on'(1).
435 XV_CRTC
438 XV_CRTC is used to control which display controller (crtc) the
439 textured adapter synchronizes the screen update with when
440 XV_VSYNC is enabled. The default, 'auto'(-1), will sync to the
441 display controller that more of the video is on. This attribute
442 is useful for things like clone mode where the user can best
443 decide which display should be synced. The default is
444 'auto'(-1).
445 XV_BICUBIC
448 XV_BICUBIC is used to control whether textured adapter should
449 apply a bicubic filter to smooth the output. It has three val‐
450 ues: 'off'(0), 'on'(1) and 'auto'(2). 'off' means never apply
451 the filter, 'on' means always apply the filter and 'auto' means
452 apply the filter only if the X and Y sizes are scaled to more
453 than double to avoid blurred output. Bicubic filtering is not
454 currently compatible with other Xv attributes like hue, con‐
455 trast, and brightness, and must be disabled to use those
456 attributes. The default is 'off'(0).
457
460 Xorg(1), xorg.conf(5), Xserver(1), X(7)
461 1. Wiki page:
463 http://www.x.org/wiki/radeon
464 2. Overview about radeon development code:
466 http://cgit.freedesktop.org/xorg/driver/xf86-video-ati/
467 3. Mailing list:
469 http://lists.x.org/mailman/listinfo/xorg-driver-ati
470 4. IRC channel:
472 #radeon on irc.freenode.net
473 5. Query the bugtracker for radeon bugs:
475 https://bugs.freedesktop.org/query.cgi?product=xorg&compo‐
476 nent=Driver/Radeon
477 6. Submit bugs & patches:
479 https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&compo‐
480 nent=Driver/Radeon
481
484 Authors include:
485 Rickard E. (Rik) Faith faith@precisioninsight.com
486 Kevin E. Martin kem@freedesktop.org
487 Alan Hourihane alanh@fairlite.demon.co.uk
488 Marc Aurele La France tsi@xfree86.org
489 Benjamin Herrenschmidt benh@kernel.crashing.org
490 Michel Dänzer michel@tungstengraphics.com
491 Alex Deucher alexdeucher@gmail.com
492 Bogdan D. bogdand@users.sourceforge.net
493 Eric Anholt eric@anholt.net
494X Version 11 xf86-video-ati 6.13.99 RADEON(4)