![abaco systems CEI-100 Series User Manual Download Page 74](http://html.mh-extra.com/html/abaco-systems/cei-100-series/cei-100-series_user-manual_450728074.webp)
Program Interface Library
Utility Routines
–
Summary
CEI-100/CEI-200/CEI-
x20 User’s Manual
62
When 'await data' mode is enabled for a particular receiver, calls to
AR_GETWORD or AR_GETWORDT put the calling thread to sleep if no
data word is available in the channel's sequential receive buffer. The
sleeping thread is awakened when either (a) waiting is cancelled with a
call to AR_CANCEL_DATA_WAIT, or (b) a word is received on the
channel in question. If no data word is available in the channel's
sequential receive buffer when a sleeping thread is awakened, the call to
AR_GETWORD or AR_GETWORDT returns ARS_NODATA. Note
that AR_GETWORD and AR_GETWORDT return failure if a thread is
already waiting to receive a word on the channel in question (only one
waiting thread per receive channel is supported).
The only routines that should be used to read data on a channel that is in
'await data' mode are AR_GETWORD or AR_GETWORDT. Other read
routines (AR_GETNEXT, AR_GETNEXTT, AR_GETBLOCK) must not
be used unless 'await data' mode is disabled. Only ARINC 429 and 561
receivers support 'await data' mode.
If 'await data' mode is enabled for a particular receiver and a thread is
currently asleep (in AR_GETWORD or AR_GETWORDT) waiting to
receive a word on the channel in question, then disabling 'await data' mode
on that channel also cancels the pending wait.
Note that 'await data' mode cannot be enabled unless internal interrupt
handling has also been enabled. Refer to AR_SET_PRELOAD_CONFIG
documentation for a discussion of internal interrupt handling limitations.
Utility Routines
–
Summary
This section lists all of the functions in the API, alphabetically by name.
Each of the following API utility routines is detailed in the remaining
sections of this chapter.
Use the prototypes in the UTILDEFS.H include file as the ultimate
guideline when programming with these routines.
Special note for CEI-100/CEI-200 users only:
The API routine
prototypes listed in this chapter are specified using platform-
independent data types. For example, CEI_UINT32 represents an
unsigned 32-bit value and CEI_INT16 represents a signed 16-bit value.
These platform-independent data types are not yet defined in the CEI-
100/CEI-200 distribution (CEI-SW). When calling functions in the CEI-
100/200 API, use appropriate native data types that are equivalent to
the platform-independent data types shown in the function prototypes
listed in this chapter.
ar_cancel_data_wait() Cancel a pending wait operation.
Note:
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com