µC/OS-III-事件标志

事件标志与信号量都是属于任务间同步的一种机制，信号量一般用于任务间的单事件同步，对于任务间的多事件同步，使用信号量来实现比较复杂，µC/OS-III提供了事件标志，事件标志就能够很好地处理任务间的多任务同步。 事件标志是一个事件是否发生用一个比特位表示，一个事件是否发生只有两种情况，分别为事件发生和事件未发生，因此只需一个比特位就能够表示事件是否发生，µC/OS-III 用1表示事件发生，用0表示事件未发生。

一、µC/OS-III事件标志相关 API 函数 1）函数 OSFlagCreate() 创建一个事件标志组。 void OSFlagCreate( OS_FLAG_GRP* p_grp, //指向事件标志组结构体的指针 CPU_CHAR* p_name, //指向作为事件标志组名的 ASCII 字符串的指针 OS_FLAGS flags, //事件标志组的初始值 OS_ERR* p_err) //指向接收错误代码变量的指针 2) 函数 OSFlagDel() 删除一个事件标志组。 OS_OBJ_QTY OSFlagDel( OS_FLAG_GRP* p_grp, //指向事件标志组结构体的指针 OS_OPT opt, //函数操作选项 OS_ERR* p_err); //指向接收错误代码变量的指针 返回值：OS_OBJ_QTY类型，被终止挂起等待事件标志任务的数量。 3）函数OSFlagPend() 用于等待事件标志组中的事件。 OS_FLAGS OSFlagPend( OS_FLAG_GRP* p_grp, //指向事件标志组结构体的指针 OS_FLAGS flags, //等待的事件标志 OS_TICK timeout, //任务挂起等待事件标志的最大允许时间 OS_OPT opt, //函数操作选项 CPU_TS* p_ts, //指向接收等待到事件时的时间戳的变量的指针 OS_ERR* p_err) //指向接收错误代码变量的指针 返回值：OS_FLAGS类型，任务实际等待到的事件标志。 4）OSFlagPendAbort() 终止任务挂起等待事件标志组。 OS_OBJ_QTY OSFlagPendAbort( OS_FLAG_GRP* p_grp, //指向事件标志组结构体的指针 OS_OPT opt, //函数操作选项 OS_ERR* p_err) //指向接收错误代码变量的指针 返回值：OS_OBJ_QTY类型，被终止挂起任务的数量。 5）函数 OSFlagPendGetFlagsRdy() 用于获取任务等待到的事件。 OS_FLAGS OSFlagPendGetFlagsRdy( OS_ERR p_err) //指向接收错误代码变量的指针 返回值：OS_FLAGS类型，任务获取到的事件标志。 6）函数 OSFlagPost() 用于设置事件标志组中的事件。 OS_FLAGS OSFlagPost( OS_FLAG_GRP p_grp, //指向事件标志组结构体的指针 OS_FLAGS flags, //等待的事件标志 OS_OPT opt, //函数操作选项 OS_ERR* p_err) //指向接收错误代码变量的指针 返回值：OS_FLAGS类型，事件标志组更新后的事件标志值。