source: x/installing/x7driver-ati.xml@ 88902ba7

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 88902ba7 was 88902ba7, checked in by Douglas R. Reno <renodr@…>, 21 months ago

Tag ATI and VMWare driver

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

  • Property mode set to 100644
File size: 10.7 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 &lfs91_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><para>CONFIG_EXTRA_FIRMWARE should all be on one line. It
155 is shown above as two lines for presentation only.</para></note>
156
157 <tip>
158 <para>
159 You can check <command>dmesg</command> output after boot to see which firmware
160 is missing.
161 </para>
162 </tip>
163
164 <para>
165 Alternatively, if you change CONFIG_DRM_RADEON to '=m' in your .config
166 the firmware can be loaded automatically from /lib/firmware/radeon when
167 it installs the module. This offers a tiny space saving, but also means
168 that the screen will be blank for a longer time before the framebuffer
169 appears. Distros take this approach because it is not practical to
170 specify every possible firmware and the kernel would be excessively big.
171 </para>
172
173 <indexterm zone="xorg-ati-driver xorg-ati-firmware-kernel">
174 <primary sortas="d-xorg-ati-firmware">xorg-ati-firmware</primary>
175 </indexterm>
176 </sect3>
177
178 <sect3 role="installation">
179 <title>Installation of Xorg ATI Driver</title>
180
181 <para>
182 Install <application>Xorg ATI Driver</application> by running the following
183 commands:
184 </para>
185
186<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
187make</userinput></screen>
188
189 <para>
190 This package does not come with a test suite.
191 </para>
192
193 <para>
194 Now, as the <systemitem class="username">root</systemitem> user:
195 </para>
196
197<screen role="root"><userinput>make install</userinput></screen>
198<!-- following is (now) automatically installed
199install -v -m644 conf/10-radeon.conf \
200 $XORG_PREFIX/share/X11/xorg.conf.d -->
201 </sect3>
202
203<!--
204 <sect3 id="ati-glamor-accel">
205 <title>Glamor Acceleration</title>
206
207 <para>
208 Glamor is an acceleration library which uses cards' 3D capabilities
209 to accelerate 2D rendering. Glamor acceleration is either required
210 or used by default for all R600 and later GPUs. To see which GPUs are
211 in these categories, read the <ulink url="&radeon-marketing-names;">
212 Decoder ring for engineering vs marketing names</ulink>.
213 </para>
214
215 <para>
216 Please note
217 that Glamor acceleration can be used with other chips as well, from the
218 R300 onwards. On at least some Northern Islands chips it is beneficial.
219 </para>
220
221 <para>
222 Glamor acceleration is not enabled by default for chipsets that don't
223 use "radeonsi" Gallium3D driver. You have to use an
224 <filename>xorg.conf</filename> file to enable it. To enable
225 Glamor for cards other than "Southern Islands" and later, create the
226 following file in
227 <filename class="directory">${XORG_PREFIX}/share/X11/xorg.conf.d/</filename>
228 as the <systemitem class="username">root</systemitem> user:
229 </para>
230
231<screen role="root"><userinput>cat &gt;&gt; ${XORG_PREFIX}/share/X11/xorg.conf.d/20-glamor.conf &lt;&lt; "EOF"
232<literal>Section "Device"
233 Identifier "radeon"
234 Driver "ati"
235 Option "AccelMethod" "glamor"
236EndSection</literal>
237EOF</userinput></screen>
238
239 </sect3>-->
240
241 <!--
242 <sect3 role="commands">
243 <title>Command Explanations</title>
244
245
246 <para>
247 <command>install -v -m644 conf/10-radeon.conf ...</command>: this
248 ensures that the radeon driver can be loaded automatically even if
249 the ati wrapper driver has not been installed.
250 </para>
251
252 </sect3> -->
253
254 <sect3 role="content">
255 <title>Contents</title>
256
257 <segmentedlist>
258 <segtitle>Installed Xorg Drivers</segtitle>
259
260 <seglistitem>
261 <seg>
262 ati_drv.so and radeon_drv.so
263 </seg>
264 </seglistitem>
265 </segmentedlist>
266
267 <variablelist>
268 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
269 <?dbfo list-presentation="list"?>
270 <?dbhtml list-presentation="table"?>
271
272 <varlistentry id="ati_drv">
273 <term><filename class="libraryfile">ati_drv.so</filename></term>
274 <listitem>
275 <para>
276 is a wrapper driver for ATI video cards that autodetects ATI
277 video hardware and loads radeon, mach64 or r128 driver.
278 </para>
279 <indexterm zone="xorg-ati-driver ati_drv">
280 <primary sortas="c-ati_drv">ati_drv.so</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="radeon_drv">
286 <term><filename class="libraryfile">radeon_drv.so</filename></term>
287 <listitem>
288 <para>
289 is an Xorg video driver for ATI Radeon based video cards.
290 </para>
291 <indexterm zone="xorg-ati-driver radeon_drv">
292 <primary sortas="c-radeon_drv">radeon_drv.so</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 </variablelist>
298
299 </sect3>
300
301 </sect2>
302 <!-- End Xorg ATI Driver -->
Note: See TracBrowser for help on using the repository browser.