Prober Driver Test Program

This section describes the prober test program testprob, which is provided with C source code. This program runs independently from IC-CAP and interactively calls driver functions to test an Agilent-supplied or a custom driver.

The file for this program is located in $ICCAP_ROOT/src and is called testprob.c. It includes the test program main. The Makefile offers an option to build this test program. This program is linked with prober.o, iceswn.o, icedil.o, a GPIB library to exercise both prober and switching matrix drivers. If testprob has been rebuilt with a custom driver, use an absolute path to specify the new testprob because $ICCAP_ROOT/bin has another, original testprob executable.

The testprob executable is an interactive program that gets user input from its stdin and calls an appropriate driver function, then prints out the return value(s) of the driver function to the Status window.

The run_testprob script properly sets your shared library lookup path and runs ./testprob if it exists, otherwise it runs $ICCAP_ROOT/bin/testprob. Therefore, you should use the run_testprob script to run testprob. Make sure $ICCAP_ROOT is properly set in your environment, then type run_testprob.

An actual prober (matrix) must be connected to a raw GPIB device file in order to perform driver (matrix) tests. Off-line testing is not available with this program.

This program expects to see a function name and its arguments as if they appeared in an IC-CAP Macro program. However an argument list cannot include another function, that is, nesting is not allowed.

A command example is:

 Prober_init(1, 0, "EG1034X", "hpib")

The currently supported functions are shown next.

Connect	Prober_debug
FNPort	Prober_init
Pdown	Prober_reset
Phome	Prober_status
Pimove	Pscale
Pink	Pup
Pmove	SWM_debug
Porig	SWM_init
Ppos	Wait

Because this test program is not a real Macro interpreter, it has the following restrictions:

Because nesting is not supported, the Connect function needs a port address such as 32701 instead of FNPort(1). Refer to the HP 4062UX Programming Reference for more information about port addresses.