Difference between pages "Package:Boot-Update" and "Package:AMD Catalyst Video Drivers"

(Difference between pages)
 
 
Line 1: Line 1:
 
{{Ebuild
 
{{Ebuild
|Summary=Funtoo Core Boot Framework for global boot loader configuration
+
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
|CatPkg=sys-boot/boot-update
+
|CatPkg=x11-drivers/ati-drivers
 
|Maintainer=Drobbins
 
|Maintainer=Drobbins
 +
|Homepage=
 
|Repository=Funtoo Overlay
 
|Repository=Funtoo Overlay
|Organization=Funtoo Technologies
 
 
|Overlay=Funtoo
 
|Overlay=Funtoo
 
}}
 
}}
Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x ({{Package|sys-boot/grub}}) and GRUB 0.97 ({{Package|sys-boot/grub-legacy}}) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting.
 
  
== Current Version ==
+
{{Important|Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.}}
  
* {{Package|sys-boot/boot-update}}
+
== Introduction ==
  
== Man Pages ==
+
<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.
Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments:
+
  
* boot-update(8)
+
== Preparing to Install ==
* boot.conf(5)
+
  
{{:Install/BootLoader}}
+
=== Blacklist Radeon and DRM Modules ===
  
=== GRUB 0.97 (grub-legacy) Quick Start ===
+
To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:
  
If using <code>sys-boot/grub-legacy-0.97</code>, perform the following steps:
+
{{file|name=/etc/modprobe.d/radeon.conf|desc=Prevent open source DRM and radeon drivers from loading|body=
 +
blacklist radeon
 +
blacklist drm
 +
}}
  
* Partition disk using MBR partitions '''(GPT not supported)'''
+
=== Configuring the kernel ===
* Install kernel/initrd to <code>/boot</code>
+
  
 +
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## emerge sys-boot/boot-update
+
# ##i##nano /etc/make.conf
###i## emerge ">=sys-boot/grub-legacy-0.97-r11"
+
VIDEO_CARDS="fglrx"
###i## grub-install-legacy /dev/sda
+
 
</console>
 
</console>
Due to an issue with <code>grub-legacy</code>, you may see the following message:
+
=== 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>
 
<console>
###i## grub-install-legacy /dev/sda
+
###i## nano /etc/portage/package.use
The file /boot/grub-legacy/stage1 not read correctly.
+
x11-drivers/ati-drivers qt4
 
</console>
 
</console>
Should you receive this message, you will have to install <code>grub-legacy</code> from the grub shell.
+
 
Assuming <code>/boot</code> is the partition <code>/dev/sda1</code> and you want to install grub to the MBR, you would run the following:
+
{{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>
 
<console>
###i## grub-legacy
+
###i## emerge -av --changed-use --deep @world
root (hd0,0)
+
setup (hd0)
+
quit
+
 
</console>
 
</console>
When adjusting to fit your setup, remember 'root' is the location of your boot partition, 'setup' is where you want to install grub, and don't forget about grub's unique naming conventions for hard drives / partitions. For more information run:
+
 
 +
otherwise you may install the drivers with
 
<console>
 
<console>
###i## info grub-legacy
+
###i## emerge -av x11-drivers/ati-drivers
 
</console>
 
</console>
  
Ensure that <code>/etc/fstab</code> is correct, and edit <code>/etc/boot.conf</code> to reflect your installation.
+
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.
Ensure a <code>generate grub-legacy</code> setting in the <code>boot</code> section. Then run:
+
  
 +
== Configuring ==
 +
 +
Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:
 
<console>
 
<console>
###i## boot-update
+
###i## eselect opengl set ati
 +
###i## eselect opencl set amd
 
</console>
 
</console>
This will auto-generate the <code>/boot/grub-legacy/grub.conf</code> required for booting. Note that <code>grub-legacy-0.97-r11</code> and later stores <code>grub.conf</code> in the <code>/boot/grub-legacy</code> directory.
 
  
Re-run <code>boot-update</code> every time your available kernels / initrds or <code>/etc/boot.conf</code> configuration changes.
+
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]]}}
 +
 
 +
=== Multi-Head Display ===
 +
 
 +
To enable a multi-head display, you'll need to use the Catalyst Control Center {{c|amdcccle}} GUI configuration tool, which is enabled by the {{c|qt4}} USE variable.
 +
 
 +
Open up a graphical terminal, and become root by typing {{c|su -}} -- your user will need to be in the {{c|wheel}} group to do this:
 +
 
 +
{{console|body=
 +
$ ##i##su -
 +
Password: ##i##*******
 +
# source /etc/profile
 +
# amdcccle
 +
}}
 +
 
 +
[[File:amdcccle.png|class=img-responsive|center]]
 +
Navigate to Display Manager, and choose the option {{c|Multi-display desktop with display(s) X}} for each display. Then, drag and drop the blue displays to arrange them to match how they are arranged in front of you. Click {{c|OK}}. The Catalyst Control Center will tell you that you will need to restart your system for the changes to take effect. Simply log out if you are running {{c|xdm}}, or end your X session, and start it up again. You should now have a fully-functioning multi-head display.
 +
 
 +
== 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.
 +
 
 +
=== 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:Projects]]
+
[[Category:Video Cards]]
[[Category:Funtoo features]]
+
[[Category:First Steps]]
 
{{EbuildFooter}}
 
{{EbuildFooter}}

Revision as of 09:44, January 23, 2015

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.

Use Flags

qt4
Install qt4 dependent optional tools (e.g Catalyst Control Panel)
modules
Build the kernel modules
disable-watermark
Do a potentially dangerous binary search and replace to disable watermark
pax_kernel
Enable pax kernel specific patches
vaapi
Enabled Video Acceleration API

News

Drobbins

How We're Keeping You At the Center of the Funtoo Universe

Read about recent developments that keep you, our users, at the forefront of our focus as Funtoo moves forward.
10 April 2015 by Drobbins
Mgorny

New OpenGL management in Funtoo

Funtoo is switching to an improved system for managing multiple OpenGL providers (Mesa/Xorg, AMD and NVIDIA). The update may involve blockers and file collisions.
30 March 2015 by Mgorny
Drobbins

Subarch Profiles are coming...

Subarch profiles are on their way! Learn more here.
29 March 2015 by Drobbins
View More News...

AMD Catalyst Video Drivers

Tip

This is a wiki page. To edit it, 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:

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

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

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

otherwise you may install the drivers with

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

# 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

Multi-Head Display

To enable a multi-head display, you'll need to use the Catalyst Control Center amdcccle GUI configuration tool, which is enabled by the qt4 USE variable.

Open up a graphical terminal, and become root by typing su - -- your user will need to be in the wheel group to do this:

$ su -
Password: *******
# source /etc/profile
# amdcccle


Amdcccle.png

Navigate to Display Manager, and choose the option Multi-display desktop with display(s) X for each display. Then, drag and drop the blue displays to arrange them to match how they are arranged in front of you. Click OK. The Catalyst Control Center will tell you that you will need to restart your system for the changes to take effect. Simply log out if you are running xdm, or end your X session, and start it up again. You should now have a fully-functioning multi-head display.

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.

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