附录 D - 转储和跟踪缓冲区
通过所使用的特定开发工具提供的命令和/或实用工具，可以将 Azure RTOS ThreadX 创建的跟踪缓冲区转储到主计算机上的文件中。 本附录举例说明了如何使用一些与 ThreadX 配合使用的更常用开发工具将跟踪缓冲区转储到主机文件中。
BenchX 工具
可以使用 BenchX 工具将跟踪缓冲区轻松地转储到主机文件中，具体方法为选择“内存视图”中的“将内存存储到文件中”按钮，如下所示：
此时，指定跟踪缓冲区的地址、大小和目标文件名（包括路径），然后选择“保存”按钮，如下所示。 这会创建二进制跟踪文件，以供在 TraceX 中查看。
RealView 工具
可以使用 ARM RealView 工具将跟踪缓冲区轻松地转储到主机文件中，具体方法为在 RealView 中的命令行提示符处输入以下命令：
> WRITEFILE,raw trace_file.trx=0x6860..0xE560
完成后，文件 trace_file.trx 将包含起始地址为 0x6860、结束地址为 0xE560 的跟踪缓冲区。 此文件可供在 TraceX 中查看。
IAR 工具
可以使用 IAR 工具将跟踪缓冲区轻松地转储到主机文件中，具体方法为直接在“内存”视图窗口中右键单击，然后选择“内存保存...”选项，如下所示：
此时，“内存保存”对话框显示。 输入起始地址和结束地址以及跟踪文件名，然后选择“保存”按钮。 在下面所示的示例中，IAR 工具将指定的跟踪缓冲区保存到文件 trace_file.hex 的 Intel HEX 记录中。
此时，跟踪缓冲区已保存到主机上的 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 步：依次选择“视图”->“内存”来打开“内存”窗口。
第 2 步：在“内存”视图窗口中右键单击来显示选项列表。 指定“显示格式”->“1 字节”来选择字节显示格式。
第 3 步：在“内存”视图窗口中再次右键单击，然后选择“转到”，这会打开便于指定事件缓冲区的地址的对话框。 此示例显示的是“event_buffer”。
第 4 步：这将突出显示跟踪缓冲区第一个位置的内容，此位置始终为字符串 BTXT….
第 5 步：现在，再次右键单击以显示“选项”菜单，然后选择“导出表”。
第 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 步：将光标置于“内存”窗口中，然后右键单击。
第 3 步：选择“保存”，然后在“将内存另存为”窗口中执行以下操作：
- 选择文件格式：二进制。
- 指定文件名：根据需要
- 指定起始地址：trace_buffer
- 指定结束地址：(trace_buffer+大小)
- 指定访问大小：1
- 点击“保存”(Save)
