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