Home

Awesome

Intel(R) Media Driver for VAAPI

Introduction

The Intel(R) Media Driver for VAAPI is a new VA-API (Video Acceleration API) user mode driver supporting hardware accelerated decoding, encoding, and video post processing for GEN based graphics hardware.

License

The Intel(R) Media Driver for VAAPI is distributed under the MIT license with portions covered under the BSD 3-clause "New" or "Revised" License. You may obtain a copy of the License at MIT & BSD-3-Clause

Building

For Ubuntu 16.04+

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

Equivalents for other distributions should work.

  1. Build and install LibVA
  2. Build and install GmmLib following GmmLib compatibility
  3. Get media repo and format the workspace folder as below (suggest the workspace to be a dedicated one for media driver build):
    <workspace>
        |- media-driver
    
  4. Create build_media new folder under your workspace
    $ mkdir <workspace>/build_media
    
    then the workspace looks like below
    <workspace>
        |- media-driver
        |- build_media
    
  5. $ cd <workspace>/build_media
    
  6. $ cmake ../media-driver
    
  7. $ make -j"$(nproc)"
    

Install

$ sudo make install

This will install the following files (e.g. on 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

For iHD_drv_video.so please export related LIBVA environment variables.

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

Supported Platforms

Components and Features

Media driver contains three components as below

Media driver supports below two builds

About Ubuntu/Debian OSV, they provide intel-media-va-driver-non-free (Full feature build) and intel-media-va-driver (Free kernel build) two packages. Free here means open source kernel but not related to fee need to pay. You could refer to build options for more detail.

If you are looking forward to have a big table to share media component features on these two builds, below tables are good referene for your information.

Decoding/Encoding Features

CODECBuild TypesBMGLNLMTLxDG2/ATSMDG1/SG1TGLxEHL/JSLICLKBLxBXTxSKLBDW
AVC<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/Es</u><br><i>D<i>
MPEG-2<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i>
VC-1<u>Full-Feature</u><br><i>Free-Kernel</i><u> </u><br><i> <i><u> </u><br><i> <i><u> </u><br><i> <i><u> </u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i><u>D</u><br><i> <i>
JPEG<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D</u><br><i>D<i>
VP8<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u> </u><br><i> <i><u> </u><br><i> <i><u>D*</u><br><i>D*<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
HEVC 8bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i>
HEVC 8bit 422<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i>
HEVC 8bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i>
HEVC 10bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E/Es</u><br><i>D/E<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i>
HEVC 10bit 422<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i>
HEVC 10bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i>
HEVC 12bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/Es</u><br><i>D<i><u>D/Es</u><br><i>D<i>
HEVC 12bit 422<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
HEVC 12bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
VP9 8bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
VP9 8bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i>
VP9 10bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D</u><br><i>D<i>
VP9 10bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i>
VP9 12bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
VP9 12bit 444<u>Full-Feature</u><br><i>Free-Kernel</i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i><u>D</u><br><i>D<i>
AV1 8bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>E<i><u>D</u><br><i> <i><u>D</u><br><i> <i>
AV1 10bit<u>Full-Feature</u><br><i>Free-Kernel</i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>D/E<i><u>D/E</u><br><i>E<i><u>D</u><br><i> <i><u>D</u><br><i> <i>
VVC 8bit<u>Full-Feature</u><br><i>Free-Kernel</i><u> </u><br><i> <i><u>D</u><br><i>D<i>
VVC 10bit<u>Full-Feature</u><br><i>Free-Kernel</i><u> </u><br><i> <i><u>D</u><br><i>D<i>

Note: Low Power Encoding(VAEntrypointEncSliceLP) and Shader Encoding(VAEntrypointEncSlice) are consolidated to the unified interface(VAEntrypointEncSlice) from MTL platform. It goes through VDEnc/Huc for HW acceleration to unleash GPU resource to customers.

For more decoding and encoding features information, please refer to

Video Processing Features

CODECBuild TypesBMGLNLMTLxDG2/ATSMDG1/SG1TGLxEHL/JSLICLKBLxBXTxSKLBDW
Blending<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
CSC<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
De-interlace<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes*</u><br><i>Yes*</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
De-noise<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Luma Key<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Mirroring<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
ProcAmp<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Rotation<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Scaling<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Sharpening<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
STD/E<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
TCC<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Color fill<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i>
Chroma Siting<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i>Yes</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i>
HDR10 TM<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i><u>Yes</u><br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i>
3DLUT<u>Full-Feature</u><br><i>Free-Kernel</i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i><u>Yes</u><br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i> <br><i> </i>

For more feature information, please refer to Supported video processing csc/scaling format

Build Options

Media-driver supports different build types as described below. You could refer to the following settings to enable them.

Media-driver requires special i915 kernel mode driver (KMD) version to support the following platforms since upstream version of i915 KMD does not fully support them(pending patches upstream). To enable these platforms, it requires to specify ENABLE_PRODUCTION_KMD=ON (default: OFF) build configuration option.

Known Issues and Limitations

  1. Intel(R) Media Driver for VAAPI is recommended to be built against gcc compiler v6.1 or later, which officially supported C++11.

  2. HuC firmware is necessary for AVC/HEVC/VP9/AV1 low power encoding bitrate control, including CBR, VBR, etc. The default kernel configuration didn't enable HuC loading for TGL/RKL and legacy platforms but enabled it from ADL+ platforms. You could change the HuC setting with "options i915 enable_guc=2" > /etc/modprobe.d/i915.conf under root. For ADL+ platforms, the kernel loads HuC as default if the related platform HuC binary exists in /lib/firware/i915. The HuC firmwares available on different platforms are:

    • APL/KBL: starting from kernel 4.11, HuC loading is disabled as default, so set i915.enable_guc=2
    • CFL: starting from kernel 4.15, HuC loading is disabled as default, so set i915.enable_guc=2
    • ICL: starting from kernel 5.2, HuC loading is disabled as default, so set i915.enable_guc=2
    • EHL/JSL: starting from kernel 5.8, HuC loading is disabled as default, so set i915.enable_guc=2
    • TGL: starting from kernel 5.9, HuC loading is disabled as default, so set i915.enable_guc=2
    • RKL: starting from kernel 5.17, HuC loading is disabled as default, so set i915.enable_guc=2
    • ADL-S/ADL-P: starting from kernel 5.17
    • ADL-N/RPL-S/RPL-P: starting from kernel 6.2
    • DG1/SG1: intel-gpu/intel-gpu-i915-backports
    • Alchemist(DG2): starting from kernel 6.2
    • ATSM: intel-gpu/intel-gpu-i915-backports
    • MTL/ARL: starting from kernel 6.8
    • LNL: intel/xe-kernel
  3. Other more known issues, please refer to media-driver/wiki "Known Issues" pages.

(*) Other names and brands may be claimed as property of others.