LiteOS-任务篇-源码分析-删除任务函数
前言
- 20201009
- LiteOS 2018
- 需要会通用链表
笔录草稿
源码分析
LOS_TaskDelete函数源码分析
完整源码
- 进入处理前，需要进入任务临界
- 通过任务ID来获取任务句柄
- 根据各种状态进行处理
- 处于 OS_TASK_STATUS_UNUSED （未使用） 状态
- 处于 OS_TASK_STATUS_RUNNING （运行态） 且调度被锁定了
- 处于 就绪态 或 阻塞态 或 阻塞队列态
- 处于 OS_TASK_STATUS_READY （就绪态）
- 处于 OS_TASK_STATUS_PEND（阻塞态） 或 OS_TASK_STATUS_PEND_QUEUE（阻塞队列态）
- 处于 OS_TASK_STATUS_DELAY （延时态）或 OS_TASK_STATUS_TIMEOUT（超时态）
- 被删除的任务需要做一些复位处理
- 被删除的任务s是否处于运行态
- 是
- 不能完全删除该任务，因为，调度过程中需要该任务参与
- 把当前任务插入到回收列表中，待运行创建任务函数时在进行回收处理。（其它RTOS都是在空闲任务中处理）
- 把当前任务（被删除的任务）copy到最低优先级的任务中，即是比空闲任务还低一个优先级的备用任务中，被赋给 g_stLosTask.pstRunTask，用于下main调度使用
- 解锁中断
- 调度
- 否
- 标记为未使用状态
- 直接放到空闲列表中
- 释放任务堆空间
- 初始化栈顶指针
- 解锁中断
/*****************************************************************************
Function : LOS_TaskDelete
Description : Delete a task
Input : uwTaskID --- Task ID
Output : None
Return : LOS_OK on success or error code on failure
*****************************************************************************/
LITE_OS_SEC_TEXT_INIT UINT32 LOS_TaskDelete(UINT32 uwTaskID)
{
UINTPTR uvIntSave;
LOS_TASK_CB *pstTaskCB;
UINT16 usTempStatus;
UINT32 uwErrRet = OS_ERROR;
CHECK_TASKID(uwTaskID); // 检查任务 ID
uvIntSave = LOS_IntLock(); // 锁中断
pstTaskCB = OS_TCB_FROM_TID(uwTaskID); // 通过任务 ID 获取任务控制块句柄
usTempStatus = pstTaskCB->usTaskStatus; // 获取任务状态
/* 判断任务状态是否处于 UNUSED （即未被创建） 状态，若是则退出*/
if (OS_TASK_STATUS_UNUSED & usTempStatus)
{
uwErrRet = LOS_ERRNO_TSK_NOT_CREATED;
OS_GOTO_ERREND();
}
/* If the task is running and scheduler is locked then you can not delete it */
if ((OS_TASK_STATUS_RUNNING & usTempStatus) && (g_usLosTaskLock != 0))
{
PRINT_INFO("In case of task lock, task deletion is not recommended\n");
g_usLosTaskLock = 0;
}
/* 判断任务状态是否处于 READY （即就绪态） 状态*/
if (OS_TASK_STATUS_READY & usTempStatus) // 处于就绪态
{
osPriqueueDequeue(&pstTaskCB->stPendList); // 从对应链表中删除该任务节点
pstTaskCB->usTaskStatus &= (~OS_TASK_STATUS_READY); // 取消就绪态
}
else if ((OS_TASK_STATUS_PEND & usTempStatus) || (OS_TASK_STATUS_PEND_QUEUE & usTempStatus)) // 处于阻塞态
{
LOS_ListDelete(&pstTaskCB->stPendList); // 从对应链表中删除该任务节点
}
if ((OS_TASK_STATUS_DELAY | OS_TASK_STATUS_TIMEOUT) & usTempStatus) // 处于任务延时会或超时状态
{
osTimerListDelete(pstTaskCB); // 从对应链表中删除该任务节点
}
pstTaskCB->usTaskStatus &= (~(OS_TASK_STATUS_SUSPEND)); // 取消挂起态
pstTaskCB->usTaskStatus |= OS_TASK_STATUS_UNUSED; // 标为未使用状态
pstTaskCB->uwEvent.uwEventID = 0xFFFFFFFF; // 复位时间ID
pstTaskCB->uwEventMask = 0;
#if (LOSCFG_BASE_CORE_CPUP == YES)
(VOID)memset((VOID *)&g_pstCpup[pstTaskCB->uwTaskID], 0, sizeof(OS_CPUP_S));
#endif
g_stLosTask.pstNewTask = LOS_DL_LIST_ENTRY(osPriqueueTop(), LOS_TASK_CB, stPendList); /*lint !e413*/ // 在就绪列表中寻找最高优先级的任务，标为下一个需要运行的任务
if (OS_TASK_STATUS_RUNNING & pstTaskCB->usTaskStatus) // 如果被删除的任务为运行态
{
/*
* 如果删除的任务为运行态时，就不能完全删除该任务，因为，调度过程中需要当前任务参与。
* 需要把当前任务插入到回收列表中，待运行创建任务函数时在进行回收处理。（其它RTOS都是在空闲任务中处理）
*/
LOS_ListTailInsert(&g_stTskRecyleList, &pstTaskCB->stPendList); // 把该任务插入回收列表
g_stLosTask.pstRunTask = &g_pstTaskCBArray[g_uwTskMaxNum];
g_stLosTask.pstRunTask->uwTaskID = uwTaskID;
g_stLosTask.pstRunTask->usTaskStatus = pstTaskCB->usTaskStatus;
g_stLosTask.pstRunTask->uwTopOfStack = pstTaskCB->uwTopOfStack;
g_stLosTask.pstRunTask->pcTaskName = pstTaskCB->pcTaskName;
pstTaskCB->usTaskStatus = OS_TASK_STATUS_UNUSED;
(VOID)LOS_IntRestore(uvIntSave); // 解锁中断
osSchedule(); // 调度
return LOS_OK;
}
else // 如果不为运行态
{
pstTaskCB->usTaskStatus = OS_TASK_STATUS_UNUSED; // 标为未使用
LOS_ListAdd(&g_stLosFreeTask, &pstTaskCB->stPendList); // 插入到可用列表
(VOID)LOS_MemFree(m_aucSysMem0, (VOID *)pstTaskCB->uwTopOfStack); // 释放任务堆空间内存
pstTaskCB->uwTopOfStack = (UINT32)NULL; // 标记栈顶为空
}
(VOID)LOS_IntRestore(uvIntSave); // 解锁中断
return LOS_OK;
LOS_ERREND: // 错误
(VOID)LOS_IntRestore(uvIntSave);
return uwErrRet;
}
参考
链接
