ar_execute_bit

short ar_execute_bit (short board, short testType);

Purpose

This function performs BIT functionality testing of each matching ARINC 429 transmit/receive channel pair on the specified device.  When executing BIT functionality, you must assure external data is not present on any receive channel of the device.

NOTE: this function bypasses execution and returns a failure status if it is invoked when multi-process execution is enabled via ar_set_preload_config and multiple processes are attached to the specified board.

Parameters

Input

Name

Type

Description

board

short

(input) Device Number for the board to test, (valid range is 0-127).

testType

short

(input) type of test to execute, defined as follows:

 
AR_BIT_BASIC_STARTUP (0) invokes device initialization.  If the API routine AR_BYPASS_WRAP_TEST has been invoked to enable startup wrap testing, an internal wrap test of all matched transmit/receive channels will be executed.

AR_BIT_FULL_STARTUP    (1) invokes device initialization followed by an internal wrap test of all matched transmit/ receive channels, regardless of prior invocation of the API routine AR_BYPASS_WRAP_TEST.

AR_BIT_PERIODIC           (2) invokes a timer-deviation test, providing basic health status of the device.

AR_BIT_INT_LOOPBACK   (3) invokes an internal wrap test of all matched transmit/receive channels.

AR_BIT_EXT_LOOPBACK  (4) invokes an external wrap test of all matched transmit/receive channels.

AR_BIT_PARTIAL_SRAM   (8) invokes a short destructive test of select, unused SRAM locations

AR_BIT_FULL_SRAM         (9) invokes a destructive test of all SRAM locations

AR_BIT_RX_LOOPBACK    (10) exclusive to the RAR15-XMC products, invokes the Receiver BIT loopback functional test

 

AR_BIT_SELECT_SRAM_MIN to AR_BIT_SELECT_SRAM_MAX (100 to 1123)
invokes a destructive test of a select block of SRAM, parsed into 1024 blocks of 512 locations each.

Return Value

Name

Type

Description

status

short

status of the function call, with valid values of:
ARS_NORMAL                  Success.
ARS_INVBOARD              The board parameter value was invalid.

ARS_BOARD_MUTEX        Access to the Board Lock timed-out/failed.
ARS_MEMWRERR             A memory test failure was encountered.

ARS_WRAP_DROP_FAIL   A transmitted ARINC 429 message was dropped.
ARS_WRAP_DATA_FAIL   A transmit/receive ARINC 429 message mismatch was encountered.
ARS_WRAP_FLUSH_FAIL  An Unknown external ARINC 429 message was received.

ARS_INVARG                  Invalid testType parameter.

ARS_FAILURE                  Timer-deviation test failed or multi-process execution is enabled (not supported).

ARS_RX_BIT_CHnn_ERROR  Exclusive to the RAR15-XMC product line, indicates Receiver “nn” (01-32) loopback execution failure.

References

Utility Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description