<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ati-faq.xml,v 1.14 2004/10/25 17:44:12 lu_zero Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<guide link="/doc/en/ati-faq.xml">
<title>Gentoo Linux ATi FAQ</title>
<author title="Author">
  <mail link="lu_zero@gentoo.org">Luca Barbato</mail>
</author>
<author title="Editor">
  <mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
  <mail link="blubber@gentoo.org">Tiemo Kieft</mail>
</author>

<abstract>
This FAQ should help users avoid some common installation and configuration
issues related to DRI and x11 for ATI boards.
</abstract>

<license/>

<version>1.0.5</version>
<date>October 25, 2004</date>

<chapter>
<title>Hardware Support</title>
<section>
<title>Is my ATI board supported?</title>
<body>

<p>
Almost every ATI board is supported by <uri 
link="http://www.freedesktop.org/Software/xorg">xorg-x11</uri>, at least for the 2D accelerated 
features.  The 3D support is provided either by <uri 
link="http://dri.sf.net">the DRI project</uri>, which is already present inside 
the xorg-x11, or by closed source drivers <uri 
link="http://mirror.ati.com/support/drivers/linux/radeon-linux.html">
provided</uri> by ATI.
</p>

<table>
<tr>
  <th>GPU</th>
  <th>Common Name</th>
  <th>Support</th>
</tr>
<tr>
  <ti>rage128</ti>
  <ti>Rage128</ti>
  <ti>xorg DRI</ti>
</tr>
<tr>
  <ti>r100</ti>
  <ti>Radeon7xxx, Radeon64</ti>
  <ti>xorg DRI</ti>
</tr>
<tr>
  <ti>r200, r250, r280</ti>
  <ti>Radeon8500, Radeon9000, Radeon9200</ti>
  <ti>xorg DRI, ATI DRI</ti>
</tr>
<tr>
  <ti>r300, following</ti>
  <ti>Radeon 9500 - 9800</ti>
  <ti>xorg 2D, ATI DRI</ti>
</tr>
</table>

</body>
</section>
<section>
<title>
I have an All-In-Wonder/Vivo board.  Are the multimedia features supported?
</title>
<body>

<p>
The multimedia features are actually supported by <uri 
link="http://gatos.sf.net">the GATOS project, the gatos drivers will be merged in the xorg tree shortly</uri>.
</p>

</body>
</section>
<section>
<title>I'm not using an x86.  What are my options?</title>
<body>

<p>
You have almost the same x11 support on ppc or alpha platform but you can't 
use the ATI closed source drivers.  That means that you can't use the r300 3d 
features at all. If you have such a board and you want it supported by x11, 
you should contact <uri link="http://www.ati.com">ATI</uri> and ask them to open
the specs.
</p>

</body>
</section>
<section>
<title>I have a laptop.  Is my "mobility" ATI model supported?</title>
<body>

<p>
It should be but you may have a configuration issue due to the OEM PCI id that 
such chips may have.  In most cases you may have to write the configuration file
yourself or use the <c>xorgconfig</c>.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Installation</title>
<section>
<title>Packages</title>
<body>

<p>
The <c>xorg-x11</c> ebuild provides the X11 implementation. The kernel modules required by DRI are provided by the 2.6.x kernels, if you are still using the 2.4.x you should emerge the <c>x11-drm</c> ebuild, and <c>ati-drivers</c> provides the ATI closed source X drivers and kernel modules, for 2.4 kernels and 2.6 ones.
</p>

<impo>
Your kernel must have agpgart support and not have the DRM modules compiled in.
</impo>

<pre caption="Installing drivers (for 2.4 systems)">
<codenote>If you want just the Rage128 drivers and modules installed with x11</codenote>
# <i>VIDEO_CARDS="rage128" emerge x11-drm</i>
<codenote>To have just the Radeon support</codenote>
<codenote>(r100, r200, r250, but not r300 yet)</codenote>
# <i>VIDEO_CARDS="radeon" emerge x11-drm</i>
<codenote>To install the ATI closed source drivers</codenote>
<codenote>(r200,r250 and r300 only)</codenote>
# <i>emerge ati-drivers</i>
<codenote>To install just X11 but not install</codenote>
<codenote>any kernel module</codenote>
# <i>emerge xorg-x11</i>
</pre>

<note>
For 2.6 systems you just have to <c>emerge xorg-x11</c> or <c>emerge ati-drivers</c>.
</note>



</body>
</section>
<section>
<title>Configuration</title>
<body>

<p>
It is suggested the use of <c>xorgcfg</c>, <c>xorgconfig</c> or directly by
using the Xorg auto configuration option:
</p>

<pre caption="Autoconfiguring X">
# <i>X -configure</i>
</pre>

<p>
For more information on how to get a basic <c>xorg.conf</c> configuration file,
please refer to the <uri link="http://www.gentoo.org/doc/en/desktop.xml">Gentoo
Desktop Documentation Resources</uri>.
</p>

<note>
Users of the ati-drivers can also use <c>fglrxconfig</c>.
</note>

<impo>
PPC users could use the <c>Xautoconf</c> stand alone configurator by
emerging the <c>Xautoconf</c> ebuild, but isn't required.
</impo>

</body>
</section>
</chapter>
</guide>
