source: x/installing/x7driver-ati.xml@ b33ecad8

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since b33ecad8 was b33ecad8, checked in by Thomas Trepl (Moody) <thomas@…>, 16 months ago

Tag ATI video driver

  • Property mode set to 100644
File size: 11.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY radeon-wiki "http://wiki.x.org/wiki/RadeonFeature">
8 <!ENTITY radeon-marketing-names "&radeon-wiki;#Decoder_ring_for_engineering_vs_marketing_names">
9
10 <!ENTITY xorg-ati-driver-version "19.1.0">
11
12 <!ENTITY xorg-ati-driver-download-http "&xorg-download-http;/driver/xf86-video-ati-&xorg-ati-driver-version;.tar.bz2">
13 <!ENTITY xorg-ati-driver-download-ftp "&xorg-download-ftp;/driver/xf86-video-ati-&xorg-ati-driver-version;.tar.bz2">
14 <!ENTITY xorg-ati-driver-md5sum "6e49d3c2839582af415ceded76e626e6">
15 <!ENTITY xorg-ati-driver-size "884 KB">
16 <!ENTITY xorg-ati-driver-buildsize "21 MB">
17 <!ENTITY xorg-ati-driver-time "0.2 SBU">
18]>
19
20 <!-- Begin Xorg ATI Driver -->
21 <sect2 id="xorg-ati-driver" xreflabel="Xorg ATI Driver-&xorg-ati-driver-version;">
22
23 <sect2info>
24 <date>$Date$</date>
25 </sect2info>
26
27 <title>Xorg ATI Driver-&xorg-ati-driver-version;</title>
28
29 <indexterm zone="xorg-ati-driver">
30 <primary sortas="a-xorg-ati-driver">xorg-ati-driver</primary>
31 </indexterm>
32
33 <sect3 role="package">
34 <title>Introduction to Xorg ATI Driver</title>
35
36 <para>
37 The <application>Xorg ATI Driver</application> package contains the X.Org
38 Video Driver for ATI Radeon video cards including all chipsets ranging
39 from R100 to the "Volcanic Islands" chipsets.
40 </para>
41
42 &lfs110_checked;
43
44 <note>
45 <para>
46 For Direct Rendering to work with newer Radeon Cards (R300 and later
47 chipsets), you need to enable the r300, r600 and radeonsi Gallium
48 drivers at <xref linkend="mesa"/> build time. Also, some cards
49 require Firmware to be available when the kernel driver is loaded.
50 Firmware can be obtained from <ulink
51 url="&sources-anduin-http;/linux-firmware/"/>.
52 See <xref linkend="xorg-ati-firmware-kernel"/> below for additional
53 firmware.
54 </para>
55 </note>
56
57 <bridgehead renderas="sect4">Package Information</bridgehead>
58 <itemizedlist spacing="compact">
59 <listitem>
60 <para>
61 Download (HTTP): <ulink url="&xorg-ati-driver-download-http;"/>
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download (FTP): <ulink url="&xorg-ati-driver-download-ftp;"/>
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download MD5 sum: &xorg-ati-driver-md5sum;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Download size: &xorg-ati-driver-size;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Estimated disk space required: &xorg-ati-driver-buildsize;
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Estimated build time: &xorg-ati-driver-time;
87 </para>
88 </listitem>
89 </itemizedlist>
90
91 <bridgehead renderas="sect4">Additional Downloads</bridgehead>
92 <itemizedlist spacing="compact">
93 <listitem>
94 <para>
95 Required patch:
96 <ulink url="&patch-root;/xf86-video-ati-&xorg-ati-driver-version;-upstream_fixes-1.patch"/>
97 </para>
98 </listitem>
99 </itemizedlist>
100
101 <bridgehead renderas="sect4">Xorg ATI Driver Dependencies</bridgehead>
102
103 <bridgehead renderas="sect5">Required</bridgehead>
104 <para role="required">
105 <xref linkend="xorg-server"/> (recommended to be built with glamor enabled)
106 </para>
107
108 <note>
109 <para>
110 Glamor is required for Southern, Sea or Volcanic Islands GPUs, and
111 used by default in all other R600 or later radeon GPUs. To see which
112 GPUs are in these categories, read the <ulink url="&radeon-marketing-names;">
113 Decoder ring for engineering vs marketing names</ulink>.
114 </para>
115 </note>
116
117 <para condition="html" role="usernotes">
118 User Notes: <ulink url="&blfs-wiki;/xorg-ati-driver"/>
119 </para>
120 </sect3>
121
122 <sect3 role="kernel" id="xorg-ati-driver-kernel">
123 <title>Kernel Configuration</title>
124
125 <para>
126 Enable the following options in the kernel configuration and recompile
127 the kernel if necessary:
128 </para>
129
130<screen><literal>Device Drivers ---&gt;
131 Graphics support ---&gt;
132 &lt;*&gt; Direct Rendering Manager (XFree86 ... support) ---&gt; [CONFIG_DRM]
133 &lt;*&gt; ATI Radeon [CONFIG_DRM_RADEON]</literal></screen>
134
135 <indexterm zone="xorg-ati-driver xorg-ati-driver-kernel">
136 <primary sortas="d-xorg-ati-driver">xorg-ati-driver</primary>
137 </indexterm>
138 </sect3>
139
140 <sect3 role="kernel" id="xorg-ati-firmware-kernel">
141 <title>Kernel Configuration for additional firmware</title>
142
143 <para>
144 If you need to add firmware, install the file(s) and then point to them in the
145 kernel configuration and recompile the kernel if necessary. To find out which
146 firmware you need, consult the <ulink url="&radeon-marketing-names;">
147 Decoder ring for engineering vs marketing names</ulink>. Download any firmware
148 for your card which is named like:
149 <filename><replaceable>&lt;ENGINEERING_NAME&gt;</replaceable>_rlc.bin</filename>,
150 etc. Note that for R600 and R700 family, generic
151 <filename>R600_rlc.bin</filename> and <filename>R700_rlc.bin</filename> are
152 necessary in addition to the model specific firmware, while for later generations
153 you need the
154 <filename>BTC_rlc.bin</filename> in addition to the model specific firmware.
155 Below is an example for a Radeon HD6470 which is a "Northern Islands" GPU,
156 plus an RTL network chip that also requests extra firmware:
157 </para>
158
159<screen><literal>CONFIG_EXTRA_FIRMWARE="radeon/BTC_rlc.bin radeon/CAICOS_mc.bin radeon/CAICOS_me.bin
160radeon/CAICOS_pfp.bin radeon/CAICOS_smc.bin rtl_nic/rtl8168e-3.fw"
161CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
162
163 <note>
164 <para>
165 CONFIG_EXTRA_FIRMWARE should all be on one line. It
166 is shown above as two lines for presentation only.
167 </para>
168 </note>
169
170 <tip>
171 <para>
172 You can check <command>dmesg</command> output after boot to see which firmware
173 is missing.
174 </para>
175 </tip>
176
177 <para>
178 Alternatively, if you change CONFIG_DRM_RADEON to '=m' in your .config
179 the firmware can be loaded automatically from /lib/firmware/radeon when
180 it installs the module. This offers a tiny space saving, but also means
181 that the screen will be blank for a longer time before the framebuffer
182 appears. Distros take this approach because it is not practical to
183 specify every possible firmware and the kernel would be excessively big.
184 </para>
185
186 <indexterm zone="xorg-ati-driver xorg-ati-firmware-kernel">
187 <primary sortas="d-xorg-ati-firmware">xorg-ati-firmware</primary>
188 </indexterm>
189 </sect3>
190
191 <sect3 role="installation">
192 <title>Installation of Xorg ATI Driver</title>
193
194<!--
195 Note: Fixed upstream, should be unneeded for versions gtr 19.1.0.
196 Patch also includes the fix.
197
198 <para>
199 First, fix an issue exposed by GCC 10 and later:
200 </para>
201
202<screen><userinput>sed -e 's/miPointer/extern &amp;/' \
203 -i src/drmmode_display.h</userinput></screen>
204-->
205
206 <para>
207 First, apply a patch including fixes for known performance regressions
208 and future problems with Xorg-Server.
209 </para>
210
211<screen><userinput remap="pre">patch -Np1 -i ../xf86-video-ati-&xorg-ati-driver-version;-upstream_fixes-1.patch</userinput></screen>
212
213 <para>
214 Install <application>Xorg ATI Driver</application> by running the following
215 commands:
216 </para>
217
218<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
219make</userinput></screen>
220
221 <para>
222 This package does not come with a test suite.
223 </para>
224
225 <para>
226 Now, as the <systemitem class="username">root</systemitem> user:
227 </para>
228
229<screen role="root"><userinput>make install</userinput></screen>
230<!-- following is (now) automatically installed
231install -v -m644 conf/10-radeon.conf \
232 $XORG_PREFIX/share/X11/xorg.conf.d -->
233 </sect3>
234
235<!--
236 <sect3 id="ati-glamor-accel">
237 <title>Glamor Acceleration</title>
238
239 <para>
240 Glamor is an acceleration library which uses cards' 3D capabilities
241 to accelerate 2D rendering. Glamor acceleration is either required
242 or used by default for all R600 and later GPUs. To see which GPUs are
243 in these categories, read the <ulink url="&radeon-marketing-names;">
244 Decoder ring for engineering vs marketing names</ulink>.
245 </para>
246
247 <para>
248 Please note
249 that Glamor acceleration can be used with other chips as well, from the
250 R300 onwards. On at least some Northern Islands chips it is beneficial.
251 </para>
252
253 <para>
254 Glamor acceleration is not enabled by default for chipsets that don't
255 use "radeonsi" Gallium3D driver. You have to use an
256 <filename>xorg.conf</filename> file to enable it. To enable
257 Glamor for cards other than "Southern Islands" and later, create the
258 following file in
259 <filename class="directory">${XORG_PREFIX}/share/X11/xorg.conf.d/</filename>
260 as the <systemitem class="username">root</systemitem> user:
261 </para>
262
263<screen role="root"><userinput>cat &gt;&gt; ${XORG_PREFIX}/share/X11/xorg.conf.d/20-glamor.conf &lt;&lt; "EOF"
264<literal>Section "Device"
265 Identifier "radeon"
266 Driver "ati"
267 Option "AccelMethod" "glamor"
268EndSection</literal>
269EOF</userinput></screen>
270
271 </sect3>-->
272
273 <!--
274 <sect3 role="commands">
275 <title>Command Explanations</title>
276
277
278 <para>
279 <command>install -v -m644 conf/10-radeon.conf ...</command>: this
280 ensures that the radeon driver can be loaded automatically even if
281 the ati wrapper driver has not been installed.
282 </para>
283
284 </sect3> -->
285
286 <sect3 role="content">
287 <title>Contents</title>
288
289 <segmentedlist>
290 <segtitle>Installed Xorg Drivers</segtitle>
291
292 <seglistitem>
293 <seg>
294 ati_drv.so and radeon_drv.so
295 </seg>
296 </seglistitem>
297 </segmentedlist>
298
299 <variablelist>
300 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
301 <?dbfo list-presentation="list"?>
302 <?dbhtml list-presentation="table"?>
303
304 <varlistentry id="ati_drv">
305 <term><filename class="libraryfile">ati_drv.so</filename></term>
306 <listitem>
307 <para>
308 is a wrapper driver for ATI video cards that autodetects ATI
309 video hardware and loads the radeon, mach64 or r128 driver
310 depending on which video card is in use
311 </para>
312 <indexterm zone="xorg-ati-driver ati_drv">
313 <primary sortas="c-ati_drv">ati_drv.so</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="radeon_drv">
319 <term><filename class="libraryfile">radeon_drv.so</filename></term>
320 <listitem>
321 <para>
322 is an Xorg video driver for ATI Radeon based video cards
323 </para>
324 <indexterm zone="xorg-ati-driver radeon_drv">
325 <primary sortas="c-radeon_drv">radeon_drv.so</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 </variablelist>
331
332 </sect3>
333
334 </sect2>
Note: See TracBrowser for help on using the repository browser.