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

10.0 10.1 11.0 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f5237a8 was f5237a8, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Tags and minor updates

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

  • Property mode set to 100644
File size: 10.1 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 "7.4.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 "8ee095009e927d61be522f392bdb843e">
15 <!ENTITY xorg-ati-driver-size "813 KB">
16 <!ENTITY xorg-ati-driver-buildsize "17 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 <title>Xorg ATI Driver-&xorg-ati-driver-version;</title>
24
25 <indexterm zone="xorg-ati-driver">
26 <primary sortas="a-xorg-ati-driver">xorg-ati-driver</primary>
27 </indexterm>
28
29 <sect3 role="package">
30 <title>Introduction to Xorg ATI Driver</title>
31
32 <para>
33 The <application>Xorg ATI Driver</application> package contains the X.Org
34 Video Driver for ATI Radeon video cards including all chipsets ranging
35 from R100 to R900 and the newer RAxx chipsets.
36 </para>
37
38 &lfs76_checked;
39
40 <note>
41 <para>
42 For Direct Rendering to work with newer Radeon Cards (R300 and later chipsets),
43 you need to enable the r300, r600 and radeonsi Gallium drivers at
44 <xref linkend="mesalib"/> build time. Also, some cards require Firmware to be
45 available when the kernel driver is loaded. Firmware can be obtained from
46 <ulink url="http://people.freedesktop.org/~agd5f/radeon_ucode/">
47 this</ulink> site. See "Kernel Configuration for additional firmware" below.
48 </para>
49 </note>
50
51 <bridgehead renderas="sect4">Package Information</bridgehead>
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>
55 Download (HTTP): <ulink url="&xorg-ati-driver-download-http;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download (FTP): <ulink url="&xorg-ati-driver-download-ftp;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download MD5 sum: &xorg-ati-driver-md5sum;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download size: &xorg-ati-driver-size;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated disk space required: &xorg-ati-driver-buildsize;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated build time: &xorg-ati-driver-time;
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect4">Xorg ATI Driver Dependencies</bridgehead>
86
87 <bridgehead renderas="sect5">Required</bridgehead>
88 <para role="required">
89 <xref linkend="xorg-server"/> (recommended to be built with glamor enabled)
90 </para>
91
92 <note>
93 <para>
94 Glamor is <emphasis>required for "Southern Islands" and later
95 GPUs</emphasis> but optional for R300 to R700, Evergreen and
96 "Northern Islands" GPUs - see the link under "Glamor
97 Acceleration" below.
98 </para>
99 </note>
100
101 <para condition="html" role="usernotes">
102 User Notes: <ulink url="&blfs-wiki;/xorg-ati-driver"/>
103 </para>
104 </sect3>
105
106 <sect3 role="kernel" id="xorg-ati-driver-kernel">
107 <title>Kernel Configuration</title>
108
109 <para>
110 Enable the following options in the kernel configuration and recompile the
111 kernel if necessary:
112 </para>
113
114<screen><literal>Device Drivers ---&gt;
115 Graphics support ---&gt;
116 ATI Radeon: Y or M</literal></screen>
117
118 <indexterm zone="xorg-ati-driver xorg-ati-driver-kernel">
119 <primary sortas="d-xorg-ati-driver">xorg-ati-driver</primary>
120 </indexterm>
121 </sect3>
122
123 <sect3 role="kernel" id="xorg-ati-firmware-kernel">
124 <title>Kernel Configuration for additional firmware</title>
125
126 <para>
127 If you need to add firmware, install the file(s) and then point to them in the
128 kernel configuration and recompile the kernel if necessary. To find out which
129 firmware you need, consult the <ulink url="&radeon-marketing-names;">
130 Decoder ring for engineering vs marketing names</ulink>. Download any firmware
131 for your card which is named like:
132 <filename><replaceable>&lt;ENGINEERING_NAME&gt;</replaceable>_rlc.bin</filename>,
133 etc. Note that for R600 and R700 family, generic
134 <filename>R600_rlc.bin</filename> and <filename>R700_rlc.bin</filename> are
135 necessary in adition to the model specific firmware, while for later generations
136 (Evergreen, "Northern Islands" and probably "Southern Islands") you need the
137 <filename>BTC_rlc.bin</filename> in adition to the model specific firmware.
138 Below is an example for Radeon HD6470, which is "Northern Islands" GPU with a
139 network card that also requires the firmware:
140 </para>
141
142<screen><literal>CONFIG_EXTRA_FIRMWARE="radeon/BTC_rlc.bin radeon/CAICOS_mc.bin radeon/CAICOS_me.bin
143radeon/CAICOS_pfp.bin radeon/CAICOS_smc.bin rtl_nic/rtl8168e-3.fw"
144CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
145
146 <note><para>CONFIG_EXTRA_FIRMWARE should all be on one line. It
147 is shown above as two lines for presentation only.</para></note>
148
149 <tip>
150 <para>
151 You can check <command>dmesg</command> output after boot to see which firmware
152 is missing.
153 </para>
154 </tip>
155
156 <indexterm zone="xorg-ati-driver xorg-ati-firmware-kernel">
157 <primary sortas="d-xorg-ati-firmware">xorg-ati-firmware</primary>
158 </indexterm>
159 </sect3>
160
161 <sect3 role="installation">
162 <title>Installation of Xorg ATI Driver</title>
163
164 <para>
165 Install <application>Xorg ATI Driver</application> by running the following
166 commands:
167 </para>
168
169<screen><userinput>sed -i -e '/ac_cv_header_glamor/s/\$ac_includes_default/#include \\"xorg-server.h\\"/' \
170 -e '/GLAMOR_NO_DRI3/s/\(#include \)/\1\\"xorg-server.h\\"\n\1/' configure &amp;&amp;
171./configure $XORG_CONFIG &amp;&amp;
172make</userinput></screen>
173
174 <para>
175 This package does not come with a test suite.
176 </para>
177
178 <para>
179 Now, as the <systemitem class="username">root</systemitem> user:
180 </para>
181
182<screen role="root"><userinput>make install</userinput></screen>
183 </sect3>
184
185 <sect3 role="commands">
186 <title>Command Explanations</title>
187
188 <para>
189 <parameter>sed -i -e '/ac_cv_header_glamor/s/\$ac_includes_default/#include \\"xorg-server.h\\"/'
190 -e '/GLAMOR_NO_DRI3/s/\(#include \)/\1\\"xorg-server.h\\"\n\1/' configure</parameter>:
191 this fixes compilation with glamor (the default) from xorg-server with recent
192 <application>glibc</application>.
193 </para>
194
195 </sect3>
196
197 <sect3>
198 <title>Glamor Acceleration</title>
199
200 <para>
201 Glamor is an acceleration library which uses cards' 3D capabilities
202 to accelerate 2D rendering. Glamor acceleration is required for
203 Radeon "Southern Islands" GPUs which use "radeonsi" Gallium3D driver
204 from <xref linkend="mesalib"/>. To see which cards fall under
205 "Southern Islands" category, read the
206 <ulink url="&radeon-marketing-names;">
207 Decoder ring for engineering vs marketing names</ulink>. Please note
208 that Glamor acceleration can be used with other chips as well, from the
209 R300 onwards, but it has not been tested recently.
210 </para>
211
212 <para>
213 Glamor acceleration is not enabled by default for chipsets that don't
214 use "radeonsi" Gallium3D driver. You have to use a
215 <filename>xorg.conf</filename> file to enable it. To enable
216 Glamor for cards other than "Southern Islands" and later, create the
217 following <filename>/etc/X11/xorg.conf</filename> as the
218 <systemitem class="username">root</systemitem> user:
219 </para>
220
221<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf &lt;&lt; "EOF"
222<literal>Section "Module"
223 Load "dri2"
224 Load "glamoregl"
225EndSection
226
227Section "Device"
228 Identifier "radeon"
229 Driver "radeon"
230 Option "AccelMethod" "glamor"
231EndSection</literal>
232EOF</userinput></screen>
233
234 </sect3>
235
236 <sect3 role="content">
237 <title>Contents</title>
238
239 <segmentedlist>
240 <segtitle>Installed Xorg Drivers</segtitle>
241
242 <seglistitem>
243 <seg>
244 ati_drv.so and radeon_drv.so
245 </seg>
246 </seglistitem>
247 </segmentedlist>
248
249 <variablelist>
250 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
251 <?dbfo list-presentation="list"?>
252 <?dbhtml list-presentation="table"?>
253
254 <varlistentry id="ati_drv">
255 <term><filename class="libraryfile">ati_drv.so</filename></term>
256 <listitem>
257 <para>
258 is a wrapper driver for ATI video cards that autodetects ATI
259 video hardware and loads radeon, mach64 or r128 driver.
260 </para>
261 <indexterm zone="xorg-ati-driver ati_drv">
262 <primary sortas="c-ati_drv">ati_drv.so</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="radeon_drv">
268 <term><filename class="libraryfile">radeon_drv.so</filename></term>
269 <listitem>
270 <para>
271 is an Xorg video driver for ATI Radeon based video cards.
272 </para>
273 <indexterm zone="xorg-ati-driver radeon_drv">
274 <primary sortas="c-radeon_drv">radeon_drv.so</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 </variablelist>
280
281 </sect3>
282
283 </sect2>
284 <!-- End Xorg ATI Driver -->
Note: See TracBrowser for help on using the repository browser.