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

10.1 11.0 11.1 11.2 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since b3940b1b was b3940b1b, checked in by Douglas R. Reno <renodr@…>, 20 months ago

Final tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24309 af4574ff-66df-0310-9fd7-8a98e5e911e0

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