Agilent Technologies InfiniiVision 5000 Series Manual

A
Agilent InfiniiVision
5000 Series
Oscilloscopes
Programmer's Guide

Notices
© Agilent Technologies, Inc. 2007-2008
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 05.15.0000
Edition
July 31, 2008
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 5000 Series Oscilloscopes Programmer's Guide 3
In This Book
This book is your guide to programming the 5000 Series oscilloscopes:
The first few chapters describe how to set up and get started:
•Chapter 1, "What's New" on page 19, describes programming command
changes in the latest version of oscilloscope software.
•Chapter 2, "Setting Up" on page 27, describes the steps you must take
before you can program the oscilloscope.
•Chapter 3, "Getting Started" on page 37, 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" on page 51, is a brief listing of
the 5000 Series oscilloscope commands and syntax.
The next chapters provide reference information:
•Chapter 5, "Commands by Subsystem" on page 89, 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, "Commands A- Z" on page 477, contains an alphabetical
listing of all command elements.
•Chapter 7, "Obsolete and Discontinued Commands" on page 501,
describes obsolete commands which still work but have been replaced
by newer commands and discontinued commands which are no longer
supported.
•Chapter 8, "Error Messages" on page 545, 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, "Status Reporting" on page 553, describes the oscilloscope's
status registers and how to check the status of the instrument.
Table 1 InfiniiVision 5000 Series Oscilloscope Models
Channels Input Bandwidth (Maximum Sample Rate)
500 MHz (4 GSa/s) 300 MHz (2 GSa/s) 100 MHz (2 GSa/s)
4 analog DSO5054A DSO5034A DSO5014A
2 analog DSO5052A DSO5032A DSO5012A

4 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
•Chapter 10, "Synchronizing Acquisitions" on page 575, describes how to
wait for acquisitions to complete before querying measurement results
or performing other operations with the captured data.
•Chapter 11, "More About Oscilloscope Commands" on page 585, contains
additional information about oscilloscope programming commands.
Finally, there is a chapter that contains programming examples:
•Chapter 12, "Programming Examples" on page 607.
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/5000manual"

Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 5
Contents
In This Book 3
1 What's New
What's New in Version 5.15 20
What's New in Version 5.10 22
What's New in Version 5.00 23
What's New in Version 4.10 25
Version 4.00 at Introduction 26
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software 28
Step 2. Connect and set up the oscilloscope 29
Using the USB (Device) Interface 29
Using the LAN Interface 29
Using the GPIB Interface 30
Step 3. Verify the oscilloscope connection 31
3 Getting Started
Basic Oscilloscope Program Structure 38
Initializing 38
Capturing Data 38
Analyzing Captured Data 39

6 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Programming the Oscilloscope 40
Referencing the IO Library 40
Opening the Oscilloscope Connection via the IO Library 41
Initializing the Interface and the Oscilloscope 41
Using :AUToscale to Automate Oscilloscope Setup 42
Using Other Oscilloscope Setup Commands 42
Capturing Data with the :DIGitize Command 43
Reading Query Responses from the Oscilloscope 45
Reading Query Results into String Variables 46
Reading Query Results into Numeric Variables 46
Reading Definite-Length Block Query Response Data 46
Sending Multiple Queries and Reading Results 47
Checking Instrument Status 48
Other Ways of Sending Commands 49
Telnet Sockets 49
Sending SCPI Commands Using Browser Web Control 49
4 Commands Quick Reference
Command Summary 52
Syntax Elements 85
Number Format 85
<NL> (Line Terminator) 85
[ ] (Optional Syntax Terms) 85
{ } (Braces) 85
::= (Defined As) 85
< > (Angle Brackets) 86
... (Ellipsis) 86
n,..,p (Value Ranges) 86
d (Digits) 86
Quoted ASCII String 86
Definite-Length Block Response Data 86
5 Commands by Subsystem
Common (*) Commands 91
*CLS (Clear Status) 95
*ESE (Standard Event Status Enable) 96
*ESR (Standard Event Status Register) 98
*IDN (Identification Number) 100
*LRN (Learn Device Setup) 101
*OPC (Operation Complete) 102

Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 7
*OPT (Option Identification) 103
*RCL (Recall) 104
*RST (Reset) 105
*SAV (Save) 108
*SRE (Service Request Enable) 109
*STB (Read Status Byte) 111
*TRG (Trigger) 113
*TST (Self Test) 114
*WAI (Wait To Continue) 115
Root (:) Commands 116
:AER (Arm Event Register) 119
:AUToscale 120
:AUToscale:AMODE 122
:AUToscale:CHANnels 123
:BLANk 124
:CDISplay 125
:DIGitize 126
:HWEenable (Hardware Event Enable Register) 128
:HWERegister:CONDition (Hardware Event Condition Register) 130
:HWERegister[:EVENt] (Hardware Event Event Register) 132
:MERGe 134
:OPEE (Operation Status Enable Register) 135
:OPERegister:CONDition (Operation Status Condition Register) 137
:OPERegister[:EVENt] (Operation Status Event Register) 139
:OVLenable (Overload Event Enable Register) 141
:OVLRegister (Overload Event Register) 143
:PRINt 145
:RUN 146
:SERial 147
:SINGle 148
:STATus 149
:STOP 150
:TER (Trigger Event Register) 151
:VIEW 152
:ACQuire Commands 153
:ACQuire:AALias 155
:ACQuire:COMPlete 156
:ACQuire:COUNt 157
:ACQuire:DAALias 158
:ACQuire:MODE 159
:ACQuire:POINts 160

8 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:ACQuire:SEGMented:COUNt 161
:ACQuire:SEGMented:INDex 162
:ACQuire:SRATe 164
:ACQuire:TYPE 165
:CALibrate Commands 167
:CALibrate:DATE 168
:CALibrate:LABel 169
:CALibrate:STARt 170
:CALibrate:STATus 171
:CALibrate:SWITch 172
:CALibrate:TEMPerature 173
:CALibrate:TIME 174
:CHANnel<n> Commands 175
:CHANnel<n>:BWLimit 178
:CHANnel<n>:COUPling 179
:CHANnel<n>:DISPlay 180
:CHANnel<n>:IMPedance 181
:CHANnel<n>:INVert 182
:CHANnel<n>:LABel 183
:CHANnel<n>:OFFSet 184
:CHANnel<n>:PROBe 185
:CHANnel<n>:PROBe:ID 186
:CHANnel<n>:PROBe:SKEW 187
:CHANnel<n>:PROBe:STYPe 188
:CHANnel<n>:PROTection 189
:CHANnel<n>:RANGe 190
:CHANnel<n>:SCALe 191
:CHANnel<n>:UNITs 192
:CHANnel<n>:VERNier 193
:DISPlay Commands 194
:DISPlay:CLEar 196
:DISPlay:DATA 197
:DISPlay:LABel 199
:DISPlay:LABList 200
:DISPlay:PERSistence 201
:DISPlay:SOURce 202
:DISPlay:VECTors 203
:EXTernal Trigger Commands 204
:EXTernal:BWLimit 206
:EXTernal:IMPedance 207

Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 9
:EXTernal:PROBe 208
:EXTernal:PROBe:ID 209
:EXTernal:PROBe:STYPe 210
:EXTernal:PROTection 211
:EXTernal:RANGe 212
:EXTernal:UNITs 213
:FUNCtion Commands 214
:FUNCtion:CENTer 217
:FUNCtion:DISPlay 218
:FUNCtion:GOFT:OPERation 219
:FUNCtion:GOFT:SOURce1 220
:FUNCtion:GOFT:SOURce2 221
:FUNCtion:OFFSet 222
:FUNCtion:OPERation 223
:FUNCtion:RANGe 224
:FUNCtion:REFerence 225
:FUNCtion:SCALe 226
:FUNCtion:SOURce1 227
:FUNCtion:SOURce2 228
:FUNCtion:SPAN 229
:FUNCtion:WINDow 230
:HARDcopy Commands 231
:HARDcopy:AREA 233
:HARDcopy:APRinter 234
:HARDcopy:FACTors 235
:HARDcopy:FFEed 236
:HARDcopy:INKSaver 237
:HARDcopy:PALette 238
:HARDcopy:PRinter:LIST 239
:HARDcopy:STARt 240
:MARKer Commands 241
:MARKer:MODE 243
:MARKer:X1Position 244
:MARKer:X1Y1source 245
:MARKer:X2Position 246
:MARKer:X2Y2source 247
:MARKer:XDELta 248
:MARKer:Y1Position 249
:MARKer:Y2Position 250
:MARKer:YDELta 251

10 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:MEASure Commands 252
:MEASure:CLEar 259
:MEASure:COUNter 260
:MEASure:DEFine 261
:MEASure:DELay 264
:MEASure:DUTYcycle 266
:MEASure:FALLtime 267
:MEASure:FREQuency 268
:MEASure:NWIDth 269
:MEASure:OVERshoot 270
:MEASure:PERiod 272
:MEASure:PHASe 273
:MEASure:PREShoot 274
:MEASure:PWIDth 275
:MEASure:RISetime 276
:MEASure:SDEViation 277
:MEASure:SHOW 278
:MEASure:SOURce 279
:MEASure:TEDGe 281
:MEASure:TVALue 283
:MEASure:VAMPlitude 285
:MEASure:VAVerage 286
:MEASure:VBASe 287
:MEASure:VMAX 288
:MEASure:VMIN 289
:MEASure:VPP 290
:MEASure:VRATio 291
:MEASure:VRMS 292
:MEASure:VTIMe 293
:MEASure:VTOP 294
:MEASure:XMAX 295
:MEASure:XMIN 296
:RECall Commands 297
:RECall:FILename 298
:RECall:IMAGe[:STARt] 299
:RECall:PWD 300
:RECall:SETup[:STARt] 301
:SAVE Commands 302
:SAVE:FILename 304
:SAVE:IMAGe[:STARt] 305
:SAVE:IMAGe:AREA 306