当前位置: 首页 > news >正文

FreeRTOS任务通知

一、什么是任务通知

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

                        (也就是说,一个任务被创建的时候,就会有一个任务通知)

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

任务通知值的更新方式

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

  • 发送消息给任务,如果有通知未读,不覆盖通知值
  • 发送消息给任务,直接覆盖通知值
  • 发送消息给任务,设置通知值的一个或者多个位
  • 发送消息给任务,递增通知值

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

任务通知的优势
  1. 使用任务通知向任务发送事件或数据,比使用队列、事件标志组或信号量快得多
  2. 使用其它方法时都要先创建对应的结构体,使用任务通知时无需额外创建结构体

任务通知的劣势

  1. 只有任务可以等待通知,中断服务函数中不可以,一位中断没有TCB。(任务创建时内存开辟的空间)
  2. 通知只能一对一,因为通知必须指定任务。
  3. 等待通知的任务可以被阻塞,但是发送消息的任务,任何情况下都不会被阻塞等待。
  4. 任务通知时通过更新任务通知值来发送数据的,任务结构体中只有一个任务通知值,只能保持一个数据。

二、相关API函数

1.发送通知

函数描述
xTaskNotify()发送通知,带有通知值
xTaskNotifyAndQuery()发送通知,带有通知值并且保留接受任务的原通知值
xTaskNotifyGive()发送通知,不带有通知值
xTaskNotifyFromISR()在中断中发送任务通知
xTaskNotifyAndQueryFromISR()在中断中发送任务通知
xTaskNotifyGiveFromISR()在中断中发送任务通知

 

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

参数:

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

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

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

枚举值描述
eNoAction发送通知,但不更新值(参数ulValue未使用)
eSetBits被通知任务的通知值按位或ulValue。(某些场景下可代替事件组,效率更高)
elncrement被通知任务的通知值加1(参数ulValue未使用),相当于xTaskNotifyGive (信号量)
eSetValueWithOverWrite被通知任务的通知值设置为ulValue。(某些场景下可代替xQueueOverwrite,效率更高)(队列覆写)
eSetValueWithoutOverwrite

如果被通知的任务当前没有通知,则被通知的任务的通知值设为ulValue。

如果被通知任务没有取走上一个通知,由接收到一个通知,则这次通知值丢弃,在这种情况下视为调用失败并返回pdFALSE

(某些场景下可带起xQueueSend,效率更高)

(没有被取走,就会阻塞等待)

返回值:

前面四个的返回值,都是pdPASS,最后一个,当通知没有取走,就会返回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.等待通知

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

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

参数:

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

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

返回值:

0:接收失败

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

uint32_t xTaskNotifyWait (uint32_t ulBitsToClearOnEntry,uint32_t ulBitsToClearOnExit,uint32_t *pulPreviousNotifyValue,TickType_t xTicksToWait);

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

ulBitsToClearOnExit:表示在函数退出前,清零任务通知值那些位,(置1)在清零前,接收到的任务通知值会先被保存到形参*pulPreviousNotifyValue中。(0xffff ffff) (一个 ’f‘ 4位1,8个 ’f‘ 刚好32位)

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

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

接下来实操一下

http://www.xdnf.cn/news/6751.html

相关文章:

  • 51单片机实验五:A/D和D/A转换
  • 前端:uniapp框架中<scroll-view>r如何控制元素进行局部滚动
  • ASP.NET MVC 实现增删改查(CRUD)操作的完整示例
  • 从代码学习深度学习 - 小批量随机梯度下降 PyTorch 版
  • Spring Boot启动流程深度解析:从main()到应用就绪的完整旅程
  • Starrocks 数据均衡DiskAndTabletLoadReBalancer的实现
  • 使用Lean 4和C#进行数学定理证明与逻辑推理
  • RAG 实战|用 StarRocks + DeepSeek 构建智能问答与企业知识库
  • edge browser for linux debian
  • 23种设计模式-创建型模式之建造者模式(Java版本)
  • AWS上构建基于自然语言的数值和符号计算系统
  • 设计模式每日硬核训练 Day 15:享元模式(Flyweight Pattern)完整讲解与实战应用
  • MCP协议在纳米材料领域的深度应用:从跨尺度协同到智能研发范式重构
  • spring响应式编程系列:总体流程
  • Ubuntu18.04安装Qt5.12
  • 在PyCharm中部署AI模型的完整指南
  • 鸿蒙-跨设备互通,设备互通提供跨设备的相机、扫描、图库访问能力,平板或2in1设备可以调用手机的相机、扫描、图库等功能。
  • 【VSCode】在 VSCode 中运行 HTML 页面并通过 HTTPS 访问
  • 在pycharm中搭建yolo11分类检测系统--PyQt5学习(二)
  • 发现“横”字手写有难度,对比两个“横”字
  • CSS3笔记
  • 小知识合集 慢慢更新
  • vue,uniapp解决h5跨域问题
  • uniapp打包IOS私钥证书过期了,如何在非mac系统操作
  • PDK中technology file从tf格式转换为lef格式
  • 【AI插件开发】Notepad++ AI插件开发实践:支持配置界面
  • 双轮驱动能源革命:能源互联网与分布式能源赋能工厂能效跃迁
  • 在Ubuntu系统中安装和升级RabbitVCS
  • 【教程】无视硬件限制强制升级Windows 11
  • 《数据结构之美--链表oj练习》