MX Foundation 4
Attributes Reference

The following attributes are available for all devices supporting an ARINC 717 interface.



Subframe Size

The KMXF_A717_SUBFRAME_SIZE attribute (TX/RX channels) holds the ARINC 717 subframe size, in number of words.
The supported range is:

Range Value
(words)
Minimum 32
Maximum 8192


Default value = 64


RX Synchronization Word 0

The KMXF_A717_RX_SYNC_WORD_0 attribute holds the actual channel (RX channel only) synchronization bit pattern of sub-frame #0. The supported values are any 12 bit values.
Default value = 0x247


RX Synchronization Word 1

The KMXF_A717_RX_SYNC_WORD_1 attribute holds the actual channel (RX channel only) synchronization bit pattern of sub-frame #1. The supported values are any 12 bit values.
Default value = 0x5B8


RX Synchronization Word 2

The KMXF_A717_RX_SYNC_WORD_2 attribute holds the actual channel (RX channel only) synchronization bit pattern of sub-frame #2. The supported values are any 12 bit values.
Default value = 0xA47


RX Synchronization Word 3

The KMXF_A717_RX_SYNC_WORD_3 attribute holds the actual channel (RX channel only) synchronization bit pattern of sub-frame #3. The supported values are any 12 bit values.
Default value = 0xDB8


Bit encoding

The KMXF_A717_BIT_ENCODING attribute defines the way bits are encoded.
When changing this attribute with KMXF_A717_ELECTRICAL_SELECTION set to VMXF_A717_ELECTRICAL_SELECT_DEFAULT, it will also changes the electrical settings of the channel for the selected encoding.

The options are:

Constant Value
VMXF_A717_BIT_ENCODING_HARVARDBIPHASE Harvard bi-phase encoding (default)
VMXF_A717_BIT_ENCODING_BIPOLAR_RZ Bipolar RZ encoding (auxiliary output)


Loopback Mode

The KMXF_A717_TX_RX_TEST_LB attribute holds the TX-to-RX loopback state for the receiver channel. When the loopback mode is enabled, the received data comes from the corresponding internal transmitter instead of the default configuration where the received data comes from the RX line circuit. This feature is intended for demo applications or for test purposes. When enabled, the module's first RX channel receives data transmitted by the first TX channel, the second RX channel receives data from the second TX channel, and so on.

The supported values are:

Constant Value
VMXF_ENABLE Enable loopback
VMXF_DISABLE Disable loopback (default)


RX Mode

The KMXF_A717_RX_MODE attribute holds the RX mode for the receiver channel. When the standard mode is enabled, the received data is returned to the application in one record for each subframe. The receiver must be synchronized to all four synchronization words to return data in string mode. In raw mode, one record will be returned for each 12-bit word. It is up to the application to find the synchronization words to decode the subframes.

The supported values are:

Constant Value
VMXF_A717_RX_MODE_STANDARD Standard mode (default)
VMXF_A717_RX_MODE_RAW Raw mode


RX Timetag Enable

The KMXF_A717_MODULE_RX_TIMETAG_ENABLE attribute defines the RX time tag enable state. When the time tag reception is disabled, the timeTag field of MXF_A717_DATAREC will always be 0.

Constant Value
VMXF_ENABLE Enable time tag (default)
VMXF_DISABLE Disable time tag


RX FIFO Aging Timeout

The KMXF_A717_MODULE_RX_FIFO_AGING attribute defines the FIFO aging timeout value for a receiver channel. It defines the longest delay that a received word can wait in the hardware FIFO before a receive interrupt is generated. The attribute value resolution is based on the timebase resolution. A RX FIFO Aging Timeout value of 0 disables the aging timeout. The attribute value is rounded down to step of 128 microseconds.

The supported range is:

Module Range (microsecond) Default (microsecond) Note
MXF_MODULE_MULTI_EH 0 - 32640 16256 Value is rounded down to step of 128 microseconds
MXF_MODULE_MULTI 0 - 32640 8192 Value is rounded down to step of 128 microseconds
Note
MX Foundation takes care of initializing this attribute using the optimal value. It is not recommended to change this attribute unless told to do so by a MAX Technologies' support engineer.


RX FIFO Almost Full Threshold

The KMXF_A717_MODULE_RX_FIFO_AF attribute holds the almost full threshold for a receiver channel. This attribute value determines the number of received words that must be accumulated in the receive hardware FIFO before an interrupt is generated.

The supported range is:

Module Range (16-bit word) Default (16-bit word)
MXF_MODULE_MULTI_EH 1 - 255 32
MXF_MODULE_MULTI 1 - 255 16
Note
MX Foundation takes care of initializing this attribute using the optimal value. It is not recommended to change this attribute unless told to do so by a MAX Technologies' support engineer.


TX FIFO Almost Full Threshold

The KMXF_A717_MODULE_TX_FIFO_AF attribute holds the almost full threshold for a transmitter channel. This attribute value determines the number of transmit 16-bit words that are to be queued in the transmit hardware FIFO. The transmit interrupt is automatically cleared once this threshold is reached.

The supported range is:

Module Range (16-bit word) Default (16-bit word)
MXF_MODULE_MULTI_EH 2 - 255 128
MXF_MODULE_MULTI 2 - 255 128
Note
MX Foundation takes care of initializing this attribute using the optimal value. It is not recommended to change this attribute unless told to do so by a MAX Technologies' support engineer.


TX FIFO Almost Empty Threshold

The KMXF_A717_MODULE_TX_FIFO_AE attribute holds the almost empty threshold for a transmitter channel. The transmit interrupt is generated whenever the number of 16-bit words remaining in the transmit hardware FIFO is less or equal to the value specified by this attribute. The software embedded process is then able to react and fill in the transmit FIFO.

The supported range is:

Module Range (16-bit word) Default (16-bit word)
MXF_MODULE_MULTI_EH 1 - 254 64
MXF_MODULE_MULTI 1 - 254 64
Note
MX Foundation takes care of initializing this attribute using the optimal value. It is not recommended to change this attribute unless told to do so by a MAX Technologies' support engineer.


Electrical Selection

The KMXF_A717_ELECTRICAL_SELECTION attribute holds the actual channel electrical selection. When the electrical selection is set to default, all electrical attributes below are set to the default value and are read only. To modify any of these attributes, set electrical selection to custom. Available only on IO-MULTI-EH channels.

Electrical attributes:
KMXF_A717_RX_DIFF_VOLTAGE_THRESHOLD
KMXF_A717_TX_SLEW_RATE_SELECTION
KMXF_A717_TX_SLEW_RATE
KMXF_A717_TX_DIFF_VOLTAGE_HIGH
KMXF_A717_TX_DIFF_VOLTAGE_LOW
KMXF_A717_TX_VOLTAGE_OFFSET

The supported values are:

Constant Value
VMXF_A717_ELECTRICAL_SELECT_DEFAULT Select default electrical parameters (default)
VMXF_A717_ELECTRICAL_SELECT_CUSTOM Select custom electrical parameters


RX Differential Voltage Threshold

The KMXF_A717_RX_DIFF_VOLTAGE_THRESHOLD attribute defines the RX differential voltage threshold. This is a floating point attribute. To modify this attribute value, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom. Available only on IO-MULTI-EH and IPM-MULTI channels.

The supported range is:

Range Value (volt)
Minimum 0.0
Maximum 25.0

Resolution: 0.05224 volt

Default value = 0.20 volt


TX Slew Rate Selection

The KMXF_A717_TX_SLEW_RATE_SELECTION attribute defines the TX slew rate selection. MX Foundation automatically calculates the default slew rate depending on the sub-frame word size. When the default option (VMXF_A717_ELECTRICAL_SELECT_DEFAULT) is selected, the KMXF_A717_TX_SLEW_RATE attribute is read only. Otherwise, when the custom option (VMXF_A717_TX_SLEW_RATE_SELECT_CUSTOM) is selected, the slew rate must be specified using the KMXF_A717_TX_SLEW_RATE attribute. To modify this attribute value on IO-MULTI-EH and IPM-MULTI channel, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom.

The supported values are:

Constant Value
VMXF_A717_TX_SLEW_RATE_SELECT_DEFAULT Select default slew rate parameter (default)
VMXF_A717_TX_SLEW_RATE_SELECT_CUSTOM Select custom slew rate parameter


TX Slew Rate

The KMXF_A717_TX_SLEW_RATE attribute defines the TX slew rate value. The KMXF_A717_TX_SLEW_RATE_SELECTION attribute must be set to VMXF_A717_TX_SLEW_RATE_SELECT_CUSTOM in order to specify the slew rate using the KMXF_A717_TX_SLEW_RATE attribute. This is a floating point attribute for parametric channel. To modify this attribute value on IO-MULTI-EH and IPM-MULTI channel, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom.

The supported values for FlexMobile are:

Value (microsecond)
1.5
3.75
7.5 (default)
10

The supported range for others is:

Module Range (nsec/volt) Default (nsec/volt) Formula
MXF_MODULE_MULTI_EH 2.0 - 13429.5 1919 (204800/1.22) / (n*3.125) with 4 ≤ n ≤ 26856
MXF_MODULE_MULTI 25.0 - 25600.0 1829 102400/n with 4096 ≤ n ≤ 51200


High TX Differential Voltage Value

The KMXF_A717_TX_DIFF_VOLTAGE_HIGH attribute defines the high TX differential voltage value. This is a floating point attribute. To modify the attribute value, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom. Available only on IO-MULTI-EH channels.

The supported range is:

Module Range (Volt)
MXF_MODULE_MULTI_EH see table below
MXF_MODULE_MULTI -9.16 – +9.16

Default value: +2.50 volt

MXF_MODULE_MULTI_EH

Device Type Revision MXF Version Range (Volt)
FlexMulti 629 Up to 2.4 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
2.5 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 1553 Up to 3.2 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.3 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 429
FlexMulti 664
FlexMulti
Up to 3.0 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.1 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5


Low TX Differential Voltage Value

The KMXF_A717_TX_DIFF_VOLTAGE_LOW attribute defines the high TX differential voltage value. This is a floating attribute. To modify the attribute value, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom. Available only on IO-MULTI-EH channels.

The supported range is:

Module Range (Volt)
MXF_MODULE_MULTI_EH see table below
MXF_MODULE_MULTI -9.16 – +9.16

Default value: -2.50 volt

MXF_MODULE_MULTI_EH

Device Type Revision MXF Version Range (Volt)
FlexMulti 629 Up to 2.4 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
2.5 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 1553 Up to 3.2 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.3 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 429
FlexMulti 664
FlexMulti
Up to 3.0 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.1 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5


TX Voltage Offset

The KMXF_A717_TX_VOLTAGE_OFFSET attribute defines the TX voltage offset. This is a floating attribute. To modify the attribute value, the KMXF_A717_ELECTRICAL_SELECTION attribute must be set to custom. Available only on IO-MULTI-EH channels.

The supported range is:

Module Range (Volt)
MXF_MODULE_MULTI_EH see table below
MXF_MODULE_MULTI -10.0 – +10.0

Default value: 2.50 volt

MXF_MODULE_MULTI_EH

Device Type Revision MXF Version Range (Volt)
FlexMulti 629 Up to 2.4 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
2.5 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 1553 Up to 3.2 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.3 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5
FlexMulti 429
FlexMulti 664
FlexMulti
Up to 3.0 Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.1 – +6.1
3.1 and later Up to 4.2.5 -5.0 – +5.0
4.3.0 to 4.4.1 -6.0 – +6.0
4.4.2 and later -6.5 – +6.5


Updated 10/23/2023