15-FreeRTOS任务应用函数（1）

1UBaseType_t uxTaskGetSystemState(
2TaskStatus_t * const pxTaskStatusArray,
3const UBaseType_t uxArraySize,
4unsigned long * const pulTotalRunTime );

1typedef struct xTASK_STATUS
 2{
 3/* 任务句柄 */
 4TaskHandle_t xHandle;
 5
 6/* A pointer to the task's name. This value will be invalid if the task was
 7deleted since the structure was populated! */
 8const signed char *pcTaskName;
 9
10/* A number unique to the task. */
11UBaseType_t xTaskNumber;
12
13/* The state in which the task existed when the structure was populated. */
14eTaskState eCurrentState;
15
16/* The priority at which the task was running (may be inherited) when the
17structure was populated. */
18UBaseType_t uxCurrentPriority;
19
20/* The priority to which the task will return if the task's current priority
21has been inherited to avoid unbounded priority inversion when obtaining a
22mutex. Only valid if configUSE_MUTEXES is defined as 1 in
23FreeRTOSConfig.h. */
24UBaseType_t uxBasePriority;
25
26/* The total run time allocated to the task so far, as defined by the run
27time stats clock. Only valid when configGENERATE_RUN_TIME_STATS is
28defined as 1 in FreeRTOSConfig.h. */
29unsigned long ulRunTimeCounter;
30
31/* Points to the lowest address of the task's stack area. */
32StackType_t *pxStackBase;
33
34/* The minimum amount of stack space that has remained for the task since
35the task was created. The closer this value is to zero the closer the task
36has come to overflowing its stack. */
37configSTACK_DEPTH_TYPE usStackHighWaterMark;
38} TaskStatus_t;

1/*本例演示如是使用uxTaskGetSystemState()函数来获取运行时间信息，并将其转化为程序员更易识别的字符格式，这些转化后的字符保存到pcWriteBuffer中。*/
 2void vTaskGetRunTimeStats(signed char *pcWriteBuffer )
 3{
 4TaskStatus_t*pxTaskStatusArray;
 5volatileUBaseType_t uxArraySize, x;
 6unsignedlong ulTotalRunTime, ulStatsAsPercentage;
 7
 8/* 防御性代码，确保字符串有合理的结束*/
 9*pcWriteBuffer = 0x00;
10
11/* 获取任务总数目*/
12uxArraySize = uxTaskGetNumberOfTasks ();
13
14/*为每个任务的TaskStatus_t结构体分配内存，也可以静态的分配一个足够大的数组 */
15pxTaskStatusArray = pvPortMalloc( uxArraySize * sizeof( TaskStatus_t ));
16
17if(pxTaskStatusArray != NULL )
18{
19/*获取每个任务的状态信息 */
20uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize,&ulTotalRunTime );
21
22/* 百分比计算 */
23ulTotalRunTime /= 100UL;
24
25/* 避免除零错误 */
26if(ulTotalRunTime > 0 )
27{
28/* 将获得的每一个任务状态信息部分的转化为程序员容易识别的字符串格式*/
29for( x = 0; x < uxArraySize; x++ )
30{
31/* 计算任务运行时间与总运行时间的百分比。*/
32ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter /ulTotalRunTime;
33
34if( ulStatsAsPercentage > 0UL )
35{
36sprintf( pcWriteBuffer, "%s\t\t%lu\t\t%lu%%\r\n",
37pxTaskStatusArray[ x ].pcTaskName,
38pxTaskStatusArray[ x ].ulRunTimeCounter,
39ulStatsAsPercentage );
40}
41else
42{
43/* 任务运行时间不足总运行时间的1%*/
44sprintf( pcWriteBuffer, "%s\t\t%lu\t\t<1%%\r\n",
45pxTaskStatusArray[ x ].pcTaskName,
46pxTaskStatusArray[x ].ulRunTimeCounter );
47}
48
49pcWriteBuffer += strlen( ( char * ) pcWriteBuffer );
50}
51}
52
53/* 释放之前申请的内存*/
54vPortFree( pxTaskStatusArray );
55}
56}

1void vTaskGetInfo( TaskHandle_t xTask,
2TaskStatus_t *pxTaskStatus,
3BaseType_t xGetFreeStackSpace,
4eTaskState eState );

1void vAFunction( void )
 2{
 3TaskHandle_t xHandle;
 4TaskStatus_t xTaskDetails;
 5
 6/* 从任务的名称中获取任务句柄。*/
 7xHandle = xTaskGetHandle( "Task_Name" );
 8
 9/* 检查句柄是不是任务本身. */
10configASSERT( xHandle );
11
12/* 使用句柄可以获得关于任务的进一步信息。 */
13vTaskGetInfo( /* 正在查询任务的句柄。 */
14xHandle,
15/* 要用信息完成的TaskStatus_t结构xTask。 */
16&xTaskDetails,
17/* Include the stack high water mark value in the
18TaskStatus_t structure. */
19pdTRUE,
20/* 在TaskStatus_t结构中包含任务状态*/
21eInvalid );
22}

1typedef struct xTASK_STATUS
 2{
 3/* 对象中的其余信息所归属的任务句柄结构有关。*/
 4TaskHandle_t xHandle;
 5
 6/*指向任务名称的指针。这个值将无效，如果任务被删除，因为结构已填充! */
 7const signed char *pcTaskName;
 8
 9/* A number unique to the task. */
10UBaseType_t xTaskNumber;
11
12/* The state in which the task existed when the structure was populated. */
13eTaskState eCurrentState;
14
15/* The priority at which the task was running (may be inherited) when the
16structure was populated. */
17UBaseType_t uxCurrentPriority;
18
19/* The priority to which the task will return if the task's current priority
20has been inherited to avoid unbounded priority inversion when obtaining a
21mutex. Only valid if configUSE_MUTEXES is defined as 1 in
22FreeRTOSConfig.h. */
23UBaseType_t uxBasePriority;
24
25/* The total run time allocated to the task so far, as defined by the run
26time stats clock. Only valid when configGENERATE_RUN_TIME_STATS is
27defined as 1 in FreeRTOSConfig.h. */
28unsigned long ulRunTimeCounter;
29
30/* Points to the lowest address of the task's stack area. */
31StackType_t *pxStackBase;
32
33/* The minimum amount of stack space that has remained for the task since
34the task was created. The closer this value is to zero the closer the task
35has come to overflowing its stack. */
36configSTACK_DEPTH_TYPE usStackHighWaterMark;
37} TaskStatus_t;