LiteOS-任务篇-源码分析-删除任务函数

前言
笔录草稿
源码分析
- LOS_TaskDelete函数源码分析
  - 完整源码
参考
- 链接

前言

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;

}

参考

链接

LiteOS源码链接
常见问题
华为开发者社区
华为LiteOS官方教程
我的源码
- 包含裸机源码
- LiteOS 工程模板
- 其它关于 LiteOS 的 demo 及 note

巴特西

LiteOS-任务篇-源码分析-删除任务函数

前言

笔录草稿

源码分析

LOS_TaskDelete函数源码分析

完整源码

参考

链接

最新文章

热门文章