UCOSIII事件标志组

两种同步机制

使能

#define OS_CFG_FLAG_EN 1u /* Enable (1) or Disable (0) code generation for EVENT FLAGS */

主结构体

typedef struct os_flag_grp OS_FLAG_GRP;

struct  os_flag_grp {                          /* Event Flag Group */

    OS_OBJ_TYPE          Type;                 /* Should be set to OS_OBJ_TYPE_FLAG */

    CPU_CHAR            *NamePtr;              /* Pointer to Event Flag Name (NUL terminated ASCII) */

    OS_PEND_LIST         PendList;             /* List of tasks waiting on event flag group */

#if OS_CFG_DBG_EN > 0u

    OS_FLAG_GRP         *DbgPrevPtr;

    OS_FLAG_GRP         *DbgNextPtr;

    CPU_CHAR            *DbgNamePtr;

#endif

    OS_FLAGS             Flags;                /* 8, 16 or 32 bit flags */

    CPU_TS               TS;                   /* Timestamp of when last post occurred */

};

API函数

//创建

void OSFlagCreate (OS_FLAG_GRP *p_grp,

                   CPU_CHAR *p_name,

                   OS_FLAGS flags,

                   OS_ERR *p_err);

#if OS_CFG_FLAG_DEL_EN > 0u

//删除

OS_OBJ_QTY OSFlagDel (OS_FLAG_GRP *p_grp,

                      OS_OPT opt,

                      OS_ERR *p_err);

#endif

/*

* opt           specifies whether you want ALL bits to be set or ANY of the bits to be set.

*               You can specify the 'ONE' of the following arguments:

*

*                   OS_OPT_PEND_FLAG_CLR_ALL   You will wait for ALL bits in 'flags' to be clear (0)

*                   OS_OPT_PEND_FLAG_CLR_ANY   You will wait for ANY bit  in 'flags' to be clear (0)

*                   OS_OPT_PEND_FLAG_SET_ALL   You will wait for ALL bits in 'flags' to be set   (1)

*                   OS_OPT_PEND_FLAG_SET_ANY   You will wait for ANY bit  in 'flags' to be set   (1)

*

*               You can 'ADD' OS_OPT_PEND_FLAG_CONSUME if you want the event flag to be 'consumed' by

*                         the call.  Example, to wait for any flag in a group AND then clear

*                         the flags that are present, set 'wait_opt' to:

*

*                         OS_OPT_PEND_FLAG_SET_ANY + OS_OPT_PEND_FLAG_CONSUME

*

*               You can also 'ADD' the type of pend with 'ONE' of the two option:

*

*                   OS_OPT_PEND_NON_BLOCKING   Task will NOT block if flags are not available

*                   OS_OPT_PEND_BLOCKING       Task will     block if flags are not available

*/

//等待-1

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);

#if OS_CFG_FLAG_PEND_ABORT_EN > 0u

//取消等待

OS_OBJ_QTY OSFlagPendAbort (OS_FLAG_GRP *p_grp,

                            OS_OPT opt,

                            OS_ERR *p_err);

#endif

//获取使任务就绪的事件标志

OS_FLAGS OSFlagPendGetFlagsRdy (OS_ERR *p_err);

//发送+1

OS_FLAGS OSFlagPost (OS_FLAG_GRP *p_grp,

                     OS_FLAGS flags,

                     OS_OPT opt,

                     OS_ERR *p_err);

应用举例

#define FLAG1       (1 << 0)

#define FLAG2       (1 << 1)

OS_FLAG_GRP EventFlags;     //定义一个事件标志组

void task1(void *p_arg)

{

    while(1)

    {

        //向事件标志组EventFlags发送标志

        flags_num=OSFlagPost((OS_FLAG_GRP*)&EventFlags,

                             (OS_FLAGS    )FLAG1,

                             (OS_OPT      )OS_OPT_POST_FLAG_SET,

                             (OS_ERR*     )&err);

        printf("task1事件标志组EventFlags的值:%d\r\n",flags_num);

        OSTimeDlyHMSM(0,0,2,0,OS_OPT_TIME_PERIODIC,&err);

        //向事件标志组EventFlags发送标志

        flags_num=OSFlagPost((OS_FLAG_GRP*)&EventFlags,

                             (OS_FLAGS    )FLAG2,

                             (OS_OPT      )OS_OPT_POST_FLAG_SET,

                             (OS_ERR*     )&err);

        printf("task1事件标志组EventFlags的值:%d\r\n",flags_num);

        OSTimeDlyHMSM(0,0,2,0,OS_OPT_TIME_PERIODIC,&err);

    }

}

void task2(void *p_arg)

{

    while(1)

    {

        //等待事件标志组

        OSFlagPend((OS_FLAG_GRP*)&EventFlags,

                   (OS_FLAGS    )FLAG1|FLAG2,

                   (OS_TICK     )0,

                   (OS_OPT      )OS_OPT_PEND_FLAG_SET_ALL+OS_OPT_PEND_FLAG_CONSUME,

                   (CPU_TS*     )0,

                   (OS_ERR*     )&err);

        printf("task2事件标志组EventFlags的值:%d\r\n",EventFlags.Flags);

    }

}

实验现象