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

m
 
(14 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
 
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
 
|CatPkg=x11-drivers/ati-drivers
 
|CatPkg=x11-drivers/ati-drivers
|Maintainer=Daniel Robbins,
+
|Maintainer=Drobbins
 +
|Homepage=
 
|Repository=Funtoo Overlay
 
|Repository=Funtoo Overlay
 
|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 Radeon drivers, which are actually quite good and hassle-free.}}
 +
 
== Introduction ==
 
== Introduction ==
  
Line 11: Line 14:
  
 
== Preparing to Install ==
 
== Preparing to Install ==
 +
 +
=== Xorg-server compatibility ===
 +
 +
{{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>:
 +
 +
{{File|name=/etc/portage/package.mask|body=
 +
>=x11-base/xorg-server-1.16
 +
}}
 +
 +
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.
 +
 
{{kernelop|desc=
 
{{kernelop|desc=
 
[*] Enable loadable module support
 
[*] Enable loadable module support
Line 24: Line 51:
 
}}
 
}}
  
{{fancynote| If you need support for AGP cards, enable the following kernel options:}}
+
{{note|If you need support for AGP cards, enable the following kernel options:}}
 
{{kernelop|desc=
 
{{kernelop|desc=
 
Device Drivers --->
 
Device Drivers --->
Line 40: Line 67:
 
VIDEO_CARDS="fglrx"
 
VIDEO_CARDS="fglrx"
 
</console>
 
</console>
 
 
=== Editing package.use ===
 
=== Editing package.use ===
  
Line 48: Line 74:
 
x11-drivers/ati-drivers qt4
 
x11-drivers/ati-drivers qt4
 
</console>
 
</console>
Adding the <code>qt4</code> USE flag enables support for building of <tt>amdcccle</tt> (AMD Catalyst Control Center: Linux Edition).
+
{{note|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 ==
 
== Installing ==
  
Line 60: Line 85:
 
== Configuring ==
 
== Configuring ==
  
Next, set ati-drivers to manage the system's OpenGL implementation:  
+
Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:  
 
<console>
 
<console>
 
###i## eselect opengl set ati
 
###i## eselect opengl set ati
 +
###i## eselect opencl set amd
 
</console>
 
</console>
  
Afterwards, run <tt>aticonfig</tt> to modify the X-server configuration file to work with the ati-drivers:  
+
Afterwards, run <code>aticonfig</code> to modify the X-server configuration file to work with the ati-drivers:  
 
<console>
 
<console>
 
###i## aticonfig --initial
 
###i## aticonfig --initial
 
</console>
 
</console>
 +
 +
{{tip|If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}
  
 
== Troubleshooting ==
 
== Troubleshooting ==
 
 
=== I am using a HDMI connection, and my monitor's display has a black border around it. ===
 
=== 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:
 
Disable overscan using the following command, as root:
  
Line 83: Line 109:
  
 
=== GNOME 3 windows only refresh when I drag them. ===
 
=== 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.
 
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:Video Cards]]
 
[[Category:First Steps]]
 
[[Category:First Steps]]
 
{{EbuildFooter}}
 
{{EbuildFooter}}

Latest revision as of 01:31, November 21, 2014

x11-drivers/ati-drivers


Current Maintainer(s):Daniel Robbins
Source Repository:Funtoo Overlay

Summary: Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.

AMD Catalyst Video Drivers

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 Radeon drivers, which are actually quite good and hassle-free.

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

Xorg-server compatibility

Note

The release of the 14.9-r1 driver ebuild eliminates the need to mask xorg-server-1.16.

ati-drivers-14.9-r1 has been added to the Funtoo Portage tree which contains a special Ubuntu-only release of the drivers that are compatible with x11-base/xorg-server (package not on wiki - please add) version 1.16. If you are using the "stock" drivers, then typically, you would need to mask xorg-server as follows. This is not necessary with 14.9-r1:

Add the following to /etc/portage/package.mask:

/etc/portage/package.mask
>=x11-base/xorg-server-1.16

If X is already installed, force it to downgrade by typing:

# emerge -auDN world

A few packages will downgrade, and you'll be ready to go.

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:

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

Editing package.use

Then, add the following to /etc/portage/package.use:

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

Note

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:

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

Configuring

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

# eselect opengl set ati
# eselect opencl set amd

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

# 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:

# 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:

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