User manual

MAUI Oscilloscopes Remote Control and Automation Manual
ActiveDSO
ActiveDSO is a proprietary ActiveX™ control that enables Teledyne LeCroy oscilloscopes to be controlled
by and exchange data with a variety of Windows applications that support the ActiveX standard. Microsoft
Office suite, Internet Explorer, Visual Basic, Visual C++, and Visual Java are a few of the many applications
and languages that support ActiveX controls.
ActiveDSO hides the intricacies of programming in ActiveX and provides a simple and consistent interface
to the controlling application. The ActiveDSO control may be used as either:
l An "invisible" object accessed via a scripting language, for example, VBS.
l A visible object embedded in an OLE Automation compatible client, such as a VBA macro launched
by a Windows application button.
Note: Many of our Automation examples utilize Visual Basic Script (VBS), the "built in" Automation
language, as it is syntactically identical to our LeCroy Setup Script (.LSS). Do not confuse VBS with
Visual Basic for Applications (VBA), a subset of Visual Basic used extensively within Windows
applications, such as Excel, as a macro "programming" language. Some things that work in VBS do
not work in VBA.
A great benefit of ActiveDSO is that it is completely independent of the remote hardware interface. The
connection via ENET (TCP/IP), GPIB, or USBTMC is made by a single command near the start of a
program. It may be used to send Automation commands or legacy IEEE 488.2 remote control commands.
Download the ActiveDSO software free of charge from our website (see Resources) and install ActiveDSO
on the controller PC. The driver installs with the ActiveDSO Developer's Guide. This manual documents all
the methods and properties used to program ActiveDSO objects. Following are some simple examples.
More extensive examples are installed in the ActiveDSO program folder.
Instantiating the ActiveDSO Control
The control's external name is always: LeCroy.ActiveDSOCtrl.1
The control's CLSID is 450A9897-D9C9-11D1-9966-0000F840FC5E
Following are instantiations of the control as an "invisible" object used to pass remote commands in
several commonly used languages. In each case, the control is aliased as "dso", although for this you may
substitute whatever you wish.
Language
VBA
Dim
dso
As Object
Set
dso
= CreateObject("LeCroy.ActiveDSOCtrl.1")
Python
import win32com.client
dso
=win32com.client.Dispatch("LeCroy.ActiveDSOCtrl.1")
Visual C++
CActiveDSO
dso
;
RECT dummyRect;
dso
.Create("LeCroy.ActiveDSOCtrl.1","HiddenWindowForDSOControl",0,dummyRect,
this,0);
1-22