RTX51 Tiny User's Guide

os_wait2

Summary
#include <rtx51tny.h>

char os_wait2 (
  unsigned char event_sel,      /* events to wait for */
  unsigned char ticks);         /* timer ticks to wait */
Description

The os_wait2 function halts the current task and waits for one or several events such as a time interval, a time-out, or a signal from another task or interrupt. The event_sel argument specifies the event or events to wait for and can be any combination of the following manifest constants:

EventDescription
K_IVLWait for the interval specified by ticks.
K_SIGWait for a signal.
K_TMOWait for a time-out specified by ticks.

Events may be logically ORed using the vertical bar character ('|'). For example, K_TMO | K_SIG, specifies that the task wait for a time-out or for a signal.

The ticks argument specifies the number of timer ticks to wait for an interval event (K_IVL) or a time-out event (K_TMO).

Note

  • This function is part of the RTX51 Tiny Real-Time Operating System which is included only with the PK51 Professional Developer's Kit.
  • Refer to Events for more information about K_IVL, K_TMO, and K_SIG.
Return Value

When one of the specified events occurs, the task is put in the READY state. When the task resumes execution, the manifest constant that identifies the event that restarted the task is returned by os_wait2. Possible return values are:

Return ValueDescription
RDY_EVENTThe task's ready flag was set by either the os_set_ready or isr_set_ready routines.
SIG_EVENTA signal was received.
TMO_EVENTA time-out has completed or an interval has expired.
NOT_OKThe value of the event_sel argument is invalid.
Example

See os_wait.