source: x/installing/x7driver-ati.xml@ 11db9792

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 11db9792 was 11db9792, checked in by Thomas Trepl <thomas@…>, 4 years ago

Fix for gcc-10

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