Agilent Technologies InfiniiVision 7000A Series Manual


Agilent InfiniiVision
7000A Series
Oscilloscopes
Programmer's Guide

Notices
© Agilent Technologies, Inc. 2005-2010
No part of this manual may be reproduced
in any form or by any means (including
electronic storage and retrieval or transla-
tion into a foreign language) without prior
agreement and written consent from Agi-
lent Technologies, Inc. as governed by
United States and international copyright
laws.
Manual Part Number
Version 06.00.0000
Edition
January 21, 2010
Available in electronic format only
Agilent Technologies, Inc.
1900 Garden of the Gods Road
Colorado Springs, CO 80907 USA
Warranty
The material contained in this docu-
ment is provided “as is,” and is sub-
ject to being changed, without notice,
in future editions. Further, to the max-
imum 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 par-
ticular purpose. Agilent shall not be
liable for errors or for incidental or
consequential damages in connection
with the furnishing, use, or perfor-
mance 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 sep-
arate 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
If software is for use in the performance of
a U.S. Government prime contract or sub-
contract, Software is delivered and
licensed as “Commercial computer soft-
ware” as defined in DFAR 252.227-7014
(June 1995), or as a “commercial item” as
defined in FAR 2.101(a) or as “Restricted
computer software” as defined in FAR
52.227-19 (June 1987) or any equivalent
agency regulation or contract clause. Use,
duplication or disclosure of Software is
subject to Agilent Technologies’ standard
commercial license terms, and non-DOD
Departments and Agencies of the U.S. Gov-
ernment will receive no greater than
Restricted Rights as defined in FAR
52.227-19(c)(1-2) (June 1987). U.S. Govern-
ment users will receive no greater than
Limited Rights as defined in FAR 52.227-14
(June 1987) or DFAR 252.227-7015 (b)(2)
(November 1995), as applicable in any
technical data.
Safety Notices
CAUTION
A CAUTION notice denotes a haz-
ard. It calls attention to an operat-
ing 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.
WARNING
A WARNING notice denotes a
hazard. It calls attention to an
operating procedure, practice, or
the like that, if not correctly per-
formed or adhered to, could result
in personal injury or death. Do not
proceed beyond a WARNING
notice until the indicated condi-
tions are fully understood and met.
Trademarks
Microsoft®, MS-DOS®, Windows®, Win-
dows 2000®, and Windows XP® are U.S.
registered trademarks of Microsoft Corpo-
ration.
Adobe®, Acrobat®, and the Acrobat
Logo® are trademarks of Adobe Systems
Incorporated.

Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide 3
In This Book
This book is your guide to programming the 7000A Series oscilloscopes:
The first few chapters describe how to set up and get started:
•Chapter 1, Chapter 1, “What's New,” starting on page 21, describes
programming command changes in the latest version of oscilloscope
software.
•Chapter 2, Chapter 2, “Setting Up,” starting on page 35, describes the
steps you must take before you can program the oscilloscope.
•Chapter 3, Chapter 3, “Getting Started,” starting on page 45, gives a
general overview of oscilloscope program structure and shows how to
program the oscilloscope using a few simple examples.
•Chapter 4, Chapter 4, “Commands Quick Reference,” starting on page
59, is a brief listing of the 7000 Series oscilloscope commands and
syntax.
The next chapters provide reference information:
•Chapter 5, Chapter 5, “Commands by Subsystem,” starting on page 111,
describes the set of commands that belong to an individual subsystem
and explains the function of each command. Command arguments and
syntax are described. Some command descriptions have example code.
•Chapter 6, Chapter 6, “Commands A- Z,” starting on page 653, contains
an alphabetical listing of all command elements.
•Chapter 7, Chapter 7, “Obsolete and Discontinued Commands,” starting
on page 687, describes obsolete commands which still work but have
been replaced by newer commands and discontinued commands which
are no longer supported.
Table 1 InfiniiVision 7000A Series Oscilloscope Models
Channels Input Bandwidth
1 GHz 500 MHz 350 MHz 100 MHz
4 analog + 16
digital
(mixed-signal)
MSO7104A MSO7054A MSO7034A MSO7014A
2 analog + 16
digital
(mixed-signal)
MSO7052A MSO7032A MSO7012A
4 analog DSO7104A DSO7054A DSO7034A DSO7014A
2 analog DSO7052A DSO7032A DSO7012A

4 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide
•Chapter 8, Chapter 8, “Error Messages,” starting on page 743, lists the
instrument error messages that can occur while programming the
oscilloscope.
The command descriptions in this reference show upper and lowercase
characters. For example, :AUToscale indicates that the entire command
name is :AUTOSCALE. The short form, :AUT, is also accepted by the
oscilloscope.
Then, there are chapters that describe programming topics and conceptual
information in more detail:
•Chapter 9, Chapter 9, “Status Reporting,” starting on page 751,
describes the oscilloscope's status registers and how to check the status
of the instrument.
•Chapter 10, Chapter 10, “Synchronizing Acquisitions,” starting on page
775, describes how to wait for acquisitions to complete before querying
measurement results or performing other operations with the captured
data.
•Chapter 11, Chapter 11, “More About Oscilloscope Commands,” starting
on page 785, contains additional information about oscilloscope
programming commands.
Finally, there is a chapter that contains programming examples:
•Chapter 12, Chapter 12, “Programming Examples,” starting on page 811.
Mixed-Signal
Oscilloscope
Channel
Differences
Because both the "analog channels only" oscilloscopes (DSO models) and
the mixed- signal oscilloscopes (MSO models) have analog channels, topics
that describe analog channels refer to all oscilloscope models. Whenever a
topic describes digital channels, that information applies only to the
mixed- signal oscilloscope models.
See Also •For more information on using the SICL, VISA, and VISA COM libraries
in general, see the documentation that comes with the Agilent IO
Libraries Suite.
•For information on controller PC interface configuration, see the
documentation for the interface card used (for example, the Agilent
82350A GPIB interface).
•For information on oscilloscope front-panel operation, see the User's
Guide.
•For detailed connectivity information, refer to the Agilent Technologies
USB/LAN/GPIB Connectivity Guide. For a printable electronic copy of
the Connectivity Guide, direct your Web browser to "www.agilent.com"
and search for "Connectivity Guide".
•For the latest versions of this and other manuals, see:
"http://www.agilent.com/find/7000manual"

Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide 5
Contents
In This Book 3
1 What's New
What's New in Version 6.00 22
What's New in Version 5.25 25
What's New in Version 5.20 27
What's New in Version 5.15 30
What's New in Version 5.10 32
Version 5.00 at Introduction 33
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software 36
Step 2. Connect and set up the oscilloscope 37
Using the USB (Device) Interface 37
Using the LAN Interface 37
Step 3. Verify the oscilloscope connection 39
3 Getting Started
Basic Oscilloscope Program Structure 46
Initializing 46
Capturing Data 46
Analyzing Captured Data 47

6 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide
Programming the Oscilloscope 48
Referencing the IO Library 48
Opening the Oscilloscope Connection via the IO Library 49
Initializing the Interface and the Oscilloscope 49
Using :AUToscale to Automate Oscilloscope Setup 50
Using Other Oscilloscope Setup Commands 50
Capturing Data with the :DIGitize Command 51
Reading Query Responses from the Oscilloscope 53
Reading Query Results into String Variables 54
Reading Query Results into Numeric Variables 54
Reading Definite-Length Block Query Response Data 54
Sending Multiple Queries and Reading Results 55
Checking Instrument Status 56
Other Ways of Sending Commands 57
Telnet Sockets 57
Sending SCPI Commands Using Browser Web Control 57
4 Commands Quick Reference
Command Summary 60
Syntax Elements 108
Number Format 108
<NL> (Line Terminator) 108
[ ] (Optional Syntax Terms) 108
{ } (Braces) 108
::= (Defined As) 108
< > (Angle Brackets) 109
... (Ellipsis) 109
n,..,p (Value Ranges) 109
d (Digits) 109
Quoted ASCII String 109
Definite-Length Block Response Data 109
5 Commands by Subsystem
Common (*) Commands 113
*CLS (Clear Status) 117
*ESE (Standard Event Status Enable) 118
*ESR (Standard Event Status Register) 120
*IDN (Identification Number) 122
*LRN (Learn Device Setup) 123
*OPC (Operation Complete) 124

Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide 7
*OPT (Option Identification) 125
*RCL (Recall) 127
*RST (Reset) 128
*SAV (Save) 131
*SRE (Service Request Enable) 132
*STB (Read Status Byte) 134
*TRG (Trigger) 136
*TST (Self Test) 137
*WAI (Wait To Continue) 138
Root (:) Commands 139
:ACTivity 142
:AER (Arm Event Register) 143
:AUToscale 144
:AUToscale:AMODE 146
:AUToscale:CHANnels 147
:BLANk 148
:CDISplay 149
:DIGitize 150
:HWEenable (Hardware Event Enable Register) 152
:HWERegister:CONDition (Hardware Event Condition Register) 154
:HWERegister[:EVENt] (Hardware Event Event Register) 156
:MERGe 158
:MTEenable (Mask Test Event Enable Register) 159
:MTERegister[:EVENt] (Mask Test Event Event Register) 161
:OPEE (Operation Status Enable Register) 163
:OPERegister:CONDition (Operation Status Condition Register) 165
:OPERegister[:EVENt] (Operation Status Event Register) 167
:OVLenable (Overload Event Enable Register) 169
:OVLRegister (Overload Event Register) 171
:PRINt 173
:RUN 174
:SERial 175
:SINGle 176
:STATus 177
:STOP 178
:TER (Trigger Event Register) 179
:VIEW 180
:ACQuire Commands 181
:ACQuire:AALias 183
:ACQuire:COMPlete 184
:ACQuire:COUNt 185

8 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide
:ACQuire:DAALias 186
:ACQuire:MODE 187
:ACQuire:POINts 188
:ACQuire:RSIGnal 189
:ACQuire:SEGMented:ANALyze 190
:ACQuire:SEGMented:COUNt 191
:ACQuire:SEGMented:INDex 192
:ACQuire:SRATe 195
:ACQuire:TYPE 196
:BUS<n> Commands 198
:BUS<n>:BIT<m> 200
:BUS<n>:BITS 201
:BUS<n>:CLEar 203
:BUS<n>:DISPlay 204
:BUS<n>:LABel 205
:BUS<n>:MASK 206
:CALibrate Commands 207
:CALibrate:DATE 209
:CALibrate:LABel 210
:CALibrate:OUTPut 211
:CALibrate:STARt 212
:CALibrate:STATus 213
:CALibrate:SWITch 214
:CALibrate:TEMPerature 215
:CALibrate:TIME 216
:CHANnel<n> Commands 217
:CHANnel<n>:BWLimit 220
:CHANnel<n>:COUPling 221
:CHANnel<n>:DISPlay 222
:CHANnel<n>:IMPedance 223
:CHANnel<n>:INVert 224
:CHANnel<n>:LABel 225
:CHANnel<n>:OFFSet 226
:CHANnel<n>:PROBe 227
:CHANnel<n>:PROBe:HEAD[:TYPE] 228
:CHANnel<n>:PROBe:ID 229
:CHANnel<n>:PROBe:SKEW 230
:CHANnel<n>:PROBe:STYPe 231
:CHANnel<n>:PROTection 232
:CHANnel<n>:RANGe 233

Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide 9
:CHANnel<n>:SCALe 234
:CHANnel<n>:UNITs 235
:CHANnel<n>:VERNier 236
:DIGital<n> Commands 237
:DIGital<n>:DISPlay 239
:DIGital<n>:LABel 240
:DIGital<n>:POSition 241
:DIGital<n>:SIZE 242
:DIGital<n>:THReshold 243
:DISPlay Commands 244
:DISPlay:CLEar 246
:DISPlay:DATA 247
:DISPlay:LABel 249
:DISPlay:LABList 250
:DISPlay:PERSistence 251
:DISPlay:SOURce 252
:DISPlay:VECTors 253
:EXTernal Trigger Commands 254
:EXTernal:BWLimit 256
:EXTernal:IMPedance 257
:EXTernal:PROBe 258
:EXTernal:PROBe:ID 259
:EXTernal:PROBe:STYPe 260
:EXTernal:PROTection 261
:EXTernal:RANGe 262
:EXTernal:UNITs 263
:FUNCtion Commands 264
:FUNCtion:CENTer 267
:FUNCtion:DISPlay 268
:FUNCtion:GOFT:OPERation 269
:FUNCtion:GOFT:SOURce1 270
:FUNCtion:GOFT:SOURce2 271
:FUNCtion:OFFSet 272
:FUNCtion:OPERation 273
:FUNCtion:RANGe 274
:FUNCtion:REFerence 275
:FUNCtion:SCALe 276
:FUNCtion:SOURce1 277
:FUNCtion:SOURce2 278
:FUNCtion:SPAN 279

10 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide
:FUNCtion:WINDow 280
:HARDcopy Commands 281
:HARDcopy:AREA 283
:HARDcopy:APRinter 284
:HARDcopy:FACTors 285
:HARDcopy:FFEed 286
:HARDcopy:INKSaver 287
:HARDcopy:LAYout 288
:HARDcopy:PALette 289
:HARDcopy:PRINter:LIST 290
:HARDcopy:STARt 291
:LISTer Commands 292
:LISTer:DATA 293
:LISTer:DISPlay 294
:MARKer Commands 295
:MARKer:MODE 297
:MARKer:X1Position 298
:MARKer:X1Y1source 299
:MARKer:X2Position 300
:MARKer:X2Y2source 301
:MARKer:XDELta 302
:MARKer:Y1Position 303
:MARKer:Y2Position 304
:MARKer:YDELta 305
:MEASure Commands 306
:MEASure:CLEar 314
:MEASure:COUNter 315
:MEASure:DEFine 316
:MEASure:DELay 319
:MEASure:DUTYcycle 321
:MEASure:FALLtime 322
:MEASure:FREQuency 323
:MEASure:NWIDth 324
:MEASure:OVERshoot 325
:MEASure:PERiod 327
:MEASure:PHASe 328
:MEASure:PREShoot 329
:MEASure:PWIDth 330
:MEASure:RESults 331
:MEASure:RISetime 334