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

前言

笔录草稿

源码分析

LOS_TaskDelete函数源码分析

完整源码

参考

链接

个人收藏笔记记录

开通VIP