概要
v++ --package または -p ステップでは、v++ コンパイルおよびリンク ビルド プロセスの終わりで最終的な出力がパッケージされます。これは、Versal デバイス、AI エンジン、Zynq デバイスを含むすべてのエンベデッド プラットフォームで必須のステップです。
--package には、次のようなオプションがあります。
--package.aie_debug_port
--package.aie_debug_port <arg>
<arg>: Versal
AI エンジン コアをデバッグするデバッガーから入ってくる接続をエミュレーターがリッスンする TCP ポートを指定します。
次に例を示します。
v++ -l --package.aie_debug_port 1440 --package.bl31_elf
--package.bl31_elf <arg>
<arg>: A72 #0 コアで実行される Arm trusted FW ELF への絶対パスまたは相対パスを指定します。
次に例を示します。
v++ -l --package.bl31_elf ./arm_trusted.elf --package.boot_mode
--package.boot_mode <arg>
<arg>: エミュレーション中またはハードウェアでアプリケーションを実行される際に使用される <ospi | qspi | sd> ブート モードを指定します。
次に例を示します。
v++ -l --package.boot_mode sd --package.defer_aie_run
--package.defer_aie_runVersal AI エンジン コアをエンベデッド プロセッサ (PS) アプリケーションでイネーブルにするかどうか指定します。このオプションを指定しない場合は、PDI ロード中に AI エンジン コアをイネーブルにする CDO コマンドが生成されます。
次に例を示します。
v++ -l --package.defer_aie_run--package.domain
--package.domain <arg>
<arg>: ドメイン名を指定します。
次に例を示します。
v++ -l --package.domain xrt--package.dtb
--package.dtb <arg>
<arg>: APU に Linux をロードするのに使用されるデバイス ツリー バイナリ (DTB) への絶対パスまたは相対パスを指定します。
次に例を示します。
v++ -l --package.dtb ./device_tree.image--package.enable_aie_debug
--package.enable_aie_debugイネーブルにすると、PDI ロード中に AI エンジン コアを停止する CDO コマンドが生成されます。
次に例を示します。
v++ -l --package.enable_aie_debug --package.image_format
--package.image_format <arg>
<arg>: <ext4 | fat32> で出力イメージ ファイル形式を指定します。
- ext4: Linux ファイル システム
- fat32: Windows ファイル システム
次に例を示します。
v++ -l --package.image_format fat32 --package.kernel_image
--package.kernel_image <arg>
<arg>: Linux カーネル イメージ ファイルへの絶対パスまたは相対パスを指定します。プラットフォームで使用可能な既存のイメージを上書きします。プラットフォーム イメージ ファイルは、https://japan.xilinx.com からダウンロードできます。詳細は、Vitis ソフトウェア プラットフォームのインストール を参照してください。
次に例を示します。
v++ -l --package.kernel_image ./kernel_image --package.no_image
--package.no_imageSD カードのイメージ作成をバイパスします。--package.boot_mode sd で有効です。
--package.out_dir
--package.out_dir <arg>
<arg>: --package コマンドの出力ディレクトリへの絶対パスまたは相対パスを指定します。
次に例を示します。
v++ -l --package.out_dir ./out_dir --package.ps_debug_port
--package.ps_debug_port <arg>
<arg>: PS コアをデバッグするデバッガーから入ってくる接続をエミュレーターがリッスンする TCP ポートを指定します。
次に例を示します。
v++ -l --package.debug_port 3200 --package.ps_elf
--package.ps_elf <arg>
<arg>: <ps.elf,core> を指定します。
- ps.elf: PS コアの ELF ファイルを指定します。
-
core: 実行する PS コアを指定します。
次に例を示します。
v++ -l --package.ps_elf a72_0.elf,a72-0 --package.rootfs
--package.rootfs <arg>
<arg>: 処理された Linux ルート ファイルのシステム ファイルへの絶対パスまたは相対パスを指定します。プラットフォーム RootFS ファイルは、Xilinx.com からダウンロードできます。詳細は、Vitis ソフトウェア プラットフォームのインストール を参照してください。
次に例を示します。
v++ -l --package.rootfs ./rootfs.ext4--package.sd_dir
--package.sd_dir <arg>
<arg>: sd_card ディレクトリ/イメージにパッケージするフォルダーを指定します。ディレクトリの内容が sd_card フォルダー内のフォルダーにコピーされます。
次に例を示します。
v++ -l --package.sd_dir ./test_data --package.sd_file
--package.sd_file <arg>
<arg>: sd_card ディレクトリ/イメージにパッケージする ELF またはその他のデータ ファイルを指定します。このオプションを繰り返し使用すると、複数のファイルが sd_card に追加できます。
次に例を示します。
v++ -l --package.sd_file ./arm_trusted.elf --package.uboot
--package.uboot <arg>
<arg>: U-Boot ELF ファイルへのパスを指定します。これにより、プラットフォーム U-Boot は使用されなくなります。
次に例を示します。
v++ -l --package.uboot ./uboot.elf