01.06.2013 Views

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

system's maximum number of available messages envelopes is 64 (since <strong>@CHIP</strong>-<strong>RTOS</strong> version 1.02B, else<br />

32).<br />

The msgID member is an output parameter from the RTX_CREATE_MSG API call.<br />

Related Topics<br />

Top of list<br />

Index page<br />

API function RTX_CREATE_MSG - Create a Message Exchange<br />

<strong>RTOS</strong> Message Exchange Manager<br />

RTX_Wait_Event<br />

Comments<br />

typedef struct tag_rtx_event_wait<br />

{<br />

unsigned int mask; // 16-Bit mask identifying the flags of interest of the group.<br />

unsigned int value; // 16 Bit value, which specifies the states of interest<br />

// for each flag selected by the mask.<br />

int match; // event match requirements, 0: only one flag must match<br />

// with value, !=0: all by mask specified flags must match<br />

long timeout; // Maximum time (milliseconds) for waiting for an event match<br />

} RTX_Wait_Event;<br />

This structure is defined in the header file rtxapi.h.<br />

Prior to making the RTX_WAIT_EVENTS call, the caller must set the members of the RTX_Wait_Event data<br />

structure.<br />

mask<br />

value<br />

match<br />

Event bits set to '1' in this mask indicate the events in valuewhich will be matched. All other event bits in the<br />

group are ignored.<br />

The desired event state for the event bits set to '1' in maskare stated here. User may wait on an event bit<br />

transition to either '1' or '0', as specified here.<br />

This is a Boolean value which indicates whether you require all indicated events to match (AND, match!= 0), or<br />

whether it is sufficient that only a single event of those specified match (OR, match=0).<br />

timeout<br />

Maximum time to wait for events, specified in milliseconds. Zero here indicates wait forever. This signed value<br />

must be non-negative.<br />

Related Topics<br />

Top of list<br />

Index page<br />

API function RTX_WAIT_EVENTS - Wait for events in a group<br />

<strong>RTOS</strong> Event Manager<br />

RTX_Wait_Msg<br />

Page 237 / 400

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!