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