Agilent Technologies InfiniiVision MSO6102A User manual

A
Agilent 6000 Series
Oscilloscopes
Programmer's Reference

Notices
© Agilent Technologies, Inc. 2005-2007
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.10.0002
Edition
July 23, 2007
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 6000 Series Oscilloscopes Programmer's Reference 3
In This Book
This programmer's reference gives detailed information on all the
commands available for controlling these oscilloscope models:
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.
Command arguments and syntax are described for each command. Some
command descriptions have example code.
•"What's New" on page 17
•"Commands Quick Reference" on page 31
•"Commands by Subsystem" on page 73
•"Commands A- Z" on page 469
•"Obsolete and Discontinued Commands" on page 491
•"Error Messages" on page 533
•"Status Reporting" on page 541
•"More About Oscilloscope Commands" on page 563
•"Programming Examples" on page 585
See the Agilent 6000 Series Oscilloscopes Programmer's Quick Start
Guide for information on installing the IO libraries, connecting the
oscilloscope to the controller PC, and getting started with oscilloscope
programming.
See your oscilloscope's User's Guide for more information on front- panel
operation.
Table 1 6000 Series Oscilloscope Models
Channels Input Bandwidth
1 GHz 500 MHz 300 MHz 100 MHz
4 analog + 16
digital
(mixed-signal)
MSO6104A/L MSO6054A/L MSO6034A MSO6014A/L
2 analog + 16
digital
(mixed-signal)
MSO6102A MSO6052A MSO6032A MSO6012A
4 analog DSO6104A/L DSO6054A/L DSO6034A DSO6014A/L
2 analog DSO6102A DSO6052A DSO6032A DSO6012A

4 Agilent 6000 Series Oscilloscopes Programmer's Reference
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.
Example
Programs
The example programs are designed to work with multiple 6000 Series
oscilloscopes. Therefore, the commands may not match the example code
exactly, but the example code should run because of the designed- in
backward compatibility with earlier commands.

Agilent 6000 Series Oscilloscopes Programmer's Reference 5
Contents
In This Book 3
1 What's New
What's New in Version 4.10 18
What's New in Version 4.00 20
What's New in Version 3.50 22
What's New in Version 3.00 24
Command Differences From 54620/54640 Series Oscilloscopes 26
2 Commands Quick Reference
Command Summary 32
Syntax Elements 70
Number Format 70
<NL> (Line Terminator) 70
[ ] (Optional Syntax Terms) 70
{ } (Braces) 70
::= (Defined As) 70
< > (Angle Brackets) 71
... (Ellipsis) 71
n,..,p (Value Ranges) 71
d (Digits) 71
Quoted ASCII String 71
Definite-Length Block Response Data 71
3 Commands by Subsystem
Common (*) Commands 75
*CLS (Clear Status) 79
*ESE (Standard Event Status Enable) 80
*ESR (Standard Event Status Register) 82
*IDN (Identification Number) 84
*LRN (Learn Device Setup) 85
*OPC (Operation Complete) 86
*OPT (Option Identification) 87
*RCL (Recall) 88

6 Agilent 6000 Series Oscilloscopes Programmer's Reference
*RST (Reset) 89
*SAV (Save) 92
*SRE (Service Request Enable) 93
*STB (Read Status Byte) 95
*TRG (Trigger) 97
*TST (Self Test) 98
*WAI (Wait To Continue) 99
Root (:) Commands 100
:ACTivity 103
:AER (Arm Event Register) 104
:AUToscale 105
:AUToscale:AMODE 107
:AUToscale:CHANnels 108
:BLANk 109
:CDISplay 110
:DIGitize 111
:HWEenable (Hardware Event Enable Register) 113
:HWERegister:CONDition (Hardware Event Condition Register) 115
:HWERegister[:EVENt] (Hardware Event Event Register) 117
:MERGe 119
:OPEE (Operation Status Enable Register) 120
:OPERegister:CONDition (Operation Status Condition Register) 122
:OPERegister[:EVENt] (Operation Status Event Register) 124
:OVLenable (Overload Event Enable Register) 126
:OVLRegister (Overload Event Register) 128
:PRINt 130
:RUN 131
:SERial 132
:SINGle 133
:STATus 134
:STOP 135
:TER (Trigger Event Register) 136
:VIEW 137
:ACQuire Commands 138
:ACQuire:AALias 140
:ACQuire:COMPlete 141
:ACQuire:COUNt 142
:ACQuire:DAALias 143
:ACQuire:MODE 144
:ACQuire:POINts 145
:ACQuire:RSIGnal 146

Agilent 6000 Series Oscilloscopes Programmer's Reference 7
:ACQuire:SRATe 147
:ACQuire:TYPE 148
:BUS<n> Commands 150
:BUS<n>:BIT<m> 152
:BUS<n>:BITS 153
:BUS<n>:CLEar 155
:BUS<n>:DISPlay 156
:BUS<n>:LABel 157
:BUS<n>:MASK 158
:CALibrate Commands 159
:CALibrate:DATE 160
:CALibrate:LABel 161
:CALibrate:STARt 162
:CALibrate:STATus 163
:CALibrate:SWITch 164
:CALibrate:TEMPerature 165
:CALibrate:TIME 166
:CHANnel<n> Commands 167
:CHANnel<n>:BWLimit 170
:CHANnel<n>:COUPling 171
:CHANnel<n>:DISPlay 172
:CHANnel<n>:IMPedance 173
:CHANnel<n>:INVert 174
:CHANnel<n>:LABel 175
:CHANnel<n>:OFFSet 176
:CHANnel<n>:PROBe 177
:CHANnel<n>:PROBe:ID 178
:CHANnel<n>:PROBe:SKEW 179
:CHANnel<n>:PROBe:STYPe 180
:CHANnel<n>:PROTection 181
:CHANnel<n>:RANGe 182
:CHANnel<n>:SCALe 183
:CHANnel<n>:UNITs 184
:CHANnel<n>:VERNier 185
:DIGital<n> Commands 186
:DIGital<n>:DISPlay 188
:DIGital<n>:LABel 189
:DIGital<n>:POSition 190
:DIGital<n>:SIZE 191
:DIGital<n>:THReshold 192

8 Agilent 6000 Series Oscilloscopes Programmer's Reference
:DISPlay Commands 193
:DISPlay:CLEar 195
:DISPlay:DATA 196
:DISPlay:LABel 198
:DISPlay:LABList 199
:DISPlay:PERSistence 200
:DISPlay:SOURce 201
:DISPlay:VECTors 202
:EXTernal Trigger Commands 203
:EXTernal:BWLimit 204
:EXTernal:IMPedance 205
:EXTernal:PROBe 206
:EXTernal:PROBe:ID 207
:EXTernal:PROBe:STYPe 208
:EXTernal:PROTection 209
:EXTernal:RANGe 210
:EXTernal:UNITs 211
:FUNCtion Commands 212
:FUNCtion:CENTer 214
:FUNCtion:DISPlay 215
:FUNCtion:OFFSet 216
:FUNCtion:OPERation 217
:FUNCtion:RANGe 218
:FUNCtion:REFerence 219
:FUNCtion:SCALe 220
:FUNCtion:SOURce 221
:FUNCtion:SPAN 222
:FUNCtion:WINDow 223
:HARDcopy Commands 224
:HARDcopy:FACTors 225
:HARDcopy:FFEed 226
:HARDcopy:FILename 227
:HARDcopy:FORMat 228
:HARDcopy:IGColors 229
:HARDcopy:PALette 230
:HARDcopy:PDRiver 231
:MARKer Commands 232
:MARKer:MODE 234
:MARKer:X1Position 235
:MARKer:X1Y1source 236

Agilent 6000 Series Oscilloscopes Programmer's Reference 9
:MARKer:X2Position 237
:MARKer:X2Y2source 238
:MARKer:XDELta 239
:MARKer:Y1Position 240
:MARKer:Y2Position 241
:MARKer:YDELta 242
:MEASure Commands 243
:MEASure:CLEar 250
:MEASure:COUNter 251
:MEASure:DEFine 252
:MEASure:DELay 255
:MEASure:DUTYcycle 257
:MEASure:FALLtime 258
:MEASure:FREQuency 259
:MEASure:NWIDth 260
:MEASure:OVERshoot 261
:MEASure:PERiod 263
:MEASure:PHASe 264
:MEASure:PREShoot 265
:MEASure:PWIDth 266
:MEASure:RISetime 267
:MEASure:SDEViation 268
:MEASure:SHOW 269
:MEASure:SOURce 270
:MEASure:TEDGe 272
:MEASure:TVALue 274
:MEASure:VAMPlitude 276
:MEASure:VAVerage 277
:MEASure:VBASe 278
:MEASure:VMAX 279
:MEASure:VMIN 280
:MEASure:VPP 281
:MEASure:VRMS 282
:MEASure:VTIMe 283
:MEASure:VTOP 284
:MEASure:XMAX 285
:MEASure:XMIN 286
:POD Commands 287
:POD<n>:DISPlay 288
:POD<n>:SIZE 289
:POD<n>:THReshold 290

10 Agilent 6000 Series Oscilloscopes Programmer's Reference
:SBUS Commands 292
:SBUS:BUSDoctor:ADDRess 294
:SBUS:BUSDoctor:BAUDrate 295
:SBUS:BUSDoctor:CHANnel 296
:SBUS:BUSDoctor:MODE 297
:SBUS:CAN:COUNt:ERRor 298
:SBUS:CAN:COUNt:OVERload 299
:SBUS:CAN:COUNt:RESet 300
:SBUS:CAN:COUNt:TOTal 301
:SBUS:CAN:COUNt:UTILization 302
:SBUS:DISPlay 303
:SBUS:FLEXray:COUNt:NULL 304
:SBUS:FLEXray:COUNt:RESet 305
:SBUS:FLEXray:COUNt:SYNC 306
:SBUS:FLEXray:COUNt:TOTal 307
:SBUS:IIC:ASIZe 308
:SBUS:LIN:PARity 309
:SBUS:MODE 310
:SBUS:SPI:WIDTh 311
:SYSTem Commands 312
:SYSTem:DATE 313
:SYSTem:DSP 314
:SYSTem:ERRor 315
:SYSTem:LOCK 316
:SYSTem:SETup 317
:SYSTem:TIME 319
:TIMebase Commands 320
:TIMebase:MODE 322
:TIMebase:POSition 323
:TIMebase:RANGe 324
:TIMebase:REFClock 325
:TIMebase:REFerence 326
:TIMebase:SCALe 327
:TIMebase:VERNier 328
:TIMebase:WINDow:POSition 329
:TIMebase:WINDow:RANGe 330
:TIMebase:WINDow:SCALe 331
:TRIGger Commands 332
General :TRIGger Commands 335
:TRIGger:HFReject 336