常用函数手册20151106讲解.docVIP

常用函数手任务管理 1 OSTaskCreate() 建立一个新任务。任务的建立可以在多任务环境启动之前，也可以在正在运行的任务中建立。中断处理程序中不能建立任务。一个任务可以为无限循环的结构。 函数原型：INT8U OSTaskCreate(void (*task)(void *pd), void *pdata, OS_STK *ptos, INT8U prio); 参数说明：task 是指向任务代码首地址的指针。 pdata 指向一个数据结构，该结构用来在建立任务时向任务传递参数。 ptos is a pointer to the tasks 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 tasks 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：要挂起的任务不存在。 3 OSTaskResume() 唤醒一个用 OSTaskSuspend() 函数挂起的任务。OSTaskResume() 也是唯一能“解挂”挂起任务的函数。 函数原型：INT8U OSTaskResume(INT8U prio); 参数说明：prio指定要唤醒任务的优先级。 返回值： OSTaskResume() 的返回值为下述之一： * OS_NO_ERR：函数调用成功。 * OS_TASK_RESUME_PRIO：要唤醒的任务不存在。 * OS_TASK_NOT_SUSPENDED：要唤醒的任务不在挂起状态。 * OS_PRIO_INVALID：参数指定的优先级大于或等于OS_LOWEST_PRIO。 信号量 1 OSSemCreate() 该函数建立并初始化一个信号量，信号量的作用如下： * 允许一个任务和其他任务或者中断同步 * 取得设备的使用权 * 标志事件的发生 函数原型：OS_EVENT *OSSemCreate(INT16U value); 参数说明：value 参数是所建立的信