ar_set_device_config

short ar_set_device_config (short board, short channel, short item, short value);

Purpose

This function assigns the state of the specified channel configuration register attribute based on the combined values of the item/value parameters.  It also supports various board-level attribute selections.

Parameters

Input

Name

Type

Description

board

short

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

channel

short

(input) The ARINC 429 or Discrete “channel” index, when applicable (valid range is 0 to one less than the total number of channels installed for the channel type referenced via the item parameter)

item

short

(input) The channel configuration attribute to (re)set.  Valid  "item" options are:
ARU_RX_BITRATE                         (1)   Receiver bus speed
ARU_TX_BITRATE                         (2)   Transmitter bus speed
ARU_RX_PARITY                           (3)   Receiver parity detection
ARU_TX_PARITY                           (4)   Transmitter parity selection
ARU_RECV_MODE                         (5)   Receiver internal wrap
ARU_TX_BIT_ERROR                     (6)   Transmitter bit count error
ARU_TX_GAP_ERROR                    (8)   Transmit inter-msg gap error
ARU_RX_FIFO_ENABLE                 (16)  Receiver FIFO operation
ARU_TX_DISABLE                        (10)  External Transmit selection
ARU_TX_FIFO_ENABLE                  (17)  Transmitter FIFO operation
ARU_DISCRETE_OUT                    (12)  Discrete output state
ARU_RX_MERGED_MODE               (18)  Receiver FIFO selection
ARU_DIFFERENTIAL_OUT               (23)  Differential output state

ARU_IRIG_OUTPUT_ENABLE          (26)  R830-RX IRIG generator enable

ARU_HW_ENHANCE_UPDATE          (31) Enhanced f/w compatibility program

ARU_INSERT_INT_Q_ENTRY           (37) Insert PCI interrupt queue entry

ARU_ACCESS_SNAPSHOT_BUFFER (38)  Snapshot buffer storage select
ARU_BYPASS_INIT_WRAP_TEST    (320) Bypass the init wrap test
ARU_MULTITHREAD_PROTECT       (321) Enable func thread protection
ARU_FAST_SLEW_RATE                (323) Transmitter slew rate
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

value

short

(input) The channel configuration attribute state.  Valid value parameter values for each item value are defined as follows:
ARU_RX_BITRATE  &               ARU_SPEED_LOW   (1) 12.5 Kbps
ARU_TX_BITRATE                   ARU_SPEED_HIGH  (0) 100 Kbps
                                             Custom Bus Speed = 16,000,000 / value+2

ARU_RX_PARITY                     AR_ON  (7) Parity detect enabled
                                             AR_OFF (8) Parity detect disabled

ARU_TX_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_RECV_MODE                   AR_WRAP_OFF (1) Internal wrap disabled
                                             AR_WRAP_ON  (0) Internal wrap enabled

ARU_RX_FIFO_ENABLE            AR_ON   (7) Rx FIFO operation enabled
                                             AR_OFF  (8) Rx FIFO operation disabled

ARU_RX_MERGED_MODE         AR_ON   (7) Rx directed to Merged FIFO
                                             AR_OFF  (8) Rx directed to Channel FIFO

ARU_TX_DISABLE                   AR_ON  (7) External Transmit disabled
                                             AR_OFF (8) External Transmit enabled

ARU_TX_FIFO_ENABLE             AR_ON  (7) Tx FIFO operation enabled
                                             AR_OFF (8) Tx FIFO operation disabled

ARU_TX_BIT_ERROR               AR_HI   (1) Tx long (33-bit) msg error
                                             AR_LO   (0) Tx short (31-bit) msg error
                                             AR_OFF  (8) Tx message length error disabled

ARU_TX_GAP_ERROR              AR_ON  (7) Tx inter-message gap error enabled
                                             AR_OFF (8) Tx inter-message gap error disabled

ARU_FAST_SLEW_RATE           AR_ON  (7) transmission using a 1.5 microsecond rise time
                                             AR_OFF (8) transmission using a 10 microsecond rise time

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_ACCESS_SNAPSHOT_BUFFER   
                                             ARU_LABEL_ONLY        (0)
                                             ARU_LABEL_WITH_SDI (1)

ARU_BYPASS_INIT_WRAP_TEST
                                             AR_ON  (7) bypass wrap test during init
                                             AR_OFF (8) execute wrap test during init

ARU_MULTITHREAD_PROTECT
                                             AR_ON  (7) h/w access protection enabled
                                             AR_OFF (8) h/w access protection disabled

ARU_HW_ENHANCE_UPDATE    AR_ON  (7) support for the CEI-x30 Enhanced Firmware Interface is enabled

                                             AR_OFF (8) support for the CEI-x30 Enhanced Firmware Interface is disabled

 

ARU_INSERT_INT_Q_ENTRY    Value not applicable

 

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

ARU_IRIG_OUTPUT_ENABLE    AR_ON  (7) R830RX IRIG Generator enabled
                                             AR_OFF (8) R830RX IRIG Generator 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        

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 supplied or the value parameter was not valid for the item parameter supplied.

ARS_INT_ISR                  Interrupt was either not initialized or not terminated successfully.  

ARS_DRIVERFAIL             Interrupt was either not initialized or not terminated successfully.  

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