Gx6192/Gx6256/Gx6864BITRun

Purpose

Starts BIT test

Syntax

Gx6256BITRun (nHandle, nMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX6256/GX6864/GX6192 board.
nMode
SHORT
Selects which BIT test
1.      GX6256_BIT_MODE_MUX: Test Mux relays only
2.      GX6256_BIT_MODE_MATRIX: Test Matrix relays only
4.      GX6256_BIT_MODE_RTM: Test Rear Transition Module relays only (if one is connected)
8.      GX6256_BIT_MODE_SR: Test Switching Router relays only (if one is connected)
15.   GX6256_BIT_MODE_DEFAULT: Tests Mux, Matrix, RTM and SR relays.
16.   GX6256_BIT_MODE_COIL: Measures relay coil values to attempt to identify marginal relays.
31.  GX6256_BIT_MODE_DIAGNOSTICS: Performs all tests available.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The built-in test checks each relay in a specified device for continuity. When this function is called, the BIT runs asynchronously in the background. The status and progress of the BIT can be checked by calling Gx6256BITGetStatus.

Example

The following example runs the built-in test and checks the status until the test has completed:

 

BOOL       bPass;

CHAR   szBITResult[1024];

DOUBLE dPercentCompleted;

 

Gx6256BITRun (nHandle, GX6256_BIT_MODE_ALL, &nStatus);

Gx6256BITGetStatus (nHandle, &bPass, szBITResult, 1024, &dPercentCompleted, &nStatus);

while (dPercentCompleted<100)

{

    printf("BIT Percent Completed = %f %", dPercentCompleted);

    Gx6256BITGetStatus (nHandle, &bPass, szBITResult, 1024, &dPercentCompleted, &nStatus);

}

 

See Also

Gx6192/Gx6256/Gx6864BITGetStatus, Gx6192/Gx6256/Gx6864BITRun, GxSWGetErrorString