CalRefInitialize

Purpose

Initializes the driver for the board at the specified address, which includes support for VISA resource. The function returns a handle that can be used with other CALREF functions to program the Power Supply.

Syntax

CalRefInitialize (sAddress, phHandle, plStatus)

Parameters

Name
Type
Comments
sAddress
STR
Address of Reference.
phHandle
PLONG
Returned handle for Matrix access.
plStatus
PLONG
Returned status: 0 on success, negative number on failure.

Comments

The function verifies and establishes communication with the instrument at the specified address information. The address information can be PXI, GPIB, USB, WinSock or VISA resource string. This address string format is starting by the address type followed by a column and the address:  PXI | GPIB | WinSock | USB | Com | VISA : Address . The specifics of the Address string characteristics can be found in Writing a Standard Driver topic in step 5. The function does not change any of the board settings.

The returned handle phHandle is used to identify the specified instrument with other driver functions.

Example

The following example initializes a Reference at GPIB board 1address 15 and VISA resource USB0::1234::5678:

 

LONG   lHandle1, lHandle2, lStatus;

 

CalRefInitialize (“GPIB:1:15”, &lHandle1 &lStatus);

CalRefInitialize (“VISA:USB0::1234::5678”, &lHandle1 &lStatus);

 

See Also

CalRefReset, CalRefGetError