学习FreeRTOS(任务通知)

1. 任务通知

1.1 什么是任务通知?

FreeRTOS 从版本 V8.2.0 开始提供任务通知这个功能,每个任务都有一个 32 位的通知值。按照 FreeRTOS 官方的说法,使用消息通知比通过二进制信号量方式解除阻塞任务快 45%, 并且更加省内存(无需创建队列)。

在大多数情况下,任务通知可以替代二值信号量、计数信号量、事件标志组,可以替代长度为 1 的队列(可 以保存一个 32 位整数或指针值),并且任务通知速度更快、使用的RAM更少!

1.2 任务通知值的更新方式

FreeRTOS 提供以下几种方式发送通知给任务 :

发送消息给任务,如果有通知未读, 不覆盖通知值

发送消息给任务,直接覆盖通知值

发送消息给任务,设置通知值的一个或者多个位

发送消息给任务,递增通知值

通过对以上方式的合理使用,可以在一定场合下替代原本的队列、信号量、事件标志组等。

1.3 任务通知的优势和劣势

任务通知的优势

1. 使用任务通知向任务发送事件或数据,比使用队列、事件标志组或信号量快得多。

2. 使用其他方法时都要先创建对应的结构体,使用任务通知时无需额外创建结构体。

任务通知的劣势

1. 只有任务可以等待通知,中断服务函数中不可以,因为中断没有 TCB 。

2. 通知只能一对一,因为通知必须指定任务。

3. 等待通知的任务可以被阻塞, 但是发送消息的任务,任何情况下都不会被阻塞等待。

4. 任务通知是通过更新任务通知值来发送数据的,任务结构体中只有一个任务通知值,只能保持一个数据。

2. 任务通知相关 API 函数

2.1 发送通知

BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify,
                         uint32_t ulValue,
                         eNotifyAction eAction );

参数:

xTaskToNotify:需要接收通知的任务句柄;

ulValue:用于更新接收任务通知值, 具体如何更新由形参 eAction 决定;

eAction:一个枚举,代表如何使用任务通知的值;

返回值:

如果被通知任务还没取走上一个通知,又接收了一个通知,则这次通知值未能更新并返回 pdFALSE, 而其他 情况均返回pdPASS。

BaseType_t xTaskNotifyAndQuery( TaskHandle_t xTaskToNotify,
 uint32_t ulValue,
 eNotifyAction eAction,
 uint32_t *pulPreviousNotifyValue );

参数:

xTaskToNotify:需要接收通知的任务句柄;

ulValue:用于更新接收任务通知值, 具体如何更新由形参 eAction 决定;

eAction:一个枚举,代表如何使用任务通知的值;

pulPreviousNotifyValue:对象任务的上一个任务通知值,如果为 NULL, 则不需要回传, 这个时候就等价 于函数 xTaskNotify()。

返回值:

如果被通知任务还没取走上一个通知,又接收了一个通知,则这次通知值未能更新并返回 pdFALSE, 而其他情况均返回pdPASS。

BaseType_t xTaskNotifyGive( TaskHandle_t xTaskToNotify );

参数:

xTaskToNotify:接收通知的任务句柄, 并让其自身的任务通知值加 1。

返回值:

总是返回 pdPASS。

2.2 等待通知

等待通知API函数只能用在任务,不可应用于中断中!

uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit,
 TickType_t xTicksToWait );

参数:

xClearCountOnExit:指定在成功接收通知后,将通知值清零或减 1,pdTRUE:把通知值清零(二值信号 量);pdFALSE:把通知值减一(计数型信号量);

xTicksToWait:阻塞等待任务通知值的最大时间;

返回值:

0:接收失败

非0:接收成功,返回任务通知的通知值

BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry,
 uint32_t ulBitsToClearOnExit,
 uint32_t *pulNotificationValue,
 TickType_t xTicksToWait );

ulBitsToClearOnEntry:函数执行前清零任务通知值那些位 。

ulBitsToClearOnExit:表示在函数退出前,清零任务通知值那些位,在清 0 前,接收到的任务通知值会先被 保存到形参*pulNotificationValue 中。

pulNotificationValue:用于保存接收到的任务通知值。 如果 不需要使用,则设置为 NULL 即可 。

xTicksToWait:等待消息通知的最大等待时间。

3. 实操

实现需求

1. 模拟二值信号量

2. 模拟计数型信号量

3. 模拟事件标志组

4. 模拟邮箱

CubeMX配置

模拟二值信号量

代码实现

/* USER CODE BEGIN Header_StartTaskSend */
/**
  * @brief  Function implementing the TaskSend thread.
  * @param  argument: Not used
  * @retval None
  */
/* USER CODE END Header_StartTaskSend */
void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET) 
      {
          xTaskNotifyGive(TaskReceiveHandle);
          printf("通知发送成功!\r\n");
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET);
    }
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

/* USER CODE BEGIN Header_StartTaskReceive */
/**
* @brief Function implementing the TaskReceive thread.
* @param argument: Not used
* @retval None
*/
/* USER CODE END Header_StartTaskReceive */
void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
   uint32_t rev=0;
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET) 
      {
          rev=ulTaskNotifyTake(pdTRUE,portMAX_DELAY);
          if(rev!=0)
          {
              printf("通知接收成功!\r\n");
          }
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET);
    }
    osDelay(10);
  }
  
  /* USER CODE END StartTaskReceive */
}

实验现象

1.打开串口助手观察现象

模拟计数型信号量

代码实现

将上面的红框代码改为

rev=ulTaskNotifyTake(pdFALSE,portMAX_DELAY);

实验现象

1.打开串口助手观察现象

模拟事件标志组

代码实现

/* USER CODE BEGIN Header_StartTaskSend */
/**
  * @brief  Function implementing the TaskSend thread.
  * @param  argument: Not used
  * @retval None
  */
/* USER CODE END Header_StartTaskSend */
void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET) 
      {
          printf("将bit0置1!\r\n");
          xTaskNotify(TaskReceiveHandle,0x01,eSetBits);
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET);
    }
  
   if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET) 
      {
          printf("将bit1置1!\r\n");
          xTaskNotify(TaskReceiveHandle,0x02,eSetBits);
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET);
    }
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

/* USER CODE BEGIN Header_StartTaskReceive */
/**
* @brief Function implementing the TaskReceive thread.
* @param argument: Not used
* @retval None
*/
/* USER CODE END Header_StartTaskReceive */
void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
   uint32_t notiy_val=0,event_rev=0;
  /* Infinite loop */
  for(;;)
  {
     xTaskNotifyWait(0,0xFFFFFFFF,&notiy_val,portMAX_DELAY);
     if(notiy_val&0x01)
        event_rev|=0x01;
     if(notiy_val&0x02)
        event_rev|=0x02;
     if(event_rev==(0x01|0x02))
     {
         printf("任务通知已接收,请假成功!\r\n");
         event_rev=0;
     }
        
 }
  /* USER CODE END StartTaskReceive */
}

实验现象

1.打开串口助手观察实验现象

模拟邮箱

邮箱是一个长度为1的队列

代码实现

/* USER CODE BEGIN Header_StartTaskSend */
/**
  * @brief  Function implementing the TaskSend thread.
  * @param  argument: Not used
  * @retval None
  */
/* USER CODE END Header_StartTaskSend */
void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
    if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET) 
      {
          printf("往邮箱写入1\r\n");
          xTaskNotify(TaskReceiveHandle,01,eSetValueWithOverwrite);
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0)==GPIO_PIN_RESET);
    }
  
   if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET)
    {
      osDelay(20);
      if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET) 
      {
          printf("往邮箱写入2\r\n");
          xTaskNotify(TaskReceiveHandle,2,eSetValueWithOverwrite);
      }
      while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1)==GPIO_PIN_RESET);
    }
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

/* USER CODE BEGIN Header_StartTaskReceive */
/**
* @brief Function implementing the TaskReceive thread.
* @param argument: Not used
* @retval None
*/
/* USER CODE END Header_StartTaskReceive */
void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
   uint32_t notiy_val=0,event_rev=0;
  /* Infinite loop */
  for(;;)
  {
     xTaskNotifyWait(0,0xFFFFFFFF,&notiy_val,portMAX_DELAY);
     printf("接收到的数据为%d\r\n",notiy_val);
        
 }
  /* USER CODE END StartTaskReceive */
}

实验现象

1.打开串口助手观察实验现象

2.如果把红框中的参数改为eSetValueWithoutOverwrite呢?

观察串口助手现象是一样的

但是第一个会覆写之前的内容、第二个不会覆写之前的内容

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值