Difference between revisions of "Package:AMD Catalyst Video Drivers"

From Funtoo
Jump to navigation Jump to search
(added information about howto install, if xorg-server has not been installed before)
Line 7: Line 7:
|Overlay=Funtoo
|Overlay=Funtoo
}}
}}
{{Warning|These drivers are not being regularly maintained by AMD, resulting in a sub-optimal and unreliable experience for many users. Symptoms generally involve X not starting at all, things like gnome-shell crashing on startup, etc. If you have problems with these drivers, consider using the free {{Package|x11-drivers/xf86-video-ati}}, which are actually quite good and hassle-free.}}
 
{{Important|Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.}}


== Introduction ==
== Introduction ==
Line 15: Line 16:
== Preparing to Install ==
== Preparing to Install ==


=== Xorg-server compatibility ===
=== Blacklist Radeon and DRM Modules ===
 
{{Note|The release of the 14.9-r1 driver ebuild eliminates the need to mask <code>xorg-server-1.16</code>.}}
 
<code>ati-drivers-14.9-r1</code> has been added to the Funtoo Portage tree which contains a special Ubuntu-only release of the drivers that are compatible with {{Package|x11-base/xorg-server}} version 1.16. If you are using the "stock" drivers, then typically, you would need to mask <code>xorg-server</code> as follows. This is not necessary with 14.9-r1:


Add the following to <code>/etc/portage/package.mask</code>:
To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:


{{File|name=/etc/portage/package.mask|body=
{{file|name=/etc/modprobe.d/radeon.conf|desc=Prevent open source DRM and radeon drivers from loading|body=
>=x11-base/xorg-server-1.16
blacklist radeon
blacklist drm
}}
}}
If X is already installed, force it to downgrade by typing:
<console>
# ##i##emerge -auDN world
</console>
A few packages will downgrade, and you'll be ready to go.


=== Configuring the kernel ===
=== Configuring the kernel ===


Configure the kernel as follows. Note that the Direct Rendering Manager is '''not''' enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.
Configure the kernel as follows. Note that the Direct Rendering Manager is '''not''' enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.  


{{kernelop|desc=
{{kernelop|desc=
Line 91: Line 81:
</console>
</console>


Before using the driver, ensure that the "fglrx" module has been loaded -- run {{c|modprobe fglrx}} as root  -- it should return with no error. If the module can't be found, run {{c|depmod -a}} as root -- then the modprobe command should work. If you are switching from the open source Radeon driver, then shutting down your desktop and rebooting your system (be sure to disable xdm) may be required to get the new "fglrx" module to load cleanly.


== Configuring ==
== Configuring ==

Revision as of 09:32, January 23, 2015

AMD Catalyst Video Drivers

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.


   Important

Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.

Introduction

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

Preparing to Install

Blacklist Radeon and DRM Modules

To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:

   /etc/modprobe.d/radeon.conf - Prevent open source DRM and radeon drivers from loading
blacklist radeon
blacklist drm

Configuring the kernel

Configure the kernel as follows. Note that the Direct Rendering Manager is not enabled. It's possible to have it selected as a kernel module, but should not be built-in to your kernel.


[*] 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) --->
   Note

If you need support for AGP cards, enable the following kernel options:

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 /etc/make.conf:

root # nano /etc/make.conf
VIDEO_CARDS="fglrx"

Enabling AMD Catalyst Control Center

Then, add the following to /etc/portage/package.use if you would like to enable support for AMD Catalyst Control Center:

root # nano /etc/portage/package.use
x11-drivers/ati-drivers qt4
   Note

If you are using a desktop or workstation profile, this USE flag will be enabled by default.

Installing

Emerging the package

If you allready have emerged xorg-server, all you need to install the drivers is running the following command:

root # emerge -av --changed-use --deep @world

otherwise you may install the drivers with

root # emerge -av x11-drivers/ati-drivers

Before using the driver, ensure that the "fglrx" module has been loaded -- run modprobe fglrx as root -- it should return with no error. If the module can't be found, run depmod -a as root -- then the modprobe command should work. If you are switching from the open source Radeon driver, then shutting down your desktop and rebooting your system (be sure to disable xdm) may be required to get the new "fglrx" module to load cleanly.

Configuring

Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:

root # eselect opengl set ati
root # eselect opencl set amd

Afterwards, run aticonfig to modify the X-server configuration file to work with the ati-drivers:

root # aticonfig --initial
   Tip

If you would like to have a full-resolution framebuffer with ati-drivers, check out 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:

root # aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0

You may need to restart your X session.

GNOME 3 windows only refresh when I drag them.

This is a known issue, reported in 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:

root # compton --backend glx --vsync none --paint-on-overlay