platforminfo ユーティリティ - 2020.2 日本語

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

Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 Japanese

platforminfo コマンド ライン ユーティリティは、インターフェイス、クロック、有効な SLR と割り当てられたリソース、および構造化されたフォーマットのメモリなどのプラットフォームのメタデータをレポートします。この情報は、たとえばカーネルを SLR またはメモリ リソース割り当てる際に参照できます。

platforminfo に使用可能なコマンド オプションは次のとおりです。

表 1. platforminfo コマンド
オプション 説明
-f [ --force ] 既存の出力ファイルを上書きします。
-h [ --help ] ヘルプ メッセージを表示します。
-k [ --keys ] 指定したプラットフォームのキーを取得します。JSON パスのリストが返されます。
-l [ --list ] プラットフォームをリストします。.xpfm ファイルを見つけるのに、まずユーザー リポジトリ パスの $PLATFORM_REPO_PATHS を検索し、その後インストール ディレクトリを検索します。
-e [ --extended ] 拡張情報を含むプラットフォームをリストします。--list と共に使用してください。
-d [ --hw ] <arg> 操作を実行するハードウェア プラットフォーム定義 (*.dsa) を指定します。値はフル パスで、ファイル名と .dsa 拡張子を含む必要があります。
-s [ --sw ] <arg> 操作を実行するソフトウェア プラットフォーム定義 (*.spfm) を指定します。値はフル パスで、ファイル名と .spfm 拡張子を含む必要があります。
-p [ --platform ] <arg> 操作を実行するザイリンクス プラットフォーム定義 (*.xpfm) を指定します。--platform の値はフル パスで、次の Example 1 に示すように、ファイル名と .xpfm 拡張子を含む必要があります。パスなしでファイル名と .xpfm 拡張子を指定した場合は、現在作業中のディレクトリのみが検索されます。プラットフォームのベース名だけを指定することもできます。Example 2 のように値をベース名にすると、該当する .xpfm ファイルを見つけるのに、まず $PLATFORM_REPO_PATHS が検索され、その後インストール ディレクトリが検索されます。
Example 1: --platform /opt/xilinx/platforms/xilinx_u50_gen3x16_xdma_201920_3.xpfm

Example 2: --platform xilinx_u200_xdma_201830_1
-o [ --output ] <arg> 結果を書き込む出力ファイルを指定します。デフォルトでは、出力はターミナル (stdout) に表示されます。
-j [ --json ] <arg> 生成する出力の JSON フォーマットを指定します。値を指定しない場合、platforminfo ユーティリティはプラットフォーム全体を JSON フォーマットで表示します。このオプションには、-k オプションで返される JSON パスを指定する引数を使用することもできます。JSON パスは、有効であれば、JSON サブツリー、リスト、または値をフェッチするために使用されます。
Example 1: 
platforminfo --json="hardwarePlatform" --platform <platform base name>

Example 2: Specify the index when referring to an item in a list.
platforminfo --json="hardwarePlatform.devices[0].name" --platform <platform base name>

Example 3: When using the short option form (-j), the value must follow immediately.
platforminfo -j"hardwarePlatform.systemClocks[]" -p <platform base name>
-v [ --verbose ] 詳細な情報を出力します。デフォルトでは、指定したプラットフォームの最も重要な特性を含め、人間に解読可能なレポートが生成されます。
注記: --help または --list オプションを使用する場合を除き、プラットフォームは必ず指定する必要があります。プラットフォームは、--platform オプションを使用するか、--hw または --sw のいずれかを使用して指定できます。または、単にプラットフォーム名を挿入するか、コマンド ラインにフル パスを指定することもできます。

生成されたレポートを理解するには、次のコマンドを使用して生成された要約された出力ログを確認します。このレポートは、理解しやすいようにセクションに分割されています。

platforminfo -p $PLATFORM_REPO_PATHS/xilinx_u200_xdma_201830_1.xpfm
ヒント: エンベデッド プロセッサ プラットフォームの例は、xilinx_zcu104_base_202010_1 の platforminfo を参照してください。