Video

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.

   Important

Editors: OK, I've decided to change the plans for this page. This is going to be a page similar to Subarches. The idea is to help people to identify their hardware and guide them toward the correct driver for their chipset. The focus will be primarily on defining the types of hardware that are supported, what products they appear in, and how to know if you have this hardware, and also give people good general overview of options available to them (free vs. proprietary, etc.) Other important topics that apply to all drivers, like eselect opengl should be covered as well. This will then serve as the meta-page for Video support, with individual ebuild pages holding the details for each driver.

Video Drivers

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

root # 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 (x11-drivers/xf86-video-ati) and proprietary (x11-drivers/ati-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

root # emerge -avuND world

eselect profile?

Configure X.org

Intel

?

Nvidia

nvidia-xconfig, etc.

AMD/ATI

aticonfig, etc.

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

root # eselect opengl list
root # eselect opengl set 1

• eselect opencl

   Note

some setups can make use of opencl

root #eselect opencl list
root #eselect opencl set 1

• test

Troubleshooting

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