μCOS-Ⅱ的用户指南用户指南.pdfVIP

参考手册 本章提供了μ C/OS- Ⅱ的用户指南。每一个用户可以调用的内核函数都按字母顺 序加 以说明，包括： z 函数的功能描述 z 函数原型 z 函数名称及源代码 z 函数使用到的常量 z 函数参数 z 函数返回值 z 特殊说明和注意点 OSInit() VoidOSInit(void); 所属文件调用者开关量 启动代码无 OSinit （）初始化μ C/OS- Ⅱ，对这个函数的调用必须在调用 OSStart （）函数 之前，而 OSStart （）函数真正开始运行多任务。 注意 / 警告 必须先于 OSStart （）函数的调用 OSIntEnter() VoidOSIntEnter （void ）; 所属文件调用者开关量 中断无 OSIntEnter （）通知μC/OS- Ⅱ一个中断处理函数正在执行，这有助于μ C/OS- Ⅱ掌握中断嵌套的情况。 OSIntEnter （）函数通常和 OSIntExit （）函数联合使 用。 注意 / 警告 在任务级不能调用该函数。 如果系统使用的处理器能够执行自动的独立执行读取 - 修改 - 写入的操作，那么 就可以直接递增中 断嵌套层数（ OSIntNesting ），这样可以避免调用函数所带来的额外的开销。 OSIntExit() voidOSIntExit （void ）; 所属文件调用者开关量 中断无 OSIntExit （）通知μC/OS- Ⅱ一个中断服务已执行完毕，这有助于μ C/OS- Ⅱ掌 握中断嵌套的情况。通常 OSIntExit （）和 OSIntEnter （）联合使用。当最后 一层嵌套的中断执行完毕后，如果有更高优先级的任务准备就绪，μ C/OS- Ⅱ会 调用任务调度函数，在这种情况下，中断返回到更高优先级的任务而不是被中 断了的任务。 注意 / 警告 在任务级不能调用该函数。并且即使没有调用 OSIntEnter （）而是使用直接递 增 OSIntNesting 的方法，也必须调用 OSIntExit （）函数。 OSMboxAccept() Void*OSMboxAccept （OS_EVENT*pevent）; 所属文件调用者开关量 任务或中断 OS_MBOX_EN OSMboxAccept （） 函 数 查 看 指 定 的 消 息 邮 箱 是 否 有 需 要 的 消 息 。 不 同 于 OSMboxPend（）函数，如果没有需要的消息， OSMboxAccept （）函数并不挂起 任务。如果消息已经到达，该消息被传递到用户任务并且从消息邮箱中清除。 通常中断调用该函数，因为中断不允许挂起等待消息。 参数 pevent 是指向需要查看的消息邮箱的指针。当建立消息邮箱时，该指针返回到 用户程序。 （参考OSMboxCreate （）函数）。 返回值 如果消息已经到达，返回指向该消息的指针；如果消息邮箱没有消息，返回空 指针。 注意 / 警告 必须先建立消息邮箱，然后使用。 OSMboxCreate() OS_EVENT*OSMboxCreate（void*msg ）; 所属文件调用者开关量 任务或启动代码 OS_MBOX_EN OSMboxCreate （）建立并初始化一个消息邮箱。消息邮箱允许任务或中断向其 他一个或几个任 务发送消息。 参数 msg参数用来初始化建立的消息邮箱。 如果该指针不为空， 建立的消息邮箱将含 有消息。 OSMboxPend() Void*OSMboxPend(OS_EVNNT*pevent,INT16Utimeout,int8u*err); 所属文件调用者开关量 任务 OS_MBOX_EN OSMboxPend（）用于任务等待消息。消息通过中断或另外的任务发送给需要的 任务。消息是一个以指针定义的变量，