source: multimedia/libdriv/intel-media.xml@ 6354d17

12.1 ken/TL2024 lazarus trunk xry111/llvm18
Last change on this file since 6354d17 was 6dbc482, checked in by Douglas R. Reno <renodr@…>, 4 months ago

Untag the multimedia drivers

  • Property mode set to 100644
File size: 8.9 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 intel-media-driver-version "23.2.4">-->
8
9 <!ENTITY intel-media-download-http "https://github.com/intel/media-driver/archive/refs/tags/intel-media-&intel-media-version;.tar.gz">
10 <!ENTITY intel-media-download-ftp " ">
11 <!ENTITY intel-media-md5sum "5e2fffaf1c1972b8791c3cfd59cd6a9e">
12 <!ENTITY intel-media-size "25 MB">
13 <!ENTITY intel-media-buildsize "2.1 GB (359 MB installed)">
14 <!ENTITY intel-media-time "6.3 SBU (with parallelism=4)">
15
16]>
17
18 <sect1 id="intel-media" xreflabel="intel-media-&intel-media-version;">
19 <?dbhtml filename="intel-media.html"?>
20
21 <sect1info>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>intel-media-&intel-media-version;</title>
26
27 <indexterm zone="intel-media">
28 <primary sortas="a-intel-media">intel-media</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to intel-media</title>
33
34 <para>
35 The <application>intel-media</application> package provides a
36 VA API driver for Intel GPUs that are provided with Broadwell CPUs and
37 higher. This includes support for a variety of codecs.
38 </para>
39
40 &lfs120_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&intel-media-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&intel-media-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &intel-media-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &intel-media-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &intel-media-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &intel-media-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76<!--
77 <bridgehead renderas="sect2">Additional Downloads</bridgehead>
78 <itemizedlist spacing="compact">
79 <listitem>
80 <para>
81 Required patch:
82 <ulink url="&patch-root;/intel-media-&intel-media-version;-upstream_fixes-1.patch"/>
83 </para>
84 </listitem>
85 </itemizedlist>
86-->
87
88 <note>
89 <para>
90 The tarball <filename>intel-media-&intel-media-version;.tar.gz</filename>
91 will extract to the directory
92 <filename class="directory">media-driver-intel-media-&intel-media-version;</filename>.
93 </para>
94 </note>
95
96 <bridgehead renderas="sect3">intel-media Dependencies</bridgehead>
97
98 <bridgehead renderas="sect4">Required</bridgehead>
99 <para role="required">
100 <xref linkend="cmake"/>,
101 <xref linkend="intel-gmmlib"/>,
102 <xref linkend="libva"/>, and
103 <xref linkend="xorg-env"/>
104 </para>
105
106 </sect2>
107
108 <sect2 role="kernel" id='intel-media-kernel'>
109 <title>Kernel Configuration</title>
110
111 <para>
112 Enable the following options in the kernel configuration.
113 Recompile the kernel if necessary:
114 </para>
115
116 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
117 href="intel-media-kernel.xml"/>
118
119 <indexterm zone="intel-media intel-media-kernel">
120 <primary sortas="d-intel-media">intel-media</primary>
121 </indexterm>
122 </sect2>
123
124 <!-- TODO: It's said Gen9+ (Skylake or later) may need some firmware files. -->
125
126 <sect2 role="installation">
127 <title>Installation of intel-media</title>
128
129 <note>
130 <para>
131 This package takes a long time to build because it compiles code
132 specific to each individual generation of Intel GPUs and for a
133 variety of media codecs.
134 </para>
135
136 <!-- This reduce the size of iHD_drv_video.so from 319M to 157M
137 for me. -->
138 <!-- It seems ARL depends on MTL. We need to review once an Arrow
139 Lake CPU is launched. -->
140 <!-- Support for ARL is completely broken, needs to be turned off to
141 complete the build -->
142 <para>
143 If you know the model of your Intel GPU, you can pass the
144 <option>-D{GEN{8,9,11,12},MTL,ARL}=OFF</option> option to the
145 <command>cmake</command> command but leaving the option for your
146 GPU out. Note that the <quote>GEN</quote> number here is the
147 generation of the GPU, not the CPU. For example, with an Intel
148 Core i7-1065G7 CPU shipping a 11th-generation Intel GPU, the
149 <option>-D{GEN{8,9,12},MTL,ARL}=OFF</option> option can be used
150 so the code specific to the other generations of Intel GPUs won't
151 be built.
152 </para>
153
154 <para>
155 To determine the model of the Intel GPU, run
156 <command>lspci -nn | grep -Ei 'VGA|DISPLAY'</command> first.
157 It will output some information about the GPU. If the output
158 contains <literal>Meteor Lake</literal>, the GPU model is
159 <literal>MTL</literal>. Otherwise, follow
160 <ulink url='https://dgpu-docs.intel.com/devices/hardware-table.html'/>
161 to find the entry for your GPU and the model of the GPU should
162 be in the <quote>Architecture</quote> column. The Xe and XeHPG
163 architectures are covered by the <literal>GEN12</literal> model.
164 </para>
165 <!-- TODO: The info about MTL is my best guess, the referred Intel
166 page does not contain Meteor Lake GPU PCI devicd ID as at Feb 2024.
167 XeHPC is not enabled by default but they are some data center GPUs.
168 Not sure if anyone will run LFS in a data center. -->
169 </note>
170
171<!--
172 <para>
173 First, fix a few build failures with GCC-13:
174 </para>
175
176 <screen><userinput remap="pre">patch -Np1 -i ../intel-media-&intel-media-version;-upstream_fixes-1.patch</userinput></screen>
177-->
178
179 <para>
180 Install <application>intel-media</application> by running the
181 following commands:
182 </para>
183
184<screen><userinput>mkdir build &amp;&amp;
185cd build &amp;&amp;
186
187cmake -DCMAKE_INSTALL_PREFIX=$XORG_PREFIX \
188 -DINSTALL_DRIVER_SYSCONF=OFF \
189 -DBUILD_TYPE=Release \
190 -G Ninja \
191 -Wno-dev .. &amp;&amp;
192ninja</userinput></screen>
193
194
195 <para>
196 This package does not come with a test suite.
197 </para>
198
199 <para>
200 Now, as the <systemitem class="username">root</systemitem> user:
201 </para>
202
203<screen role="root"><userinput>ninja install</userinput></screen>
204
205 </sect2>
206
207 <!-- As of Oct 1 2023, the build is broken if MTL and ARL are turned on
208 hopefully this is fixed by the time they launch, in which
209 case we can remove the option and this section [rahul] -->
210 <!-- As of October 31st, 2023, the build seems to be functional again! This
211 is with version 23.4.0. [renodr]
212 <sect2 role="commands">
213 <title>Command Explanations</title>
214
215 <para>
216 <parameter>-D{MTL,ARL}=OFF</parameter>: As of October 2023,
217 Meteor Lake and Arrow Lake iGPU support is broken but still
218 in intel-media. The build fails if support for either iGPU
219 is turned on. Since both of these have not been officially
220 released yet, it is safe to turn support for them off.
221 </para>
222
223 </sect2>
224 -->
225
226 <sect2 role="content">
227 <title>Contents</title>
228
229 <segmentedlist>
230 <segtitle>Installed Programs</segtitle>
231 <segtitle>Installed Libraries</segtitle>
232 <segtitle>Installed Drivers</segtitle>
233 <segtitle>Installed Directories</segtitle>
234
235 <seglistitem>
236 <seg>
237 None
238 </seg>
239 <seg>
240 libigfxcmrt.so
241 </seg>
242 <seg>
243 iHD_drv_video.so
244 </seg>
245 <seg>
246 /usr/include/igfxcmrt
247 </seg>
248 </seglistitem>
249 </segmentedlist>
250
251 <variablelist>
252 <bridgehead renderas="sect2">Short Descriptions</bridgehead>
253 <?dbfo list-presentation="list"?>
254 <?dbhtml list-presentation="table"?>
255
256 <varlistentry id="libigfxcmrt">
257 <term><filename class="libraryfile">libigfxcmrt.so</filename></term>
258 <listitem>
259 <para>
260 provides API functions which allow running GPU kernels on the
261 render engine
262 </para>
263 <indexterm zone="intel-media libigfxcmrt">
264 <primary sortas="c-libigfxcmrt">libigfxcmrt.so</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 </variablelist>
270
271 </sect2>
272
273 </sect1>
Note: See TracBrowser for help on using the repository browser.