Video and Vision Processing Suite Intel® FPGA IPユーザーガイド

ID 683329
日付 6/26/2023
Public
ドキュメント目次
1. Video and Vision Processing Suiteについて 2. Video and Vision Processing IPのスタートガイド 3. Video and Vision Processing IPの機能の説明 4. Video and Vision Processing IPインターフェイス 5. Video and Vision Processing IPレジスター 6. Video and Vision Processing IPのソフトウェア・プログラミング・モデル 7. Protocol Converter Intel® FPGA IP 8. 3D LUT Intel® FPGA IP 9. AXI-Stream Broadcaster Intel® FPGA IP 10. Bits per Color Sample Adapter Intel FPGA IP 11. Chroma Key Intel® FPGA IP 12. Chroma Resampler Intel® FPGA IP 13. Clipper Intel® FPGA IP 14. Clocked Video Input Intel® FPGA IP 15. Clocked Video to Full-Raster Converter Intel® FPGA IP 16. Clocked Video Output Intel® FPGA IP 17. Color Space Converter Intel® FPGA IP 18. Deinterlacer Intel® FPGA IP 19. FIR Filter Intel® FPGA IP 20. Frame Cleaner Intel® FPGA IP 21. Full-Raster to Clocked Video Converter Intel® FPGA IP 22. Full-Raster to Streaming Converter Intel® FPGA IP 23. Genlock Controller Intel® FPGA IP 24. Generic Crosspoint Intel® FPGA IP 25. Genlock Signal Router Intel® FPGA IP 26. Guard Bands Intel® FPGA IP 27. Interlacer Intel® FPGA IP 28. Mixer Intel® FPGA IP 29. Parallel Converter Intel® FPGA IPのピクセル 30. Scaler Intel® FPGA IP 31. Stream Cleaner Intel® FPGA IP 32. Switch Intel® FPGA IP 33. Tone Mapping Operator Intel® FPGA IP 34. Test Pattern Generator Intel® FPGA IP 35. Video and Vision Monitor Intel FPGA IP 36. Video Frame Buffer Intel® FPGA IP 37. Video Frame Reader Intel FPGA IP 38. Video Frame Writer Intel FPGA IP 39. Video Streaming FIFO Intel® FPGA IP 40. Video Timing Generator Intel® FPGA IP 41. Warp Intel® FPGA IP 42. デザイン・セキュリティー 43. Video and Vision Processing Suiteユーザーガイドの文書改訂履歴

18.5. Deinterlacer IPのソフトウェアAPI

IPには、ランタイム時にIPをソフトウェア制御するためのソフトウェア・ドライバーが含まれています。このIPは、Nios II HALが提供する汎用デバイスモデルのいずれにも適合しません。これは、一連の専用アクセサーをコントロール・レジスターおよびステータスレジスターに公開します。ドライバー構造は基本ドライバー構造を継承するため、 Video and Vision Processing IPのソフトウェアAPI で説明されているすべての一般的なメソッドを適用できます。

レジスター定義ヘッダーファイル: intel_vvp_dil_regs.h

インクルード・ファイル: intel_vvp_dil.h

表 278.  Deinterlacer IPのソフトウェアAPI
名前 説明
intel_vvp_dil_init Deinterlacerインスタンスを初期化します。
intel_vvp_core_* Video and Vision Processing IPのソフトウェア・プログラミング・モデルで定義されたアクセサー
intel_vvp_dil_get_lite_mode ライトモードがオンであることを返します。
intel_vvp_dil_get_debug_enabled デバッグ機能がオンであることを返します。
Intel_vvp_dil_get_max_width サポートされている最大幅を返します。
intel_vvp_dil_get_dil_algorithm デインターレース・アルゴリズムを返します。
intel_vvp_dil_get_field_sync フィールド同期メソッドを返します。
intel_vvp_dil_get_mem_base_address ベースアドレスを返します (ウィーブ・デインターレース)。
intel_vvp_dil_get_mem_buff_line_stride 行のストライドを返します (ウィーブ・デインターレース)。
intel_vvp_dil_get_bps Bits per sampleの値を返します (ウィーブ・デインターレース)。
intel_vvp_dil_get_num_colors Number of color planesの値を返します (ウィーブ・デインターレース)。
intel_vvp_dil_get_pixels_in_parallel Pixels in parallelの値を返します (ウィーブ・デインターレース)。
intel_vvp_dil_get_mem_packing Memory packingの値を返します (ウィーブ・デインターレース)。
intel_vvp_dil_is_running IPがデータを処理しているかどうかを返します。
intel_vvp_dil_get_status ステータスレジスターを読み出します。

enum eIntelVvpDilAlgorithms

メンバー

kIntelVvpDilBobAlgo (0) - ボブ・デインターレース

kIntelVvpDilWeaveAlgo (1) - ウィーブ・デインターレース

kIntelVvpDilAlgoErr (-1) - 無効なデインターレース・アルゴリズム (エラーを示すために使用)

説明

コンフィグレーション可能なデインターレース・アルゴリズムの列挙

enum eIntelVvpDilMemPacking

メンバー

kIntelVvpDilPerfectPacking (0) - 完全なパッキング

kIntelVvpDilColorPacking (1) - カラーパッキング

kIntelVvpDilPixelPacking (2) - ピクセルパッキング

kIntelVvpDilPackingErr (-1) – 無効な値 (エラーを示すために使用)

説明

コンフィグレーション可能なメモリー・パッキング・アルゴリズムの列挙

enum eIntelVvpDilFieldSyncs

メンバー

kIntelVvpDilDeinterlaceSyncF0 – F0での同期 (入力フレームレート = 出力フレームレート)

kIntelVvpDilDeinterlaceSyncF0 – F1での同期 (入力フレームレート = 出力フレームレート)

kIntelVvpDilDeinterlaceSync Both – F0とF1での同期 (入力フィールドレート = 出力フレームレート)

説明
サポートされている3つのフィールドからフレームへのレート変換の列挙

intel_vvp_dil_init

プロトタイプ
int intel_vvp_dil_init(intel_vvp_dil_instance *instance, intel_vvp_core_base base);
説明
デインターレーサーのインスタンスを初期化します。ベースアドレスで読み出されたベンダーIDまたは製品IDが一致しない場合、またはレジスターマップのバージョンがサポートされていない場合、初期化は早期に停止します。それ以外の場合、関数はIPコンパイル時のパラメーター化の読み出しと格納に進みます。インスタンスは完全に初期化されていないため、ゼロ以外のエラーコードを返した場合、アプリケーションはそれ以上使用しないでください。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

Base – レジスターマップのベースアドレス

戻り値

成功の場合はkIntelVvpCoreOk (0)、エラーの場合は負のエラーコード

コアのベンダーIDがインテルFPGAベンダーID (0x6AF7) ではない場合、kIntelVvpCoreVidErr

product_idがDeinterlacer製品IDと一致しない場合、kIntelVvpCorePidErr

インスタンスがヌルポインターの場合は、kIntelVvpCoreInstanceErr

レジスターマップがサポートされていない場合は、kIntelVvpDilRegMapVersionErr

intel_vvp_dil_get_lite_mode

プロトタイプ
bool intel_vvp_dil_get_lite_mode(intel_vvp_dil_instance *instance);
説明
LITE_MODEレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
IPがライトモードでパラメーター化されている場合は、Trueを返します。

intel_vvp_dil_get_debug_enabled

プロトタイプ
bool intel_vvp_dil_get_debug_enabled(intel_vvp_dil_instance *instance);
説明
DEBUG_ENABLEDレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
IPがデバッグ機能をイネーブルしてパラメーター化されている場合は、Trueを返します。

intel_vvp_dil_get_max_width

プロトタイプ
uint32_t intel_vvp_dil_get_max_widh(intel_vvp_dil_instance *instance);
説明
MAX_WIDTHレジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
最大サポート幅

intel_vvp_dil_get_dil_algorithm

プロトタイプ
eIntelVvpDilAlgorithms_t intel_vvp_dil_get_dil_algorithm(intel_vvp_dil_instance *instance);
説明
デインターレース・アルゴリズム・レジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
コンパイル時に選択されるデインターレース・アルゴリズム

intel_vvp_dil_get_field_sync

プロトタイプ
eIntelVvpDilFieldSyncs intel_vvp_dil_get_field_sync(intel_vvp_dil_instance *instance);
説明
フィールド同期レジスターの値を返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
コンパイル時に選択されるフィールド同期アルゴリズム

intel_vvp_dil_get_mem_base_address

プロトタイプ
uint32_t intel_vvp_dil_get_mem_base_address(intel_vvp_dil_instance *instance);
説明

MEM_BASE_ADDRレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

メモリー内のストレージバッファーのベースアドレス

intel_vvp_dil_get_mem_buff_line_stride

プロトタイプ
uint32_t intel_vvp_dil_get_mem_buff_line_stride(intel_vvp_dil_instance *instance);
説明

MEM_BUFF_LINE_STRIDEレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

ストレージバッファーで使用される行のストライド

intel_vvp_dil_get_bps

プロトタイプ
uint8_t intel_vvp_dil_get_bps(intel_vvp_dil_instance *instance);
説明

BITS_PER_SAMPLEレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

カラーサンプルごとのビット数

intel_vvp_dil_get_num_colors

プロトタイプ
uint8_t intel_vvp_dil_get_num_colors(intel_vvp_dil_instance *instance);
説明

NUM_COLOR_PLANESレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

ピクセルあたりのカラープレーンの数

intel_vvp_dil_get_pixels_in_parallel

プロトタイプ
uint8_t intel_vvp_dil_get_pixels_in_parallel(intel_vvp_dil_instance *instance);
説明

PIXELS_IN_PARALLELレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

ビートごとに並行してストリーミングされるピクセルの数

intel_vvp_dil_get_mem_packing

プロトタイプ
eIntelVvpDilMemPacking intel_vvp_dil_get_mem_packing(intel_vvp_dil_instance *instance);
説明

MEM_PACKINGレジスターの値を返します。インスタンスは、完全に初期化され、ウィーブ・デインターレース用にコンフィグレーションされた有効なintel_vvp_dil_instanceである必要があります。

引数

インスタンス - intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター

戻り値

フィールドをメモリーに格納するために使用されるメモリーパッキング方法

intel_vvp_dil_is_running

プロトタイプ
bool intel_vvp_ dil _is_running(intel_vvp_dil_instance* instance);
説明
STATUSレジスターの実行ビットを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
IPが現在出力フィールドを生成している場合はTrue、2つのフィールドの間にある場合はFalse

intel_vvp_dil_get_status

プロトタイプ
uint8_t intel_vvp_dil_get_status(intel_vvp_dil_instance* instance);
説明
STATUSレジスターを読み出して返します。インスタンスは、完全に初期化された有効なintel_vvp_dil_instanceである必要があります。
引数
インスタンス – intel_vvp_dil_instanceソフトウェア・ドライバー・インスタンス構造体へのポインター
戻り値
ステータスレジスターから読み出された値