基本概念

    任务相关概念

    任务状态

    Huawei LiteOS系统中的每一任务都有多种运行状态。系统初始化完成后，创建的任务就可以在系统中竞争一定的资源，由内核进行调度。

    任务状态通常分为以下四种：

    • 就绪（Ready）：该任务在就绪列表中，只等待CPU。
    • 运行（Running）：该任务正在执行。
    • 阻塞（Blocked）：该任务不在就绪列表中。包含任务被挂起、任务被延时、任务正在等待信号量、读写队列或者等待读写事件等。
    • 退出态（Dead）：该任务运行结束，等待系统回收资源。

    任务状态示意图

    任务状态迁移说明

    就绪态→运行态：

    任务创建后进入就绪态，发生任务切换时，就绪列表中最高优先级的任务被执行，从而进入运行态，但此刻该任务依旧在就绪列表中。

    运行态→阻塞态：

    正在运行的任务发生阻塞（挂起、延时、获取互斥锁、读消息、读信号量等待等）时，该任务会从就绪列表中删除，任务状态由运行态变成阻塞态，然后发生任务切换，运行就绪列表中剩余最高优先级任务。

    阻塞态→就绪态（阻塞态→运行态）：

    阻塞的任务被恢复后（任务恢复、延时时间超时、读信号量超时或读到信号量等），此时被恢复的任务会被加入就绪列表，从而由阻塞态变成就绪态；此时如果被恢复任务的优先级高于正在运行任务的优先级，则会发生任务切换，将该任务由就绪态变成运行态。

    就绪态→阻塞态：

    任务也有可能在就绪态时被阻塞（挂起），此时任务状态会由就绪态转变为阻塞态，该任务从就绪列表中删除，不会参与任务调度，直到该任务被恢复。

    运行态→就绪态：

    有更高优先级任务创建或者恢复后，会发生任务调度，此刻就绪列表中最高优先级任务变为运行态，那么原先运行的任务由运行态变为就绪态，依然在就绪列表中。

    运行态→退出态:

    运行中的任务运行结束，内核自动将此任务删除，任务状态由运行态变为退出态。

    阻塞态→退出态:

    阻塞的任务调用删除接口，任务状态由阻塞态变为退出态。

    任务ID

    任务ID，在任务创建时通过参数返回给用户，作为任务的一个非常重要的标识。用户可以通过任务ID对指定任务进行任务挂起、任务恢复、查询任务名等操作。

    任务优先级

    优先级表示任务执行的优先顺序。任务的优先级决定了在发生任务切换时即将要执行的任务。在就绪列表中的最高优先级的任务将得到执行。

    任务入口函数

    每个新任务得到调度后将执行的函数。该函数由用户实现，在任务创建时，通过任务创建结构体指定。

    每一个任务都含有一个任务控制块(TCB)。TCB包含了任务上下文栈指针（stack pointer）、任务状态、任务优先级、任务ID、任务名、任务栈大小等信息。TCB可以反映出每个任务运行情况。

    任务栈

    每一个任务都拥有一个独立的栈空间，我们称为任务栈。栈空间里保存的信息包含局部变量、寄存器、函数参数、函数返回地址等。任务在任务切换时会将切出任务的上下文信息保存在自身的任务栈空间里面，以便任务恢复时还原现场，从而在任务恢复后在切出点继续开始执行。

    任务上下文

    任务在运行过程中使用到的一些资源，如寄存器等，我们称为任务上下文。当这个任务挂起时，其他任务继续执行，在任务恢复后，如果没有把任务上下文保存下来，有可能任务切换会修改寄存器中的值，从而导致未知错误。

    因此，Huawei LiteOS在任务挂起的时候会将本任务的任务上下文信息，保存在自己的任务栈里面，以便任务恢复后，从栈空间中恢复挂起时的上下文信息，从而继续执行被挂起时被打断的代码。

    任务切换

    任务切换包含获取就绪列表中最高优先级任务、切出任务上下文保存、切入任务上下文恢复等动作。

    运作机制

    Huawei LiteOS任务管理模块提供任务创建、任务删除、任务延时、任务挂起和任务恢复、更改任务优先级、锁任务调度和解锁任务调度、根据任务控制块查询任务ID、根据ID查询任务控制块信息功能。

    在任务模块初始化时，系统会先申请任务控制块需要的内存空间，如果系统可用的内存空间小于其所需要的内存空间，任务模块就会初始化失败。如果任务初始化成功，则系统对任务控制块内容进行初始化。

    用户创建任务时，系统会将任务栈进行初始化，预置上下文。此外，系统还会将“任务入口函数”地址放在相应位置。这样在任务第一次启动进入运行态时，将会执行“任务入口函数”。

    使用场景

    任务创建后，内核可以执行锁任务调度，解锁任务调度，挂起，恢复，延时等操作，同时也可以设置任务优先级，获取任务优先级。任务结束的时候，则进行当前任务自删除操作。

    功能

    Huawei LiteOS 系统中的任务管理模块为用户提供下面几种功能。

    开发流程

    以创建任务为例，讲解开发流程。

    1. 在los_config.h中配置任务模块。

      配置LOSCFG_BASE_CORE_TSK_LIMIT系统支持最大任务数，这个可以根据需求自己配置。

      配置LOSCFG_BASE_CORE_TSK_IDLE_STACK_SIZE 空闲（IDLE）任务栈大小，这个默认即可。

      配置LOSCFG_BASE_CORE_TSK_DEFAULT_STACK_SIZE默认任务栈大小，用户根据自己的需求进行配置，在用户创建任务时，可以进行针对性设置。

      配置LOSCFG_BASE_CORE_TIMESLICE时间片开关为YES。

      配置LOSCFG_BASE_CORE_TIMESLICE_TIMEOUT时间片，根据实际情况自己配置。

      配置LOSCFG_BASE_CORE_TSK_MONITOR任务监测模块裁剪开关，可选择是否打开。

    2. 锁任务LOS_TaskLock，锁住任务，防止高优先级任务调度。

    3. 创建任务LOS_TaskCreate。

    4. 解锁任务LOS_TaskUnlock，让任务按照优先级进行调度。

    5. 延时任务LOS_TaskDelay，任务延时等待。

    6. 挂起指定的任务LOS_TaskSuspend，任务挂起等待恢复操作。

    TASK状态

    Huawei LiteOS任务的状态由内核自动维护，对用户不可见，不需要用户去操作。

    TASK错误码

    对任务存在失败可能性的操作，包括创建任务、删除任务、挂起任务、恢复任务、延时任务等等，均需要返回对应的错误码，以便快速定位错误原因。

    序号 定义 实际数值 描述 参考解决方案
    1 LOS_ERRNO_TSK_NO_MEMORY 0x03000200 内存空间不足 分配更大的内存分区
    2 LOS_ERRNO_TSK_PTR_NULL 0x02000201 任务参数为空 检查任务参数
    3 LOS_ERRNO_TSK_STKSZ_NOT_ALIGN 0x02000202 任务栈大小未对齐 对齐任务栈
    4 LOS_ERRNO_TSK_PRIOR_ERROR 0x02000203 不正确的任务优先级 检查任务优先级
    5 LOS_ERRNO_TSK_ENTRY_NULL 0x02000204 任务入口函数为空 定义任务入口函数
    6 LOS_ERRNO_TSK_NAME_EMPTY 0x02000205 任务名为空 设置任务名
    7 LOS_ERRNO_TSK_STKSZ_TOO_SMALL 0x02000206 任务栈太小 扩大任务栈
    8 LOS_ERRNO_TSK_ID_INVALID 0x02000207 无效的任务ID 检查任务ID
    9 LOS_ERRNO_TSK_ALREADY_SUSPENDED 0x02000208 任务已经被挂起 等待这个任务被恢复后，再去尝试挂起这个任务
    10 LOS_ERRNO_TSK_NOT_SUSPENDED 0x02000209 任务未被挂起 挂起这个任务
    11 LOS_ERRNO_TSK_NOT_CREATED 0x0200020a 任务未被创建 创建这个任务
    12 LOS_ERRNO_TSK_OPERATE_SWTMR 0x02000222 不允许操作软件定时器任务 用户不要试图去操作软件定时器任务的设置
    13 LOS_ERRNO_TSK_MSG_NONZERO 0x0200020c 任务信息非零 暂不使用该错误码
    14 LOS_ERRNO_TSK_DELAY_IN_INT 0x0300020d 中断期间，进行任务延时 等待退出中断后再进行延时操作
    15 LOS_ERRNO_TSK_DELAY_IN_LOCK 0x0200020e 任务被锁的状态下，进行延时 等待解锁任务之后再进行延时操作
    16 LOS_ERRNO_TSK_YIELD_INVALID_TASK 0x0200020f 将被排入行程的任务是无效的 检查这个任务
    17 LOS_ERRNO_TSK_YIELD_NOT_ENOUGH_TASK 0x02000210 没有或者仅有一个可用任务能进行行程安排 增加任务数
    18 LOS_ERRNO_TSK_TCB_UNAVAILABLE 0x02000211 没有空闲的任务控制块可用 增加任务控制块数量
    19 LOS_ERRNO_TSK_HOOK_NOT_MATCH 0x02000212 任务的钩子函数不匹配 暂不使用该错误码
    20 LOS_ERRNO_TSK_HOOK_IS_FULL 0x02000213 任务的钩子函数数量超过界限 暂不使用该错误码
    21 LOS_ERRNO_TSK_OPERATE_IDLE 0x02000214 这是个IDLE任务 检查任务ID，不要试图操作IDLE任务
    22 LOS_ERRNO_TSK_SUSPEND_LOCKED 0x03000215 将被挂起的任务处于被锁状态 等待任务解锁后再尝试挂起任务
    23 LOS_ERRNO_TSK_FREE_STACK_FAILED 0x02000217 任务栈free失败 该错误码暂不使用
    24 LOS_ERRNO_TSK_STKAREA_TOO_SMALL 0x02000218 任务栈区域太小 该错误码暂不使用
    25 LOS_ERRNO_TSK_ACTIVE_FAILED 0x03000219 任务触发失败 创建一个IDLE任务后执行任务转换
    26 LOS_ERRNO_TSK_CONFIG_TOO_MANY 0x0200021a 过多的任务配置项 该错误码暂不使用
    27 LOS_ERRNO_TSK_CP_SAVE_AREA_NOT_ALIGN 0x0200021b 暂无 该错误码暂不使用
    28 LOS_ERRNO_TSK_MSG_Q_TOO_MANY 0x0200021d 暂无 该错误码暂不使用
    29 LOS_ERRNO_TSK_CP_SAVE_AREA_NULL 0x0200021e 暂无 该错误码暂不使用
    30 LOS_ERRNO_TSK_SELF_DELETE_ERR 0x0200021f 暂无 该错误码暂不使用
    31 LOS_ERRNO_TSK_STKSZ_TOO_LARGE 0x02000220 任务栈大小设置过大 减小任务栈大小
    32 LOS_ERRNO_TSK_SUSPEND_SWTMR_NOT_ALLOWED 0x02000221 不允许挂起软件定时器任务 检查任务ID, 不要试图挂起软件定时器任务

    错误码定义： 错误码是一个32位的存储单元，31~24位表示错误等级，23~16位表示错误码标志，15~8位代表错误码所属模块，7~0位表示错误码序号，如下

    例如：

    4.1.任务 - 图1
    错误码序号 0x16、0x1c、0x0b，未被定义，不可用。

    平台差异性

    无。

    • 创建新任务时，会对之前自删除任务的任务控制块和任务栈进行回收，非自删除任务的控制块和栈在任务删除的时候已经回收。

    • 任务名是指针没有分配空间，在设置任务名时，禁止将局部变量的地址赋值给任务名指针。

    • 任务栈的大小按8字节大小对齐。确定任务栈大小的原则是，够用就行：多了浪费，少了任务栈溢出。

    • 挂起任务的时候若为当前任务且已锁任务，则不能被挂起。

    • 空闲（IDLE）任务及软件定时器任务不能被挂起或者删除。

    • 在中断处理函数中或者在锁任务的情况下，执行LOS_TaskDelay操作会失败。

    • 锁任务调度，并不关中断，因此任务仍可被中断打断。

    • 锁任务调度必须和解锁任务调度配合使用。

    • 设置任务优先级的时候可能会发生任务调度。

    • 除去空闲（IDLE）任务以外，系统可配置的任务资源个数是指：整个系统的任务资源总个数，而非用户能使用的任务资源个数。例如：系统软件定时器多占用一个任务资源数，那么系统可配置的任务资源就会减少一个。

    • 为了防止系统出现问题，系统禁止对软件定时器任务优先级进行修改。

    • LOS_CurTaskPriSet和LOS_TaskPriSet接口不能在中断中使用。

    • LOS_TaskPriGet接口传入的task ID对应的任务未创建或者超过最大任务数，统一返回0xffff。

    • 在删除任务时要保证任务申请的资源（如互斥锁、信号量等）已被释放。

    实例描述

    下面的示例介绍任务的基本操作方法，包含任务创建、任务延时、任务锁与解锁调度、挂起和恢复、查询当前任务PID、根据PID查询任务信息等操作，阐述任务优先级调度的机制以及各接口的应用。

    1. 创建了2个任务:TaskHi和TaskLo。

    2. TaskHi为高优先级任务。

    编程示例

    结果验证

    编译运行得到的结果为：