説明
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