syn.directive.performance - 2025.2 日本語 - UG1399

説明

syn.directive.performance を使うと、target_ti や target_tl といった高レベルの制約を指定できます。この指示子では、ループの連続開始間のクロック サイクル数を定義できます。さらに、ツールが目的を達成するために、UNROLL、PIPELINE、ARRAY_PARTITION、INLINE といった低レベルの指示子を自動的に推論します。syn.directive.performance を指定される値は必ず達成されとは限らず、あくまでもターゲットです。

target_ti は、ループの連続開始間の間隔です。つまり、ループの最初の反復が開始されてから、次の最初の反復が開始されるまでの間隔です。次のコード例では、target_ti=T は L1 の連続する 2 回の反復間の L2 ループ開始の目標間隔が 100 サイクルである必要があることを示しています。

const int T = 100;
L1: for (int i=0; i<N; i++)
  L2: for (int j=0; j<M; j++){
   #pragma HLS PERFORMANCE target_ti=T
   ...
   }

target_tl は、ループの開始から終了までの間隔、またはループの最初の反復の開始からループの最後の反復の完了までの間隔です。前述のコード例の場合、target_tl=T は、L1 1 回の反復間の L2 ループの目標が 100 サイクルである必要があることを示しています。

トランザクション間隔は、ループの開始間隔 (II) に反復回数 (tripcount) を掛けた値 (target_ti = II * loop tripcount) になります。逆に、target_ti は FreqHz/毎秒ごとの演算になります。

たとえば、画像処理関数が 1 回の呼び出しで 1 フレームを処理し、スループット目標が 60 fps の場合、その関数の目標スループットは 1 秒あたり 60 回の呼び出しです。クロック周波数が 180 MHz の場合、target_ti は、関数呼び出しごとに 180M/60 なので、300 万クロックサイクルになります。

構文

ループの指示子を指定します。

syn.directive.performance=<location> [Options]

説明:

<location> は function/loop_label 形式でループを指定します。

オプション

target_ti=<value>

反復を完了するためのループのクロック サイクル数として定義されたターゲット トランザクション間隔を指定します。トランザクション間隔とは、ループの最初のトランザクションまたはネストされたループから、ループの次のトランザクションの開始までのクロック サイクル数です。<value> は、整数、浮動小数点、または定数式として指定できます。この式は、ツールによって整数に変換されます。

注記: 切り捨てが発生した場合、警告が表示されます。

target_tl=<value>

ループがすべての反復を完了するまでのクロック サイクル数として定義されるターゲット レイテンシを指定します。トランザクション レイテンシは、ループの最初の反復の開始から、ループの最後の反復の完了までの間隔のことです。<value> は、整数、浮動小数点、または定数式として指定できます。この式は、ツールによって整数に変換されます。

unit=[sec | cycle]

target_ti または target_tl の値に対する単位を指定します。単位は秒かクロック サイクルで指定できます。単位が秒の場合は、ナノ秒 (ns)、ピコ秒 (ps)、マイクロ秒 (us) を指定できます。

例 1

loop_1 とラベルが付けられているループは、ターゲット トランザクション間隔を 4 クロック サイクルにするように指定されています。

syn.directive.performance=loop_1 target_ti=4

関連項目

• syn.directive.inline