rst - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 简体中文

目标复位。

语法

rst [options]

将活动目标复位。

选项

选项 描述
-processor 将活动的处理器目标复位。
-cores 将活动的处理器组复位。仅限 Zynq、Zynq UltraScale+ MPSoC 和 Versal 器件才支持此复位类型。处理器组定义为一组处理器核以及片上外设(如 OCM)。
-dap 复位 Arm DAP。仅限对应 Arm DAP 的目标才支持此复位类型。此类目标示例包括:APU、RPU、PSU 和 Versal。
-system 将活动系统复位。这是默认复位。
-srst 为活动目标生成系统复位。对于 JTAG,这是通过在与活动目标关联的 JTAG 线缆的 SRST 管脚上生成脉冲来完成的。
-por 为活动目标生成上电复位。对于 JTAG,这是通过在与活动目标关联的 JTAG 线缆的 POR 管脚上生成脉冲来完成的。
-ps 在 Zynq UltraScale+ MPSoC 上生成仅限 PS 复位。仅支持通过 MicroBlaze PMU 目标执行此复位。
-stop 复位后将核暂挂。如果不指定该选项,那么调试器会选择默认操作,即针对 -system 将核恢复,针对 -processor 和 -cores 则将核暂挂。仅支持将该选项与 -processor、-cores 和 -system 选项搭配使用。
-start 复位后将核恢复。请参阅 -stop 选项的描述以获取更多详细信息。
-endianness <value> 将数据字节序设置为 <value>。支持下列值:le - 小字节序;be - 大字节序。支持将该选项用于 APU、RPU、A9、A53 和 A72 目标。如果不指定该选项,则不更改当前配置。
-code-endianness <value> 将指令字节序设置为 <value>。支持下列值:le - 小字节序;be - 大字节序。支持将该选项用于 APU、RPU、A9、A53 和 A72 目标。如果不指定该选项,则不更改当前配置。
-isa <isa-name> 将 ISA 设置为 <isa-name>。受支持的 isa-names 为 ARM/A32、A64 和 Thumb。支持将该选项用于 APU、RPU、A9、A53 和 A72 目标。如果不指定该选项,则不更改当前配置。
-clear-registers 触发复位后,清除 CPU 寄存器。当器件上电后触发复位时,可使用该选项。否则,调试器最终可能基于寄存器内容读取无效的系统地址。清除寄存器将避免出现不可预测的行为。支持将该选项用于 Arm 目标,搭配“-processor”和“-cores”一起使用。
-type <reset type> 支持以下复位类型:core、cluster、cpu、dap、system、por、pmc-por、pmc-srst、ps-por、ps-srst、pl-por 和 pl-srst。Versal 器件支持 pmc-por、pmc-srst、ps-por、ps-srst、pl-por 和 pl-srst。上述每个复位类型均可用于断言 CRP 模块的 RST_PS 寄存器中对应的位有效和无效。pmc-por : RST_PS[PMC_POR] pmc-srst : RST_PS[PMC_SRST] ps-por : RST_PS[PS_POR] ps-srst : RST_PS[PS_SRST] pl-por : RST_PS[PL_POR] pl-srst : RST_PS[PL_SRST]

注释

  • 对于 Versal 器件,触发处理器复位之前,通过 IPI channel5 来激活默认子系统。由于当 PDI 内不包含 PS ELF 时,PLM 不会激活子系统,因此需要执行此操作。如果在 Vivado 设计中不启用此 IPI 通道,则无法激活该子系统。如果使用 PM API,这会导致运行时问题。

返回

如果复位成功,则不返回任何结果。如果不支持复位,则返回错误字符串。