嵌入式常用函数手册.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)