source: x/installing/x7driver-amdgpu.xml@ 297b344

10.1 11.0 11.1 11.2 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 297b344 was f39cf0d0, checked in by Ken Moffat <ken@…>, 22 months ago

Kernel config changes suggested by rhubarbpieguy

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

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