source: x/installing/x7driver-amdgpu.xml@ 751ceda

11.1 lazarus trunk xry111/intltool xry111/test-20220226
Last change on this file since 751ceda was 751ceda, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Package Updates.
Update to kf5-5.89. Includes

extra-cmake-modules
breeze-icons
oxygen-icons5

Update to plasma-wayland-protocols-1.5.0.
Make text clarification for amdgpu xorg driver.

  • Property mode set to 100644
File size: 8.6 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 and newer AMD-CPUs with
39 integrated graphics (APUs). This includes video cards starting with 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 &lfs110a_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 and newer APUs
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 Install <application>Xorg AMDGPU Driver</application> by running the following
186 commands:
187 </para>
188
189<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
190make</userinput></screen>
191
192 <para>
193 This package does not come with a test suite.
194 </para>
195
196 <para>
197 Now, as the <systemitem class="username">root</systemitem> user:
198 </para>
199
200<screen role="root"><userinput>make install</userinput></screen>
201 </sect3>
202
203 <sect3 role="content">
204 <title>Contents</title>
205
206 <segmentedlist>
207 <segtitle>Installed Xorg Driver</segtitle>
208
209 <seglistitem>
210 <seg>
211 amdgpu_drv.so
212 </seg>
213 </seglistitem>
214 </segmentedlist>
215
216 <variablelist>
217 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
218 <?dbfo list-presentation="list"?>
219 <?dbhtml list-presentation="table"?>
220
221 <varlistentry id="amdgpu_drv">
222 <term><filename class="libraryfile">amdgpu_drv.so</filename></term>
223 <listitem>
224 <para>
225 is an Xorg video driver for latest AMD Radeon video cards
226 </para>
227 <indexterm zone="xorg-amdgpu-driver amdgpu_drv">
228 <primary sortas="c-amdgpu_drv">amdgpu_drv.so</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 </variablelist>
234
235 </sect3>
236
237 </sect2>
Note: See TracBrowser for help on using the repository browser.