Difference between pages "Package:AMD Catalyst Video Drivers" and "GNOME First Steps"

From Funtoo
(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
{{Ebuild
=== What is GNOME? ===
|Summary=Accelerated ATI/AMD binary drivers for Radeon HD 5000 and newer chipsets.
 
|CatPkg=x11-drivers/ati-drivers
"GNOME 3 is an easy and elegant way to use your computer. It is designed to put you in control and bring freedom to everybody. GNOME 3 is developed by the GNOME community, a diverse, international group of contributors that is supported by an independent, non-profit foundation." — [http://gnome.org GNOME]
|Maintainer=Drobbins
 
|Homepage=
=== Prerequisites ===
|Repository=Funtoo Overlay
 
|Overlay=Funtoo
==== From a Clean Install ====
 
Ensure that the [[X Window System]] is installed.
 
=== Preparing to emerge ===
 
To get your system ready to emerge gnome, first set your system flavor to desktop, and enable the gnome profile mix-in. To accomplish this, do the following:
{{console|recipe=setup,setup-light|desc=Set profile|body=
# ##i##eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop
# ##i##eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome
}}
}}


{{Important|Version 14.12-r3 and above now include ATI GLESv2 and EGL libraries, which should improve stabilty with GNOME.}}
By enabling the gnome mix-in, various USE and other settings will be optimized to provide you with a pain-free GNOME installation experience.
 
=== Emerging ===
 
You are provided with two packages that will pull in this desktop environment:
 
* ''gnome''
 
{{fancynote|This is the "whole shabang" - pulls in a range of applications made for the gnome desktop environment including a few games, an archive manager, a system monitor, a web browser, a terminal, etc.}}


== Introduction ==
* ''gnome-light''


<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.  
{{fancynote|As the name implies, this pulls in the base minimal you need to get a functioning GNOME Desktop Environment.}}


== Preparing to Install ==
==== GNOME 3.14 from a clean install ====


=== Blacklist Radeon and DRM Modules ===
===== gnome =====


To avoid having the open source Radeon drivers automatically load and ruin your day, create a blacklist file as follows:
To emerge ''gnome'' run the following command


{{file|name=/etc/modprobe.d/radeon.conf|desc=Prevent open source DRM and radeon drivers from loading|body=
{{console|desc=Emerging GNOME|body=
blacklist radeon
# ##i## emerge gnome
blacklist drm
}}
}}


=== Configuring the kernel ===
===== gnome-light =====


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.
To emerge ''gnome-light'' run the following command


{{kernelop|desc=
{{console|recipe=setup-light|desc=Emerging a minimal GNOME environment (alternative)|body=
[*] Enable loadable module support
# ##i## emerge gnome-light
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:}}
==== Upgrading from GNOME 3.12 ====
{{kernelop|desc=
 
Device Drivers --->
To update either ''gnome'' or ''gnome-light'' run the following command:
      Graphics support --->
 
            <*> /dev/agpgart (AGP Support) --->
{{console|body=
                  Select an appropriate AGP driver:
# ##i## emerge -vauDN world
                  <*> AMD Opteron/Athlon64 on-CPU GART support
}}
}}
=== Subsystems ===
==== Bluetooth ====
For bluetooth support, ensure that:
# Bluetooth support is enabled in your kernel (using modules is fine).
# Your bluetooth hardware is turned on.
# Add the <code>bluetooth</code> startup script to the default runlevel, and start it.


=== Editing make.conf ===
This can be done as follows:


Add the following to your <code>/etc/make.conf</code>:
<console>
<console>
# ##i##nano /etc/make.conf
# ##i##rc-update add bluetooth default
VIDEO_CARDS="fglrx"
# ##i##rc
</console>
</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:
Once this is done, you should now be able to navigate to ''Settings'' -> ''Bluetooth'' and turn bluetooth on. The icon next to devices should now animate and you should be able to discover and add devices such as keyboards.
<console>
 
###i## nano /etc/portage/package.use
{{Note|1=
x11-drivers/ati-drivers qt4
Additional kernel drivers may need to be enabled for certain input devices. For example, for the bluetooth Apple Magic Trackpad, the following option must be enabled in your kernel:
</console>


{{Note|If you are using a desktop or workstation profile, this USE flag will be enabled by default.}}
{{kernelop|title=Device Drivers,HID support,HID bus support,Special HID drivers|desc=
<M> Apple Magic Mouse/Trackpad multi-touch support
}}}}


== Installing ==
==== Printing ====


=== Emerging the package ===
To enable printing support, add <code>cupsd</code> to the default runlevel:


If you allready have emerged xorg-server, all you need to install the drivers is running the following command:
<console>
<console>
###i## emerge -av --changed-use --deep @world
# ##i##rc-update add cupsd default
# ##i##rc
</console>
</console>


otherwise you may install the drivers with
You should now be able to navigate to ''Settings'' -> ''Printers'' and add printers to your system, and print.
<console>
 
###i## emerge -av x11-drivers/ati-drivers
==== Scanning ====
</console>
 
To enable scanning support, add your user account to the <code>lp</code> group. This will allow your user to access the USB scanner.
 
Then, <code>emerge xsane</code>, and run it. It should be able to access your scanner.


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.
=== Finishing Touches ===


== Configuring ==
==== X ====


Next, set ati-drivers to manage the system's OpenGL and OpenCL implementations:
===== Setting up xdm (GUI log-in) =====
<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:
Typically, you will want to use <code>gdm</code>, the GNOME display manager, to log in to GNOME. This will allow you to log in graphically, rather than using the text console.
<console>
###i## aticonfig --initial
</console>


{{tip|If you would like to have a full-resolution framebuffer with ati-drivers, check out [[uvesafb| uvesafb]]}}
To enable gdm, edit <code>/etc/conf.d/xdm</code> and set <code>DISPLAYMANAGER</code> to <code>gdm</code> instead of <code>xdm</code>. Then, perform the following steps to add <code>xdm</code> to the default runlevel, and have it start automatically from now on when your system starts:


=== Multi-Head Display ===
{{Note|Funtoo's <code>/etc/init.d/xdm</code> initscript has been modified to start the requisite services <code>dbus</code>, <code>openrc-settingsd</code> and <code>consolekit</code> prior to starting <code>gdm</code>.}}


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.
{{console|recipe=setup|desc=Enable the GNOME display manager|body=
# ##i## rc-update add xdm default
}}


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:
Then, if you want to start it now do:


{{console|body=
{{console|body=
$ ##i##su -
# ##i##rc
Password: ##i##*******
# source /etc/profile
# amdcccle
}}
}}


[[File:amdcccle.png|class=img-responsive|center]]
But you should reboot to avoid having an open login terminal.
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.
 
===== Setting up xinitrc (text log-in) =====
 
Adding the following to your <code>~/.xinitrc</code> file is sufficient:
 
<pre>
# Fix Missing Applications in Gnome
export XDG_MENU_PREFIX=gnome-
 
# Properly Launch the Desired X Session
exec ck-launch-session gnome-session
</pre>


== Troubleshooting ==
Additionaly, if you need support for different input sources, there is no longer a need to configure IBus or SCIM in your <code>.xinitrc</code> file as GNOME uses IBus natively. Simply configure it in the Control Center under Region & Language.
=== 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>
=== Automatically Starting Applications at Login ===
# ##i##aticonfig --set-pcs-val=MCIL,DigitalHDTVDefaultUnderscan,0
 
</console>
When using an old-fashioned <code>.xinitrc</code>, starting up applications when X starts is relatively easy. When using GDM, this can still be accomplished, by using the <code>~/.xprofile</code> file. Here's my sample <code>.xprofile</code> to start <code>xflux</code> to dim the screen at night:
 
<pre>
xflux -z 87107
</pre>
 
{{Note|Remember to add a <code>&</code> at the end of any command that doesn't return to the shell prompt after running.}}
 
=== games ===
Gnome has several games that can be added on to your install.  By default most games are not included in gnome's emerge.
 
Users wishing to play games need to be added to the games group:
{{console|body=###i## gpasswd -a $USER games}}
 
game list:
;gnome-sudoku
;gnome-mastermind
;gnome-nibbles
;gnome-robots
;gnome-chess
;gnome-hearts
;gnome-mahjongg
;gnome-mines
;gnome-klotski
;gnome-tetravex
 
game system emulators:
 
;gnomeboyadvance
;gnome-mud
 
=== Significant Known Issues (Workarounds Available) ===


You may need to restart your X session.
[https://bugs.funtoo.org/browse/FL-1678 FL-1678]: Bluetooth interface gives wrong pairing key


=== Compton with backend glx does not work well with ati-drivers ===
[https://bugs.funtoo.org/browse/FL-1687 FL-1687]: Wallpaper corruption when resuming from suspend
Try running compton with the following switches:
<console>
###i## compton --backend glx --vsync none --paint-on-overlay
</console>


[[Category:Video Cards]]
[[Category:Desktop]]
[[Category:First Steps]]
[[Category:First Steps]]
{{EbuildFooter}}
[[Category:Official Documentation]]

Revision as of 17:45, February 22, 2015

What is GNOME?

"GNOME 3 is an easy and elegant way to use your computer. It is designed to put you in control and bring freedom to everybody. GNOME 3 is developed by the GNOME community, a diverse, international group of contributors that is supported by an independent, non-profit foundation." — GNOME

Prerequisites

From a Clean Install

Ensure that the X Window System is installed.

Preparing to emerge

To get your system ready to emerge gnome, first set your system flavor to desktop, and enable the gnome profile mix-in. To accomplish this, do the following: 

root # eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop
root # eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome

Console: Set profile

By enabling the gnome mix-in, various USE and other settings will be optimized to provide you with a pain-free GNOME installation experience.

Emerging

You are provided with two packages that will pull in this desktop environment:

  • gnome
   Note

This is the "whole shabang" - pulls in a range of applications made for the gnome desktop environment including a few games, an archive manager, a system monitor, a web browser, a terminal, etc.

  • gnome-light
   Note

As the name implies, this pulls in the base minimal you need to get a functioning GNOME Desktop Environment.

GNOME 3.14 from a clean install

gnome

To emerge gnome run the following command 

root #  emerge gnome

Console: Emerging GNOME

gnome-light

To emerge gnome-light run the following command 

root #  emerge gnome-light

Console: Emerging a minimal GNOME environment (alternative)

Upgrading from GNOME 3.12

To update either gnome or gnome-light run the following command: 

root #  emerge -vauDN world

Subsystems

Bluetooth

For bluetooth support, ensure that:

  1. Bluetooth support is enabled in your kernel (using modules is fine).
  2. Your bluetooth hardware is turned on.
  3. Add the bluetooth startup script to the default runlevel, and start it.

This can be done as follows: 

root # rc-update add bluetooth default
root # rc

Once this is done, you should now be able to navigate to Settings -> Bluetooth and turn bluetooth on. The icon next to devices should now animate and you should be able to discover and add devices such as keyboards.

   Note

Additional kernel drivers may need to be enabled for certain input devices. For example, for the bluetooth Apple Magic Trackpad, the following option must be enabled in your kernel:

Under Device Drivers-->HID support-->HID bus support-->Special HID drivers:

<M> Apple Magic Mouse/Trackpad multi-touch support

Printing

To enable printing support, add cupsd to the default runlevel: 

root # rc-update add cupsd default
root # rc

You should now be able to navigate to Settings -> Printers and add printers to your system, and print.

Scanning

To enable scanning support, add your user account to the lp group. This will allow your user to access the USB scanner.

Then, emerge xsane, and run it. It should be able to access your scanner.

Finishing Touches

X

Setting up xdm (GUI log-in)

Typically, you will want to use gdm, the GNOME display manager, to log in to GNOME. This will allow you to log in graphically, rather than using the text console.

To enable gdm, edit /etc/conf.d/xdm and set DISPLAYMANAGER to gdm instead of xdm. Then, perform the following steps to add xdm to the default runlevel, and have it start automatically from now on when your system starts:

   Note

Funtoo's /etc/init.d/xdm initscript has been modified to start the requisite services dbus, openrc-settingsd and consolekit prior to starting gdm. 

root #  rc-update add xdm default

Console: Enable the GNOME display manager

Then, if you want to start it now do: 

root # rc

But you should reboot to avoid having an open login terminal.

Setting up xinitrc (text log-in)

Adding the following to your ~/.xinitrc file is sufficient: 

# Fix Missing Applications in Gnome
export XDG_MENU_PREFIX=gnome-

# Properly Launch the Desired X Session
exec ck-launch-session gnome-session

Additionaly, if you need support for different input sources, there is no longer a need to configure IBus or SCIM in your .xinitrc file as GNOME uses IBus natively. Simply configure it in the Control Center under Region & Language.

Automatically Starting Applications at Login

When using an old-fashioned .xinitrc, starting up applications when X starts is relatively easy. When using GDM, this can still be accomplished, by using the ~/.xprofile file. Here's my sample .xprofile to start xflux to dim the screen at night: 

xflux -z 87107
   Note

Remember to add a & at the end of any command that doesn't return to the shell prompt after running.

games

Gnome has several games that can be added on to your install. By default most games are not included in gnome's emerge.

Users wishing to play games need to be added to the games group: 

root # gpasswd -a $USER games

game list:

gnome-sudoku
gnome-mastermind
gnome-nibbles
gnome-robots
gnome-chess
gnome-hearts
gnome-mahjongg
gnome-mines
gnome-klotski
gnome-tetravex

game system emulators:

gnomeboyadvance
gnome-mud

Significant Known Issues (Workarounds Available)

FL-1678: Bluetooth interface gives wrong pairing key

FL-1687: Wallpaper corruption when resuming from suspend

Retrieved from "https://www.funtoo.org/index.php?title=Package:AMD_Catalyst_Video_Drivers&oldid=9153"