DioSetupInitialization

Applies To

GC5050, GX5050, GX5055, GX5150, GX5280, GX5290, GX5290e, GX5295

Purpose

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

Syntax

DioSetupInitialization (nMaster, nBrdNum, nBase, pnDensity, pnBanks, nHandle, pnStatus)

Parameters

Name	Type	Comments
nMaster	SHORT	Specifies the Master board’s handle of the Slave board being initialized. If the board is a Master board, then nMasterHandle should be zero.
nBrdNum	SHORT	Specifies the Master or Slave board number. Valid numbers are 1-16 for Master boards and 1-7 for Slave boards (representing I/O pins 32-256 for a domain).
nBase	SHORT	Base address for the board.
pnDensity	PSHORT	Memory module size densities
pnBanks	PSHORT	Number of memory modules installed
nHandle	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

All PXI/PCI cards:

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 Counter 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).

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

GC5050/GX5050/GX5150:

● Calling this function will not change the current configuration of the board and will set the board to the HALT mode.

● The memory module densities and the number of memory modules installed are read from the board.

● Density values are read back from the board and can be as follow:

0. 256K by 32-bit

1. 1M by 32-bit

2. 2M by 32-bit

3. 4M by 32-bit

● The number of Banks is read back from the board can be 1 to 8.

GX5055:

● Calling this function will not change the current configuration of the board and will set the board to the HALT mode.

● The memory module densities and the number of memory modules installed are read from the board.

● Density values are read back from the board and can be as follow:

0 512 by 32-bit

GX5280/GX5290/GX5290e/GX5295:

● Calling this function will not change the current configuration of the board and will set the board to the HALT mode.

● The memory module densities and the number of memory modules installed are read from the board.

● Density values are read back from the board and can be as follow:

0 32M by 32-bit

1 64M by 32-bit

2 128M by 32-bit

Example

The following example demonstrates how to initialize a system that 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, &nDensity, &nBanks, &nMasterHandle1, &nStatus);

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