From Fedora Project Wiki

No edit summary
Line 2: Line 2:
== AMD Catalyst is non-free/proprietary software ==
== AMD Catalyst is non-free/proprietary software ==


AMD Catalyst driver cannot be included in Fedora because it is not free/libre and open source software.  Fedora includes a free and open source driver for AMD graphics cards.  It is highly recommended that you use the default driver that is part of Fedora and help improve it by providing your feedback.  The following documentation describes the steps to use the non-free/proprietary driver.  Fedora cannot help resolve bugs in the proprietary driver and all feedback should be directed to the vendor instead.
AMD Catalyst driver cannot be included in Fedora because it is '''not free software'''.  Fedora includes a free and open source driver for AMD graphics cards.  It is highly recommended that you use the default driver that is part of Fedora and help improve it by providing your feedback.  The following documentation describes the steps to use the non-free/proprietary driver.  Fedora cannot help resolve bugs in the proprietary driver and all feedback should be directed to the vendor instead.


If you experience problems with the default free driver, or find it slow, you may install it with the following instructions.
If you experience problems with the default free driver, or find it slow, you may install it with the following instructions.
Line 8: Line 8:
== Getting AMD Catalyst ==
== Getting AMD Catalyst ==


{{admon/important|Root is needed|All of the following commands will require superuser priveleges. Become root using:
{{admon/important|Root is needed|Any commands with a preceding hash, as opposed to a dollar sign will require superuser privileges. Become root using:
:<pre>$ su -</pre> It is possible to use sudo instead
<pre>$ su -</pre>
::<pre>$ sudo -i</pre>}}
or
<pre>$ sudo -i</pre>}}


=== Preperations ===
=== Preperations ===


Upgrade your system
Upgrade your system and reboot.
:<pre># yum upgrade</pre>
<pre># yum upgrade</pre>
:<pre># shutdown -r now</pre>
<pre># shutdown -r now</pre>
Download and install the RPM Fusion repositories (according to your Fedora version):
Download and install the RPM Fusion repositories (according to your Fedora version):
:<strong>Fedora 18</strong>
*Fedora 18
::[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-18.noarch.rpm RPM Fusion free]
**[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-18.noarch.rpm RPM Fusion free]
::[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-18.noarch.rpm RPM Fusion nonfree]
**[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-18.noarch.rpm RPM Fusion nonfree]
:<strong>Fedora 17</strong>
*Fedora 17
::[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-17.noarch.rpm RPM Fusion free]
**[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-17.noarch.rpm RPM Fusion free]
::[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-17.noarch.rpm RPM Fusion nonfree]
**[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-17.noarch.rpm RPM Fusion nonfree]
:<strong>Fedora 16</strong>
*Fedora 16
::[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-16.noarch.rpm RPM Fusion free]
**[http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-16.noarch.rpm RPM Fusion free]
::[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-16.noarch.rpm RPM Fusion nonfree]
**[http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-16.noarch.rpm RPM Fusion nonfree]
:If your browser has downloaded these packages, as opposed to requesting to open the Fedora package installer, you may install them using the following command:
If your browser has downloaded these packages, as opposed to requesting to open the Fedora package installer, you may install them using the following command:
::<pre># yum install /path/to/package(s).rpm</pre>
<pre># yum install /path/to/package(s).rpm</pre>


=== Installing AMD Catalyst ===
=== Installing AMD Catalyst ===


Install the Catalyst driver and libraries
Install the Catalyst driver and libraries using yum.
:<pre># yum install xorg-x11-drv-catalyst xorg-x11-drv-catalyst-libs</pre>
<pre># yum install xorg-x11-drv-catalyst xorg-x11-drv-catalyst-libs</pre>
Install akmod for Catalyst
Install akmod driver module for Catalyst.
:<pre># yum install akmod-catalyst</pre>
<pre># yum install akmod-catalyst</pre>
{{admon/note|Akmod vs. kmod|Many will be confused and mistakenly install kmod instead of akmod. Akmod is the preferred option, similar to dkms, in that is dynamically rebuilds the kernel module whenever a new kernel is installed, instead of the user having to rebuild each kernel module whenever there is a new kernel release.<br>A disadvantage to akmod is that it required more space than kmod-compiled modules.}}
{{admon/note|Akmod vs. kmod|Many will mistakenly install kmod instead of akmod. Akmod is the preferred option, similar to dkms, in that is dynamically rebuilds the kernel module whenever a new kernel is installed, instead of the user having to rebuild each kernel module whenever there is a new kernel release.<br>A disadvantage to akmod is that it required more space than kmod-compiled modules.}}
Run the '''<code>amdconfig</code>''' / '''<code>aticonfig</code>''' commands to generate a new '''<code>xorg.conf</code>''' for your system. Failure to do so will likely result in a broken system.
<pre># amdconfig -f --initial</pre>
or (if using multiple GPUs / switchable graphics)
<pre># amdconfig -f --adapter=all --initial</pre>


=== Finishing touches ===
=== Finishing touches ===


Blacklist old radeon modules
To prevent the old radeon driver from loading at boot, blacklist it by adding the '''<code>radeon</code>''' and '''<code>radeonhd</code>''' drivers to modprobe's '''<code>blacklist.conf</code>'''.
<pre># echo "blacklist radeon" >> /etc/modprobe.d/blacklist.conf</pre>
<pre># echo "blacklist radeon" >> /etc/modprobe.d/blacklist.conf</pre>
<pre># echo "blacklist radeonhd" >> /etc/modprobe.d/blacklist.conf</pre>
<pre># echo "blacklist radeonhd" >> /etc/modprobe.d/blacklist.conf</pre>
 
Remove the old radeon driver from initramfs loaded at boot.
 
Remove the old radeon driver from initramfs
<pre># mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-radeon.img</pre>
<pre># mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-radeon.img</pre>
<pre># dracut /boot/initramfs-$(uname -r).img $(uname -r)</pre>
<pre># dracut /boot/initramfs-$(uname -r).img $(uname -r)</pre>
 
Reboot.
 
Reboot
<pre># shutdown -r now</pre>
 
 
Configure xorg.conf
<pre># amdconfig -f --initial</pre>
 
 
Reboot (again)
<pre># shutdown -r now</pre>
<pre># shutdown -r now</pre>
 
Once you have rebooted, run '''<code>fglrxinfo</code>''' (this does not require root privileges), which should display an output similar to the following:
 
Once you have rebooted, run <code>fglrxinfo</code> (this does not require root privileges), which should display an output similar to the following:
<pre>$ fglrxinfo</pre>
<pre>$ fglrxinfo</pre>
<pre>
<pre>

Revision as of 13:18, 7 February 2013

AMD Catalyst is non-free/proprietary software

AMD Catalyst driver cannot be included in Fedora because it is not free software. Fedora includes a free and open source driver for AMD graphics cards. It is highly recommended that you use the default driver that is part of Fedora and help improve it by providing your feedback. The following documentation describes the steps to use the non-free/proprietary driver. Fedora cannot help resolve bugs in the proprietary driver and all feedback should be directed to the vendor instead.

If you experience problems with the default free driver, or find it slow, you may install it with the following instructions.

Getting AMD Catalyst

Root is needed
Any commands with a preceding hash, as opposed to a dollar sign will require superuser privileges. Become root using:
$ su -

or

$ sudo -i

Preperations

Upgrade your system and reboot.

# yum upgrade
# shutdown -r now

Download and install the RPM Fusion repositories (according to your Fedora version):

If your browser has downloaded these packages, as opposed to requesting to open the Fedora package installer, you may install them using the following command:

# yum install /path/to/package(s).rpm

Installing AMD Catalyst

Install the Catalyst driver and libraries using yum.

# yum install xorg-x11-drv-catalyst xorg-x11-drv-catalyst-libs

Install akmod driver module for Catalyst.

# yum install akmod-catalyst
Akmod vs. kmod
Many will mistakenly install kmod instead of akmod. Akmod is the preferred option, similar to dkms, in that is dynamically rebuilds the kernel module whenever a new kernel is installed, instead of the user having to rebuild each kernel module whenever there is a new kernel release.
A disadvantage to akmod is that it required more space than kmod-compiled modules.

Run the amdconfig / aticonfig commands to generate a new xorg.conf for your system. Failure to do so will likely result in a broken system.

# amdconfig -f --initial

or (if using multiple GPUs / switchable graphics)

# amdconfig -f --adapter=all --initial

Finishing touches

To prevent the old radeon driver from loading at boot, blacklist it by adding the radeon and radeonhd drivers to modprobe's blacklist.conf.

# echo "blacklist radeon" >> /etc/modprobe.d/blacklist.conf
# echo "blacklist radeonhd" >> /etc/modprobe.d/blacklist.conf

Remove the old radeon driver from initramfs loaded at boot.

# mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-radeon.img
# dracut /boot/initramfs-$(uname -r).img $(uname -r)

Reboot.

# shutdown -r now

Once you have rebooted, run fglrxinfo (this does not require root privileges), which should display an output similar to the following:

$ fglrxinfo
fglrxinfo 
display: :0  screen: 0
OpenGL vendor string: Advanced Micro Devices, Inc.
OpenGL renderer string: AMD Radeon HD 6300M Series
OpenGL version string: 4.2.11733 Compatibility Profile Context