User manual

Part 1: Making the Remote Connection
ActiveDSO Methods for Remote Control
Following are several ActiveDSO methods that are particularly useful for remote control. See the
ActiveDSO Developer's Guide for an explanation of all ActiveDSO methods.
MakeConnection
This method establishes the connection from controller to oscilloscope. It is a single line of code that
requires only that you pass the oscilloscope interface an address to which to connect.
The following table shows the MakeConnection string for each remote interface type.
Interface Syntax Example
TCP/IP
MakeConnection("IP:
<IP address>
") MakeConnection("IP: 172.25.9.22")
LXI
MakeConnection("VXI11:
<IP address>
") MakeConnection("VXI11: 172.25.9.22")
GPIB
MakeConnection("GPIB[
x
]:
<GPIB address>
")
x
:= 0 to 3 (optional)
MakeConnection("GPIB: 4")
USBTMC
MakeConnection("USBTMC: <VISA resource string>") MakeConnection("USBTMC:
USB0::0x05FF::0x1023::2807N59057::INSTR")
Note: When the VISA resource string is used with ActiveDSO for remote control, it is preceded by a
single colon space instead of the double colon used with a VISA driver.
Disconnect
The Disconnect method disconnects the control from the device. This method performs the necessary
termination functions, which will cleanup and disconnect the interface connection.
WriteString
The WriteString method sends a command string to the connected device with or without a terminating
EOI (End or Identify). It can be used with Automation or legacy remote commands.
WriteString follows the syntax:
<controlName>.WriteString("<textString>", <EOI Boolean>)
<controlName>:= name used to instantiate the ActiveDSO control
<textString>:= command string sent to the device
<EOI Boolean>:= {1, 0}
If EOI is set to 1 (TRUE), the command terminates with EOI, and the device interprets the command right
away. This is normally the desired behavior.
If EOI is set to 0 (FALSE), a command may be sent in several parts with the device starting to interpret the
command only when it receives the final part, which should have EOI set to TRUE.
1-23