实时操作系统UCOS学习笔记13----事件标志组

前面讲过可以使用信号量来完成任务同步，这里再讲解一下另外一种任务同步的方法，就是事件标志组，事件标志组用来解决一个任务和多个事件之间的同步。

1、事件标志组

有时候一个任务可能需要和多个事件同步，这个时候就需要使用事件标志组。事件标志组与任务之间是有2种同步机制：“或”同步和“与”同步，当任何一个事件发生，任务都被同步的同步机制是“或”同步；需要所有的事件都能发生任务才会被同步的同步机制是“与”同步，这2种同步机制如下图所示。

1. 在UCOSIII中事件标志组是OS_FLAG_GRP，在os.h文件中有定义，事件标志组中也包含了一串任务，这些任务都在等待着事件标志组中的部分（或全部）事件标志被置1或被清零，在使用之前，必须创建事件标志组。
2. 任务和ISR（中断服务程序）都可以发布事件标志，但是，只有任务可以创建、删除事件标志组以及取消其他任务对事件标志组的等待。
3. 任务可以通过调用函数OSFlagPend()等待事件标志组中的任意个事件标志，调用函数OSFlagPend()的时候可以设置一个超时时间，如果过了超时时间请求的事件还没有被发布，那么任务就会重新进入就绪态。
4. 我们可以设置同步机制为“或”同步还是“与”同步。

UCOSIII中关于事件标志组的API函数如下表所示，一般情况下我们只使用OSFlagCreate()、OSFlagPend()和OSFlagPost()这3个函数。

2、事件标志组相关函数

2.1 创建事件标志组
在使用事件标志组之前，需要调用函数OSFlagCreate()创建一个事件标志组，OSFlagCreate()函数原型如下。

• p_grp：指向事件标志组，事件标志组的存储空间需要应用程序进行实际分配，我们可以按照下面的例子来定义一个事件标志组。 OS_FLAG_GRP EventFlag;
• p_name：事件标志组的名字
• flags：定义时间标志组的初始值
• p_err：用来保存调用此函数后返回的错误码。

2.2 等待事件标志组
等待一个事件标志组需要调用此函数OSFlagPend()，函数原型如下。

OSFlagPend()允许将事件标志组里事件标志的“与或”组合状态设置成任务的等待条件。任务等待的条件可以是标志组里任意一个标志置位或清零，也可以是所有事件标志都置位或清零。如果任务等待的事件标志组不满足设置的条件，那么该任务被置为挂起状态，直到等待的事件标志组满足条件、指定的超时时间到、时间标志被删除或另一个任务终止了该任务的挂起状态。

• p_grp：指向事件标志组
• flags：bit序列，任务需要等待事件标志组的哪个位就把这个序列对应的位置1，根据设置这个序列可以是8bit、16bit或者32bit。比如任务需要等待事件标志组的bit0和bit1时（无论是等待置位还是清零），flag的值就为0X03。
• timeout：指定等待事件标志组的超时时间（时钟节拍数），如果在指定的超时时间内所等待的一个或多个事件没有发生，那么任务恢复运行。如果此值设置为0，则任务就将一直等待下去，直到一个或多个事件发生。
• opt：决定任务等待的条件是所有标志置位、所有标志清零、任意一个标志置位还是任意一个标志清零，具体的定义如下。
  OS_OPT_PEND_FLAG_CLR_ALL 等待事件标志组所有的位清零
  OS_OPT_PEND_FLAG_CLR_ANY 等待事件标志组中任意一个标志清零
  OS_OPT_PEND_FLAG_SET_ALL 等待事件标志组中所有的位置位
  OS_OPT_PEND_FLAG_SET_ANY 等待事件标志组中任意一个标志置位
  调用上面4个选项的时候还可以搭配下面3个选项。
  OS_OPT_PEND_FLAG_CONSUME 用来设置是否继续保留该事件标志的状态
  OS_OPT_PEND_NON_BLOCKING 标志组不满足条件时不挂起任务
  OS_OPT_PEND_BLOCKING 标志组不满足条件时挂起任务

这里应该注意选项OS_OPT_PEND_FLAG_CONSUME的使用方法，如果我们希望任务等待事件标志组的任意一个标志置位，并在满足条件后将对应的标志清零那么就可以搭配使用选项OS_OPT_PEND_FLAG_CONSUME。

• p_ts：指向一个时间戳，记录了发送、终止和删除事件标志组的时刻，如果为这个指针赋值NULL，则函数的调用者将不会收到时间戳。
• p_err：用来保存调用此函数后返回的错误码。

2.3 向事件标志组发布标志
调用函数OSFlagPost()可以对事件标志组进行置位或清零，函数原型如下。

一般情况下，需要进行置位或者清零的标志由一个掩码确定（参数flags）。OSFlagPost()修改完事件标志后，将检查并使那些等待条件已经满足的任务进入就绪态。该函数可以对已经置位或清零的标志进行重复置位和清零操作。

• p_grp：指向事件标志组

• flags：决定对哪些位清零和置位，当opt参数为OS_OPT_POST_FLAG_SET时，参数flags中置位的位就会在事件标志组中对应的位也将被置位。当opt为OS_OPT_POST_FLAG_CLR的时候参数flags中置位的位在事件标志组中对应的位将被清零。

• opt：决定对标志位的操作，有2种选项。
  OS_OPT_POST_FLAG_SET 对标志位进行置位操作
  OS_OPT_POST_FLAG_CLR 对标志位进行清零操作

• p_err：保存调用此函数后返回的错误码。

3、事件标志组实验

3.1 实验程序设计
设计一个程序，只有按下按键KEY0和KEY1（不需要同时按下）时任务flagsprocess_task任务才能执行。分析程序设计的要求，我们可以使用事件标志组来实现，按下KEY0和KEY1作为两个不同的事件，只有这两个事件同时发生了才能执行任务flagsprocess_task。实验代码如下：

首先需要定义事件标志组，并且定义了KEY0个KEY1的掩码以及事件标志组的初始值。函数ucos_load_main_ui()为主界面，主要是在LCD上显示一些提示信息。main()函数为主函数，和前面的实验一样。主要是初始化外设和UCOSIII，并且新建一个start_task任务。
start_task任务里面创建了一个事件标志组EventFlags和两个任务：main_task和flagsprocess_task。
main_task()函数为主任务的任务函数，函数里面主要是获取按键值，如果按下KEY0的话就调用OSFlagPost()向事件标志组EventFlags发布标志KEY0_FLAG，如果按下KEY1的话就向事件标志组EventFlags发布KEY1_FLAG。在main_task()函数中每调用一次OSFlagPost()就在LCD上显示事件标志组EventFlags的当前值并且通过串口输出这个值，我们可以通过这个值的变化来观察事件标志组各个事件产生的过程。
flagsprocess_task()函数为事件标志组处理任务的任务函数，在这个函数中我们一直等待事件标志组EventFlags中相应的事件发生，当等待的事件发生的话就刷新LCD下方方框的背景颜色，并且控制LED1反转。

3.2 实验程序结果分析