doc/en/ati-faq.xml

<?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>

<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>
# VIDEO_CARDS="rage128" emerge xfree-drm
<codenote>To have just the Radeon support</codenote>
<codenote>(r100, r200, r250, but not r300 yet)</codenote>
# VIDEO_CARDS="radeon" emerge xfree-drm
<codenote>To install the ATI closed source drivers</codenote>
<codenote>(r200,r250 and r300 only)</codenote>
# emerge ati-drivers
<codenote>To install just XFree86 but not install</codenote>
<codenote>any kernel module</codenote>
# emerge xfree
</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>
# X -configure
</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>
1	peesh	1.1	<?xml version='1.0' encoding="UTF-8"?>
2			<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3
4			<guide link="/doc/en/ati-faq.xml">
5			<title>Gentoo Linux ATi FAQ</title>
6			<author title="Author"><mail link="lu_zero@gentoo.org">
7			Luca Barbato</mail>
8			</author>
9			<author title="Editor"><mail link="peesh@gentoo.org">
10			Jorge Paulo</mail>
11			</author>
12
13			<abstract>This FAQ should help users avoid some common installation and configuration
14	peesh	1.2	issues related to DRI and xfree for ATI boards.</abstract>
15	peesh	1.1
16	swift	1.3	<license/>
17
18	swift	1.4	<version>1.0.1</version>
19			<date>August 25, 2003</date>
20	peesh	1.1
21			<chapter>
22			<title>Hardware Support</title>
23			<section>
24	peesh	1.2	<title>Is my ATI board supported?</title>
25	peesh	1.1	<body>
26	peesh	1.2	<p>Almost every ATI board is supported by <uri link="http://www.xfree86.org">Xfree86</uri>,
27	peesh	1.1	at least for the 2D accelerated features. The 3D support is provided either by
28	peesh	1.2	<uri link="http://dri.sf.net">the DRI project</uri>, which is already present inside XFree86,
29	peesh	1.1	or by closed source drivers
30	peesh	1.2	<uri link="http://mirror.ati.com/support/drivers/linux/radeon-linux.html">provided</uri> by ATI.
31	peesh	1.1	</p>
32
33			<table>
34			<tr>
35			<th>GPU</th>
36			<th>Common Name</th>
37			<th>Support</th>
38			</tr>
39			<tr>
40	swift	1.4	<ti>rage128</ti>
41	peesh	1.2	<ti>Rage128</ti>
42	peesh	1.1	<ti>xfree DRI</ti>
43			</tr>
44			<tr>
45			<ti>r100</ti>
46	peesh	1.2	<ti>Radeon7xxx, Radeon64</ti>
47	peesh	1.1	<ti>xfree DRI</ti>
48			</tr>
49			<tr>
50			<ti>r200,r250</ti>
51	peesh	1.2	<ti>Radeon8500, Radeon9000</ti>
52			<ti>xfree DRI, ATI DRI</ti>
53	peesh	1.1	</tr>
54			<tr>
55	peesh	1.2	<ti>r300, following</ti>
56			<ti>Radeon9500, Radeon9800</ti>
57			<ti>xfree 2D, ATI DRI</ti>
58	peesh	1.1	</tr>
59			</table>
60
61			</body>
62			</section>
63
64			<section>
65	peesh	1.2	<title>I have an All-In-Wonder/Vivo board. Are the multimedia features supported?</title>
66	peesh	1.1	<body>
67			<p>The multimedia features are actually supported by
68	peesh	1.2	<uri link="http://gatos.sf.net">the GATOS project</uri>.</p>
69			<warn>ati-gatos is currently outdated. We are planning to add gatos support directly
70	peesh	1.1	inside xfree.</warn>
71			</body>
72			</section>
73
74			<section>
75			<title>I'm not using an x86. What are my options?</title>
76			<body>
77			<p>You have almost the same xfree support on ppc or alpha platform but you can't use
78	peesh	1.2	the ATI closed source drivers. That means that you can't use the r300 3d features at all.
79	peesh	1.1	If you have such a board and you want it supported by xfree, you should contact
80	peesh	1.2	<uri link="http://www.ati.com">ATI</uri> and ask them to open the specs.</p>
81	peesh	1.1	</body>
82			</section>
83
84			<section>
85	peesh	1.2	<title>I have a laptop. Is my "mobility" ATI model supported?</title>
86	peesh	1.1	<body>
87	peesh	1.2	<p>It should be but you may have a configuration issue due to the OEM PCI id that such
88	peesh	1.1	chips may have. In most cases you may have to write the configuration file yourself or
89			use the <c>xf86config</c>.
90			</p>
91
92			</body>
93			</section>
94
95			</chapter>
96
97			<chapter>
98			<title>Installation</title>
99
100			<section>
101			<title>Packages</title>
102			<body>
103			<p>
104	peesh	1.2	The <c>xfree</c> ebuild provides XFree86. <c>xfree-drm</c> provides the kernel
105			modules required by DRI and <c>ati-drivers</c> provides the ATI closed source X
106	peesh	1.1	drivers and kernel modules.
107			</p>
108			<impo>
109			Your kernel must have agpgart support and not have the DRM modules compiled in.
110			</impo>
111			<pre>
112	peesh	1.2	<codenote>If you want just the Rage128 drivers and modules
113	peesh	1.1	installed with xfree
114			</codenote>
115	swift	1.4	# VIDEO_CARDS="rage128" emerge xfree-drm
116	peesh	1.2	<codenote>To have just the Radeon support</codenote>
117	peesh	1.1	<codenote>(r100, r200, r250, but not r300 yet)</codenote>
118	swift	1.4	# VIDEO_CARDS="radeon" emerge xfree-drm
119	peesh	1.2	<codenote>To install the ATI closed source drivers</codenote>
120	peesh	1.1	<codenote>(r200,r250 and r300 only)</codenote>
121			# emerge ati-drivers
122			<codenote>To install just XFree86 but not install</codenote>
123			<codenote>any kernel module</codenote>
124			# emerge xfree
125			</pre>
126			</body>
127			</section>
128
129			<section>
130			<title>Configuration</title>
131			<body>
132	peesh	1.2	<p>It is suggested the use of <c>xf86cfg</c>, <c>xf86config</c> or directly by
133			using the XFree86 auto configuration option:
134	peesh	1.1	<pre>
135			# X -configure
136			</pre>
137			For more information on how to get a basic <c>XF86Config</c> configuration file,
138			please refer to the
139			<uri link="http://www.gentoo.org/doc/en/desktop.xml">Desktop Configuration Guide</uri>.</p>
140			<note> Users of the ati-drivers can also use <c>fglrxconfig</c>.</note>
141			<impo>PPC users should use the <c>Xeasyconf</c> stand alone configurator by
142			emerging the <c>xeasyconf</c> ebuild.</impo>
143			</body>
144			</section>
145
146
147			</chapter>
148			</guide>