ウィンドウ ベース カーネルのインポート - 2022.1 日本語

たとえば、ウィンドウ ベースのインターフェイスを含む単純なカーネルをインポートする場合、次の simple.h ヘッダー ファイルに示すように、int16 型の 2 つの入力ウィンドウと 1 つの出力ウィンドウを含む add_kernel 関数を定義します。

Simple.h

#ifndef __ADD_KERNEL_H__
#define __ADD_KERNEL_H__
 
#include <adf.h>
#define NUM_SAMPLES 4
void add_kernel(input_window_int16 * in1,input_window_int16 * in2, output_window_int16 * outw);
 
#endif

このカーネル (simple.cc) は、次のように定義されます。in1 および in2 の sum 演算を処理し、outw に出力を生成します。

#include "simple.h"
void add_kernel(input_window_int16 * in1,input_window_int16 * in2, output_window_int16 * outw)
{
    int16 temp1,temp2,temp_out;
    for (unsigned i=0; i<NUM_SAMPLES; i++) {
        window_readincr(in1,temp1);
        window_readincr(in2,temp2);
        temp_out = temp1 + temp2;
        window_writeincr(outw,temp_out);
    }
}

Block Parameters ダイアログ ボックスで Import をクリックすると、ツールによりヘッダー ファイルの関数シグネチャが解析され、AI エンジン カーネルのインターフェイスが次の図に示すようにアップデートされます。

図 1. アップデート後の AIE Kernel ブロック

AIE Kernel ブロックを Simulink エディターに追加した後には、入力ポートと出力ポートは存在しません。Block Parameters ダイアログ ボックスでカーネル パラメーターを追加すると、ブロックが 2 つの入力ポートと 1 つの出力ポートでアップデートされ、インポートされたカーネル関数に一致するブロック名が付けられます。

正しくインポートされると、Function タブにユーザーが編集可能なパラメーターが表示されます。インポートされたカーネル関数の関数定義と、ポート名および方向をすばやく確認できます。

図 2. Function タブ

Function タブの Window size と Window margin に適切な値入力する必要があります。

ウィンドウ マージン値の設定

データ アクセスのメカニズム で説明したように、ウィンドウ マージンは入力データ サンプルのオーバーラップです。Model Composer では、Window margin 値はサンプル数で指定します。Window margin に入力する値は、32 バイトの倍数である必要があります。

たとえば、入力のデータ型が int16 (2 バイト) に場合、Window margin の指定可能な最小値は 16 サンプル (16 × 2) で、ほかに 32、48、64 などの値を指定できます。

別の例として、入力のデータ型が cint32 (8 バイト: 実数部 4 バイト、仮想部 4 バイト) である場合、指定可能な最小ウィンドウ マージンは 4 です。これは、4 × 8 バイトは 32 バイトだからです。ほかに 8、12、16 などの値を指定できます。

次の表に、各パラメーターの説明を示します。

カーネル関数が正常にインポートされると、General タブ Import ボタンが Update に変わり、ブロック パラメーターをアップデートできるようになります。ブロックをインポートした後、再インポートせずにカーネル関数のソース コードを変更できます。ただし、関数シグネチャまたは関数へのパラメーターを変更した場合は、General タブの Update ボタンをクリックする必要があります。

図 3. General タブ