Program Interface Library
AR_SET_STORAGE_MODE
CEI-100/CEI-200/CEI-
x20 User’s Manual
142
AR_SET_STORAGE_MODE
CEI_INT16 ar_set_storage_mode (CEI_INT16 board, CEI_INT16 flag);
There are three possible methods for storage of received data on the
ARINC interface. The default method is Buffered Mode, which puts the
data in a circular buffer with all data received on a particular channel
stored chronologically in that channel's buffer. Each channel has its own
individual buffer memory. You must use the utility AR_GETWORD or
AR_GETNEXT to retrieve data sequentially from the buffer. If time
tagging has been enabled, you must use AR_GETWORDT or
AR_GETNEXTT to sequentially retrieve the data plus the time tag.
A permutation of Buffered Mode, called Merged Mode, merges all of the
data for all receive channels into a single buffer. The storage areas for the
individual receive channels are combined into one large buffer. Time
tagging is automatically enabled. The buffer for receive channel 0
contains all of the data. You must use the utility AR_GETWORDT or
AR_GETNEXTT for this channel to retrieve data sequentially from the
buffer. On the CEI-100, the most significant bit of the time tag is
overwritten with the channel. On the CEI-200, the most significant three
bits of the time tag are overwritten with the channel number. On the CEI-
x20, the most significant four bits of the time tag are overwritten with the
channel number. This opposes the time tagging in Buffered Mode, which
maintains that range.
An alternate storage method, Dedicated Mode, is available which puts
received data in a dedicated location in memory, based on label and
channel. Only the most recently received data is stored for any given
label/channel combination. When this method is used, an 8-bit sequence
number is maintained for each label/channel location. It is incremented
each time a word is stored by the ARINC processor. You can retrieve data
that is stored in this method by using the utility AR_GET_LATEST.
This routine defines the storage mode for all receive channels on the
interface and must be called before starting the board with AR_GO.
Time tagging is only available for Buffered Mode and Merged Mode.
When using the Enhanced API for the CEI-520/520A/620/820/820TX, the
board supports concurrent operation of both Buffered and Dedicated
receive modes. Calling this function to enable Dedicated mode is ignored
and returns ARS_NORMAL.
See AR_SETCHPARMS for a superior replacement for this function.
Syntax
Description
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com