radeon.man revision b13dfe66
1209ff23fSmrg.ds q \N'34'
2209ff23fSmrg.TH RADEON __drivermansuffix__ __vendorversion__
3209ff23fSmrg.SH NAME
4209ff23fSmrgradeon \- ATI RADEON video driver
5209ff23fSmrg.SH SYNOPSIS
6209ff23fSmrg.nf
7209ff23fSmrg.B "Section \*qDevice\*q"
8209ff23fSmrg.BI "  Identifier \*q"  devname \*q
9209ff23fSmrg.B  "  Driver \*qradeon\*q"
10209ff23fSmrg\ \ ...
11209ff23fSmrg.B EndSection
12209ff23fSmrg.fi
13209ff23fSmrg.SH DESCRIPTION
14209ff23fSmrg.B radeon
15921a55d8Smrgis an __xservername__ driver for ATI RADEON-based video cards with the
16b7e1c893Smrgfollowing features:
17b7e1c893Smrg.PP
18b7e1c893Smrg.PD 0
19b7e1c893Smrg.TP 2
20b7e1c893Smrg\(bu
21921a55d8SmrgFull support for 8-, 15-, 16- and 24-bit pixel depths;
22b7e1c893Smrg.TP
23b7e1c893Smrg\(bu
24b7e1c893SmrgRandR 1.2 and RandR 1.3 support;
25b7e1c893Smrg.TP
26b7e1c893Smrg\(bu
27921a55d8SmrgTV-out support (only on RV/RS1xx, RV/RS2xx, R/RV/RS3xx. Experimental
28b7e1c893Smrgsupport on R/RV5xx, R/RV6xx, and R/RV7xx through the
29b7e1c893Smrg.B ATOMTvOut
30921a55d8Smrgoption);  TV-out is not supported on cards that use the Rage Theatre
31921a55d8Smrgchip for TV-out (R100, R200).
32b7e1c893Smrg.TP
33b7e1c893Smrg\(bu
34b7e1c893SmrgFull EXA 2D acceleration;
35b7e1c893Smrg.TP
36b7e1c893Smrg\(bu
37b7e1c893SmrgFull XAA 2D acceleration (only on R/RV/RS1xx, R/RV/RS2xx, R/RV/RS3xx,
38b7e1c893SmrgR/RV/RS4xx, R/RV5xx, RS6xx. XAA Render acceleration supported only on R/RV100,
39b7e1c893SmrgR/RV/RS2xx and RS3xx);
40b7e1c893Smrg.TP
41b7e1c893Smrg\(bu
42b7e1c893SmrgTextured XVideo acceleration including anti-tearing support (Bicubic filtering
43ad43ddacSmrgonly available on R/RV3xx, R/RV/RS4xx, R/RV5xx, and RS6xx/RS740);
44b7e1c893Smrg.TP
45b7e1c893Smrg\(bu
46b7e1c893SmrgOverlay XVideo acceleration (only on R/RV/RS1xx, R/RV/RS2xx,
47b7e1c893SmrgR/RV/RS3xx, R/RV/RS4xx);
48b7e1c893Smrg.TP
49b7e1c893Smrg\(bu
50ad43ddacSmrg3D acceleration;
51b7e1c893Smrg.PD
52209ff23fSmrg.SH SUPPORTED HARDWARE
53209ff23fSmrgThe
54209ff23fSmrg.B radeon
55b7e1c893Smrgdriver supports PCI, AGP, and PCIE video cards based on the following ATI chips:
56b7e1c893Smrg.PP
57b7e1c893Smrg.PD 0
58209ff23fSmrg.TP 12
59209ff23fSmrg.B R100
60209ff23fSmrgRadeon 7200
61209ff23fSmrg.TP 12
62209ff23fSmrg.B RV100
63209ff23fSmrgRadeon 7000(VE), M6, RN50/ES1000
64209ff23fSmrg.TP 12
65209ff23fSmrg.B RS100
66209ff23fSmrgRadeon IGP320(M)
67209ff23fSmrg.TP 12
68209ff23fSmrg.B RV200
69209ff23fSmrgRadeon 7500, M7, FireGL 7800
70209ff23fSmrg.TP 12
71209ff23fSmrg.B RS200
72209ff23fSmrgRadeon IGP330(M)/IGP340(M)
73209ff23fSmrg.TP 12
74209ff23fSmrg.B RS250
75209ff23fSmrgRadeon Mobility 7000 IGP
76209ff23fSmrg.TP 12
77209ff23fSmrg.B R200
78209ff23fSmrgRadeon 8500, 9100, FireGL 8800/8700
79209ff23fSmrg.TP 12
80209ff23fSmrg.B RV250
81209ff23fSmrgRadeon 9000PRO/9000, M9
82209ff23fSmrg.TP 12
83b7e1c893Smrg.B RV280
84b7e1c893SmrgRadeon 9200PRO/9200/9200SE/9250, M9+
85b7e1c893Smrg.TP 12
86209ff23fSmrg.B RS300
87209ff23fSmrgRadeon 9100 IGP
88209ff23fSmrg.TP 12
89209ff23fSmrg.B RS350
90209ff23fSmrgRadeon 9200 IGP
91209ff23fSmrg.TP 12
92209ff23fSmrg.B RS400/RS480
93209ff23fSmrgRadeon XPRESS 200(M)/1100 IGP
94209ff23fSmrg.TP 12
95209ff23fSmrg.B R300
96209ff23fSmrgRadeon 9700PRO/9700/9500PRO/9500/9600TX, FireGL X1/Z1
97209ff23fSmrg.TP 12
98209ff23fSmrg.B R350
99209ff23fSmrgRadeon 9800PRO/9800SE/9800, FireGL X2
100209ff23fSmrg.TP 12
101209ff23fSmrg.B R360
102209ff23fSmrgRadeon 9800XT
103209ff23fSmrg.TP 12
104209ff23fSmrg.B RV350
105209ff23fSmrgRadeon 9600PRO/9600SE/9600/9550, M10/M11, FireGL T2
106209ff23fSmrg.TP 12
107209ff23fSmrg.B RV360
108209ff23fSmrgRadeon 9600XT
109209ff23fSmrg.TP 12
110209ff23fSmrg.B RV370
111209ff23fSmrgRadeon X300, M22
112209ff23fSmrg.TP 12
113209ff23fSmrg.B RV380
114209ff23fSmrgRadeon X600, M24
115209ff23fSmrg.TP 12
116209ff23fSmrg.B RV410
117209ff23fSmrgRadeon X700, M26 PCIE
118209ff23fSmrg.TP 12
119209ff23fSmrg.B R420
120209ff23fSmrgRadeon X800 AGP
121209ff23fSmrg.TP 12
122209ff23fSmrg.B R423/R430
123209ff23fSmrgRadeon X800, M28 PCIE
124209ff23fSmrg.TP 12
125209ff23fSmrg.B R480/R481
126209ff23fSmrgRadeon X850 PCIE/AGP
127209ff23fSmrg.TP 12
128209ff23fSmrg.B RV505/RV515/RV516/RV550
129209ff23fSmrgRadeon X1300/X1400/X1500/X2300
130209ff23fSmrg.TP 12
131209ff23fSmrg.B R520
132209ff23fSmrgRadeon X1800
133209ff23fSmrg.TP 12
134209ff23fSmrg.B RV530/RV560
135209ff23fSmrgRadeon X1600/X1650/X1700
136209ff23fSmrg.TP 12
137209ff23fSmrg.B RV570/R580
138209ff23fSmrgRadeon X1900/X1950
139209ff23fSmrg.TP 12
140b7e1c893Smrg.B RS600/RS690/RS740
141b7e1c893SmrgRadeon X1200/X1250/X2100
142209ff23fSmrg.TP 12
143209ff23fSmrg.B R600
144209ff23fSmrgRadeon HD 2900
145209ff23fSmrg.TP 12
146209ff23fSmrg.B RV610/RV630
147209ff23fSmrgRadeon HD 2400/2600
148209ff23fSmrg.TP 12
149209ff23fSmrg.B RV620/RV635
150209ff23fSmrgRadeon HD 3450/3470
151209ff23fSmrg.TP 12
152b7e1c893Smrg.B RV670
153b7e1c893SmrgRadeon HD 3850/3870
154b7e1c893Smrg.TP 12
155209ff23fSmrg.B RS780
156b7e1c893SmrgRadeon HD 3100/3200/3300
157b7e1c893Smrg.TP 12
158921a55d8Smrg.B RS880
159921a55d8SmrgRadeon HD 4100/4200/4290
160921a55d8Smrg.TP 12
161b7e1c893Smrg.B RV710
162b7e1c893SmrgRadeon HD 4350/4550
163b7e1c893Smrg.TP 12
164b7e1c893Smrg.B RV730
165b7e1c893SmrgRadeon HD 4650/4670
166b7e1c893Smrg.TP 12
167b7e1c893Smrg.B RV770
168b7e1c893SmrgRadeon HD 4850/4870
169921a55d8Smrg.TP 12
170921a55d8Smrg.B CEDAR
171921a55d8SmrgRadeon HD 5450
172921a55d8Smrg.TP 12
173921a55d8Smrg.B REDWOOD
174921a55d8SmrgRadeon HD 5550/5570/5670
175921a55d8Smrg.TP 12
176921a55d8Smrg.B JUNIPER
177921a55d8SmrgRadeon HD 5750/5770
178921a55d8Smrg.TP 12
179921a55d8Smrg.B CYPRESS
180921a55d8SmrgRadeon HD 5850/5870
181921a55d8Smrg.TP 12
182921a55d8Smrg.B HEMLOCK
183921a55d8SmrgRadeon HD 5970
184921a55d8Smrg.TP 12
185921a55d8Smrg.B PALM
186921a55d8SmrgRadeon HD 6310/6250
187b13dfe66Smrg.TP 12
188b13dfe66Smrg.B BARTS
189b13dfe66SmrgRadeon HD 6850/6870
190b13dfe66Smrg.TP 12
191b13dfe66Smrg.B TURKS
192b13dfe66SmrgRadeon HD 6570/6670
193b13dfe66Smrg.TP 12
194b13dfe66Smrg.B CAICOS
195b13dfe66SmrgRadeon HD 6450
196b7e1c893Smrg.PD
197209ff23fSmrg.SH CONFIGURATION DETAILS
198209ff23fSmrgPlease refer to __xconfigfile__(__filemansuffix__) for general configuration
199209ff23fSmrgdetails.  This section only covers configuration details specific to this
200209ff23fSmrgdriver.
201209ff23fSmrg.PP
202209ff23fSmrgThe driver auto\-detects all device information necessary to initialize
203209ff23fSmrgthe card.  However, if you have problems with auto\-detection, you can
204921a55d8Smrgspecify for UMS (Userspace Modesetting):
205209ff23fSmrg.PP
206209ff23fSmrg.RS 4
207209ff23fSmrgVideoRam \- in kilobytes
208209ff23fSmrg.br
209209ff23fSmrgMemBase  \- physical address of the linear framebuffer
210209ff23fSmrg.br
211209ff23fSmrgIOBase   \- physical address of the MMIO registers
212209ff23fSmrg.br
213209ff23fSmrgChipID   \- PCI DEVICE ID
214209ff23fSmrg.RE
215209ff23fSmrg.PP
216209ff23fSmrgIn addition, the following driver
217209ff23fSmrg.B Options
218921a55d8Smrgare supported for both
219921a55d8Smrg.B UMS
220921a55d8Smrg(Userspace Modesetting) and
221921a55d8Smrg.B KMS
222921a55d8Smrg(Kernel Modesetting):
223209ff23fSmrg.TP
224209ff23fSmrg.BI "Option \*qSWcursor\*q \*q" boolean \*q
225209ff23fSmrgSelects software cursor.  The default is
226209ff23fSmrg.B off.
227209ff23fSmrg.TP
228209ff23fSmrg.BI "Option \*qNoAccel\*q \*q" boolean \*q
229209ff23fSmrgEnables or disables all hardware acceleration.
230209ff23fSmrg.br
231209ff23fSmrgThe default is to
232209ff23fSmrg.B enable
233209ff23fSmrghardware acceleration.
234209ff23fSmrg.TP
235921a55d8Smrg.BI "Option \*qZaphodHeads\*q \*q" string \*q
236921a55d8SmrgSpecify the RandR output(s) to use with zaphod mode for a particular driver
237921a55d8Smrginstance.  If you use this option you most use this option for all instances
238921a55d8Smrgof the driver.
239921a55d8Smrg.br
240921a55d8SmrgFor example:
241921a55d8Smrg.B
242921a55d8SmrgOption \*qZaphodHeads\*q \*qLVDS,VGA-0\*q
243921a55d8Smrgwill assign xrandr outputs LVDS and VGA-0 to this instance of the driver.
244921a55d8Smrg.TP
245921a55d8Smrg.BI "Option \*qEXAVSync\*q \*q" boolean \*q
246921a55d8SmrgThis option attempts to avoid tearing by stalling the engine until the display
247921a55d8Smrgcontroller has passed the destination region.  It reduces tearing at the cost
248921a55d8Smrgof performance and has been known to cause instability on some chips.
249921a55d8SmrgThe default is
250921a55d8Smrg.B off.
251921a55d8Smrg
252921a55d8Smrg.PP
253921a55d8SmrgThe following driver
254921a55d8Smrg.B Options
255921a55d8Smrgare supported for
256921a55d8Smrg.B KMS
257921a55d8Smrg(Kernel Modesetting):
258921a55d8Smrg.TP
259921a55d8Smrg.BI "Option \*qColorTiling\*q \*q" "boolean" \*q
260921a55d8SmrgThe framebuffer can be addressed either in linear or tiled mode. Tiled mode can provide
261921a55d8Smrgsignificant performance benefits with 3D applications.  Tiling will be disabled if the drm
262921a55d8Smrgmodule is too old or if the current display configuration does not support it. KMS
263921a55d8SmrgColorTiling is not currently supported on R/RV/RS1XX, R/RV/RS2XX, and RS3XX.
264921a55d8Smrg.br
265921a55d8SmrgThe default value is
266921a55d8Smrg.B on
267921a55d8Smrgfor R/RV3XX, R/RV4XX, R/RV5XX, RS6XX, RS740 and
268921a55d8Smrg.B off
269921a55d8Smrgfor R/RV6XX, R/RV7XX, RS780, RS880, and EVERGREEN.
270921a55d8Smrg.TP
271921a55d8Smrg.BI "Option \*qEXAPixmaps\*q \*q" boolean \*q
272921a55d8SmrgUnder KMS, to avoid thrashing pixmaps in/out of VRAM on low memory cards,
273921a55d8Smrgwe use a heuristic based on VRAM amount to determine whether to allow EXA
274921a55d8Smrgto use VRAM for non-essential pixmaps.  This option allows us to override the
275921a55d8Smrgheuristic.  The default is
276921a55d8Smrg.B on
277921a55d8Smrgwith > 32MB VRAM, off with < 32MB.
278921a55d8Smrg.TP
279921a55d8Smrg.BI "Option \*qSwapbuffersWait\*q \*q" boolean \*q
280921a55d8SmrgThis option controls the behavior of glXSwapBuffers and glXCopySubBufferMESA
281921a55d8Smrgcalls by GL applications.  If enabled, the calls will avoid tearing by making
282921a55d8Smrgsure the display scanline is outside of the area to be copied before the copy
283921a55d8Smrgoccurs.  If disabled, no scanline synchronization is performed, meaning tearing
284921a55d8Smrgwill likely occur.  Note that when enabled, this option can adversely affect
285921a55d8Smrgthe framerate of applications that render frames at less than refresh rate.
286921a55d8Smrg.IP
287921a55d8SmrgThe default value is
288921a55d8Smrg.B on.
289921a55d8Smrg.TP
290921a55d8Smrg.BI "Option \*qEnablePageFlip\*q \*q" boolean \*q
291921a55d8SmrgEnable DRI2 page flipping.  The default is
292921a55d8Smrg.B on.
293921a55d8SmrgPageflipping is supported on all radeon hardware.
294921a55d8Smrg.PP
295921a55d8SmrgThe following driver
296921a55d8Smrg.B Options
297921a55d8Smrgare supported for
298921a55d8Smrg.B UMS
299921a55d8Smrg(Userspace Modesetting):
300921a55d8Smrg.TP
301209ff23fSmrg.BI "Option \*qDac6Bit\*q \*q" boolean \*q
302209ff23fSmrgEnables or disables the use of 6 bits per color component when in 8 bpp
303209ff23fSmrgmode (emulates VGA mode).  By default, all 8 bits per color component
304209ff23fSmrgare used.
305209ff23fSmrg.br
306209ff23fSmrgThe default is
307209ff23fSmrg.B off.
308209ff23fSmrg.TP
309209ff23fSmrg.BI "Option \*qVideoKey\*q \*q" integer \*q
310209ff23fSmrgThis overrides the default pixel value for the YUV video overlay key.
311209ff23fSmrg.br
312209ff23fSmrgThe default value is
313209ff23fSmrg.B 0x1E.
314209ff23fSmrg.TP
315209ff23fSmrg.BI "Option \*qScalerWidth\*q \*q" integer \*q
316921a55d8SmrgThis sets the overlay scaler buffer width. Accepted values range from
317921a55d8Smrg1024 to 2048, divisible by 64.  Values other than 1536 and 1920 may
318921a55d8Smrgnot make sense.  This should be set automatically, but no one knows
319921a55d8Smrgwhat the limit is for which chip. If you think quality is not optimal
320921a55d8Smrgwhen playing back HD video (with horizontal resolution larger than
321921a55d8Smrgthis setting), increase this value.  If you get an empty area at the
322921a55d8Smrgright (usually pink), decrease it. Note that this only affects the "true"
323921a55d8Smrgoverlay via Xv, and won't affect things like textured video.
324209ff23fSmrg.br
325209ff23fSmrgThe default value is either 1536 (for most chips) or 1920.
326209ff23fSmrg.TP
327209ff23fSmrg.BI "Option \*qAGPMode\*q \*q" integer \*q
328209ff23fSmrgSet AGP data transfer rate.
329209ff23fSmrg(used only when DRI is enabled)
330209ff23fSmrg.br
331209ff23fSmrg1      \-\- 1x (before AGP v3 only)
332209ff23fSmrg.br
333209ff23fSmrg2      \-\- 2x (before AGP v3 only)
334209ff23fSmrg.br
335209ff23fSmrg4      \-\- 4x
336209ff23fSmrg.br
337209ff23fSmrg8      \-\- 8x (AGP v3 only)
338209ff23fSmrg.br
339209ff23fSmrgothers \-\- invalid
340209ff23fSmrg.br
341209ff23fSmrgThe default is to
342209ff23fSmrg.B leave it unchanged.
343209ff23fSmrg.TP
344209ff23fSmrg.BI "Option \*qAGPFastWrite\*q \*q" boolean \*q
345209ff23fSmrgEnable AGP fast writes.  Enabling this is frequently the cause of
346209ff23fSmrginstability. Used only when the DRI is enabled. If you enable
347209ff23fSmrgthis option you will get *NO* support from developers.
348209ff23fSmrg.br
349209ff23fSmrgThe default is
350209ff23fSmrg.B off.
351209ff23fSmrg.TP
352209ff23fSmrg.BI "Option \*qBusType\*q \*q" string \*q
353209ff23fSmrgUsed to replace previous ForcePCIMode option.
354209ff23fSmrgShould only be used when driver's bus detection is incorrect
355921a55d8Smrgor you want to force a AGP card to PCI mode. You should NEVER force
356209ff23fSmrga PCI card to AGP bus.
357209ff23fSmrg.br
358209ff23fSmrgPCI    \-\- PCI bus
359209ff23fSmrg.br
360209ff23fSmrgAGP    \-\- AGP bus
361209ff23fSmrg.br
362b7e1c893SmrgPCIE   \-\- PCI Express bus
363209ff23fSmrg.br
364209ff23fSmrg(used only when DRI is enabled)
365209ff23fSmrg.br
366209ff23fSmrgThe default is
367209ff23fSmrg.B auto detect.
368209ff23fSmrg.TP
369209ff23fSmrg.BI "Option \*qDisplayPriority\*q \*q" string \*q
370209ff23fSmrg.br
371209ff23fSmrgUsed to prevent flickering or tearing problem caused by display buffer underflow.
372209ff23fSmrg.br
373209ff23fSmrgAUTO   \-\- Driver calculated (default).
374209ff23fSmrg.br
375209ff23fSmrgBIOS   \-\- Remain unchanged from BIOS setting.
376209ff23fSmrg          Use this if the calculation is not correct
377209ff23fSmrg          for your card.
378209ff23fSmrg.br
379209ff23fSmrgHIGH   \-\- Force to the highest priority.
380209ff23fSmrg          Use this if you have problem with above options.
381209ff23fSmrg          This may affect performance slightly.
382209ff23fSmrg.br
383209ff23fSmrgThe default value is
384209ff23fSmrg.B AUTO.
385209ff23fSmrg.TP
386209ff23fSmrg.BI "Option \*qColorTiling\*q \*q" "boolean" \*q
387921a55d8SmrgThe framebuffer can be addressed either in linear or tiled mode. Tiled mode can provide
388921a55d8Smrgsignificant performance benefits with 3D applications.  For 2D it shouldn't matter
389209ff23fSmrgmuch. Tiling will be disabled if the virtual x resolution exceeds 2048 (3968 for R300 
390921a55d8Smrgand above), or if DRI is enabled and the drm module is too old.
391209ff23fSmrg.br
392921a55d8SmrgIf this option is enabled, a new DRI driver is required for direct rendering.
393209ff23fSmrg.br
394209ff23fSmrgColor tiling will be automatically disabled in interlaced or doublescan screen modes.
395209ff23fSmrg.br
396209ff23fSmrgThe default value is
397209ff23fSmrg.B on.
398209ff23fSmrg.TP 
399209ff23fSmrg.BI "Option \*qIgnoreEDID\*q \*q" boolean \*q
400921a55d8SmrgDo not use EDID data for mode validation.  DDC is still used
401209ff23fSmrgfor monitor detection. This is different from NoDDC option.
402209ff23fSmrg.br
403209ff23fSmrgThe default value is
404209ff23fSmrg.B off.
405209ff23fSmrg.TP 
406ad43ddacSmrg.BI "Option \*qCustomEDID\*q \*q" string \*q
407ad43ddacSmrgForces the X driver to use the EDID data specified in a file rather
408ad43ddacSmrgthan the display's EDID. Also overrides DDC monitor detection.
409ad43ddacSmrg.br
410921a55d8SmrgYou may specify a semicolon-separated list of output name and filename pairs
411ad43ddacSmrgwith an optional flag, "digital" or "analog", to override the digital bit in
412921a55d8Smrgthe EDID which is used by the driver to determine whether to use the
413ad43ddacSmrganalog or digital encoder associated with a DVI-I port.
414921a55d8SmrgThe output name is the RandR output name, e.g., "VGA-0" or "DVI-0";
415ad43ddacSmrgconsult the Xorg log for the supported output names of any given system.
416ad43ddacSmrg.br
417ad43ddacSmrgThe file must contain a raw 128-byte EDID block, as captured by
418ad43ddacSmrg.B
419ad43ddacSmrgget-edid.
420ad43ddacSmrg.br
421ad43ddacSmrgFor example:
422ad43ddacSmrg.B
423ad43ddacSmrgOption \*qCustomEDID\*q \*qVGA-0:/tmp/edid1.bin; DVI-0:/tmp/edid2.bin:digital\*q
424ad43ddacSmrgwill assign the EDID from the file /tmp/edid1.bin to the output device
425ad43ddacSmrgVGA-0, and the EDID from the file /tmp/edid2.bin to the output device
426ad43ddacSmrgDVI-0 and force the DVI port to use the digital encoder.
427ad43ddacSmrg.br
428ad43ddacSmrgNote that a output name must always be specified,
429ad43ddacSmrgeven if only one EDID is specified.
430ad43ddacSmrg.br
431ad43ddacSmrg.B
432ad43ddacSmrgCaution:
433ad43ddacSmrgSpecifying an EDID that doesn't exactly match your display may
434ad43ddacSmrgdamage your hardware, as it allows the driver to specify timings beyond
435ad43ddacSmrgthe capabilities of your display. Use with care.
436ad43ddacSmrg.TP 
437209ff23fSmrg.BI "Option \*qPanelSize\*q \*q" "string" \*q
438209ff23fSmrgShould only be used when driver cannot detect the correct panel size.
439209ff23fSmrgApply to both desktop (TMDS) and laptop (LVDS) digital panels.
440209ff23fSmrgWhen a valid panel size is specified, the timings collected from
441b7e1c893SmrgDDC and BIOS will not be used. If you have a panel with timings
442209ff23fSmrgdifferent from that of a standard VESA mode, you have to provide
443209ff23fSmrgthis information through the Modeline.
444209ff23fSmrg.br
445209ff23fSmrgFor example, Option "PanelSize" "1400x1050"
446209ff23fSmrg.br
447209ff23fSmrgThe default value is
448209ff23fSmrg.B none.
449209ff23fSmrg.TP
450209ff23fSmrg.BI "Option \*qEnablePageFlip\*q \*q" boolean \*q
451209ff23fSmrgEnable page flipping for 3D acceleration. This will increase performance
452209ff23fSmrgbut not work correctly in some rare cases, hence the default is
453209ff23fSmrg.B off.
454b7e1c893SmrgIt is currently only supported on R/RV/RS4xx and older hardware.
455209ff23fSmrg.TP
456209ff23fSmrg.BI "Option \*qForceMinDotClock\*q \*q" frequency \*q
457209ff23fSmrgOverride minimum dot clock. Some Radeon BIOSes report a minimum dot
458209ff23fSmrgclock unsuitable (too high) for use with television sets even when they
459209ff23fSmrgactually can produce lower dot clocks. If this is the case you can
460209ff23fSmrgoverride the value here.
461209ff23fSmrg.B Note that using this option may damage your hardware.
462209ff23fSmrgYou have been warned. The
463209ff23fSmrg.B frequency
464209ff23fSmrgparameter may be specified as a float value with standard suffixes like
465209ff23fSmrg"k", "kHz", "M", "MHz".
466209ff23fSmrg.TP
467209ff23fSmrg.BI "Option \*qRenderAccel\*q \*q" boolean \*q
468b7e1c893SmrgEnables or disables hardware Render acceleration.  It is supported on all
469b7e1c893SmrgRadeon cards when using EXA acceleration and on Radeon R/RV/RS1xx,
470921a55d8SmrgR/RV/RS2xx and RS3xx when using XAA.  The default is to
471209ff23fSmrg.B enable
472209ff23fSmrgRender acceleration.
473209ff23fSmrg.TP
474209ff23fSmrg.BI "Option \*qAccelMethod\*q \*q" "string" \*q
475209ff23fSmrgChooses between available acceleration architectures.  Valid options are
476209ff23fSmrg.B XAA
477209ff23fSmrgand
478209ff23fSmrg.B EXA.
479209ff23fSmrgXAA is the traditional acceleration architecture and support for it is very
480209ff23fSmrgstable.  EXA is a newer acceleration architecture with better performance for
481ad43ddacSmrgthe Render and Composite extensions.  The default is
482ad43ddacSmrg.B EXA.
483209ff23fSmrg.TP
484209ff23fSmrg.BI "Option \*qAccelDFS\*q \*q" boolean \*q
485209ff23fSmrgUse or don't use accelerated EXA DownloadFromScreen hook when possible (only
486209ff23fSmrgwhen Direct Rendering is enabled, e.g.).
487209ff23fSmrgDefault:
488209ff23fSmrg.B off
489209ff23fSmrgwith AGP due to issues with GPU->host transfers with some AGP bridges,
490209ff23fSmrg.B on
491209ff23fSmrgotherwise.
492209ff23fSmrg.TP
493209ff23fSmrg.BI "Option \*qFBTexPercent\*q \*q" integer \*q
494209ff23fSmrgAmount of video RAM to reserve for OpenGL textures, in percent. With EXA, the
495209ff23fSmrgremainder of video RAM is reserved for EXA offscreen management. Specifying 0
496209ff23fSmrgresults in all offscreen video RAM being reserved for EXA and only GART memory
497209ff23fSmrgbeing available for OpenGL textures. This may improve EXA performance, but
498209ff23fSmrgbeware that it may cause problems with OpenGL drivers from Mesa versions older
499209ff23fSmrgthan 6.4. With XAA, specifying lower percentage than what gets reserved without
500209ff23fSmrgthis option has no effect, but the driver tries to increase the video RAM
501209ff23fSmrgreserved for textures to the amount specified roughly.
502209ff23fSmrgDefault:
503209ff23fSmrg.B 50.
504209ff23fSmrg.TP
505209ff23fSmrg.BI "Option \*qDepthBits\*q \*q" integer \*q
506209ff23fSmrgPrecision in bits per pixel of the shared depth buffer used for 3D acceleration.
507209ff23fSmrgValid values are 16 and 24. When this is 24, there will also be a hardware
508209ff23fSmrgaccelerated stencil buffer, but the combined depth/stencil buffer will take up
509209ff23fSmrgtwice as much video RAM as when it's 16.
510209ff23fSmrgDefault:
511209ff23fSmrg.B The same as the screen depth.
512209ff23fSmrg.TP
513209ff23fSmrg.BI "Option \*qDMAForXv\*q \*q" boolean \*q
514209ff23fSmrgTry or don't try to use DMA for Xv image transfers. This will reduce CPU
515209ff23fSmrgusage when playing big videos like DVDs, but may cause instabilities.
516209ff23fSmrgDefault:
517209ff23fSmrg.B on.
518209ff23fSmrg.TP
519209ff23fSmrg.BI "Option \*qSubPixelOrder\*q \*q" "string" \*q
520209ff23fSmrgForce subpixel order to specified order.
521209ff23fSmrgSubpixel order is used for subpixel decimation on flat panels.
522209ff23fSmrg.br
523209ff23fSmrgNONE   \-\- No subpixel (CRT like displays)
524209ff23fSmrg.br
525209ff23fSmrgRGB    \-\- in horizontal RGB order (most flat panels)
526209ff23fSmrg.br
527209ff23fSmrgBGR    \-\- in horizontal BGR order (some flat panels)
528209ff23fSmrg
529209ff23fSmrg.br
530209ff23fSmrgThis option is intended to be used in following cases:
531209ff23fSmrg.br
532209ff23fSmrg1. The default subpixel order is incorrect for your panel.
533209ff23fSmrg.br
534209ff23fSmrg2. Enable subpixel decimation on analog panels.
535209ff23fSmrg.br
536209ff23fSmrg3. Adjust to one display type in dual-head clone mode setup.
537209ff23fSmrg.br
538b7e1c893Smrg4. Get better performance with Render acceleration on
539209ff23fSmrgdigital panels (use NONE setting).
540209ff23fSmrg.br
541209ff23fSmrgThe default is 
542209ff23fSmrg.B NONE 
543209ff23fSmrgfor CRT, 
544209ff23fSmrg.B RGB 
545209ff23fSmrgfor digital panels
546209ff23fSmrg.TP
547ad43ddacSmrg.BI "Option \*qClockGating\*q \*q" boolean \*q
548ad43ddacSmrgEnable dynamic clock gating.  This can help reduce heat and increase battery
549209ff23fSmrglife by reducing power usage.  Some users report reduced 3D performance
550209ff23fSmrgwith this enabled.  The default is
551209ff23fSmrg.B off.
552209ff23fSmrg.TP
553ad43ddacSmrg.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q
554ad43ddacSmrgEnable a static low power mode.  This can help reduce heat and increase battery
555ad43ddacSmrglife by reducing power usage at the expense of performance. The default is
556ad43ddacSmrg.B off.
557ad43ddacSmrg.TP
558ad43ddacSmrg.BI "Option \*qDynamicPM\*q \*q" boolean \*q
559ad43ddacSmrgEnable dynamic power mode switching.  This can help reduce heat and increase battery
560ad43ddacSmrglife by reducing power usage when the system is idle (DPMS active). The default is
561ad43ddacSmrg.B off.
562ad43ddacSmrg.TP
563209ff23fSmrg.BI "Option \*qVGAAccess\*q \*q" boolean \*q
564209ff23fSmrgTell the driver if it can do legacy VGA IOs to the card. This is
565209ff23fSmrgnecessary for properly resuming consoles when in VGA text mode, but
566209ff23fSmrgshouldn't be if the console is using radeonfb or some other graphic
567209ff23fSmrgmode driver. Some platforms like PowerPC have issues with those, and they aren't
568209ff23fSmrgnecessary unless you have a real text mode in console. The default is
569209ff23fSmrg.B off
570209ff23fSmrgon PowerPC and SPARC and
571209ff23fSmrg.B on
572209ff23fSmrgon other architectures.
573209ff23fSmrg.TP
574209ff23fSmrg.BI "Option \*qReverseDDC\*q \*q" boolean \*q
575921a55d8SmrgWhen BIOS connector information isn't available, use this option to
576921a55d8Smrgreverse the mapping of the two main DDC ports. Use this if the X server
577209ff23fSmrgobviously detects the wrong display for each connector. This is
578209ff23fSmrgtypically needed on the Radeon 9600 cards bundled with Apple G5s. The
579209ff23fSmrgdefault is
580209ff23fSmrg.B off.
581209ff23fSmrg.TP
582209ff23fSmrg.BI "Option \*qLVDSProbePLL\*q \*q" boolean \*q
583921a55d8SmrgWhen BIOS panel information isn't available (like on PowerBooks), it
584921a55d8Smrgmay still be necessary to use the firmware-provided PLL values for the
585209ff23fSmrgpanel or flickering will happen. This option will force probing of
586209ff23fSmrgthe current value programmed in the chip when X is launched in that
587209ff23fSmrgcase.  This is only useful for LVDS panels (laptop internal panels).
588209ff23fSmrgThe default is
589209ff23fSmrg.B on.
590209ff23fSmrg.TP
591209ff23fSmrg.BI "Option \*qTVDACLoadDetect\*q \*q" boolean \*q
592b7e1c893SmrgEnable load detection on the TV DAC.  The TV DAC is used to drive both
593b7e1c893SmrgTV-out and analog monitors. Load detection is often unreliable in the
594209ff23fSmrgTV DAC so it is disabled by default.
595209ff23fSmrgThe default is
596209ff23fSmrg.B off.
597209ff23fSmrg.TP
598209ff23fSmrg.BI "Option \*qDefaultTMDSPLL\*q \*q" boolean \*q
599209ff23fSmrgUse the default driver provided TMDS PLL values rather than the ones
600921a55d8Smrgprovided by the BIOS. This option has no effect on Mac cards.  Enable
601b7e1c893Smrgthis option if you are having problems with a DVI monitor using the
602209ff23fSmrginternal TMDS controller.
603209ff23fSmrgThe default is
604209ff23fSmrg.B off.
605209ff23fSmrg.TP
606209ff23fSmrg.BI "Option \*qDefaultTVDACAdj\*q \*q" boolean \*q
607209ff23fSmrgUse the default driver provided TVDAC Adj values rather than the ones
608921a55d8Smrgprovided by the BIOS. This option has no effect on Mac cards.  Enable
609b7e1c893Smrgthis option if you are having problems with a washed out display on
610209ff23fSmrgthe secondary DAC.
611209ff23fSmrgThe default is
612209ff23fSmrg.B off.
613209ff23fSmrg.TP
614209ff23fSmrg.BI "Option \*qDRI\*q \*q" boolean \*q
615b7e1c893SmrgEnable DRI support.  This option allows you to enable to disable the DRI.
616209ff23fSmrgThe default is
617209ff23fSmrg.B off 
618209ff23fSmrgfor RN50/ES1000 and
619209ff23fSmrg.B on 
620209ff23fSmrgfor others.
621209ff23fSmrg.TP
622209ff23fSmrg.BI "Option \*qDefaultConnectorTable\*q \*q" boolean \*q
623209ff23fSmrgEnable this option to skip the BIOS connector table parsing and use the
624b7e1c893Smrgdriver defaults for each chip.
625209ff23fSmrgThe default is
626209ff23fSmrg.B off 
627209ff23fSmrg.TP
628209ff23fSmrg.BI "Option \*qMacModel\*q \*q" string \*q
629209ff23fSmrg.br
630209ff23fSmrgUsed to specify Mac models for connector tables and quirks.  If you have
631921a55d8Smrga PowerBook or Mini with DVI that does not work properly, try the alternate
632b7e1c893Smrgoptions as Apple does not seem to provide a good way of knowing whether
633b7e1c893Smrgthey use internal or external TMDS for DVI.  Only valid on PowerPC.
634b7e1c893SmrgOn Linux, the driver will attempt to detect the MacModel automatically.
635209ff23fSmrg.br
636209ff23fSmrgibook                \-\- ibooks
637209ff23fSmrg.br
638209ff23fSmrgpowerbook-external   \-\- Powerbooks with external DVI
639209ff23fSmrg.br
640209ff23fSmrgpowerbook-internal   \-\- Powerbooks with integrated DVI
641209ff23fSmrg.br
642209ff23fSmrgpowerbook-vga        \-\- Powerbooks with VGA rather than DVI
643209ff23fSmrg.br
644209ff23fSmrgmini-external        \-\- Mac Mini with external DVI
645209ff23fSmrg.br
646209ff23fSmrgmini-internal        \-\- Mac Mini with integrated DVI
647209ff23fSmrg.br
648209ff23fSmrgimac-g5-isight       \-\- iMac G5 iSight
649209ff23fSmrg.br
650b7e1c893Smrgemac                 \-\- eMac G4
651b7e1c893Smrg.br
652209ff23fSmrgThe default value is
653209ff23fSmrg.B undefined.
654209ff23fSmrg.TP
655209ff23fSmrg.BI "Option \*qTVStandard\*q \*q" string \*q
656209ff23fSmrg.br
657209ff23fSmrgUsed to specify the default TV standard if you want to use something other than
658921a55d8Smrgthe BIOS default. Valid options are:
659209ff23fSmrg.br
660209ff23fSmrgntsc
661209ff23fSmrg.br
662209ff23fSmrgpal
663209ff23fSmrg.br
664209ff23fSmrgpal-m
665209ff23fSmrg.br
666209ff23fSmrgpal-60
667209ff23fSmrg.br
668209ff23fSmrgntsc-j
669209ff23fSmrg.br
670209ff23fSmrgscart-pal
671209ff23fSmrg.br
672209ff23fSmrgThe default value is
673209ff23fSmrg.B undefined.
674209ff23fSmrg.TP
675209ff23fSmrg.BI "Option \*qForceTVOut\*q \*q" boolean \*q
676b7e1c893SmrgEnable this option to force TV-out to always be detected as attached.
677209ff23fSmrgThe default is
678209ff23fSmrg.B off 
679209ff23fSmrg.TP
680209ff23fSmrg.BI "Option \*qIgnoreLidStatus\*q \*q" boolean \*q
681209ff23fSmrgEnable this option to ignore lid status on laptops and always detect
682209ff23fSmrgLVDS as attached.
683209ff23fSmrgThe default is
684209ff23fSmrg.B on. 
685209ff23fSmrg.TP
686209ff23fSmrg.BI "Option \*qInt10\*q \*q" boolean \*q
687921a55d8SmrgThis option allows you to disable INT10 initialization.  Set this to
688209ff23fSmrgFalse if you are experiencing a hang when initializing a secondary card.
689209ff23fSmrgThe default is
690b7e1c893Smrg.B on.
691b7e1c893Smrg.TP 
692b7e1c893Smrg.BI "Option \*qATOMTvOut\*q \*q" boolean \*q
693b7e1c893SmrgThis option enables experimental TV-out support for R/RV5xx, R/RV6xx, and R/RV7xx
694921a55d8SmrgAtomBIOS chips. TV-out is experimental and may not function on these chips as
695b7e1c893Smrgwell as hoped for.
696b7e1c893SmrgThe default is
697b7e1c893Smrg.B off.
698b7e1c893Smrg.TP 
699b7e1c893Smrg.BI "Option \*qR4xxATOM\*q \*q" boolean \*q
700921a55d8SmrgThis option enables modesetting on R/RV4xx chips using AtomBIOS.
701b7e1c893SmrgThe default is
702b7e1c893Smrg.B off.
703b7e1c893Smrg
704b7e1c893Smrg.SH TEXTURED VIDEO ATTRIBUTES
705b7e1c893SmrgThe driver supports the following X11 Xv attributes for Textured Video.
706b7e1c893SmrgYou can use the "xvattr" tool to query/set those attributes at runtime.
707b7e1c893Smrg
708209ff23fSmrg.TP
709b7e1c893Smrg.BI "XV_VSYNC"
710b7e1c893SmrgXV_VSYNC is used to control whether textured adapter synchronizes
711b7e1c893Smrgthe screen update to the monitor vertical refresh to eliminate tearing.
712b7e1c893SmrgIt has two values: 'off'(0) and 'on'(1). The default is
713b7e1c893Smrg.B 'on'(1).
714b7e1c893Smrg
715ad43ddacSmrg.TP
716ad43ddacSmrg.BI "XV_CRTC"
717ad43ddacSmrgXV_CRTC is used to control which display controller (crtc) the textured
718ad43ddacSmrgadapter synchronizes the screen update with when XV_VSYNC is enabled.
719ad43ddacSmrgThe default, 'auto'(-1), will sync to the display controller that more
720ad43ddacSmrgof the video is on.  This attribute is useful for things like clone mode
721ad43ddacSmrgwhere the user can best decide which display should be synced.
722ad43ddacSmrgThe default is
723ad43ddacSmrg.B 'auto'(-1).
724ad43ddacSmrg
725b7e1c893Smrg.TP
726b7e1c893Smrg.BI "XV_BICUBIC"
727b7e1c893SmrgXV_BICUBIC is used to control whether textured adapter should apply
728b7e1c893Smrga bicubic filter to smooth the output. It has three values: 'off'(0), 'on'(1)
729b7e1c893Smrgand 'auto'(2). 'off' means never apply the filter, 'on' means always apply
730b7e1c893Smrgthe filter and 'auto' means apply the filter only if the X and Y
731ad43ddacSmrgsizes are scaled to more than double to avoid blurred output.  Bicubic
732ad43ddacSmrgfiltering is not currently compatible with other Xv attributes like hue,
733ad43ddacSmrgcontrast, and brightness, and must be disabled to use those attributes.
734b7e1c893SmrgThe default is
7352f39173dSmrg.B 'off'(0).
736209ff23fSmrg
737209ff23fSmrg.SH SEE ALSO
738b7e1c893Smrg__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
739b7e1c893Smrg.IP " 1." 4
740b7e1c893SmrgWiki page:
741b7e1c893Smrg.RS 4
742b7e1c893Smrghttp://www.x.org/wiki/radeon
743b7e1c893Smrg.RE
744b7e1c893Smrg.IP " 2." 4
745b7e1c893SmrgOverview about radeon development code:
746b7e1c893Smrg.RS 4
747b7e1c893Smrghttp://cgit.freedesktop.org/xorg/driver/xf86-video-ati/
748b7e1c893Smrg.RE
749b7e1c893Smrg.IP " 3." 4
750b7e1c893SmrgMailing list:
751b7e1c893Smrg.RS 4
752b7e1c893Smrghttp://lists.x.org/mailman/listinfo/xorg-driver-ati
753b7e1c893Smrg.RE
754b7e1c893Smrg.IP " 4." 4
755b7e1c893SmrgIRC channel:
756b7e1c893Smrg.RS 4
757b7e1c893Smrg#radeon on irc.freenode.net
758b7e1c893Smrg.RE
759b7e1c893Smrg.IP " 5." 4
760b7e1c893SmrgQuery the bugtracker for radeon bugs:
761b7e1c893Smrg.RS 4
762b7e1c893Smrghttps://bugs.freedesktop.org/query.cgi?product=xorg&component=Driver/Radeon
763b7e1c893Smrg.RE
764b7e1c893Smrg.IP " 6." 4
765b7e1c893SmrgSubmit bugs & patches:
766b7e1c893Smrg.RS 4
767b7e1c893Smrghttps://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver/Radeon
768b7e1c893Smrg.RE
769b7e1c893Smrg
770209ff23fSmrg.SH AUTHORS
771209ff23fSmrg.nf
772209ff23fSmrgAuthors include:
773209ff23fSmrgRickard E. (Rik) Faith   \fIfaith@precisioninsight.com\fP
774209ff23fSmrgKevin E. Martin          \fIkem@freedesktop.org\fP
775209ff23fSmrgAlan Hourihane           \fIalanh@fairlite.demon.co.uk\fP
776209ff23fSmrgMarc Aurele La France    \fItsi@xfree86.org\fP
777209ff23fSmrgBenjamin Herrenschmidt   \fIbenh@kernel.crashing.org\fP
778209ff23fSmrgMichel D\(:anzer            \fImichel@tungstengraphics.com\fP
779209ff23fSmrgAlex Deucher             \fIalexdeucher@gmail.com\fP
780209ff23fSmrgBogdan D.                \fIbogdand@users.sourceforge.net\fP
781209ff23fSmrgEric Anholt              \fIeric@anholt.net\fP
782