<?xml version='1.0' encoding="UTF-8"?>
<!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 xfree for ATI boards.</abstract>

<license/>

<version>1.0.1</version>
<date>August 25, 2003</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.xfree86.org">Xfree86</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 XFree86, 
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>xfree DRI</ti>
	</tr>
	<tr>
		<ti>r100</ti>
		<ti>Radeon7xxx, Radeon64</ti>
		<ti>xfree DRI</ti>
	</tr>
	<tr>
		<ti>r200,r250</ti>
		<ti>Radeon8500, Radeon9000</ti>
		<ti>xfree DRI, ATI DRI</ti>
	</tr>
	<tr>
		<ti>r300, following</ti>
		<ti>Radeon9500, Radeon9800</ti>
		<ti>xfree 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</uri>.</p>
<warn>ati-gatos is currently outdated.  We are planning to add gatos support directly
inside xfree.</warn>
</body>
</section>

<section>
<title>I'm not using an x86.  What are my options?</title>
<body>
<p>You have almost the same xfree 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 xfree, 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>xf86config</c>.
</p>

</body>
</section>

</chapter>

<chapter>
<title>Installation</title>

<section>
<title>Packages</title>
<body>
<p>
The <c>xfree</c> ebuild provides XFree86. <c>xfree-drm</c> provides the kernel
modules required by DRI and <c>ati-drivers</c> provides the ATI closed source X
drivers and kernel modules.
</p>
<impo>
Your kernel must have agpgart support and not have the DRM modules compiled in.
</impo>
<pre>
<codenote>If you want just the Rage128 drivers and modules
installed with xfree
</codenote>
# <i>VIDEO_CARDS="rage128" emerge xfree-drm</i>
<codenote>To have just the Radeon support</codenote>
<codenote>(r100, r200, r250, but not r300 yet)</codenote>
# <i>VIDEO_CARDS="radeon" emerge xfree-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 XFree86 but not install</codenote>
<codenote>any kernel module</codenote>
# <i>emerge xfree</i>
</pre>
</body>
</section>

<section>
<title>Configuration</title>
<body>
<p>It is suggested the use of <c>xf86cfg</c>, <c>xf86config</c> or directly by
using the XFree86 auto configuration option:
<pre>
# <i>X -configure</i>
</pre>
For more information on how to get a basic <c>XF86Config</c> configuration file,
please refer to the
<uri link="http://www.gentoo.org/doc/en/desktop.xml">Desktop Configuration Guide</uri>.</p>
<note> Users of the ati-drivers can also use <c>fglrxconfig</c>.</note>
<impo>PPC users should use the <c>Xeasyconf</c> stand alone configurator by
emerging the <c>xeasyconf</c> ebuild.</impo>
</body>
</section>


</chapter>
</guide>
