Rohde & Schwarz 1145.1010.04/05/06, Operating Manual

Page: 785 / 813

R&S
®
ZVA/ZVB/ZVT Rear Panel Connectors
1145.1084.12 8.13 E-3
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.
RSDLLWaitSrq() Waits until a device generates an SRQ.
RSDLLSwapBytes Swaps the byte sequence for binary numeric display (only required for non-Intel platforms)
Description of Interface Functions
RSDLLibfind()
The function provides a handle for access to the device with the name
udName
.
VB format: Function RSDLLibfind (ByVal udName$, ibsta%, iberr%, ibcntl&) As Integer
C-format: short WINAPI RSDLLibfind( char far *udName, short far *ibsta, short far *iberr,
unsigned long far *ibcntl)
C format (Unix): short RSDLLibfind( char *udName, short *ibsta, short *iberr, unsigned long *ibcntl)
Parameter:
udName
IP address of device
Example: ud = RSDLLibfind ("89.10.38.97", ibsta, iberr, ibcntl)
The function must be called prior to all other functions of the interface.
As return value, the function provides a handle that must be indicated in all functions for access to the
device. If the device with the name
udName
is not found, the handle has a negative value.
RSDLLibwrt
This function sends data to the device with the handle
ud
.
VB format: Function RSDLLibwrt (ByVal ud%, ByVal Wrt$, ibsta%, iberr%, ibcntl&) As Integer
C format: short WINAPI RSDLLibwrt( short ud, char far *Wrt, short far *ibsta, short far *iberr,
unsigned long far *ibcntl )
C format (Unix): short RSDLLibwrt( short ud, char *Wrt, short *ibsta, short *iberr, unsigned long
*ibcntl )