Agilent U2701A/U2702A
USB Modular
Oscilloscopes
IVI-COM Programmer’s
Reference for Agilent VEE
Agilent Technologies
Notices
CAUTION
WARNING
© Agilent Technologies, Inc., 2009
No p art o f this manu al may be re produce d in
any form or by any means (including electronic storage and retrieval or translation
into a foreign language) without prior agreement and written consent from Agilent
Technologies, Inc. as governed by United
States and international copyright laws.
Manual Part Number
U2702-90039
Edition
First Edition, March 22, 2009
Agilent Technologies, Inc.
5301 Stevens Creek Blvd.
Santa Clara, CA 95052 USA
Warranty
The material contained in this document is provided “as is,” and is subject to being changed, without notice,
in future editions. Further, to the maximum extent permitted by applicable
law, Agilent disclaims all warranties,
either express or implied, with regard
to this manual and any information
contained herein, including but not
limited to the implied warranties of
merchantability and fitness for a particular purpose. Agilent shall not be
liable for errors or for incidental or
consequential damages in connection with the furnishing, use, or performance of this document or of any
information contained herein. Should
Agilent and the user have a separate
written agreement with warranty
terms covering the material in this
document that conflict with these
terms, the warranty terms in the separate agreement shall control.
Technology Licenses
The hardware and or software described in
this document are furnished under a license
and may be used or copied only in accordance with the terms of such license.
Restricted Rights Legend
U.S. Government Restricted Rights. Software and technical data rights granted to
the federal government include only those
rights customarily provided to end user customers. Agilent provides this customary
commercial license in Software and technical data pursuant to FAR 12.211 (Technical
Data) and 12.212 (Computer Software) and,
for the Department of Defense, DFARS
252.227-7015 (Technical Data - Commercial
Items) and DFARS 227.7202-3 (Rights in
Commercial Computer Software or Computer Software Documentation).
Safety Notices
A CAUTION notice denotes a hazard. It calls attention to an operating procedure, practice, or the like
that, if not correctly performed or
adhered to, could result in damage
to the product or loss of important
data. Do not proceed beyond a
CAUTION notice until the indicated
conditions are fully understood and
met.
A WARNING notice denotes a
hazard. It calls attention to an
operating procedure, practice, or
the like that, if not correctly performed or adhered to, could result
in personal injury or death. Do not
proceed beyond a WARNING
notice until the indicated conditions are fully understood and
met.
II U2701A/U2702A IVI-COM Programmer’s Reference
Contents
1 Introduction to IVI-COM
Getting Started 2
Installation Guide 3
General Guidelines for Oscilloscope Programming 5
Side-by-Side SCPI and IVI-COM Comparison of the U2701A/U2702A
Commands 6
2 Configuration
Count 12
Item 13
BandwidthLimit 13
Configure 15
Coupling 18
Enabled 20
Offset 22
ProbeAttenuation 24
Range 26
Name 29
Close 31
Initialize 32
Initialized 34
Configure 35
Coupling 37
Edge 39
Configure 39
Slope 41
U2701A/U2702A IVI-COM Programmer’s Reference III
Glitch 43
Condition 43
Configure 45
Polarity 47
Width 49
Holdoff 50
Modifier 51
Level 53
Source 54
Status 55
TV 56
Configure 56
Event 59
LineNumber 61
SignalFormat 62
Type 64
Width 66
Condition 66
Configure 68
Polarity 71
ThresholdHigh 73
ThresholdLow 74
Clear 75
ConfigureServiceRequest 76
Preset 78
Register 79
SerialPoll 81
TimeoutMilliseconds 82
IV U2701A/U2702A IVI-COM Programmer’s Reference
WaitForOperationComplete 84
Disable 85
ErrorQuery 86
LockObject 88
Reset 89
ResetWithDefaults 90
SelfTest 91
UnlockObject 93
Enumeration Members 94
AgilentU2701AGlitchConditionEnum 94
AgilentU2701AGlitchPolarityEnum 95
AgilentU2701ASRQReasonEnum 95
AgilentU2701AStatusRegisterEnum 97
AgilentU2701AStatusSubRegisterEnum 98
AgilentU2701ATriggerCouplingEnum 99
AgilentU2701ATriggerModifierEnum 99
AgilentU2701ATriggerSlopeEnum 100
AgilentU2701ATriggerTypeEnum 101
AgilentU2701ATVSignalFormatEnum 102
AgilentU2701ATVTriggerEventEnum 103
AgilentU2701AVerticalCouplingEnum 104
AgilentU2701AWidthConditionEnum 105
AgilentU2701AWidthPolarityEnum 105
3 Acquisition
ConfigureRecord 108
Interpolation 110
NumberOfAverages 112
RecordLength 113
U2701A/U2702A IVI-COM Programmer’s Reference V
SampleMode 114
SampleRate 116
StartTime 117
TimePerRecord 119
Type 122
Enumeration Members 124
AgilentU2701AAcquisitionStatusEnum 124
AgilentU2701AAcquisitionTypeEnum 125
AgilentU2701AInterpolationEnum 126
AgilentU2701ASampleModeEnum 126
4 Waveform Display
Abort 128
AutoSetup 129
Count 130
Initiate 131
IsWaveformElementInvalid 132
Item 134
FetchWaveform 134
ReadWaveform 136
5 Post Analysis
Abort 140
AutoSetup 141
Count 142
Initiate 143
IsWaveformElementInvalid 144
VI U2701A/U2702A IVI-COM Programmer’s Reference
Item 146
FetchWaveform 146
FetchWaveformMeasurement 148
ReadWaveform 150
ReadWaveformMeasurement 152
MathFunction 154
Name 156
Status 157
Enumeration Members 159
AgilentU2701AMathOperationEnum 159
AgilentU2701AMeasurementEnum 160
AgilentU2701ATimeOutEnum 163
6Others
Calibrate 166
Date 167
Label 168
Time 169
Cache 170
ClearInterchangeWarnings 171
DriverSetup 172
GetNextCoercionRecord 173
GetNextInterchangeWarning 174
InterchangeCheck 175
InvalidateAllAttributes 176
IoResourceDescriptor 177
LogicalName 178
U2701A/U2702A IVI-COM Programmer’s Reference VII
QueryInstrumentStatus 179
RangeCheck 180
RecordCoercions 181
ResetInterchangeCheck 182
Simulate 183
Description 184
GroupCapabilities 185
Identifier 186
InstrumentFirmwareRevision 187
InstrumentManufacturer 188
InstrumentModel 189
Revision 190
SpecificationMajorVersion 191
SpecificationMinorVersion 192
SupportedInstrumentModels 193
Vendor 194
SerialNumber 195
7 Application Example
Introduction 198
Creating connectivity to the IVI-COM driver 198
Complete Example 207
VIII U2701A/U2702A IVI-COM Programmer’s Reference
U2701A/U2702A USB Modular Oscilloscope
IVI-COM Programmer’s Reference for Agilent VEE
1 Introduction to IVI-COM
Getting Started 2
Installation Guide 3
General Guidelines for Oscilloscope Programming 5
Side-by-Side SCPI and IVI-COM Comparison of the U2701A/U2702A
Commands 6
This chapter introduces the remote programming basics of the
U2701A/U2702A USB modular oscilloscopes. The IVI- COM programming
commands provide the means to control this instrument remotely via
a PC.
Agilent Technologies
1
1 Introduction to IVI-COM
Getting Started
The IVI Foundation is an open consortium founded in year 1998 to
promote specifications for programming test instruments.
For complete information on the IVI Foundation and for the most
up- to- date versions of all IVI specifications and components, you can visit
the IVI Foundation web site at www.ivifoundation.org.
2 U2701A/U2702A IVI-COM Programmer’s Reference
Installation Guide
1 To download the AgilentU2701A IVI Driver, go to the Agilent Technical
Support web site at:
http://www.home.agilent.com/agilent/techSupport.jspx?pid=1369621&cc=
US&lc=eng&t=80029.k.0&guid=181735
2 Click Drivers & Software > IVI-COM and IVI-C for U2701A/U2702A to download
the AgilentU2701A IVI Driver package.
3 Save the file to any location on your hard disk.
4 Disconnect any instrument that is connected to your PC and close all
other applications on your PC.
5 Double- click the saved installation file to begin installation.
6 The latest version of the IVI Shared Components should be downloaded
from www.ivifoundation.org prior to installing the AgilentU2701A IVI
Driver package. It is recommended that you periodically check for
newer versions of the IVI Shared Components and update as available
from the IVI Foundation.
7 If the latest version of the IVI Shared Components is detected,
installation of the AgilentU2701A IVI Driver will proceed as normal.
Introduction to IVI-COM 1
U2701A/U2702A IVI-COM Programmer’s Reference 3
1 Introduction to IVI-COM
8 The AgilentU2701A IVI Driver 1.0.0.0 Setup Wizard dialog will appear. Click
Next to begin.
9 Read the License Agreement and select I accept the terms in the License
Agreement to proceed. You may click Print to print a hardcopy of the
Agilent License Terms for your reference. Click Next to proceed.
10 Fill in the Customer Information Form accordingly, and click Next.
11 Select the Ty p i c a l or Full option in the Setup Type to install the
AgilentU2701A IVI Driver package. Advanced users may select the
Custom option to customize the program features to be installed and
where they will be installed. Click Next to proceed.
12 Click Next to install to the specified folder or click Change to install to
a different folder.
13 Click Install to begin the installation of the AgilentU2701A IVI Driver
package.
14 Click Finish when the installation has completed.
4 U2701A/U2702A IVI-COM Programmer’s Reference
Introduction to IVI-COM 1
Configuration
Acquisition
Waveform Display
Post Analysis
START
END
You can use the commands in this section to
configure the oscilloscope channels for waveform
acquisition, set the type of event that triggers the
oscilloscope, modify the registry status, and
perform various utility operations.
You can use the commands in this section to
configure the acquisition type, the size of the
waveform record, the length of time that
corresponds to overall waveform record, and the
position of the first point in the waveform record
relative to the trigger event.
The statements in this section is used to acquire
waveform data from the oscilloscope. You can use
the commands in this section to initiate, acquire,
and abort measurements.
The statements in this section is used to analyze
the waveform data acquired from the oscilloscope.
You can also use the commands in this section to
initiate, acquire, and abort measurements.
General Guidelines for Oscilloscope Programming
The block diagram below illustrates the general flow of steps required to
program an oscilloscope. The necessary IVI- COM driver commands are
arranged to reflect this block diagram.
U2701A/U2702A IVI-COM Programmer’s Reference 5
1 Introduction to IVI-COM
Side-by-Side SCPI and IVI-COM Comparison of the
U2701A/U2702A Commands
Tab l e 1 - 1 SCPI, IAgilentU2701A IVI, and IIviScope command comparison
SCPI command IAgilentU2701A IVI command IIviScope command
IEEE 488.2 Common commands
*CLS IAgilentU2701AStatus.Clear -
*IDN IIviDriver.Identity IIviDriver.Identity
*OPC? IAgilentU2701ASystem.WaitForOperation
Complete()
*RST IIviDriverUtility.Reset() IIviDriverUtility.Reset()
Root level commands
AUTO IAgilentU2701AMeasurements.AutoSetup IIviScopeMeasurements.AutoSetup
ACQuire commands
AVERages IAgilentU2701AAcquisition.NumberOf
Averages
MODE IAgilentU2701AAcquisition.SampleMode IIviScopeAcquisition.SampleMode
SRATe? IAgilentU2701AAcquisition.SampleRate IIviScopeAcquisition.SampleRate
TYPE IAgilentU2701AAcquisition.Type IIviScopeAcquisition.Type
CHANnel<n> commands
BWLimit IAgilentU2701AChannel.BandwidthLimit -
COUPling IAgilentU2701AChannel.Coupling IIviScopeChannel.Coupling
DISPlay IAgilentU2701AChannel.Enabled IIviScopeChannel.Enabled
INVert - -
OFFSet IAgilentU2701AChannel.Offset IIviScopeChannel.Offset
-
IIviScopeAcquisition.NumberOfAverages
PROBe IAgilentU2701AChannel.ProbeAttenuation IIviScopeChannel.ProbeAttenuation
SCALe IAgilentU2701AChannel.Range IIviScopeChannel.Range
6 U2701A/U2702A IVI-COM Programmer’s Reference
Introduction to IVI-COM 1
Tab l e 1 - 1 SCPI, IAgilentU2701A IVI, and IIviScope command comparison
SCPI command IAgilentU2701A IVI command IIviScope command
KEY commands
AUTO_SCALE IAgilentU2701AMeasurements.AutoSetup IIviScopeMeasurements.AutoSetup
CH1 IAgilentU2701AChannel.Enabled IIviScopeChannel.Enabled
CH1_POS_DEC IAgilentU2701AChannel.Offset IIviScopeChannel.Offset
CH1_POS_INC IAgilentU2701AChannel.Offset IIviScopeChannel.Offset
CH1_SCALE_DEC IAgilentU2701AChannel.Range IIviScopeChannel.Range
CH1_SCALE_INC IAgilentU2701AChannel.Range IIviScopeChannel.Range
CH2 IAgilentU2701AChannel.Enabled IIviScopeChannel.Enabled
CH2_POS_DEC IAgilentU2701AChannel.Offset IIviScopeChannel.Offset
CH2_POS_INC IAgilentU2701AChannel.Offset IIviScopeChannel.Offset
CH2_SCALE_DEC IAgilentU2701AChannel.Range IIviScopeChannel.Range
CH2_SCALE_INC IAgilentU2701AChannel.Range IIviScopeChannel.Range
MAIN_DELAYED IAgilentU2701AAcquisition.StartTime IIviScopeAcquisition.StartTime
MATH IAgilentU2701AMeasurementsMathFunction -
MEASURE IAgilentU2701AMeasurement IIviScope.Measurement
MODE_COUPLING IAgilentU2701AChannel.Coupling IIviScopeChannel.Coupling
SINGLE IAgilentU2701AMeasurements.Initiate IIviScopeMeasurements.Initiate
TIME_POS_DEC IAgilentU2701AAcquisition.StartTime IIviScopeAcquisition.StartTime
TIME_POS_INC IAgilentU2701AAcquisition.StartTime IIviScopeAcquisition.StartTime
TIME_SCALE_DEC IAgilentU2701AAcquisition.TimePerRecord IIviScopeAcquisition.TimePerRecord
TIME_SCALE_INC IAgilentU2701AAcquisition.TimePerRecord IIviScopeAcquisition.TimePerRecord
TRIG_LVL_DEC IAgilentU2701ATrigger.Level Property IIviScopeTrigger.Level
TRIG_LVL_INC IAgilentU2701ATrigger.Level Property IIviScopeTrigger.Level
U2701A/U2702A IVI-COM Programmer’s Reference 7
1 Introduction to IVI-COM
Tab l e 1 - 1 SCPI, IAgilentU2701A IVI, and IIviScope command comparison
SCPI command IAgilentU2701A IVI command IIviScope command
MEASure commands
FALLtime AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
FREQuency AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
NDUTycycle AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
NWIDth AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
OVERshoot AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
PDUTycycle AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
PERiod AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
PREShoot AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
PWIDth AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
RISetime AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VAMPlitude AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VAVerage AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VBASe AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VMAX AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VMIN AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
8 U2701A/U2702A IVI-COM Programmer’s Reference
Introduction to IVI-COM 1
Tab l e 1 - 1 SCPI, IAgilentU2701A IVI, and IIviScope command comparison
SCPI command IAgilentU2701A IVI command IIviScope command
MEASure commands
VPP AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VRMS AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
VTOP AgilentU2701AMeasurementEnum Enumeration IviScopeMeasurementEnum Enumeration
TIMebase commands
DELayed IAgilentU2701AAcquisition.StartTime IIviScopeAcquisition.StartTime
HOLDoff IAgilentU2701ATrigger.Holdoff IIviScopeTrigger.Holdoff
POSition IAgilentU2701AAcquisition.StartTime IIviScopeAcquisition.StartTime
SCALe IAgilentU2701AAcquisition.TimePerRecord IIviScopeAcquisition.TimePerRecord
TRIGger commands
[EDGE]:COUPling IAgilentU2701ATrigger.Coupling Property IIviScopeChannel.Coupling
[EDGE]:LEVel IAgilentU2701ATrigger.Level Property IIviScopeTrigger.Level
[EDGE]:SLOPe IAgilentU2701ATriggerEdge.Slope Property IIviScopeTriggerEdge.Slope
[EDGE]:SOURe IAgilentU2701ATrigger.Source Property IIviScopeTrigger.Source
[EDGE]:SWEep IAgilentU2701ATrigger.Modifier Property IIviScopeTrigger.Modifier
MODE IAgilentU2701ATrigger.Type Property IIviScopeTrigger.Type
PULSe:MODE AgilentU2701ATriggerTypeEnum Enumeration IIviScopeTriggerTypeEnum Enumeration
PULSEe:WIDTh AgilentU2701ATriggerTypeEnum Enumeration IIviScopeTriggerTypeEnum Enumeration
STATus IAgilentU2701ATrigger.Status -
WAVeform commands
DATA? IAgilentU2701AMeasurement.ReadWaveform IIviScopeMeasurement.ReadWaveform
XINCrement? IAgilentU2701AMeasurement.ReadWaveform IIviScopeMeasurement.ReadWaveform
XORigin? IAgilentU2701AMeasurement.ReadWaveform IIviScopeMeasurement.ReadWaveform
U2701A/U2702A IVI-COM Programmer’s Reference 9
1 Introduction to IVI-COM
10 U2701A/U2702A IVI-COM Programmer’s Reference
U2701A/U2702A USB Modular Oscilloscope
IVI-COM Programmer’s Reference for Agilent VEE
2 Configuration
Channels Interface commands starting on page 12
Close 31
Initialize 32
Initialized 34
Trigger Interface commands starting on page 37
Status Interface commands starting on page 75
System Interface commands starting on page 82
Utility Interface commands starting on page 85
Enumeration Members 94
This chapter describes the configuration commands used to program the
U2701A/U2702A USB modular oscilloscopes over the remote interface. You
can use the commands in this chapter to configure the oscilloscope
channels for waveform acquisition, set the type of event that triggers the
oscilloscope, modify the registry status, and perform various utility
operations.
Agilent Technologies
11
2 Configuration
Count
Ty p e
Property
Function
Get
Description
This command returns the number of channels available.
Hierarchy
IAgilentU2701A
;
Channels
;
Count
Parameters
Long/Int32
Example
12 U2701A/U2702A IVI-COM Programmer’s Reference
Item
Configuration 2
This is an interface reference pointer to the IAgilentU2701AChannel
interface which is selected by the channel name.
BandwidthLimit
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the bandwidth limit status for the selected
channel. If
If
False, the bandwidth limit for the selected channel is disabled.
True, the bandwidth limit for the selected channel is enabled.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
BandwidthLimit
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
U2701A/U2702A IVI-COM Programmer’s Reference 13
2 Configuration
Return Format
Boolean
Example
14 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Configure
Ty p e
Method
Function
Set
Description
This command configures the most commonly used properties of the
oscilloscope channel sub- system. Use this command to enable or disable
the channel and to set the range, offset, coupling, and probe attenuation
values.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
Configure(Range, Offset, Coupling, ProbeAttenuation,
Enabled)
U2701A/U2702A IVI-COM Programmer’s Reference 15
2 Configuration
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
Range Double Specifies the vertical range. This value sets the Vertical
Range property.
Offset Double Specifies the vertical offset. This value sets the Vertical
Offset property.
Coupling AgilentU2701A
VerticalCoupling
Enum
ProbeAttenuation Double Specifies the probe attenuation. This value sets the
Enabled Boolean Specifies if the channel is enabled for acquisition. This
Specifies how to couple the input signal. This value sets
the Vertical Coupling property.
ProbeAttenuation property.
value sets the Channels.Enabled property.
Return Format
Boolean
16 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 17
2 Configuration
Coupling
Ty p e
Property
Function
Get and Set
Description
This command returns/sets how the oscilloscope couples the input signal.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
Coupling
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
Return Format
Item Type Description
AgilentU2701A
VerticalCoupling
Enum
18 U2701A/U2702A IVI-COM Programmer’s Reference
Enum See “AgilentU2701AVerticalCouplingEnum” on page 104.
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 19
2 Configuration
Enabled
Ty p e
Property
Function
Get and Set
Description
If this command is set to True, the oscilloscope acquires a waveform for
this channel when the IAgilentU2701AMeasurement.Initiate,
IAgilentU2701AMeasurement.ReadWaveform,
IAgilentU2701AMeasurement.ReadWaveformMeasurement, or
IIviScopeMeasurement.ReadWaveformMinMax methods are called.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
Enabled
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
Return Format
Boolean
20 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 21
2 Configuration
Offset
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the location of the center of the range that
was specified with the Range property. The units are expressed in volts,
with respect to ground. For example, to acquire a sine wave spanning
from 0.0 V to 10.0 V, set Offset to 5.0 V.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
Offset
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
Return Format
Double
22 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 23
2 Configuration
ProbeAttenuation
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the scaling factor by which the probe
attenuates the input signal. For example, with a 10:1 probe, the value is
10.0.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
ProbeAttenuation
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
Return Format
Double
24 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 25
2 Configuration
Range
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the absolute value of the input range that the
oscilloscope can acquire for the channel. The units are expressed in volts.
For example, to acquire a sine wave spanning from –5.0 V to 5.0 V, set
Range to 10.0 V.
Hierarchy
IAgilentU2701A
;
Channels
;
Item(Name)
;
Range
Parameters
Item Type Description
Name String The name of a channel. It may be either a name returned
by the Name property or a name mapped to a particular
repeated capability in the session in the configuration
store.
26 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Remarks
The absolute value of the input range that the oscilloscope can acquire is
equivalent to the Volt/Div value multiplied by eight at the scope setting.
Volt/Div (Attenuation = 1x) Voltage range
2 mV 16 mV
5 mV 40 mV
10 mV 80 mV
20 mV 160 mV
50 mV 400 mV
100 mV 800 mV
200 mV 1.6 V
500 mV 4 V
1 V 8 V
2 V 16 V
5 V 40 V
Return Format
Double
U2701A/U2702A IVI-COM Programmer’s Reference 27
2 Configuration
Example
28 U2701A/U2702A IVI-COM Programmer’s Reference
Name
Ty p e
Property
Function
Get
Description
This command returns the channel name for a given index.
Hierarchy
IAgilentU2701A
;
Channels
;
Name(Index)
Parameters
Configuration 2
Item Type Description
Index Long/Int32 One based index into the collection of channels.
Return Format
String
U2701A/U2702A IVI-COM Programmer’s Reference 29
2 Configuration
Example
30 U2701A/U2702A IVI-COM Programmer’s Reference
Close
Configuration 2
Ty p e
Method
Function
Set
Description
This command closes the I/O session to the instrument. Driver methods
and properties that access the instrument are not accessible after Close is
called.
Hierarchy
IAgilentU2701A
;
Close()
Example
U2701A/U2702A IVI-COM Programmer’s Reference 31
2 Configuration
Initialize
Ty p e
Method
Function
Set
Description
This command opens the I/O session to the instrument. Driver methods
and properties that access the instrument are only accessible after
Initialize is called. Initialize optionally performs a Reset and queries the
instrument to validate the instrument model.
Hierarchy
IAgilentU2701A
;
Initialize(ResourceName, IdQuery, Reset, OptionString)
32 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Parameters
Item Type Description
ResourceName String/BSTR An IVI logical name or an instrument specific string that
identifies the address of the instrument, such as a VISA
resource descriptor string.
IdQuery Boolean Specifies whether to verify the ID of the instrument.
Reset Boolean Specifies whether to reset the instrument.
OptionString String/BSTR The user can use the OptionString parameter to specify
the initial values of certain IVI inherent attributes for the
session.
The format of an assignment in the OptionString
parameter is “Name=Value”, where Name is one of:
RangeCheck, QueryInstrumentStatus, Cache, Simulate,
RecordCoercions, InterchangeCheck, or DriverSetup.
Value is either True or False except for DriverSetup. If the
OptionString parameter contains an assignment for the
Driver Setup attribute, the Initialize function assumes that
everything following “DriverSetup=” is part of the
assignment.
Example
U2701A/U2702A IVI-COM Programmer’s Reference 33
2 Configuration
Initialized
Ty p e
Property
Function
Get
Description
This command returns True between a successful call to the Initialize
method and a successful call to the Close method, and
times.
Hierarchy
IAgilentU2701A
;
Initialized
False at all other
Return Format
Boolean
Example
34 U2701A/U2702A IVI-COM Programmer’s Reference
Configure
Configuration 2
Ty p e
Method
Function
Set
Description
This command configures the trigger Type and Holdoff. Holdoff units are
expressed in seconds.
Hierarchy
IAgilentU2701A
;
Trigger
;
Configure(Type, Holdoff)
Parameters
Item Type Description
Type AgilentU2701A
Tr ig g e rTy p eE n um
Holdoff Double Specifies the trigger hold-off. This value sets the Trigger.
U2701A/U2702A IVI-COM Programmer’s Reference 35
Specifies the trigger type. This value sets the Trigger.Ty p e
property. See “AgilentU2701ATriggerTypeEnum” on
page 101 for more information.
Holdoff property.
2 Configuration
Example
36 U2701A/U2702A IVI-COM Programmer’s Reference
Coupling
Configuration 2
Ty p e
Property
Function
Get and Set
Description
This command returns/sets how the oscilloscope couples the trigger
source.
Hierarchy
IAgilentU2701A
;
Trigger
;
Coupling
Return Format
Item Type Description
AgilentU2701A
TriggerCoupling
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 37
Enum See “AgilentU2701ATriggerCouplingEnum” on page 99 for
more information.
2 Configuration
Example
38 U2701A/U2702A IVI-COM Programmer’s Reference
Edge
Configuration 2
This interface configures slope of edge trigger.
Configure
Ty p e
Method
Function
Set
Description
This command configures the conditions for edge trigger. An edge trigger
occurs when the trigger source signal passes through the trigger level with
the specified slope.
Hierarchy
IAgilentU2701A
;
Trigger
;
Edge
;
Configure(Source, Level, Slope)
U2701A/U2702A IVI-COM Programmer’s Reference 39
2 Configuration
Parameters
Item Type Description
Source String Specifies the trigger source. This value sets the
Tr ig g e r. Source property.
Level Double Specifies the trigger level. This value sets the Trigger.Level
property.
Slope AgilentU2701A
TriggerSlopeEnum
Example
Specifies the trigger slope. This value sets the
Tr ig g e r. Slope property. See
“AgilentU2701ATriggerSlopeEnum” on page 100 for more
information.
40 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Slope
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the slope, a rising or a falling edge, that
triggers the oscilloscope.
Hierarchy
IAgilentU2701A
;
Trigger
;
Edge
;
Slope
Parameters
Item Type Description
AgilentU2701A
TriggerSlopeEnum
U2701A/U2702A IVI-COM Programmer’s Reference 41
Enum See “AgilentU2701ATriggerSlopeEnum” on page 100 for
more information.
2 Configuration
Example
42 U2701A/U2702A IVI-COM Programmer’s Reference
Glitch
Configuration 2
This interface configures the condition, polarity, and width of the glitch
trigger.
Condition
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the glitch condition that determines whether
the oscilloscope triggers on a pulse with a width less than or greater than
the glitch width value.
Hierarchy
IAgilentU2701A
;
Trigger
;
Glitch
;
Condition
Parameters
Item Type Description
AgilentU2701A
GlitchCondition
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 43
Enum See “AgilentU2701AGlitchConditionEnum” on page 94 for
more information.
2 Configuration
Example
44 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Configure
Ty p e
Method
Function
Set
Description
This command configures the glitch trigger Source, Level, Width, Polarity,
and Condition. A glitch trigger occurs when the edge of a pulse that
matches the Width and Polarity crosses the specified Le vel (expressed in
volts).
Hierarchy
IAgilentU2701A
;
Trigger
;
Glitch
;
Configure(Source, Level, Width, Polarity, Condition)
Parameters
Item Type Description
Source String Specifies the trigger source. This value sets the
Tr ig g e r. Source property.
Level Double Specifies the trigger level. This value sets the Trigger.Level
property.
Width Double Specifies the glitch triggering glitch width in seconds.
This value sets the Glitch.Width property.
Polarity AgilentU2701A
GlitchPolarity
Enum
Condition AgilentU2701A
GlitchCondition
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 45
Specifies the glitch polarity. This value sets the Glitch.
Polarity property.
Specifies the glitch condition. This value sets the
Glitch.Condition property.
2 Configuration
Example
46 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Polarity
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the polarity of the glitch that triggers the
oscilloscope.
Hierarchy
IAgilentU2701A
;
Trigger
;
Glitch
;
Polarity
Return Format
Item Type Description
AgilentU2701A
GlitchPolarity
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 47
Enum Specifies the glitch polarity. This value sets the
Glitch.Polarity property.
2 Configuration
Example
48 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Width
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the glitch width. The units are expressed in
seconds.
Hierarchy
IAgilentU2701A
;
Trigger
;
Glitch
;
Width
Return Format
Double
Example
U2701A/U2702A IVI-COM Programmer’s Reference 49
2 Configuration
Holdoff
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the length of time the oscilloscope waits after
it fills the acquisition buffer until the oscilloscope enables the trigger
interface to detect another trigger. The units are expressed in seconds.
Hierarchy
IAgilentU2701A
;
Trigger
;
Holdoff
Return Format
Double
Example
50 U2701A/U2702A IVI-COM Programmer’s Reference
Modifier
Configuration 2
Ty p e
Property
Function
Get and Set
Description
This command determines the oscilloscope behavior in the absence of a
trigger.
Hierarchy
IAgilentU2701A
;
Trigger
;
Modifier
Return Format
Item Type Description
AgilentU2701A
TriggerModifier
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 51
Enum See “AgilentU2701ATriggerModifierEnum” on page 99 for
more information.
2 Configuration
Example
52 U2701A/U2702A IVI-COM Programmer’s Reference
Level
Configuration 2
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the voltage threshold for the trigger interface.
The units are expressed in volts.
Hierarchy
IAgilentU2701A
;
Trigger
;
Level
Return Format
Double
Example
U2701A/U2702A IVI-COM Programmer’s Reference 53
2 Configuration
Source
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the signal that the oscilloscope monitors for a
trigger. It can be a channel or one of many other values.
Hierarchy
IAgilentU2701A
;
Trigger
;
Source
Return Format
String/BSTR
Example
54 U2701A/U2702A IVI-COM Programmer’s Reference
Status
Configuration 2
Ty p e
Property
Function
Get
Description
If this command is set to True, the waveform starts directly after the
trigger condition is met. If this command is set to
has to send a force trigger to get a waveform.
False, the instrument
Hierarchy
IAgilentU2701A
;
Trigger
;
Status
Return Format
Boolean
Example
U2701A/U2702A IVI-COM Programmer’s Reference 55
2 Configuration
TV
This interface configures the signal format, number of lines, and events of
the TV trigger.
Configure
Ty p e
Method
Function
Set
Description
This command configures the TV trigger source, signal format, event, and
polarity.
Hierarchy
IAgilentU2701A
;
Trigger
;
TV
;
Configure(Source, SignalFormat, Event)
56 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Parameters
Item Type Description
Source String Specifies the trigger source. This value sets the
Tr ig g e r. Source property.
SignalFormat AgilentU2701ATV
SignalFormat
Enum
Event AgilentU2701ATV
TriggerEventEnum
Specifies the TV trigger signal format. This value sets the
TV.SignalFormat property. See
“AgilentU2701ATVSignalFormatEnum” on page 102 for
more information.
Specifies the TV trigger event. This value sets the
TV.Event property. See
“AgilentU2701ATVTriggerEventEnum” on page 103 for
more information.
U2701A/U2702A IVI-COM Programmer’s Reference 57
2 Configuration
Example
58 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Event
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the event on which the oscilloscope triggers.
Hierarchy
IAgilentU2701A
;
Trigger
;
TV
;
Event
Return Format
Item Type Description
AgilentU2701ATV
TriggerEventEnum
U2701A/U2702A IVI-COM Programmer’s Reference 59
Enum See “AgilentU2701ATVTriggerEventEnum” on page 103 for
more information.
2 Configuration
Example
60 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
LineNumber
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the line on which the oscilloscope triggers. The
line number is absolute and not relative to the field of the TV signal.
Hierarchy
IAgilentU2701A
;
Trigger
;
TV
;
LineNumber
Return Format
Long/Int32
Example
U2701A/U2702A IVI-COM Programmer’s Reference 61
2 Configuration
SignalFormat
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the format of the TV signal on which the
oscilloscope triggers.
Hierarchy
IAgilentU2701A
;
Trigger
;
TV
;
SignalFormat
Return Format
Item Type Description
AgilentU2701ATV
SignalFormat
Enum
62 U2701A/U2702A IVI-COM Programmer’s Reference
Enum See “AgilentU2701ATVSignalFormatEnum” on page 102
for more information.
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 63
2 Configuration
Type
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the kind of event that triggers the oscilloscope.
Hierarchy
IAgilentU2701A
;
Trigger
;
TV
;
Type
Return Format
Item Type Description
AgilentU2701A
Tr ig g e rTy p eE n um
64 U2701A/U2702A IVI-COM Programmer’s Reference
Enum See “AgilentU2701ATriggerTypeEnum” on page 101 for
more information.
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 65
2 Configuration
Width
This interface configures condition, polarity, and threshold level of width
trigger.
Condition
Ty p e
Property
Function
Get and Set
Description
This command returns/sets whether a pulse within or outside the high
and low thresholds triggers the oscilloscope.
Hierarchy
IAgilentU2701A
;
Trigger
;
Width
;
Condition
Return Format
Item Type Description
AgilentU2701A
WidthCondition
Enum
66 U2701A/U2702A IVI-COM Programmer’s Reference
Enum See “AgilentU2701AWidthConditionEnum” on page 105
for more information.
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 67
2 Configuration
Configure
Ty p e
Method
Function
Set
Description
This command configures the width trigger Source, Level, ThresholdLow,
ThresholdHigh, Polarity, and Condition. A width trigger occurs when a
pulse, which passes through Level, with a width between or outside, the
width threshold is detected.
Hierarchy
IAgilentU2701A
;
Trigger
;
Width
;
Configure(Source, Level, ThresholdLow, ThresholdHigh,
Polarity, Condition)
Parameters
Item Type Description
Source String Specifies the trigger source. This value sets the
Tr ig g e r. Source property.
Level Double Specifies the trigger level. This value sets the Trigger.Level
property.
ThresholdLow Double Sets the width triggering low threshold in seconds. This
value sets the Width.ThresholdLow property.
ThresholdHigh Double Sets the width triggering high threshold in seconds. This
value sets the Width.ThresholdHigh property.
68 U2701A/U2702A IVI-COM Programmer’s Reference
Item Type Description
Configuration 2
Polarity AgilentU2701A
WidthPolarity
Enum
Condition AgilentU2701A
WidthCondition
Enum
Specifies the width polarity. This value sets the
Width.Polarity property. See
“AgilentU2701AWidthPolarityEnum” on page 105 for more
information.
Specifies the width condition. This value sets the
Width.Condition property. See
“AgilentU2701AWidthConditionEnum” on page 105 for
more information.
U2701A/U2702A IVI-COM Programmer’s Reference 69
2 Configuration
Example
70 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
Polarity
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the polarity of the pulse that triggers the
oscilloscope.
Hierarchy
IAgilentU2701A
;
Trigger
;
Width
;
Polarity
Return Format
Item Type Description
AgilentU2701A
WidthPolarity
Enum
U2701A/U2702A IVI-COM Programmer’s Reference 71
Enum See “AgilentU2701AWidthPolarityEnum” on page 105 for
more information.
2 Configuration
Example
72 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
ThresholdHigh
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the high width threshold time, expressed in
seconds.
Hierarchy
IAgilentU2701A
;
Trigger
;
Width
;
ThresholdHigh
Return Format
Double
Example
U2701A/U2702A IVI-COM Programmer’s Reference 73
2 Configuration
ThresholdLow
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the low width threshold time, expressed in
seconds.
Hierarchy
IAgilentU2701A
;
Trigger
;
Width
;
ThresholdLow
Return Format
Double
Example
74 U2701A/U2702A IVI-COM Programmer’s Reference
Clear
Configuration 2
Ty p e
Method
Function
Set
Description
This command clears all event registers and error queues. The enable
registers are unaffected.
Hierarchy
IAgilentU2701A
;
Status
;
Clear()
Example
U2701A/U2702A IVI-COM Programmer’s Reference 75
2 Configuration
ConfigureServiceRequest
Ty p e
Method
Function
Set
Description
This command clears all the enable registers. It then sets the appropriate
transition filters and enable registers so when the specified event(s)
occur(s) the instrument requests service. All other events are disabled
from generating a service request. To detect a service request the client
application must poll the status byte using the SerialPoll method or
Register property and test the request service bit.
Hierarchy
IAgilentU2701A
;
Status
;
ConfigureServiceRequest(Reason)
Parameters
Item Type Description
Reason AgilentU2701A
SRQReasonEnum
76 U2701A/U2702A IVI-COM Programmer’s Reference
The defined values are expressed in the powers of two: 1,
2, 4, and so on. You can OR several reasons together so
multiple events can generate a service request. See
“AgilentU2701ASRQReasonEnum” on page 95 for more
information.
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 77
2 Configuration
Preset
Ty p e
Method
Function
Set
Description
This command sets the SCPI defined enable registers and transition filters.
Hierarchy
IAgilentU2701A
;
Status
;
Preset()
Example
78 U2701A/U2702A IVI-COM Programmer’s Reference
Register
Ty p e
Property
Function
Get and Set
Description
This command returns/sets the instrument status registers.
Hierarchy
IAgilentU2701A
;
Status
;
Register(Register, SubRegister, val)
Parameters
Configuration 2
Item Type Description
Register AgilentU2701A
StatusRegister
Enum
SubRegister AgilentU2701A
StatusSubRegister
Enum
val Long/Int32 Instrument Status Register value
The status register to access. See
“AgilentU2701AStatusRegisterEnum” on page 97 for
available registers.
The status sub register to access. See
“AgilentU2701AStatusSubRegisterEnum” on page 98 for
available sub registers.
U2701A/U2702A IVI-COM Programmer’s Reference 79
2 Configuration
Return Format
Item Type Description
val Long/Int32 Instrument Status Register value
Example
80 U2701A/U2702A IVI-COM Programmer’s Reference
SerialPoll
Configuration 2
Ty p e
Property
Function
Get
Description
This command returns the serial poll of the instrument status byte.
Hierarchy
IAgilentU2701A
;
Status
;
SerialPoll
Return Format
Long/Int32
Example
U2701A/U2702A IVI-COM Programmer’s Reference 81
2 Configuration
TimeoutMilliseconds
Ty p e
Property
Function
Set
Description
This command sets the value, in milliseconds, of the default timeout used
by I/O operations. This property provides access to the driver Visa Session
Timeout. Only in rare, unusual circumstances should you set this property.
Driver methods and properties with operations which take a significant
time to perform are responsible for adjusting the I/O timeout to an
appropriate value. Some methods provide a MaxTimeMilliseconds
parameter which gives you direct control over the timeout value for that
method. Sometimes, however, increasing the timeout value can work
around an obscure driver defect.
Hierarchy
IAgilentU2701A
;
System
;
TimeoutMilliseconds
Return Format
Long/Int32
82 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 83
2 Configuration
WaitForOperationComplete
Ty p e
Method
Function
Set
Description
This command sets the instrument not to return until previously started
operations are completed or the MaxTimeMillisecon ds time have expired.
Hierarchy
IAgilentU2701A
;
System
;
WaitForOperationComplete (MaxTimeMilliseconds)
Return Format
String/BTSR
Example
84 U2701A/U2702A IVI-COM Programmer’s Reference
Disable
Configuration 2
Ty p e
Method
Function
Set
Description
This command quickly places the instrument in a state where it has no, or
minimal, effect on the external system to which it is connected. This state
is not necessarily a known state.
Hierarchy
IAgilentU2701A
;
Utility
;
Disable()
Example
U2701A/U2702A IVI-COM Programmer’s Reference 85
2 Configuration
ErrorQuery
Ty p e
Method
Function
Get
Description
This commad queries the instrument and returns the instrument specific
error information. This function can be used when QueryInstrumentStatus
is
True to retrieve error details when the driver detects an instrument
error.
Hierarchy
IAgilentU2701A
;
Utility
;
ErrorQuery(ErrorCode, ErrorMessage)
Return Format
Item Type Description
ErrorCode Long/Int32 Instrument error code.
ErrorMessage String/BSTR Instrument error message.
86 U2701A/U2702A IVI-COM Programmer’s Reference
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 87
2 Configuration
LockObject
Ty p e
Method
Function
Set
Description
Obtains a multithread lock on the driver after waiting until all other
execution threads have released their locks on the instrument session.
Hierarchy
IAgilentU2701A
;
Utility
;
LockObject()
Example
88 U2701A/U2702A IVI-COM Programmer’s Reference
Reset
Configuration 2
Ty p e
Method
Function
Set
Description
This command places the instrument in a known state and configures
instrument options on which the IVI specific driver depends (for example,
enabling/disabling headers). For an IEEE- 488.2 instrument, Reset sends
the command string
*RST to the instrument.
Hierarchy
IAgilentU2701A
;
Utility
;
Reset()
Example
U2701A/U2702A IVI-COM Programmer’s Reference 89
2 Configuration
ResetWithDefaults
Ty p e
Method
Function
Set
Description
This command does the equivalent of Reset and then, disables class
extension capability groups, sets attributes to initial values defined by
class specs, and configures the driver to option string settings used when
Initialize was last executed.
Hierarchy
IAgilentU2701A
;
Utility
;
ResetWithDefaults()
Example
90 U2701A/U2702A IVI-COM Programmer’s Reference
SelfTest
Configuration 2
Ty p e
Method
Function
Get
Description
This command performs an instrument self- test, waits for the instrument
to complete the test, and queries the instrument for the results. If the
instrument passes the test, TestResult is “
“
Self test passed”.
0” and TestMessage is
Hierarchy
IAgilentU2701A
;
Utility
;
SelfTest(TestResult, TestMessage)
Return Format
Item Type Description
TestResult Long/Int32 Numeric result from the self-test operation. 0 = no error
(test passed).
TestMessage String/BSTR Self-test status message.
U2701A/U2702A IVI-COM Programmer’s Reference 91
2 Configuration
Example
92 U2701A/U2702A IVI-COM Programmer’s Reference
Loading...