source: x/installing/x7driver-amdgpu.xml@ c93c620c

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c93c620c was c93c620c, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Tags

  • Property mode set to 100644
File size: 8.5 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;#decoderringforengineeringvsmarketingnames">
9
10 <!ENTITY xorg-amdgpu-driver-version "21.0.0">
11
12 <!ENTITY xorg-amdgpu-driver-download-http "&xorg-download-http;/driver/xf86-video-amdgpu-&xorg-amdgpu-driver-version;.tar.bz2">
13 <!ENTITY xorg-amdgpu-driver-download-ftp "&xorg-download-ftp;/driver/xf86-video-amdgpu-&xorg-amdgpu-driver-version;.tar.bz2">
14 <!ENTITY xorg-amdgpu-driver-md5sum "61a4af51082a58c63af8970b06c3f4be">
15 <!ENTITY xorg-amdgpu-driver-size "440 KB">
16 <!ENTITY xorg-amdgpu-driver-buildsize "6.0 MB">
17 <!ENTITY xorg-amdgpu-driver-time "less than 0.1 SBU">
18]>
19
20 <!-- Begin Xorg AMDGPU Driver -->
21 <sect2 id="xorg-amdgpu-driver" xreflabel="Xorg AMDGPU Driver-&xorg-amdgpu-driver-version;">
22
23 <sect2info>
24 <date>$Date$</date>
25 </sect2info>
26
27 <title>Xorg AMDGPU Driver-&xorg-amdgpu-driver-version;</title>
28
29 <indexterm zone="xorg-amdgpu-driver">
30 <primary sortas="a-xorg-amdgpu-driver">xorg-amdgpu-driver</primary>
31 </indexterm>
32
33 <sect3 role="package">
34 <title>Introduction to Xorg AMDGPU Driver</title>
35
36 <para>
37 The <application>Xorg AMDGPU Driver</application> package contains the X.Org
38 Video Driver for newer AMD Radeon video cards starting from Volcanic Islands.
39 It can also be used for Southern and Sea Islands if the experimental support
40 was enabled in the kernel.
41 </para>
42
43 &lfs110a_checked;
44
45 <note>
46 <para>
47 For Direct Rendering to work, you need to enable the radeonsi Gallium
48 driver at <xref linkend="mesa"/> build time. Also, all 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-amdgpu-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-amdgpu-driver-download-http;"/>
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download (FTP): <ulink url="&xorg-amdgpu-driver-download-ftp;"/>
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download MD5 sum: &xorg-amdgpu-driver-md5sum;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Download size: &xorg-amdgpu-driver-size;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Estimated disk space required: &xorg-amdgpu-driver-buildsize;
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Estimated build time: &xorg-amdgpu-driver-time;
87 </para>
88 </listitem>
89 </itemizedlist>
90
91 <bridgehead renderas="sect4">Xorg AMDGPU Driver Dependencies</bridgehead>
92
93 <bridgehead renderas="sect5">Required</bridgehead>
94 <para role="required">
95 <xref linkend="xorg-server"/> (must be built with glamor enabled)
96 </para>
97
98 <para condition="html" role="usernotes">
99 User Notes: <ulink url="&blfs-wiki;/xorg-amdgpu-driver"/>
100 </para>
101 </sect3>
102
103 <sect3 role="kernel" id="xorg-amdgpu-driver-kernel">
104 <title>Kernel Configuration</title>
105
106 <para>
107 Enable the following options in the kernel configuration and recompile
108 the kernel if necessary:
109 </para>
110
111<!-- Editor note: CONFIG_DRM_AMDGPU_SI available in 4.9+ -->
112<screen><literal>Device Drivers ---&gt;
113 Graphics support ---&gt;
114 &lt;*&gt; Direct Rendering Manager (XFree86 ... support) ---&gt; [CONFIG_DRM]
115 &lt;*/M&gt; AMD GPU [CONFIG_DRM_AMDGPU]
116 &lt; /*&gt; Enable amdgpu support for SI parts [CONFIG_DRM_AMDGPU_SI]
117 &lt; /*&gt; Enable amdgpu support for CIK parts [CONFIG_DRM_AMDGPU_CIK]</literal></screen>
118
119 <para>
120 The last two options enable experimental support for Southern and
121 Sea Islands AMD GPUs so they can be used with this driver. Note that
122 the support is marked experimental and disabled by default.
123 <xref linkend="xorg-ati-driver"/> should be used for those GPUs.
124 </para>
125
126 <indexterm zone="xorg-amdgpu-driver xorg-amdgpu-driver-kernel">
127 <primary sortas="d-xorg-amdgpu-driver">xorg-amdgpu-driver</primary>
128 </indexterm>
129 </sect3>
130
131 <sect3 role="kernel" id="xorg-amdgpu-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. Below is an example for Radeon R7 M340 GPU, which is codenamed
142 Iceland/Topaz, along with a network card that also requires the firmware:
143 </para>
144
145<screen><literal>CONFIG_EXTRA_FIRMWARE="amdgpu/topaz_ce.bin amdgpu/topaz_k_smc.bin amdgpu/topaz_mc.bin
146 amdgpu/topaz_me.bin amdgpu/topaz_mec2.bin amdgpu/topaz_mec.bin
147 amdgpu/topaz_pfp.bin amdgpu/topaz_rlc.bin amdgpu/topaz_sdma1.bin
148 amdgpu/topaz_sdma.bin amdgpu/topaz_smc.bin rtl_nic/rtl8168e-3.fw"
149CONFIG_EXTRA_FIRMWARE_DIR="/lib/firmware"</literal></screen>
150
151 <note>
152 <para>
153 CONFIG_EXTRA_FIRMWARE should all be on one line. It is shown above as
154 multiple lines for presentation only.
155 </para>
156 </note>
157
158 <tip>
159 <para>
160 You can check <command>dmesg</command> output after boot to see which firmware
161 is missing.
162 </para>
163 </tip>
164
165 <para>
166 Alternatively, if you change CONFIG_DRM_AMDGPU to '=m' in your linux
167 kernel .config the firmware can be loaded automatically from
168 /lib/firmware/amdgpu/ when it installs the module. This offers a tiny
169 space saving, but also means that the screen will be blank for a longer
170 time before the framebuffer appears. Distros take this approach because
171 it is not practical to specify every possible firmware and the kernel
172 would be excessively big.
173 </para>
174
175 <indexterm zone="xorg-amdgpu-driver xorg-amdgpu-firmware-kernel">
176 <primary sortas="d-xorg-amdgpu-firmware">xorg-amdgpu-firmware</primary>
177 </indexterm>
178 </sect3>
179
180 <sect3 role="installation">
181 <title>Installation of Xorg AMDGPU Driver</title>
182
183 <para>
184 Install <application>Xorg AMDGPU Driver</application> by running the following
185 commands:
186 </para>
187
188<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
189make</userinput></screen>
190
191 <para>
192 This package does not come with a test suite.
193 </para>
194
195 <para>
196 Now, as the <systemitem class="username">root</systemitem> user:
197 </para>
198
199<screen role="root"><userinput>make install</userinput></screen>
200 </sect3>
201
202 <sect3 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Xorg Driver</segtitle>
207
208 <seglistitem>
209 <seg>
210 amdgpu_drv.so
211 </seg>
212 </seglistitem>
213 </segmentedlist>
214
215 <variablelist>
216 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
217 <?dbfo list-presentation="list"?>
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="amdgpu_drv">
221 <term><filename class="libraryfile">amdgpu_drv.so</filename></term>
222 <listitem>
223 <para>
224 is an Xorg video driver for latest AMD Radeon video cards
225 </para>
226 <indexterm zone="xorg-amdgpu-driver amdgpu_drv">
227 <primary sortas="c-amdgpu_drv">amdgpu_drv.so</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 </variablelist>
233
234 </sect3>
235
236 </sect2>
Note: See TracBrowser for help on using the repository browser.