GtDio6xSetupInitialization

Applies To

GX5296, GX5961, GX5964

Purpose

Initializes the driver for the specified PXI slot using the HW device driver.

Syntax

GtDio6xSetupInitialization (nMaster, nBrdNum, wSlot, pnHandle, pnStatus)

Parameters

Name
Type
Comments
nMaster
SHORT
Specifies the Master number of the Slave board being initialized.
If the board is a Master board, then nMaster should be zero and nBrdNum will specify the master number.
nBrdNum
SHORT
Specifies the Master or Slave board number. Valid numbers are 1-16 for Master boards and greater than 0 for Slave.
wSlot
WORD
Board slot number.
pnHandle
PSHORT
Returns a handle for later reference with this board, 0 for error.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The Marvin Test Solutions HW device driver is installed with the driver and is the default device driver. The function returns a handle that for use with other DIO6X functions to program the board. The function does not change any of the board settings.

     The specified PXI slot number is displayed by the PXI/PCI Explorer applet that can be opened from the Windows Control Panel. You may also use the label on the chassis below the PXI slot where the board is installed. The function accepts two types of slot numbers: A combination of chassis number (chassis # x 256) with the chassis slot number. For example 0x105 (chassis 1 slot 5).

     Legacy nSlot as used by earlier versions of HW/VISA. The slot number contains no chassis number and can be changed using the PXI/PCI Explorer applet (1-255).

GtDio6xSetupInitialization must be called for each board (Master and Slave) in order to initialize all boards.

Each board that is initialized with this function is added to the specified domain. Boards that are added must be in contiguous slots.

When this function is called, the domain will be stopped and placed into a standby state. No other board settings are affected by this function.

Use the GtDio6xInitialize instead of calling GtDio6xSetupInitialization repeats for each domain members to initialize all DIO domain members using one command.

After initializing the last card in the domain, call GtDio6xCalibrateDomainTimingDeskew to calibrate the backplane timing signals.

Example

The following example demonstrates how to initialize a domain that includes a Master board in chassis 1 slot 6 and a slave at chassis 1 slot 7:

 

SHORT nMasterHandle1, nSlave1, nDensity, nBanks, nStatus;

DioSetupInitialization (0, 1, 0x106,&nMasterHandle1, &nStatus);

DioSetupInitialization (nMasterHandle1, 1, 0x107, &nSlave11, &nStatus);

 

See Also

GtDio6xInitialize, GtDio6xSetupInitializationVisa, GtDio6xGetSlaveHandle, GtDio6xGetBoardCount, GtDio6xCalibrateDomainChannelsDeskew,  GtDio6xGetErrorString