Keithley 4200-SCS Reference Manual page 641

Model 4200-SCS Reference Manual
kibdefint Keithley GPIB define device initialize
Purpose
Format
Remarks
4200-901-01 Rev. S / May 2017
Defines a device-dependent command sent to an instrument connected to the GPIB
interface. This string is sent during any normal tester-based devint. It ensures that if
the tester is calling devint internally, any external GPIB device will now be initialized
along with the rest of the known instruments.
int kibdefint(int pri_addr, int sec_addr, unsigned int timeout,
double delay, unsigned int snd_size, char *snd_buff);
The primary address of the instrument; 1 through 30 is valid (the
pri_addr
GPIB uses address 31).
The secondary address of the instrument; 1 through 30 is valid. If
sec_addr
the instrument device does not support secondary addressing, this
parameter must be -1.
The GPIB transfer timeout. This timeout is in 100 ms units (for
timeout
example timeout = 40 = 4.0 s).
The time to wait after the device-dependent string is sent to the
delay
device, in seconds.
The number of bytes to send over the GPIB interface.
snd_size
The physical byte buffer containing the data to send over the bus.
snd_buff
This is the INITIALIZE string. A maximum of 1024 bytes is allowed.
Each call to kibdefclr and kibdefint copies parameters to a data structure within
tester memory. These data structures are allocated dynamically. After the execution of
the command buffer using execut, these tables are cleared, and any strings previously
defined MUST be redefined.
The tester system lets you define a maximum of 20 clear and 20 initialization strings.
Each string may contain up to a maximum of 1024 bytes. Once defined, these strings
remain in effect until the execut statement is executed.
Strings are sent over the GPIB in a first-in, first-out queue. This means that the first call
to kibdefclr or kibdefint will be the first string sent over the GPIB interface.
devclr (kibdefclr) strings are ALWAYS sent prior to initialization.
All kiblib devclr and devint strings are sent before devclr and devint
execution. This may be a problem when communicating with any Keithley-supported
GPIB instruments. This may also have an effect on bsweep, because bsweep issues a
devclr to clear ALL active sources. It is not recommended to use GPIB instruments
when performing bsweep tests.
Return to Section Topics
Section 8: Keithley User Library Tool (KULT)
8-125