Specifications

Customizing the System 59Chapter 3
Instrument Handlers
Instrument Handlers are a layer of software between Agilent TestExec SL
and standard instrument drivers (see Figure 3-2). In general, Instrument
Handlers are designed to be called from C/C++ code action
Instrument handlers contain functions written in C code that are organized
by instrument type and function, and require parameters relevant to the
function. For example, the call to set up triggering for a voltmeter is:
dmmConfTrigIn (dmm, trigselect, count, delay);
Function dmmConfTrigIn accepts four parameters: dmm, trigselect, count,
and delay. The generic name of the function is
ConfTrigIn, and the name
of the instrument, in this case
dmm, is added as a prefix to form the full,
specific name of the function.
Note Instrument handlers are maintained constant in different TS-5400 software
releases, which is not the case with the drivers. Thus, use instrument
handlers for actions whenever possible.
Standard Functions
in Instrument
Handlers
The names of the standard functions used in instrument handlers appear
below. Note that not all handler routines will have all of these routines.
Figure 3-2. Software Layers
User Actions
Instrument Handler
Driver
List of Immediate execution functions (input/output to device when
executed)
Get<xxx> ‘Get’ prefix is used for any routine that returns
data of any kind.
GetResults Returns results of a reading, optionally
triggering it first.
Set Outputs current config to device.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com