【FreeRtos教程五】STM32 CubeMx——Binary and Counting Semaphore（二进制信号量和计数型信号量）

Joseph Wen

已于 2024-09-03 16:23:37 修改

阅读量1k

点赞数 3

分类专栏： FreeRtos 文章标签：学习单片机 stm32 mcu

于 2023-03-05 21:56:42 首次发布

本文链接：https://blog.csdn.net/DIVIDADA/article/details/129351778

版权

FreeRtos 专栏收录该内容

11 篇文章 24 订阅

订阅专栏

1 信号量

1.1 什么是信号量

前面介绍队列（queue）我们可以用于在任务之间、任务和中断之间传输数据，但是有时候我们只是需要传递状态，并不需要传递具体的信息。例如任务A中让计数值加1，任务B获取到这个计数值，由此实现两个任务间的通讯。二进制信号量和计数型信号量唯一的差别就是二进制信号量的最大计数值被限定为1。

1.2 信号量的常规操作

信号量这个名字很恰当：

信号：起通知作用
量：还可以用来表示资源的数量
- 当"量"没有限制时，它就是"计数型信号量"(Counting Semaphores)
- 当"量"只有0、1两个取值时，它就是"二进制信号量"(Binary Semaphores)
支持的动作："give"给出资源，计数值加1；"take"获得资源，计数值减1

计数型信号量的典型场景是：

计数：事件产生时"give"信号量，让计数值加1；处理事件时要先"take"信号量，就是获得信号量，让计数值减1。
资源管理：要想访问资源需要先"take"信号量，让计数值减1；用完资源后"give"信号量，让计数值加1。

信号量的"give"、"take"双方并不需要相同，可以用于生产者-消费者场合：

生产者为任务A、B，消费者为任务C、D
一开始信号量的计数值为0，如果任务C、D想获得信号量，会有两种结果：
- 阻塞：买不到东西咱就等等吧，可以定个闹钟(超时时间)
- 即刻返回失败：不等
任务A、B可以生产资源，就是让信号量的计数值增加1，并且把等待这个资源的顾客唤醒
唤醒谁？谁优先级高就唤醒谁，如果大家优先级一样就唤醒等待时间最长的人

2 示例程序

2.1 例程功能

创建两个按键任务，一个按键任务用来释放信号量，一个按键用来获取信号量，获取、释放信号量的同时将剩余信号量打印出来。

2.2 步骤

配置两个按键IO口

创建两个动态任务

创建一个二值信号量

创建一个计数型信号量，计数值为6

按键KEY0按下，释放信号量

/* USER CODE END Header_StartTask_KEY0 */
void StartTask_KEY0(void const * argument)
{
  /* USER CODE BEGIN StartTask_KEY0 */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
    {
            osDelay(10);
            if(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
            {
                if(myCountingSem01Handle!=NULL)
                {
                    if(osSemaphoreRelease(myCountingSem01Handle)==osOK)
                    {
                        osThreadSuspendAll();
                        printf("释放成功，剩余信号量：%d \n",osSemaphoreGetCount(myCountingSem01Handle));
                        osThreadResumeAll();
                    }
                    else
                    {
                        osThreadSuspendAll();
                        printf("都释放完了，剩余信号量：%d \n",osSemaphoreGetCount(myCountingSem01Handle));
                        osThreadResumeAll();
                    }
                    while(HAL_GPIO_ReadPin(KEY0_GPIO_Port,KEY0_Pin)==0)
                    {
                        osDelay(10);
                    }
                }
            }
    }
    osDelay(1);
  }
  /* USER CODE END StartTask_KEY0 */
}

按键KEY1按下，获取信号量

void StartTask_KEY1(void const * argument)
{
  /* USER CODE BEGIN StartTask_KEY1 */
  /* Infinite loop */

  for(;;)
  {
    if(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
    {
      osDelay(10);
    if(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
    {
        if(myCountingSem01Handle!=NULL)
        {
            if(osSemaphoreWait(myCountingSem01Handle,0)==osOK)
            {
                osThreadSuspendAll();
                printf("获得成功，剩余信号量：%d\n",osSemaphoreGetCount(myCountingSem01Handle));
                osThreadResumeAll();
            }
            else
            {
                osThreadSuspendAll();
                printf("全部获得了，剩余信号量：%d\n",osSemaphoreGetCount(myCountingSem01Handle));
                osThreadResumeAll();
            }
            while(HAL_GPIO_ReadPin(KEY1_GPIO_Port,KEY1_Pin)==0)
            {
                osDelay(10);
            }
        }
    }
    }
    osDelay(1);
    }
  /* USER CODE END StartTask_KEY1 */
}

2.3 实验结果

初始信号量为6，KEY1按下，获取信号量，KEY0按下，释放信号量

注：二值信号量的实验只需将两个任务中句柄myCountingSem01Handle替换为myBinarySem01Handle

2.4 函数讲解

1 osStatus osSemaphoreRelease (osSemaphoreId semaphore_id)

/**
@brief Release a Semaphore token
@param  semaphore_id  semaphore object referenced with \ref osSemaphore.
@retval  status code that indicates the execution status of the function.
@note   MUST REMAIN UNCHANGED: \b osSemaphoreRelease shall be consistent in every CMSIS-RTOS.
*/
osStatus osSemaphoreRelease (osSemaphoreId semaphore_id)

函数功能：释放某一信号量
传入参数：要释放信号量的句柄

2 int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t millisec)

/**
@brief Wait until a Semaphore token becomes available
@param  semaphore_id  semaphore object referenced with \ref osSemaphore.
@param  millisec      timeout value or 0 in case of no time-out.
@retval  number of available tokens, or -1 in case of incorrect parameters.
@note   MUST REMAIN UNCHANGED: \b osSemaphoreWait shall be consistent in every CMSIS-RTOS.
*/
int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t millisec)

函数功能：获取某一信号量
传入参数：1.semaphore_id （要释放信号量的句柄） 2.millisec（超时等待时间）

3 uint32_t osSemaphoreGetCount(osSemaphoreId semaphore_id)

/**
* @brief  Returns the current count value of a counting semaphore
* @param  semaphore_id  semaphore_id ID obtained by \ref osSemaphoreCreate.
* @retval  count value
*/
uint32_t osSemaphoreGetCount(osSemaphoreId semaphore_id)