|
|
| Line 1: |
Line 1: |
| {{Ebuild
| | [[Support Funtoo]] and help us grow! '''Donate $15 per month and get a free SSD-based [[Funtoo Hosting|Funtoo Virtual Container]]. 25 spots left. |
| |Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
| |
| |CatPkg=x11-drivers/ati-drivers
| |
| |Maintainer=Drobbins
| |
| |Homepage=
| |
| |Repository=Funtoo Overlay
| |
| |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.}}
| |
| | |
| == 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 ==
| |
| | |
| === 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 ===
| |
| | |
| 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=
| |
| [*] 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:}}
| |
| {{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>
| |
| === Enabling AMD Catalyst Control Center ===
| |
| | |
| Then, add the following to <code>/etc/portage/package.use</code> if you would like to enable support for AMD Catalyst Control Center:
| |
| <console>
| |
| ###i## nano /etc/portage/package.use
| |
| x11-drivers/ati-drivers qt4
| |
| </console>
| |
| | |
| {{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:
| |
| <console>
| |
| ###i## emerge -av --changed-use --deep @world
| |
| </console>
| |
| | |
| otherwise you may install the drivers with
| |
| <console>
| |
| ###i## emerge -av x11-drivers/ati-drivers
| |
| </console>
| |
| | |
| | |
| == Configuring ==
| |
| | |
| Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:
| |
| <console>
| |
| ###i## eselect opengl set ati
| |
| ###i## eselect opencl set amd
| |
| </console>
| |
| | |
| Afterwards, run <code>aticonfig</code> to modify the X-server configuration file to work with the ati-drivers:
| |
| <console>
| |
| ###i## aticonfig --initial
| |
| </console>
| |
| | |
| {{tip|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}}
| |