FreeRTOS任务状态信息查询

uxTaskPriorityGet()：查询某个任务的优先级

vTaskPrioritySet()：改变某个任务的任务优先级

uxTaskGetSystemState()：获取系统中任务状态

vTaskGetInfo()：获取某个任务信息

xTaskGetApplicationTaskTag()：获取某个任务的标签(Tag)值

xTaskGetCurrentTaskHandle()：获取当前正在运行的任务的任务句柄

xTaskGetHandle()：根据任务名字查找某个任务的句柄

xTaskGetIdleTaskHandle()：获取空闲任务的任务句柄

uxTaskGetStackHighWaterMark()：获取任务的堆栈的历史剩余最小值，FreeRTOS 中叫做“高水位线”

eTaskGetState()：获取某个任务的壮态，这个壮态是 eTaskState 类型

pcTaskGetName()：获取某个任务的任务名字

xTaskGetTickCount()：获取系统时间计数器值

xTaskGetTickCountFromISR()：在中断服务函数中获取时间计数器值

xTaskGetSchedulerState()：获取任务调度器的壮态，开启或未开启

uxTaskGetNumberOfTasks()：获取当前系统中存在的任务数量

vTaskList()：以一种表格的形式输出当前系统中所有任务的详细信息

vTaskGetRunTimeStats()：获取每个任务的运行时间

vTaskSetApplicationTaskTag()：设置任务标签(Tag)值

SetThreadLocalStoragePointer()：设置线程本地存储指针

GetThreadLocalStoragePointer()：获取线程本地存储指针

使用举例

/*
* UBaseType_t uxTaskGetNumberOfTasks( void )
* UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray,
*                                   const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime )
*/

TaskStatus_t *StatusArray;
UBaseType_t task_num;

task_num=uxTaskGetNumberOfTasks();      //获取系统任务数量
printf("uxTaskGetNumberOfTasks %d\r\n", task_num);

StatusArray=pvPortMalloc(task_num*sizeof(TaskStatus_t));//申请内存
if(StatusArray!=NULL)                   //内存申请成功
{
ArraySize=uxTaskGetSystemState((TaskStatus_t*   )StatusArray,   //任务信息存储数组
(UBaseType_t     )task_num,  //任务信息存储数组大小
(uint32_t*       )&TotalRunTime);//保存系统总的运行时间
printf("TaskName\t\tPriority\t\tTaskNumber\t\t\r\n");
for(x=0;x<task_num;x++)
{
printf("%s\t\t%d\t\t\t%d\t\t\t\r\n",
StatusArray[x].pcTaskName, //任务名称
(int)StatusArray[x].uxCurrentPriority, //任务优先级
(int)StatusArray[x].xTaskNumber); //任务编号

}
}
vPortFree(StatusArray); //释放内存

实验现象

uxTaskGetNumberOfTasks 5

TaskName        Priority        TaskNumber
query_task      3               5
led0_task       2               4
IDLE            0               2
start_task      1               1
Tmr Svc         31              3

使用举例

/*
* TaskHandle_t xTaskGetHandle( const char *pcNameToQuery )
* void vTaskGetInfo( TaskHandle_t xTask, TaskStatus_t *pxTaskStatus,
*                    BaseType_t xGetFreeStackSpace, eTaskState eState )
*/
TaskHandle_t TaskHandle;
TaskStatus_t TaskStatus;

TaskHandle=xTaskGetHandle("led0_task");         //根据任务名获取任务句柄

//获取LED0_Task的任务信息
vTaskGetInfo((TaskHandle_t  )TaskHandle,        //任务句柄
(TaskStatus_t* )&TaskStatus,       //任务信息结构体
(BaseType_t    )pdTRUE,            //允许统计任务堆栈历史最小剩余大小
(eTaskState    )eInvalid);         //函数自己获取任务运行壮态

printf("任务名:                %s\r\n",TaskStatus.pcTaskName);
printf("任务编号:              %d\r\n",(int)TaskStatus.xTaskNumber);
printf("任务壮态:              %d\r\n",TaskStatus.eCurrentState);
printf("任务当前优先级:        %d\r\n",(int)TaskStatus.uxCurrentPriority);
printf("任务基优先级:          %d\r\n",(int)TaskStatus.uxBasePriority);
printf("任务堆栈基地址:        %#x\r\n",(int)TaskStatus.pxStackBase);
printf("任务堆栈历史剩余最小值: %d\r\n",TaskStatus.usStackHighWaterMark);

实验现象

任务名:                led0_task
任务编号:              4
任务壮态:              2
任务当前优先级:         2
任务基优先级:           2
任务堆栈基地址:         0x200012e8
任务堆栈历史剩余最小值:  108

使用举例

/*
* eTaskState eTaskGetState( TaskHandle_t xTask )
*/

typedef enum
{
eRunning = 0,   /* A task is querying the state of itself, so must be running. */
eReady,         /* The task being queried is in a read or pending ready list. */
eBlocked,       /* The task being queried is in the Blocked state. */
eSuspended,     /* The task being queried is in the Suspended state, or is in the Blocked state with an infinite time out. */
eDeleted,       /* The task being queried has been deleted, but its TCB has not yet been freed. */
eInvalid        /* Used as an 'invalid state' value. */
} eTaskState;

TaskHandle=xTaskGetHandle("query_task");        //根据任务名获取任务句柄

TaskState=eTaskGetState(TaskHandle);            //获取query_task任务的任务壮态

switch((int)TaskState)
{
case eRunning:
sprintf(TaskInfo,"Running");
break;
case eReady:
sprintf(TaskInfo,"Ready");
break;
case eSuspended:
sprintf(TaskInfo,"Suspended");
break;
case eDeleted:
sprintf(TaskInfo,"Deleted");
break;
case eInvalid:
sprintf(TaskInfo,"Invalid");
break;
}
printf("任务壮态值:%d,对应的壮态为:%s\r\n",TaskState,TaskInfo);

实验现象

任务壮态值:0,对应的壮态为:Running

使用举例

/*
* void vTaskList( char * pcWriteBuffer )
*/

vTaskList(InfoBuffer);          //获取所有任务的信息
printf("%s\r\n",InfoBuffer);

实验现象

query_task      R   3   192 5
IDLE            R   0   108 2
led0_task       B   2   108 4
Tmr Svc         S   31  236 3