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

10.0 10.1 11.0 11.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a045599 was a045599, checked in by Ken Moffat <ken@…>, 7 years ago

First attempt at allowing for firmware which is not built in to the kernel.

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

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