Kibrcv - Keithley 4200A-SCS Reference Manual

Hide thumbs Also See for 4200A-SCS:

Table of Contents

Model 4200A-SCS Parameter Analyzer Reference Manual

kibrcv

This command reads a device-dependent string from an instrument connected to the GPIB interface.

int kibrcv(int pri_addr, int sec_addr, char term, unsigned int timeout, unsigned

int rcv_size, unsigned int *rcv_len, char *rcv_buff);

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.

4200A-901-01 Rev. C / February 2017

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

Section 13: LPT library function reference