Agilent U2701A, U2702A Data Sheet
Agilent U2701A/U2702A
USB Modular
Oscilloscopes
IVI-COM Programmer’s
Reference for NI LabVIEW
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-90040
Edition
First Edition, June 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 14
BandwidthLimit 14
Configure 16
Coupling 19
Enabled 21
Offset 23
ProbeAttenuation 25
Range 27
Name 30
Close 32
Initialize 34
Initialized 37
Configure 39
Coupling 41
Edge 43
Configure 43
Slope 46
U2701A/U2702A IVI-COM Programmer’s Reference III
Glitch 48
Condition 48
Configure 50
Polarity 52
Width 54
Holdoff 56
Modifier 58
Level 60
Source 61
Status 63
TV 66
Configure 66
Event 69
LineNumber 71
SignalFormat 72
Type 75
Width 77
Condition 77
Configure 79
Polarity 82
ThresholdHigh 84
ThresholdLow 85
Clear 88
ConfigureServiceRequest 90
Preset 92
Register 94
SerialPoll 96
TimeoutMilliseconds 98
IV U2701A/U2702A IVI-COM Programmer’s Reference
WaitForOperationComplete 100
Disable 102
ErrorQuery 104
LockObject 106
Reset 108
ResetWithDefaults 110
SelfTest 112
UnlockObject 114
Enumeration Members 116
AgilentU2701AGlitchConditionEnum 116
AgilentU2701AGlitchPolarityEnum 117
AgilentU2701ASRQReasonEnum 117
AgilentU2701AStatusRegisterEnum 119
AgilentU2701AStatusSubRegisterEnum 120
AgilentU2701ATriggerCouplingEnum 121
AgilentU2701ATriggerModifierEnum 121
AgilentU2701ATriggerSlopeEnum 122
AgilentU2701ATriggerTypeEnum 123
AgilentU2701ATVSignalFormatEnum 124
AgilentU2701ATVTriggerEventEnum 125
AgilentU2701AVerticalCouplingEnum 126
AgilentU2701AWidthConditionEnum 127
AgilentU2701AWidthPolarityEnum 127
3 Acquisition
ConfigureRecord 130
Interpolation 132
NumberOfAverages 134
RecordLength 135
U2701A/U2702A IVI-COM Programmer’s Reference V
SampleMode 137
SampleRate 140
StartTime 142
TimePerRecord 144
Type 147
Enumeration Members 149
AgilentU2701AAcquisitionStatusEnum 149
AgilentU2701AAcquisitionTypeEnum 150
AgilentU2701AInterpolationEnum 151
AgilentU2701ASampleModeEnum 151
4 Waveform Display
Abort 154
AutoSetup 156
Count 158
Initiate 160
IsWaveformElementInvalid 162
Item 164
FetchWaveform 164
ReadWaveform 167
5 Post Analysis
Abort 172
AutoSetup 174
Count 176
Initiate 178
IsWaveformElementInvalid 180
VI U2701A/U2702A IVI-COM Programmer’s Reference
Item 182
FetchWaveform 182
FetchWaveformMeasurement 185
ReadWaveform 187
ReadWaveformMeasurement 190
MathFunction 193
Name 195
Status 196
Enumeration Members 199
AgilentU2701AMathOperationEnum 199
AgilentU2701AMeasurementEnum 200
AgilentU2701ATimeOutEnum 203
6Others
Calibrate 206
Date 208
Label 210
Time 212
Cache 214
ClearInterchangeWarnings 216
DriverSetup 218
GetNextCoercionRecord 220
GetNextInterchangeWarning 221
InterchangeCheck 223
InvalidateAllAttributes 225
IoResourceDescriptor 227
LogicalName 229
U2701A/U2702A IVI-COM Programmer’s Reference VII
QueryInstrumentStatus 231
RangeCheck 233
RecordCoercions 235
ResetInterchangeCheck 237
Simulate 239
Description 241
GroupCapabilities 243
Identifier 245
InstrumentFirmwareRevision 247
InstrumentManufacturer 249
InstrumentModel 251
Revision 253
SpecificationMajorVersion 255
SpecificationMinorVersion 257
SupportedInstrumentModels 259
Vendor 261
SerialNumber 263
7 Application Example
Introduction 266
Creating Connectivity to the IVI-COM Driver 266
Using the Driver 268
Complete Example 276
VIII U2701A/U2702A IVI-COM Programmer’s Reference
U2701A/U2702A USB Modular Oscilloscope
IVI-COM Programmer’s Reference for NI LabVIEW
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 (continued)
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 (continued)
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 (continued)
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 NI LabVIEW
2 Configuration
Channels Interface commands starting on page 12
Close 32
Initialize 34
Initialized 37
Trigger Interface commands starting on page 41
Status Interface commands starting on page 88
System Interface commands starting on page 98
Utility Interface commands starting on page 102
Enumeration Members 116
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
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 13
2 Configuration
Item
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.
14 U2701A/U2702A IVI-COM Programmer’s Reference
Return Format
Boolean
Example
Configuration 2
U2701A/U2702A IVI-COM Programmer’s Reference 15
2 Configuration
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)
16 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
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
U2701A/U2702A IVI-COM Programmer’s Reference 17
2 Configuration
Example
18 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
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
U2701A/U2702A IVI-COM Programmer’s Reference 19
Enum See “AgilentU2701AVerticalCouplingEnum” on page 126.
2 Configuration
Example
20 U2701A/U2702A IVI-COM Programmer’s Reference
Configuration 2
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
U2701A/U2702A IVI-COM Programmer’s Reference 21
2 Configuration
Example
22 U2701A/U2702A IVI-COM Programmer’s Reference
Loading...