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