media driver

VAAPI的英特尔（R）媒体驱动程序

介绍

VAAPI的Intel（R）媒体驱动程序是一种新的VA-API（视频加速API）用户模式驱动程序，支持硬件加速，编码和视频帖子处理，用于基于GEN的图形硬件。

执照

VAAPI的Intel（R）媒体驱动程序是根据MIT许可证分发的，其部分为BSD 3-CARESS“ NEW”或“修订”许可证。您可以在MIT＆BSD-3-CAREE中获得许可证的副本

建筑

对于Ubuntu 16.04+

 apt install autoconf libtool libdrm-dev xorg xorg-dev openbox libx11-dev libgl1-mesa-glx

其他分布的等效物应该有效。

1. 构建和安装libva
2. 构建和安装gmmlib遵循gmmlib兼容性
3. 获取媒体存储库并将工作区文件夹格式化如下（建议工作区是媒体驱动程序构建的专用一个）：

    <workspace>
       |- media-driver
   

4. 在工作区下创建build_media新文件夹

    $ mkdir <workspace>/build_media
   

   然后工作区看起来如下

    <workspace>
       |- media-driver
       |- build_media
   

5.  $ cd <workspace>/build_media
   

6.  $ cmake ../media-driver
   

7.  $ make -j"$(nproc)"
   

安装

 $ sudo make install

这将安装以下文件（例如在Ubuntu上）：

 -- Installing: /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
-- Installing: /etc/profile.d/intel-media.sh
-- Installing: /usr/lib/x86_64-linux-gnu/igfxcmrt64.so

对于IHD_DRV_VIDEO。因此，请导出相关的Libva环境变量。

 export LIBVA_DRIVERS_PATH=<path-contains-iHD_drv_video.so>
export LIBVA_DRIVER_NAME=iHD

支持的平台

• BDW（Broadwell）
• SKL（Skylake）
• BXTX（BXT：Broxton，APL：Apollo Lake，GLK：双子座湖）
• KBLX（KBL：卡比湖，CFL：咖啡湖，WHL：威士忌湖，CML：AML彗星湖：琥珀湖）
• ICL（冰湖）
• JSL（Jasper Lake） / EHL（Elkhart Lake）
• TGLX（TGL：Tiger Lake，RKL：火箭湖，ADL-S/P/N：Alder Lake，RPL-S/P：Raptor Lake）
• DG1/SG1
• 炼金术士（DG2）/ATSM
• MTLX（MTL：Meteor Lake，ARL-S/H：Arrow Lake）
• LNL（月球湖）
• BMG（战斗）

组件和功能

媒体驱动程序包含三个组件如下

• 视频解码调用基于硬件的解码器（VDBOX），它提供了完全加速的硬件视频解码，以释放用于其他操作的图形引擎。
• 视频编码支持两种模式，一种调用基于硬件的编码器（VDENC/HUC）提供低功率编码，另一个是基于硬件（PAK）+Shader（媒体内核+VME）的编码。用户可以通过VA-API选择模式。
• 视频处理支持基于硬件的视频处理器（VEBOX/SFC）和下色器（媒体​​内核）解决方案的几个流行功能。

媒体驱动程序支持以下两个版本

• 完整功能构建是默认驱动程序构建，它支持硬件加速器和密闭源着色器（媒体​​内核二进制文件）的所有功能。大多数OSV（例如Rhel/Suse/Fedora）都使用此构建。
• 免费的内核构建，启用完全开源的着色器（媒体​​内核）和硬件功能，但功能将受到限制。

关于Ubuntu/Debian OSV，他们提供了Intel-Media-Va-driver-Non-Fime（完整功能构建）和Intel-Media-Va-Driver（免费内核构建）两个软件包。免费这里意味着开源内核，但与需要支付的费用无关。您可以参考构建选项以获取更多详细信息。

如果您期待在这两个构建中共享媒体组件功能，那么下面的桌子是您的信息的良好推荐烯。

解码/编码功能

编解码器	构建类型	BMG	lnl	mtlx	DG2/ATSM	DG1/SG1	TGLX	EHL/JSL	ICL	kblx	bxtx	SKL	BDW
AVC	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E/ES D/E。	D/E/ES D/E。	D/E。 D/E。	D/E/ES D/E。	D/E/ES D/E。	D/E/ES D/E。	D/E/ES D/E。	d/es d
MPEG-2	全力 自由主义者	d d	d d	d d	d d	d/es d	d/es d	d d	d/es d	d/es d	d d	d/es d	d/es d
VC-1	全力 自由主义者					d	d	d	d	d	d	d	d
jpeg	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	d d
VP8	全力 自由主义者	d d	d d	d d			D* D*	d d	d/es d	d/es d	d d	d d	d d
HEVC 8bit	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E/ES D/E。	D/E/ES D/E。	D/E。 D/E。	D/E/ES D/E。	d/es d	d/es d	d/es d
HEVC 8bit 422	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	d d	D/E。 D/E。	d/es d	d/es d	d d	d/es d
HEVC 8bit 444	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。
HEVC 10bit	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E/ES D/E。	D/E/ES D/E。	D/E。 D/E。	D/E/ES D/E。	d/es d	d d
HEVC 10bit 422	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	d d	D/E。 D/E。	d/es d	d/es d	d d	d/es d
HEVC 10bit 444	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。
HEVC 12bit	全力 自由主义者	d d	d d	d d	d d	d/es d	d/es d
HEVC 12bit 422	全力 自由主义者	d d	d d	d d	d d	d d	d d
HEVC 12bit 444	全力 自由主义者	d d	d d	d d	d d	d d	d d
VP9 8位	全力 自由主义者	d d	d d	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	d d	d d
VP9 8bit 444	全力 自由主义者	d d	d d	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。
VP9 10bit	全力 自由主义者	d d	d d	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	d d
VP9 10bit 444	全力 自由主义者	d d	d d	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。
VP9 12bit	全力 自由主义者	d d	d d	d d	d d	d d	d d
VP9 12bit 444	全力 自由主义者	d d	d d	d d	d d	d d	d d
AV1 8位	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 e	d	d
AV1 10bit	全力 自由主义者	D/E。 D/E。	D/E。 D/E。	D/E。 D/E。	D/E。 e	d	d
VVC 8位	全力 自由主义者		d d
VVC 10bit	全力 自由主义者		d d

• * VP8解码仅在TGL平台上支持
• D-硬件解码
• E-硬件编码，低功率编码（VDENC/HUC）
• ES-硬件（PAK） +着色器（媒体​​内核 + VME）编码

注意：从MTL平台将低功率编码（VaentrypointSliceLP）和着色器编码（VaentryPointencSlice）合并到Unified接口（Vaentrypointencslice）。它通过VDENC/HUC进行HW加速，向客户释放GPU资源。

有关更多解码和编码功能信息，请参考

• 媒体功能摘要
  • 支持的解码输出格式和最大分辨率
  • 支持的编码输入格式和最大分辨率

视频处理功能

编解码器	构建类型	BMG	lnl	mtlx	DG2/ATSM	DG1/SG1	TGLX	EHL/JSL	ICL	kblx	bxtx	SKL	BDW
混合	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
CSC	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
De Interlace	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的* 是的*	是的 是的	是的	是的	是的	是的
De-noise	全力 自由主义者	是的	是的	是的	是的	是的	是的		是的	是的	是的	是的	是的
Luma键	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
镜像	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
Procamp	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
旋转	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
缩放	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
锐化	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
std/e	全力 自由主义者	是的	是的	是的	是的	是的	是的		是的	是的	是的	是的	是的
TCC	全力 自由主义者	是的	是的	是的	是的	是的	是的		是的	是的	是的	是的	是的
颜色填充	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的	是的
色度选址	全力 自由主义者	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的 是的	是的	是的	是的
HDR10 TM	全力 自由主义者	是的	是的	是的	是的	是的	是的		是的
3dlut	全力 自由主义者	是的	是的	是的	是的	是的	是的

• * EHL/JSL仅支持Bob DI
• CSC：颜色空间转换
• Procamp：亮度，对比度，色调，饱和度
• STD/E：肤色检测和增强
• TCC：总颜色控制
• HDR10 TM：HDR10音调映射
• 3DLUT：三维查找表

有关更多功能信息，请参阅支持的视频处理CSC/缩放格式

构建选项

如下所述，媒体驱动器支持不同的构建类型。您可以参考以下设置以启用它们。

• 完整功能构建：enable_kernels = on（默认）enable_nonfree_kernels = on（默认）
• 免费内核构建：enable_kernels = on enable_nonfree_kernels = OFF
  • 如果尝试使用预构建的开源内核二进制文件，请添加build_kernels = off（默认）。
  • 如果尝试从源代码重建开源内核，请添加build_kernels = on。

媒体驱动器需要特殊的i915内核模式驱动程序（KMD）版本来支持以下平台，因为i915 kmd的上游版本不完全支持它们（上游待定补丁）。要启用这些平台，它需要指定ENABLE_PRODUCTION_KMD=ON （默认： OFF ）构建配置选项。

• DG1/SG1
• ATSM

已知问题和限制

1. 建议使用VAAPI的Intel（R）媒体驱动程序针对GCC编译器v6.1或更高版本建造，该媒体驱动程序正式支持C ++ 11。

2. HUC固件对于AVC/HEVC/VP9/AV1低功率编码比特率控件（包括CBR，VBR等）都是必需的。默认的内核配置并未启用TGL/RKL和Legacy平台的HUC加载，但可以从ADL+平台启用它。您可以使用"options i915 enable_guc=2" > /etc/modprobe.d/i915.conf更改HUC设置。对于ADL+平台，如果相关平台HUC HUC二进制存在于/lib/firware/i915中，则内核将HUC默认为默认值。在不同平台上可用的HUC Firmwares是：

   • APL/KBL：从内核4.11开始，HUC加载被禁用为默认值，因此设置i915.enable_guc=2
   • CFL：从内核4.15开始，HUC加载被禁用为默认值，因此设置i915.enable_guc=2
   • ICL：从内核5.2开始，HUC加载被禁用为默认值，因此设置i915.enable_guc=2
   • EHL/JSL：从内核5.8开始，HUC加载被禁用为默认值，因此设置i915.enable_guc=2
   • TGL：从内核5.9开始，HUC加载被禁用为默认值，因此设置i915.enable_guc=2
   • RKL：从内核5.17开始，H​​UC加载被禁用为默认值，因此设置i915.enable_guc=2
   • ADL-S/ADL-P：从内核5.17开始
   • ADL-N/RPL-S/RPL-P：从内核6.2开始
   • DG1/SG1：Intel-GPU/Intel-GPU-I915-Backports
   • 炼金术士（DG2）：从内核6.2开始
   • ATSM：Intel-GPU/Intel-GPU-I915-Backports
   • MTL/ARL：从内核6.8开始
   • LNL：Intel/Xe-Kernel

3. 其他更已知的问题，请参阅媒体驱动程序/Wiki“已知问题”页面。

（*）其他名称和品牌可能被称为他人的财产。