OS_SEM信号量源码注释

1 /*
2 *************************************************************************************
3 * uC/OS-II实时控制内核
4 * 光立方制作主要的包含文件
5 * 信号量程序函数
6 *
7 * : OS_SEM.C 信号量程序函数
8 * : Jean J. Labrosse
9 * 中文注解: 钟常慰 zhongcw @ 126 译注版本: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*/

本文发布于:2024-09-22 23:36:38,感谢您对本站的认可!

本文链接:https://www.17tex.com/tex/1/155679.html

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系,我们将在24小时内删除。

标签:信号量   任务   事件   中断   删除
留言与评论(共有 0 条评论)
   
验证码:
Copyright ©2019-2024 Comsenz Inc.Powered by © 易纺专利技术学习网 豫ICP备2022007602号 豫公网安备41160202000603 站长QQ:729038198 关于我们 投诉建议