前言
7 I6 {5 [% f' V) w2 Y8 b本文主要介绍什么是二值信号量和二值信号量的基本操作。
& r6 E' X% g+ o+ \5 J
一、什么是二值信号量
信号量名副其实就是一个信号可以进行任务之前信息的交互，二值信号量通常用于互斥访问或同步。二值信号量就是一个只能保存一个数据的队列，这个队列要么是空要么是有他就只有两种状态。
, b+ I/ {- Y9 s% k+ Z) L8 K5 \1 Y
! `* G1 j: e+ }0 b二、cubeMX配置
6 L! l! J# {6 W$ |3 v1.选择添加一个二值信号量
& b. X/ ]5 ?3 J& B& ^+ D
. e4 i4 @8 q9 ~/ n
2.设置二值信号量
& J0 ?- K' B3 r5 W这里比较简单我们只需要设置一下二值信号量的名字即可。
' g& m: C7 A8 x2 ]4 K: E- M


7 p; d6 z: o% g: D0 \三、代码编写
1.创建二值信号量
1 L! k& f1 U3 E; S9 g; G这部分代码cubeMX会帮我们书写好
/ P) a, [5 L$ [  V/ m1 }9 L3 D: I

1. /* definition and creation of myBinarySem01 */
   
2.   osSemaphoreDef(myBinarySem01);
   , C* a) z1 e( C; R+ }1 e+ ~
3.   myBinarySem01Handle = osSemaphoreCreate(osSemaphore(myBinarySem01), 1);
   ' l9 a* D- m9 Z9 V& m0 m
4. 
   2 ]- d& Z) h& a* \: y; D- g
5.   /* USER CODE BEGIN RTOS_SEMAPHORES */

复制代码

2.产生二值信号量函数
  k6 d3 o- R: F$ h本函数cubeMX对其进行了封装，其本质还是调用了xSemaphoreGiveFromISR和xSemaphoreGive两个函数。

: ^, f3 Y% W/ t/ K

1. /**
   % f2 A) v: T4 |1 g
2. * @brief Release a Semaphore token
   * D1 j8 ?9 u6 z" Q; z# V( U
3. * @param  semaphore_id  semaphore object referenced with \ref osSemaphore.
   & b, R( @8 Y1 t% R1 {' Q
4. * @retval  status code that indicates the execution status of the function.
   & E8 @) i3 R5 s, Q4 t- E9 b
5. * @note   MUST REMAIN UNCHANGED: \b osSemaphoreRelease shall be consistent in every CMSIS-RTOS.
   
6. */
   + q$ p! i1 Y, ?
7. osStatus osSemaphoreRelease (osSemaphoreId semaphore_id)
   , D! Z( P' }% H& D; _" \9 v
8. {
   
9.   osStatus result = osOK;
   ) V7 z4 V. t% e1 E! e0 H
10.   portBASE_TYPE taskWoken = pdFALSE;
    
11. 
    
12. 
    / D1 Z: F1 c9 \
13.   if (inHandlerMode()) {
    
14.     if (xSemaphoreGiveFromISR(semaphore_id, &taskWoken) != pdTRUE) {
    
15.       return osErrorOS;
    
16.     }
    
17.     portEND_SWITCHING_ISR(taskWoken);
    2 M. `$ y( Y" y
18.   }
    
19.   else {
    & B9 ~& [3 u6 d- \# D. n
20.     if (xSemaphoreGive(semaphore_id) != pdTRUE) {
    . K+ T% y9 i8 P5 T$ D- ?
21.       result = osErrorOS;
    4 |$ h1 x. C0 k( x
22.     }
    ' p7 i) T5 k* s0 ]* a; H9 o" [
23.   }
    % x* F4 S% d' H: F0 X' d
24. 
    ) o3 T, J0 j+ C, r
25.   return result;
    
26. }
    

复制代码

9 r" W" x2 _7 T, w+ l: L! E3 z3.接收二值信号量函数
本函数cubeMX也对其进行了封装，其本质还是调用了xSemaphoreTakeFromISR和xSemaphoreTake两个函数。

' r' `  ^) ~9 w# k( i- S, V* E7 K当二值信号量接收成功的时候会返回osOK。

2 x+ L+ h+ M$ d. r$ |4 O

1. /**
   ) v% N: C$ N$ g; ]0 x
2. * @brief Wait until a Semaphore token becomes available
   
3. * @param  semaphore_id  semaphore object referenced with \ref osSemaphore.
   / y9 w# \1 Q! h7 V! R
4. * @param  millisec      timeout value or 0 in case of no time-out.
   
5. * @retval  number of available tokens, or -1 in case of incorrect parameters.
   # E2 k7 w% |! \# j0 s( \
6. * @note   MUST REMAIN UNCHANGED: \b osSemaphoreWait shall be consistent in every CMSIS-RTOS.
   6 X3 y. ]- n1 {" o! G$ }8 R" k
7. */
   
8. int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t millisec)
   
9. {
   
10.   TickType_t ticks;
    
11.   portBASE_TYPE taskWoken = pdFALSE;  
    $ ~0 C+ E, k$ G
12. 
    ) Y0 c% R; j% R4 d) \, J2 G' e
13. 
    
14.   if (semaphore_id == NULL) {
    
15.     return osErrorParameter;
    " C$ \" I7 J$ y7 o" o
16.   }
    5 ?0 S3 ^/ e7 ^
17. 
    ' E: p: M; _6 v/ L
18.   ticks = 0;
    2 \2 l8 j! F. t( _- ?9 Z3 i
19.   if (millisec == osWaitForever) {
    * S/ l+ Y* S. G! P/ m3 |" S4 b; t
20.     ticks = portMAX_DELAY;
    / u- K4 `1 c+ M; ?
21.   }
    
22.   else if (millisec != 0) {
    0 e: o$ L9 _7 N: Q, ?
23.     ticks = millisec / portTICK_PERIOD_MS;
    - i& P; L7 |& x' c3 i1 R
24.     if (ticks == 0) {
    
25.       ticks = 1;
    
26.     }
    # ]$ Y' k& |# ?; D+ N
27.   }
    
28. 
    
29.   if (inHandlerMode()) {
    
30.     if (xSemaphoreTakeFromISR(semaphore_id, &taskWoken) != pdTRUE) {
    ! w: ]' F0 J0 K/ _
31.       return osErrorOS;
    
32.     }
    
33.         portEND_SWITCHING_ISR(taskWoken);
    ) I3 @; F0 V# B$ m, }
34.   }  
    : [, V; G  o/ _. T  [, @
35.   else if (xSemaphoreTake(semaphore_id, ticks) != pdTRUE) {
    % ^, B. N/ P; r% m7 F
36.     return osErrorOS;
    7 b. V. `! L$ g: {1 L3 ?8 M$ _
37.   }
    
38. 
    % `. o. g8 e; b2 D7 R
39.   return osOK;
    
40. }

复制代码

四、二值信号量具体操作
$ |+ @' H# z! Y% ~3 G& c; T- F

1. osThreadId Task1TaskHandle;
   & ]* e, k: P/ t) r+ L" m5 h
2. osThreadId Task2TaskHandle;
   ' M- g& V! t$ D4 b  w
3. 
   
4. void Task1Task(void const * argument);
   
5. void Task2Task(void const * argument);
   
6. 
   
7. osThreadDef(Task1TaskName, Task1Task, osPriorityNormal, 0, 128);
   
8. Task1TaskHandle = osThreadCreate(osThread(Task1TaskName), NULL);
   4 s; t. r3 q8 F
9. 
   5 t- y3 v% d" O7 j, F
10. osThreadDef(Task2TaskName, Task2Task, osPriorityNormal, 0, 128);
    2 {  e. ]$ F0 v6 W# _4 U7 Q
11. Task2TaskHandle = osThreadCreate(osThread(Task2TaskName), NULL);
    
12. 
    
13. //产生二值信号量任务
    - t  s  |, |* @7 H9 e
14. void Task1Task(void const * argument)
    
15. {
    ' ~. c' J! b5 X3 t  J* V
16.         static u8 i=0;
    
17.         for(;;)
    ' n& H  B' K: f# R$ ?/ ]
18.         {
    
19.                 //调用10次再产生二值信号量
    $ U3 B& F; m5 O. n
20.                 if(++i==10)
    
21.                 {
    " J& d0 J7 I) b4 }: `1 X
22.                         osSemaphoreRelease(myBinarySem01Handle);//产生二值信号量               
    
23.                 }
    % c# \: Y! @7 a$ o, |: h
24.                 osDelay(5);//调用延时才会释放资源
    " Y; v8 Q% s6 M4 ~# o
25.         }
    
26. }
    3 L9 u2 y+ d2 K' ~+ B6 E
27. 
    
28. 
    
29. //接收二值信号量任务
    
30. void Task2Task(void const * argument)
    1 y6 ?) ^  d& n: H! _: ^
31. {
      W; h, f5 c5 |$ }0 j: \8 K
32.         for(;;)
    2 Y, j# l2 l" e
33.         {
    $ c( |. P* a8 W, j
34.                 if(osOK==osSemaphoreWait(myBinarySem01Handle,portMAX_DELAY))//等待二值信号量采用死等的方式
    
35.             {
    
36.                       //等待二值信号量成功
    
37.                    }
    
38.                 osDelay(5);//调用延时才会释放资源
    ! E0 N5 i) x8 s- _( Q4 Q
39.         }
    
40. }
    9 H. B. _5 l$ n- e/ @3 z% Y

复制代码

总结
二值信号量的大致操作和介绍就是这样了。

: K/ x4 m7 e1 o; M/ R/ X& \# j) Y4 k