1209ff23fSmrg.ds q \N'34'
2209ff23fSmrg.TH RADEON __drivermansuffix__ __vendorversion__
3209ff23fSmrg.SH NAME
443df4709Smrgradeon \- 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
1543df4709Smrgis 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
2743df4709SmrgTV-out support (only on RV/RS1xx, RV/RS2xx, R/RV/RS3xx. Experimental
2843df4709Smrgsupport on R/RV5xx, R/RV6xx, and R/RV7xx through the
2943df4709Smrg.B ATOMTvOut
3043df4709Smrgoption);  TV-out is not supported on cards that use the Rage Theatre
3143df4709Smrgchip for TV-out (R100, R200).
3243df4709Smrg.TP
3343df4709Smrg\(bu
34b7e1c893SmrgFull EXA 2D acceleration;
35b7e1c893Smrg.TP
36b7e1c893Smrg\(bu
3743df4709SmrgFull XAA 2D acceleration (only on R/RV/RS1xx, R/RV/RS2xx, R/RV/RS3xx,
3843df4709SmrgR/RV/RS4xx, R/RV5xx, RS6xx. XAA Render acceleration supported only on R/RV100,
3943df4709SmrgR/RV/RS2xx and RS3xx);
4043df4709Smrg.TP
4143df4709Smrg\(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
4643df4709SmrgOverlay XVideo acceleration (only on R/RV/RS1xx, R/RV/RS2xx,
4743df4709SmrgR/RV/RS3xx, R/RV/RS4xx);
4843df4709Smrg.TP
4943df4709Smrg\(bu
50ad43ddacSmrg3D acceleration;
51b7e1c893Smrg.PD
52209ff23fSmrg.SH SUPPORTED HARDWARE
53209ff23fSmrgThe
54209ff23fSmrg.B radeon
5543df4709Smrgdriver supports PCI, AGP, and PCIE video cards based on the following ATI chips
5640732134Srjs(note: list is non-exhaustive):
57b7e1c893Smrg.PP
58b7e1c893Smrg.PD 0
59209ff23fSmrg.TP 12
60209ff23fSmrg.B R100
61209ff23fSmrgRadeon 7200
62209ff23fSmrg.TP 12
63209ff23fSmrg.B RV100
64209ff23fSmrgRadeon 7000(VE), M6, RN50/ES1000
65209ff23fSmrg.TP 12
66209ff23fSmrg.B RS100
67209ff23fSmrgRadeon IGP320(M)
68209ff23fSmrg.TP 12
69209ff23fSmrg.B RV200
70209ff23fSmrgRadeon 7500, M7, FireGL 7800
71209ff23fSmrg.TP 12
72209ff23fSmrg.B RS200
73209ff23fSmrgRadeon IGP330(M)/IGP340(M)
74209ff23fSmrg.TP 12
75209ff23fSmrg.B RS250
76209ff23fSmrgRadeon Mobility 7000 IGP
77209ff23fSmrg.TP 12
78209ff23fSmrg.B R200
79209ff23fSmrgRadeon 8500, 9100, FireGL 8800/8700
80209ff23fSmrg.TP 12
81209ff23fSmrg.B RV250
82209ff23fSmrgRadeon 9000PRO/9000, M9
83209ff23fSmrg.TP 12
84b7e1c893Smrg.B RV280
85b7e1c893SmrgRadeon 9200PRO/9200/9200SE/9250, M9+
86b7e1c893Smrg.TP 12
87209ff23fSmrg.B RS300
88209ff23fSmrgRadeon 9100 IGP
89209ff23fSmrg.TP 12
90209ff23fSmrg.B RS350
91209ff23fSmrgRadeon 9200 IGP
92209ff23fSmrg.TP 12
93209ff23fSmrg.B RS400/RS480
94209ff23fSmrgRadeon XPRESS 200(M)/1100 IGP
95209ff23fSmrg.TP 12
96209ff23fSmrg.B R300
97209ff23fSmrgRadeon 9700PRO/9700/9500PRO/9500/9600TX, FireGL X1/Z1
98209ff23fSmrg.TP 12
99209ff23fSmrg.B R350
100209ff23fSmrgRadeon 9800PRO/9800SE/9800, FireGL X2
101209ff23fSmrg.TP 12
102209ff23fSmrg.B R360
103209ff23fSmrgRadeon 9800XT
104209ff23fSmrg.TP 12
105209ff23fSmrg.B RV350
106209ff23fSmrgRadeon 9600PRO/9600SE/9600/9550, M10/M11, FireGL T2
107209ff23fSmrg.TP 12
108209ff23fSmrg.B RV360
109209ff23fSmrgRadeon 9600XT
110209ff23fSmrg.TP 12
111209ff23fSmrg.B RV370
112209ff23fSmrgRadeon X300, M22
113209ff23fSmrg.TP 12
114209ff23fSmrg.B RV380
115209ff23fSmrgRadeon X600, M24
116209ff23fSmrg.TP 12
117209ff23fSmrg.B RV410
11843df4709SmrgRadeon X700, M26 PCIE
119209ff23fSmrg.TP 12
120209ff23fSmrg.B R420
121209ff23fSmrgRadeon X800 AGP
122209ff23fSmrg.TP 12
123209ff23fSmrg.B R423/R430
12443df4709SmrgRadeon X800, M28 PCIE
125209ff23fSmrg.TP 12
126209ff23fSmrg.B R480/R481
12743df4709SmrgRadeon X850 PCIE/AGP
128209ff23fSmrg.TP 12
129209ff23fSmrg.B RV505/RV515/RV516/RV550
13040732134SrjsRadeon X1300/X1400/X1500/X1550/X2300
131209ff23fSmrg.TP 12
132209ff23fSmrg.B R520
133209ff23fSmrgRadeon X1800
134209ff23fSmrg.TP 12
135209ff23fSmrg.B RV530/RV560
136209ff23fSmrgRadeon X1600/X1650/X1700
137209ff23fSmrg.TP 12
138209ff23fSmrg.B RV570/R580
139209ff23fSmrgRadeon X1900/X1950
140209ff23fSmrg.TP 12
141b7e1c893Smrg.B RS600/RS690/RS740
142b7e1c893SmrgRadeon X1200/X1250/X2100
143209ff23fSmrg.TP 12
144209ff23fSmrg.B R600
145209ff23fSmrgRadeon HD 2900
146209ff23fSmrg.TP 12
147209ff23fSmrg.B RV610/RV630
14840732134SrjsRadeon HD 2400/2600/2700/4200/4225/4250
149209ff23fSmrg.TP 12
150209ff23fSmrg.B RV620/RV635
15140732134SrjsRadeon HD 3410/3430/3450/3470/3650/3670
152209ff23fSmrg.TP 12
153b7e1c893Smrg.B RV670
15440732134SrjsRadeon HD 3690/3850/3870
155b7e1c893Smrg.TP 12
15640732134Srjs.B RS780/RS880
15740732134SrjsRadeon HD 3100/3200/3300/4100/4200/4250/4290
158b7e1c893Smrg.TP 12
15940732134Srjs.B RV710/RV730
16040732134SrjsRadeon HD 4330/4350/4550/4650/4670/5145/5165/530v/545v/560v/565v
161921a55d8Smrg.TP 12
16240732134Srjs.B RV740/RV770/RV790
16340732134SrjsRadeon HD 4770/4730/4830/4850/4860/4870/4890
164921a55d8Smrg.TP 12
165921a55d8Smrg.B CEDAR
16640732134SrjsRadeon HD 5430/5450/6330/6350/6370
167921a55d8Smrg.TP 12
168921a55d8Smrg.B REDWOOD
16940732134SrjsRadeon HD 5550/5570/5650/5670/5730/5750/5770/6530/6550/6570
170921a55d8Smrg.TP 12
171921a55d8Smrg.B JUNIPER
17240732134SrjsRadeon HD 5750/5770/5830/5850/5870/6750/6770/6830/6850/6870
173921a55d8Smrg.TP 12
174921a55d8Smrg.B CYPRESS
17540732134SrjsRadeon HD 5830/5850/5870
176921a55d8Smrg.TP 12
177921a55d8Smrg.B HEMLOCK
178921a55d8SmrgRadeon HD 5970
179921a55d8Smrg.TP 12
180921a55d8Smrg.B PALM
181921a55d8SmrgRadeon HD 6310/6250
182b13dfe66Smrg.TP 12
18340732134Srjs.B SUMO/SUMO2
18440732134SrjsRadeon HD 6370/6380/6410/6480/6520/6530/6550/6620
18540732134Srjs.TP 12
186b13dfe66Smrg.B BARTS
18740732134SrjsRadeon HD 6790/6850/6870/6950/6970/6990
188b13dfe66Smrg.TP 12
189b13dfe66Smrg.B TURKS
19040732134SrjsRadeon HD 6570/6630/6650/6670/6730/6750/6770
191b13dfe66Smrg.TP 12
192b13dfe66Smrg.B CAICOS
19340732134SrjsRadeon HD 6430/6450/6470/6490
194c4ae5be6Smrg.TP 12
195c4ae5be6Smrg.B CAYMAN
196c4ae5be6SmrgRadeon HD 6950/6970/6990
19740732134Srjs.TP 12
19840732134Srjs.B ARUBA
199b7e1c893Smrg.PD
200209ff23fSmrg.SH CONFIGURATION DETAILS
201209ff23fSmrgPlease refer to __xconfigfile__(__filemansuffix__) for general configuration
202209ff23fSmrgdetails.  This section only covers configuration details specific to this
203209ff23fSmrgdriver.
204209ff23fSmrg.PP
20543df4709SmrgThe driver auto\-detects all device information necessary to initialize
20643df4709Smrgthe card.  However, if you have problems with auto\-detection, you can
20743df4709Smrgspecify for UMS (Userspace Modesetting):
20843df4709Smrg.PP
20943df4709Smrg.RS 4
21043df4709SmrgVideoRam \- in kilobytes
21143df4709Smrg.br
21243df4709SmrgMemBase  \- physical address of the linear framebuffer
21343df4709Smrg.br
21443df4709SmrgIOBase   \- physical address of the MMIO registers
21543df4709Smrg.br
21643df4709SmrgChipID   \- PCI DEVICE ID
21743df4709Smrg.RE
21843df4709Smrg.PP
21943df4709SmrgIn addition, the following driver
220209ff23fSmrg.B Options
22143df4709Smrgare supported for both
22243df4709Smrg.B UMS
22343df4709Smrg(Userspace Modesetting) and
22443df4709Smrg.B KMS
22543df4709Smrg(Kernel Modesetting):
226209ff23fSmrg.TP
227209ff23fSmrg.BI "Option \*qSWcursor\*q \*q" boolean \*q
228209ff23fSmrgSelects software cursor.  The default is
229209ff23fSmrg.B off.
230209ff23fSmrg.TP
23143df4709Smrg.BI "Option \*qNoAccel\*q \*q" boolean \*q
232209ff23fSmrgEnables or disables all hardware acceleration.
233209ff23fSmrg.br
23443df4709SmrgThe default is to
23543df4709Smrg.B enable
23643df4709Smrghardware acceleration.
237209ff23fSmrg.TP
238921a55d8Smrg.BI "Option \*qZaphodHeads\*q \*q" string \*q
239921a55d8SmrgSpecify the RandR output(s) to use with zaphod mode for a particular driver
240c4ae5be6Smrginstance.  If you use this option you must use this option for all instances
241921a55d8Smrgof the driver.
242921a55d8Smrg.br
243921a55d8SmrgFor example:
244921a55d8Smrg.B
245921a55d8SmrgOption \*qZaphodHeads\*q \*qLVDS,VGA-0\*q
246921a55d8Smrgwill assign xrandr outputs LVDS and VGA-0 to this instance of the driver.
247921a55d8Smrg.TP
24843df4709Smrg.BI "Option \*qEXAVSync\*q \*q" boolean \*q
24943df4709SmrgThis option attempts to avoid tearing by stalling the engine until the display
25043df4709Smrgcontroller has passed the destination region.  It reduces tearing at the cost
25143df4709Smrgof performance and has been known to cause instability on some chips.
25243df4709SmrgThe default is
25343df4709Smrg.B off.
25443df4709Smrg
25543df4709Smrg.PP
25643df4709SmrgThe following driver
25743df4709Smrg.B Options
25843df4709Smrgare supported for
25943df4709Smrg.B KMS
26043df4709Smrg(Kernel Modesetting):
26143df4709Smrg.TP
262921a55d8Smrg.BI "Option \*qColorTiling\*q \*q" "boolean" \*q
263921a55d8SmrgThe framebuffer can be addressed either in linear or tiled mode. Tiled mode can provide
264921a55d8Smrgsignificant performance benefits with 3D applications.  Tiling will be disabled if the drm
26540732134Srjsmodule is too old or if the current display configuration does not support it.  On R600+
26640732134Srjsthis enables 1D tiling mode.
267921a55d8Smrg.br
268921a55d8SmrgThe default value is
269921a55d8Smrg.B on
27040732134Srjsfor R/RV3XX, R/RV4XX, R/RV5XX, RS6XX, RS740, R/RV6XX, R/RV7XX, RS780, RS880,
27143df4709SmrgEVERGREEN, and CAYMAN and
27240732134Srjs.B off
27343df4709Smrgfor R/RV/RS1XX, R/RV/RS2XX, and RS3XX.
27440732134Srjs.TP
27540732134Srjs.BI "Option \*qColorTiling2D\*q \*q" "boolean" \*q
27640732134SrjsThe framebuffer can be addressed either in linear, 1D, or 2D tiled modes. 2D tiled mode can
27740732134Srjsprovide significant performance benefits over 1D tiling with 3D applications.  Tiling
27840732134Srjswill be disabled if the drm module is too old or if the current display configuration
27943df4709Smrgdoes not support it. KMS ColorTiling2D is only supported on R600 and newer chips.
28040732134Srjs.br
28140732134SrjsThe default value is
28243df4709Smrg.B off
28343df4709Smrgfor R/RV6XX, R/RV7XX, RS780, RS880, EVERGREEN, and CAYMAN.
28443df4709Smrg.TP
28543df4709Smrg.BI "Option \*qEXAPixmaps\*q \*q" boolean \*q
28643df4709SmrgUnder KMS, to avoid thrashing pixmaps in/out of VRAM on low memory cards,
28743df4709Smrgwe use a heuristic based on VRAM amount to determine whether to allow EXA
28843df4709Smrgto use VRAM for non-essential pixmaps.  This option allows us to override the
28943df4709Smrgheuristic.  The default is
290921a55d8Smrg.B on
29143df4709Smrgwith > 32MB VRAM, off with < 32MB.
292921a55d8Smrg.TP
29343df4709Smrg.BI "Option \*qSwapbuffersWait\*q \*q" boolean \*q
29443df4709SmrgThis option controls the behavior of glXSwapBuffers and glXCopySubBufferMESA
29543df4709Smrgcalls by GL applications.  If enabled, the calls will avoid tearing by making
29643df4709Smrgsure the display scanline is outside of the area to be copied before the copy
29743df4709Smrgoccurs.  If disabled, no scanline synchronization is performed, meaning tearing
29843df4709Smrgwill likely occur.  Note that when enabled, this option can adversely affect
29943df4709Smrgthe framerate of applications that render frames at less than refresh rate.
30043df4709Smrg.IP
30143df4709SmrgThe default value is
30243df4709Smrg.B on.
303921a55d8Smrg.TP
304921a55d8Smrg.BI "Option \*qEnablePageFlip\*q \*q" boolean \*q
305921a55d8SmrgEnable DRI2 page flipping.  The default is
306921a55d8Smrg.B on.
307921a55d8SmrgPageflipping is supported on all radeon hardware.
30843df4709Smrg.PP
30943df4709SmrgThe following driver
31043df4709Smrg.B Options
31143df4709Smrgare supported for
31243df4709Smrg.B UMS
31343df4709Smrg(Userspace Modesetting):
314921a55d8Smrg.TP
31543df4709Smrg.BI "Option \*qDac6Bit\*q \*q" boolean \*q
31643df4709SmrgEnables or disables the use of 6 bits per color component when in 8 bpp
31743df4709Smrgmode (emulates VGA mode).  By default, all 8 bits per color component
31843df4709Smrgare used.
31943df4709Smrg.br
32043df4709SmrgThe default is
321209ff23fSmrg.B off.
322209ff23fSmrg.TP
32343df4709Smrg.BI "Option \*qVideoKey\*q \*q" integer \*q
32443df4709SmrgThis overrides the default pixel value for the YUV video overlay key.
32543df4709Smrg.br
32643df4709SmrgThe default value is
32743df4709Smrg.B 0x1E.
32843df4709Smrg.TP
32943df4709Smrg.BI "Option \*qScalerWidth\*q \*q" integer \*q
33043df4709SmrgThis sets the overlay scaler buffer width. Accepted values range from
33143df4709Smrg1024 to 2048, divisible by 64.  Values other than 1536 and 1920 may
33243df4709Smrgnot make sense.  This should be set automatically, but no one knows
33343df4709Smrgwhat the limit is for which chip. If you think quality is not optimal
33443df4709Smrgwhen playing back HD video (with horizontal resolution larger than
33543df4709Smrgthis setting), increase this value.  If you get an empty area at the
33643df4709Smrgright (usually pink), decrease it. Note that this only affects the "true"
33743df4709Smrgoverlay via Xv, and won't affect things like textured video.
33843df4709Smrg.br
33943df4709SmrgThe default value is either 1536 (for most chips) or 1920.
34043df4709Smrg.TP
34143df4709Smrg.BI "Option \*qAGPMode\*q \*q" integer \*q
34243df4709SmrgSet AGP data transfer rate.
34343df4709Smrg(used only when DRI is enabled)
34443df4709Smrg.br
34543df4709Smrg1      \-\- 1x (before AGP v3 only)
34643df4709Smrg.br
34743df4709Smrg2      \-\- 2x (before AGP v3 only)
34843df4709Smrg.br
34943df4709Smrg4      \-\- 4x
35043df4709Smrg.br
35143df4709Smrg8      \-\- 8x (AGP v3 only)
35243df4709Smrg.br
35343df4709Smrgothers \-\- invalid
35443df4709Smrg.br
35543df4709SmrgThe default is to
35643df4709Smrg.B leave it unchanged.
35743df4709Smrg.TP
35843df4709Smrg.BI "Option \*qAGPFastWrite\*q \*q" boolean \*q
35943df4709SmrgEnable AGP fast writes.  Enabling this is frequently the cause of
36043df4709Smrginstability. Used only when the DRI is enabled. If you enable
36143df4709Smrgthis option you will get *NO* support from developers.
36243df4709Smrg.br
36343df4709SmrgThe default is
36443df4709Smrg.B off.
36543df4709Smrg.TP
36643df4709Smrg.BI "Option \*qBusType\*q \*q" string \*q
36743df4709SmrgUsed to replace previous ForcePCIMode option.
36843df4709SmrgShould only be used when driver's bus detection is incorrect
36943df4709Smrgor you want to force an AGP card to PCI mode. You should NEVER force
37043df4709Smrga PCI card to AGP bus.
37143df4709Smrg.br
37243df4709SmrgPCI    \-\- PCI bus
37343df4709Smrg.br
37443df4709SmrgAGP    \-\- AGP bus
37543df4709Smrg.br
37643df4709SmrgPCIE   \-\- PCI Express bus
37743df4709Smrg.br
37843df4709Smrg(used only when DRI is enabled)
37943df4709Smrg.br
38043df4709SmrgThe default is
38143df4709Smrg.B auto detect.
38243df4709Smrg.TP
38343df4709Smrg.BI "Option \*qDisplayPriority\*q \*q" string \*q
38443df4709Smrg.br
38543df4709SmrgUsed to prevent flickering or tearing problem caused by display buffer underflow.
38643df4709Smrg.br
38743df4709SmrgAUTO   \-\- Driver calculated (default).
38843df4709Smrg.br
38943df4709SmrgBIOS   \-\- Remain unchanged from BIOS setting.
39043df4709Smrg          Use this if the calculation is not correct
39143df4709Smrg          for your card.
39243df4709Smrg.br
39343df4709SmrgHIGH   \-\- Force to the highest priority.
39443df4709Smrg          Use this if you have problem with above options.
39543df4709Smrg          This may affect performance slightly.
39643df4709Smrg.br
39743df4709SmrgThe default value is
39843df4709Smrg.B AUTO.
39943df4709Smrg.TP
40043df4709Smrg.BI "Option \*qColorTiling\*q \*q" "boolean" \*q
40143df4709SmrgThe framebuffer can be addressed either in linear or tiled mode. Tiled mode can provide
40243df4709Smrgsignificant performance benefits with 3D applications.  For 2D it shouldn't matter
40343df4709Smrgmuch. Tiling will be disabled if the virtual x resolution exceeds 2048 (3968 for R300 
40443df4709Smrgand above), or if DRI is enabled and the drm module is too old.
40543df4709Smrg.br
40643df4709SmrgIf this option is enabled, a new DRI driver is required for direct rendering.
40743df4709Smrg.br
40843df4709SmrgColor tiling will be automatically disabled in interlaced or doublescan screen modes.
40943df4709Smrg.br
41043df4709SmrgThe default value is
41143df4709Smrg.B on.
41243df4709Smrg.TP 
41343df4709Smrg.BI "Option \*qIgnoreEDID\*q \*q" boolean \*q
41443df4709SmrgDo not use EDID data for mode validation.  DDC is still used
41543df4709Smrgfor monitor detection. This is different from NoDDC option.
41643df4709Smrg.br
41743df4709SmrgThe default value is
41843df4709Smrg.B off.
41943df4709Smrg.TP 
42043df4709Smrg.BI "Option \*qCustomEDID\*q \*q" string \*q
42143df4709SmrgForces the X driver to use the EDID data specified in a file rather
42243df4709Smrgthan the display's EDID. Also overrides DDC monitor detection.
42343df4709Smrg.br
42443df4709SmrgYou may specify a semicolon-separated list of output name and filename pairs
42543df4709Smrgwith an optional flag, "digital" or "analog", to override the digital bit in
42643df4709Smrgthe EDID which is used by the driver to determine whether to use the
42743df4709Smrganalog or digital encoder associated with a DVI-I port.
42843df4709SmrgThe output name is the RandR output name, e.g., "VGA-0" or "DVI-0";
42943df4709Smrgconsult the Xorg log for the supported output names of any given system.
43043df4709Smrg.br
43143df4709SmrgThe file must contain a raw 128-byte EDID block, as captured by
43243df4709Smrg.B
43343df4709Smrgget-edid.
43443df4709Smrg.br
43543df4709SmrgFor example:
43643df4709Smrg.B
43743df4709SmrgOption \*qCustomEDID\*q \*qVGA-0:/tmp/edid1.bin; DVI-0:/tmp/edid2.bin:digital\*q
43843df4709Smrgwill assign the EDID from the file /tmp/edid1.bin to the output device
43943df4709SmrgVGA-0, and the EDID from the file /tmp/edid2.bin to the output device
44043df4709SmrgDVI-0 and force the DVI port to use the digital encoder.
44143df4709Smrg.br
44243df4709SmrgNote that an output name must always be specified,
44343df4709Smrgeven if only one EDID is specified.
44443df4709Smrg.br
44543df4709Smrg.B
44643df4709SmrgCaution:
44743df4709SmrgSpecifying an EDID that doesn't exactly match your display may
44843df4709Smrgdamage your hardware, as it allows the driver to specify timings beyond
44943df4709Smrgthe capabilities of your display. Use with care.
45043df4709Smrg.TP 
45143df4709Smrg.BI "Option \*qPanelSize\*q \*q" "string" \*q
45243df4709SmrgShould only be used when driver cannot detect the correct panel size.
45343df4709SmrgApply to both desktop (TMDS) and laptop (LVDS) digital panels.
45443df4709SmrgWhen a valid panel size is specified, the timings collected from
45543df4709SmrgDDC and BIOS will not be used. If you have a panel with timings
45643df4709Smrgdifferent from that of a standard VESA mode, you have to provide
45743df4709Smrgthis information through the Modeline.
45843df4709Smrg.br
45943df4709SmrgFor example, Option "PanelSize" "1400x1050"
46043df4709Smrg.br
46143df4709SmrgThe default value is
46243df4709Smrg.B none.
46343df4709Smrg.TP
46443df4709Smrg.BI "Option \*qEnablePageFlip\*q \*q" boolean \*q
46543df4709SmrgEnable page flipping for 3D acceleration. This will increase performance
46643df4709Smrgbut not work correctly in some rare cases, hence the default is
46743df4709Smrg.B off.
46843df4709SmrgIt is currently only supported on R/RV/RS4xx and older hardware.
46943df4709Smrg.TP
47043df4709Smrg.BI "Option \*qForceMinDotClock\*q \*q" frequency \*q
47143df4709SmrgOverride minimum dot clock. Some Radeon BIOSes report a minimum dot
47243df4709Smrgclock unsuitable (too high) for use with television sets even when they
47343df4709Smrgactually can produce lower dot clocks. If this is the case you can
47443df4709Smrgoverride the value here.
47543df4709Smrg.B Note that using this option may damage your hardware.
47643df4709SmrgYou have been warned. The
47743df4709Smrg.B frequency
47843df4709Smrgparameter may be specified as a float value with standard suffixes like
47943df4709Smrg"k", "kHz", "M", "MHz".
48043df4709Smrg.TP
48143df4709Smrg.BI "Option \*qRenderAccel\*q \*q" boolean \*q
48243df4709SmrgEnables or disables hardware Render acceleration.  It is supported on all
48343df4709SmrgRadeon cards when using EXA acceleration and on Radeon R/RV/RS1xx,
48443df4709SmrgR/RV/RS2xx and RS3xx when using XAA.  The default is to
48543df4709Smrg.B enable
48643df4709SmrgRender acceleration.
48743df4709Smrg.TP
488209ff23fSmrg.BI "Option \*qAccelMethod\*q \*q" "string" \*q
48943df4709SmrgChooses between available acceleration architectures.  Valid options are
49043df4709Smrg.B XAA
49143df4709Smrgand
49243df4709Smrg.B EXA.
49343df4709SmrgXAA is the traditional acceleration architecture and support for it is very
49443df4709Smrgstable.  EXA is a newer acceleration architecture with better performance for
49543df4709Smrgthe Render and Composite extensions.  The default is
496ad43ddacSmrg.B EXA.
49743df4709Smrg.TP
49843df4709Smrg.BI "Option \*qAccelDFS\*q \*q" boolean \*q
49943df4709SmrgUse or don't use accelerated EXA DownloadFromScreen hook when possible (only
50043df4709Smrgwhen Direct Rendering is enabled, e.g.).
50143df4709SmrgDefault:
50243df4709Smrg.B off
50343df4709Smrgwith AGP due to issues with GPU->host transfers with some AGP bridges,
50443df4709Smrg.B on
50543df4709Smrgotherwise.
50643df4709Smrg.TP
50743df4709Smrg.BI "Option \*qFBTexPercent\*q \*q" integer \*q
50843df4709SmrgAmount of video RAM to reserve for OpenGL textures, in percent. With EXA, the
50943df4709Smrgremainder of video RAM is reserved for EXA offscreen management. Specifying 0
51043df4709Smrgresults in all offscreen video RAM being reserved for EXA and only GART memory
51143df4709Smrgbeing available for OpenGL textures. This may improve EXA performance, but
51243df4709Smrgbeware that it may cause problems with OpenGL drivers from Mesa versions older
51343df4709Smrgthan 6.4. With XAA, specifying lower percentage than what gets reserved without
51443df4709Smrgthis option has no effect, but the driver tries to increase the video RAM
51543df4709Smrgreserved for textures to the amount specified roughly.
51643df4709SmrgDefault:
51743df4709Smrg.B 50.
51843df4709Smrg.TP
51943df4709Smrg.BI "Option \*qDepthBits\*q \*q" integer \*q
52043df4709SmrgPrecision in bits per pixel of the shared depth buffer used for 3D acceleration.
52143df4709SmrgValid values are 16 and 24. When this is 24, there will also be a hardware
52243df4709Smrgaccelerated stencil buffer, but the combined depth/stencil buffer will take up
52343df4709Smrgtwice as much video RAM as when it's 16.
52443df4709SmrgDefault:
52543df4709Smrg.B The same as the screen depth.
52643df4709Smrg.TP
52743df4709Smrg.BI "Option \*qDMAForXv\*q \*q" boolean \*q
52843df4709SmrgTry or don't try to use DMA for Xv image transfers. This will reduce CPU
52943df4709Smrgusage when playing big videos like DVDs, but may cause instabilities.
53043df4709SmrgDefault:
53143df4709Smrg.B on.
53243df4709Smrg.TP
53343df4709Smrg.BI "Option \*qSubPixelOrder\*q \*q" "string" \*q
53443df4709SmrgForce subpixel order to specified order.
53543df4709SmrgSubpixel order is used for subpixel decimation on flat panels.
53643df4709Smrg.br
53743df4709SmrgNONE   \-\- No subpixel (CRT like displays)
53843df4709Smrg.br
53943df4709SmrgRGB    \-\- in horizontal RGB order (most flat panels)
54043df4709Smrg.br
54143df4709SmrgBGR    \-\- in horizontal BGR order (some flat panels)
542209ff23fSmrg
54343df4709Smrg.br
54443df4709SmrgThis option is intended to be used in following cases:
54543df4709Smrg.br
54643df4709Smrg1. The default subpixel order is incorrect for your panel.
54743df4709Smrg.br
54843df4709Smrg2. Enable subpixel decimation on analog panels.
54943df4709Smrg.br
55043df4709Smrg3. Adjust to one display type in dual-head clone mode setup.
55143df4709Smrg.br
55243df4709Smrg4. Get better performance with Render acceleration on
55343df4709Smrgdigital panels (use NONE setting).
55443df4709Smrg.br
55543df4709SmrgThe default is 
55643df4709Smrg.B NONE 
55743df4709Smrgfor CRT, 
55843df4709Smrg.B RGB 
55943df4709Smrgfor digital panels
56043df4709Smrg.TP
56143df4709Smrg.BI "Option \*qClockGating\*q \*q" boolean \*q
56243df4709SmrgEnable dynamic clock gating.  This can help reduce heat and increase battery
56343df4709Smrglife by reducing power usage.  Some users report reduced 3D performance
56443df4709Smrgwith this enabled.  The default is
56543df4709Smrg.B off.
56643df4709Smrg.TP
56743df4709Smrg.BI "Option \*qForceLowPowerMode\*q \*q" boolean \*q
56843df4709SmrgEnable a static low power mode.  This can help reduce heat and increase battery
56943df4709Smrglife by reducing power usage at the expense of performance. The default is
57043df4709Smrg.B off.
57143df4709Smrg.TP
57243df4709Smrg.BI "Option \*qDynamicPM\*q \*q" boolean \*q
57343df4709SmrgEnable dynamic power mode switching.  This can help reduce heat and increase battery
57443df4709Smrglife by reducing power usage when the system is idle (DPMS active). The default is
57543df4709Smrg.B off.
57643df4709Smrg.TP
57743df4709Smrg.BI "Option \*qVGAAccess\*q \*q" boolean \*q
57843df4709SmrgTell the driver if it can do legacy VGA IOs to the card. This is
57943df4709Smrgnecessary for properly resuming consoles when in VGA text mode, but
58043df4709Smrgshouldn't be if the console is using radeonfb or some other graphic
58143df4709Smrgmode driver. Some platforms like PowerPC have issues with those, and they aren't
58243df4709Smrgnecessary unless you have a real text mode in console. The default is
58343df4709Smrg.B off
58443df4709Smrgon PowerPC and SPARC and
58543df4709Smrg.B on
58643df4709Smrgon other architectures.
58743df4709Smrg.TP
58843df4709Smrg.BI "Option \*qReverseDDC\*q \*q" boolean \*q
58943df4709SmrgWhen BIOS connector information isn't available, use this option to
59043df4709Smrgreverse the mapping of the two main DDC ports. Use this if the X server
59143df4709Smrgobviously detects the wrong display for each connector. This is
59243df4709Smrgtypically needed on the Radeon 9600 cards bundled with Apple G5s. The
59343df4709Smrgdefault is
59443df4709Smrg.B off.
59543df4709Smrg.TP
59643df4709Smrg.BI "Option \*qLVDSProbePLL\*q \*q" boolean \*q
59743df4709SmrgWhen BIOS panel information isn't available (like on PowerBooks), it
59843df4709Smrgmay still be necessary to use the firmware-provided PLL values for the
59943df4709Smrgpanel or flickering will happen. This option will force probing of
60043df4709Smrgthe current value programmed in the chip when X is launched in that
60143df4709Smrgcase.  This is only useful for LVDS panels (laptop internal panels).
60243df4709SmrgThe default is
60343df4709Smrg.B on.
60443df4709Smrg.TP
60543df4709Smrg.BI "Option \*qTVDACLoadDetect\*q \*q" boolean \*q
60643df4709SmrgEnable load detection on the TV DAC.  The TV DAC is used to drive both
60743df4709SmrgTV-out and analog monitors. Load detection is often unreliable in the
60843df4709SmrgTV DAC so it is disabled by default.
609209ff23fSmrgThe default is
610209ff23fSmrg.B off.
611209ff23fSmrg.TP
61243df4709Smrg.BI "Option \*qDefaultTMDSPLL\*q \*q" boolean \*q
61343df4709SmrgUse the default driver provided TMDS PLL values rather than the ones
61443df4709Smrgprovided by the BIOS. This option has no effect on Mac cards.  Enable
61543df4709Smrgthis option if you are having problems with a DVI monitor using the
61643df4709Smrginternal TMDS controller.
617209ff23fSmrgThe default is
618209ff23fSmrg.B off.
619209ff23fSmrg.TP
62043df4709Smrg.BI "Option \*qDefaultTVDACAdj\*q \*q" boolean \*q
62143df4709SmrgUse the default driver provided TVDAC Adj values rather than the ones
62243df4709Smrgprovided by the BIOS. This option has no effect on Mac cards.  Enable
62343df4709Smrgthis option if you are having problems with a washed out display on
62443df4709Smrgthe secondary DAC.
62543df4709SmrgThe default is
62643df4709Smrg.B off.
627209ff23fSmrg.TP
62843df4709Smrg.BI "Option \*qDRI\*q \*q" boolean \*q
62943df4709SmrgEnable DRI support.  This option allows you to enable to disable the DRI.
63043df4709SmrgThe default is
63143df4709Smrg.B off 
63243df4709Smrgfor RN50/ES1000 and
63343df4709Smrg.B on 
63443df4709Smrgfor others.
63543df4709Smrg.TP
63643df4709Smrg.BI "Option \*qDefaultConnectorTable\*q \*q" boolean \*q
63743df4709SmrgEnable this option to skip the BIOS connector table parsing and use the
63843df4709Smrgdriver defaults for each chip.
63943df4709SmrgThe default is
64043df4709Smrg.B off 
64143df4709Smrg.TP
64243df4709Smrg.BI "Option \*qMacModel\*q \*q" string \*q
64343df4709Smrg.br
64443df4709SmrgUsed to specify Mac models for connector tables and quirks.  If you have
64543df4709Smrga PowerBook or Mini with DVI that does not work properly, try the alternate
64643df4709Smrgoptions as Apple does not seem to provide a good way of knowing whether
64743df4709Smrgthey use internal or external TMDS for DVI.  Only valid on PowerPC.
64843df4709SmrgOn Linux, the driver will attempt to detect the MacModel automatically.
64943df4709Smrg.br
65043df4709Smrgibook                \-\- ibooks
65143df4709Smrg.br
65243df4709Smrgpowerbook-external   \-\- Powerbooks with external DVI
65343df4709Smrg.br
65443df4709Smrgpowerbook-internal   \-\- Powerbooks with integrated DVI
65543df4709Smrg.br
65643df4709Smrgpowerbook-vga        \-\- Powerbooks with VGA rather than DVI
65743df4709Smrg.br
65843df4709Smrgmini-external        \-\- Mac Mini with external DVI
65943df4709Smrg.br
66043df4709Smrgmini-internal        \-\- Mac Mini with integrated DVI
66143df4709Smrg.br
66243df4709Smrgimac-g5-isight       \-\- iMac G5 iSight
66343df4709Smrg.br
66443df4709Smrgemac                 \-\- eMac G4
66543df4709Smrg.br
66643df4709Smrgsam440ep             \-\- SAM440ep embedded board
66743df4709Smrg.br
66843df4709SmrgThe default value is
66943df4709Smrg.B undefined.
67043df4709Smrg.TP
67143df4709Smrg.BI "Option \*qTVStandard\*q \*q" string \*q
67243df4709Smrg.br
67343df4709SmrgUsed to specify the default TV standard if you want to use something other than
67443df4709Smrgthe BIOS default. Valid options are:
67543df4709Smrg.br
67643df4709Smrgntsc
67743df4709Smrg.br
67843df4709Smrgpal
67943df4709Smrg.br
68043df4709Smrgpal-m
68143df4709Smrg.br
68243df4709Smrgpal-60
68343df4709Smrg.br
68443df4709Smrgntsc-j
68543df4709Smrg.br
68643df4709Smrgscart-pal
68743df4709Smrg.br
688209ff23fSmrgThe default value is
68943df4709Smrg.B undefined.
69043df4709Smrg.TP
69143df4709Smrg.BI "Option \*qForceTVOut\*q \*q" boolean \*q
69243df4709SmrgEnable this option to force TV-out to always be detected as attached.
69343df4709SmrgThe default is
69443df4709Smrg.B off 
69543df4709Smrg.TP
69643df4709Smrg.BI "Option \*qIgnoreLidStatus\*q \*q" boolean \*q
69743df4709SmrgEnable this option to ignore lid status on laptops and always detect
69843df4709SmrgLVDS as attached.
69943df4709SmrgThe default is
70043df4709Smrg.B on. 
70143df4709Smrg.TP
70243df4709Smrg.BI "Option \*qInt10\*q \*q" boolean \*q
70343df4709SmrgThis option allows you to disable INT10 initialization.  Set this to
70443df4709SmrgFalse if you are experiencing a hang when initializing a secondary card.
70543df4709SmrgThe default is
706b7e1c893Smrg.B on.
70743df4709Smrg.TP 
70843df4709Smrg.BI "Option \*qATOMTvOut\*q \*q" boolean \*q
70943df4709SmrgThis option enables experimental TV-out support for R/RV5xx, R/RV6xx, and R/RV7xx
71043df4709SmrgAtomBIOS chips. TV-out is experimental and may not function on these chips as
71143df4709Smrgwell as hoped for.
71243df4709SmrgThe default is
71343df4709Smrg.B off.
71443df4709Smrg.TP 
71543df4709Smrg.BI "Option \*qR4xxATOM\*q \*q" boolean \*q
71643df4709SmrgThis option enables modesetting on R/RV4xx chips using AtomBIOS.
71743df4709SmrgThe default is
71843df4709Smrg.B off.
719b7e1c893Smrg
720b7e1c893Smrg.SH TEXTURED VIDEO ATTRIBUTES
721b7e1c893SmrgThe driver supports the following X11 Xv attributes for Textured Video.
722b7e1c893SmrgYou can use the "xvattr" tool to query/set those attributes at runtime.
723b7e1c893Smrg
724209ff23fSmrg.TP
725b7e1c893Smrg.BI "XV_VSYNC"
726b7e1c893SmrgXV_VSYNC is used to control whether textured adapter synchronizes
727b7e1c893Smrgthe screen update to the monitor vertical refresh to eliminate tearing.
728b7e1c893SmrgIt has two values: 'off'(0) and 'on'(1). The default is
729b7e1c893Smrg.B 'on'(1).
730b7e1c893Smrg
731ad43ddacSmrg.TP
732ad43ddacSmrg.BI "XV_CRTC"
733ad43ddacSmrgXV_CRTC is used to control which display controller (crtc) the textured
734ad43ddacSmrgadapter synchronizes the screen update with when XV_VSYNC is enabled.
735ad43ddacSmrgThe default, 'auto'(-1), will sync to the display controller that more
73640732134Srjsof the video is on; when this is ambiguous, the display controller associated
73740732134Srjswith the RandR primary output is preferred.  This attribute is useful for
73840732134Srjsthings like clone mode where the user can best decide which display should be
73940732134Srjssynced.
740ad43ddacSmrgThe default is
741ad43ddacSmrg.B 'auto'(-1).
742ad43ddacSmrg
743b7e1c893Smrg.TP
744b7e1c893Smrg.BI "XV_BICUBIC"
745b7e1c893SmrgXV_BICUBIC is used to control whether textured adapter should apply
746b7e1c893Smrga bicubic filter to smooth the output. It has three values: 'off'(0), 'on'(1)
747b7e1c893Smrgand 'auto'(2). 'off' means never apply the filter, 'on' means always apply
748b7e1c893Smrgthe filter and 'auto' means apply the filter only if the X and Y
749ad43ddacSmrgsizes are scaled to more than double to avoid blurred output.  Bicubic
750ad43ddacSmrgfiltering is not currently compatible with other Xv attributes like hue,
751ad43ddacSmrgcontrast, and brightness, and must be disabled to use those attributes.
752b7e1c893SmrgThe default is
7532f39173dSmrg.B 'off'(0).
754209ff23fSmrg
755209ff23fSmrg.SH SEE ALSO
756b7e1c893Smrg__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
757b7e1c893Smrg.IP " 1." 4
758b7e1c893SmrgWiki page:
759b7e1c893Smrg.RS 4
760b7e1c893Smrghttp://www.x.org/wiki/radeon
761b7e1c893Smrg.RE
762b7e1c893Smrg.IP " 2." 4
763b7e1c893SmrgOverview about radeon development code:
764b7e1c893Smrg.RS 4
765b7e1c893Smrghttp://cgit.freedesktop.org/xorg/driver/xf86-video-ati/
766b7e1c893Smrg.RE
767b7e1c893Smrg.IP " 3." 4
768b7e1c893SmrgMailing list:
769b7e1c893Smrg.RS 4
770b7e1c893Smrghttp://lists.x.org/mailman/listinfo/xorg-driver-ati
771b7e1c893Smrg.RE
772b7e1c893Smrg.IP " 4." 4
773b7e1c893SmrgIRC channel:
774b7e1c893Smrg.RS 4
775b7e1c893Smrg#radeon on irc.freenode.net
776b7e1c893Smrg.RE
777b7e1c893Smrg.IP " 5." 4
778b7e1c893SmrgQuery the bugtracker for radeon bugs:
779b7e1c893Smrg.RS 4
780b7e1c893Smrghttps://bugs.freedesktop.org/query.cgi?product=xorg&component=Driver/Radeon
781b7e1c893Smrg.RE
782b7e1c893Smrg.IP " 6." 4
783b7e1c893SmrgSubmit bugs & patches:
784b7e1c893Smrg.RS 4
785b7e1c893Smrghttps://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver/Radeon
786b7e1c893Smrg.RE
787b7e1c893Smrg
788209ff23fSmrg.SH AUTHORS
789209ff23fSmrg.nf
790209ff23fSmrgAuthors include:
791209ff23fSmrgRickard E. (Rik) Faith   \fIfaith@precisioninsight.com\fP
792209ff23fSmrgKevin E. Martin          \fIkem@freedesktop.org\fP
793209ff23fSmrgAlan Hourihane           \fIalanh@fairlite.demon.co.uk\fP
794209ff23fSmrgMarc Aurele La France    \fItsi@xfree86.org\fP
795209ff23fSmrgBenjamin Herrenschmidt   \fIbenh@kernel.crashing.org\fP
79640732134SrjsMichel D\(:anzer            \fImichel@daenzer.net\fP
797209ff23fSmrgAlex Deucher             \fIalexdeucher@gmail.com\fP
798209ff23fSmrgBogdan D.                \fIbogdand@users.sourceforge.net\fP
799209ff23fSmrgEric Anholt              \fIeric@anholt.net\fP
800