ar_loadslv

short ar_loadslv (short board, unsigned int base_seg, int base_port, unsigned short ram_size);

Purpose

This function initializes the API and device via invocation of ar_initialize_api() and ar_initialize_device().  It acquires the address space allocated to the device and invokes an initialization/reset procedure.  If any portion of the initialization fails or the board is not detected, a status other than ARS_NORMAL is returned.
See the ar_initialize_device function description for details regarding the default setup of the device following execution of this function.

Parameters

Input

Name

Type

Description

board

short

(input) Device Number for the product/resource to open, (valid range is 0-15).

base_seg

unsigned int

Legacy parameter not used in this API - provided only for compatibility to older ARINC product API's.

base_port

int

Legacy parameter not used in this API - provided only for compatibility to older ARINC product API's.

ram_size

unsigned short

Legacy parameter not used in this API - provided only for compatibility to older ARINC product API's.

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_BADLOAD               The device driver session was opened successfully but the device firmware download failed.
ARS_BOARD_MUTEX       Access to the Board Lock timed-out/failed.
ARS_MEMWRERR            A memory test failure was encountered.

ARS_WRAP_DROP_FAIL  ARINC 429 wrap data missing encountered when the internal wrap test was executed.
ARS_WRAP_DATA_FAIL  ARINC 429 wrap data pattern mismatch encountered when the internal wrap test was executed.
ARS_WRAP_FLUSH_FAIL Unknown external data was encountered when the internal wrap test was executed.

ARS_HW_DETECT          The device driver session was opened but the detected device is not recognized as a CEI-x30 product.

ARS_WINRTFAIL            The device driver failed to open a session with the device, either because the device is not properly installed in the host system or a resource conflict is inhibiting device driver initialization.  

References

Initialization Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description