doc/en/ati-faq.xml

<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ati-faq.xml,v 1.8 2004/07/29 15:50:18 swift 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.3</version>
<date>September 06, 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</ti>
  <ti>Radeon8500, Radeon9000</ti>
  <ti>xorg DRI, ATI DRI</ti>
</tr>
<tr>
  <ti>r300, following</ti>
  <ti>Radeon9500, Radeon9800</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 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>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">
<codenote>If you want just the Rage128 drivers and modules installed with xfree</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>

</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 XFree86 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>Xeasyconf</c> stand alone configurator by
emerging the <c>xeasyconf</c> ebuild, but isn't required.
</impo>

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