abaco systems CEI-520 - Ar_Get_Latest

Program Interface Library AR_GET_LATEST
CEI-100/CEI-200/CEI-x20 User’s Manual 87
AR_GET_LATEST
void ar_get_latest (CEI_INT16 board, CEI_INT16 channel, CEI_UINT16
label, CEI_INT32 *data, CEI_CHAR *seqno);
This routine retrieves ARINC data when “Dedicated” data storage mode is
in effect (see AR_SET_STORAGE_MODE). It returns the most recently
received data for a selected label and channel. It also returns an eight-bit
sequence number that indicates the number of 32-bit ARINC words
received for that combination of label and channel.
For the CEI-100/200 and CEI-520/520A/620/820/820TX, if no data has
been received, this routine returns a data word with zero in all bits
except for the label field, which has the requested label value. Because
the sequence number is stored in the label field on the hardware, the
label is re-inserted by this routine after the sequence number has been
extracted from the hardware data. The CEI-220/420/420A returns a data
word containing all zeros if no labels have been received.
If you are using the CEI-520/520A/620/820/820TX enhanced API, the
“DEDICATED’ storage mode is always operational, and this function is
enhanced as follows:
 The entry point, AR_GET_LATEST, is used to return the latest value
for a label/channel. This function gets data from the “DEDICATED”
storage mode Snap Shot buffer 'SnapRBuf'. It returns the most
recently received data for a selected label and channel. It also returns
the eight-bit sequence number that indicates the number of ARINC
words received for that combination of label and channel.
 If the label requested is label 256 (an ARINC label that does not exist)
or the value “ARU_ALL_LABELS”, this function returns all 256
ARINC labels and sequence numbers for the specified channel, in
sequence, in successive “data” and “seqno” array elements. This
function assumes that the caller has allocated at least 256*4 bytes for
“data” and at least 256 bytes for “seqno” when being used in this
mode.
None
Syntax
Description
Note:
Return Value
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com