ar_set_config

short ar_set_config (short board, short item, long value);

Purpose

This function assigns the respective device configuration register attribute state based on the item parameter selection.  It is specifically intended to support board and channel configuration attribute assignment compatibility with the legacy CEI-x20-SW API.  It should not be used for ARINC 429 channel configuration in applications authored specifically for the CEI-x30 products.

Parameters

Input

Name

Type

Description

board

short

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

item

short

(input) The channel configuration attribute to assign.  Supported board-level item parameter values are defined as follows:

ARU_RX_TIMETAG_MODE             (440) Receive message time-tag reporting mode
ARU_IRIG_WRAP_ENABLE            (441) IRIG receiver internal wrap
ARU_IRIG_INPUT_THREASHOLD   (442) Assign IRIG receive threshold
ARU_IRIG_ADJUST_THREASHOLD (443) Invoke IRIG "calibration"
ARU_IRIG_QUICK_ADJUSTMENT   (444) Invoke IRIG quick adjustment
ARU_IRIG_SET_BIAS                   (446) Assign IRIG offset time value

 

Legacy CEI-x20 channel configuration item parameter values supported are:
 
ARU_RX_CHxx_BIT_RATE              (40-55 and 500-531)
ARU_TX_CHxx_BIT_RATE              (60-75 and 700-731)
ARU_RX_CHxx_PARITY                 (80-95 and 900-931)
ARU_TX_CHxx_PARITY          (100-115 and 1100-1131)
ARU_TX_CHxx_SHUT_OFF      (240-255 and 1700-1731)
ARU_TX_CHxx_HB_INJ          (180-195 and 3300-3331)
ARU_TX_CHxx_LB_INJ           (200-215 and 3500-3531)
ARU_TX_CHxx_GAP_INJ        (220-235 and 3700-3731)

 

Legacy CEI-100/200 channel configuration item parameter values supported are:

ARU_XMIT_RATE (1) assigns the transmitter bus speed for all installed transmit channels to a specific frequency (in Hertz).
ARU_RECV_RATE (2) assigns the receiver bus speed for all installed receive channels to a specific frequency (in Hertz).
ARU_PARITY (3)    assigns parity for all channels.
ARU_INTERNAL_WRAP (4) assigns internal wrap for all receivers

value

int

(input) The channel configuration attribute state to assign.  Specific board-level value parameter values are defined as follows:

ARU_RX_TIMETAG_MODE      AR_TIMETAG_EXT_IRIG_64BIT     (0) 64-bit IRIG
                                           AR_TIMETAG_INT_USEC_64BIT    (1) 64-bit 1usec
                                           AR_TIMETAG_INT_20USEC_32BIT (3) 32-bit 20usec
                                           AR_TIMETAG_INT_MSEC_32BIT    (4) 32-bit 1msec
                                           AR_TIMER_X20_COMPAT_32BIT    (5) CEI-x20 compatible programmable resolution

ARU_IRIG_WRAP_ENABLE      AR_ON  (7) internal wrap enabled
                                            AR_OFF (8) internal wrap disabled

ARU_IRIG_INPUT_THREASHOLD     IRIG input DAC threashold voltage, in millivolts

ARU_IRIG_ADJUST_THREASHOLD  AR_ON  (7) print DAC settings to console
                                                   AR_OFF (8) don't print anything to console

ARU_IRIG_QUICK_ADJUSTMENT   Value not applicable

ARU_IRIG_SET_BIAS               Application defined IRIG sample time offset, range is +/-32768 milliseconds     

Legacy channel configuration item parameter value selections supported are:


ARU_PARITY                           ARU_PARITY_ODD  (0) ODD parity active
                                             ARU_PARITY_EVEN (1) EVEN parity active
                                             ARU_PARITY_NONE (2) NO parity selected, bit 31 transmitted as supplied

ARU_INTERNAL_WRAP            AR_WRAP_OFF (1) Internal wrap disabled
                                            AR_WRAP_ON  (0) Internal wrap enabled

ARU_RX_CHxx_BIT_RATE &    AR_LOW   (1) 12.5 Kbps
ARU_TX_CHxx_BIT_RATE       AR_HIGH  (0) 100 Kbps

                                            Non-standard Speed as Frequency in Hertz

 

ARU_RX_CHxx_PARITY          AR_OFF or AR_ODD  
ARU_TX_CHxx_PARITY          AR_OFF, AR_ODD or AR_EVEN

ARU_TX_CHxx_SHUT_OFF      AR_ON or AR_OFF
ARU_TX_CHxx_HB_INJ
ARU_TX_CHxx_LB_INJ
ARU_TX_CHxx_GAP_INJ

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_INVARG                  The item parameter value was not supported by this function or device configuration.
ARS_INVHARVAL             An invalid channel was implied from, or the value parameter was not valid for, the item parameter value supplied.

ARS_BOARD_MUTEX        Access to the Board Lock timed-out/failed.

References

Device Configuration Functions
Alphabetical Function Index
Hierarchical Function Index

CEI-x30 API Description