STM32FreeRTOS任务通知(STM32cube高效开发)

2024-03-04 03:52
文章标签 高效 开发 任务 通知 stm32cube stm32freertos

本文主要是介绍STM32FreeRTOS任务通知(STM32cube高效开发)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

  • 一、任务通知
    • (一）任务通知概述
      • 1、任务通知可模拟队列和信号量
      • 2、任务通知优势和局限性
    • (二) 任务通知函数
      • 1、xTaskNotify（）发送通知值不返回先前通知值的函数
      • 2、xTaskNotifyFromISR（）发送通知函数ISR版本
      • 3、xTaskNotifyAndQuery()发送通知值且返回先前通知值的函数
      • 4、xTaskNotifyGive()函数-发送通知值使通知值+1的函数
      • 5、xTaskNotifyWait()函数-等待任务通知和接收通知值
      • 6、ulTaskNotifyTake()函数--二值信号量或计数信号量获取任务通知
      • 7、xTaskNotifyStateClear()函数-清除任务通知值
  • 二、任务通知传递数据
    • （一）任务通知值模拟二值信号量
      • 1、目标
      • 2、STM32cubemx配置
      • 3、代码编写
    • （二）任务通知值模拟计数型信号量
      • 1、目标
      • 2、STM32cubemx设置
      • 3、代码编写

一、任务通知

(一）任务通知概述

1、任务通知可模拟队列和信号量

任务通知是FreeRTOS另外一种进程间通信技术。不需要创建任何中间对象，可以直接从任务向任务或ISR向任务发送通知，传递一个通知值任务通知可以模拟二值信号量、计数信号量、或长度为1的消息队列，使用任务通知，一般效率更高，消耗内存更少

在这里插入图片描述

在这里插入图片描述
任务通知和队列信号量事件组区别如下

  • 队列信号量事件组：

    使用队列、信号量、事件标志组时都需另外创建一个结构体，通过中间的结构体进行间接通信！

  • 任务通知：

    使用任务通知时，任务结构体TCB中就包含了内部对象，可以直接接收别人发过来的"通知"

2、任务通知优势和局限性

(1)任务通知值优势

在这里插入图片描述

  • 效率更高： 使用任务通知向任务发送事件或数据比使用队列、事件标志组或信号量快得多
  • 使用内存更少： 使用其他方法时都要先创建对应的结构体，使用任务通知时无需额外创建结构体

(2)任务通知值局限

在这里插入图片描述

  • 无法发送数据给ISR： ISR没有任务结构体，所以无法给ISR发送数据。但是ISR可以使用任务通知的功能，发数据给任务。
  • 无法广播给多个任务： 任务通知只能是被指定的一个任务接收并处理
  • 无法缓存多个数据； 任务通知是通过更新任务通知值来发送数据的，任务结构体中只有一个任务通知值，只能保持一个数据。
  • 发送受阻不支持阻塞： 发送方无法进入阻塞状态等待

(二) 任务通知函数

在这里插入图片描述

1、xTaskNotify（）发送通知值不返回先前通知值的函数

向一个任务发送通知的函数
参数1：任务通知句柄
参数2：要发送的通知值（此参数的使用取决于参数3）
参数3：通知值得作用方式（可以传入五种不同得枚举值）

在这里插入图片描述

/*
参数1：接收者任务句柄
参数2：要发送的通知值（此参数的使用取决于参数3）
参数3：通知值作用方式（可以传入五种不同得枚举值eNotifyAction）
参数4：为NULL表明不会返回通知前的数值
通知值和枚举值共同决定了如何修改接收者通知值
返回值是更新后的通知值
*/
#define xTaskNotify( xTaskToNotify, ulValue, eAction ) 
xTaskGenericNotify( ( xTaskToNotify ), ( ulValue ), ( eAction ), NULL )

xTaskNotify()在调用函数xTaskGenericNotify()时没有传递最后一个参数，所以不能返回接收者更新之前的通知值。函数xTaskNotify()返回的是更新之后的接收者的通知值。

参数3的枚举值如下所示：
在这里插入图片描述

typedef enum
{eNoAction = 0, /* 无操作：只发通知，不改变接收者的通知值 */eSetBits, /* 更新指定bit: 接收者的通知值与ulValue按位或运算，适用于当做事件组使用 */eIncrement, /* t将接收者的通知值加1，适用于当做二值信号量或计数信号量使用 */eSetValueWithOverwrite,/* 覆写通知值：用ulValue覆盖接收者的通知值，即使前一次的通知未被处理 */eSetValueWithoutOverwrite /* 不覆写通知值：接收者处于非挂起状态时，用ulValue更新其通知值，否则不更新*/
} eNotifyAction;

参数3枚举值：
（1）传入eSetBits时（适用于任务通知做事件组时使用）
在这里插入图片描述
接收者的通知值与u1value进行按位或运算

（2）传入eIncrement（适用于当作计数型信号量或二值信号量场景）
在这里插入图片描述
接收者的通知值+1运算

（3）覆写
在这里插入图片描述
用u1value覆盖接收者的通知值（即使前一次的通知未被处理）
（4）不覆写更新通知值
在这里插入图片描述
接收者处于非挂起状态时，用u1value更新其通知值，否则不更新

宏函数实际调用执行的函数：

/*
参数1：任务通知句柄
参数2：要发送的通知值（此参数的使用取决于参数3）
参数3：通知值得作用方式（可以传入五种不同得枚举值eNotifyAction）
参数4：返回接收者的通知值被改变之前的值（NULL表明不会返回通知前的数值）
*/#if( configUSE_TASK_NOTIFICATIONS == 1 )BaseType_t xTaskGenericNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue,eNotifyAction eAction,uint32_t *pulPreviousNotificationValue ){略}#endif /* configUSE_TASK_NOTIFICATIONS */

在这里插入图片描述

2、xTaskNotifyFromISR（）发送通知函数ISR版本

ISR版本比任务中的发送函数多一个参数（最后一个参数是指是否需要进行上下文切换）

#define xTaskNotifyFromISR( xTaskToNotify, ulValue, eAction,pxHigherPriorityTaskWoken ) 
xTaskGenericNotifyFromISR( ( xTaskToNotify ), ( ulValue ), ( eAction ), NULL, ( HigherPriorityTaskWoken ) )

pxHigherPriorityTaskWoken是一个*BaseType_t 类型的指针，实际上是一个返回数据，表示退出中断ISR函数之后是否需要进行上下文切换

申请进行上下文切换调用函数portYIELD_FROM_ISR()

3、xTaskNotifyAndQuery()发送通知值且返回先前通知值的函数

函数xTaskNotifyAndQuery()与xTaskNotify()的功能相同，但是能返回接收者通知值改变之前的值。（还有一个ISR版本）
在这里插入图片描述
参数pulPreviousNotifyValue用于获取接收者之前的通知值，是uint32_t *类型的指针变量

示意代码如下：

uint32_t previousValue=0;
uint32_t currentValue=0;
currentValue =xTaskNotifyAndQuery(xTaskToNotify, ulValue, eAction, &previousValue);

4、xTaskNotifyGive()函数-发送通知值使通知值+1的函数

函数 xTaskNotifyGive() 是xTaskNotify()的一种功能简化版本（并有一个ISR版本）
参数eAction设置为eIncrement，所以，函数xTaskNotifyGive()的功能就是使接收者的通知值加1，这使其适用于 将任务通知当做二值信号量或计数信号量使用的场合。
在这里插入图片描述

注意：
发送通知API函数可以用于任务和中断服务函数中；接收通知API函数只能用在任务中。
在这里插入图片描述

5、xTaskNotifyWait()函数-等待任务通知和接收通知值

接收者使用函数xTaskNotifyWait()进入阻塞状态等待任务通知并获取通知值

BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit,uint32_t *pulNotificationValue, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;参数1：函数进入时需要清零的通知值的位掩码。（需要清零的位在掩码中用1表示，否则用0表示）计算方式是当前值按位取反后再与通知值按位与运算，用计算的结果用来更新通知值，如果设置为0表示不更新通知值，如果设置为0xffffffff表示将所有位清零
参数2：函数在退出时需要清零的通知值的位的掩码。（0就是不更改通知值，0xFFFFFFFF就是将通知值设置为0）参数3：是一个uint32_t *类型的指针，用于返回接收到的通知值。
参数4：超时阻塞时间（函数在阻塞状态等待的节拍数）
返回值：是pdTRUE或pdFALSE，pdTRUE表示接收到了任务通知，包括函数一进入就读取已挂起的任务通知

如果是未挂起的任务，也就是没有任务通知任务进入阻塞状态等待任务通知。
如果任务是挂起状态，有未处理的任务通知就立刻读取通知值然后返回。
任务接收到通知或者超时则会退出阻塞状态

6、ulTaskNotifyTake()函数–二值信号量或计数信号量获取任务通知

获取任务通知，可以设置在退出此函数的时候将任务通知值清零或者减一。
当任务通知用作二值信号量或者计数信号量的时候，使用此函数来获取信号量。

在这里插入图片描述

uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;参数1：pdTRUE或pdFALSE
(1)取值为pdTRUE时，函数接收到通知并退出时将通知值清零，这种情况下是将通知值当做二值信号量使用
(2)取值为pdFALSE时，函数接收到通知并退出时将通知值减1，这种情况下是将通知值当做计数信号量使用
参数2：超时等待时间（进入阻塞状态等待任务通知的节拍数）
返回值：减1或清零之前的通知值

函数ulTaskNotifyTake()一般与函数xTaskNotifyGive()搭配使用，将任务通知值当做二值信号量或计数信号量使用。

在这里插入图片描述

在这里插入图片描述

注意：
当任务通知用作于信号量时，使用函数获取信号量：ulTaskNotifyTake()
当任务通知用作于事件标志组或队列时，使用此函数来获取： xTaskNotifyWait()

在这里插入图片描述

7、xTaskNotifyStateClear()函数-清除任务通知值

清除接收者的任务通知等待状态使其变为未挂起状态，不会将接收者的通知值清零（参数是需要操作的任务句柄，设置为NULL表示当前的任务）
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

二、任务通知传递数据

（一）任务通知值模拟二值信号量

1、目标

使用中断方式进行ADC转换，通过任务通知将ADC转换结果作为通知值发送给另外一个任务
（1）ADC1在定时器TIM3的触发下进行周期为500ms的ADC数据采集，在ADC的ISR函数里通过函数xTaskNotifyFromISR()将转换结果发送给任务Task_Show
（2）任务Task_Show总是使用函数xTaskNotifyWait()等待任务通知，读取出通知值后在LCD上显示数据

2、STM32cubemx配置

（1）复制只有LCD的cube文件并重命名

在这里插入图片描述

（2）RCC

在这里插入图片描述

(3)SYS选择TIM6作为FreeRTOS的基础时钟源
在这里插入图片描述
（4）定时器3选择内部时钟
在这里插入图片描述
TIM3挂载到APB1总线，84MHZ,如果将其划分为1khz的话，分频系数就需要设为84k
在这里插入图片描述
但是分频器最大65535，达不到8万4, 就设为8400-1获得一个10000h频率即定时0.1ms，由于希望获得到周期是500ms的延时，所以计数周期可以设置为5000-1，并且选择更新事件。
在这里插入图片描述
（5）ADC设置
选择通道5，选择定时器3触发事件，采样选择15
在这里插入图片描述
使能ADC的NVIC
在这里插入图片描述
(6)启动Freertos选择V2版本，并且对默认任务进行修改将栈空间设为256字
在这里插入图片描述
（7）设置NVIC
要在ADC的ISR中调用freertos的函数，所以ADC中断优先级不能比5高
在这里插入图片描述

生成代码

3、代码编写

（1）LCD部分
移植BSP文件夹到工程目录中并且添加相关路径到头文件中，并调用相关的头文件实现lcd的初始化和数据显示测试。 可以实现LCD的数据显示以后进行下一步
（2）main.c文件主函数
LCD初始化、LCD测试、启动定时器和ADC
在这里插入图片描述

 /* USER CODE BEGIN 2 */TFTLCD_Init();LCD_ShowString(10, 10+0*20, tftlcd_data.width, tftlcd_data.height, 12, "tasknotify test bin");//以中断方式启动adc1HAL_ADC_Start_IT(&hadc1);//启动定时器3HAL_TIM_Base_Start(&htim3);/* USER CODE END 2 */

main.h添加头文件（从main.c调用头文件处复制即可）
在这里插入图片描述

（3）Freertos代码编写

ADC1在定时器TIM3的触发下进行周期为500ms的ADC数据采集，在ADC的ISR函数里通过函数xTaskNotifyFromISR()将转换结果发送给任务Task_Show

/* USER CODE BEGIN Application */void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc)
{//由于定时器3每500ms更新一次事件，adc在500ms触发下周期性的进行adc转换，转换完就会触发这个回调函数//	//先查询是不是adc1的通道5if(hadc->Instance==ADC1)//adc1{uint32_t adc_value=HAL_ADC_GetValue(&hadc1);//获取ADC的数值，并赋值给局部变量//以任务通知的形式将数据发送给任务，且以覆写的形式进行//首先保证任务句柄存在才写入数据if(Task_showHandle!=NULL){BaseType_t pxHigherPriorityTaskWoken=pdFALSE;//默认不进行任务调度//使用ISTR写入数据函数//参数1接收数据的任务句柄，参数2:传输数值//参数3：覆写，参数4：是否进行上下文切换xTaskNotifyFromISR(Task_showHandle,adc_value,eSetValueWithOverwrite,&pxHigherPriorityTaskWoken);//防止优先级反转需要传入数值来判断推出前是否需要进行一次任务调度申请portYIELD_FROM_ISR(pxHigherPriorityTaskWoken);}}
}/* USER CODE END Application */

任务Task_Show总是使用函数xTaskNotifyWait()等待任务通知，读取出通知值后在LCD上显示数据

/* USER CODE END Header_AppTask_show */
void AppTask_show(void *argument)
{/* USER CODE BEGIN AppTask_show */uint32_t pulNotificationValue=0;//接收的值/* Infinite loop */for(;;){//参数1：函数进入时不更新通知值（0），0xffffffff表示将所有位清零//参数2：函数退出时清零所有位（0xffffffff）,0就是不更改通知值//参数3：返回的通知值，参数4：超时等待时间BaseType_t result=xTaskNotifyWait(0, 0xffffffff, &pulNotificationValue, portMAX_DELAY);if(result==pdPASS)//表示接收到了通知{uint32_t adc_value=pulNotificationValue;uint8_t data[20];sprintf(data,"adc_value=%d    ",adc_value);LCD_ShowString(10,10+2*20,tftlcd_data.width,tftlcd_data.height,12,data);sprintf(data,"volatge=%d  mv  ",adc_value*3300>>12);//>>12就是除以4096LCD_ShowString(10,10+3*20,tftlcd_data.width,tftlcd_data.height,12,data);}//没有加入vtaskdelay表明一直在等待通知值的到来}/* USER CODE END AppTask_show */
}

（二）任务通知值模拟计数型信号量

使用函数xTaskNotifyGive()发送通知，使接收者的通知值加1，使用函数ulTaskNotifyTake()读取通知，使通知值减1或清零
在这里插入图片描述
在这里插入图片描述

1、目标

使用任务通知模拟计数信号量，表示如图所示的餐厅前排队的人数变化。
在这里插入图片描述

（1）在FreeRTOS中创建一个任务Task_CheckIn，其通知值表示当前在排队的人数。
（2）在任务Task_CheckIn中连续检测key1键，当Key1键按下时执行函数ulTaskNotifyTake()使通知值减1，表示允许1人进店，使排队人数减1。
(3) 设置RTC周期唤醒周期为2秒，在周期唤醒中断里执行函数vTaskNotifyGiveFromISR()向任务Task_CheckIn发送通知，使其通知值加1，表示又来1人加入排队的队伍。

2、STM32cubemx设置

（1）复制按键和LCD的cebemx文件并重命名
在这里插入图片描述
（2）RCC设置
由于要使用RTC，开启外部低速时钟
在这里插入图片描述
（3）SYS设置Freertos基础时钟源
在这里插入图片描述
（4）启用RTC
激活RTC、周期唤醒、二进制数据、2s唤醒一次
在这里插入图片描述
使能RTC中断
在这里插入图片描述
（5）启用Freertos并修改默认任务
栈空间设置为256字
在这里插入图片描述

（6）在原来基础之上设置RTC时钟源
在这里插入图片描述

3、代码编写

（1）移植BSP文件夹到工程目录中，并且添加头文件路径到工程中以及添加lcd头文件调用，实现LCD的初始化和显示测试
（2）main.c
lcd初始化和lcd显示测试
在这里插入图片描述
main.h调用头文件
在这里插入图片描述

（3）freeRTOS代码编写

任务函数

void AppTask_CheckIn(void *argument)
{/* USER CODE BEGIN AppTask_CheckIn *//* Infinite loop */for(;;){KEYS value=key_scan(20);if(value==KEY_1)//如果是按�?1按下{//参数1：pdfalse表示计数信号量，pdfalse表示通知值不清零，进行-1操作//参数2：一直等待//返回值是上一次的通知值uint32_t precount=ulTaskNotifyTake( pdFALSE, portMAX_DELAY );uint8_t str[20];sprintf(str,"people in waiting= %d     ",precount-1);LCD_ShowString(10, 10+2*20, tftlcd_data.width, tftlcd_data.height, 12, str);vTaskDelay(300);//消抖延时}elsevTaskDelay(5);}/* USER CODE END AppTask_CheckIn */
}

RTC唤醒中断函数

void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtc)
{LED1_TOGGLE();//2s进入回调函数一次BaseType_t pxHigherPriorityTaskWoken=pdFALSE;//不进行上下文切换//参数1：写入的任务句柄，参数2：是否进行上下文切换vTaskNotifyGiveFromISR(Task_CheckInHandle, &pxHigherPriorityTaskWoken);portYIELD_FROM_ISR(pxHigherPriorityTaskWoken);
}

（1）LED1闪烁，表示RTC的中断ISR函数在执行，每2秒钟发送一次任务通知
（2）按下Key1键时， LCD上显示当前排队人数，连续按Key1键时会使排队人数减少，直到减少为0，任务Task_CheckIn就会进入阻塞等待状态。
（3）除了函数ulTaskNotifyTake()和xTaskNotifyWait()之外，没有其他函数能读取任务的当前通知值， 所以程序不能实时显示排队人数，只有在按下Key1键执行一次ulTaskNotifyTake()函数后才会显示当前排队人数

这篇关于STM32FreeRTOS任务通知(STM32cube高效开发)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/771918。

相关文章

Oracle查询优化之高效实现仅查询前10条记录的方法与实践

Oracle查询优化之高效实现仅查询前10条记录的方法与实践

《Oracle查询优化之高效实现仅查询前10条记录的方法与实践》：本文主要介绍Oracle查询优化之高效实现仅查询前10条记录的相关资料,包括使用ROWNUM、ROW_NUMBER()函数、FET... 目录1. 使用 ROWNUM 查询2. 使用 ROW_NUMBER() 函数3. 使用 FETCH FI
阅读更多...
在C#中获取端口号与系统信息的高效实践

在C#中获取端口号与系统信息的高效实践

《在C#中获取端口号与系统信息的高效实践》在现代软件开发中,尤其是系统管理、运维、监控和性能优化等场景中,了解计算机硬件和网络的状态至关重要,C#作为一种广泛应用的编程语言,提供了丰富的API来帮助开... 目录引言1. 获取端口号信息1.1 获取活动的 TCP 和 UDP 连接说明：应用场景：2. 获取硬
阅读更多...
基于Python开发电脑定时关机工具

基于Python开发电脑定时关机工具

《基于Python开发电脑定时关机工具》这篇文章主要为大家详细介绍了如何基于Python开发一个电脑定时关机工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 简介2. 运行效果3. 相关源码1. 简介这个程序就像一个“忠实的管家”，帮你按时关掉电脑，而且全程不需要你多做
阅读更多...
Python实现高效地读写大型文件

Python实现高效地读写大型文件

《Python实现高效地读写大型文件》Python如何读写的是大型文件,有没有什么方法来提高效率呢,这篇文章就来和大家聊聊如何在Python中高效地读写大型文件,需要的可以了解下... 目录一、逐行读取大型文件二、分块读取大型文件三、使用 mmap 模块进行内存映射文件操作（适用于大文件）四、使用 pand
阅读更多...
高效管理你的Linux系统: Debian操作系统常用命令指南

高效管理你的Linux系统: Debian操作系统常用命令指南

《高效管理你的Linux系统:Debian操作系统常用命令指南》在Debian操作系统中，了解和掌握常用命令对于提高工作效率和系统管理至关重要，本文将详细介绍Debian的常用命令，帮助读者更好地使... Debian是一个流行的linux发行版，它以其稳定性、强大的软件包管理和丰富的社区资源而闻名。在使用
阅读更多...
Java中的Opencv简介与开发环境部署方法

Java中的Opencv简介与开发环境部署方法

《Java中的Opencv简介与开发环境部署方法》OpenCV是一个开源的计算机视觉和图像处理库,提供了丰富的图像处理算法和工具,它支持多种图像处理和计算机视觉算法,可以用于物体识别与跟踪、图像分割与... 目录1.Opencv简介Opencv的应用2.Java使用OpenCV进行图像操作opencv安装j
阅读更多...
Python Invoke自动化任务库的使用

Python Invoke自动化任务库的使用

《PythonInvoke自动化任务库的使用》Invoke是一个强大的Python库,用于编写自动化脚本,本文就来介绍一下PythonInvoke自动化任务库的使用,具有一定的参考价值,感兴趣的可以... 目录什么是 Invoke？如何安装 Invoke？Invoke 基础1. 运行测试2. 构建文档3.
阅读更多...
解决Cron定时任务中Pytest脚本无法发送邮件的问题

解决Cron定时任务中Pytest脚本无法发送邮件的问题

《解决Cron定时任务中Pytest脚本无法发送邮件的问题》文章探讨解决在Cron定时任务中运行Pytest脚本时邮件发送失败的问题,先优化环境变量,再检查Pytest邮件配置,接着配置文件确保SMT... 目录引言1. 环境变量优化：确保Cron任务可以正确执行解决方案：1.1. 创建一个脚本1.2. 修
阅读更多...
Java实现任务管理器性能网络监控数据的方法详解

Java实现任务管理器性能网络监控数据的方法详解

《Java实现任务管理器性能网络监控数据的方法详解》在现代操作系统中,任务管理器是一个非常重要的工具,用于监控和管理计算机的运行状态,包括CPU使用率、内存占用等,对于开发者和系统管理员来说,了解这些... 目录引言一、背景知识二、准备工作1. Maven依赖2. Gradle依赖三、代码实现四、代码详解五
阅读更多...
如何使用celery进行异步处理和定时任务(django)

如何使用celery进行异步处理和定时任务(django)

《如何使用celery进行异步处理和定时任务(django)》文章介绍了Celery的基本概念、安装方法、如何使用Celery进行异步任务处理以及如何设置定时任务,通过Celery,可以在Web应用中... 目录一、celery的作用二、安装celery三、使用celery 异步执行任务四、使用celery
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2