【FreeRTOS篇】任务通知

一、什么是任务通知?

使用任务通知比通过二进制信号量方式解除阻塞任务快 45%, 并且更加省内存(无需创建队列)。

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

二、任务通知值的更新方式

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

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

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

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

三、任务通知的优势和劣势

任务通知的优势:

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

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

任务通知的劣势:

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

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

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

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

持一个数据。

四、任务通知相关 API 函数

1. 发送通知

函数描述
xTaskNotify()发送通知,带有通知值
xTaskNotifyAndQuery()发送通知,带有通知值并且保留接收任务的原通知值
xTaskNotifyGive()发送通知,不带通知值

 xTaskNotify()

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

参数:
xTaskToNotify:需要接收通知的任务句柄;
ulValue:用于更新接收任务通知值, 具体如何更新由形参 eAction 决定;
eAction:一个枚举,代表如何使用任务通知的值;
返回值:
如果被通知任务还没取走上一个通知,又接收了一个通知,则这次通知值未能更新并返回
pdFALSE, 而其他情况均返回pdPASS。
枚举值描述
eNoAction发送通知,但不更新值(参数ulValue未使用)
eSetBits被通知任务的通知值按位或ulValue。(某些场景下可代替事件组,效率更高)
eIncrement被通知任务的通知值增加1(参数ulValue未使用),相当于xTaskNotifyGive
eSetValueWithOverWrite被通知任务的通知值设置为 ulValue。(某些场景下可代替xQueueOverwrite ,效率更高)
eSetValueWithoutOverwrite如果被通知的任务当前没有通知,则被通知的任务的通知值设为ulValue。如果被通知任务没有取走上一个通知,又接收到了一个通知,则这次通知值丢弃,在这种情况下视为调用失败并返回pdFALSE(某些场景下可代替 xQueueSend ,效率更高)

xTaskNotifyAndQuery()

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

参数:
xTaskToNotify:需要接收通知的任务句柄;
ulValue:用于更新接收任务通知值, 具体如何更新由形参 eAction 决定; 
eAction:一个枚举,代表如何使用任务通知的值;
pulPreviousNotifyValue:对象任务的上一个任务通知值,如果为 NULL, 则不需要回传, 这个时
候就等价于函数 xTaskNotify()。
返回值:
如果被通知任务还没取走上一个通知,又接收了一个通知,则这次通知值未能更新并返回
pdFALSE, 而其他情况均返回pdPASS。

xTaskNotifyGive()

BaseType_t xTaskNotifyGive( TaskHandle_t xTaskToNotify );

参数:
xTaskToNotify:接收通知的任务句柄, 并让其自身的任务通知值加 1。
返回值:
总是返回 pdPASS。

2. 等待通知

函数描述
ulTaskNotifyTake()获取任务通知,可以设置在退出此函数的时候将任务通知值清零或者减一。当任务通知用作二值信号量或者计数信号量的时候,使用此函数来获取信号量。
xTaskNotifyWait()获取任务通知,比 ulTaskNotifyTak()更为复杂,可获取通知值和清除通知值的指定位

ulTaskNotifyTake()

uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit,
                            TickType_t xTicksToWait );

参数:
xClearCountOnExit:指定在成功接收通知后,将通知值清零或减 1,pdTRUE:把通知值清零(二
值信号量);pdFALSE:把通知值减一(计数型信号量); 
xTicksToWait:阻塞等待任务通知值的最大时间;
返回值:
0:接收失败 非0:接收成功,返回任务通知的通知值

xTaskNotifyWait()

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

参数:
ulBitsToClearOnEntry:函数执行前清零任务通知值那些位 。 
ulBitsToClearOnExit:表示在函数退出前,清零任务通知值那些位,在清 0 前,接收到的任务通知值会先被保存到形参*pulNotificationValue 中。 
pulNotificationValue:用于保存接收到的任务通知值。如果不需要使用,则设置为 NULL 即可 。 
xTicksToWait:等待消息通知的最大等待时间。

五、实操

1. 模拟二值信号量

void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
			{
				xTaskNotifyGive(TaskReceiveHandle);
				printf("任务通知:模拟二值信号量发送成功\r\n");
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET);
		}
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
	uint32_t rev = 0;
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
			{
				rev = ulTaskNotifyTake(pdTRUE,portMAX_DELAY);
				if(rev != 0)
				printf("任务通知:模拟二值信号量接收成功\r\n");
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET);
		}
    osDelay(1);
  }
  /* USER CODE END StartTaskReceive */
}

2. 模拟计数型信号量

void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
			{
				xTaskNotifyGive(TaskReceiveHandle);
				printf("任务通知:模拟计数型信号量发送成功\r\n");
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET);
		}
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
	uint32_t rev = 0;
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
			{
				rev = ulTaskNotifyTake(pdFALSE,portMAX_DELAY);
				if(rev != 0)
				printf("任务通知:模拟计数型信号量接收成功,rev=%d\r\n",rev);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET);
		}
    osDelay(1);
  }
  /* USER CODE END StartTaskReceive */
}

3. 模拟事件标志组

void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
			{
				printf("将bit0位置1\r\n");
				xTaskNotify(TaskReceiveHandle,0x01,eSetBits);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET);
		}
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
			{
				printf("将bit1位置1\r\n");
				xTaskNotify(TaskReceiveHandle,0x02,eSetBits);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET);
		}
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
	uint32_t notify_val = 0;
	uint32_t event_bit = 0;
  /* Infinite loop */
  for(;;)
  {
		xTaskNotifyWait(0,0xFFFFFFFF,&notify_val,portMAX_DELAY);
		if(notify_val & 0x01)
			event_bit |= 0x01;
		if(notify_val & 0x02)
			event_bit |= 0x02;
		if(event_bit == (0x01 | 0x02))
		{
			printf("任务通知:模拟事件标志组接收成功\r\n");
			event_bit = 0;
		}	
    osDelay(1);
  }
  /* USER CODE END StartTaskReceive */
}

4. 模拟邮箱

即:长度为1的队列

void StartTaskSend(void const * argument)
{
  /* USER CODE BEGIN StartTaskSend */
  /* Infinite loop */
  for(;;)
  {
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET)
			{
				printf("按键1按下\r\n");
				xTaskNotify(TaskReceiveHandle,1,eSetValueWithoutOverwrite);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0) == RESET);
		}
		if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
		{
			osDelay(20);
			if(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET)
			{
				printf("按键2按下\r\n");
				xTaskNotify(TaskReceiveHandle,2,eSetValueWithoutOverwrite);
			}	
			while(HAL_GPIO_ReadPin(GPIOA,GPIO_PIN_1) == RESET);
		}
    osDelay(10);
  }
  /* USER CODE END StartTaskSend */
}

void StartTaskReceive(void const * argument)
{
  /* USER CODE BEGIN StartTaskReceive */
	uint32_t notify_val = 0;
  /* Infinite loop */
  for(;;)
  {
		xTaskNotifyWait(0,0xFFFFFFFF,&notify_val,portMAX_DELAY);
		printf("接收到的通知值为:%d\r\n",notify_val);
    osDelay(1);
  }
  /* USER CODE END StartTaskReceive */
}
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
提供的源码资源涵盖了安卓应用、小程序、Python应用和Java应用等多个领域,每个领域都包含了丰富的实例和项目。这些源码都是基于各自平台的最新技术和标准编写,确保了在对应环境下能够无缝运行。同时,源码中配备了详细的注释和文档,帮助用户快速理解代码结构和实现逻辑。 适用人群: 这些源码资源特别适合大学生群体。无论你是计算机相关专业的学生,还是对其他领域编程感兴趣的学生,这些资源都能为你提供宝贵的学习和实践机会。通过学习和运行这些源码,你可以掌握各平台开发的基础知识,提升编程能力和项目实战经验。 使用场景及目标: 在学习阶段,你可以利用这些源码资源进行课程实践、课外项目或毕业设计。通过分析和运行源码,你将深入了解各平台开发的技术细节和最佳实践,逐步培养起自己的项目开发和问题解决能力。此外,在求职或创业过程中,具备跨平台开发能力的大学生将更具竞争力。 其他说明: 为了确保源码资源的可运行性和易用性,特别注意了以下几点:首先,每份源码都提供了详细的运行环境和依赖说明,确保用户能够轻松搭建起开发环境;其次,源码中的注释和文档都非常完善,方便用户快速上手和理解代码;最后,我会定期更新这些源码资源,以适应各平台技术的最新发展和市场需求。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序猿gao

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值