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

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 e376303 was e376303, checked in by Ken Moffat <ken@…>, 7 years ago

Fix xf86-video-ati-7.4.0 for glamor from xorg-server: personally, I find the patch easier to understand.

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

  • Property mode set to 100644
File size: 9.9 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 &lfs75_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 radeon/CAICOS_pfp.bin radeon/CAICOS_smc.bin rtl_nic/rtl8168e-3.fw"
143CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
144
145 <tip>
146 <para>
147 You can check <command>dmesg</command> output after boot to see which firmware
148 is missing.
149 </para>
150 </tip>
151
152 <indexterm zone="xorg-ati-driver xorg-ati-firmware-kernel">
153 <primary sortas="d-xorg-ati-firmware">xorg-ati-firmware</primary>
154 </indexterm>
155 </sect3>
156
157 <sect3 role="installation">
158 <title>Installation of Xorg ATI Driver</title>
159
160 <para>
161 Install <application>Xorg ATI Driver</application> by running the following
162 commands:
163 </para>
164
165<screen><userinput>sed -i -e '/ac_cv_header_glamor/s/\$ac_includes_default/#include \\"xorg-server.h\\"/' \
166 -e '/GLAMOR_NO_DRI3/s/\(#include \)/\1\\"xorg-server.h\\"\n\1/' configure &amp;&amp;
167./configure $XORG_CONFIG &amp;&amp;
168make</userinput></screen>
169
170 <para>
171 This package does not come with a test suite.
172 </para>
173
174 <para>
175 Now, as the <systemitem class="username">root</systemitem> user:
176 </para>
177
178<screen role="root"><userinput>make install</userinput></screen>
179 </sect3>
180
181 <sect3 role="commands">
182 <title>Command Explanations</title>
183
184 <para>
185 <parameter>sed -i -e '/ac_cv_header_glamor/s/\$ac_includes_default/#include \\"xorg-server.h\\"/'
186 -e '/GLAMOR_NO_DRI3/s/\(#include \)/\1\\"xorg-server.h\\"\n\1/' configure</parameter>:
187 this fixes compilation with glamor (the default) from xorg-server with recent
188 <application>glibc</application>.
189 </para>
190
191 </sect3>
192
193 <sect3>
194 <title>Glamor Acceleration</title>
195
196 <para>
197 Glamor is an acceleration library which uses cards' 3D capabilities
198 to accelerate 2D rendering. Glamor acceleration is required for
199 Radeon "Southern Islands" GPUs which use "radeonsi" Gallium3D driver
200 from <xref linkend="mesalib"/>. To see which cards fall under
201 "Southern Islands" category, read the
202 <ulink url="&radeon-marketing-names;">
203 Decoder ring for engineering vs marketing names</ulink>. Please note
204 that Glamor acceleration can be used with other chips as well, from the
205 R300 onwards, but it has not been tested recently.
206 </para>
207
208 <para>
209 Glamor acceleration is not enabled by default for chipsets that don't
210 use "radeonsi" Gallium3D driver. You have to use a
211 <filename>xorg.conf</filename> file to enable it. To enable
212 Glamor for cards other than "Southern Islands" and later, create the
213 following <filename>/etc/X11/xorg.conf</filename> as the
214 <systemitem class="username">root</systemitem> user:
215 </para>
216
217<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf &lt;&lt; "EOF"
218<literal>Section "Module"
219 Load "dri2"
220 Load "glamoregl"
221EndSection
222
223Section "Device"
224 Identifier "radeon"
225 Driver "radeon"
226 Option "AccelMethod" "glamor"
227EndSection</literal>
228EOF</userinput></screen>
229
230 </sect3>
231
232 <sect3 role="content">
233 <title>Contents</title>
234
235 <segmentedlist>
236 <segtitle>Installed Xorg Drivers</segtitle>
237
238 <seglistitem>
239 <seg>
240 ati_drv.so and radeon_drv.so
241 </seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="ati_drv">
251 <term><filename class="libraryfile">ati_drv.so</filename></term>
252 <listitem>
253 <para>
254 is a wrapper driver for ATI video cards that autodetects ATI
255 video hardware and loads radeon, mach64 or r128 driver.
256 </para>
257 <indexterm zone="xorg-ati-driver ati_drv">
258 <primary sortas="c-ati_drv">ati_drv.so</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="radeon_drv">
264 <term><filename class="libraryfile">radeon_drv.so</filename></term>
265 <listitem>
266 <para>
267 is an Xorg video driver for ATI Radeon based video cards.
268 </para>
269 <indexterm zone="xorg-ati-driver radeon_drv">
270 <primary sortas="c-radeon_drv">radeon_drv.so</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 </variablelist>
276
277 </sect3>
278
279 </sect2>
280 <!-- End Xorg ATI Driver -->
Note: See TracBrowser for help on using the repository browser.