FreeRTOS 24：事件组EventGroup等待、清零、获取操作

等待事件标志位xEventGroupWaitBits()

既然标记了事件的发生，那么我怎么知道他到底有没有发生，这也是需要一个函数来获 取 事 件 是 否 已 经 发 生 ， FreeRTOS 提 供 了 一 个 等 待 指 定 事 件 的 函 数 — —
xEventGroupWaitBits()，通过这个函数， 任务可以知道事件标志组中的哪些位，有什么事件发生了， 然后通过 “逻辑与”、“逻辑或”等操作对感兴趣的事件进行获取，并且这个函数实现了等待超时机制， 当且仅当任务等待的事件发生时，任务才能获取到事件信息。在这段时间中，如果事件一直没发生，该任务将保持阻塞状态以等待事件发生。当其它任务或中断服务程序往其等待的事件设置对应的标志位，该任务将自动由阻塞态转为就绪态。当任务等待的时间超过了指定的阻塞时间，即使事件还未发生，任务也会自动从阻塞态转移为就绪态。这样子很有效的体现了操作系统的实时性，如果事件正确获取（等待到） 则返回对应的事件标志位，由用户判断再做处理， 因为在事件超时的时候也会返回一个不能确定的事件值，所以需要判断任务所等待的事件是否真的发生。

EventGroupWaitBits()用于获取事件组中的一个或多个事件发生标志， 当要读取的事件标 志 位 没 有 被 置 位 时 任 务 将 进 入 阻 塞 等 待 状 态 。

EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToWaitFor,const BaseType_t xClearOnExit,const BaseType_t xWaitForAllBits,TickType_t xTicksToWait )
{EventGroup_t * pxEventBits = xEventGroup;EventBits_t uxReturn, uxControlBits = 0;BaseType_t xWaitConditionMet, xAlreadyYielded;BaseType_t xTimeoutOccurred = pdFALSE;// 检查用户是否尝试等待内核自身使用的位，并且至少请求了一个位configASSERT( xEventGroup );configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 );configASSERT( uxBitsToWaitFor != 0 );#if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ){configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );}#endifvTaskSuspendAll();{const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits;// 检查等待条件是否已经满足xWaitConditionMet = prvTestWaitCondition( uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits );if( xWaitConditionMet != pdFALSE ){// 等待条件已经满足，无需阻塞uxReturn = uxCurrentEventBits;xTicksToWait = ( TickType_t ) 0;// 如果需要，清除等待的位if( xClearOnExit != pdFALSE ){pxEventBits->uxEventBits &= ~uxBitsToWaitFor;}else{mtCOVERAGE_TEST_MARKER();}}else if( xTicksToWait == ( TickType_t ) 0 ){// 等待条件未满足，但未指定阻塞时间，直接返回当前值uxReturn = uxCurrentEventBits;xTimeoutOccurred = pdTRUE;}else{// 任务将阻塞等待所需位被设置// 使用控制位记录此调用的行为if( xClearOnExit != pdFALSE ){uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT;}else{mtCOVERAGE_TEST_MARKER();}if( xWaitForAllBits != pdFALSE ){uxControlBits |= eventWAIT_FOR_ALL_BITS;}else{mtCOVERAGE_TEST_MARKER();}// 将调用任务等待的位存储在任务的事件列表项中，以便内核知道何时找到匹配项vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait );// 这是过时的，但在某些编译器中如果不这样做会生成警告uxReturn = 0;traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor );}}xAlreadyYielded = xTaskResumeAll();if( xTicksToWait != ( TickType_t ) 0 ){if( xAlreadyYielded == pdFALSE ){portYIELD_WITHIN_API();}else{mtCOVERAGE_TEST_MARKER();}// 任务阻塞等待所需位被设置，此时要么所需位已被设置，要么阻塞时间已到期// 如果所需位已被设置，它们将存储在任务的事件列表项中，现在应检索并清除uxReturn = uxTaskResetEventItemValue();if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 ){taskENTER_CRITICAL();{// 任务超时，返回当前事件位值uxReturn = pxEventBits->uxEventBits;// 可能在任务离开阻塞状态和再次运行之间更新了事件位if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE ){if( xClearOnExit != pdFALSE ){pxEventBits->uxEventBits &= ~uxBitsToWaitFor;}else{mtCOVERAGE_TEST_MARKER();}}else{mtCOVERAGE_TEST_MARKER();}xTimeoutOccurred = pdTRUE;}taskEXIT_CRITICAL();}else{// 任务因位被设置而解除阻塞}// 任务阻塞，因此可能设置了控制位uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES;}traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred );// 防止编译器警告( void ) xTimeoutOccurred;return uxReturn;
}

xEventGroupWaitBits 函数用于等待事件组中的特定事件位被设置。具体功能和步骤如下：

  1. 参数检查：

    • 检查传入的事件组是否有效。

    • 检查等待的位是否包含内核自身使用的位。

    • 检查至少请求了一个位。

    • 如果配置了 INCLUDE_xTaskGetSchedulerState 或 configUSE_TIMERS，则检查调度器是否暂停并且等待时间不为零。

  2. 任务调度暂停：

    • 暂停任务调度，防止其他任务干扰。

  3. 检查当前事件位：

    • 获取当前事件位。

    • 检查等待条件是否已经满足。

      • 如果满足，直接返回当前事件位，并根据需要清除这些位。

      • 如果不满足且未指定阻塞时间，直接返回当前事件位并设置超时标志。

      • 如果不满足且指定了阻塞时间，将任务加入等待队列。

  4. 任务阻塞：

    • 根据需要设置控制位，记录任务的行为。

    • 将任务加入等待队列，等待所需事件位被设置。

    • 恢复任务调度。

  5. 任务唤醒：

    • 如果任务因事件位被设置而唤醒，返回当前事件位。

    • 如果任务因超时而唤醒，返回当前事件位并设置超时标志。

  6. 清除控制位：

    • 返回前清除控制位，防止影响后续操作。

清零事件标志位

xEventGroupClearBits()与 xEventGroupClearBitsFromISR()都是用于清除事件组指定的位， 如果在获取事件的时候没有将对应的标志位清除， 那么就需要用这个函数来进行显式清除， xEventGroupClearBits()函数不能在中断中使用，而是由具有中断保护功能 的xEventGroupClearBitsFromISR() 来代替，中断清除事件标志位的操作在守护任务（也叫定时 器 服 务 任 务 ） 里 面 完 成 。 守 护 进 程 的 优 先 级 由 FreeRTOSConfig.h 中 的 宏configTIMER_TASK_PRIORITY 来 定 义 。

xEventGroupClearBits()清零事件标志位

EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToClear )
{EventGroup_t * pxEventBits = xEventGroup;EventBits_t uxReturn;/* 检查用户是否尝试清除内核自身使用的位 */configASSERT( xEventGroup );configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 );taskENTER_CRITICAL();{traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear );/* 返回值是清除位之前的事件组值 */uxReturn = pxEventBits->uxEventBits;/* 清除指定的位 */pxEventBits->uxEventBits &= ~uxBitsToClear;}taskEXIT_CRITICAL();return uxReturn;
}

函数 xEventGroupClearBits，用于清除事件组中的指定位。

  1. 参数检查：

    • configASSERT( xEventGroup );：检查事件组句柄是否有效。
    • configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 );：确保要清除的位不包含内核保留的位。

  2. 进入临界区：

    • taskENTER_CRITICAL();：进入临界区，防止多任务环境下的并发问题。

  3. 记录当前事件组值：

    • uxReturn = pxEventBits->uxEventBits;：在清除位之前，记录当前事件组的值。

  4. 清除指定位：

    • pxEventBits->uxEventBits &= ~uxBitsToClear;：通过按位与操作清除指定的位。

  5. 退出临界区：

    • taskEXIT_CRITICAL();：退出临界区。

  6. 返回结果：

    • return uxReturn;：返回清除位之前的事件组值。

xEventGroupClearBitsFromISR()在中断中清零事件标志位

#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) )BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup,const EventBits_t uxBitsToClear )
{BaseType_t xReturn;// 记录从中断服务例程清除事件组位的操作traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear );// 将清除位的操作挂起到调度器，以便在合适的时机执行xReturn = xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL ); /*lint !e9087 无法避免将指针强制转换为 void*，因为这是一个通用的回调函数，不是特定于此用例的。回调会将指针重新转换为原始类型，因此是安全的。 */// 返回挂起结果return xReturn;
}#endif /* if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) ) */

函数 xEventGroupClearBitsFromISR，用于在中断服务例程（ISR）中清除事件组中的指定位。具体功能如下：

  1. 参数检查：无显式的参数检查，但通过调用 xTimerPendFunctionCallFromISR 来确保安全。

  2. 记录事件：记录从中断服务例程清除事件组位的操作。

  3. 挂起函数调用：使用 xTimerPendFunctionCallFromISR 将清除位的操作挂起到调度器，以便在合适的时机执行。

  4. 返回结果：返回 xTimerPendFunctionCallFromISR 的结果，指示是否成功挂起函数调用。

获取事件组中各事件标志位的值xEventGroupGetBits()

EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup )
{UBaseType_t uxSavedInterruptStatus;EventGroup_t const * const pxEventBits = xEventGroup;EventBits_t uxReturn;// 保存当前的中断状态，防止中断嵌套uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();{// 从事件组中读取当前的位值uxReturn = pxEventBits->uxEventBits;}// 恢复中断状态portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );// 返回事件组的当前位值return uxReturn;
} /*lint !e818 EventGroupHandle_t 是一个在其他函数中使用的 typedef，因此不能是指向常量的指针。*//*lint !e818 EventGroupHandle_t is a typedef used in other functions to so can't be pointer to const. */

函数 xEventGroupGetBitsFromISR，用于在中断服务例程（ISR）中获取事件组的当前位。具体功能如下：

  1. 保存中断状态：使用 portSET_INTERRUPT_MASK_FROM_ISR 保存当前的中断状态，防止中断嵌套。

  2. 获取事件组位：从事件组中读取当前的位值。

  3. 恢复中断状态：使用 portCLEAR_INTERRUPT_MASK_FROM_ISR 恢复中断状态。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/web/59039.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

在线绘制带community的蛋白质-蛋白质相互作用（PPI）网络图

在线绘制带community的蛋白质-蛋白质相互作用（PPI）网络图

导读：分子相互作用网络图揭示了细胞内部分子间的复杂相互作用。通过识别网络中密集连接的节点所形成的社区（community），可以揭示它们之间以前未知的功能联系。这些社区可能代表了具有共同功能的功能模块，对于理解细胞生…
阅读更多...
qt QTableView详解

qt QTableView详解

1、概述 QTableView 是 Qt 框架中的一个高级视图类，用于以表格形式展示二维数据。它基于 QAbstractItemView，并与模型（通常是 QAbstractTableModel 或 QStandardItemModel）结合使用，以实现数据的展示和交互。QTableVi…
阅读更多...
Orleans集群及Placement设置

Orleans集群及Placement设置

服务端界面使用相同的clusterid和serviceid，相同ip地址，不同网关端口号和服务端口号，启动两个silo服务，并使用MySql数据库做Silo间信息同步，实现集群。 silo服务启动代码如下（从nuget下载Microsoft.Orleans…
阅读更多...
【Linux】 IPC 进程间通信（三）（消息队列 信号量）

【Linux】 IPC 进程间通信（三）（消息队列 信号量）

📃个人主页：island1314 🔥个人专栏：Linux—登神长阶 ⛺️ 欢迎关注：👍点赞 👂🏽留言 😍收藏 💞 💞 💞 一、消息队列 💌…
阅读更多...
Docker：镜像构建 DockerFile

Docker：镜像构建 DockerFile

Docker：镜像构建 DockerFile 镜像构建docker build DockerfileFROMCOPYENVWORKDIRADDRUNCMDENTRYPOINTUSERARGVOLUME 镜像构建 在Docker官方提供的镜像中，大部分都是基础镜像，他们只提供某个简单的功能，如果想要一个功能更加丰富…
阅读更多...
遥控器数图控链路系统核心技术+算法详解

遥控器数图控链路系统核心技术+算法详解

一、核心技术 无线通信技术 遥控器数图控链路系统主要基于无线通信技术进行数据传输。通过特定的调制、编码和信号处理技术，将遥控器的操作指令转化为无线电信号，并传输给被控制设备。被控制设备接收到信号后，再将其解码为可识别的指令&…
阅读更多...
Kafka 源码 KRaft 模式本地运行

Kafka 源码 KRaft 模式本地运行

KRaft（Kafka Raft Metadata mode），从版本 2.8.0 开始作为测试特性引入，并在后续版本中持续得到改进和增强。 KRaft 模式是指 Kafka 使用 Raft 协议来管理集群元数据的一种运行模式，这标志着 Kafka 向去除对 ZooKeeper …
阅读更多...
Android下的系统调用 (syscall)，内联汇编syscall

Android下的系统调用 (syscall)，内联汇编syscall

版权归作者所有，如有转发，请注明文章出处：https://cyrus-studio.github.io/blog/ 什么是系统调用 (syscall) 系统调用是操作系统提供给应用程序的一组接口，允许用户空间程序与内核进行交互。 在 Android（基于 Linux …
阅读更多...
RAGulator：如何识别和缓解大模型所谓的“忠实幻觉”

RAGulator：如何识别和缓解大模型所谓的“忠实幻觉”

RAGulator，一个轻量级的、用于检测RAG系统中语义上与上下文不符（OOC）的LLM生成文本的检测器 论文链接:https://arxiv.org/abs/2411.03920 论文概述 实时检测大型语言模型（LLM）生成的与上下文不符的输出问题&#xff…
阅读更多...
Git核心概念

Git核心概念

目录 版本控制 什么是版本控制 为什么要版本控制 本地版本控制系统 集中化的版本控制系统 分布式版本控制系统 认识Git Git简史 Git与其他版本管理系统的主要区别 Git的三种状态 Git使用快速入门 获取Git仓库 记录每次更新到仓库 一个好的 Git 提交消息如下&#…
阅读更多...
leetcode82：删除排序链表中的重复节点||

leetcode82：删除排序链表中的重复节点||

给定一个已排序的链表的头 head ， 删除原始链表中所有重复数字的节点，只留下不同的数字 。返回 已排序的链表 。 示例 1： 输入：head [1,2,3,3,4,4,5] 输出：[1,2,5]示例 2： 输入：head [1,1,1,2…
阅读更多...
基于SpringBoot的Java教学支持系统开发指南

基于SpringBoot的Java教学支持系统开发指南

1系统概述 1.1 研究背景 随着计算机技术的发展以及计算机网络的逐渐普及，互联网成为人们查找信息的重要场所，二十一世纪是信息的时代，所以信息的管理显得特别重要。因此，使用计算机来管理教学辅助平台的相关信息成为必然。开发合适…
阅读更多...
python3的基本数据类型：可变集合的用法

python3的基本数据类型：可变集合的用法

一. 简介 前面学习了 python3中的一种基本数据类型-集合，文章如下： python3的基本数据类型：集合的创建与分类-CSDN博客 本文继续学习 Python3中的集合，主要学习 可变集合的用法。 二. python3的基本类型：可变集合的…
阅读更多...
【Linux系列】 环境配置文件合并的艺术：从`.env`到`.env.combined`

【Linux系列】 环境配置文件合并的艺术：从`.env`到`.env.combined`

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。 推荐:kwan 的首页,持续学…
阅读更多...
C/C++语言基础--C++模板与元编程系列五(可变惨模板，形参包展开，折叠表达式)

C/C++语言基础--C++模板与元编程系列五(可变惨模板，形参包展开，折叠表达式)

本专栏目的 更新C/C的基础语法，包括C的一些新特性 前言 模板与元编程是C的重要特点，也是难点，本人预计将会更新10期左右进行讲解，这是第五期，讲解可变惨模板，形参包展开，折叠表达式等&#x…
阅读更多...
Redis设计与实现 学习笔记 第十六章 Sentinel

Redis设计与实现 学习笔记 第十六章 Sentinel

Sentinel（哨岗、哨兵）是Redis的高可用性（high availability）解决方案：由一个或多个Sentinel实例（instance）组成的Sentinel系统可以监视任意多个主服务器，以及这些主服务器属下的从服…
阅读更多...
贪心算法day05（k次取反后最大数组和 田径赛马）

贪心算法day05（k次取反后最大数组和 田径赛马）

目录 1.k次取反后最大化的数组和 2.按身高排序 3.优势洗牌 1.k次取反后最大化的数组和 题目链接：. - 力扣（LeetCode） 思路： 代码： class Solution {public int largestSumAfterKNegations(int[] nums, int k) {//如…
阅读更多...
易语言加载dll模拟windows鼠标轨迹移动

易语言加载dll模拟windows鼠标轨迹移动

一.简介 鼠标轨迹算法是一种模拟人类鼠标操作的程序，它能够模拟出自然而真实的鼠标移动路径。 鼠标轨迹算法的底层实现采用C/C语言，原因在于C/C提供了高性能的执行能力和直接访问操作系统底层资源的能力。 鼠标轨迹算法具有以下优势： 模拟…
阅读更多...
Go语言的常用内置函数

Go语言的常用内置函数

文章目录 一、Strings包字符串处理包定义Strings包的基本用法Strconv包中常用函数 二、Time包三、Math包math包概述使用math包 四、随机数包（rand） 一、Strings包 字符串处理包定义 Strings包简介： 一般编程语言包含的字符串处理库功能区别…
阅读更多...
Springboot+Vue+mysql前后端分离的Java项目部署教程

Springboot+Vue+mysql前后端分离的Java项目部署教程

参考了网上许多文章，有的使用的是nginx，eclipse，其实只要是数据库或者java的软件基本都大同小异。 本人使用phpstudy对项目进行部署，亲测有效。 需要的软件： 1.Node.js安装（ps：这一步我也不知道…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023