ar_get_latest_t

int ar_get_latest_t (short board, short channel, unsigned short label, unsigned int * data, TIME_TAG_TYPE * timeTag);

Purpose

This function retrieves the latest ARINC 429 message and time-stamp received for the specified channel/label combination from the snapshot buffer. 

 

When using this function, the host application should set the snapshot storage mode to label field only, (see the documentation on the function ar_set_device_config, for the configuration option ARU_ACCESS_SNAPSHOT_BUFFER).  This sets up the device to store the ARINC 429 message and time-stamp in the snapshot buffer based on the label field value only, ignoring the SDI bit field value.

If no message has been received for the specified channel/label since the last initialization of the device, a data value of zero is returned for the message and time-stamp.  If the timeTag parameter is NULL, no time-stamp information is returned.

Parameters

Input

 

Name

Type

Description

board

short

(input) Device Number of the board to reference, (valid range is 0-15).

channel

short

(input) Specifies which receive channel this routine is to access.  Valid range is 0 to one less than the installed ARINC 429 receive channel count.

label

unsigned short

(input) The label value of interest.

Output

 

 

Name

Type

Description

data

unsigned int

(passed by reference)

(output) The latest received 32-bit ARINC 429 message value for the specified label.

timeTag

TIME_TAG_TYPE

(passed by reference)

(output) The 64-bit message time-stamp, the format of which is determined by the current selected API time-tag reference.

Return Value

Name

Type

Description

status

short

status of the function call, with valid values of:
ARS_NORMAL            Routine execution was successful.
ARS_BOARD_MUTEX  Access to the Board Lock timed-out/failed.
ARS_INVBOARD        The board parameter value was invalid.
ARS_INVARG            An invalid label or null data parameter was provided.

ARS_INVHARVAL       The channel parameter was not valid for this device configuration.

References

Receive Data Processing Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description