os_evt_wait_or

#include <rtl.h>

OS_RESULT os_evt_wait_or (
    U16 wait_flags,    /* Bit pattern of events to wait for */
    U16 timeout );     /* Length of time to wait for event */

The os_evt_wait_or function waits for one of the events specified in the wait_flags to occur. The function only waits on events whose corresponding flags have been set to 1 in the wait_flags parameter. The function can wait on as many as 16 different events.

You can use the timeout argument to specific the length of time after which the function must return even if none of the events have occurred. You can use any value of timeout with the exception of 0xFFFF, which you can use to specify an indefinite timeout. The unit of measure of the timeout argument is the number of system intervals.

The os_evt_wait_or function returns when at least one of the events specified in the wait_flags has occurred or when the timeout expires. The event flag or flags that caused the os_evt_wait_or function to complete are cleared before the function returns. You can identify those event flags with os_evt_get function later.

The os_evt_wait_or function is in the RL-RTX library. The prototype is defined in rtl.h.

note

• Each task has its own 16 bit wait flag.

The os_evt_wait_or function returns a value to indicate whether an event occurred or the timeout expired.

os_evt_get, os_evt_wait_and

#include <rtl.h>

__task void task1 (void) {
  OS_RESULT result;

  result = os_evt_wait_or (0x0003, 500);
  if (result == OS_R_TMO) {
    printf("Event wait timeout.\n");
  }
  else {
    printf("Event received.\n");
  }
   ..
}