18 KiB
任务管理
任务机制
任务(task)是XiUOS中处理器使用权分配的最小单位。每个任务有自己的程序栈与寄存器上下文,在多处理器平台上可以互不干扰地同时运行,但单个处理器上任意时刻只能有一个任务在运行。用户可以使用XiUOS提供的接口创建任意数量的任务。内核会对系统中的所有任务按照一定策略(抢占式优先级或先来先服务)进行调度,以最大限度地利用处理器资源。用户可以使用XiUOS提供的接口创建任意数量的任务。
任务状态
系统中的任务在任意时刻都处于就绪(ready)、运行(running)、阻塞/挂起(suspend)、退出(quit)四种状态之一。状态之间的变化关系如下图所示。

任务在创建完成后会进入就绪状态并被加入就绪队列等待内核调度。当任务被调度开始运行时,任务会进入运行状态。若任务在运行过程中被更高优先级的任务抢占,则被抢占的任务会回到就绪队列并再次进入就绪状态。当任务在运行过程中申请资源失败时,任务会被挂起并进入挂起状态,并在所申请资源能够被满足时回到就绪状态。当任务执行完成,即从入口函数返回时,会进入终止状态,并由内核回收其相关资源。
任务调度
任务调度即从系统就绪队列中按一定策略选择任务,使其进入运行状态的过程。XiUOS支持以下调度方式:
- 抢占式优先级调度:在创建任务时可以指定任务的优先级,内核总是选取就绪队列中优先级最高的任务。当新创建的任务优先级高于正在运行的任务的优先级时,当前运行的任务会被抢占。若就绪队列中最高优先级任务有多个,则这些任务会按时间片轮转交替运行。
- 先来先服务(FIFO)调度:任务按照被创建的顺序依次被执行。当一个任务运行完成后,系统才会让下一个任务开始运行。
- 时间片轮转(RR)调度:任务按照分配的时间片执行,时间片结束,调度一个新的就绪任务执行,当前任务重新就绪,等待下一次的调度。
任务结构定义
每个任务在内核中由一个task_descriptor结构表示,二者一一对应。
struct task_descriptor
{
void *stack_pointer;
struct dync_sched_member dync_sched_member_x;
struct t_baseinfo t_baseinfo_x;
#ifdef XS_USING_SMP
struct smp_info smp_info_x;
#endif
#if defined(XS_USING_EVENT)
xs_uint32 event_ctrl1:3;
xs_uint32 event_ctrl2:29;
#endif
xs_err_t error;
XS_DOUBLE_LINKLIST link;
};
其中stack_pointer成员表示该任务的栈的起始地址,dync_sched_member_x成员包含与任务调度相关的信息,t_baseinfo_x包含任务的基本信息,smp_info_x包含与多处理器相关的信息,event_ctrl1/event_ctrl2用于实现事件集机制(见任务间通信部分文档),error为任务调用内核接口时最近的错误码,link用于将系统中的所有任务组织成一个双链表。各复合成员的详细定义如下:
struct task_baseinfo {
char name[XS_NAME_MAX];
void *func_entry;
void *func_param;
xs_uint32 stack_size;
xs_uint8 origin_prio;
};
struct task_baseinfo结构记录了任务的基本属性,包括任务的名称(name)、入口函数和参数(func_entry、func_param)、栈大小(stack_size)、优先级(origin_prio)。
struct dync_sched_member {
xs_uint8 stat;
xs_uint8 advance_cnt;
xs_uint8 cur_prio;
xs_ubase origin_timeslice;
xs_ubase rest_timeslice;
#ifdef XS_USING_TASK_ISOLATION
xs_uint8 isolation_flag;
void *isolation;
#endif
union {
XS_DOUBLE_LINKLIST sched_link;
XS_AVL sched_avl;
}
XS_DOUBLE_LINKLIST pend_link;
xs_Timer_t task_timer;
};
#define XS_SUSPEND ((1) << (0))
#define XS_READY ((1) << (1))
#define XS_RUNNING ((1) << (2))
#define XS_QUIT ((1) << (3))
struct dync_sched_member结构的成员用于记录与调度相关的信息。stat表示任务的当前状态,可以为挂起(XS_SUSPEND)、就绪(XS_READY)、运行(XS_RUNNING)或退出(XS_QUIT)。advance_cnt表示在配置成短作业预先调度时优先处理的时间片周期个数。cur_prio表示任务当前的优先级:为防止出现优先级反转,该优先级可以高于任务创建时配置的优先级。origin_timeslice表示在时间片轮转调度中该任务每次运行的时间片。地址空间隔离信息(isolation_flag变量和指针isolation)。sched_link、sched_avl构成的联合体为就绪队列节点,XiUOS中就绪队列可以配置为双链表(sched_link)或AVL树(sched_avl)。pend_link为任务挂起时使用的等待队列节点。task_timer用于任务睡眠的计时。
struct smp_info {
xs_uint8 combined_coreid;
xs_uint8 running_coreid;
};
struct smp_info结构包含多处理器相关的信息,其成员分别表示该任务绑定的CPU ID与正在运行的CPU ID。
任务函数接口
struct xs_utask
{
char name[XS_NAME_MAX];
void *func_entry;
void *func_param;
xs_uint32 stack_size;
xs_uint8 prio;
};
typedef struct xs_utask struct xs_utask;
struct task_descriptor* xs_UserTaskCreate(xs_utask_x task);
该函数用于用户态创建一个任务。任务的各个属性由一个struct xs_utask结构表示,包括任务的名称、入口函数及参数、栈大小和优先级,在调用该函数时需要传入该结构的实例用于配置任务。任务创建成功后,内核会为其分配指定大小的栈及其他结构(如struct task_descriptor)结构,并返回任务描述符指针。
参数 | 描述 |
---|---|
task | 任务配置属性 |
xs_int32 xs_UserTaskDelete(struct task_descriptor task);
该函数用于删除一个任务,强制使其进入退出状态。若删除成功则返回XS_EOK,若失败则返回-XS_ERROR。
参数 | 描述 |
---|---|
task | 待删除的任务描述符 |
xs_int32 xs_UserTaskCoreCombine(struct task_descriptor task, xs_uint8 coreid);
该函数用于将任务绑定至指定的处理器上。若绑定成功则返回XS_EOK,若失败则返回-XS_ERROR。
参数 | 描述 |
---|---|
task_id | 待绑定的任务描述符 |
coreid | 带绑定的处理器ID |
xs_int32 xs_UserTaskCoreUncombine(struct task_descriptor task);
该函数用于解除任务与处理器的绑定。若解除成功则返回XS_EOK,若失败则返回-XS_ERROR。
参数 | 描述 |
---|---|
task | 待解除绑定的任务描述符 |
xs_int32 xs_UserTaskDelay(xs_ticks_x ticks);
该函数用于将当前任务挂起一定时间,单位为tick。挂起时间结束后,任务会进入就绪状态,可以继续被调度。
参数 | 描述 |
---|---|
ticks | 任务挂起时间,单位为tick |
struct task_descriptor* xs_UserTaskSearch(char *name)
该函数用于从任务名称获取任务描述符。
参数 | 描述 |
---|---|
name | 任务名称 |
任务通信
XiUOS提供多种任务间通信机制,包括消息队列、信号量、互斥量与事件集。
消息队列
消息队列(message queue)提供可供多个任务读或写的消息缓冲区,其中消息指固定长度的任意数据块。消息队列的容量有限。当消息队列满时,向消息队列写入的任务会被挂起;当消息队列空时,从消息队列读取的任务会被挂起。
消息队列结构定义
struct xs_MsgQueue
{
xs_uint16 id;
void *msg_buf;
xs_uint16 index;
xs_uint16 num_msgs;
xs_uint16 each_len;
xs_uint16 max_msgs;
XS_DOUBLE_LINKLIST send_pend_list;
XS_DOUBLE_LINKLIST recv_pend_list;
XS_DOUBLE_LINKLIST link;
};
成员 | 描述 |
---|---|
id | 消息队列ID,用于唯一标识一个消息队列 |
msg_buf | 用于存储消息的缓冲区的首地址 |
index | 当前缓冲区中第一个消息的序号 |
num_msgs | 当前缓冲区中的消息数量 |
each_len | 每条消息的大小,单位为字节 |
max_msgs | 缓冲区中最多能存放的消息数量 |
send_pend_list | 被挂起的发送任务链表 |
recv_pend_list | 被挂起的接收任务链表 |
link | 系统中所有消息队列构成的链表 |
消息队列函数接口
xs_int32 xs_UserMsgQueueCreate(xs_uint16 msg_len, xs_uint16 max_msgs);
该函数用于创建一个消息队列。创建成功后,新的消息队列会被加入内核的消息队列管理链表,并返回该消息队列的ID,ID默认范围0-255,可配置。
参数 | 描述 |
---|---|
msg_len | 每条消息的长度,单位为字节 |
max_msgs | 缓冲区中最多存放的消息数量 |
void xs_UserMsgQueueDelete(xs_uint16 id);
该函数用于删除一个已创建的消息队列。
参数 | 描述 |
---|---|
id | 待删除的消息队列ID |
xs_int32 xs_UserMsgQueueSend(xs_uint16 id, const void *msg, xs_uint16 size, xs_ticks_x wait_time);
该函数用于向消息队列发送一个消息。若消息发送成功则返回XS_EOK,若不成功(等待超时)则返回-XS_ETIMEOUT。
参数 | 描述 |
---|---|
id | 目标消息队列ID |
msg | 消息数据首地址 |
size | 消息长度 |
wait_time | 等待时间上限,单位ticks;若为0,则不等待 |
xs_int32 xs_UserMsgQueueRecv(xs_uint16 id, void *buf, xs_uint16 size, xs_ticks_x wait_time);
该函数用于从消息队列接收一个消息。若消息接收成功则返回XS_EOK,若不成功(等待超时)则返回-XS_ETIMEOUT。
参数 | 描述 |
---|---|
id | 来源消息队列ID |
buf | 用于接收消息数据的缓冲区 |
size | 缓冲区大小 |
wait_time | 等待时间上限,单位ticks;若为0,则不等待 |
xs_int32 xs_UserMsgQueueReinit(xs_uint16 id);
该函数用于将一个消息队列复位。
参数 | 描述 |
---|---|
id | 来源消息队列ID |
信号量
信号量(semaphore)具有一个给定的初值。任务可以获取或释放一个信号量。当任务获取信号量时信号量的值递减,释放信号量时值递增。当信号量值递减至0时,后续尝试获取信号量的任务会被挂起。每当一个已获取信号量的任务释放信号量时,内核会从信号量挂起队列上唤醒一个任务。信号量可以用于实现任务间的同步与互斥。
信号量结构定义
struct xs_Semaphore
{
xs_uint16 id;
xs_uint16 value;
XS_DOUBLE_LINKLIST pend_list;
XS_DOUBLE_LINKLIST link;
};
成员 | 描述 |
---|---|
id | 信号量ID,用于唯一标识一个信号量 |
value | 信号量的当前值 |
pend_link | 挂起任务链表 |
link | 系统中所有信号量构成的链表 |
信号量函数接口
xs_int32 xs_UserSemaphoreCreate(xs_uint16 val);
该函数用于创建一个信号量。创建成功后,新的信号量会被加入内核的信号量管理链表,并返回该信号量的ID,ID默认范围0-255,可配置。
参数 | 描述 |
---|---|
val | 信号量的初值 |
void xs_UserSemaphoreDelete(xs_uint16 id);
该函数用于删除一个已创建的信号量。
参数 | 描述 |
---|---|
id | 待删除的信号量的ID |
xs_int32 xs_UserSemaphoreObtain(xs_uint16 id, xs_ticks_x wait_time);
该函数用于获取一个信号量。若获取成功则返回XS_EOK,若不成功(等待超时)则返回-XS_ETIMEOUT。
参数 | 描述 |
---|---|
id | 欲获取的信号量的ID |
wait_time | 等待时间上限,单位ticks;若为0,则不等待 |
xs_int32 xs_UserSemaphoreAbandon(xs_uint16 id);
该函数用于释放一个信号量。
参数 | 描述 |
---|---|
id | 待释放的信号量的ID |
xs_int32 xs_UserSemaphoreSetValue(xs_uint16 id, xs_uint16 val);
该函数用于将一个信号量的值进行重置。
参数 | 描述 |
---|---|
id | 来源消息队列ID |
val | 重置的信号量的值 |
互斥量
互斥量(mutex)可以视作一个初值为1的信号量,同样有获取和释放操作。互斥量一般用于任务间的互斥。
互斥量结构定义
struct xs_Mutex
{
xs_uint16 id;
xs_uint8 origin_prio;
xs_uint8 recursive_cnt;
struct task_descriptor *holder;
XS_DOUBLE_LINKLIST pend_list;
XS_DOUBLE_LINKLIST link;
};
成员 | 描述 |
---|---|
id | 互斥量ID,用于唯一标识一个互斥量 |
origin_prio | 持有互斥量的任务的原优先级,用于避免优先级反转 |
recursive_cnt | 持有互斥量的任务获取互斥量的次数,用于实现递归锁 |
holder | 持有互斥量的任务 |
pend_list | 挂起任务链表 |
link | 系统中所有互斥量构成的链表 |
互斥量函数接口
xs_int32 xs_UserMutexCreate(void);
该函数用于创建一个互斥量。创建成功后,新的互斥量会被加入内核的互斥量管理链表,并返回该互斥量的ID,ID默认范围0-255,可配置。
void xs_UserMutexDelete(xs_uint16 id);
该函数用于删除一个已创建的互斥量。
参数 | 描述 |
---|---|
id | 待删除的互斥量的ID |
xs_int32 xs_UserMutexObtain(xs_uint16 id, xs_ticks_x wait_time);
该函数用于获取一个互斥量。若获取成功则返回XS_EOK,若不成功(等待超时)则返回-XS_ETIMEOUT。
参数 | 描述 |
---|---|
id | 欲获取的互斥量的ID |
wait_time | 等待时间上限,单位ticks;若为0,则不等待 |
xs_int32 xs_UserMutexAbandon(xs_uint16 id);
该函数用于释放一个互斥量。
参数 | 描述 |
---|---|
id | 待释放的互斥量的ID |
事件集
事件集(event set)允许用户定义一个事件集合,集合中的每个事件都可以被任务触发或等待。任务可以同时等待多个事件,此时等待触发的条件可以配置为AND或者OR:当等待触发条件配置为AND时,只有所有被等待的事件均被触发才视作等待结束;当等待触发条件配置为OR时,任意一个被等待的事件触发即视作等待结束。使用事件集可以实现多对多的任务间同步与互斥。
事件集结构定义
#define XS_EVENT_AND (1 << 29)
#define XS_EVENT_OR (1 << 30)
#define XS_EVENT_AUTOCLEAN (1 << 31)
#define XS_EVENTS(x) (1 << x)
struct xs_event
{
xs_uint16 id;
xs_uint32 trigge_way;
XS_DOUBLE_LINKLIST pend_list;
XS_DOUBLE_LINKLIST link;
};
成员 | 描述 |
---|---|
id | 事件集ID,用于唯一标识一个事件集 |
trigge_way | 高3位用于记录事件集属性(等待触发条件、是否自动清空),低29位用于表示至多29个事件 |
pend_list | 等待任务链表 |
link | 系统中所有事件集构成的链表 |
事件集函数接口
xs_int32 xs_UserEventCreate(xs_uint32 options);
该函数用于创建一个事件集。options参数用于配置事件集的属性。可配置的属性有等待触发方式(XS_EVENT_AND或XS_EVENT_OR)及等待触发后是否自动清空其他已触发的事件(XS_EVENT_AUTOCLEAN)。创建成功后,新的事件集会被加入内核的事件集管理链表,并返回该事件集的ID,ID默认范围0-255,可配置。
参数 | 描述 |
---|---|
options | 事件集配置选项,须在XS_EVENT_AND及XS_EVENT_OR中指定其一,并可以按位或上XS_EVENT_AUTOCLEAN |
void xs_UserEventDele(xs_uint16 id);
该函数用于删除一个已创建的事件集。
参数 | 描述 |
---|---|
id | 待删除的事件集的ID |
xs_int32 xs_UserEventTrigger(xs_uint16 id, xs_uint32 events);
该函数用于触发事件集中的一组事件。
参数 | 描述 |
---|---|
id | 事件集ID |
events | 欲触发的事件,其中被置1的位标识被触发的事件 ,可以使用XS_EVENTS宏按位或发送事件类型 |
xs_int32 xs_UserEventProcess(xs_uint16 id, xs_uint32 events, xs_ticks_x wait_time);
该函数用于等待事件集中的一组事件。若等待成功则返回XS_EOK,此时若XS_EVENT_AUTOCLEAN被打开则事件集中所有已触发事件会被清空;若等待失败(超时)则返回-XS_ETIMEOUT。
参数 | 描述 |
---|---|
id | 事件集ID |
events | 欲等待的事件,其中被置1的位标识被等待的事件,可以使用XS_EVENTS宏按位或接收事件类型 |
wait_time | 等待时间上限,单位ticks;若为0,则不等待 |
xs_int32 xs_UserEventConfig(xs_uint16 id, xs_uint32 options);
该函数用于配置事件集中的一种事件类型。若等配置成功则返回XS_EOK,options参数用于配置事件集的属性。可配置的属性有等待触发方式(XS_EVENT_AND或XS_EVENT_OR)及等待触发后是否自动清空其他已触发的事件(XS_EVENT_AUTOCLEAN)。
参数 | 描述 |
---|---|
id | 事件集ID |
options | 事件集配置选项,须在XS_EVENT_AND及XS_EVENT_OR中指定其一,并可以按位或上XS_EVENT_AUTOCLEAN |
xs_int32 xs_UserEventReinit(xs_uint16 id);
该函数用于将一个事件的值进行重置。
参数 | 描述 |
---|---|
id | 来源消息队列ID |
使用场景
- 在多处理器设备上,多个任务可以并行运行,从而提高处理器的利用率。
- 在一些中断驱动的应用中,如果中断需要处理的工作过于复杂,则可以创建一个任务专门用于处理相关工作,从而改善中断延迟。