FreeRTOS 快速入门(八)之任务通知

2024-08-26 06:12

本文主要是介绍FreeRTOS 快速入门(八)之任务通知,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

  • 一、任务通知
    • 1、基本概念
    • 2、优势及限制
    • 3、通知状态和通知值
  • 二、任务通知的使用
    • 1、xTaskNotifyGive/ulTaskNotifyTake
    • 2、xTaskNotify/xTaskNotifyWait
    • 3、xTaskNotifyAndQuery


一、任务通知

1、基本概念

FreeRTOS 从 V8.2.0 版本开始提供任务通知这个功能,每个任务都有 一个 32 位 的通知值,在大多数情况下,任务通知可以 替代二值信号量、计数信号量、事件组,也可以替代长度为 1 的队列(可以保存一个 32 位整数或指针值)。

相对于以前使用 FreeRTOS 内核通信的资源,必须创建队列、二进制信号量、计数信号量或事件组的情况,使用任务通知显然更灵活。按照 FreeRTOS 官方的说法,使用任务通知比通过信号量等 ICP 通信方式解除阻塞的任务要快 45%,并且更加省 RAM 内存空间(使用 GCC 编译器,-o2 优化级别),任务通知的使用无需创建队列。

想要使用任务通知,必须将 FreeRTOSConfig.h 中的宏定义 configUSE_TASK_NOTIFICATIONS 设置为 1,其实FreeRTOS 默认是为 1 的,所以任务通知是默认使能的。

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

  • 发送通知给任务, 如果有通知未读,不覆盖通知值。
  • 发送通知给任务,直接覆盖通知值。
  • 发送通知给任务,设置通知值的一个或者多个位 ,可以当做事件组来使用。
  • 发送通知给任务,递增通知值,可以当做计数信号量使用。

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

2、优势及限制

任务通知的优势:

  • 效率更高:使用任务通知来发送事件、数据给某个任务时,效率更高。比队列、信号量、事件组都有大的优势。
  • 更节省内存:使用其他方法时都要先创建对应的结构体,使用任务通知时无需额外创建结构体。

任务通知的限制:

  • 不能发送数据给 ISR:ISR 并没有任务结构体,所以无法使用任务通知的功能给 ISR 发送数据。但是 ISR 可以使用任务通知的功能,发数据给任务。
  • 数据只能给该任务独享
  • 无法缓冲数据
  • 无法广播给多个任务
  • 如果发送受阻,发送方无法进入阻塞状态等待

3、通知状态和通知值

每个任务都有一个结构体:TCB(Task Control Block),里面有 2 个成员:

  • 一个是 uint8_t 类型,用来表示通知状态
  • 一个是 uint32_t 类型,用来表示通知值
typedef struct tskTaskControlBlock
{....../* configTASK_NOTIFICATION_ARRAY_ENTRIES = 1 */volatile uint32_t ulNotifiedValue[ configTASK_NOTIFICATION_ARRAY_ENTRIES ];volatile uint8_t ucNotifyState[ configTASK_NOTIFICATION_ARRAY_ENTRIES ];......
} tskTCB;

通知状态有 3 种取值:

  • taskNOT_WAITING_NOTIFICATION:任务没有在等待通知
  • taskWAITING_NOTIFICATION:任务在等待通知
  • taskNOTIFICATION_RECEIVED:任务接收到了通知,也被称为 pending(有数据了,待处理)
#define taskNOT_WAITING_NOTIFICATION ( ( uint8_t ) 0 ) /* 也是初始状态 */
#define taskWAITING_NOTIFICATION ( ( uint8_t ) 1 )
#define taskNOTIFICATION_RECEIVED ( ( uint8_t ) 2 )

通知值可以有很多种类型:

  • 计数值
  • 位(类似事件组)
  • 任意数值

二、任务通知的使用

使用任务通知,可以实现轻量级的队列(长度为 1)、邮箱(覆盖的队列)、计数型信号量、二进制信号量、事件组。

任务通知有两套函数,简化版、专业版,列表如下:

  • 简化版函数的使用比较简单,它实际上也是使用专业版函数实现的
  • 专业版函数支持很多参数,可以实现很多功能
简化版专业版
发出通知xTaskNotifyGive
vTaskNotifyGiveFromISR
xTaskNotify
xTaskNotifyFromISR
取出通知ulTaskNotifyTakexTaskNotifyWait

1、xTaskNotifyGive/ulTaskNotifyTake

在任务中使用 xTaskNotifyGive 函数,在 ISR 中使用 vTaskNotifyGiveFromISR 函数,都是直接给其他任务
发送通知:

  • 使得通知值加一
  • 并使得通知状态变为"pending",也就是 taskNOTIFICATION_RECEIVED,表示有数据了、待处理

可以使用 ulTaskNotifyTake 函数来取出通知值:

  • 如果通知值等于 0,则阻塞(可以指定超时时间)
  • 当通知值大于 0 时,任务从阻塞态进入就绪态
  • ulTaskNotifyTake 返回之前,还可以做些清理工作:把通知值减一,或者把通知值清零

使用 ulTaskNotifyTake 函数可以实现轻量级的、高效的二进制信号量、计数型信号量。

原型如下:

/** xTaskToNotify : 任务句柄(创建任务时得到),给哪个任务发通知* 返回值 : 必定返回pdPASS*/
BaseType_t xTaskNotifyGive( TaskHandle_t xTaskToNotify );/** xTaskHandle : 任务句柄(创建任务时得到),给哪个任务发通知* pxHigherPriorityTaskWoken : 被通知的任务,可能正处于阻塞状态。此函数发出通知后,会把它从阻塞状态切换为就绪态。如果被唤醒的任务的优先级,高于当前任务的优先级,则 *pxHigherPriorityTaskWoken 被设置为pdTRUE,这表示在中断返回之前要进行任务切换。*/
void vTaskNotifyGiveFromISR( TaskHandle_t xTaskHandle, BaseType_t*pxHigherPriorityTaskWoken );/** xClearCountOnExit : 函数返回前是否清零:*                    pdTRUE:把通知值清零*                    pdFALSE:如果通知值大于0,则把通知值减一* xTicksToWait : 任务进入阻塞态的超时时间,它在等待通知值大于0。*                 0:不等待,即刻返回;*                 portMAX_DELAY:一直等待,直到通知值大于0;*                 其他值:Tick Count,可以用pdMS_TO_TICKS() 把ms转换为Tick Count*/
uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait);

2、xTaskNotify/xTaskNotifyWait

xTaskNotify 函数功能更强大,可以使用不同参数实现各类功能,比如:

  • 让接收任务的通知值加一:这时 xTaskNotify() 等同于 xTaskNotifyGive()
  • 设置接收任务的通知值的某一位、某些位,这就是一个轻量级的、更高效的事件组
  • 把一个新值写入接收任务的通知值:上一次的通知值被读走后,写入才成功。这就是轻量级的、长度为1的队列
  • 用一个新值覆盖接收任务的通知值:无论上一次的通知值是否被读走,覆盖都成功。类似 xQueueOverwrite() 函数,这就是轻量级的邮箱。

xTaskNotify()xTaskNotifyGive() 更灵活、强大,使用上也就更复杂。xTaskNotifyFromISR() 是它对应的 ISR 版本。

使用 xTaskNotifyWait() 函数来取出任务通知。它比 ulTaskNotifyTake() 更复杂:

  • 可以让任务等待(可以加上超时时间),等到任务状态为"pending"(也就是有数据)
  • 还可以在函数进入、退出时,清除通知值的指定位

原型如下:

/** xTaskToNotify:接收通知的任务句* ulValue:用于更新接收任务通知的任务通知值,具体如何更新由形参 eAction 决定* eAction:任务通知值更新方式,具体见下面表格* 返回值:参数 eAction 为 eSetValueWithoutOverwrite 时,如果被通知任务还没取走上一个通知,又接收到了一个通知,则这次通知值未能更新并返回 pdFALSE,而其他情况均返回 pdPASS*/
BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue,eNotifyAction eAction );/** xTaskToNotify:接收通知的任务句* ulValue:用于更新接收任务通知的任务通知值,具体如何更新由形参 eAction* eAction:任务通知值更新方式,具体见下面表格* pxHigherPriorityTaskWoken:在使用之前必须先初始化为 pdFALSE。当调用该函数发送一个任务通知时,目标任务接收到通知后将从阻塞态变为就绪态,并且如果其优先级比当前运行的任务的优先级高,那么 *pxHigherPriorityTaskWoken 会被设置为 pdTRUE,然后在中断退出前执行一次上下文切换,去执行刚刚被唤醒的中断优先级较高的任务。pxHigherPriorityTaskWoken 是一个可选的参数可以设置为 NULL* 返回值:参数 eAction 为 eSetValueWithoutOverwrite 时,如果被通知任务还没取走上一个通知,又接收到了一个通知,则这次通知值未能更新并返回 pdFALSE,而其他情况均返回 pdPASS*/
BaseType_t xTaskNotifyFromISR( TaskHandle_t xTaskToNotify,uint32_t ulValue,eNotifyAction eAction,BaseType_t *pxHigherPriorityTaskWoken );/** ulBitsToClearOnEntry:ulBitsToClearOnEntry 表示在使用通知之前,将任务通知值的哪些位清 0,实现过程就是将任务的通知值与参数 ulBitsToClearOnEntry 的按位取反值按位与操作。如果 ulBitsToClearOnEntry 设置为 0x01,那么在函数进入前,任务通知值的位1会被清0,其他位保持不变。如果 ulBitsToClearOnEntry 设置为 0xFFFFFFFF (ULONG_MAX),那么在进入函数前任务通知值的所有位都会被清 0,表示清零任务通知值* pulNotificationValue:用于保存接收到的任务通知值。如果接收到的任务通知不需要使用,则设置为 NULL 即可。这个通知值在参数 ulBitsToClearOnExit 起作用前将通知值拷贝到 *pulNotificationValue 中* xTicksToWait:等待超时时间,单位为系统节拍周期。宏 pdMS_TO_TICKS 用于将单位毫秒转化为系统节拍数* 返回值:如果获取任务通知成功则返回 pdTRUE,失败则返回 pdFALSE*/
BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry,uint32_t ulBitsToClearOnExit,uint32_t *pulNotificationValue,TickType_t xTicksToWait );

其中,eAcrtion 的取值如下:

eAction 取值含义
eNoAction对象任务接收任务通知,但是任务自身的任务通知值不更新,即形参 ulValue 没有用。
eSetBits对象任务接收任务通知,同时任务自身的任务通知值与 ulValue 按位或。
如果 ulValue 设置为 0x01,那么任务的通知值的位 0 将被置为 1。
同样的如果 ulValue 设置为 0x04,那么任务的通知值的位 2 将被置为 1。
在这种方式下,任务通知可以看成是事件标志的一种轻量型的实现,速度更快。
eIncrement对象任务接收任务通知,任务自身的任务通知值加 1,即形参ulValue 没有用。
这个时候调用 xTaskNotify() 等同于调用 xTaskNotifyGive()。
eSetValueWithOverwrite对象任务接收任务通知,且任务自身的任务通知值会无条件的被设置为 ulValue。
在这种方式下,任务通知可以看成是函数 xQueueOverwrite() 的一种轻量型的实现,速度更快。
eSetValueWithoutOverwrite对象任务接收任务通知,且对象任务没有通知值,那么通知值就会被设置为 ulValue。
对象任务接收任务通知,但是上一次接收到的通知值并没有取走,那么本次的通知值将不会更新,同时函数返回 pdFALSE。
在这种方式下,任务通知可以看成是函数 xQueueSend() 应用在队列深度为 1 的队列上的一种轻量型实现,速度更快。

3、xTaskNotifyAndQuery

xTaskNotifyAndQuery()xTaskNotify() 很像,都是调用通用的任务通知发送函数 xTaskGenericNotify() 来实现通知的发送,不同的是多了一个附加的参数 pulPreviousNotifyValue 用于回传接收任务的上一个通知值。

xTaskNotifyAndQuery() 函数不能用在中断中,而是必须使用带中断保护功能的 xTaskNotifyAndQuery()FromISR 来代替。

/** xTaskToNotify:接收通知的任务句* ulValue:用于更新接收任务通知的任务通知值,具体如何更新由形参 eAction 决定* eAction:任务通知值更新方式,具体见上面表格* pulPreviousNotifyValue:对象任务的上一个任务通知值,如果为 NULL,则不需要回传,这个时候就等价于函数 xTaskNotify()* 返回值:参数 eAction 为 eSetValueWithoutOverwrite 时,如果被通知任务还没取走上一个通知,又接收到了一个通知,则这次通知值未能更新并返回 pdFALSE,而其他情况均返回 pdPASS*/
BaseType_t xTaskNotifyAndQuery( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotifyValue )/** xTaskToNotify:接收通知的任务句* ulValue:用于更新接收任务通知的任务通知值,具体如何更新由形参 eAction 决定* eAction:任务通知值更新方式,具体见上面表格* pulPreviousNotifyValue:对象任务的上一个任务通知值,如果为 NULL,则不需要回传,这个时候就等价于函数 xTaskNotify()* pxHigherPriorityTaskWoken:在使用之前必须先初始化为 pdFALSE。当调用该函数发送一个任务通知时,目标任务接收到通知后将从阻塞态变为就绪态,并且如果其优先级比当前运行的任务的优先级高,那么 *pxHigherPriorityTaskWoken 会被设置为 pdTRUE,然后在中断退出前执行一次上下文切换,去执行刚刚被唤醒的中断优先级较高的任务。pxHigherPriorityTaskWoken 是一个可选的参数可以设置为 NULL* 返回值:参数 eAction 为 eSetValueWithoutOverwrite 时,如果被通知任务还没取走上一个通知,又接收到了一个通知,则这次通知值未能更新并返回 pdFALSE,而其他情况均返回 pdPASS*/
BaseType_t xTaskNotifyAndQueryFromISR(  TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotifyValue, BaseType_t *pxHigherPriorityTaskWoken )

这篇关于FreeRTOS 快速入门(八)之任务通知的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1107772

相关文章

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门(一):登录与退出》 《Spring-Security-入门(二):基于数据库验证》 《Spring-Security-入门(三):密码加密》 《Spring-Security-入门(四):自定义-Filter》 《Spring-Security-入门(五):在 Sprin

电脑桌面文件删除了怎么找回来?别急,快速恢复攻略在此

在日常使用电脑的过程中,我们经常会遇到这样的情况:一不小心,桌面上的某个重要文件被删除了。这时,大多数人可能会感到惊慌失措,不知所措。 其实,不必过于担心,因为有很多方法可以帮助我们找回被删除的桌面文件。下面,就让我们一起来了解一下这些恢复桌面文件的方法吧。 一、使用撤销操作 如果我们刚刚删除了桌面上的文件,并且还没有进行其他操作,那么可以尝试使用撤销操作来恢复文件。在键盘上同时按下“C

数论入门整理(updating)

一、gcd lcm 基础中的基础,一般用来处理计算第一步什么的,分数化简之类。 LL gcd(LL a, LL b) { return b ? gcd(b, a % b) : a; } <pre name="code" class="cpp">LL lcm(LL a, LL b){LL c = gcd(a, b);return a / c * b;} 例题:

Java 创建图形用户界面(GUI)入门指南(Swing库 JFrame 类)概述

概述 基本概念 Java Swing 的架构 Java Swing 是一个为 Java 设计的 GUI 工具包,是 JAVA 基础类的一部分,基于 Java AWT 构建,提供了一系列轻量级、可定制的图形用户界面(GUI)组件。 与 AWT 相比,Swing 提供了许多比 AWT 更好的屏幕显示元素,更加灵活和可定制,具有更好的跨平台性能。 组件和容器 Java Swing 提供了许多

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站,手机流量可以访问IPV6网络的服务,为什么不在电脑搭建Home Assistant(hass),来控制你的设备呢?@智能家居 @万物互联

poj 2104 and hdu 2665 划分树模板入门题

题意: 给一个数组n(1e5)个数,给一个范围(fr, to, k),求这个范围中第k大的数。 解析: 划分树入门。 bing神的模板。 坑爹的地方是把-l 看成了-1........ 一直re。 代码: poj 2104: #include <iostream>#include <cstdio>#include <cstdlib>#include <al

hdu 4565 推倒公式+矩阵快速幂

题意 求下式的值: Sn=⌈ (a+b√)n⌉%m S_n = \lceil\ (a + \sqrt{b}) ^ n \rceil\% m 其中: 0<a,m<215 0< a, m < 2^{15} 0<b,n<231 0 < b, n < 2^{31} (a−1)2<b<a2 (a-1)^2< b < a^2 解析 令: An=(a+b√)n A_n = (a +

MySQL-CRUD入门1

文章目录 认识配置文件client节点mysql节点mysqld节点 数据的添加(Create)添加一行数据添加多行数据两种添加数据的效率对比 数据的查询(Retrieve)全列查询指定列查询查询中带有表达式关于字面量关于as重命名 临时表引入distinct去重order by 排序关于NULL 认识配置文件 在我们的MySQL服务安装好了之后, 会有一个配置文件, 也就

v0.dev快速开发

探索v0.dev:次世代开发者之利器 今之技艺日新月异,开发者之工具亦随之进步不辍。v0.dev者,新兴之开发者利器也,迅速引起众多开发者之瞩目。本文将引汝探究v0.dev之基本功能与优势,助汝速速上手,提升开发之效率。 何谓v0.dev? v0.dev者,现代化之开发者工具也,旨在简化并加速软件开发之过程。其集多种功能于一体,助开发者高效编写、测试及部署代码。无论汝为前端开发者、后端开发者

音视频入门基础:WAV专题(10)——FFmpeg源码中计算WAV音频文件每个packet的pts、dts的实现

一、引言 从文章《音视频入门基础:WAV专题(6)——通过FFprobe显示WAV音频文件每个数据包的信息》中我们可以知道,通过FFprobe命令可以打印WAV音频文件每个packet(也称为数据包或多媒体包)的信息,这些信息包含该packet的pts、dts: 打印出来的“pts”实际是AVPacket结构体中的成员变量pts,是以AVStream->time_base为单位的显