Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 339625 | Differences between
and this patch

Collapse All | Expand All

(-)ati-faq.xml.orig (-46 / +171 lines)
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&amp;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">

Return to bug 339625