1
完善资料让更多小伙伴认识你,还能领取20积分哦, 立即完善>
2.FreeRTOS事件标志组 2.1事件标志组简介 从前几章中我们知道可以用信号量实现同步,但信号量只能实现与单个任务或中断之间的同步,当某个任务需要与多个任务或事件进行同步时,这时候我们可以使用事件标志组。 讲到事件标志组,首先要提到事件位,事件位用来表明某个事件是否发生,通常用作事件标志。比如:从中断中接收指令需要处理时将某个位(标志)置1,当处理结束以后就讲这个位(标志)置0。 一个事件组就是一组的事件位,事件组中的事件位通过位编号来访问。 2.2事件标志组函数 2.2.1 创建事件标志组 创建事件标志组的函数有两个,分别如下: xEventGroupCreate(),此函数用于动态创建事件标志组,所需要的内存通过动态内存管理方法分配,事件标志组可用的bits数取决于宏configUSE_16_BIT_TICKS,当此宏为1时,事件标志组有8个可用位,当为0时有24个可用位。其函数原型如下: EventGroupHandle_t xEventGroupCreate( void ) 参数:无 返回值: NULL:事件标志组创建失败。 其他值:创建成功的事件标志组句柄。 xEventGroupCreateStatic(),此函数也用于创建事件标志组,所需要的内存通过用户自行分配,其函数原型如下: EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t *pxEventGroupBuffer ) 参数: pxEventGroupBuffer: 指向一个StaticEventGroup_t类型的变量,用来保存件标志组结构体。 返回值: NULL:事件标志组创建失败。 其他值:创建成功的事件标志组句柄。 2.2.2 设置事件位 设置事件位包括置1与清零操作,FreeRTOS提供了四个函数可以设置事件标志组的事件位,分别如下: 在任务级中将指定事件位清零函数xEventGroupClearBits(),其函数原型如下: EventBits_t xEventGroupClearBits(EventGroupHandle_t xEventGroup, Const EventBits_t uxBitsToClear) 参数: xEventGroup: 要操作的事件标志组句柄。 uxBitsToClear: 要清除的事件位。 返回值: 任何值: 将指定事件位清零之前的事件组值。 中断级清零函数 xEventGroupClearBitsFromISR(),此函数为xEventGroupClearBits()的中断版本,只能用于中断服务函数中,其函数原型如下: BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) 参数: xEventGroup: 要操作的事件标志组句柄。 uxBitsToSet: 要清除的事件位。 返回值: pdPASS: 事件位清零成功。 pdFAISE: 事件位清零失败。 置1函数xEventGroupSetBits(),此函数可在任务级中将指定事件位置1,其函数原型如下: EventBits_t xEventGroupSetBits(EventGroupHandle_t xEventGroup, Const EventBits_t uxBitsToSet) 参数: xEventGroup: 要操作的事件标志组句柄。 uxBitsToSet: 指定要置1的事件位。 返回值: 任何值: 将指定事件位置1后的事件组值。 中断xEventGroupSetBitsFromISR(),此函数为xEventGroupSetBits()的中断版本,只能用于中断服务函数中,其函数原型如下: BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet BaseType_t* pxHigherPriorityTaskWoken) 参数: xEventGroup: 要操作的事件标志组句柄。 uxBitsToSet: 指定要置1的事件位。 pxHigherPriorityTaskWoken: 标记退出此函数以后是否进行任务切换 返回值: pdPASS: 事件位置1成功。 pdFAISE: 事件位置1失败。 2.2.3 获取事件标志组值 FreeRTOS中提供了可以查询事件标志组值的API函数,分别如下: xEventGroupGetBits(),此函数用于任务中获取当前事件标志组的值,即各个事件位的值,此函数是个宏,其函数原型如下: EventBits_t xEventGroupGetBits( EventGroupHandle_t xEventGroup ) 参数: xEventGroup: 要获取的事件标志组的句柄。 返回值: 任何值: 当前事件标志组的值。 xEventGroupGetBitsFromISR(),此函数用于在中断服务函数中获取当前事件标志组的值,为函数xEventGroupGetBits()的中断版本,此函数也是个宏,其函数原型如下: BaseType_t xEventGroupGetBitsFromISR ( EventGroupHandle_t xEventGroup); 参数: xEventGroup: 要获取的事件标志组的句柄。 返回值: 任何值: 当前事件标志组的值。 2.2.4 等待指定是事件位 当某个任务需要与多个事件进行同步时,那么它就需要等待并判断多个事件位,此时可以调用函数xEventGroupWaitBits()完成功能。调用此函数以后如果等待的事件位还没有准备好的话进入阻塞状态,直到等待的事件位准备好或者阻塞时间到达,其函数原型如下 EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFord, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, const TickType_t xTicksToWait ) 参数: xEventGroup: 指定要等待的事件标志组。 uxBitsToWaitFord: 指定要等待的事件位。 xClearOnExit: 此参数要是为pdTRUE的话,那么在退出此函数之前由参数 uxBitsToWaitFor所设置的这些事件位就会清零。如果设置位pdFALSE 的话这些事件位就不会改变。 xWaitForAllBits: 此参数如果设置为 pdTRUE 的话,当 uxBitsToWaitFord 所设置的 这些事件位都置 1,或者指定的阻塞时间到的时候函数 xEventGroupWaitBits()才会返回。当此函数为 pdFALSE 的话,只要 uxBitsToWaitFor 所设置的这些事件位其中的任意一个置1,或者指 定 的 阻 塞 时 间到 的 话 函 数xEventGroupWaitBits()就会返回。 返回值: 任何值: 返回当所等待的事件位置 1 以后的事件标志组的值,或者阻塞时间到。根 据这个值我们就知道哪些事件位置 1 了。如果函数因为阻塞时间到而返回的 话这个返回值就不代表任何的含义。 2.3操作实验 2.3.1实验设计 本次设计通过检测三个按键状态,设置事件组中不同事件位,当全设置1之后,所有事件位清零,翻转LED电平。 可参考12.3.2章节进行导入已有工程,工程存放路径【华清远见-FS-MP1A开发资料 |