如何使用Tracealyzer的流模式來跟蹤ThreadX應(yīng)用

Tracealyzer是Percepio 公司開發(fā)的一款用于RTOS的嵌入式軟件系統(tǒng)的可視化跟蹤工具，提供了30多種相互關(guān)聯(lián)的可視化運行時行為視圖，本文將介紹如何使用Tracealyzer的流模式來跟蹤ThreadX應(yīng)用。

添加Tracealyzer跟蹤記錄器庫文件

使用Tracealyzer首先需要在工程中添加用于ThreadX的跟蹤記錄器庫文件，包括源碼，頭文件、配置文件等。這些文件在Tracealyzer的安裝目錄下可以找到，默認(rèn)的保存路徑可以參考：C:Program FilesPercepioTracealyzer 4ThreadXTraceRecorder。

使用流模式，還需要添加流模式端口所用到的文件，以JLink RTT方式為例需要例如添加記錄器庫streamports下的Jlink_RTT文件夾中的文件。本文介紹時使用的是STM32CubeIDE，所有文件添加完成后的工程目錄結(jié)構(gòu)如下圖所示：

注意在進行操作的時候出現(xiàn)的所有的文件夾名稱及文件保存路徑中均不包含空格和中文字符，以避免在編譯過程中出現(xiàn)一些奇怪的錯誤，以及所有添加文件的頭文件包含路徑都需要在工程中進行設(shè)置。文件的添加過程也可以參考：快速入門| Tracealyzer跟蹤記錄庫移植

工程相關(guān)宏和IDE選項設(shè)置

(1)要在項目中使用跟蹤首先需要在ThreadX的tx_api.h頭文件中包含記錄器庫的頭文件。

(2)在ThreadX的配置文件tx_user.h中開啟跟蹤功能和堆棧檢測功能，需要通過修改頭文件中的這兩條宏來開啟。

(3)在Tracealyzer的配置文件trcConfig.h文件中需要包含你所使用芯片系列所對應(yīng)的頭文件，以STM32F4系列芯片為例則是#include "stm32f4xx.h"。

在該文件中還需要指定你所使用的芯片內(nèi)核，如果是使用M3/M4/M7內(nèi)核的芯片則選擇TRC_HARDWARE_PORT_ARM_Cortex_M即可。

(4)在trcKernelPortConfig.h文件中，通過宏#define TRC_CFG_CPU_CLOCK_HZ設(shè)置所使用MCU運行的時鐘主頻，例如運行在25MHz。

(5)為了實現(xiàn)一些ThreadX自帶的跟蹤機制所未提供的更為強大的跟蹤功能，Tracealyzer提供了一個頭文件trcCTI.h，該文件需要被項目工程中的所有代碼文件都包含?？梢越柚鶬DE提供的設(shè)置選項來實現(xiàn)。

在STM32CubeIDE的工程設(shè)置中，選擇編譯器Preprocessor選項的Define symbols(-D)一欄添加“__inside_$(notdir $(basename $(@)))”這一全局宏定義命令來實現(xiàn)。

在該位置添加宏定義后還需在Miscellaneous選項中添加“-include trcCTI.h”命令。

在工程代碼中啟動跟蹤

在ThreadX的入口函數(shù)tx_application_define()的入口位置調(diào)用vTraceEnable()函數(shù)開啟Tracealyzer跟蹤。vTraceEnable()函數(shù)根據(jù)函數(shù)參數(shù)的不同支持多種設(shè)置，此處TRC_START指初始化并直接開始跟蹤。

Tracealyzer電腦端軟件的設(shè)置

(1)開始實時跟蹤。啟動Tracealyzer，從File->Settings->J-Link Settings設(shè)置調(diào)試器所使用的接口和芯片型號。

(2)在PSF Streaming Settings，設(shè)置Target Connection為：SEGGER RTT，使用J-Link RTT通訊機制，將Trace數(shù)據(jù)從目標(biāo)板經(jīng)過J-Link調(diào)試器傳送到PC端軟件。

(3)運行目標(biāo)平臺程序，點“Start Recording”圖標(biāo)打開Live Stream窗口，點“Start Session”按鈕即可開始實時跟蹤。

(4)示例中創(chuàng)建了一個簡單的優(yōu)先級為10的循環(huán)打印任務(wù) ，可以看到在Tracealyzer中成功顯示了該任務(wù)中調(diào)用的延時函數(shù)，及執(zhí)行過程中被系統(tǒng)中更高優(yōu)先級的定時器任務(wù)System Timer Thread任務(wù)搶占的執(zhí)行情況。

作為一款功能強大的RTOS可視化跟蹤工具，系統(tǒng)運行時的行為提供了前所未有的洞察方法。能夠幫助開發(fā)人員加快固件的開發(fā)，減少對系統(tǒng)驗證和性能優(yōu)化所需要的時間。

審核編輯：湯梓紅