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
