OS_SEM信号量源码注释（精选）.doc

1 /*
2 *************************************************************************************
3 * uC/OS-II实时控制内核
4 * 主要的包含文件
5 * 信号量程序函数
6 *
7 * 文件: 信号量程序函数
8 * 作者: Jean J. Labrosse
9 * 中文注解: 钟常慰 zhongcw @ 译注版本: 请尊重原版内容
10 *************************************************************************************
11 */
12
13 #ifndef OS_MASTER_FILE //是否已定义OS_MASTER_FILE主文件
14 #include "" //包含""文件,部分C语言头文件的汇总打包文件
15 #endif //定义结束
16
17 #if OS_SEM_EN > 0 //条件编译:当OS_SEM_EN允许产生信号量程序代码
18 /*
19 *************************************************************************************
20 * 无条件地等待请求一个信号量
21 *
22 * 描述: 该函数是查看资源是否使用或事件是否发生。中断调用该函数查询信号量。
23 * 不同于OSSemPend()函数,如果资源不可使用,ept()函数并不挂起任务。
24
25 * 参数: pevent 指向需要保护地共享资源地信号量。当建立信号量时,用户得到该指针
26 *
27 * 返回: ept()函数时;
28 共享资源信号量的值> 0,则说明共享资源可以使用,这个值被返回调用者,信号量的值减1;
29 共享资源信号量的值= 0,则说明资源不能使用,返回0。
30 *************************************************************************************
31 */
32
33 #if EPT_EN > 0 //允许生成 ept()函数
34 INT16U ept (OS_EVENT *pevent) //无条件地等待请求一个信号量函数
35 {
36 #if OS_CRITICAL_METHOD == 3 //中断函数被设定为模式3
37 OS_CPU_SR cpu_sr;
38 #endif
39 t; //信号量的内容暂时存储变量
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(); //关闭中断
t = pevent->t; //取信号值
52 if (cnt > 0) { //当信号值>0时,该值有效
53 pevent->t--; //信号量减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 * == (voi