Agilent Technologies InfiniiVision 3000 X-Series Manual

s1
Agilent InfiniiVision
3000 X-Series
Oscilloscopes
Programmer's Guide

Notices
© Agilent Technologies, Inc. 2005-2012
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 02.10.0000
Edition
March 1, 2012
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 3000 X-Series Oscilloscopes Programmer's Guide 3
In This Book
This book is your guide to programming the 3000 X- Series oscilloscopes:
The first few chapters describe how to set up and get started:
•Chapter 1, “What's New,” starting on page 31, describes programming
command changes in the latest version of oscilloscope software.
•Chapter 2, “Setting Up,” starting on page 45, describes the steps you
must take before you can program the oscilloscope.
•Chapter 3, “Getting Started,” starting on page 55, gives a general
overview of oscilloscope program structure and shows how to program
the oscilloscope using a few simple examples.
•Chapter 4, “Commands Quick Reference,” starting on page 69, is a brief
listing of the 3000 X-Series oscilloscope commands and syntax.
The next chapters provide reference information on common commands,
root level commands, other subsystem commands, and error messages:
•Chapter 5, “Common (*) Commands,” starting on page 153, describes
commands defined by the IEEE 488.2 standard that are common to all
instruments.
•Chapter 6, “Root (:) Commands,” starting on page 179, describes
commands that reside at the root level of the command tree and control
many of the basic functions of the oscilloscope.
•Chapter 7, “:ACQuire Commands,” starting on page 219, describes
commands for setting the parameters used when acquiring and storing
data.
•Chapter 8, “:BUS<n> Commands,” starting on page 233, describes
commands that control all oscilloscope functions associated with the
digital channels bus display.
Table 1 InfiniiVision 3000 X-Series Oscilloscope Models, Bandwidths, Sample Rates
Bandwidth 100 MHz 200 MHz 350 MHz 500 MHz 1 GHz
Sample Rate
(interleaved,
non-interleaved)
4GSa/s,
2GSa/s
4GSa/s,
2GSa/s
4GSa/s,
2GSa/s
4GSa/s,
2GSa/s
5GSa/s,
2.5 GSa/s
4 analog + 16 digital
(mixed signal) channels
MSO-X 3014A MSO-X 3024A MSO-X 3034A MSO-X 3054A MSO-X 3104A
2 analog + 16 digital
(mixed signal) channels
MSO-X 3012A MSO-X 3032A MSO-X 3052A MSO-X 3102A
4 analog channels DSO-X 3014A DSO-X 3024A DSO-X 3034A DSO-X 3054A DSO-X 3104A
2 analog channels DSO-X 3012A DSO-X 3032A DSO-X 3052A DSO-X 3102A

4 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
•Chapter 9, “:CALibrate Commands,” starting on page 243, describes
utility commands for determining the state of the calibration factor
protection button.
•Chapter 10, “:CHANnel<n> Commands,” starting on page 253, describes
commands that control all oscilloscope functions associated with
individual analog channels or groups of channels.
•Chapter 11, “:DEMO Commands,” starting on page 273, describes
commands that control the education kit (Option EDU) demonstration
signals that can be output on the oscilloscope's Demo 1 and Demo 2
terminals.
•Chapter 12, “:DIGital<d> Commands,” starting on page 281, describes
commands that control all oscilloscope functions associated with
individual digital channels.
•Chapter 13, “:DISPlay Commands,” starting on page 289, describes
commands that control how waveforms, graticule, and text are displayed
and written on the screen.
•Chapter 14, “:EXTernal Trigger Commands,” starting on page 301,
describes commands that control the input characteristics of the
external trigger input.
•Chapter 15, “:FUNCtion Commands,” starting on page 307, describes
commands that control math waveforms.
•Chapter 16, “:HARDcopy Commands,” starting on page 341, describes
commands that set and query the selection of hardcopy device and
formatting options.
•Chapter 17, “:LISTer Commands,” starting on page 359, describes
commands that turn on/off the Lister display for decoded serial data
and get the Lister data.
•Chapter 18, “:MARKer Commands,” starting on page 363, describes
commands that set and query the settings of X- axis markers (X1 and
X2 cursors) and the Y- axis markers (Y1 and Y2 cursors).
•Chapter 19, “:MEASure Commands,” starting on page 379, describes
commands that select automatic measurements (and control markers).
•Chapter 20, “:MEASure Power Commands,” starting on page 447,
describes measurement commands that are available when the
DSOX3PWR power measurements and analysis application is licensed
and enabled.
•Chapter 21, “:MTESt Commands,” starting on page 467, describes
commands that control the mask test features provided with
Option LMT.
•Chapter 22, “:POD Commands,” starting on page 501, describes
commands that control all oscilloscope functions associated with groups
of digital channels.
•Chapter 23, “:POWer Commands,” starting on page 507, describes
commands that control the DSOX3PWR power measurement application.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 5
•Chapter 24, “:RECall Commands,” starting on page 565, describes
commands that recall previously saved oscilloscope setups, reference
waveforms, or masks.
•Chapter 25, “:SAVE Commands,” starting on page 573, describes
commands that save oscilloscope setups, screen images, and data.
•Chapter 26, “:SBUS<n> Commands,” starting on page 595, describes
commands that control oscilloscope functions associated with the serial
decode bus and serial triggering.
•Chapter 27, “:SEARch Commands,” starting on page 743, describes
commands that control oscilloscope functions associated with searching
for waveform events.
•Chapter 28, “:SYSTem Commands,” starting on page 817, describes
commands that control basic system functions of the oscilloscope.
•Chapter 29, “:TIMebase Commands,” starting on page 831, describes
commands that control all horizontal sweep functions.
•Chapter 30, “:TRIGger Commands,” starting on page 843, describes
commands that control the trigger modes and parameters for each
trigger type.
•Chapter 31, “:WAVeform Commands,” starting on page 923, describes
commands that provide access to waveform data.
•Chapter 32, “:WGEN Commands,” starting on page 959, describes
commands that control waveform generator (Option WGN) functions and
parameters.
•Chapter 33, “:WMEMory<r> Commands,” starting on page 985, describes
commands that control reference waveforms.
•Chapter 34, “Obsolete and Discontinued Commands,” starting on page
995, describes obsolete commands which still work but have been
replaced by newer commands and discontinued commands which are no
longer supported.
•Chapter 35, “Error Messages,” starting on page 1047, 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 36, “Status Reporting,” starting on page 1055, describes the
oscilloscope's status registers and how to check the status of the
instrument.
•Chapter 37, “Synchronizing Acquisitions,” starting on page 1077,
describes how to wait for acquisitions to complete before querying

6 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
measurement results or performing other operations with the captured
data.
•Chapter 38, “More About Oscilloscope Commands,” starting on page
1087, contains additional information about oscilloscope programming
commands.
Finally, there is a chapter that contains programming examples:
•Chapter 39, “Programming Examples,” starting on page 1097.
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
82350B 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/3000X- Series- manual"

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 7
Contents
In This Book 3
1 What's New
What's New in Version 2.10 32
What's New in Version 2.00 33
What's New in Version 1.20 37
What's New in Version 1.10 39
Version 1.00 at Introduction 40
Command Differences From 7000B Series Oscilloscopes 41
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software 46
Step 2. Connect and set up the oscilloscope 47
Using the USB (Device) Interface 47
Using the LAN Interface 47
Using the GPIB Interface 48
Step 3. Verify the oscilloscope connection 49
3 Getting Started
Basic Oscilloscope Program Structure 56
Initializing 56
Capturing Data 56
Analyzing Captured Data 57

8 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
Programming the Oscilloscope 58
Referencing the IO Library 58
Opening the Oscilloscope Connection via the IO Library 59
Initializing the Interface and the Oscilloscope 59
Using :AUToscale to Automate Oscilloscope Setup 60
Using Other Oscilloscope Setup Commands 60
Capturing Data with the :DIGitize Command 61
Reading Query Responses from the Oscilloscope 63
Reading Query Results into String Variables 64
Reading Query Results into Numeric Variables 64
Reading Definite-Length Block Query Response Data 64
Sending Multiple Queries and Reading Results 65
Checking Instrument Status 66
Other Ways of Sending Commands 67
Telnet Sockets 67
Sending SCPI Commands Using Browser Web Control 67
4 Commands Quick Reference
Command Summary 70
Syntax Elements 149
Number Format 149
<NL> (Line Terminator) 149
[ ] (Optional Syntax Terms) 149
{ } (Braces) 149
::= (Defined As) 149
< > (Angle Brackets) 150
... (Ellipsis) 150
n,..,p (Value Ranges) 150
d (Digits) 150
Quoted ASCII String 150
Definite-Length Block Response Data 150
5 Common (*) Commands
*CLS (Clear Status) 157
*ESE (Standard Event Status Enable) 158
*ESR (Standard Event Status Register) 160
*IDN (Identification Number) 162
*LRN (Learn Device Setup) 163
*OPC (Operation Complete) 164
*OPT (Option Identification) 165

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 9
*RCL (Recall) 167
*RST (Reset) 168
*SAV (Save) 171
*SRE (Service Request Enable) 172
*STB (Read Status Byte) 174
*TRG (Trigger) 176
*TST (Self Test) 177
*WAI (Wait To Continue) 178
6 Root (:) Commands
:ACTivity 183
:AER (Arm Event Register) 184
:AUToscale 185
:AUToscale:AMODE 187
:AUToscale:CHANnels 188
:AUToscale:FDEBug 189
:BLANk 190
:DIGitize 191
:MTEenable (Mask Test Event Enable Register) 193
:MTERegister[:EVENt] (Mask Test Event Event Register) 195
:OPEE (Operation Status Enable Register) 197
:OPERegister:CONDition (Operation Status Condition Register) 199
:OPERegister[:EVENt] (Operation Status Event Register) 201
:OVLenable (Overload Event Enable Register) 203
:OVLRegister (Overload Event Register) 205
:PRINt 207
:PWRenable (Power Event Enable Register) 208
:PWRRegister[:EVENt] (Power Event Event Register) 210
:RUN 211
:SERial 212
:SINGle 213
:STATus 214
:STOP 215
:TER (Trigger Event Register) 216
:VIEW 217
7 :ACQuire Commands
:ACQuire:COMPlete 221
:ACQuire:COUNt 222
:ACQuire:MODE 223
:ACQuire:POINts 224

10 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
:ACQuire:SEGMented:ANALyze 225
:ACQuire:SEGMented:COUNt 226
:ACQuire:SEGMented:INDex 227
:ACQuire:SRATe 230
:ACQuire:TYPE 231
8 :BUS<n> Commands
:BUS<n>:BIT<m> 235
:BUS<n>:BITS 236
:BUS<n>:CLEar 238
:BUS<n>:DISPlay 239
:BUS<n>:LABel 240
:BUS<n>:MASK 241
9 :CALibrate Commands
:CALibrate:DATE 245
:CALibrate:LABel 246
:CALibrate:OUTPut 247
:CALibrate:PROTected 248
:CALibrate:STARt 249
:CALibrate:STATus 250
:CALibrate:TEMPerature 251
:CALibrate:TIME 252
10 :CHANnel<n> Commands
:CHANnel<n>:BWLimit 256
:CHANnel<n>:COUPling 257
:CHANnel<n>:DISPlay 258
:CHANnel<n>:IMPedance 259
:CHANnel<n>:INVert 260
:CHANnel<n>:LABel 261
:CHANnel<n>:OFFSet 262
:CHANnel<n>:PROBe 263
:CHANnel<n>:PROBe:HEAD[:TYPE] 264
:CHANnel<n>:PROBe:ID 265
:CHANnel<n>:PROBe:SKEW 266
:CHANnel<n>:PROBe:STYPe 267
:CHANnel<n>:PROTection 268
:CHANnel<n>:RANGe 269
:CHANnel<n>:SCALe 270
:CHANnel<n>:UNITs 271