Lines 17-22
Link Here
|
17 |
<author title="Editor"> |
17 |
<author title="Editor"> |
18 |
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
18 |
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
19 |
</author> |
19 |
</author> |
|
|
20 |
<author title="Author"> |
21 |
<mail link="enrico.tagliavini@gmail.com">Enrico Tagliavini</mail> |
22 |
</author> |
20 |
|
23 |
|
21 |
<abstract> |
24 |
<abstract> |
22 |
This FAQ should help users avoid some common installation and configuration |
25 |
This FAQ should help users avoid some common installation and configuration |
Lines 27-38
Link Here
|
27 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
30 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
28 |
<license/> |
31 |
<license/> |
29 |
|
32 |
|
30 |
<version>3</version> |
33 |
<version>3.1</version> |
31 |
<date>2010-08-02</date> |
34 |
<date>2010-10-03</date> |
32 |
|
35 |
|
33 |
<chapter> |
36 |
<chapter> |
34 |
<title>Hardware Support</title> |
37 |
<title>Hardware Support</title> |
35 |
<section> |
38 |
<section> |
|
|
39 |
<body> |
40 |
|
41 |
<p> |
42 |
This guide is just an addition to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server |
43 |
HowTo</uri> so read it before using this guide |
44 |
</p> |
45 |
|
46 |
</body> |
47 |
</section> |
48 |
<section> |
36 |
<title>Is my ATI board supported?</title> |
49 |
<title>Is my ATI board supported?</title> |
37 |
<body> |
50 |
<body> |
38 |
|
51 |
|
Lines 46-51
Link Here
|
46 |
GPUs. Older GPUs will use the mature open source xorg-x11 driver. |
59 |
GPUs. Older GPUs will use the mature open source xorg-x11 driver. |
47 |
</p> |
60 |
</p> |
48 |
|
61 |
|
|
|
62 |
<note> |
63 |
To find out what GPU your card is based on you can check <uri>http://en.wikipedia.org/wiki/Comparison_of_ATI_Graphics_Processing_Units</uri> |
64 |
</note> |
65 |
|
49 |
<table> |
66 |
<table> |
50 |
<tr> |
67 |
<tr> |
51 |
<th>GPU</th> |
68 |
<th>GPU</th> |
Lines 133-169
Link Here
|
133 |
|
150 |
|
134 |
</body> |
151 |
</body> |
135 |
</section> |
152 |
</section> |
|
|
153 |
</chapter> |
154 |
|
155 |
<chapter> |
156 |
<title>Using the X11 implementation</title> |
136 |
<section> |
157 |
<section> |
137 |
<title>I have a laptop. Is my ATI Mobility model supported?</title> |
|
|
138 |
<body> |
158 |
<body> |
139 |
|
159 |
|
140 |
<p> |
160 |
<p> |
141 |
It should be, but you may have a configuration issue due to the OEM PCI id that |
161 |
Please read the <uri link="/doc/en/xorg-config.xml">Gentoo X Server |
142 |
such chips may have. In such cases, you may have to write the configuration |
162 |
HowTo</uri> and the <uri link="/doc/en/dri-howto.xml">Hardware Acceleration |
143 |
file yourself. |
163 |
Guide</uri> for more information on installing drivers for your ATI graphics |
|
|
164 |
card. |
144 |
</p> |
165 |
</p> |
145 |
|
166 |
|
146 |
</body> |
167 |
</body> |
147 |
</section> |
168 |
</section> |
148 |
</chapter> |
|
|
149 |
|
150 |
<chapter> |
151 |
<title>Installation</title> |
152 |
<section> |
169 |
<section> |
153 |
<title>Packages</title> |
170 |
<title>Configuration</title> |
154 |
<body> |
171 |
<body> |
155 |
|
172 |
|
|
|
173 |
<impo> |
174 |
If you are using radeon driver with KMS be sure fbcon is loaded, otherwise you |
175 |
will get no framebuffer. You also need to disable all framebuffer |
176 |
drivers from the kernel line in GRUB or LILO, like vesafb, uvesafb and |
177 |
radeonfb. Also make sure radeon kernel module |
178 |
is loaded <b>before</b> the X start. |
179 |
</impo> |
180 |
|
156 |
<p> |
181 |
<p> |
157 |
There are two ways of getting drivers for your ATI card: |
182 |
You may not need to manually create <path>xorg.conf</path> or modify it. <e>Try |
|
|
183 |
running without it first</e>. You can also use the Xorg auto configuration option: |
158 |
</p> |
184 |
</p> |
159 |
|
185 |
|
160 |
<ul> |
186 |
<pre caption="Autoconfiguring X"> |
161 |
<li>The <c>xorg-x11</c> ebuild provides the X11 implementation</li> |
187 |
# <i>X -configure</i> |
162 |
<li> |
188 |
</pre> |
163 |
The <c>ati-drivers</c> ebuild provides the ATI closed source X drivers and |
189 |
|
164 |
kernel modules |
190 |
<warn> |
165 |
</li> |
191 |
X -configure is known to be broken with some cards, likely from r300 and newer, |
166 |
</ul> |
192 |
so don't be surprised if it fails. This option will be removed in future |
|
|
193 |
xorg-server versions. |
194 |
</warn> |
195 |
|
196 |
<p> |
197 |
For more information on how to get a basic <c>xorg.conf</c> configuration file, |
198 |
please refer to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server |
199 |
HowTo</uri>. |
200 |
</p> |
201 |
|
202 |
<note> |
203 |
PPC, AMD64, and x86 users can use the <c>xac</c> stand-alone X configuration |
204 |
tool by emerging <c>x11-misc/xac</c>, but isn't required. |
205 |
</note> |
206 |
|
207 |
</body> |
208 |
</section> |
209 |
</chapter> |
210 |
<chapter> |
211 |
<title>Installing the ATI propietary implementation</title> |
212 |
<section> |
213 |
<title>Kernel Setup</title> |
214 |
<body> |
167 |
|
215 |
|
168 |
<p> |
216 |
<p> |
169 |
If you want to use ATI's <e>internal</e> agpgart support instead of the Linux |
217 |
If you want to use ATI's <e>internal</e> agpgart support instead of the Linux |
Lines 171-228
Link Here
|
171 |
configuration) must be built as modules or not at all. |
219 |
configuration) must be built as modules or not at all. |
172 |
</p> |
220 |
</p> |
173 |
|
221 |
|
174 |
<note> |
222 |
<p> |
175 |
Please read the <uri link="/doc/en/dri-howto.xml">Hardware Acceleration |
223 |
To use <c>ati-drivers</c> you need to do the following changes to your kernel |
176 |
Guide</uri> for more information on installing drivers for your ATI graphics |
224 |
configurations |
177 |
card. |
225 |
</p> |
178 |
</note> |
226 |
<dl> |
|
|
227 |
<dt><b>Enable</b></dt> |
228 |
<dd> |
229 |
<ul> |
230 |
<li>MTRR</li> |
231 |
<li>AGP if you have and agp card</li> |
232 |
<li>PCIEPORTBUS if you have a PCIe card</li> |
233 |
<li>ACPI</li> |
234 |
<li>MAGIC_SYSRQ</li> |
235 |
<li>PCI_MSI</li> |
236 |
<li>MTRR</li> |
237 |
</ul> |
238 |
</dd> |
239 |
<dt><b>Build as module or disable</b></dt> |
240 |
<dd> |
241 |
<ul> |
242 |
<li>DRM</li> |
243 |
</ul> |
244 |
</dd> |
245 |
<dt><b>Disable</b></dt> |
246 |
<dd> |
247 |
<ol> |
248 |
<li>FB_RADEON</li> |
249 |
<li>PREEMPT_RCU</li> |
250 |
<li>LOCKDEP</li> |
251 |
</ol> |
252 |
</dd> |
253 |
</dl> |
179 |
|
254 |
|
180 |
</body> |
255 |
</body> |
181 |
</section> |
256 |
</section> |
182 |
<section> |
257 |
<section> |
183 |
<title>Configuration</title> |
258 |
<title>Installing the driver</title> |
184 |
<body> |
259 |
<body> |
185 |
|
260 |
|
186 |
<p> |
261 |
<p> |
187 |
You may not need to manually create <path>xorg.conf</path> or modify it. Try |
262 |
You can install ati-drivers package in two ways: |
188 |
running without it first. You can also use the Xorg auto configuration option: |
|
|
189 |
</p> |
263 |
</p> |
190 |
|
264 |
|
191 |
<pre caption="Autoconfiguring X"> |
265 |
<dl> |
192 |
# <i>X -configure</i> |
266 |
<dd> |
|
|
267 |
<ul> |
268 |
<li> |
269 |
Add <c>fglrx</c> to <c>VIDEO_CARDS</c> in <c>make.conf</c>, |
270 |
then run <c>emerge -1N x11-base/xorg-drivers</c> |
271 |
</li> |
272 |
<li><c>emerge x11-drivers/ati-drivers</c></li> |
273 |
</ul> |
274 |
</dd> |
275 |
</dl> |
276 |
|
277 |
<p> |
278 |
Be sure to autoload the fglrx kernel module: see the |
279 |
<uri link="/doc/en/handbook/handbook-x86.xml?part=1&chap=7#doc_chap5"> |
280 |
Kernel configuration</uri> part of the Gentoo Handbook if you are using |
281 |
sys-apps/baselayout-1*. See the <uri link="/doc/en/openrc-migration.xml"> |
282 |
openrc migration guide</uri> if you are using sys-apps/baselayout-2*. |
283 |
Of course radeon and drm kernel module must be removed from autoload, |
284 |
since they conflict with fglrx |
285 |
</p> |
286 |
|
287 |
<p> |
288 |
If radeon kernel modules keeps loading you can blacklist it editing |
289 |
<c>/etc/modprobe.d/blacklist.conf</c> |
290 |
</p> |
291 |
<pre caption="/etc/modprobe.d/blacklist.conf"> |
292 |
# <i>blacklist radeon</i> |
193 |
</pre> |
293 |
</pre> |
194 |
|
294 |
|
|
|
295 |
</body> |
296 |
</section> |
297 |
<section> |
298 |
<title>Configuration</title> |
299 |
<body> |
300 |
|
195 |
<p> |
301 |
<p> |
196 |
For more information on how to get a basic <c>xorg.conf</c> configuration file, |
302 |
You must use an xorg.conf or an xorg.conf.d file with <c>ati-drivers</c>, |
197 |
please refer to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server |
303 |
becouse you must tell xorg to use the fglrx driver. An easy way to do this is |
198 |
HowTo</uri>. |
304 |
using <c>aticonfig</c>: |
199 |
</p> |
305 |
</p> |
200 |
|
306 |
|
201 |
<note> |
307 |
<pre caption="Creating or adjusting an xorg.conf with aticonfig"> |
202 |
PPC, AMD64, and x86 users can use the <c>xac</c> stand-alone X configuration |
308 |
# <i>aticonfig --initial</i> |
203 |
tool by emerging <c>x11-misc/xac</c>, but isn't required. |
309 |
this will also create a backup of the original xorg.conf file |
204 |
</note> |
310 |
|
|
|
311 |
for dual head configuration you can run |
312 |
# <i>aticonfig --initial=dual-head</i> |
313 |
</pre> |
205 |
|
314 |
|
206 |
<note> |
315 |
<note> |
207 |
You can use <c>aticonfig</c> if you have installed the <c>ati-drivers</c> |
316 |
More options can be set, refer to <c>aticonfig --help</c> |
208 |
package. |
|
|
209 |
</note> |
317 |
</note> |
210 |
|
318 |
|
211 |
<impo> |
319 |
<p> |
212 |
If you're using <c>ati-drivers</c>, then you'll need to disable <c>radeonfb</c> |
320 |
By building <c>ati-drivers</c> with <c>qt4</c> USE flag, you will be able to |
213 |
(and probably any other framebuffer drivers) in your kernel config, as it |
321 |
use the amdcccle graphic configuration tool to easly configuring the drivers |
214 |
conflicts with the built-in framebuffer in <c>ati-drivers</c>. |
322 |
options, and xorg.conf |
215 |
</impo> |
323 |
</p> |
|
|
324 |
|
325 |
<p> |
326 |
If you wish to do it manually you have to specify <c>Driver "fglrx"</c> in |
327 |
the Device Section. It is suggested to always use aticonfig to tweak the driver |
328 |
config and xorg.conf to <b>avoid</b> conflicting option like: |
329 |
</p> |
330 |
|
331 |
<pre caption="An invalid xorg.conf fglrx options example"> |
332 |
Driver "fglrx" |
333 |
Option "Textured2D" "on" |
334 |
Option "TexturedXRender" "on" |
335 |
</pre> |
336 |
|
337 |
<p> |
338 |
which couses an Xorg segmentation fault. It is a good policy to keep the |
339 |
default options with this driver. |
340 |
</p> |
216 |
|
341 |
|
217 |
</body> |
342 |
</body> |
218 |
</section> |
343 |
</section> |
219 |
<section> |
344 |
<section> |
220 |
<title>Switching to OpenGL</title> |
345 |
<title>Switching to ATI OpenGL</title> |
221 |
<body> |
346 |
<body> |
222 |
|
347 |
|
223 |
<p> |
348 |
<p> |
224 |
Once X is installed, configured, and running, it can use the ATI OpenGL |
349 |
Once X is installed and configured you must use the ATI OpenGL implementation, you will get a |
225 |
libraries: |
350 |
black screen at X startup without this using <c>ati-drivers</c> |
226 |
</p> |
351 |
</p> |
227 |
|
352 |
|
228 |
<pre caption="Running eselect"> |
353 |
<pre caption="Running eselect"> |