Documentation Center

  • Trial Software
  • Product Updates

Working with the RSIB Interface

Understanding VISA-RSIB

RSIB Passport for VISA allows you to control and exchange data remotely with Rohde & Schwarz spectrum and network analyzers over a local area network. The RSIB interface is supported by National Instruments VISA only. It also requires the Rohde & Schwarz VISA passport. You can use MATLAB® and Rohde & Schwarz spectrum and network analyzers to perform complex data analysis on measured telecommunication signals and to verify simulated data against real measurement data.

Creating a VISA-RSIB Object

You create a VISA-RSIB object with the visa function. Each VISA-RSIB object is associated with an instrument connected to your computer.

visa requires the vendor name and the resource name as input arguments. The only supported vendor name is ni. The resource name consists of the IP address or host name of the instrument. You can find the VISA-RSIB resource name for a given instrument with the configuration tool provided by your vendor, or with the instrhwinfo function. (In place of the resource name, you can use an alias as defined with your VISA vendor configuration tool.) As described in Connecting to the Instrument, you can also configure properties during object creation.

Before you create a VISA object, you must find the instrument in the appropriate vendor VISA explorer. When you find the instrument configured, note the resource string and create the object using that information. For example, to create a VISA-RSIB object that uses National Instruments® VISA and associated with an instrument with IP address 192.168.1.33,

vr = visa('ni','RSIB::192.168.1.33::INSTR');

The VISA-RSIB object vr now exists in the MATLAB workspace.

To open a connection to the instrument, type:

fopen (vr);

You can display the class of vr with the whos command.

whos vr
  Name      Size         Bytes  Class

  vr        1x1            884  visa object

Grand total is 16 elements using 884 bytes

After you create the VISA-RSIB object, the properties listed below are automatically assigned values. These properties provide descriptive information about the object based on its class type and address information.

VISA-RSIB Descriptive Properties

Property Name

Description

Name

Specify a descriptive name for the VISA-RSIB object.

RsrcName

Indicate the resource name for a VISA instrument.

Type

Indicate the object type.

You can display the values of these properties for vr with the get function.

get(vr,{'Name','RsrcName','Type'})
ans = 
    'VISA-RSIB0-192.168.1.33'   'RSIB0::192.168.1.33::INSTR'
    'visa-RSIB'

VISA-RSIB Object Display

The VISA-RSIB object provides you with a convenient display that summarizes important address and state information. You can invoke the display summary these three ways:

  • Type the VISA-RSIB object at the command line.

  • Exclude the semicolon when creating a VISA-RSIB object.

  • Exclude the semicolon when configuring properties using the dot notation.

You can also display summary information via the Workspace browser by right-clicking an instrument object and selecting Display Summary from the context menu.

The display summary for the VISA-RSIB object vr is given below.

VISA-RSIB Object Using NI Adaptor : VISA-RSIB-192.168.1.33  

Communication Address
   RemoteHost:         192.168.1.33  

Communication State
   Status:             closed
   RecordStatus:       off  

Read/Write State
   TransferStatus:     idle
   BytesAvailable:     0
   ValuesReceived:     0
   ValuesSent:         0

VISA-RSIB Address

The VISA-RSIB address consists of

  • Remote host of the instrument

You specify the address property value via the resource name during VISA-RSIB object creation. The instrument address property is given below.

VISA-RSIB Address Property

Property Name

Description

RemoteHost

Specify the remote host name or IP address of the instrument

The property is automatically updated with the specified resource name value when you create the VISA-RSIB object.

With the get function, you can display the address property value for the VISA-RSIB object vr, created in Creating a VISA-RSIB Object.

fopen(vr)
get(vr,{'RemoteHost'})
ans = 
    [192.168.1.33]
Was this topic helpful?