Description
Wait for a combination of conditions or events (i.e. bits) to be set (or cleared) in an event flag group. The application can wait for any condition to be set or cleared, or for all conditions to be set or cleared. If the events that the calling task desires are not available, the calling task is blocked (optional) until the desired conditions or events are satisfied, the specified timeout expires, the event flag is deleted, or the pend is aborted by another task.
Files
os.h/os_flag.c
Prototype
Arguments
p_grp
is a pointer to the event flag group.
...
The flags are not available within the specified amount of time.
Returned Values
The flag(s) that cause the task to be ready, 0
if either none of the flags are ready, or indicate an error occurred.
Required Configuration
OS_CFG_FLAG_EN
must be enabled in os_cfg.h. Refer to uC-OS-III Configuration Manual
Callers
Application.
Notes/Warnings
- The event flag group must be created before it is used.
Example Usage