R&S ZVB - Page 1155

R&S
®
ZVA / R&S
®
ZVB / R&S
®
ZVT Annexes
Interfaces and Connectors
Operating Manual 1145.1084.12 – 30 1140
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 is 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.
Overview of Interface Functions
The library functions are adapted to the interface functions of National Instruments for GPIB programming.
The functions supported by the libraries are listed in the following table.
Function
Description
RSDLLibfind()
Provides a handle for access to a device.
RSDLLibwrt()
Sends a zero-terminated string to a device.
RSDLLilwrt()
Sends a certain number of bytes to a device.
RSDLLibwrtf()
Sends the contents of a file to a device.
RSDLLibrd()
Reads data from a device into a string.
RSDLLilrd()
Reads a certain number of bytes from a device.
RSDLLibrdf()
Reads data from a device into a file.
RSDLLibtmo()
Sets timeout for RSIB functions
RSDLLibsre()
Switches a device into the local or remote state
RSDLLibloc()
Temporarily switches a device into the local state
RSDLLibeot()
Enables/disables the END message for write operations.
RSDLLibrsp()
Performs a serial poll and provides the status byte.
RSDLLibclr
Sends the command SDC (Device Clear) to the instrument.
RSDLLibonl()
Sets the device On/Offlline.
RSDLLTestSrq()
Checks whether a device has generated an SRQ.