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

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 fe0192e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 years ago

more SVN prop clean up

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