Rohde & Schwarz 1065.6000.20, Operating Manual

Page: 405 / 438

Contents - Maintenance and Instrument Interfaces FSE
1065.6016.12 8.12 E-15
RSIB Interface Functions
This following sections describe all functions of libraries ’
RSIB.DLL’, ’RSIB32.DLL’
or
"librsib.so"
by means of which control applications can be written.
Variables ibsta, iberr, ibcntl
Same as with the National Instrument interface, successful execution of a command can be checked by
means of the variables
ibsta
,
iberr
and
ibcntl
. To this end, references to the three variables are
transferred to all RSIB functions. In addition, the status word
ibsta
is returned as a function value by all
functions.
Status word ibsta
All functions send back a status word that provides information on the status of the RSIB interface. The
following bits are defined:
Bit name Bit Hex code Description
ERR
15 8000 This bit is set if an error occurs during a function call. If this bit is set,
iberr
contains an error code which specifies the error.
TIMO
14 4000
This bit is set if a timeout occurs during a function call. A timeout may occur in
the following situations:
•
while waiting for an SRQ with the function
RSDLLWaitSrq()
.
•
if no acknowledgment is received for data sent to an instrument with
RSDLLibwrt()
or
RSDLLilwrt()
.
•
if no response from server to a data request with function
RSDLLibrd()
or
RSDLLilrd()
.
CMPL
8 0100
This bit is set if the reply of the IEC/IEEE-bus parser is completely read. If a
reply of the parser is read with the function
RSDLLilrd()
and the buffer
length is not sufficient, the bit is cleared.
Error variable iberr
If the ERR bit (8000h) is set in the status word,
iberr
contains an error code that specifies the error.
The RSIB has error codes of its own independent of the National Instrument interface.
Error Error code Description
IBERR_DEVICE_REGISTER 1 RSIB.DLL cannot register any new device.
IBERR_CONNECT 2 Link to the device has failed.
IBERR_NO_DEVICE
3 An interface function was called with an invalid device handle.
IBERR_MEM
4 No free memory available.
IBERR_TIMEOUT
5 Timeout has occurred.
IBERR_BUSY
6 The RSIB interface is blocked by a function not yet completed.
Windows is not blocked, for example, by function RSDLLibrd() if data are still
to be transmitted in response to this function. In this case a new call is
possible. Further calls are however rejected by RSIB.DLL with error code
IBERR_BUSY
.
IBERR_FILE 7 Error in reading from or writing to a file.
IBERR_SEMA 8 Error upon creating or assigning a semaphore (only under Unix)
Count variable - ibcntl
The variable ibcntl is updated with the number of bytes transmitted on every read and write function call.