Difference between pages "X Window System" and "Package:AMD Catalyst Video Drivers"

(Difference between pages)
 
 
Line 1: Line 1:
=== X.Org ===
+
{{Ebuild
 +
|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
 +
}}
 +
== Introduction ==
  
In order to use a graphical environment it's necessary to install X.Org, which is an implementation of the X Window system.  
+
<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.  
  
Before we start it's a good idea to make sure that your system is configured correctly. If you've installed your kernel using the <code>binary</code> USE flag, chances are that your video card is already supported.
+
== 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.
 +
 
 +
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:
  
You should also find your IP address, because if X freezes and you need to get out of it, the safest way is to SSH in from another computer/smartphone/tablet and issue
 
 
<console>
 
<console>
killall X
+
# ##i##emerge -auDN world
 
</console>
 
</console>
  
In order for Portage to know which [[Video | video]] card(s) you want to support, you'll need to add a line to your <code>[[make.conf | make.conf]]</code>.
+
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>
 
<console>
# ##i##nano -w /etc/portage/make.conf
+
# ##i##nano /etc/make.conf
...
+
VIDEO_CARDS="fglrx"
VIDEO_CARDS="intel"
+
 
</console>
 
</console>
 +
=== Editing package.use ===
  
In the example above we're using Intel integrated graphics drivers. Examples of valid entries include <code>radeon</code> for AMD Radeon cards, and <code>nouveau</code> or <code>nvidia</code> for NVIDIA cards. If you haven't yet switched to the <code>desktop</code> profile it's a good idea to do it now.
+
Then, add the following to <code>/etc/portage/package.use</code>:
 
+
Next comes the actual installation:
+
 
<console>
 
<console>
# ##i##emerge xorg-x11
+
###i## nano /etc/portage/package.use
 +
x11-drivers/ati-drivers qt4
 
</console>
 
</console>
 +
{{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 ==
  
Now we need to test to make sure X.Org is working properly. To test it we will install twm, a simple window manager which has traditionally served as the standard window manager for X.Org. In Funtoo Linux it is included in the core X.Org meta-package <code>x11-apps/xinit</code>, but is not installed by default.
+
=== Emerging the package ===
 
+
To emerge the drivers, run the following command:
It is possible to install twm directly by merging <code>x11-wm/twm</code> but for the sake of this tutorial we will install the meta-package, which includes a few extra utilities which may come in handy. There are two ways to do this depending on whether you want it to be installed temporarily or permanently. If you just want it to test X.Org use the following command:
+
 
<console>
 
<console>
# ##i##USE="-minimal" emerge -1 xinit
+
###i## emerge -av --changed-use --deep @world
 
</console>
 
</console>
  
The <code>minimal</code> USE flag is used in some ebuilds to install the bare minimum needed to get a working system. By passing <code>USE="-minimal"</code> to the command line before <code>emerge</code>, we are telling Portage to disable the flag and install the complete package. The <code>-1</code> (<code>--oneshot</code>) following <code>emerge</code> tells Portage not to add the package to [[#Updating your system|<code>world</code>]]. This is useful when installing packages which are automatically pulled in as dependencies by other packages.
+
== Configuring ==
  
If you want the package installed permanently you will need to add a line to <code>package.use</code>:  
+
Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:  
 
<console>
 
<console>
# ##i##mkdir -p /etc/portage
+
###i## eselect opengl set ati
# ##i##echo x11-apps/xinit -minimal >> /etc/portage/package.use
+
###i## eselect opencl set amd
 
</console>
 
</console>
  
Next we reinstall <code>x11-apps/xinit</code>:
+
Afterwards, run <code>aticonfig</code> to modify the X-server configuration file to work with the ati-drivers:  
 
<console>
 
<console>
# ##i##emerge -1N xinit
+
###i## aticonfig --initial
 
</console>
 
</console>
  
Once that's done, we're able to finally test X.Org:
+
{{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>
 
<console>
# ##i##startx
+
# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
 
</console>
 
</console>
  
If everything is well, a simple GUI along with an analog clock and a terminal will appear.
+
You may need to restart your X session.
  
====Keyboard/Mouse====
+
=== 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.
  
If you have no keyboard/mouse input in x11, check if your kernel supports dev
+
=== Compton with backend glx does not work well with ati-drivers ===
 +
Try running compton with the following switches:
 
<console>
 
<console>
zcat /proc/config.gz | grep EVDEV
+
###i## compton --backend glx --vsync none --paint-on-overlay
</console>*
+
if your output is:
+
<console>
+
CONFIG_INPUT_EVDEV=y
+
</console>
+
Install xf86-input-evdev
+
<console>
+
emerge -avxf86-input-evdev
+
 
</console>
 
</console>
  
 
+
[[Category:Video Cards]]
 
[[Category:First Steps]]
 
[[Category:First Steps]]
 +
{{EbuildFooter}}

Revision as of 08:07, November 6, 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

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.

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