MX Foundation 4

Functions

uint32 mxfSelfTestMEMORY (HMXF_DEVICE device, uint64 level, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestMILSTD1553 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestEBR1553 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestSERIALASYNC (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestARINC429 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestARINC629 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestARINC708 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestARINC717 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestCSDB (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestDISCRETE (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestHDLC (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestARINC664 (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestCANBUS (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestFLEXDIO (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestHFCE (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestCURRENT (HMXF_DEVICE device, uint64 zone, double *value, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestTEMPERATURE (HMXF_DEVICE device, uint64 zone, double *value, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestNVSTORAGE (HMXF_DEVICE device, uint64 level, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestRTCLK (HMXF_DEVICE device, uint64 level, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestDEBUGCOMPORT (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestETHERNET (HMXF_DEVICE device, uint64 port, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestSYNCIO (HMXF_DEVICE device, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 
uint32 mxfSelfTestIRIGB (HMXF_DEVICE device, uint64 signal, uint64 level, uint64 extLoopback, uint64 *result, char *info, char *diagnostic)
 

Variables

<!--uint32mxfSelfTestASCB(HMXF_DEVICEdevice, uint64port, uint64level, uint64extLoopback, uint64 *result, char *info, char *diagnostic);--> uint32 mxfSelfTestVOLTAGE (HMXF_DEVICE device, uint64 zone, double *value, uint64 *result, char *info, char *diagnostic)
 

Detailed Description

Function Documentation

uint32 mxfSelfTestMEMORY ( HMXF_DEVICE  device,
uint64  level,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestMEMORY(UInt64 device, UInt64 level, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestMEMORY(UInt64 device, UInt64 level, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a memory self-test on the specified device.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test. Test 32-bit and random access.
MXF_SELFTEST_LEVEL_EXHAUSTIVE Execute exhaustive test. Test 32-bit, 16-bit and 8-bit access three times and random access.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestMILSTD1553 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestMILSTD1553(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestMILSTD1553(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a MIL-STD-1553 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0-3)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Port must be physically connected to an external bus.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestARINC429()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestEBR1553 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestEBR1553(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestEBR1553(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a EBR-1553 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0-3)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Port must be physically connected to an external bus.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestARINC429()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestSERIALASYNC ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestSERIALASYNC(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestSERIALASYNC(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a ASYNC protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0, TX1 with RX1, ...).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestARINC429()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestARINC429 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestARINC429(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestARINC429(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs an ARINC 429 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestARINC629 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestARINC629(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestARINC629(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs an ARINC 629 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Port must be physically connected to an external bus.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestARINC708 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestARINC708(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestARINC708(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs an ARINC 708 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestARINC717 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestARINC717(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestARINC717(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs an ARINC 717 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestCSDB ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestCSDB(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestCSDB(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a CSDB protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestDISCRETE ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestDISCRETE(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestDISCRETE(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Discrete self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0) for directional discrete. External power must be supplied for 28V avionics discrete.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestARINC429()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
mxfSelfTestFLEXDIO()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestHDLC ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestHDLC(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestHDLC(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a HDLC protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestARINC664 ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestARINC664(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestARINC664(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a ARINC 664 protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.2 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestCANBUS()
uint32 mxfSelfTestCANBUS ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestCANBUS(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestCANBUS(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a CAN bus protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Port must be physically connected to an external bus.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.2 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestARINC664()
mxfSelfTestHDLC()
uint32 mxfSelfTestFLEXDIO ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestFLEXDIO(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestFLEXDIO(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Flex Discrete self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. External power must be supplied.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.5.6 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestARINC429()
mxfSelfTestCSDB()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestHDLC()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
mxfSelfTestDISCRETE()
Examples:
selfTests.c.
uint32 mxfSelfTestHFCE ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestHFCE(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestHFCE(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a HFCE protocol self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX port must be physically connected to its corresponding RX port (TX0 with RX0 and TX1 with RX1).
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.4.2 and later.
See also
mxfSelfTestMILSTD1553()
mxfSelfTestEBR1553()
mxfSelfTestSERIALASYNC()
mxfSelfTestDISCRETE()
mxfSelfTestCSDB()
mxfSelfTestARINC429()
mxfSelfTestARINC629()
mxfSelfTestARINC708()
mxfSelfTestARINC717()
mxfSelfTestARINC664()
mxfSelfTestCANBUS()
uint32 mxfSelfTestCURRENT ( HMXF_DEVICE  device,
uint64  zone,
double *  value,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestCURRENT(UInt64 device, UInt64 zone, out double value, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestCURRENT(UInt64 device, UInt64 zone, out double value, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Current self-test on the specified zone.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]zoneDevice zone number
Device Zone Description
FlexMulti 0 +3.3 V current
1 +12 V current
2 +5 V current
3 +3.3 V switchers current (FlexMulti 1553 and FlexMulti 629)
+2.5 V current (FlexMulti 664 and FlexMulti 429)
Flex1553-PCIe 0 +3.3 V current
1 +12 V current
FlexMobile 0 +12 V current
PMC/XMC 0 +3.3 V current
1 +12 V current
2 +5 V current
FlexMAX 0 +12 V current
1 +12 V modules current
[out]valueCurrent value (ampere)
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestTEMPERATURE ( HMXF_DEVICE  device,
uint64  zone,
double *  value,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestTEMPERATURE(UInt64 device, UInt64 zone, out double value, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestTEMPERATURE(UInt64 device, UInt64 zone, out double value, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Temperature self-test on the specified zone.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]zoneDevice zone number
Device Zone Description
FlexMulti 0 FPGA Temperature
1 CPU Temperature
2 IO #1 Temperature
3 IO #2 Temperature
Flex1553-PCIe 0 FPGA Temperature
1 CPU Temperature
500 Series carrier 0 FPGA Temperature
1 Power Section Temperature
FlexMobile 0 FPGA Temperature
1 Parametric Temperature
PMC/XMC 0 FPGA Temperature
1 Avionics Section Temperature
FlexMAX 0 FPGA Temperature
[out]valueTemperature value (°C)
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestNVSTORAGE ( HMXF_DEVICE  device,
uint64  level,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestNVSTORAGE(UInt64 device, UInt64 level, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestNVSTORAGE(UInt64 device, UInt64 level, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Non-volatile storage self-test on the specified device.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestRTCLK ( HMXF_DEVICE  device,
uint64  level,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestRTCLK(UInt64 device, UInt64 level, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestRTCLK(UInt64 device, UInt64 level, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Real time clock self-test on the specified device.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestDEBUGCOMPORT ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestDEBUGCOMPORT(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestDEBUGCOMPORT(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Serial communication interface (RS-232) self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. TX pin must be physically connected to its corresponding RX pin.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestETHERNET ( HMXF_DEVICE  device,
uint64  port,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestETHERNET(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestETHERNET(UInt64 device, UInt64 port, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Ethernet self-test on the specified port.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]portDevice port number (0)
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Port must be physically connected a network.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestSYNCIO ( HMXF_DEVICE  device,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestSYNCIO(UInt64 device, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestSYNCIO(UInt64 device, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Synchronization I/O (sync In/Out pins) self-test on the specified device.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback
VMXF_ENABLE Using the external loopback. Sync Out must be physically connected to Sync In of the device.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
uint32 mxfSelfTestIRIGB ( HMXF_DEVICE  device,
uint64  signal,
uint64  level,
uint64  extLoopback,
uint64 *  result,
char *  info,
char *  diagnostic 
)
C#
public static extern UInt32 mxfSelfTestIRIGB(UInt64 device, UInt64 signal, UInt64 level, UInt64 extLoopback, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestIRIGB(UInt64 device, UInt64 signal, UInt64 level, UInt64 extLoopback, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a IRIG-B self-test on the specified device.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]signalSignal type to test:
Constant Description
MXF_SELFTEST_IRIGB_SIGNAL_AM AM signal
MXF_SELFTEST_IRIGB_SIGNAL_AM_1PPS AM-1PPS signal
MXF_SELFTEST_IRIGB_SIGNAL_DIGITAL DIGITAL signal
[in]levelTest level:
Constant Description
MXF_SELFTEST_LEVEL_QUICK Execute quick test.
[in]extLoopbackExternal loopback option:
Constant Description
VMXF_DISABLE Using the internal loopback (only available for digital signal)
VMXF_ENABLE Using the external loopback. IRIG-B signal must be physically connected to an IRIG-B source.
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestVOLTAGE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.

Variable Documentation

<!--uint32mxfSelfTestASCB(HMXF_DEVICEdevice,uint64port,uint64level,uint64extLoopback,uint64*result,char*info,char*diagnostic);--> uint32 mxfSelfTestVOLTAGE(HMXF_DEVICE device, uint64 zone, double *value, uint64 *result, char *info, char *diagnostic)
C#
public static extern UInt32 mxfSelfTestVOLTAGE(UInt64 device, UInt64 zone, out double value, out UInt64 result, StringBuilder info, StringBuilder diagnostic);

public static extern UInt32 mxfSelfTestVOLTAGE(UInt64 device, UInt64 zone, out double value, out UInt64 result, IntPtr info, IntPtr diagnostic);

Performs a Voltage self-test on the specified zone.

This function resets the device. Neither mxfSystemInit() nor mxfSystemResourcesInit() are required before this function call. After the call and reset are complete, MX Foundation Library must be reloaded using either mxfSystemInit() or mxfSystemResourcesInit(). All handles with the exception of Server and Device will be lost and must be obtained again.

Parameters
[in]deviceDevice handle
[in]zoneDevice zone number
Device Zone Description
FlexMulti 0 +3.3 V voltage
1 +12 V voltage
2 +5 V voltage
3 +3.3 V switchers voltage (FlexMulti 1553 and FlexMulti 629)
+2.5 V voltage (FlexMulti 664 and FlexMulti 429)
Flex1553-PCIe 0 +3.3 V voltage
1 +12 V voltage
FlexMobile 0 +12 V voltage
PMC/XMC 0 +3.3 V voltage
1 +12 V voltage
2 +5 V voltage
FlexMAX 0 +12 V voltage
1 +12 V modules voltage
[out]valueVoltage value (volts)
[out]resultResult of the test:
Constant Description
MXF_SELFTEST_PASS Test passed
MXF_SELFTEST_FAIL Test failed
[out]infoTest information string. Pass NULL to ignore this parameter.
[out]diagnosticTest diagnostic text string when the test has failed. Pass NULL to ignore this parameter.
Returns
MAXT_SUCCESS is returned when the function has succeeded. Refer to mxf_error.h for a list of defined errors.
Call mxfSystemErrorStringGet() to transform the return code into a text string.
Availability:
Available in MX Foundation 4.0 and later.
See also
mxfSelfTestMEMORY()
mxfSelfTestDISCRETE()
mxfSelfTestCURRENT()
mxfSelfTestTEMPERATURE()
mxfSelfTestRTCLK()
mxfSelfTestDEBUGCOMPORT()
mxfSelfTestETHERNET()
mxfSelfTestSYNCIO()
mxfSelfTestIRIGB()
mxfSelfTestNVSTORAGE()
Examples:
selfTests.c, and selfTests.cs.
Updated 03/30/2022