Difference between pages "Package:AMD Catalyst Video Drivers" and "Video"

(Difference between pages)
 
(removed tips/tricks chapter (likely to be driver specific; should go in Package:driver page))
 
Line 1: Line 1:
{{Ebuild
+
The purpose of this page is to give you streamlined steps for setting up your video hardware for X, and desktop environments such as GNOME.
|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 ==
+
{{Note|Editors: Keep this page relatively simple, and link to dedicated pages for more exhaustive coverage of a particular video driver. These instructions are intended to get users set up as quickly and simply as possible, without having to wade through lots of minute details.}}
  
<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.
+
== Video Drivers ==
  
== Preparing to Install ==
+
first determine which video card you have and which driver it requires.
  
=== Xorg-server compatibility ===
+
<console>###i## lspci -k</console>
  
{{Note|The release of the 14.9-r1 driver ebuild eliminates the need to mask <code>xorg-server-1.16</code>.}}
+
=== Intel ===
 +
Add or Edit the <code>VIDEO_CARDS</code> global variable in <code>/etc/make.conf</code> to the value in the following table appropriate for the Intel graphics hardware.
 +
* '''NEED TABLE''': available drivers, hardware gen, VIDEO_CARDS variable
 +
gen 1&2:
 +
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="intel"
 +
}}
 +
gen 3
 +
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="intel i915"
 +
}}
 +
gen 4+
 +
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="intel i965"
 +
}}
 +
* custom kernel menuconfig settings
  
<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:
+
=== AMD/ATI ===
 +
Users can choose between free ({{Package|x11-drivers/xf86-video-ati}}) and proprietary ({{Package|x11-drivers/ati-drivers}}) video drivers. The free drivers are recommended as the proprietary drivers are not currently maintained very well by AMD.
  
Add the following to <code>/etc/portage/package.mask</code>:
+
Add or Edit the VIDEO_CARDS global variable in <code>/etc/make.conf</code> to the value in the following table appropriate for the AMD/ATI graphics hardware.
 +
* '''NEED TABLE''': available drivers, hardware gen, required VIDEO_CARDS variable
 +
Open source drivers:
 +
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="radeon"
 +
}}
  
{{File|name=/etc/portage/package.mask|body=
+
Closed source drivers:
>=x11-base/xorg-server-1.16
+
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="fglrx"
 
}}
 
}}
  
If X is already installed, force it to downgrade by typing:
+
* custom kernel menuconfig settings
  
<console>
+
=== Nvidia ===
# ##i##emerge -auDN world
+
Users can choose between Open (nouveau) and Closed-Source (nvidia) video drivers. Add or Edit the VIDEO_CARDS global variable in /etc/portage/make.conf to the value in the following table appropriate for the Nvidia graphics hardware.
</console>
+
* '''NEED TABLE''': nouveau + nvidia-drivers versions, hardware gen, required VIDEO_CARDS variable
 
+
Open source drivers:
A few packages will downgrade, and you'll be ready to go.
+
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 
+
VIDEO_CARDS="nouveau"
=== Configuring the kernel ===
+
}}
 
+
Closed source [[Package:NVIDIA_Linux_Display_Drivers | drivers]]:
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.
+
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
 +
VIDEO_CARDS="nvidia"
 +
}}
 +
* custom kernel menuconfig settings
 +
different settings for nouveau and nvidia
  
{{kernelop|desc=
+
=== Other ===
[*] Enable loadable module support
+
==== Multiple Cards (Hybrid Graphics) ====
Processor type and features --->
+
recommended make.conf VIDEO_CARDS
      [*] MTRR (Memory Type Range Register) support
+
Hybrid intel/ati:
Bus options (PCI etc.) --->
+
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
      [*] PCI Express Port Bus Support
+
VIDEO_CARDS="fglrx intel"
      [*] 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:}}
+
==== Virtual Machine Guests ====
{{kernelop|desc=
+
(details?)
Device Drivers --->
+
These settings are used by Parallels VM's and presumably others
      Graphics support --->
+
{{file|name=/etc/portage/make.conf|lang=|desc=set video global variable|body=
            <*> /dev/agpgart (AGP Support) --->
+
VIDEO_CARDS="vesa vga"
                  Select an appropriate AGP driver:
+
                  <*> AMD Opteron/Athlon64 on-CPU GART support
+
 
}}
 
}}
  
=== Editing make.conf ===
+
==== Raspberry Pi ====
 
+
(details?)
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 ===
+
To emerge the drivers, run the following command:
+
<console>
+
###i## emerge -av --changed-use --deep @world
+
</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:
+
== Install ==
<console>
+
once your video cards variable is set in make.conf merge changes into your system
###i## aticonfig --initial
+
</console>
+
  
{{tip|If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}
+
<console>###i## emerge -avuND world</console>
  
== Troubleshooting ==
+
eselect profile?
=== 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>
+
==Configure X.org==
# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
+
===Intel===
</console>
+
?
 +
===Nvidia===
 +
nvidia-xconfig, etc.
  
You may need to restart your X session.
+
===AMD/ATI===
 +
aticonfig, etc.
 +
<console># ##i##aticonfig --initial --input=/etc/X11/xorg.conf</console>
  
=== GNOME 3 windows only refresh when I drag them. ===
+
==Configure framebuffer==
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.
+
What to put in boot.conf etc. Assumes that the kernel is correctly configured.
 +
===Intel===
 +
?
 +
===Nvidia===
 +
* settings for nouveau
 +
* settings for nvidia-drivers
 +
* How to use sys-apps/v86d
 +
 +
===AMD/ATI===
 +
* settings for fglxr
 +
* settings for radeon, etc.
  
=== Compton with backend glx does not work well with ati-drivers ===
+
==Finalize and test==
Try running compton with the following switches:
+
* eselect opengl
<console>
+
{{note|change the number of card eselected to match the card of your system}}
###i## compton --backend glx --vsync none --paint-on-overlay
+
<console>###i## eselect opengl list
</console>
+
###i## eselect opengl set 1</console>
 +
* eselect opencl
 +
{{note|some setups can make use of opencl}}
 +
<console>###i##eselect opencl list
 +
###i##eselect opencl set 1</console>
 +
* test
  
[[Category:Video Cards]]
+
==Troubleshooting==
[[Category:First Steps]]
+
* e.g. what to do if only a blank screen
{{EbuildFooter}}
+

Revision as of 05:55, November 25, 2014

The purpose of this page is to give you streamlined steps for setting up your video hardware for X, and desktop environments such as GNOME.

Note

Editors: Keep this page relatively simple, and link to dedicated pages for more exhaustive coverage of a particular video driver. These instructions are intended to get users set up as quickly and simply as possible, without having to wade through lots of minute details.

Video Drivers

first determine which video card you have and which driver it requires.

# lspci -k

Intel

Add or Edit the VIDEO_CARDS global variable in /etc/make.conf to the value in the following table appropriate for the Intel graphics hardware.

  • NEED TABLE: available drivers, hardware gen, VIDEO_CARDS variable

gen 1&2:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="intel"

gen 3

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="intel i915"

gen 4+

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="intel i965"
  • custom kernel menuconfig settings

AMD/ATI

Users can choose between free (Radeon Video Drivers) and proprietary (AMD Catalyst Video Drivers) video drivers. The free drivers are recommended as the proprietary drivers are not currently maintained very well by AMD.

Add or Edit the VIDEO_CARDS global variable in /etc/make.conf to the value in the following table appropriate for the AMD/ATI graphics hardware.

  • NEED TABLE: available drivers, hardware gen, required VIDEO_CARDS variable

Open source drivers:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="radeon"

Closed source drivers:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="fglrx"
  • custom kernel menuconfig settings

Nvidia

Users can choose between Open (nouveau) and Closed-Source (nvidia) video drivers. Add or Edit the VIDEO_CARDS global variable in /etc/portage/make.conf to the value in the following table appropriate for the Nvidia graphics hardware.

  • NEED TABLE: nouveau + nvidia-drivers versions, hardware gen, required VIDEO_CARDS variable

Open source drivers:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="nouveau"

Closed source drivers:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="nvidia"
  • custom kernel menuconfig settings

different settings for nouveau and nvidia

Other

Multiple Cards (Hybrid Graphics)

recommended make.conf VIDEO_CARDS Hybrid intel/ati:

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="fglrx intel"

Virtual Machine Guests

(details?) These settings are used by Parallels VM's and presumably others

/etc/portage/make.conf: set video global variable
VIDEO_CARDS="vesa vga"

Raspberry Pi

(details?)

Install

once your video cards variable is set in make.conf merge changes into your system

# emerge -avuND world

eselect profile?

Configure X.org

Intel

?

Nvidia

nvidia-xconfig, etc.

AMD/ATI

aticonfig, etc.

# aticonfig --initial --input=/etc/X11/xorg.conf

Configure framebuffer

What to put in boot.conf etc. Assumes that the kernel is correctly configured.

Intel

?

Nvidia

  • settings for nouveau
  • settings for nvidia-drivers
  • How to use sys-apps/v86d

AMD/ATI

  • settings for fglxr
  • settings for radeon, etc.

Finalize and test

  • eselect opengl

Note

change the number of card eselected to match the card of your system

# eselect opengl list
# eselect opengl set 1
  • eselect opencl

Note

some setups can make use of opencl

#eselect opencl list
#eselect opencl set 1
  • test

Troubleshooting

  • e.g. what to do if only a blank screen