UCOS-II_API_参考手册

《UCOS-II_API_参考手册》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、UCOS-IIAPI参考手册本章提供了μC/OS-Ⅱ的用户指南。每一个用户可以调用的内核函数都按字母顺序加以说明，包括：函数的功能描述函数原型函数名称及源代码函数使用到的常量函数参数函数返回值特殊说明和注意点OSInit()VoidOSInit(void);所属文件调用者开关量OS_CORE.C启动代码无OSinit（）初始化μC/OS-Ⅱ，对这个函数的调用必须在调用OSStart（）函数之前，而OSStart（）函数真正开始运行多任务。参数无返回值无注意/警告必须先于OSStart（）函数的调用范例：voidmain(void){.OSInit();/*初始化uC/OS-II

2、*/.OSStart();/*启动多任务内核*/}μC/OS-II:实时操作系统内核OSIntEnter()VoidOSIntEnter（void）;所属文件调用者开关量OS_CORE.C中断无OSIntEnter（）通知μC/OS-Ⅱ一个中断处理函数正在执行，这有助于μC/OS-Ⅱ掌握中断嵌套的情况。OSIntEnter（）函数通常和OSIntExit（）函数联合使用。参数无返回值无注意/警告在任务级不能调用该函数。如果系统使用的处理器能够执行自动的独立执行读取-修改-写入的操作，那么就可以直接递增中断嵌套层数（OSIntNesting），这样可以避免调用函数所带来的额外的开销。范例一：（

3、Intel80x86的实模式,在大模式下编译，，realmode，largemodel）ISRxPROCFARPUSHA;保存中断现场PUSHESPUSHDS;MOVAX,DGROUP;读入数据段MOVDS,AX;CALLFARPTR_OSIntEnter;通知内核进入中断..POPDS;恢复中断现场POPESPOPAIRET;中断返回ISRxENDP范例二：（Intel80x86的实模式,在大模式下编译，,realmode,largemodel）参考手册ISRxPROCFARPUSHA;保存中断现场PUSHESPUSHDS;MOVAX,DGROUP;读入数据段MOVDS,AX;INCBYT

4、EPTR_OSIntNesting;通知内核进入中断...POPDS;恢复中断现场POPESPOPAIRET;中断返回ISRxENDPμC/OS-II:实时操作系统内核OSIntExit()VoidOSIntExit（void）;所属文件调用者开关量OS_CORE.C中断无OSIntExit（）通知μC/OS-Ⅱ一个中断服务已执行完毕，这有助于μC/OS-Ⅱ掌握中断嵌套的情况。通常OSIntExit（）和OSIntEnter（）联合使用。当最后一层嵌套的中断执行完毕后，如果有更高优先级的任务准备就绪，μC/OS-Ⅱ会调用任务调度函数，在这种情况下，中断返回到更高优先级的任务而不是被中断了的任

5、务。参数无返回值无注意/警告在任务级不能调用该函数。并且即使没有调用OSIntEnter（）而是使用直接递增OSIntNesting的方法，也必须调用OSIntExit（）函数。范例：（Intel80x86的实模式,在大模式下编译，realmode,largemodel）ISRxPROCFARPUSHA;保存中断现场PUSHESPUSHDS..CALLFARPTR_OSIntExit;通知内核进入中断POPDS;恢复中断现场POPESPOPAIRET;中断返回ISRxENDP参考手册OSMboxAccept()Void*OSMboxAccept（OS_EVENT*pevent）;所属文件调用

6、者开关量OS_MBOX.C任务或中断OS_MBOX_ENOSMboxAccept（）函数查看指定的消息邮箱是否有需要的消息。不同于OSMboxPend（）函数，如果没有需要的消息，OSMboxAccept（）函数并不挂起任务。如果消息已经到达，该消息被传递到用户任务并且从消息邮箱中清除。通常中断调用该函数，因为中断不允许挂起等待消息。参数pevent是指向需要查看的消息邮箱的指针。当建立消息邮箱时，该指针返回到用户程序。（参考OSMboxCreate（）函数）。返回值如果消息已经到达，返回指向该消息的指针；如果消息邮箱没有消息，返回空指针。注意/警告必须先建立消息邮箱，然后使用。范例：OS_

7、EVENT*CommMbox;voidTask(void*pdata){void*msg;pdata=pdata;for(;;){msg=OSMboxAccept(CommMbox);/*检查消息邮箱是否有消息*/if(msg!=(void*)0){./*处理消息*/.}else{./*没有消息*/.}..μC/OS-II:实时操作系统内核}}参考手册OSMboxCreate()OS_EVENT*OSMbox