syn.directive.alias - 2023.2 日本語

Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発 (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 日本語

説明

2 つ以上の M_AXI ポインター引数が、メモリ内の同じ基盤バッファー (DDR または HBM) をポイントし、ポインター間の距離またはオフセットを設定して、そのポインター間のエイリアスを示すように指定します。

重要: syn.directive.alias は、M_AXI インターフェイスにマップされた最上位の関数引数に適用します。

Vitis HLS は、異なるポインターを独立したチャネルと判断し、通常は依存解析を実行しません。ただし、ホストが複数のポインターに単一のバッファーを割り当てる場合は、syn.directive.alias でこの関係を伝達し、依存解析を維持できます。これにより、バッファー内のポインター間の距離を定義することで、Vitis HLS でデータ依存解析が有効になります。

syn.directive.alias の要件:

  • すべてのポートは、次の例に示すように、M_AXI インターフェイスのほか、異なるバンドルに割り当てられている必要があります。
  • 各ポートは、1 つの syn.directive.alias コマンドでのみ使用できます
  • syn.directive.alias に割り当てられたすべてのポートが、同じ深さである必要があります。
  • オフセットが指定されている場合、各ポートは 1 つのオフセットを持つことができます。
  • M_AXI ポートのオフセットは、slave または direct に指定する必要があります。offset=off はサポートされていません。

構文

syn.directive.alias=[OPTIONS] <location> <ports>
  • <location> は、ALIAS プラグマが適用される function[/label] 形式の場所を示す文字列です。
  • <ports> はそのポートをエイリアスに指定します。

オプション

distance=<integer>
リスト内のポートに渡されるポインター値の差を指定します。
offset=<string>
配列の原点を基準にして、ports リストで各ポートに渡されるポインターのオフセットを指定します。

次の top 関数の場合:

void top(int *arr0, int *arr1, int *arr2, int *arr3, ...) {
  #pragma HLS interface M_AXI port=arr0 bundle=hbm0 depth=0x40000000
  #pragma HLS interface M_AXI port=arr1 bundle=hbm1 depth=0x40000000
  #pragma HLS interface M_AXI port=arr2 bundle=hbm2 depth=0x40000000
  #pragma HLS interface M_AXI port=arr3 bundle=hbm3 depth=0x40000000
次のコマンドは、指定された配列ポインターのエイリアスを定義し、その間の distance を定義します。
syn.directive.alias=top arr0,arr1,arr2,arr3 distance=10000000
または、次のコマンドでポインター間の offset を指定して、同じ設定にします。
syn.directive.alias=top arr0,arr1,arr2,arr3 offset=00000000,10000000,20000000,30000000