Tracealyzer跟踪记录库移植

Percepio Tracealyzer是一个强大的工具，可以在运行时跟踪和可视化分析RTOS系统。超过30种视图，对系统的实时行为提供了惊人洞察力，加速了应用的调试、验证和系统性能优化的过程。使用Tracealyzer，可以查看到系统的真实运行情况，为开发人员节省排除错误的时间。

Tracealyzer由PC应用程序和跟踪组件组成，Percepio提供了跟踪记录库(Trace Recorder library)，支持多个RTOS，未来还计划支持裸机系统。

   

移植跟踪记录库

使用Tracealyzer，首先要将跟踪记录库集成到工程。安装了Tracealyzer 4之后，在安装路径下找到以RTOS名称命名的文件夹，将TraceRecorder子文件夹复制到自己的工程目录中。以FreeRTOS为例：

1、将trcKernelPort.c、

trcSnapshotRecorder.c和trcStreamingRecorder.c，3个主要源码文件添加到工程中。

2、将3个配置文件也添加到工程中，方便随时修改跟踪记录库的配置。建议每个工程分别使用一组配置文件，将trcConfig.h、trcSnapshotConfig.h和trcStreamingConfig.h复制到独立的工程目录下即可。

3、将TraceRecorderinclude目录添加到头文件路径中。

4、修改配置文件trcConfig.h，删除#error "Trace Recorder: Please include your processor's header file here and remove this line."，并#include处理器头文件。本次以STM32F769为例：添加 #include "stm32f7xx.h"

5、将硬件移植配置为Tracealyzer针对Cortex-M提供的实现。其他架构的处理器，如果没有现存的移植，需要用户自行提供一个硬件定时器来产生时间戳。

#define TRC_CFG_HARDWARE_PORT TRC_HARDWARE_PORT_ARM_Cortex_M

6、将跟踪模式设置为快照模式(Snapshot)：

#define TRC_CFG_RECORDER_MODE TRC_RECORDER_MODE_SNAPSHOT

快照模式是将跟踪到是事件缓存到芯片的RAM当中，然后通过工具的支持将事件缓存读取到PC上并保存为文件，由Tracealyzer进行显示和分析。

Note：除了快照模式，Tracealyzer还支持流模式(Streaming)，实时的将跟踪到的事件通过 (JTAG/SWD)、串口等接口传输到PC端进行显示和分析。本文只使用快照模式。

7、设置所使用的FreeRTOS的版本，这里使用的是FreeRTOS v10版本。

#define TRC_CFG_FREERTOS_VERSION TRC_FREERTOS_VERSION_10_0_0

8、修改trcSnapshotConfig.h，设置快照的模式，当事件缓存满了之后停止跟踪。#defineTRC_CFG_SNAPSHOT_MODE 

TRC_SNAPSHOT_MODE_STOP_WHEN_FULL

9、设置事件缓存的大小，单位是字，根据芯片空余的RAM大小酌情设置。

#define TRC_CFG_EVENT_BUFFER_SIZE  10000

10、在FreeRTOSConfig.h配置文件中使能跟踪功能：

#define configUSE_TRACE_FACILITY        1

并且在文件尾部添加包含trcRecorder.h头文件：

#ifdef __ICCARM__

#if ( configUSE_TRACE_FACILITY == 1 )

#include "trcRecorder.h"

#endif

#endif

11、在main函数中调用vTraceEnable(TRC_START)初始化并使能跟踪，调用的位置须在硬件完成初始化之后，第一个内核对象创建之前。

使用Tracealyzer可视化分析

构建工程，将程序下载到目标板中运行一段时间。然后打开Tracealyzer，通过J-link的支持将事件缓存读取出来。

1、从File->Settings打开设置窗口，在J-Link Settings中设置所使用的调试接口和芯片型号。

2、从菜单栏 Trace->Open Snapshot Tool打开Take Snapshot窗口，按“Memory Region”设置芯片的RAM起始地址和大小，然后按“Read Snapshot”即可将事件缓存读取到PC端，然后进行显示和分析。

3、垂直时间轴视图窗口和事件记录窗口。

审核编辑 ：李倩