OS_SEM信号量源码注释.doc

1 /* 2 ************************************************************************************* 3 * uC/OS-II实时控制内核 4 * 主要的包含文件 5 * 信号量程序函数 6 * 7 * 文 件: OS_SEM.C 信号量程序函数 8 * 作 者: Jean J. Labrosse 9 * 中文注解: 钟常慰 zhongcw @ 126.com 译注版本：1.0 请尊重原版内容 10 ************************************************************************************* 11 */ 12 13 #ifndef OS_MASTER_FILE //是否已定义OS_MASTER_FILE主文件 14 #include includes.h //包含includes.h文件，部分C语言头文件的汇总打包文件 15 #endif //定义结束 16 17 #if OS_SEM_EN 0 //条件编译：当OS_SEM_EN允许产生信号量程序代码 18 /* 19 ************************************************************************************* 20 * 无条件地等待请求一个信号量 21 * 22 * 描述: 该函数是查看资源是否使用或事件是否发生。中断调用该函数查询信号量。 23 * 不同于OSSemPend()函数，如果资源不可使用，OSSemAccept()函数并不挂起任务。 24 25 * 参数: pevent 指向需要保护地共享资源地信号量。当建立信号量时，用户得到该指针 26 * 27 * 返回: 当调用OSSemAccept()函数时； 28 共享资源信号量的值 0，则说明共享资源可以使用，这个值被返回调用者，信号量的值减1； 29 共享资源信号量的值 = 0，则说明资源不能使用，返回0。 30 ************************************************************************************* 31 */ 32 33 #if OS_SEM_ACCEPT_EN 0 //允许生成 OSSemAccept()函数 34 INT16U OSSemAccept (OS_EVENT *pevent) //无条件地等待请求一个信号量函数 35 { 36 #if OS_CRITICAL_METHOD == 3 //中断函数被设定为模式3 37 OS_CPU_SR cpu_sr; 38 #endif 39 INT16U cnt; //信号量的内容暂时存储变量 40 41 42 #if OS_ARG_CHK_EN 0 //所有参数必须在指定的参数内 43 if (pevent == (OS_EVENT *)0) { //当信号量指针为NULL时，返回0，空指针 44 return (0); 45 } 46 if (pevent-OSEventType != OS_EVENT_TYPE_SEM) { //当事件类型≠信号量类型 47 return (0); //返回0 48 } 49 #endif 50 OS_ENTER_CRITICAL(); //关闭中断 51 cnt = pevent-OSEventCnt; //取信号值 52 if (cnt 0) { //当信号值0时，该值有效 53 pevent-OSEventCnt--; //信号量减1 54 } 55 OS_EXIT_CRITICAL(); //打开中断 56 return (cnt); //返回信号值 57 } 58 #endif 59 60 /*$PAGE*/?? 61 /* 62 ******************************************************************************************* 建立一个信号量 63 * 64 * 描述: 建立并初始化一个信号量。信号量的作用为： 65 * 1、允许一个任务与其它任务或中断同步； 66 * 2、取得共享资源的使用权； 67 * 3、标志事件的发生 68 * 69 * 参数: cnt 建立信号量的初始值，可以为0 ~ 65 535的任何值 70 * 71 * 注意：必须先建立信号量，然后才能使用 72 * 73 * 返回: != (void *)0 返回指向分配给所建立的消息邮箱的事件控制块指针； 74 * == (vo