简介

跟踪钩子宏是一个很强大的功能，用来收集嵌入式应用的相关数据。freeRTOS提供的源代码中的跟踪宏是空的，因此开发者可以根据自己的需求设计宏需要跟踪的数据，不使用的空的宏不会影响应用程序的时序。

例子

如下几个使用跟踪宏的例子：

• 设置一个数字输出，用来表明当前执行的任务。可以使用逻辑分析仪来观察、记录、分析任务的执行序列及时序
• 相似的，可以设置模拟输出，比如电压，则可以使用示波器来观察时序
• 记录任务的执行序列、时序、RTOS内核事件和API调用，这些数据可以用来离线分析应用
• 在第三方调试器中集成RTOS内核事件

例子1

为每个任务提供一个数字的或者模拟的标签值，每个任务的标签值都是特定的，将traceSWITCHED_IN()宏设置为输出这个标签值：

/* 第一个任务标签值设为1\. */
void vTask1( void *pvParameters )
{
    /* 使用电压灯等级1代表任务1 */
    vTaskSetApplicationTaskTag( NULL, ( void * ) 1 );
    for( ;; )
    {
        /* Task code goes here. */
    }
}
/*************************************************/
/* 第二个任务标签值设为2. */
void vTask2( void *pvParameters )
{
    /* 使用电压等级2代表任务2 */
    vTaskSetApplicationTaskTag( NULL, ( void * ) 2 );
    for( ;; )
    {
        /* Task code goes here. */
    }
}
/*************************************************/
/* 设置宏输出任务的标签值，使用通道0. */
#define traceTASK_SWITCHED_IN() vSetAnalogueOutput( 0, (int)pxCurrentTCB->pxTaskTag )

例子2

API调用记录可以用来记录上下文切换的原因，RTOS内核调用记录可以用来记录任务的执行序列，比如：

/* traceBLOCKING_ON_QUEUE_RECEIVE() 可以用来记录上下文切换的原因 */
#define traceBLOCKING_ON_QUEUE_RECEIVE(xQueue)      \
    ulSwitchReason = reasonBLOCKING_ON_QUEUE_READ;
/* log_event() 用来记录任务的执行时间及原因 */
#define traceTASK_SWITCHED_OUT()                    \
    log_event( pxCurrentTCB, ulSwitchReason );

定义

在中断中调用的宏必须是短小精悍的，设置变量、写跟踪寄存器、端口输出是可以接受的，但是像fprintf()这类试图输出数据到存储器的功能，因为占用时间太长，而不被允许。

所有的宏定义必须在包含freeRTOS.h配置文件之前，最简单的方式是在freeRTOS.h文件的开头定义这些宏，当然也可以在单独的文件中定义，但是包含顺序需要在freeRTOS.h之前。

下表列出了这些可用的宏，宏的参数暗示了事件记录时的关联对象(队列、互斥量、信号量)