Agilent Technologies InfiniiVision 4000 X-Series Manual

s1
Agilent InfiniiVision
4000 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 03.10.0000
Edition
February 14, 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®, Windows®, Windows NT®,
MS Windows®, and Windows Vista® are
trademarks or registered trademarks of
Microsoft Corporation in the United States
and/or other countries.

Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide 3
In This Book
This book is your guide to programming the 4000 X- Series oscilloscopes:
The first few chapters describe how to set up and get started:
•Chapter 1, “What's New,” starting on page 33, describes programming
command changes in the latest version of oscilloscope software.
•Chapter 2, “Setting Up,” starting on page 43, describes the steps you
must take before you can program the oscilloscope.
•Chapter 3, “Getting Started,” starting on page 53, 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 67, is a brief
listing of the 4000 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 161, describes
commands defined by the IEEE 488.2 standard that are common to all
instruments.
•Chapter 6, “Root (:) Commands,” starting on page 187, 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 227, describes
commands for setting the parameters used when acquiring and storing
data.
•Chapter 8, “:BUS<n> Commands,” starting on page 243, describes
commands that control all oscilloscope functions associated with the
digital channels bus display.
Table 1 InfiniiVision 4000 X-Series Oscilloscope Models, Bandwidths, Sample Rates
Bandwidth 200 MHz 350 MHz 500 MHz 1 GHz 1.5 GHz
Sample Rate
(interleaved,
non-interleaved)
5GSa/s,
2.5 GSa/s
5GSa/s,
2.5 GSa/s
5GSa/s,
2.5 GSa/s
5GSa/s,
2.5 GSa/s
5GSa/s,
2.5 GSa/s
2-Channel + 16 Logic
Channels MSO
MSO-X 4022A MSO-X 4032A MSO-X 4052A
4-Channel + 16 Logic
Channels MSO
MSO-X 4024A MSO-X 4034A MSO-X 4054A MSO-X 4104A MSO-X 4154A
2-Channel DSO DSO-X 4022A DSO-X 4032A DSO-X 4052A
4-Channel DSO DSO-X 4024A DSO-X 4034A DSO-X 4054A DSO-X 4104A DSO-X 4154A

4 Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
•Chapter 9, “:CALibrate Commands,” starting on page 253, describes
utility commands for determining the state of the calibration factor
protection button.
•Chapter 10, “:CHANnel<n> Commands,” starting on page 263, describes
commands that control all oscilloscope functions associated with
individual analog channels or groups of channels.
•Chapter 12, “:DEMO Commands,” starting on page 293, 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 13, “:DIGital<d> Commands,” starting on page 301, describes
commands that control all oscilloscope functions associated with
individual digital channels.
•Chapter 14, “:DISPlay Commands,” starting on page 309, describes
commands that control how waveforms, graticule, and text are displayed
and written on the screen.
•Chapter 15, “:DVM Commands,” starting on page 323, describes
commands that control the optional DSOXDVM digital voltmeter analysis
feature.
•Chapter 16, “:EXTernal Trigger Commands,” starting on page 331,
describes commands that control the input characteristics of the
external trigger input.
•Chapter 17, “:FUNCtion<m> Commands,” starting on page 337, describes
commands that control math waveforms.
•Chapter 18, “:HARDcopy Commands,” starting on page 369, describes
commands that set and query the selection of hardcopy device and
formatting options.
•Chapter 19, “:LISTer Commands,” starting on page 387, describes
commands that turn on/off the Lister display for decoded serial data
and get the Lister data.
•Chapter 20, “:MARKer Commands,” starting on page 391, 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 21, “:MEASure Commands,” starting on page 407, describes
commands that select automatic measurements (and control markers).
•Chapter 22, “:MEASure Power Commands,” starting on page 485,
describes measurement commands that are available when the
DSOX4PWR power measurements and analysis application is licensed
and enabled.
•Chapter 23, “:MTESt Commands,” starting on page 507, describes
commands that control the mask test features provided with
Option LMT.

Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide 5
•Chapter 24, “:POD Commands,” starting on page 541, describes
commands that control all oscilloscope functions associated with groups
of digital channels.
•Chapter 25, “:POWer Commands,” starting on page 547, describes
commands that control the DSOX4PWR power measurement application.
•Chapter 26, “:RECall Commands,” starting on page 613, describes
commands that recall previously saved oscilloscope setups, reference
waveforms, or masks.
•Chapter 27, “:SAVE Commands,” starting on page 621, describes
commands that save oscilloscope setups, screen images, and data.
•Chapter 28, “:SBUS<n> Commands,” starting on page 645, describes
commands that control oscilloscope functions associated with the serial
decode bus and serial triggering.
•Chapter 29, “:SEARch Commands,” starting on page 817, describes
commands that control oscilloscope functions associated with searching
for waveform events.
•Chapter 30, “:SYSTem Commands,” starting on page 909, describes
commands that control basic system functions of the oscilloscope.
•Chapter 31, “:TIMebase Commands,” starting on page 923, describes
commands that control all horizontal sweep functions.
•Chapter 32, “:TRIGger Commands,” starting on page 935, describes
commands that control the trigger modes and parameters for each
trigger type.
•Chapter 33, “:WAVeform Commands,” starting on page 1019, describes
commands that provide access to waveform data.
•Chapter 34, “:WGEN<w> Commands,” starting on page 1055, describes
commands that control waveform generator (Option WGN) functions and
parameters.
•Chapter 35, “:WMEMory<r> Commands,” starting on page 1099,
describes commands that control reference waveforms.
•Chapter 36, “Obsolete and Discontinued Commands,” starting on page
1109, describes obsolete commands which still work but have been
replaced by newer commands and discontinued commands which are no
longer supported.
•Chapter 37, “Error Messages,” starting on page 1167, 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:

6 Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
•Chapter 38, “Status Reporting,” starting on page 1175, describes the
oscilloscope's status registers and how to check the status of the
instrument.
•Chapter 39, “Synchronizing Acquisitions,” starting on page 1197,
describes how to wait for acquisitions to complete before querying
measurement results or performing other operations with the captured
data.
•Chapter 40, “More About Oscilloscope Commands,” starting on page
1207, contains additional information about oscilloscope programming
commands.
Finally, there is a chapter that contains programming examples:
•Chapter 41, “Programming Examples,” starting on page 1217.
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/4000X- Series- manual"

Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide 7
Contents
In This Book 3
1 What's New
What's New in Version 3.10 34
What's New in Version 3.01 35
Version 3.00 at Introduction 36
Command Differences From 3000 X-Series Oscilloscopes 37
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software 44
Step 2. Connect and set up the oscilloscope 45
Using the USB (Device) Interface 45
Using the LAN Interface 45
Step 3. Verify the oscilloscope connection 47
3 Getting Started
Basic Oscilloscope Program Structure 54
Initializing 54
Capturing Data 54
Analyzing Captured Data 55
Programming the Oscilloscope 56
Referencing the IO Library 56
Opening the Oscilloscope Connection via the IO Library 57
Initializing the Interface and the Oscilloscope 57
Using :AUToscale to Automate Oscilloscope Setup 58
Using Other Oscilloscope Setup Commands 58
Capturing Data with the :DIGitize Command 59
Reading Query Responses from the Oscilloscope 61
Reading Query Results into String Variables 62
Reading Query Results into Numeric Variables 62
Reading Definite-Length Block Query Response Data 62
Sending Multiple Queries and Reading Results 63
Checking Instrument Status 64

8 Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
Other Ways of Sending Commands 65
Telnet Sockets 65
Sending SCPI Commands Using Browser Web Control 65
4 Commands Quick Reference
Command Summary 68
Syntax Elements 158
Number Format 158
<NL> (Line Terminator) 158
[ ] (Optional Syntax Terms) 158
{ } (Braces) 158
::= (Defined As) 158
< > (Angle Brackets) 159
... (Ellipsis) 159
n,..,p (Value Ranges) 159
d (Digits) 159
Quoted ASCII String 159
Definite-Length Block Response Data 159
5 Common (*) Commands
*CLS (Clear Status) 165
*ESE (Standard Event Status Enable) 166
*ESR (Standard Event Status Register) 168
*IDN (Identification Number) 170
*LRN (Learn Device Setup) 171
*OPC (Operation Complete) 172
*OPT (Option Identification) 173
*RCL (Recall) 175
*RST (Reset) 176
*SAV (Save) 179
*SRE (Service Request Enable) 180
*STB (Read Status Byte) 182
*TRG (Trigger) 184
*TST (Self Test) 185
*WAI (Wait To Continue) 186
6 Root (:) Commands
:ACTivity 191
:AER (Arm Event Register) 192
:AUToscale 193
:AUToscale:AMODE 195

Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide 9
:AUToscale:CHANnels 196
:AUToscale:FDEBug 197
:BLANk 198
:DIGitize 199
:HWEenable (Hardware Event Enable Register) 201
:HWERegister:CONDition (Hardware Event Condition Register) 203
:HWERegister[:EVENt] (Hardware Event Event Register) 204
:MTEenable (Mask Test Event Enable Register) 205
:MTERegister[:EVENt] (Mask Test Event Event Register) 207
:OPEE (Operation Status Enable Register) 209
:OPERegister:CONDition (Operation Status Condition Register) 211
:OPERegister[:EVENt] (Operation Status Event Register) 213
:OVLenable (Overload Event Enable Register) 215
:OVLRegister (Overload Event Register) 217
:PRINt 219
:RUN 220
:SERial 221
:SINGle 222
:STATus 223
:STOP 224
:TER (Trigger Event Register) 225
:VIEW 226
7 :ACQuire Commands
:ACQuire:COMPlete 229
:ACQuire:COUNt 230
:ACQuire:MODE 231
:ACQuire:POINts 232
:ACQuire:RSIGnal 233
:ACQuire:SEGMented:ANALyze 234
:ACQuire:SEGMented:COUNt 235
:ACQuire:SEGMented:INDex 236
:ACQuire:SRATe 239
:ACQuire:TYPE 240
8 :BUS<n> Commands
:BUS<n>:BIT<m> 245
:BUS<n>:BITS 246
:BUS<n>:CLEar 248
:BUS<n>:DISPlay 249
:BUS<n>:LABel 250

10 Agilent InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
:BUS<n>:MASK 251
9 :CALibrate Commands
:CALibrate:DATE 255
:CALibrate:LABel 256
:CALibrate:OUTPut 257
:CALibrate:PROTected 258
:CALibrate:STARt 259
:CALibrate:STATus 260
:CALibrate:TEMPerature 261
:CALibrate:TIME 262
10 :CHANnel<n> Commands
:CHANnel<n>:BWLimit 266
:CHANnel<n>:COUPling 267
:CHANnel<n>:DISPlay 268
:CHANnel<n>:IMPedance 269
:CHANnel<n>:INVert 270
:CHANnel<n>:LABel 271
:CHANnel<n>:OFFSet 272
:CHANnel<n>:PROBe 273
:CHANnel<n>:PROBe:HEAD[:TYPE] 274
:CHANnel<n>:PROBe:ID 275
:CHANnel<n>:PROBe:SKEW 276
:CHANnel<n>:PROBe:STYPe 277
:CHANnel<n>:PROTection 278
:CHANnel<n>:RANGe 279
:CHANnel<n>:SCALe 280
:CHANnel<n>:UNITs 281
:CHANnel<n>:VERNier 282
11 :COMPliance Commands
:COMPliance:USB:AUTosetup 284
:COMPliance:USB:RUN 285
:COMPliance:USB:SOURce:ADJacent 286
:COMPliance:USB:SOURce:DIFFerential 287
:COMPliance:USB:SOURce:DMINus 288
:COMPliance:USB:SOURce:DPLus 289
:COMPliance:USB:TEST 290
:COMPliance:USB:TEST:CONNection 291
:COMPliance:USB:TEST:TYPE 292