Rohde & Schwarz Smart Instruments SM300 Operating instructions

W.Blanz 06/2007 – 1MA73_07E
Products: Rohde&Schwarz Smart Instruments™ Family300 (SM300, FS300, FS315, AM300, UP300/350)
Rohde&Schwarz
Smart Instruments™ Family300
Basic Programming Guide
Introduction to the fundamentals of programming the R&S Smart Instruments™ Family 300 in different
development environments.

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 2 Rohde & Schwarz
Table of Contents
1Introduction ............................................................................................. 3
2Basic Details about Smart Instruments™ ............................................... 3
3Installing Instrument Drivers ................................................................... 4
4Instrument Drivers................................................................................... 6
5Integrating Drivers into a Project............................................................. 6
6Using "FS300 Basic Measurement" for the First Time ......................... 15
7"Resource String" and "Virtual Instrument Name" ................................ 17
8Where to Find Help on the Driver Functions......................................... 19
9Which Data Type to Use ....................................................................... 19
10 References............................................................................................ 21
11 Appendix: Contact our hotline............................................................... 22
12 Keywords .............................................................................................. 23

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 3 Rohde & Schwarz
1Introduction
Rohde&Schwarz provides instrument drivers available for all Smart
Instruments™. These drivers allow you to access instruments from various
programming environments under Microsoft Windows XP/2000. The
"Smart Instruments™ Programming Guide" deals with programming the
Smart Instruments™ Family300 utilising these drivers from within different
programming languages (C/C++, Visual Basic, LabView,
LabWindows/CVI). Use of this facility requires some basic prior knowledge
of programming in the individual languages.
2Basic Details about Smart Instruments™
The Smart Instruments™ Family300 is operated by remote control via the
USB host port. This means that the operating system used for remote
control purposes must provide in-house USB support. The drivers
described below support the Microsoft Windows XP and Microsoft
Windows 2000 operating systems.
Each Family300 instrument consists of two USB instruments, namely a
measurement and/or generator module, and the system controller
associated with the instrument platform in the power supply. A dedicated
USB driver has to be installed in Windows for each of these USB
instruments. Windows either asks you to install the appropriate device
driver or continues automatically if a driver has already been installed for
these instruments. The USB drivers are automatically installed in the
Windows system when the instrument driver is installed (see 3 Installing
Instrument Drivers).
Figure 1: Configuration for Smart Instruments™ (SM300)

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 4 Rohde & Schwarz
3Installing Instrument Drivers
The instrument drivers can be obtained from the Rohde&Schwarz web site
(http://www.rohde-schwarz.de/drivers/overview.html). The site contains the
latest versions of the instrument drivers together with examples and
installations notes.
The following should be noted when installing and using the drivers: if a
VISA library has been installed on your PC, the instrument drivers are
embedded in its directory structure (e.g. C:\VXIPNP). If this is not the case,
the path to be used must be specified on installation and must also be set
in the development environments. The following document assumes that a
VISA library has been installed; this is a component of all National
Instruments development environments (e.g. LabWindows/CVI and
LabView) and of Agilent VEE.
The Rohde&Schwarz web site offers you a choice of three different drivers
for each instrument, but only two of the installation packages contain the
complete drivers for control.
VXI Plug&Play Instrument Driver:
This driver package installs the basic driver together with all the necessary
DLLs, LIBs and Include files, plus the Windows USB drivers, for operating
the instrument concerned by remote control.
LabView:
The driver package is configured in the same way as the VXIplug&play
instrument driver package, but in this case libraries for use within National
Instruments LabView are also included (see VXIplug&play Instrument
Driver).
LabWindows/CVI:
In contrast to the two packages mentioned above, this driver package
contains only the LabWindows/CVI function panel (fp) file, the C sources, a
ReadMe file and the Help files. However, to be able to use the instrument
driver, one of the two packages mentioned above must be installed first.

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 5 Rohde & Schwarz
Directory structure:
After the instrument drivers are installed directory structures can differ,
depending whether or not the VISA library is installed on your PC.
With VISA Without VISA (standard installation directory)
In an installation with the VISA library you find the same directories and
files in the sub-directory "WinNT" as you would find when VISA is not
installed.
The following list of directories and files refers to the FS300 spectrum
analyzer.
Directory Contents
\bin Instrument driver DLL (e.g. rssifs_32.dll)
\lib Library files (e.g. rssifs.lib)
\bc (Borland C)
\msc (Microfsoft C)
\include Header files
-rssitype.h (type declarations for the Smart
Instruments™ for C)
-SiControl.h (type declarations for the basic
driver for C (internal to the driver))
-rssifs.h (FS300 type and function
declarations for C)
-rssifs.bas (FS300 type and function
declarations for Visual Basic)
\Kbase Empty by default
\rssifs (in this case for the FS300)
-license.pdf (license notices)
-readme.txt (release notes)
-rssifs.c (instrument driver sources)
-rssifs.chm (HTML based Help)
-rssifs.def (export description)
-rssifs.fp (LabWindows/CVI front panel file)
-RSSIFS.HLP (Windows Help)

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 6 Rohde & Schwarz
-UnInst.isu (uninstall information)
\GWinNT LabView files
-rssifs.chm (HTML based Help)
-rssifs_xx.mnu (several LabView menu
files)
-rssifs.llb (LabView library)
4Instrument Drivers
The Smart Instruments™ Family300 has instrument drivers which can be
used within Windows in all programming languages that can access DLLs.
The instrument drivers consist of different DLLs which carry out various
control tasks. The USB driver rssifs.sys serves as an interface for Windows
USB driver support. The SiControl DLL enables instrument-specific driver
components to access measurement modules with the aid of a common
interface. The instrument driver DLLs rssixx_32.dll (where xx stands for the
particular instrument, e.g. rssifs_32.dll for the FS300 spectrum analyzer)
provide the programmer with instrument-specific functions. The following
sections cover these in particular.
5Integrating Drivers into a Project
The following section describes how to use instrument drivers in different
programming environments within Windows using an FS300 spectrum
analyzer as an example. Since development environments change in the
course of time, the integration sequence may also change with the advent
of a new version. The programming environment version is therefore
specified at the beginning of each section.
Visual C/C++
The following process refers to Microsoft Visual C++ 6.0.
To use the instrument driver in a Visual C++ project, you can proceed in
either of two ways:
oUse the LIB file as the interface for the DLL
oImport the DLL with the aid of LoadLibrary in runtime
The functions of the instrument driver are available to be called in either
method.
Using the LIB file
To use the LIB file as the interface for the DLL, the file must be integrated
into the project. Do this by following the menu sequence Project->Project

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 7 Rohde & Schwarz
Settings->Link "Object/Library Modules" and entering the desired LIB file,
e.g. rssifs.lib for the FS300 spectrum analyzer.
Figure 2: Adding the LIB file to the current project
The compiler must be notified of the path so that it can find the LIB file.
You therefore need to add a new search path for LIB files by using the
menu sequence Tools->Options..->Directory. As mentioned above (section
3Installing Instrument Drivers) the search path to the files can vary
according to the type of installation.
Figure 3: Adding the search path for LIB files
In order to declare the functions and data types of the instrument driver
within your project, you must integrate the C header files into your project
and define the Include path if this has not already been done. Do this by
proceeding as described in the case of the LIB file, but in this case choose
"Include files".

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 8 Rohde & Schwarz
Figure 4: Adding the search path for C header files
The general settings for your Visual C++ project have now been entered.
The header files must now be integrated into those of your modules which
are intended to call the driver functions. As usual in C and C++ this is done
by using #include.
In order to declare the functions and data types, the two header files rssixx.h
and rssitypes.h must be integrated (see also 9 Which Data Type to Use).
Example: #include <rssifs.h>
#include <rssitypes.h>
Importing the DLL in runtime
DLLs are integrated during the runtime of the program. Note that in this case
every function that is going to be used must be explicitly integrated, making
this a very time-consuming method. The next section shows in principle how
to do this, using the functions of rssifs_32.dll as an example.
The function rssifs_init is used to initialize an instrument. It is structured as
follows:
ViStatus _VI_FUNC rssifs_init (ViRsrc resourceName, ViBoolean IDQuery,
ViBoolean resetDevice,
ViPSession instrSession);
Information on data types can be found in file rssitypes.h.
Please note that the path to the header files must be specified in this case
also (see 3 Installing Instrument Drivers).

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 9 Rohde & Schwarz
Example:
#include <rssitype.h>
#include <rssifs.h>
typedef ViStatus (RSSIFSINIT)(ViRsrc , ViBoolean ,ViBoolean ,
ViPSession );
HINSTANCE hInstance;
RSSIFSINIT* pFunction;
/* variables for function call */
ViRsrc resourceName = "USB::0xAAD::0x6::100015";
ViBoolean IDQuery = TRUE;
ViBoolean resetDevice = TRUE;
ViPSession instrSession= 0;
ViStatus Result = 0;
int main(int argc, char*argv[]){
hInstance=::LoadLibrary("c:\\VXIPNP\\WinNT\\bin\\rssifs_32.dll");
pFunction =(RSSIFSINIT*)::GetProcAddress(hInstance, "rssifs_init");
/* function call */
Result=(*pFunction)( resourceName, IDQuery, resetDevice,
&instrSession);
return(0); }
Visual Basic
The following process refers to Microsoft Visual Basic 6.0.
Integrating the reference
To integrate the instrument drivers as reference in Visual Basic, carry out the
steps described below within your project. When you have created your new
project you can use the menu sequence Project->References... to integrate
the instrument drivers.

R&S Smart Instruments™ Family300 Basic Programming
Guide
1MA73 10 Rohde & Schwarz
Figure 5: Integrating the reference
Figure 6: Selecting the reference
If the instrument drivers are not listed, use the Browse button to search for
the DLL in the installation directory where the instrument driver is located
(e.g. c:\VXIPnP\WinNT\bin\).