media-driver

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):
   复制

   
       |- media-driver

4. Create build_media new folder under your workspace
   复制

   $ mkdir /build_media

   then the workspace looks like below
   复制

   
       |- media-driver
       |- build_media

5. 复制

   $ cd /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=
export LIBVA_DRIVER_NAME=iHD

Supported Platforms

• BDW (Broadwell)
• SKL (Skylake)
• BXTx (BXT: Broxton, APL: Apollo Lake, GLK: Gemini Lake)
• KBLx (KBL: Kaby Lake, CFL: Coffee Lake, WHL: Whiskey Lake, CML: Comet Lake, AML: Amber Lake)
• ICL (Ice Lake)
• JSL (Jasper Lake) / EHL (Elkhart Lake)
• TGLx (TGL: Tiger Lake, RKL: Rocket Lake, ADL-S/P/N: Alder Lake, RPL-S/P: Raptor Lake)
• DG1/SG1
• Alchemist(DG2)/ATSM
• MTLx (MTL: Meteor Lake, ARL-S/H: Arrow Lake)
• LNL (Lunar Lake)
• BMG (Battlemage)
• PTL (Pather Lake)
• NVL (Nova Lake)

Components and Features

Media driver contains three components as below

• Video decoding calls hardware-based decoder(VDBox) which provides fully-accelerated hardware video decoding to release the graphics engine for other operations.
• Video encoding supports two modes, one calls hardware-based encoder(VDEnc/Huc) to provide low power encoding, another one is hardware(PAK)+shader(media kernel+VME) based encoding. User could choose the mode through VA-API.
• Video processing supports several popular features by hardware-based video processor(VEBox/SFC) and shader(media kernel) based solution together.

Media driver supports below two builds

• Full Feature Build is default driver build, which supports all feature by hardware accelerator and close source shaders(media kernel binaries). Most of OSVs(like RHEL/SUSE/fedora) are using this build.
• Free Kernel Build, enables fully open source shaders(media kernels) and hardware features but the features would be limited.

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

• * VP8 decoding is only supported on TGL platform
• D - Hardware Decoding
• E - Hardware Encoding, Low Power Encoding(VDEnc/Huc)
• Es - Hardware(PAK) + Shader(media kernel+VME) Encoding

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

• Media Features Summary
  • Supported Decoding Output Format and Max Resolution
  • Supported Encoding Input Format and Max Resolution

Video Processing Features