Kibrcv - Keithley S530 Manual

Section 3: LPTLib command reference

kibrcv

This command reads a device-dependent string from an instrument connected to the GPIB interface.
Usage
int kibrcv(int pri_addr, int sec_addr, char term, unsigned int timeout, unsigned int
rcv_size, unsigned int *rcv_len, char *rcv_buff);
pri_addr
sec_addr
term
timeout
rcv_size
rcv_len
rcv_buff
Details
The kibrcv command receives a buffer from the GPIB interface by doing the following:
1. Assert attention (ATN).
2. Send device LISTEN address.
3. Send device TALK address.
4. Send secondary address (if not -1).
5. De-assert ATN.
6. Read byte array from the device rcv_buff parameter until end-or-identify (EOI) or the delimiter
is received.
7. Assert ATN.
8. Send UNTalk (UNT).
9. Send UNListen (UNL).
10. De-assert ATN.
The rcv_size parameter defines the maximum number of bytes physically allowed in the buffer. If
the rcv_size parameter is greater than the byte string returned by the instrument, the device is
short-cycled and only the maximum number of bytes is returned.
Also see
None
3-38
S530/S540 KTE Linear Parametric Test Library (LPTLib) User's Manual
The primary address of the instrument (0 to 30; the controller uses address 31)
The secondary address of the instrument (1 to 30; if the instrument device does not
support secondary addressing, this parameter must be -1)
The ASCII delimiter character of the returned string; this is the byte used for
terminating data buffer reading
The GPIB timeout for the transfer in 100 ms units (for example,
timeout = 40 = 4.0 s)
The physical receive buffer size; this is the maximum number of bytes that can be
read from the device
The number of bytes that are read from the device on the GPIB interface; this
variable is returned by the tester after all bytes are read from the device
The physical byte buffer destined to receive the data from the device connected to
the GPIB interface
S530-900-01 Rev. E / September 2017