View source for Package:AMD Catalyst Video Drivers

{{Ebuild
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
|CatPkg=x11-drivers/ati-drivers
|Maintainer=Drobbins
|Repository=Funtoo Overlay
|Overlay=Funtoo
}}
== Introduction ==

<tt>x11-drivers/ati-drivers</tt> (often referred to as "<tt>fglrx</tt>", the name of its kernel module) is the proprietary, accelerated driver for AMD (ATI) graphics cards. 

== Preparing to Install ==
=== Configuring the kernel ===
{{kernelop|desc=
[*] Enable loadable module support
Processor type and features --->
      [*] MTRR (Memory Type Range Register) support
Bus options (PCI etc.) --->
      [*] PCI Express Port Bus Support
      [*] Message Signaled Interrupts (MSI and MSI-X)
Device Drivers --->
      Graphics support --->
            < > Direct Rendering Manager (xFree86 4.1.0 and higher DRI support) --->
}}

{{fancynote| If you need support for AGP cards, enable the following kernel options:}}
{{kernelop|desc=
Device Drivers --->
      Graphics support --->
            <*> /dev/agpgart (AGP Support) --->
                  Select an appropriate AGP driver:
                  <*> AMD Opteron/Athlon64 on-CPU GART support
}}

=== Editing make.conf ===

Add the following to your <code>/etc/make.conf</code>:
<console>
# ##i##nano /etc/make.conf
VIDEO_CARDS="fglrx"
</console>

=== USE Flags ===
{| class="wikitable" style="margin: 1em auto;" width=80%
! width="20%" | Use flag
! width="10%" | Default
! width="10%" | Recommended
! width="60%" | Description
|-
| style="text-align: center;" | debug
| style="text-align: center;" | No
| style="text-align: center;" | ?
| style="text-align: center;" | 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
|-
| style="text-align: center;" | modules
| style="text-align: center;" | Yes
| style="text-align: center; background-color: green;" | Yes
| style="text-align: center;" | Build the required kernel modules.
|-
| style="text-align: center;" | multilib
| style="text-align: center;" | Depends on system
| style="text-align: center; background-color: yellow;" | Depends on system
| style="text-align: center;" | On 64 bit systems, if you want to be able to compile 32bit and 64bit binaries. Not recommended for pure64-based builds.
|-
| style="text-align: center;" | qt4
| style="text-align: center;" | No
| style="text-align: center; background-color: green;" | Yes
| style="text-align: center;" | Add support for the Qt GUI/Application Toolkit version 4.x. This use flag also enables the building of <tt>amdcccle</tt> (AMD Catalyst Control Center: Linux Edition).
|-
| style="text-align: center;" | static-libs
| style="text-align: center;" | No
| style="text-align: center; background-color: red;" | No
| style="text-align: center;" | Buold static versions of dynamic libraries as well.
|}

=== Editing package.use ===

Then, add the following to <code>/etc/portage/package.use</code>:
<console>
###i## nano /etc/portage/package.use
x11-drivers/ati-drivers qt4
</console>
{{fancynote| Feel free to add or remove use flags as you see fit. For example, if you do not want amdcccle support, remove the qt4 use flag.}}
== Installing ==

=== Emerging the package ===
To emerge the drivers, run the following command:
<console>
###i## emerge -av --changed-use --deep @world
</console>

== Configuring ==

Next, set ati-drivers to manage the system's OpenGL implementation: 
<console>
###i## eselect opengl set ati
</console>

Afterwards, run <tt>aticonfig</tt> to modify the X-server configuration file to work with the ati-drivers: 
<console>
###i## aticonfig --initial
</console>

{{fancytip| If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}

== Troubleshooting ==

=== I am using a HDMI connection, and my monitor's display has a black border around it. ===

Disable overscan using the following command, as root:

<console>
# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
</console>

You may need to restart your X session.

=== GNOME 3 windows only refresh when I drag them. ===

This is a known issue, reported in [http://bugs.funtoo.org/browse/FL-1130 Funtoo Bug 1130]. This issue has been fixed by addressing a bug in cogl -- upgrade to cogl-1.12.2-r2 to fix it.

=== Compton with backend glx does not work well with ati-drivers ===
Try running compton with the following switches:
<console>
###i## compton --backend glx --vsync none --paint-on-overlay
</console>
[[Category:Video Cards]]
[[Category:First Steps]]
{{EbuildFooter}}