Opening An Instrument Session - Agilent Technologies 8163A Programming Manual

Opening an Instrument Session

Agilent 8163A/B, 8164A/B & 8166A/B Mainframes, Fifth Edition

Opening an Instrument Session

To control an instrument from a program, you must open a communication
path between the computer/controller and the instrument. This path is
known as an instrument session, and is opened with the function
hp816x
ViStatus _init( ViRsrc InstrDesc, ViBoolean id_query, ViBoolean reset,
ViPSession instrumentHandle );
Instruments are assigned a handle when the instrument session is
opened. The handle, which is a pointer to the instrument, is the first
parameter passed in all subsequent calls to driver functions.
The parameters of the function hp816x
• : the address of the instrument
ViRsrc InstrDesc
• : a Boolean flag which indicates if in-system verifica-
ViBoolean id_query
tion should be performed.
Passing (1) will perform an in-system verification; passing
VI_TRUE
(0) will not.
VI_FALSE
If you set to false, you can use the generic functions of the in-
id_query
strument driver with other instruments.
• : a Boolean flag which indicates if the instrument should
ViBoolean reset
be reset when it is opened.
Passing (1) will perform a reset when the session is opened;
VI_TRUE
passing (0) will not perform a reset,
VI_FALSE
•
ViPSession instrumentHandle
is the handle which addresses the instrument, and is
InstrumentHandle
the first parameter passed in all driver functions.
Successful completion of this function returns
The Agilent 816x VXIplug&play Instrument Driver
include:
_init
: a pointer to an instrument session.
VI_SUCCESS
227