media driver

VaapiのIntel（R）メディアドライバー

導入

VAAPIのIntel（R）メディアドライバーは、GENベースのグラフィックスハードウェアのデコード、エンコード、およびビデオ後処理をサポートする新しいVA-API（ビデオアクセラレーションAPI）ユーザーモードドライバーです。

ライセンス

VAAPIのIntel（R）メディアドライバーは、MITライセンスの下で、BSD 3条項の「新しい」または「改訂」ライセンスの一部をカバーして配布されます。 MIT＆BSD-3-Clauseでライセンスのコピーを入手できます

建物

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.SOの場合は、関連するLIBVA環境変数をエクスポートしてください。

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

サポートされているプラ​​ットフォーム

• BDW（ブロードウェル）
• 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（アイスレイク）
• JSL（ジャスパー湖） / EHL（エルクハート湖）
• TGLX（TGL：Tiger Lake、RKL：Rocket Lake、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（バトルメイジ）

コンポーネントと機能

メディアドライバーには、以下に3つのコンポーネントが含まれています

• ビデオデコードは、ハードウェアベースのデコーダー（VDBOX）を呼び出します。これは、他の操作用にグラフィックエンジンをリリースするために完全にアクセラル化されたハードウェアビデオデコードを提供します。
• ビデオエンコーディングは2つのモードをサポートします。1つはハードウェアベースのエンコーダー（VDENC/HUC）を呼び出して低電力エンコードを提供します。もう1つはハードウェア（PAK）+シェーダー（メディアカーネル+VME）ベースのエンコードです。ユーザーはVA-APIを介してモードを選択できます。
• ビデオ処理は、ハードウェアベースのビデオプロセッサ（VEBOX/SFC）とシェーダー（メディアカーネル）ベースのソリューションによるいくつかの一般的な機能をサポートしています。

メディアドライバーは、2つのビルドを下回っています

• フル機能ビルドはデフォルトのドライバービルドであり、ハードウェアアクセラレータとクローズソースシェーダー（メディアカーネルバイナリ）によるすべての機能をサポートします。ほとんどのOSV（Rhel/Suse/Fedoraなど）はこのビルドを使用しています。
• 無料のカーネルビルド、完全にオープンソースシェーダー（メディアカーネル）とハードウェア機能を有効にしますが、機能は制限されます。

Ubuntu/Debian OSVについて、Intel-Media-Va-Driver-Non-Free（フル機能ビルド）とIntel-Media-Va-Driver（Free Kernel Build）2つのパッケージを提供します。ここでは無料はオープンソースカーネルを意味しますが、料金の支払いの必要性とは関係ありません。詳細については、ビルドオプションを参照できます。

これら2つのビルドでメディアコンポーネント機能を共有する大きなテーブルがあることを楽しみにしている場合、テーブルの下には情報の適切な紹介があります。

デコード/エンコード機能

コーデック	ビルドタイプ	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 8ビット	フル機能 フリーカーネル	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 8ビット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 8ビット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 10ビット	フル機能 フリーカーネル	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 10ビット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 10ビット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 12ビット	フル機能 フリーカーネル	d d	d d	d d	d d	d/es d	d/es d
HEVC 12ビット422	フル機能 フリーカーネル	d d	d d	d d	d d	d d	d d
HEVC 12ビット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 8ビット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 10ビット	フル機能 フリーカーネル	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 10ビット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 12ビット	フル機能 フリーカーネル	d d	d d	d d	d d	d d	d d
VP9 12ビット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 10ビット	フル機能 フリーカーネル	D/e D/e	D/e D/e	D/e D/e	D/e e	d	d
VVC 8ビット	フル機能 フリーカーネル		d d
VVC 10ビット	フル機能 フリーカーネル		d d

• * VP8デコードは、TGLプラットフォームでのみサポートされています
• D-ハードウェアデコード
• e-ハードウェアエンコーディング、低電力エンコーディング（vdenc/huc）
• ES -Hardware（PAK） + Shader（Media Kernel + VME）エンコーディング

注：低電力エンコーディング（vaentrypointencslicelp）およびシェーダーエンコード（vaentrypointencslice）は、 MTLプラットフォームから統合インターフェイス（vaentrypointencslice）に統合されます。顧客にGPUリソ​​ースを解き放つために、HWアクセラレーションのためにVDENC/HUCを通過します。

詳細なデコードとエンコード機能情報については、参照してください

• メディア機能の要約
  • サポートされているデコード出力形式と最大解像度
  • サポートされているエンコード入力形式と最大解像度

ビデオ処理機能

コーデック	ビルドタイプ	BMG	LNL	mtlx	DG2/ATSM	DG1/SG1	tglx	EHL/JSL	ICL	KBLX	bxtx	SKL	bdw
ブレンド	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
CSC	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
interlace	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい* はい*	はい はい	はい	はい	はい	はい
デノイズ	フル機能 フリーカーネル	はい	はい	はい	はい	はい	はい		はい	はい	はい	はい	はい
ルーマキー	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
ミラーリング	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
Procamp	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
回転	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
スケーリング	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
シャープニング	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
std/e	フル機能 フリーカーネル	はい	はい	はい	はい	はい	はい		はい	はい	はい	はい	はい
TCC	フル機能 フリーカーネル	はい	はい	はい	はい	はい	はい		はい	はい	はい	はい	はい
カラーフィル	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい	はい
クロマの座り	フル機能 フリーカーネル	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい はい	はい	はい	はい
HDR10 TM	フル機能 フリーカーネル	はい	はい	はい	はい	はい	はい		はい
3dlut	フル機能 フリーカーネル	はい	はい	はい	はい	はい	はい

• * EHL/JSLはBob Diのみをサポートしています
• CSC：カラースペース変換
• Procamp：明るさ、コントラスト、色相、飽和
• STD/E：スキントーン検出と強化
• TCC：合計色制御
• HDR10 TM：HDR10トーンマッピング
• 3dlut：3次元検索テーブル

その他の機能情報については、サポートされているビデオ処理CSC/スケーリング形式を参照してください

オプションを構築します

メディアドライバーは、以下に説明するように、さまざまなビルドタイプをサポートしています。次の設定を参照して、それらを有効にすることができます。

• 完全な機能ビルド：enable_kernels = on（default）enable_nonfree_kernels = on（default）
• 無料カーネルビルド：enable_kernels = on enable_nonfree_kernels = off
  • 事前に構築されたオープンソースカーネルバイナリを使用しようとしている場合は、build_kernels = off（default）を追加してください。
  • ソースコードからオープンソースカーネルを再構築しようとしている場合は、build_kernels = onを追加してください。

Media-Driverは、I915 KMDの上流バージョンが完全にサポートしていないため、次のプラットフォームをサポートするために特別なI915カーネルモードドライバー（KMD）バージョンを必要とします（上流にはパッチが保留されます）。これらのプラットフォームを有効にするには、 ENABLE_PRODUCTION_KMD=ON （default： OFF ）構成オプションを指定する必要があります。

• DG1/SG1
• ATSM

既知の問題と制限

1. VAAPIのIntel（R）メディアドライバーは、C ++ 11を正式にサポートするGCCコンパイラv6.1以降に対して構築することをお勧めします。

2. HUCファームウェアは、CBR、VBRなどを含むAVC/HEVC/VP9/AV1低電力エンコードビットレートコントロールに必要です。デフォルトのカーネル構成では、TGL/RKLおよびレガシープラットフォームのHUCロードを有効にしませんでしたが、ADL+プラットフォームから有効になりました。 "options i915 enable_guc=2" > /etc/modprobe.d/i915.confの下の「オプションi915 enable_guc = 2」で変更することができます。 ADL+プラットフォームの場合、Cernelは/lib/firware/i915に関連するプラットフォームHUCバイナリが存在する場合、デフォルトとしてHUCをロードします。さまざまなプラットフォームで利用可能なHUCファームウェアは次のとおりです。

   • APL/KBL：カーネル4.11から始まると、hucロードはデフォルトとして無効になるため、 i915.enable_guc=2を設定します
   • CFL：カーネル4.15から始めて、hucロードはデフォルトとして無効になるため、 i915.enable_guc=2設定します
   • ICL：Kernel 5.2から開始して、HUCの負荷はデフォルトとして無効になるため、 i915.enable_guc=2を設定します
   • EHL/JSL：Kernel 5.8から始まると、HUCの負荷はデフォルトとして無効になるため、 i915.enable_guc=2を設定します
   • TGL：Kernel 5.9から開始すると、HUCの負荷はデフォルトとして無効になるため、 i915.enable_guc=2を設定します
   • RKL：Kernel 5.17から開始すると、HUCの読み込みはデフォルトとして無効になるため、 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バックポート
   • 錬金術師（DG2）：カーネル6.2から始まります
   • ATSM：Intel-GPU/Intel-GPU-I915-Backports
   • MTL/ARL：カーネル6.8から始まります
   • LNL：Intel/Xe-Kernel

3. その他の既知の問題は、Media-Driver/Wikiの「既知の問題」ページを参照してください。

（*）他の名前とブランドは、他の名前の財産として主張される場合があります。