附录 D - 转储和跟踪缓冲区

通过所使用的特定开发工具提供的命令和/或实用工具,可以将 Azure RTOS ThreadX 创建的跟踪缓冲区转储到主计算机上的文件中。 本附录举例说明了如何使用一些与 ThreadX 配合使用的更常用开发工具将跟踪缓冲区转储到主机文件中。

BenchX 工具

可以使用 BenchX 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为选择“内存视图”中的“将内存存储到文件中”按钮,如下所示:

Screenshot of the Memory View in the BenchX tools.

此时,指定跟踪缓冲区的地址、大小和目标文件名(包括路径),然后选择“保存”按钮,如下所示。 这会创建二进制跟踪文件,以供在 TraceX 中查看。

Screenshot of the the BenchX tools save dialog.

RealView 工具

可以使用 ARM RealView 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为在 RealView 中的命令行提示符处输入以下命令:

> WRITEFILE,raw trace_file.trx=0x6860..0xE560

完成后,文件 trace_file.trx 将包含起始地址为 0x6860、结束地址为 0xE560 的跟踪缓冲区。 此文件可供在 TraceX 中查看。

IAR 工具

可以使用 IAR 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为直接在“内存”视图窗口中右键单击,然后选择“内存保存...”选项,如下所示:

Screenshot of the Memory Save option in the IAR tools.

此时,“内存保存”对话框显示。 输入起始地址和结束地址以及跟踪文件名,然后选择“保存”按钮。 在下面所示的示例中,IAR 工具将指定的跟踪缓冲区保存到文件 trace_file.hex 的 Intel HEX 记录中。

Screenshot of the IAR tools Memory Save dialog.

此时,跟踪缓冲区已保存到主机上的 trace_file.hex 文件中,并可供在 TraceX 中查看

CodeWarrior 工具

可以使用 CodeWarrior 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为在命令窗口中输入 save 命令。 下面的示例 save 命令假定跟踪缓冲区的起始地址为 0x102200,结束地址为 0x109F00:

> save –b p:0x102200..0x109F00 trace_file.trx -a 32bit

这会将跟踪缓冲区保存到主机上的 trace_file.trx 文件中

MPLAB 工具

MPLAB 可以通过其“导出表”实用工具来创建与 TraceX 兼容的跟踪文件,此实用工具便于将任意范围的内存导出到主机文件中。 若要使用此实用工具为 TraceX 创建跟踪文件,请按以下步骤操作:

第 1 步:依次选择“视图”->“内存”来打开“内存”窗口。

Screenshot of the Memory selected on the View menu.

第 2 步:在“内存”视图窗口中右键单击来显示选项列表。 指定“显示格式”->“1 字节”来选择字节显示格式。

Screenshot of the Memory View with the Display Format option selected.

Screenshot of the Go To dialog.

第 3 步:在“内存”视图窗口中再次右键单击,然后选择“转到”,这会打开便于指定事件缓冲区的地址的对话框。 此示例显示的是“event_buffer”。

Screenshot of the Memory View with the Go To option selected.

Screenshot of an example showing the event_buffer being displayed.

第 4 步:这将突出显示跟踪缓冲区第一个位置的内容,此位置始终为字符串 BTXT….

Screenshot of the first location of the trace buffer.

第 5 步:现在,再次右键单击以显示“选项”菜单,然后选择“导出表”。

Screenshot of the Memory View with the Export Table option selected.

第 6 步:此时,“导出表”对话框显示,如下所示。 指定要导出的地址范围。 对于 8K 跟踪缓冲区(如此示例中所示),指定范围 0xA00006AC - 0xA00026AC,并为要创建的主机文件输入文件名(在此示例中为 demo_threadx.trx)。

![“导出为”对话框的屏幕截图。

第 7 步:此时,名为 demo_threadx.trx 且可供 TraceX 打开的文件在主机上创建。

GHS 工具

可以使用 GHS 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为在“调试命令”窗口中的命令行提示符处输入以下命令:

memdump raw c:releasethreadxdemo_threadx.trx event_buffer 32768

完成后,文件 demo_threadx.trx 将包含位于 event_buffer 中、大小为 32,768 字节的跟踪缓冲区,并可供在 TraceX 中查看。

Renesas HEW

可以使用 Renasas HEW 工具将跟踪缓冲区轻松地转储到主机文件中,具体方法为执行以下三个步骤(和子步骤):

第 1 步:打开“内存”窗口。

![“内存”窗口的屏幕截图。

第 2 步:将光标置于“内存”窗口中,然后右键单击。

Screenshot of the Memory Window with the Save option selected.

第 3 步:选择“保存”,然后在“将内存另存为”窗口中执行以下操作:

  • 选择文件格式:二进制。
  • 指定文件名:根据需要
  • 指定起始地址:trace_buffer
  • 指定结束地址:(trace_buffer+大小)
  • 指定访问大小:1
  • 点击“保存”(Save)

Screenshot of the Save Memory As dialog.