Software Library API naibrd 2.24.0
See all documentation at naii.docs.com
Functions
Interrupt Functions
NAI Board Library - Module Functions » DIF Module Functions

Functions

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptEnable (int32_t cardIndex, int32_t module, int32_t channel, naibrd_dif_chan_mapped_status_type_t type, bool_t enable)
 Sets the Interrupt Enable for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptEnable (int32_t cardIndex, int32_t module, int32_t channel, naibrd_dif_chan_mapped_status_type_t type, bool_t *outenable)
 Retrieves the Interrupt Enable for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptTriggerType (int32_t cardIndex, int32_t module, int32_t channel, naibrd_dif_chan_mapped_status_type_t type, naibrd_dif_interrupt_t interruptType)
 Sets the Interrupt Edge/Level property for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptTriggerType (int32_t cardIndex, int32_t module, int32_t channel, naibrd_dif_chan_mapped_status_type_t type, naibrd_dif_interrupt_t *outinterruptType)
 Retrieves the Interrupt Edge/Level property for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptVector (int32_t cardIndex, int32_t module, naibrd_dif_chan_mapped_status_type_t type, uint32_t vector)
 Sets the Interrupt Vector for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptVector (int32_t cardIndex, int32_t module, naibrd_dif_chan_mapped_status_type_t type, uint32_t *outvector)
 Retrieves the Interrupt Vector for the specified DIF channel and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptSteering (int32_t cardIndex, int32_t module, naibrd_dif_chan_mapped_status_type_t type, naibrd_int_steering_t steering)
 Sets the Interrupt Steering which indicates the interrupt direction for the specified DIF group and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptSteering (int32_t cardIndex, int32_t module, naibrd_dif_chan_mapped_status_type_t type, naibrd_int_steering_t *outsteering)
 Retrieves the Interrupt Steering which indicates the interrupt direction for the specified DIF group and interrupt status type.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetBITInterval (int32_t cardIndex, int32_t module, uint32_t bitInterval)
 Sets the BIT Error Interval. The BIT Error Interval essentially filter BIT errors prior to an actual notification of a BIT Error (maybe advantageous in "noisy/unstable" application environments or for general filtering purposes). The BIT Error Interval mechanism uses an up/down counter such that accumulated successive fault detections are counted up and no fault detections are counted down. The BIT Error Interval essentially sets up a threshold requirement of "successive" fault events to accumulate before actual notification of the fault.
 
NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetBITInterval (int32_t cardIndex, int32_t module, uint32_t *outbitInterval)
 Retrieves the BIT Error Interval. The BIT Error Interval essentially filter BIT errors prior to an actual notification of a BIT Error (maybe advantageous in "noisy/unstable" application environments or for general filtering purposes). The BIT Error Interval mechanism uses an up/down counter such that accumulated successive fault detections are counted up and no fault detections are counted down. The BIT Error Interval essentially sets up a threshold requirement of "successive" fault events to accumulate before actual notification of the fault.
 

Detailed Description

Function Documentation

◆ naibrd_DIF_GetBITInterval()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetBITInterval ( int32_t cardIndex,
int32_t module,
uint32_t * outbitInterval )

Retrieves the BIT Error Interval. The BIT Error Interval essentially filter BIT errors prior to an actual notification of a BIT Error (maybe advantageous in "noisy/unstable" application environments or for general filtering purposes). The BIT Error Interval mechanism uses an up/down counter such that accumulated successive fault detections are counted up and no fault detections are counted down. The BIT Error Interval essentially sets up a threshold requirement of "successive" fault events to accumulate before actual notification of the fault.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
outbitInterval: (Output) BIT Interval.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_GetChanMappedInterruptEnable()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptEnable ( int32_t cardIndex,
int32_t module,
int32_t channel,
naibrd_dif_chan_mapped_status_type_t type,
bool_t * outenable )

Retrieves the Interrupt Enable for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
channel: (Input) Channel Number of the channel to access (1 - [max channels for module]).
type: (Input) Status Type: refer to naibrd_dif_chan_mapped_status_type_t definitions (Latched types only).
outenable: (Output) 0 to disable, 1 to enable interrupt.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_CHANNEL when invalid channel parameter.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_GetChanMappedInterruptSteering()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptSteering ( int32_t cardIndex,
int32_t module,
naibrd_dif_chan_mapped_status_type_t type,
naibrd_int_steering_t * outsteering )

Retrieves the Interrupt Steering which indicates the interrupt direction for the specified DIF group and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
type: (Input) Status Type: refer to nai_dt_status_type_t definition.
outsteering: (Output) Interrupt Steering: refer to naibrd_int_steering_t definition.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_VALUE when an invalid naibrd_dif_chan_mapped_status_type_t type is specified.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_GetChanMappedInterruptTriggerType()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptTriggerType ( int32_t cardIndex,
int32_t module,
int32_t channel,
naibrd_dif_chan_mapped_status_type_t type,
naibrd_dif_interrupt_t * outinterruptType )

Retrieves the Interrupt Edge/Level property for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
channel: (Input) Channel Number of the channel to access (1 - [max channels for module]).
type: (Input) Status Type: refer to nai_dt_status_type_t definition.
outinterruptType: (Output) Interrupt Type: refer to nai_dt_interrupt_t definition.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_CHANNEL when invalid channel parameter.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_GetChanMappedInterruptVector()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_GetChanMappedInterruptVector ( int32_t cardIndex,
int32_t module,
naibrd_dif_chan_mapped_status_type_t type,
uint32_t * outvector )

Retrieves the Interrupt Vector for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
type: (Input) Status Type: refer to naibrd_dif_chan_mapped_status_type_t definitions (Latched types only).
outvector: (Output) Interrupt Vector.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_VALUE when an invalid naibrd_dif_chan_mapped_status_type_t type is specified.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_SetBITInterval()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetBITInterval ( int32_t cardIndex,
int32_t module,
uint32_t bitInterval )

Sets the BIT Error Interval. The BIT Error Interval essentially filter BIT errors prior to an actual notification of a BIT Error (maybe advantageous in "noisy/unstable" application environments or for general filtering purposes). The BIT Error Interval mechanism uses an up/down counter such that accumulated successive fault detections are counted up and no fault detections are counted down. The BIT Error Interval essentially sets up a threshold requirement of "successive" fault events to accumulate before actual notification of the fault.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
bitInterval: (Input) BIT Interval.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_SetChanMappedInterruptEnable()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptEnable ( int32_t cardIndex,
int32_t module,
int32_t channel,
naibrd_dif_chan_mapped_status_type_t type,
bool_t enable )

Sets the Interrupt Enable for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
channel: (Input) Channel Number of the channel to access (1 - [max channels for module]).
type: (Input) Status Type: refer to naibrd_dif_chan_mapped_status_type_t definitions (Latched types only).
enable: (Input) 0 to disable, 1 to enable interrupt.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_CHANNEL when invalid channel parameter.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_SetChanMappedInterruptSteering()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptSteering ( int32_t cardIndex,
int32_t module,
naibrd_dif_chan_mapped_status_type_t type,
naibrd_int_steering_t steering )

Sets the Interrupt Steering which indicates the interrupt direction for the specified DIF group and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
type: (Input) Status Type: refer to nai_dt_status_type_t definition.
steering: (Input) Interrupt Steering: refer to naibrd_int_steering_t definition.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_VALUE when an invalid naibrd_dif_chan_mapped_status_type_t type is specified.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_SetChanMappedInterruptTriggerType()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptTriggerType ( int32_t cardIndex,
int32_t module,
int32_t channel,
naibrd_dif_chan_mapped_status_type_t type,
naibrd_dif_interrupt_t interruptType )

Sets the Interrupt Edge/Level property for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
channel: (Input) Channel Number of the channel to access (1 - [max channels for module]).
type: (Input) Status Type: refer to nai_dt_status_type_t definition.
interruptType: (Input) Interrupt Type: refer to nai_dt_interrupt_t definition.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_CHANNEL when invalid channel parameter.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.

◆ naibrd_DIF_SetChanMappedInterruptVector()

NAIBRDFUNC nai_status_t NAIAPI naibrd_DIF_SetChanMappedInterruptVector ( int32_t cardIndex,
int32_t module,
naibrd_dif_chan_mapped_status_type_t type,
uint32_t vector )

Sets the Interrupt Vector for the specified DIF channel and interrupt status type.

Parameters
cardIndex: (Input) Logical Card Index assigned to connection with the NAI_BOARD (0 - NAI_MAX_CARDS-1).
module: (Input) Module Number of the module to access (1 - [max modules for board]).
type: (Input) Status Type: refer to naibrd_dif_chan_mapped_status_type_t definitions (Latched types only).
vector: (Input) Interrupt Vector.
Returns
  • NAI_SUCCESS
  • NAI_ERROR_INVALID_CARD when invalid card parameter is specified.
  • NAI_ERROR_INVALID_MODULE when invalid card parameter is specified.
  • NAI_ERROR_NOT_OPEN when handle to board is invalid.
  • NAI_ERROR_INVALID_VALUE when an invalid naibrd_dif_chan_mapped_status_type_t type is specified.
  • NAI_ERROR_NOT_SUPPORTED when function is not supported.