跟踪钩子宏

描述

FreeRTOS 源代码中的关键关注点包含空宏， 应用程序可以重新定义这些宏，以便提供特定于应用程序的跟踪工具。 应用程序只需要实现特别关注的宏，未使用的宏将保留为空， 因此不会影响应用程序的定时。

示例

• 设置数字输出以指示正在执行的任务，并允许使用逻辑分析器查看和记录任务执行序列和定时。
• 类似地，将模拟输出设置为表示正在执行的任务的电压，并允许使用示波器查看和记录任务执行序列和定时。
• 记录任务执行序列、任务定时、RTOS 内核事件和 API 调用以进行离线分析。
• 将 RTOS 内核事件集成到第三方调试器中。

示例 1

/* First task sets its tag value to 1. */
void vTask1( void *pvParameters )
{
    /* This task is going to be represented by a voltage scale of 1. */
    vTaskSetApplicationTaskTag( NULL, ( void * ) 1 );

    for( ;; )
    {
        /* Task code goes here. */
    }
}
/*************************************************/

/* Second task sets its tag value to 2. */
void vTask2( void *pvParameters )
{
    /* This task is going to be represented by a voltage scale of 2. */
    vTaskSetApplicationTaskTag( NULL, ( void * ) 2 );

    for( ;; )
    {
        /* Task code goes here. */
    }
}
/*************************************************/

/* Define the traceTASK_SWITCHED_IN() macro to output the voltage associated
   with the task being selected to run on port 0. */
#define traceTASK_SWITCHED_IN() vSetAnalogueOutput( 0, (int)pxCurrentTCB->pxTaskTag )

示例 2

/* traceBLOCKING_ON_QUEUE_RECEIVE() is just one of the macros that can be used to
   record why a context switch is about to occur. */
#define traceBLOCKING_ON_QUEUE_RECEIVE(xQueue)      
    ulSwitchReason = reasonBLOCKING_ON_QUEUE_READ;

/* log_event() is an application defined function that logs which tasks ran when,
   and why. */
#define traceTASK_SWITCHED_OUT()                    
    log_event( pxCurrentTCB, ulSwitchReason );

定义

宏定义必须在加入 FreeRTOS.h 之前进行。 最容易定义跟踪宏的位置在 FreeRTOSConfig.h 的底部，或在 FreeRTOSConfig.h 的底部包含的单独的头文件中。

下表描述了可用的宏。 宏参数用于指示与所记录的事件相关联的 任务、队列、信号量或互斥锁。

除了上表中的追踪宏之外，还可以使用追踪宏记录所有 FreeRTOS API 的进入和退出。 宏参数用于指示函数参数和返回值。下表列出了 xEventGroupCreateStatic API 的一个示例。