Agilent Technologies Infiniium 90000 Q-Series Manual

s1
Agilent Infiniium
90000 Series
Oscilloscopes
Programmer's Reference

Notices
© Agilent Technologies, Inc. 2007-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 04.50.0000
Edition
May 28, 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 Infiniium 90000 Series Oscilloscopes Programmer's Reference 3
In This Book
This book is your guide to programming the Infiniium 90000 Series
oscilloscopes These oscilloscopes include the 90000A Series, the
90000 X- Series, and the 90000 Q- Series.
Chapter 1, “What's New,” starting on page 29, 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 control the oscilloscope with remote programs.
The next several chapters give you an introduction to programming the
oscilloscopes, along with necessary conceptual information. These chapters
describe basic program communications, interface, syntax, data types, and
status reporting:
•Chapter 3, “Introduction to Programming,” starting on page 51
•Chapter 4, “LAN, USB, and GPIB Interfaces,” starting on page 87
•Chapter 5, “Message Communication and System Functions,” starting on
page 99
•Chapter 6, “Status Reporting,” starting on page 103
•Chapter 7, “Remote Acquisition Synchronization,” starting on page 127
•Chapter 8, “Programming Conventions,” starting on page 137
The next chapters describe the commands used to program the
oscilloscopes. Each chapter describes the set of commands that belong to
an individual subsystem, and explains the function of each command.
•Chapter 9, “Acquire Commands,” starting on page 147
•Chapter 10, “Bus Commands,” starting on page 175
•Chapter 11, “Calibration Commands,” starting on page 185
•Chapter 12, “Channel Commands,” starting on page 191
•Chapter 13, “Common Commands,” starting on page 245
•Chapter 14, “Digital Commands,” starting on page 269
•Chapter 15, “Disk Commands,” starting on page 275
•Chapter 16, “Display Commands,” starting on page 293
•Chapter 17, “Function Commands,” starting on page 319
•Chapter 18, “Hardcopy Commands,” starting on page 365
•Chapter 19, “Histogram Commands,” starting on page 371
•Chapter 20, “InfiniiScan (ISCan) Commands,” starting on page 383
•Chapter 21, “Limit Test Commands,” starting on page 405
•Chapter 22, “Lister Commands,” starting on page 413
•Chapter 23, “Marker Commands,” starting on page 417
•Chapter 24, “Mask Test Commands,” starting on page 429

4 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
•Chapter 25, “Measure Commands,” starting on page 473
•Chapter 26, “Pod Commands,” starting on page 697
•Chapter 27, “Root Level Commands,” starting on page 703
•Chapter 28, “Serial Bus Commands,” starting on page 737
•Chapter 29, “Self- Test Commands,” starting on page 757
•Chapter 30, “Serial Data Equalization Commands,” starting on page 761
•Chapter 31, “System Commands,” starting on page 805
•Chapter 32, “Time Base Commands,” starting on page 819
•Chapter 33, “Trigger Commands,” starting on page 831
•Chapter 34, “Waveform Commands,” starting on page 931
•Chapter 35, “Waveform Memory Commands,” starting on page 991
Chapter 36, “Obsolete and Discontinued Commands,” starting on page
1001, describes obsolete (deprecated) commands that still work but have
been replaced by newer commands, and lists discontinued commands that
are no longer supported.
Chapter 37, “Error Messages,” starting on page 1007, describes error
messages.
Chapter 38, “Sample Programs,” starting on page 1019, shows example
programs in various languages using the VISA COM, VISA, and SICL
libraries.
Finally, Chapter 39, “Reference,” starting on page 1151, contains file
format descriptions.
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/Infiniium- manuals"

Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 5
Contents
In This Book 3
1 What's New
What's New in Version 4.50 30
What's New in Version 4.30 33
What's New in Version 4.20 34
What's New in Version 4.10 35
What's New in Version 4.00 36
What's New in Version 3.50 37
What's New in Version 3.20 39
What's New in Version 3.11 40
What's New in Version 3.10 41
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
Using the GPIB Interface 45
Step 3. Verify the oscilloscope connection 46
3 Introduction to Programming
Communicating with the Oscilloscope 53
Instructions 54
Instruction Header 55
White Space (Separator) 56
Braces 57
Ellipsis 58
Square Brackets 59
Command and Query Sources 60

6 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
Program Data 61
Header Types 62
Simple Command Header 62
Compound Command Header 62
Combining Commands in the Same Subsystem 63
Common Command Header 63
Duplicate Mnemonics 63
Query Headers 64
Program Header Options 65
Character Program Data 66
Numeric Program Data 67
Embedded Strings 68
Program Message Terminator 69
Common Commands within a Subsystem 70
Selecting Multiple Subsystems 71
Programming Getting Started 72
Referencing the IO Library 73
Opening the Oscilloscope Connection via the IO Library 74
Initializing the Interface and the Oscilloscope 75
Autoscale 75
Setting Up the Oscilloscope 76
Example Program 77
Using the DIGITIZE Command 78
Receiving Information from the Oscilloscope 80
String Variable Example 81
Numeric Variable Example 82
Definite-Length Block Response Data 83
Multiple Queries 84
Oscilloscope Status 85
4 LAN, USB, and GPIB Interfaces
LAN Interface Connector 88
GPIB Interface Connector 89
Default Startup Conditions 90

Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 7
Interface Capabilities 91
GPIB Command and Data Concepts 92
Communicating Over the GPIB Interface 93
Interface Select Code 93
Oscilloscope Address 93
Communicating Over the LAN Interface 94
Communicating via Telnet and Sockets 96
Telnet 96
Sockets 96
Bus Commands 98
Device Clear 98
Group Execute Trigger 98
Interface Clear 98
5 Message Communication and System Functions
Protocols 100
Functional Elements 100
Protocol Overview 100
Protocol Operation 101
Protocol Exceptions 101
Suffix Multiplier 101
Suffix Unit 102
6 Status Reporting
Status Reporting Data Structures 106
Status Byte Register 108
Service Request Enable Register 110
Message Event Register 111
Trigger Event Register 112
Standard Event Status Register 113
Standard Event Status Enable Register 114
Operation Status Register 115
Operation Status Enable Register 116
Mask Test Event Register 117
Mask Test Event Enable Register 118
Acquisition Done Event Register 119

8 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
Process Done Event Register 120
Trigger Armed Event Register 121
Auto Trigger Event Register 122
Error Queue 123
Output Queue 124
Message Queue 125
Clearing Registers and Queues 126
7 Remote Acquisition Synchronization
Programming Flow 128
Setting Up the Oscilloscope 129
Acquiring a Waveform 130
Retrieving Results 131
Acquisition Synchronization 132
Blocking Synchronization 132
Polling Synchronization With Timeout 132
Single Shot Device Under Test (DUT) 134
Averaging Acquisition Synchronization 136
8 Programming Conventions
Truncation Rule 138
The Command Tree 139
Command Types 139
Tree Traversal Rules 139
Tree Traversal Examples 140
Infinity Representation 142
Sequential and Overlapped Commands 143
Response Generation 144
EOI 145
9 Acquire Commands
:ACQuire:AVERage 148
:ACQuire[:AVERage]:COUNt 149
:ACQuire:BANDwidth 150
:ACQuire:COMPlete 152

Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 9
:ACQuire:COMPlete:STATe 154
:ACQuire:HRESolution 155
:ACQuire:INTerpolate 156
:ACQuire:MODE 157
:ACQuire:POINts[:ANALog] 159
:ACQuire:POINts:AUTO 163
:ACQuire:POINts:DIGital? 164
:ACQuire:REDGe 165
:ACQuire:RESPonse 166
:ACQuire:SEGMented:COUNt 167
:ACQuire:SEGMented:INDex 168
:ACQuire:SEGMented:TTAGs 169
:ACQuire:SRATe[:ANALog] 170
:ACQuire:SRATe[:ANALog]:AUTO 172
:ACQuire:SRATe:DIGital 173
:ACQuire:SRATe:DIGital:AUTO 174
10 Bus Commands
:BUS:B<N>:TYPE 176
:BUS<N>:BIT<M> 177
:BUS<N>:BITS 178
:BUS<N>:CLEar 179
:BUS<N>:CLOCk 180
:BUS<N>:CLOCk:SLOPe 181
:BUS<N>:DISPlay 182
:BUS<N>:LABel 183
:BUS<N>:READout 184
11 Calibration Commands
:CALibrate:OUTPut 187
:CALibrate:SKEW 188
:CALibrate:STATus? 189
12 Channel Commands
:CHANnel<N>:COMMonmode 193
:CHANnel<N>:DIFFerential 194
:CHANnel<N>:DIFFerential:SKEW 195
:CHANnel<N>:DISPlay 196
:CHANnel<N>:DISPlay:AUTO 197
:CHANnel<N>:DISPlay:OFFSet 198
:CHANnel<N>:DISPlay:RANGe 199

10 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
:CHANnel<N>:DISPlay:SCALe 200
:CHANnel<N>:INPut 201
:CHANnel<N>:ISIM:APPLy 202
:CHANnel<N>:ISIM:BANDwidth 203
:CHANnel<N>:ISIM:BWLimit 204
:CHANnel<N>:ISIM:CONVolve 205
:CHANnel<N>:ISIM:CORRection 206
:CHANnel<N>:ISIM:DEConvolve 208
:CHANnel<N>:ISIM:DELay 209
:CHANnel<N>:ISIM:PEXTraction 210
:CHANnel<N>:ISIM:SPAN 212
:CHANnel<N>:ISIM:STATe 213
:CHANnel<N>:LABel 214
:CHANnel<N>:OFFSet 215
:CHANnel<N>:PROBe 216
:CHANnel<N>:PROBe:ACCAL 217
:CHANnel<N>:PROBe:ATTenuation 218
:CHANnel<N>:PROBe:AUTozero 219
:CHANnel<N>:PROBe:COUPling 220
:CHANnel<N>:PROBe:EADapter 221
:CHANnel<N>:PROBe:ECOupling 223
:CHANnel<N>:PROBe:EXTernal 224
:CHANnel<N>:PROBe:EXTernal:GAIN 225
:CHANnel<N>:PROBe:EXTernal:OFFSet 226
:CHANnel<N>:PROBe:EXTernal:UNITs 227
:CHANnel<N>:PROBe:GAIN 228
:CHANnel<N>:PROBe:HEAD:ADD 229
:CHANnel<N>:PROBe:HEAD:DELete ALL 230
:CHANnel<N>:PROBe:HEAD:SELect 231
:CHANnel<N>:PROBe:HEAD:VTERm 232
:CHANnel<N>:PROBe:ID? 233
:CHANnel<N>:PROBe:MODE 234
:CHANnel<N>:PROBe:PRECprobe:BANDwidth 235
:CHANnel<N>:PROBe:PRECprobe:CALibration 236
:CHANnel<N>:PROBe:PRECprobe:MODE 237
:CHANnel<N>:PROBe:PRECprobe:ZSRC 238
:CHANnel<N>:PROBe:SKEW 240
:CHANnel<N>:PROBe:STYPe 241
:CHANnel<N>:RANGe 242
:CHANnel<N>:SCALe 243
:CHANnel<N>:UNITs 244