--- ati-faq.xml.orig 2010-08-02 23:00:10.000000000 +0200 +++ ati-faq.xml 2010-10-04 00:03:08.582600638 +0200 @@ -17,6 +17,9 @@ Joshua Saddler + + Enrico Tagliavini + This FAQ should help users avoid some common installation and configuration @@ -27,12 +30,22 @@ -3 -2010-08-02 +3.1 +2010-10-03 Hardware Support
+ + +

+This guide is just an addition to the Gentoo X Server +HowTo so read it before using this guide +

+ + +
+
Is my ATI board supported? @@ -46,6 +59,10 @@ GPUs. Older GPUs will use the mature open source xorg-x11 driver.

+ +To find out what GPU your card is based on you can check http://en.wikipedia.org/wiki/Comparison_of_ATI_Graphics_Processing_Units + + @@ -133,37 +150,68 @@ + + + +Using the X11 implementation
-I have a laptop. Is my ATI Mobility model supported?

-It should be, but you may have a configuration issue due to the OEM PCI id that -such chips may have. In such cases, you may have to write the configuration -file yourself. +Please read the Gentoo X Server +HowTo and the Hardware Acceleration +Guide for more information on installing drivers for your ATI graphics +card.

-
- - -Installation
-Packages +Configuration + +If you are using radeon driver with KMS be sure fbcon is loaded, otherwise you +will get no framebuffer. You also need to disable all framebuffer +drivers from the kernel line in GRUB or LILO, like vesafb, uvesafb and +radeonfb. Also make sure radeon kernel module +is loaded before the X start. + +

-There are two ways of getting drivers for your ATI card: +You may not need to manually create xorg.conf or modify it. Try +running without it first. You can also use the Xorg auto configuration option:

-
    -
  • The xorg-x11 ebuild provides the X11 implementation
  • -
  • - The ati-drivers ebuild provides the ATI closed source X drivers and - kernel modules -
  • -
+
+# X -configure
+
+ + +X -configure is known to be broken with some cards, likely from r300 and newer, +so don't be surprised if it fails. This option will be removed in future +xorg-server versions. + + +

+For more information on how to get a basic xorg.conf configuration file, +please refer to the Gentoo X Server +HowTo. +

+ + +PPC, AMD64, and x86 users can use the xac stand-alone X configuration +tool by emerging x11-misc/xac, but isn't required. + + + +
+
+ +Installing the ATI propietary implementation +
+Kernel Setup +

If you want to use ATI's internal agpgart support instead of the Linux @@ -171,58 +219,135 @@ configuration) must be built as modules or not at all.

- -Please read the Hardware Acceleration -Guide for more information on installing drivers for your ATI graphics -card. - +

+To use ati-drivers you need to do the following changes to your kernel +configurations +

+
+
Enable
+
+
    +
  • MTRR
  • +
  • AGP if you have and agp card
  • +
  • PCIEPORTBUS if you have a PCIe card
  • +
  • ACPI
  • +
  • MAGIC_SYSRQ
  • +
  • PCI_MSI
  • +
  • MTRR
  • +
+
+
Build as module or disable
+
+
    +
  • DRM
  • +
+
+
Disable
+
+
    +
  1. FB_RADEON
  2. +
  3. PREEMPT_RCU
  4. +
  5. LOCKDEP
  6. +
+
+
-Configuration +Installing the driver

-You may not need to manually create xorg.conf or modify it. Try -running without it first. You can also use the Xorg auto configuration option: +You can install ati-drivers package in two ways:

-
-# X -configure
+
+
+
    +
  • + Add fglrx to VIDEO_CARDS in make.conf, + then run emerge -1N x11-base/xorg-drivers +
  • +
  • emerge x11-drivers/ati-drivers
  • +
+
+
+ +

+Be sure to autoload the fglrx kernel module: see the + +Kernel configuration part of the Gentoo Handbook if you are using +sys-apps/baselayout-1*. See the +openrc migration guide if you are using sys-apps/baselayout-2*. +Of course radeon and drm kernel module must be removed from autoload, +since they conflict with fglrx +

+ +

+If radeon kernel modules keeps loading you can blacklist it editing +/etc/modprobe.d/blacklist.conf +

+
+# blacklist radeon
 
+ +
+
+Configuration + +

-For more information on how to get a basic xorg.conf configuration file, -please refer to the Gentoo X Server -HowTo. +You must use an xorg.conf or an xorg.conf.d file with ati-drivers, +becouse you must tell xorg to use the fglrx driver. An easy way to do this is +using aticonfig:

- -PPC, AMD64, and x86 users can use the xac stand-alone X configuration -tool by emerging x11-misc/xac, but isn't required. - +
+# aticonfig --initial
+this will also create a backup of the original xorg.conf file
+
+for dual head configuration you can run
+# aticonfig --initial=dual-head
+
-You can use aticonfig if you have installed the ati-drivers -package. +More options can be set, refer to aticonfig --help - -If you're using ati-drivers, then you'll need to disable radeonfb -(and probably any other framebuffer drivers) in your kernel config, as it -conflicts with the built-in framebuffer in ati-drivers. - +

+By building ati-drivers with qt4 USE flag, you will be able to +use the amdcccle graphic configuration tool to easly configuring the drivers +options, and xorg.conf +

+ +

+If you wish to do it manually you have to specify Driver "fglrx" in +the Device Section. It is suggested to always use aticonfig to tweak the driver +config and xorg.conf to avoid conflicting option like: +

+ +
+Driver "fglrx"
+Option "Textured2D" "on"
+Option "TexturedXRender" "on"
+
+ +

+which couses an Xorg segmentation fault. It is a good policy to keep the +default options with this driver. +

-Switching to OpenGL +Switching to ATI OpenGL

-Once X is installed, configured, and running, it can use the ATI OpenGL -libraries: +Once X is installed and configured you must use the ATI OpenGL implementation, you will get a +black screen at X startup without this using ati-drivers

GPU