User manual

MAUI Oscilloscopes Remote Control and Automation Manual
Result Variable Types
Type Definition
Integer 16-bit signed integer
Long 32-bit signed integer
Double 8-byte floating point type
String Array of characters
Object Object with its own interface
Variant Variable that is dimensioned without indicating a variable type
Exposing Waveforms
Waveform data is exposed as a simple array using app.Subsystem.Wfmn.Out.Result.Samples. Wfmn can
be any object defined within the XStreamDSO object hierarchy that produces a waveform trace (generally
Cn, Fn, Mn, SEn, and Zn).
The sample script D:\Scripts\Automation\ExampleWaveform.vbs gets the sample points in analog trace
C1 by accessing app.Acquisition.C1.Out.Result.Samples and dumps them into a text file.
Digital Waveforms
Digital waveforms are two-dimensional arrays, the DataArray being the samples and the TimeArray being
the time associated with the samples. As each digital bus may have up-to-18 lines (D0-D17), the DataArray
has at least two columns, being the Sample Number and the Digital Line from which it was taken.
Each sample has a time, but it is not easily calculated from the timebase, as with analog waveforms, as
the digital pulses on each line may have different widths. To accurately expose a digital waveform, you
must access both arrays and correlate the times with the samples from each line.
The sample script D:\Scripts\Automation\ExampleDigital.vbs gets the arrays in a digital trace that has
been stored in M1, determines the number of lines in the bus, correlates the times with the samples, and
dumps the results in a text file.
Tip: To see how this works, recall the Digital entry from
D:\Scripts\Automation\AutomationExamplesLabNotebook.lnb. This will copy a 3-line digital trace
into M1, which is accessed by the script.
Sequence Mode Waveforms
In MAUI firmware version 7.7.x.x and later, the segment index is supported as an argument to the
Out.Result property. For example, the following commands return results for segment 1 of the respective
waveform (which is a Sequence Mode acquisition):
set myResult = app.Acquisition.C1.Out.Result(1)
set myResult = app.Math.F1.Out.Result(1)
Zero (0) or no argument returns the result related to the last segment. A segment index greater than the
total number of segments also returns the result related to the last segment.
2-30