UCOSIII事件标志组
一、理论部分
1、有时一个任务需要和多个事件同步，此时可以用事件标志组。
2、事件标志组的事件可以“与”同步，也可以“或”同步。
3、任务和 ISR(中断服务程序)都可以发布事件标志，但是，只有任务可以创建、删除事件
标志组以及取消其他任务对事件标志组的等待。
4、如果任务在等待过程中时间超时，任务会被重新进入就绪态。
二、相关API函数
1、定义事件组
OS_FLAG_GRP EventFlags; //定义一个事件标志组
2、OSFlagCreate() 创建事件标志组
OSFlagCreate ( (OS_FLAG_GRP*) &EventFlags,
(CPU_CHAR*) "EventFlags",
(OS_FLAGS) KEYFLAGS_VALUE,
(OS_ERR*) &err);
void OSFlagCreate ( OS_FLAG_GRP *p_grp, //指向事件标志组
CPU_CHAR *p_name, //事件组名字
OS_FLAGS flags, //定义事件组的初始值
OS_ERR *p_err)
3、OSFlagPend() 等待事件标志组
OSFlagPend( (OS_FLAG_GRP*) &EventFlags,
(OS_FLAGS) KEY0_FLAG+ KEY1_FLAG,
(OS_TICK) 0,
(OS_OPT) OS_OPT_PEND_FLAG_SET_ALL+OS_OPT_PEND_FLAG_CONSUME,
(CPU_TS*) 0 ,
(OS_ERR*) &err);
OS_FLAGS OSFlagPend ( OS_FLAG_GRP *p_grp, //指向事件标志组
OS_FLAGS flags, //bit序列
OS_TICK timeout, //超时等待时间
OS_OPT opt, //决定事件等待的标志
CPU_TS *p_ts, //时间戳
OS_ERR *p_err)
flags： 需要等待的事件标志组
可以是8bit 16bit 32bit
如需要等待的事件标志组（无论是置1还是清零）1bit和2bit 则flags为0x03
OS_OPT 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、 OSFlagPost() 向事件标志组发送标志
OSFlagPost ( &EventFlags, 0X01, OS_OPT_POST_FLAG_SET, &err);
OS_FLAGS OSFlagPost ( OS_FLAG_GRP *p_grp, //指向事件标志组
OS_FLAGS flags, //决定哪些位置清零和置位
OS_OPT opt, //决定位置的操作清零和置位
OS_ERR *p_err)
opt：
OS_OPT_POST_FLAG_SET 对标志位进行置位操作
OS_OPT_POST_FLAG_CLR 对标志位进行清零操作
三、程序源码
#include "led.h"
#include "delay.h"
#include "sys.h"
#include "bsp_key.h"
#include "usart.h"
#include "includes.h"
//任务优先级
#define START_TASK_PRIO 3
//任务堆栈大小
#define START_STK_SIZE 128
//任务控制块
OS_TCB StartTaskTCB;
//任务堆栈
CPU_STK START_TASK_STK[START_STK_SIZE];
//任务函数
void start_task(void *p_arg);
//任务优先级
#define TASK1_TASK_PRIO 4
//任务堆栈大小
#define TASK1_STK_SIZE 128
//任务控制块
OS_TCB Task1TaskTCB;
//任务堆栈
CPU_STK TASK1_TASK_STK[TASK1_STK_SIZE];
//任务函数
void task1_task(void *p_arg);
//任务优先级
#define TASK2_TASK_PRIO 5
//任务堆栈大小
#define TASK2_STK_SIZE 128
//任务控制块
OS_TCB Task2TaskTCB;
//任务堆栈
CPU_STK TASK2_TASK_STK[TASK2_STK_SIZE];
//任务函数
void task2_task(void *p_arg);
////////////////////////事件标志组//////////////////////////////
#define KEY0_FLAG 0x01
#define KEY1_FLAG 0x02
#define KEYFLAGS_VALUE 0X00
OS_FLAG_GRP EventFlags; //定义一个事件标志组
u8 task1_num=0;
int main(void)
{
OS_ERR err;
CPU_SR_ALLOC();
delay_init ();
NVIC_PriorityGroupConfig (NVIC_PriorityGroup_2); //设置中断优先级
uart_init (115200); //初始化串口
printf("串口初始化完成\r\n");
LED_Init();
Key_GPIO_Config();
OSInit(&err);
OS_CRITICAL_ENTER(); //进入临界区
OSTaskCreate( (OS_TCB*) &StartTaskTCB, //任务控制块 (CPU_CHAR*) "start_task ", //任务名称
(OS_TASK_PTR) start_task, //任务函数
(void*) 0, //参数
(OS_PRIO) START_TASK_PRIO, //任务优先级
(CPU_STK*) &START_TASK_STK[0], //任务堆栈基地址
(CPU_STK_SIZE) START_STK_SIZE/10, //任务堆栈深度限位
(CPU_STK_SIZE) START_STK_SIZE, //任务堆栈大小
(OS_MSG_QTY) 0, //任务内部消息队列能够接收的最大消息数目,为0时禁止接收消息
(OS_TICK) 0, //当使能时间片轮转时的时间片长度，为0时为默认长度
(void*) 0, //用户补充的存储区
(OS_OPT) OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR, //任务选项
(OS_ERR*) &err); //存放该函数错误时的返回值
OS_CRITICAL_EXIT(); //退出临界区
OSStart(&err);
}
//开始任务函数
void start_task(void *p_arg)
{
OS_ERR err;
CPU_SR_ALLOC();
p_arg = p_arg;
CPU_Init();
#if OS_CFG_STAT_TASK_EN > 0u
OSStatTaskCPUUsageInit(&err); //统计任务
#endif
#ifdef CPU_CFG_INT_DIS_MEAS_EN //如果使能了测量中断关闭时间
CPU_IntDisMeasMaxCurReset();
#endif
#if OS_CFG_SCHED_ROUND_ROBIN_EN //当使用时间片轮转的时候
//使能时间片轮转调度功能,时间片长度为1个系统时钟节拍，既1*5=5ms
OSSchedRoundRobinCfg(DEF_ENABLED,1,&err);
#endif
OS_CRITICAL_ENTER(); //进入临界区
OSFlagCreate ( (OS_FLAG_GRP*) &EventFlags,
(CPU_CHAR*) "EventFlags",
(OS_FLAGS) KEYFLAGS_VALUE,
(OS_ERR*) &err); //创建事件标志组
OSTaskCreate( (OS_TCB*) &Task1TaskTCB, //任务控制块
(CPU_CHAR*) "task1_task ", //任务名称
(OS_TASK_PTR) task1_task, //任务函数
(void*) 0, //参数
(OS_PRIO) TASK1_TASK_PRIO, //任务优先级
(CPU_STK*) &TASK1_TASK_STK[0],
(CPU_STK_SIZE) TASK1_STK_SIZE/10,
(CPU_STK_SIZE) TASK1_STK_SIZE,
(OS_MSG_QTY) 0,
(OS_TICK) 0,
(void*) 0,
(OS_OPT) OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR,
(OS_ERR*) &err);
OSTaskCreate( (OS_TCB*) &Task2TaskTCB, //任务控制块
(CPU_CHAR*) "task2_task ", //任务名称
(OS_TASK_PTR) task2_task, //任务函数
(void*) 0, //参数
(OS_PRIO) TASK2_TASK_PRIO, //任务优先级
(CPU_STK*) &TASK2_TASK_STK[0],
(CPU_STK_SIZE) TASK2_STK_SIZE/10,
(CPU_STK_SIZE) TASK2_STK_SIZE,
(OS_MSG_QTY) 0, //内建消息队列长度
(OS_TICK) 0,
(void*) 0,
(OS_OPT) OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR,
(OS_ERR*) &err);
OS_CRITICAL_EXIT(); //退出临界区
OSTaskDel ((OS_TCB*)&StartTaskTCB,&err); //删除任务自身
}
void task1_task(void *p_arg)
{
OS_ERR err;
CPU_SR_ALLOC();
p_arg = p_arg;
while(1)
{
if(PAin(0)==1)
{
task1_num++; //按键次数
if(task1_num%2==0)
{
OSFlagPost ( &EventFlags, 0X01, OS_OPT_POST_FLAG_SET, &err); //发送信号标志
printf("按键1按下\r\n");
}
else
{
OSFlagPost ( &EventFlags, 0X02, OS_OPT_POST_FLAG_SET, &err);
printf("按键2按下\r\n");
}
while(PAin(0)==1);
}
OSTimeDlyHMSM(0,0,0,10,OS_OPT_TIME_HMSM_STRICT,&err); //延时10MS
}
}
void task2_task(void *p_arg)
{
u8 *num;
OS_ERR err;
CPU_SR_ALLOC();
p_arg = p_arg;
while(1)
{
OSFlagPend( (OS_FLAG_GRP*) &EventFlags,
(OS_FLAGS) KEY0_FLAG+ KEY1_FLAG,
(OS_TICK) 0,
(OS_OPT) OS_OPT_PEND_FLAG_SET_ALL+OS_OPT_PEND_FLAG_CONSUME,//OS_OPT_PEND_FLAG_SET_ALL+OS_OPT_PEND_FLAG_CLR_ANY,
(CPU_TS*) 0 ,
(OS_ERR*) &err); //等待信号标志组
printf("任务2运行\r\n");
LED1=~LED1;
OSTimeDlyHMSM(0,0,0,800,OS_OPT_PEND_BLOCKING,&err); //延时800MS
}
}