uCOS-II 常用函数参考手册
任务管理
1 OSTaskCreate()
建立一个新任务。任务的建立可以在多任务环境启动之前，也可以在正在运行的任务
中建立。中断处理程序中不能建立任务。一个任务可以为无限循环的结构。
函数原型：INT8U OSTaskCreate(void (*task)(void *pd), void *pdata, OS_STK *ptos, INT8U prio);
参数说明：task 是指向任务代码首地址的指针。
pdata 指向一个数据结构，该结构用来在建立任务时向任务传递参数。
ptos is a pointer to the task's top of stack. If the configuration constant OS_STK_GROWTH is
set to 1, the stack is assumed to grow downward (i.e. from high memory to low memory). 'pstk'
will thus point to the highest (valid) memory location of the stack. If OS_STK_GROWTH is set to 0,
'pstk' will point to the lowest memory location of the stack and the stack will grow with
increasing memory locations.
prio is the task's priority. A unique priority MUST be assigned to each task and the lower the
number, the higher the priority.
返回值：
OSTaskCreate() 的返回值为下述之一：
* OS_NO_ERR：函数调用成功。
* OS_PRIO_EXIST：具有该优先级的任务已经存在。
* OS_PRIO_INVALID：参数指定的优先级大于 OS_LOWEST_PRIO。
* OS_NO_MORE_TCB：系统中没有 OS_TCB 可以分配给任务了。
2 OSTaskSuspend()
无条件挂起一个任务。调用此函数的任务也可以传递参数 OS_PRIO_SELF，挂起调用任
务本身。当前任务挂起后，只有其他任务才能唤醒被挂起的任务。任务挂起后，系统会重新
进行任务调度， 运 行 下一个优先 级最高的就绪 任 务 。 唤 醒挂起任务需 要 调 用 函 数
OSTaskResume()。
任务的挂起是可以叠加到其他操作上的。例如，任务被挂起时正在进行延时操作，那
么任务的唤醒就需要两个条件：延时的结束以及其他任务的唤醒操作。又如，任务被挂起时
正在等待信号量，当任务从信号量的等待对列中清除后也不能立即运行，而必须等到被唤醒
后。
函数原型：INT8U OSTaskSuspend(INT8U prio);
参数说明：prio 为指定要获取挂起的任务优先级，也可以指定参数 OS_PRIO_SELF，挂起任
务本身。此时，下一个优先级最高的就绪任务将运行。
返回值：
OSTaskSuspend() 的返回值为下述之一：
* OS_NO_ERR：函数调用成功。
* OS_TASK_SUSPEND_IDLE：试图挂起μ C/OS-II 中的空闲任务（Idle task）。此为非法操作。
* OS_PRIO_INVALID：参数指定的优先级大于 OS_LOWEST_PRIO 或没有设定 OS_PRIO_SELF
的值。
* OS_TASK_SUSPEND_PRIO：要挂起的任务不存在。
剩余17页未读，继续阅读
评论0