命令和描述 - 2023.2 简体中文

Bootgen 用户指南 (UG1283)

Document ID
UG1283
Release Date
2023-10-18
Version
2023.2 简体中文

下表中列出了 Bootgen 命令选项。每个选项都链接至左侧列中的详细描述以及右侧列中的简短描述。架构名称用于指示使用该命令的 AMD 器件:

  • zynqAMD Zynq™ 7000 SoC 器件
  • zynqmpAMD Zynq™ UltraScale+™ MPSoC 器件
  • fpga:任意 7 系列和更高版本的器件
  • versalVersal 自适应 SoC

如需了解更多信息,请参阅 命令参考

表 1. Bootgen 命令和描述
命令 描述和选项 适用于
arch <type> AMD 器件架构。选项:
  • zynq(默认)
  • zynqmp
  • fpga
  • versal
  • 全部
authenticatedjtag <options> 用于在安全启动期间启用 JTAG。实参包括:
  • rsa
  • ecdsa
  • versal
bif_help 打印出 BIF 帮助信息摘要。
  • 全部
dual_qspi_mode <configuration> 生成 2 个输出文件用于双 QSPI 配置:
  • parallel
  • stacked <size>
  • zynq
  • zynqmp
  • versal
dual_ospi_mode stacked <size> 生成 2 个输出文件用于堆叠配置。
  • versal
dump <options> 根据指定的选项转储分区或启动头文件。
  • empty:将分区转储为二进制文件。
  • bh:将启动头文件转储为二进制文件。
  • plm:将 PLM 转储为二进制文件。
  • pmc_cdo:将 PMC CDO 转储为二进制文件。
  • boot_files:将启动头文件、PLM 和 PMC CDO 转储为三个独立二进制文件。
  • slave_pdis:为 SSI 技术用例转储从 PDI

默认不对从 PDI 执行转储。如果您要单独对从 PDI 进行调试或分析,则应使用该选项。

  • versal
dump_dir 将组件转储到指定目录中。
  • versal
efuseppkbits <PPK_filename> 生成用于 eFUSE 的 PPK 散列。
  • zynq
  • zynqmp
  • versal
encrypt <options> 器件中存储的 AES 密钥。选项包括:
  • bbram(默认)
  • efuse
  • zynq
  • fpga
encryption_dump 生成加密 log 日志文件 aes_log.txt
  • zynqmp
  • versal
fill <hex_byte> 指定用于填充的填充字节。
  • zynq
  • zynqmp
  • versal
generate_hashes 生成包含填充的散列的文件:
  • Zynq 器件:SHA-2(含 PKCS#1v1.5 填充方案)
  • Zynq UltraScale+ MPSoC:SHA-3(含 PKCS#1v1.5 填充方案)
  • Versal 自适应 SoC:SHA-3(含 PSS 填充方案)
  • zynq
  • zynqmp
  • versal
generate_keys <key_type> 生成认证密钥。选项包括:
  • pem
  • rsa
  • obfuscatedkey
  • zynq
  • zynqmp
  • versal
h 和 help 打印出帮助信息摘要。
  • 全部
image <filename(.bif)> 提供启动镜像格式 (.bif) 文件名。
  • 全部
log<level_type> 生成位于当前工作目录的 log 日志文件,此文件含下列消息类型:
  • error
  • warning(默认)
  • info
  • debug
  • trace
  • 全部
nonbooting 创建中间启动镜像。
  • zynq
  • zynqmp
  • versal
o <filename> 指定输出文件。文件格式取决于文件名扩展名。有效扩展名包括:
  • .bin(默认)
  • .mcs
  • .pdi
  • 全部
overlay_cdo <filename> CDO 覆盖选项提供了生成 CDO 文件后对其进行修改的方法。 versal
p <partname> 指定生成加密密钥时使用的器件名称。
  • 全部
padimageheader <option> 填充镜像头文件,以强制对齐下列分区。选项包括:
  • 0
  • 1(默认值)
  • zynq
  • zynqmp
process_bitstream <option> 指定比特流作为 .bin.mcs 来进行处理并输出。
  • 例如:如果针对 BIF 文件中的比特流选中加密,那么输出即为已加密的比特流。
  • zynq
  • zynqmp
read <options> 用于根据选项读取启动头文件、镜像头文件和分区头文件。
  • bh:从启动镜像读取人工可读格式的启动头文件
  • iht:从启动镜像读取镜像头文件表
  • ih:从启动镜像读取镜像头文件
  • pht:从启动镜像读取分区头文件
  • ac:从启动镜像读取身份验证证书
  • zynq
  • zynqmp
  • versal
split <options> 将启动镜像拆分为多个分区,并将文件作为 .bin.mcs 来输出。
  • 启动头文件 + 镜像头文件 + 分区头文件 + Fsbl.elf
  • Partition1.bit
  • Partition2.elf
  • zynq
  • zynqmp
  • versal
spksignature <filename> 生成 SPK 签名文件。
  • zynq
  • zynqmp
  • versal
verify <filename> 该选项用于对启动镜像的身份验证执行验证。根据可用分区对启动镜像中的所有身份验证证书进行验证。
  • zynq
  • zynqmp
  • versal
verify_kdf 该选项用于确认 Bootgen 中用于生成 AES 密钥的“计数器模式 KDF”。
  • zynqmp
  • versal
w <option> 指定是否覆盖输出文件:
  • on(默认)
  • off
注释: 无选项的 -w 解释为 –w on
  • 全部
zynqmpes1 为 ES1 (1.0) 生成启动镜像。默认填充方案为 ES2 (2.0)。
  • zynqmp