mbtrace - 2023.2 简体中文

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

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

配置和运行 MB 追踪。

语法

mbtrace [options]

配置和运行 MB 程序和事件追踪,以追踪 MB 上运行的应用。输出内容为针对执行的程序进行反汇编的结果。

选项

选项 描述
-start 启用并启动追踪。开始追踪后,将捕获程序的执行以供后续输出。
-stop 停止并输出追踪。
-con 在活动目标恢复执行后输出追踪,直至命中断点为止。必须设置至少一个断点或观察点才能使用该选项。该选项仅可用于嵌入追踪。
-stp 在活动目标恢复执行后输出追踪,直至控制到达属于另一行源代码的指令为止。
-nxt 在活动目标恢复执行后输出追踪,直至控制到达属于另一行源代码的指令为止,但全速运行调用的任意函数。
-out <filename> 将追踪数据输出至文件。<filename>:输出文件的名称,用于写入追踪数据。如不指定,则数据输出至标准输出。
-level <level> 将追踪级别设为“full”、“flow”、“event”或“cycles”。如不指定,则使用“flow”。
-halt 设置此项即可在追踪缓冲器已满时,停止程序执行。如不指定,将停止追踪,但继续执行程序。
-save 设置此项即可启用捕获新数据值的加载和获取指令。
-low <addr> 设置外部追踪缓冲器地址范围的低位地址。地址范围必须指明未使用且可访问的存储器空间。仅限配合外部追踪一起使用。
-high <addr> 设置外部追踪缓冲器地址范围的高位地址。地址范围必须指明未使用且可访问的存储器空间。仅限配合外部追踪一起使用。
-format <format> 将外部追踪数据格式设置为“mdm”、“ftm”或“tpiu”。如不指定格式,则使用“mdm”。“ftm”和“tpiu”格式均为 Zynq 7000 PS 的输出格式。仅限配合外部追踪一起使用。

返回

取决于所使用的选项。-start、-out、-level、-halt、-save、-low、-high 和 -format:如配置成功,则不返回任何结果。如果出错,则返回错误字符串。

-stop, -con, -stp, -nxt:不返回任何结果,且将追踪数据输出至文件或标准输出。如果出错,则返回错误字符串。

示例

mbtrace -start

启用并启动追踪。

mbtrace -start -level full -halt

启用并启动追踪,配置此项即可保存完整追踪,而不只是程序流程,并且当追踪缓冲器已满时停止执行。

mbtrace -stop

停止追踪,将数据输出至标准格式。

mbtrace -stop -out trace.out

停止追踪,将数据输出至 trace.out。

mbtrace -con -out trace.out

继续执行,将数据输出至 trace.out。