前言
本文主要介绍什么是二值信号量和二值信号量的基本操作。

一、什么是二值信号量
信号量名副其实就是一个信号可以进行任务之前信息的交互，二值信号量通常用于互斥访问或同步。二值信号量就是一个只能保存一个数据的队列，这个队列要么是空要么是有他就只有两种状态。

二、cubeMX配置
1.选择添加一个二值信号量


2.设置二值信号量
这里比较简单我们只需要设置一下二值信号量的名字即可。



三、代码编写
1.创建二值信号量
这部分代码cubeMX会帮我们书写好

1. /* definition and creation of myBinarySem01 */
   
2.   osSemaphoreDef(myBinarySem01);
   
3.   myBinarySem01Handle = osSemaphoreCreate(osSemaphore(myBinarySem01), 1);
   
4. 
   
5.   /* USER CODE BEGIN RTOS_SEMAPHORES */

复制代码

2.产生二值信号量函数
本函数cubeMX对其进行了封装，其本质还是调用了xSemaphoreGiveFromISR和xSemaphoreGive两个函数。

1. /**
   
2. * @brief Release a Semaphore token
   
3. * @param  semaphore_id  semaphore object referenced with \ref osSemaphore.
   
4. * @retval  status code that indicates the execution status of the function.
   
5. * @note   MUST REMAIN UNCHANGED: \b osSemaphoreRelease shall be consistent in every CMSIS-RTOS.
   
6. */
   
7. osStatus osSemaphoreRelease (osSemaphoreId semaphore_id)
   
8. {
   
9.   osStatus result = osOK;
   
10.   portBASE_TYPE taskWoken = pdFALSE;
    
11. 
    
12. 
    
13.   if (inHandlerMode()) {
    
14.     if (xSemaphoreGiveFromISR(semaphore_id, &taskWoken) != pdTRUE) {
    
15.       return osErrorOS;
    
16.     }
    
17.     portEND_SWITCHING_ISR(taskWoken);
    
18.   }
    
19.   else {
    
20.     if (xSemaphoreGive(semaphore_id) != pdTRUE) {
    
21.       result = osErrorOS;
    
22.     }
    
23.   }
    
24. 
    
25.   return result;
    
26. }
    

复制代码

3.接收二值信号量函数
本函数cubeMX也对其进行了封装，其本质还是调用了xSemaphoreTakeFromISR和xSemaphoreTake两个函数。

当二值信号量接收成功的时候会返回osOK。

1. /**
   
2. * @brief Wait until a Semaphore token becomes available
   
3. * @param  semaphore_id  semaphore object referenced with \ref osSemaphore.
   
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.
   
6. * @note   MUST REMAIN UNCHANGED: \b osSemaphoreWait shall be consistent in every CMSIS-RTOS.
   
7. */
   
8. int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t millisec)
   
9. {
   
10.   TickType_t ticks;
    
11.   portBASE_TYPE taskWoken = pdFALSE;  
    
12. 
    
13. 
    
14.   if (semaphore_id == NULL) {
    
15.     return osErrorParameter;
    
16.   }
    
17. 
    
18.   ticks = 0;
    
19.   if (millisec == osWaitForever) {
    
20.     ticks = portMAX_DELAY;
    
21.   }
    
22.   else if (millisec != 0) {
    
23.     ticks = millisec / portTICK_PERIOD_MS;
    
24.     if (ticks == 0) {
    
25.       ticks = 1;
    
26.     }
    
27.   }
    
28. 
    
29.   if (inHandlerMode()) {
    
30.     if (xSemaphoreTakeFromISR(semaphore_id, &taskWoken) != pdTRUE) {
    
31.       return osErrorOS;
    
32.     }
    
33.         portEND_SWITCHING_ISR(taskWoken);
    
34.   }  
    
35.   else if (xSemaphoreTake(semaphore_id, ticks) != pdTRUE) {
    
36.     return osErrorOS;
    
37.   }
    
38. 
    
39.   return osOK;
    
40. }

复制代码

四、二值信号量具体操作

1. osThreadId Task1TaskHandle;
   
2. osThreadId Task2TaskHandle;
   
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);
   
9. 
   
10. osThreadDef(Task2TaskName, Task2Task, osPriorityNormal, 0, 128);
    
11. Task2TaskHandle = osThreadCreate(osThread(Task2TaskName), NULL);
    
12. 
    
13. //产生二值信号量任务
    
14. void Task1Task(void const * argument)
    
15. {
    
16.         static u8 i=0;
    
17.         for(;;)
    
18.         {
    
19.                 //调用10次再产生二值信号量
    
20.                 if(++i==10)
    
21.                 {
    
22.                         osSemaphoreRelease(myBinarySem01Handle);//产生二值信号量               
    
23.                 }
    
24.                 osDelay(5);//调用延时才会释放资源
    
25.         }
    
26. }
    
27. 
    
28. 
    
29. //接收二值信号量任务
    
30. void Task2Task(void const * argument)
    
31. {
    
32.         for(;;)
    
33.         {
    
34.                 if(osOK==osSemaphoreWait(myBinarySem01Handle,portMAX_DELAY))//等待二值信号量采用死等的方式
    
35.             {
    
36.                       //等待二值信号量成功
    
37.                    }
    
38.                 osDelay(5);//调用延时才会释放资源
    
39.         }
    
40. }
    

复制代码

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