クラスベースカーネル

クラスベースカーネル - 2023.2 日本語

Vitis Model Composer ユーザーガイド (UG1483)

Document ID

UG1483

Release Date

2023-11-15

Version

2023.2 日本語

Vitis Model Composer では、パラメーター値を指定するためのコンストラクターパラメーターを含む C++ カーネルクラスをインポートできます。次に示すように、AI エンジンライブラリから AIE Class Kernel ブロックを使用する必要があります。

図 1. AIE Class Kernel

ブロックをダブルクリックすると、次の図に示すように、AI エンジンクラスカーネルブロックのパラメーターが表示されます。

図 2. AIE Class Kernel ブロックの [Block Parameters] ダイアログボックス

カーネル関数をブロックとしてインポートするには、ブロックマスクパラメーターをアップデートする必要があります。次の表に、各パラメーターの説明を示します。

表 1. AIE Class Kernel ブロックのパラメーター
パラメーター名	パラメーターのデータ型	必要性	説明
Kernel header file	文字列	必須	カーネルクラスおよび registerKernelClass メソッド宣言を含むヘッダーファイルの名前。ファイル名のみ、ファイルへの相対パス、またはファイルへの絶対パスを指定できます。参照ボタンをクリックしてファイルを選択します。このフィールドには、環境変数は指定できません。
Kernel class	文字列	必須	メンバー変数およびカーネルメンバー関数を含むカーネルクラスの名前。
Kernel function	文字列	必須	ブロックを作成するカーネルメンバー関数の名前。この関数は、カーネルヘッダーファイルで registerKernelClass メソッドを使用して登録されている必要があります。
Kernel source file	文字列	必須	カーネルメンバー関数定義およびデフォルト以外のコンストラクターパラメーター値の指定を含むソースファイルの名前。ファイル名のみ、ファイルへの相対パス、またはファイルへの絶対パスを指定できます。ファイル名、ファイルへの相対パス、またはファイルへの絶対パスを指定できます。このフィールドには、環境変数は指定できません。
Kernel search paths	文字列のベクター	オプション	Kernel header file または Kernel source file に指定された値を使用してカーネルヘッダーファイルまたはカーネルソースファイルが見つからない場合は、Kernel search paths に指定されているパスでファイルが検索されます。このパラメーターを使用すると、カーネルヘッダーファイルおよびカーネルソースファイルへのパスを指定すると同時に、環境変数を使用できます。環境変数は、`${ENV}` または `$ENV` 形式で指定できます。
Preprocessor options		オプション	ダウンストリームのコンパイルを特定のプリプロセッサオプションを使用して実行する場合にプリプロセッサ引数を指定します。使用可能な形式は `-D<name>` および `-D<name>=<definition>` で、コンマで区切って複数指定できます。引数は `-D` で開始する必要があり、`<definition>` が指定されていない場合は `1` と想定されます。

AIE Class Kernel ブロックでは、通常の AI エンジンカーネルブロックがサポートできるすべてのカーネル機能をサポートしており、AI エンジンクラスのカーネルブロックをダブルクリックして表示される Block Parameters ダイアログボックスは、カーネルメンバー関数がウィンドウベースかストリームベースかに関係なく同じです。ヘッダーファイルまたはソースファイルを編集するには、参照ボタンの横にある Edit ボタンをクリックします。