source: x/installing/x7driver-ati.xml@ 71df408

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 71df408 was 71df408, checked in by Pierre Labastie <pieere@…>, 4 years ago

Format the x/installing chapter

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22865 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>
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 <para>
186 Install <application>Xorg ATI Driver</application> by running the following
187 commands:
188 </para>
189
190<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
191make</userinput></screen>
192
193 <para>
194 This package does not come with a test suite.
195 </para>
196
197 <para>
198 Now, as the <systemitem class="username">root</systemitem> user:
199 </para>
200
201<screen role="root"><userinput>make install</userinput></screen>
202<!-- following is (now) automatically installed
203install -v -m644 conf/10-radeon.conf \
204 $XORG_PREFIX/share/X11/xorg.conf.d -->
205 </sect3>
206
207<!--
208 <sect3 id="ati-glamor-accel">
209 <title>Glamor Acceleration</title>
210
211 <para>
212 Glamor is an acceleration library which uses cards' 3D capabilities
213 to accelerate 2D rendering. Glamor acceleration is either required
214 or used by default for all R600 and later GPUs. To see which GPUs are
215 in these categories, read the <ulink url="&radeon-marketing-names;">
216 Decoder ring for engineering vs marketing names</ulink>.
217 </para>
218
219 <para>
220 Please note
221 that Glamor acceleration can be used with other chips as well, from the
222 R300 onwards. On at least some Northern Islands chips it is beneficial.
223 </para>
224
225 <para>
226 Glamor acceleration is not enabled by default for chipsets that don't
227 use "radeonsi" Gallium3D driver. You have to use an
228 <filename>xorg.conf</filename> file to enable it. To enable
229 Glamor for cards other than "Southern Islands" and later, create the
230 following file in
231 <filename class="directory">${XORG_PREFIX}/share/X11/xorg.conf.d/</filename>
232 as the <systemitem class="username">root</systemitem> user:
233 </para>
234
235<screen role="root"><userinput>cat &gt;&gt; ${XORG_PREFIX}/share/X11/xorg.conf.d/20-glamor.conf &lt;&lt; "EOF"
236<literal>Section "Device"
237 Identifier "radeon"
238 Driver "ati"
239 Option "AccelMethod" "glamor"
240EndSection</literal>
241EOF</userinput></screen>
242
243 </sect3>-->
244
245 <!--
246 <sect3 role="commands">
247 <title>Command Explanations</title>
248
249
250 <para>
251 <command>install -v -m644 conf/10-radeon.conf ...</command>: this
252 ensures that the radeon driver can be loaded automatically even if
253 the ati wrapper driver has not been installed.
254 </para>
255
256 </sect3> -->
257
258 <sect3 role="content">
259 <title>Contents</title>
260
261 <segmentedlist>
262 <segtitle>Installed Xorg Drivers</segtitle>
263
264 <seglistitem>
265 <seg>
266 ati_drv.so and radeon_drv.so
267 </seg>
268 </seglistitem>
269 </segmentedlist>
270
271 <variablelist>
272 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
273 <?dbfo list-presentation="list"?>
274 <?dbhtml list-presentation="table"?>
275
276 <varlistentry id="ati_drv">
277 <term><filename class="libraryfile">ati_drv.so</filename></term>
278 <listitem>
279 <para>
280 is a wrapper driver for ATI video cards that autodetects ATI
281 video hardware and loads radeon, mach64 or r128 driver.
282 </para>
283 <indexterm zone="xorg-ati-driver ati_drv">
284 <primary sortas="c-ati_drv">ati_drv.so</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="radeon_drv">
290 <term><filename class="libraryfile">radeon_drv.so</filename></term>
291 <listitem>
292 <para>
293 is an Xorg video driver for ATI Radeon based video cards.
294 </para>
295 <indexterm zone="xorg-ati-driver radeon_drv">
296 <primary sortas="c-radeon_drv">radeon_drv.so</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 </variablelist>
302
303 </sect3>
304
305 </sect2>
306 <!-- End Xorg ATI Driver -->
Note: See TracBrowser for help on using the repository browser.