Agilent Technologies InfiniiVision 2000 X-Series Manual

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

Notices
© Agilent Technologies, Inc. 2005-2013
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.30.0000
Edition
April 5, 2013
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 2000 X-Series Oscilloscopes Programmer's Guide 3
In This Book
This book is your guide to programming the 2000 X- Series oscilloscopes:
The first few chapters describe how to set up and get started:
•Chapter 1, “What's New,” starting on page 25, describes programming
command changes in the latest version of oscilloscope software.
•Chapter 2, “Setting Up,” starting on page 39, describes the steps you
must take before you can program the oscilloscope.
•Chapter 3, “Getting Started,” starting on page 49, 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 63, is a brief
listing of the 2000 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 121, describes
commands defined by the IEEE 488.2 standard that are common to all
instruments.
•Chapter 6, “Root (:) Commands,” starting on page 147, 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 183, describes
commands for setting the parameters used when acquiring and storing
data.
•Chapter 8, “:BUS<n> Commands,” starting on page 197, describes
commands that control all oscilloscope functions associated with the
digital channels bus display.
•Chapter 9, “:CALibrate Commands,” starting on page 207, describes
utility commands for determining the state of the calibration factor
protection button.
Table 1 InfiniiVision 2000 X-Series Oscilloscope Models
Channels Input Bandwidth
70 MHz 100 MHz 200 MHz
4 analog + 8 digital
(mixed signal)
MSO-X 2004A MSO-X 2014A MSO-X 2024A
2 analog + 8 digital
(mixed signal)
MSO-X 2002A MSO-X 2012A MSO-X 2022A
4 analog DSO-X 2004A DSO-X 2014A DSO-X 2024A
2 analog DSO-X 2002A DSO-X 2012A DSO-X 2022A

4 Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide
•Chapter 10, “:CHANnel<n> Commands,” starting on page 217, describes
commands that control all oscilloscope functions associated with
individual analog channels or groups of channels.
•Chapter 11, “:DEMO Commands,” starting on page 237, 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 243, describes
commands that control all oscilloscope functions associated with
individual digital channels.
•Chapter 13, “:DISPlay Commands,” starting on page 251, describes
commands that control how waveforms, graticule, and text are displayed
and written on the screen.
•Chapter 14, “:DVM Commands,” starting on page 263, describes
commands that control the optional DSOXDVM digital voltmeter analysis
feature.
•Chapter 15, “:EXTernal Trigger Commands,” starting on page 271,
describes commands that control the input characteristics of the
external trigger input.
•Chapter 16, “:FUNCtion Commands,” starting on page 277, describes
commands that control math waveforms.
•Chapter 17, “:HARDcopy Commands,” starting on page 295, describes
commands that set and query the selection of hardcopy device and
formatting options.
•Chapter 18, “:LISTer Commands,” starting on page 313, describes
commands that turn on/off the Lister display for decoded serial data
and get the Lister data.
•Chapter 19, “:MARKer Commands,” starting on page 317, 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 20, “:MEASure Commands,” starting on page 333, describes
commands that select automatic measurements (and control markers).
•Chapter 21, “:MTESt Commands,” starting on page 377, describes
commands that control the mask test features provided with
Option LMT.
•Chapter 22, “:POD Commands,” starting on page 411, describes
commands that control all oscilloscope functions associated with groups
of digital channels.
•Chapter 23, “:RECall Commands,” starting on page 417, describes
commands that recall previously saved oscilloscope setups, reference
waveforms, or masks.
•Chapter 24, “:SAVE Commands,” starting on page 425, describes
commands that save oscilloscope setups, screen images, and data.

Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide 5
•Chapter 25, “:SBUS<n> Commands,” starting on page 447, describes
commands that control oscilloscope functions associated with the serial
decode bus and serial triggering.
•Chapter 26, “:SEARch Commands,” starting on page 531, describes
commands that control oscilloscope functions associated with searching
for waveform events.
•Chapter 27, “:SYSTem Commands,” starting on page 563, describes
commands that control basic system functions of the oscilloscope.
•Chapter 28, “:TIMebase Commands,” starting on page 577, describes
commands that control all horizontal sweep functions.
•Chapter 29, “:TRIGger Commands,” starting on page 589, describes
commands that control the trigger modes and parameters for each
trigger type.
•Chapter 30, “:WAVeform Commands,” starting on page 627, describes
commands that provide access to waveform data.
•Chapter 31, “:WGEN Commands,” starting on page 663, describes
commands that control waveform generator (Option WGN) functions and
parameters.
•Chapter 32, “:WMEMory<r> Commands,” starting on page 693, describes
commands that control reference waveforms.
•Chapter 33, “Obsolete and Discontinued Commands,” starting on page
703, describes obsolete commands which still work but have been
replaced by newer commands and discontinued commands which are no
longer supported.
•Chapter 34, “Error Messages,” starting on page 751, 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 35, “Status Reporting,” starting on page 759, describes the
oscilloscope's status registers and how to check the status of the
instrument.
•Chapter 36, “Synchronizing Acquisitions,” starting on page 779,
describes how to wait for acquisitions to complete before querying
measurement results or performing other operations with the captured
data.
•Chapter 37, “More About Oscilloscope Commands,” starting on page 789,
contains additional information about oscilloscope programming
commands.
Finally, there is a chapter that contains programming examples:

6 Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide
•Chapter 38, “Programming Examples,” starting on page 799.
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/2000X- Series- manual"

Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide 7
Contents
In This Book 3
1 What's New
What's New in Version 2.30 26
What's New in Version 2.20 28
What's New in Version 2.10 30
What's New in Version 2.00 31
What's New in Version 1.20 32
What's New in Version 1.10 33
Version 1.00 at Introduction 34
Command Differences From 7000B Series Oscilloscopes 35
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software 40
Step 2. Connect and set up the oscilloscope 41
Using the USB (Device) Interface 41
Using the LAN Interface 41
Using the GPIB Interface 42
Step 3. Verify the oscilloscope connection 43
3 Getting Started
Basic Oscilloscope Program Structure 50
Initializing 50
Capturing Data 50
Analyzing Captured Data 51

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

Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide 9
*RCL (Recall) 135
*RST (Reset) 136
*SAV (Save) 139
*SRE (Service Request Enable) 140
*STB (Read Status Byte) 142
*TRG (Trigger) 144
*TST (Self Test) 145
*WAI (Wait To Continue) 146
6 Root (:) Commands
:ACTivity 151
:AER (Arm Event Register) 152
:AUToscale 153
:AUToscale:AMODE 155
:AUToscale:CHANnels 156
:AUToscale:FDEBug 157
:BLANk 158
:DIGitize 159
:MTEenable (Mask Test Event Enable Register) 161
:MTERegister[:EVENt] (Mask Test Event Event Register) 163
:OPEE (Operation Status Enable Register) 165
:OPERegister:CONDition (Operation Status Condition Register) 167
:OPERegister[:EVENt] (Operation Status Event Register) 169
:OVLenable (Overload Event Enable Register) 171
:OVLRegister (Overload Event Register) 173
:PRINt 175
:RUN 176
:SERial 177
:SINGle 178
:STATus 179
:STOP 180
:TER (Trigger Event Register) 181
:VIEW 182
7 :ACQuire Commands
:ACQuire:COMPlete 185
:ACQuire:COUNt 186
:ACQuire:MODE 187
:ACQuire:POINts 188
:ACQuire:SEGMented:ANALyze 189
:ACQuire:SEGMented:COUNt 190

10 Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide
:ACQuire:SEGMented:INDex 191
:ACQuire:SRATe 194
:ACQuire:TYPE 195
8 :BUS<n> Commands
:BUS<n>:BIT<m> 199
:BUS<n>:BITS 200
:BUS<n>:CLEar 202
:BUS<n>:DISPlay 203
:BUS<n>:LABel 204
:BUS<n>:MASK 205
9 :CALibrate Commands
:CALibrate:DATE 209
:CALibrate:LABel 210
:CALibrate:OUTPut 211
:CALibrate:PROTected 212
:CALibrate:STARt 213
:CALibrate:STATus 214
:CALibrate:TEMPerature 215
:CALibrate:TIME 216
10 :CHANnel<n> Commands
: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
:CHANnel<n>:SCALe 234
:CHANnel<n>:UNITs 235
:CHANnel<n>:VERNier 236