AMD Catalyst (previous fglrx: FireGL and Radeon for X ) is the proprietary graphics driver for AMD/ATI graphic cards. The open source alternative is radeon.
To choose the right driver, first detect the graphics card. You can use lspci for this task:
If you have an AGP card, also detect the chipset supporting AGP:
|Product name||Driver version||X server (max)||Bus||Note|
|Radeon HD 5000 and newer||13.6_beta||1.14||PCIe|
|Radeon HD 5000 and newer||13.4||1.13||PCIe|
|Radeon HD 2000 - 4000||13.1_pre897||1.12.49||PCIe or AGP||Mask ati-drivers slot 1 and newer, see the instructions under the table|
|Radeon HD 1000 and older||Use radeon driver|
- Force legacy driver when you have Radeon HD 2000 - 4000
- Mask >=ati-drivers-13.1 and >=xorg-server-1.13:
You need USB support. Also you need to activate the following kernel options:
If you have an AGP card, enable AGP support:
If you use a hybrid system with Intel integrated video card, you should also activite KMS and Intel driver. Make sure raedon is disable.
Portage uses the variable VIDEO_CARDS for enabling support for various graphics cards in packages. Setting VIDEO_CARDS to fglrx will pull in the driver x11-drivers/ati-drivers:
If you are using a hybrid system, enable intel driver but disable sna USE flag on it. See bug #430000.
Check the USE flags of x11-drivers/ati-drivers:
|debug||No||No||Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see http://www.gentoo.org/proj/en/qa/backtraces.xml|
|modules||Yes||Yes||Build the kernel modules|
|multilib||No||On 64bit systems, if you want to be able to compile 32bit and 64bit binaries|
|qt4||Yes||Install qt4 dependent optional tools (e.g Catalyst Control Panel)|
|static-libs||No||No||Build static libraries|
After setting this you want to update your system so the changes take effect:
Some cards need acpid running to handle events. See the ACPI article.
This will generate an initial xorg.conf to /root/xorg.conf.new:
Copy the file /root/xorg.conf.new to the default location:
This will modify an existing xorg.conf to use the fglrx driver with a single screen:
For dual-head configuration use this instead (where the second screen is [left|right|above|below]):
Set the OpenGL driver to use fglrx:
If you have the USE flag acl enabled globally and are using ConsoleKit (i.e you're using a Desktop profile) permissions to video cards will be handled automatically. You can check the permissions using getfacl:
A broader solution is to add the user you want to be able to access the video card to the video group:
Note that you will still be able to run X without permission to the fglrx subsystem, but usually not with acceleration enabled.
The most comfortable way for most users is to use opt/bin/amdcccle as a graphical UI to configure the driver.
Unexplained segmentation faults and kernel crashes
- fglrx Quick Switch - Quickly switch between this driver and the open Radeon driver using GRUB 2 without downgrading xorg-server.
- hprofile - Another method for switching between graphics drivers.
- uvesafb - Framebuffer support with binary drivers.
- ATI FAQ