Agilent Technologies DSO5054A, DSO5034A, DSO5014A, DSO5052A, DSO5012A Programmer's Manual
...
Agilent InfiniiVision
5000 Series
Oscilloscopes
Programmer's Guide
A
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 translation into a foreign language) without prior
agreement and written consent from Agilent Technologies, Inc. as governed by
United States and international copyright
laws.
Trademarks
Microsoft®, MS-DOS®, Windows®, Windows 2000®, and Windows XP® are U.S.
registered trademarks of Microsoft Corporation.
Adobe®, Acrobat®, and the Acrobat
Logo® are trademarks of Adobe Systems
Incorporated.
Manual Part Number
Version 05.20.0000
Edition
December 5, 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 document is provided “as is,” and is subject to being changed, without notice,
in future editions. Further, to the maximum 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 particular purpose. Agilent shall not be
liable for errors or for incidental or
consequential damages in connection
with the furnishing, use, or performance 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 separate 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
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. Government will receive no greater than
Restricted Rights as defined in FAR
52.227-19(c)(1-2) (June 1987). U.S. Government 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 hazard. It calls attention to an operating 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 performed or adhered to, could result
in personal injury or death. Do not
proceed beyond a WARNING
notice until the indicated conditions are fully understood and met.
If software is for use in the performance of
a U.S. Government prime contract or subcontract, Software is delivered and
licensed as “Commercial computer software” 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
In This Book
This book is your guide to programming the 5000 Series oscilloscopes:
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
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 31, describes the steps you must take
before you can program the oscilloscope.
• Chapter 3, "Getting Started" on page 41, 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 55, 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 95, 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 535, contains an alphabetical
listing of all command elements.
• Chapter 7, "Obsolete and Discontinued Commands" on page 563,
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 615, 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 623, describes the oscilloscope's
status registers and how to check the status of the instrument.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 3
• Chapter 10, "Synchronizing Acquisitions" on page 647, 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 657, contains
additional information about oscilloscope programming commands.
Finally, there is a chapter that contains programming examples:
• Chapter 12, "Programming Examples" on page 679.
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"
4 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Contents
1 What's New
2 Setting Up
In This Book 3
What's New in Version 5.20 20
What's New in Version 5.15 23
What's New in Version 5.10 25
What's New in Version 5.00 26
What's New in Version 4.10 28
Version 4.00 at Introduction 29
Step 1. Install Agilent IO Libraries Suite software 32
Step 2. Connect and set up the oscilloscope 33
Using the USB (Device) Interface 33
Using the LAN Interface 33
Using the GPIB Interface 34
Step 3. Verify the oscilloscope connection 35
3 Getting Started
Basic Oscilloscope Program Structure 42
Initializing 42
Capturing Data 42
Analyzing Captured Data 43
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 5
Programming the Oscilloscope 44
Referencing the IO Library 44
Opening the Oscilloscope Connection via the IO Library 45
Initializing the Interface and the Oscilloscope 45
Using :AUToscale to Automate Oscilloscope Setup 46
Using Other Oscilloscope Setup Commands 46
Capturing Data with the :DIGitize Command 47
Reading Query Responses from the Oscilloscope 49
Reading Query Results into String Variables 50
Reading Query Results into Numeric Variables 50
Reading Definite-Length Block Query Response Data 50
Sending Multiple Queries and Reading Results 51
Checking Instrument Status 52
Other Ways of Sending Commands 53
Tel ne t S oc ke ts 53
Sending SCPI Commands Using Browser Web Control 53
4 Commands Quick Reference
Command Summary 56
Syntax Elements 92
Number Format 92
<NL> (Line Terminator) 92
[ ] (Optional Syntax Terms) 92
{ } (Braces) 92
::= (Defined As) 92
< > (Angle Brackets) 93
... (Ellipsis) 93
n,..,p (Value Ranges) 93
d (Digits) 93
Quoted ASCII String 93
Definite-Length Block Response Data 93
5 Commands by Subsystem
Common (*) Commands 97
*CLS (Clear Status) 101
*ESE (Standard Event Status Enable) 102
*ESR (Standard Event Status Register) 104
*IDN (Identification Number) 106
*LRN (Learn Device Setup) 107
*OPC (Operation Complete) 108
6 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
*OPT (Option Identification) 109
*RCL (Recall) 110
*RST (Reset) 111
*SAV (Save) 114
*SRE (Service Request Enable) 115
*STB (Read Status Byte) 117
*TRG (Trigger) 119
*TST (Self Test) 120
*WAI (Wait To Continue) 121
Root (:) Commands 122
:AER (Arm Event Register) 125
:AUToscale 126
:AUToscale:AMODE 128
:AUToscale:CHANnels 129
:BLANk 130
:CDISplay 131
:DIGitize 132
:HWEenable (Hardware Event Enable Register) 134
:HWERegister:CONDition (Hardware Event Condition Register) 136
:HWERegister[:EVENt] (Hardware Event Event Register) 138
:MERGe 140
:MTEenable (Mask Test Event Enable Register) 141
:MTERegister[:EVENt] (Mask Test Event Event Register) 143
:OPEE (Operation Status Enable Register) 145
:OPERegister:CONDition (Operation Status Condition Register) 147
:OPERegister[:EVENt] (Operation Status Event Register) 149
:OVLenable (Overload Event Enable Register) 151
:OVLRegister (Overload Event Register) 153
:PRINt 155
:RUN 156
:SERial 157
:SINGle 158
:STATus 159
:STOP 160
:TER (Trigger Event Register) 161
:VIEW 162
:ACQuire Commands 163
:ACQuire:AALias 165
:ACQuire:COMPlete 166
:ACQuire:COUNt 167
:ACQuire:DAALias 168
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 7
:ACQuire:MODE 169
:ACQuire:POINts 170
:ACQuire:SEGMented:ANALyze 171
:ACQuire:SEGMented:COUNt 172
:ACQuire:SEGMented:INDex 173
:ACQuire:SRATe 176
:ACQuire:TYPE 177
:CALibrate Commands 179
:CALibrate:DATE 181
:CALibrate:LABel 182
:CALibrate:OUTPut 183
:CALibrate:STARt 184
:CALibrate:STATus 185
:CALibrate:SWITch 186
:CALibrate:TEMPerature 187
:CALibrate:TIME 188
:CHANnel<n> Commands 189
:CHANnel<n>:BWLimit 192
:CHANnel<n>:COUPling 193
:CHANnel<n>:DISPlay 194
:CHANnel<n>:IMPedance 195
:CHANnel<n>:INVert 196
:CHANnel<n>:LABel 197
:CHANnel<n>:OFFSet 198
:CHANnel<n>:PROBe 199
:CHANnel<n>:PROBe:ID 200
:CHANnel<n>:PROBe:SKEW 201
:CHANnel<n>:PROBe:STYPe 202
:CHANnel<n>:PROTection 203
:CHANnel<n>:RANGe 204
:CHANnel<n>:SCALe 205
:CHANnel<n>:UNITs 206
:CHANnel<n>:VERNier 207
:DISPlay Commands 208
:DISPlay:CLEar 210
:DISPlay:DATA 211
:DISPlay:LABel 213
:DISPlay:LABList 214
:DISPlay:PERSistence 215
:DISPlay:SOURce 216
8 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:DISPlay:VECTors 217
:EXTernal Trigger Commands 218
:EXTernal:BWLimit 220
:EXTernal:IMPedance 221
:EXTernal:PROBe 222
:EXTernal:PROBe:ID 223
:EXTernal:PROBe:STYPe 224
:EXTernal:PROTection 225
:EXTernal:RANGe 226
:EXTernal:UNITs 227
:FUNCtion Commands 228
:FUNCtion:CENTer 231
:FUNCtion:DISPlay 232
:FUNCtion:GOFT:OPERation 233
:FUNCtion:GOFT:SOURce1 234
:FUNCtion:GOFT:SOURce2 235
:FUNCtion:OFFSet 236
:FUNCtion:OPERation 237
:FUNCtion:RANGe 238
:FUNCtion:REFerence 239
:FUNCtion:SCALe 240
:FUNCtion:SOURce1 241
:FUNCtion:SOURce2 242
:FUNCtion:SPAN 243
:FUNCtion:WINDow 244
:HARDcopy Commands 245
:HARDcopy:AREA 247
:HARDcopy:APRinter 248
:HARDcopy:FACTors 249
:HARDcopy:FFEed 250
:HARDcopy:INKSaver 251
:HARDcopy:LAYout 252
:HARDcopy:PALette 253
:HARDcopy:PRINter:LIST 254
:HARDcopy:STARt 255
:MARKer Commands 256
:MARKer:MODE 258
:MARKer:X1Position 259
:MARKer:X1Y1source 260
:MARKer:X2Position 261
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 9
:MARKer:X2Y2source 262
:MARKer:XDELta 263
:MARKer:Y1Position 264
:MARKer:Y2Position 265
:MARKer:YDELta 266
:MEASure Commands 267
:MEASure:CLEar 274
:MEASure:COUNter 275
:MEASure:DEFine 276
:MEASure:DELay 279
:MEASure:DUTYcycle 281
:MEASure:FALLtime 282
:MEASure:FREQuency 283
:MEASure:NWIDth 284
:MEASure:OVERshoot 285
:MEASure:PERiod 287
:MEASure:PHASe 288
:MEASure:PREShoot 289
:MEASure:PWIDth 290
:MEASure:RESults 291
:MEASure:RISetime 294
:MEASure:SDEViation 295
:MEASure:SHOW 296
:MEASure:SOURce 297
:MEASure:STATistics 299
:MEASure:STATistics:INCRement 300
:MEASure:STATistics:RESet 301
:MEASure:TEDGe 302
:MEASure:TVALue 304
:MEASure:VAMPlitude 306
:MEASure:VAVerage 307
:MEASure:VBASe 308
:MEASure:VMAX 309
:MEASure:VMIN 310
:MEASure:VPP 311
:MEASure:VRATio 312
:MEASure:VRMS 313
:MEASure:VTIMe 314
:MEASure:VTOP 315
:MEASure:XMAX 316
:MEASure:XMIN 317
10 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:MTESt Commands 318
:MTESt:AMASk:CREate 323
:MTESt:AMASk:SOURce 324
:MTESt:AMASk:UNITs 325
:MTESt:AMASk:XDELta 326
:MTESt:AMASk:YDELta 327
:MTESt:COUNt:FWAVeforms 328
:MTESt:COUNt:RESet 329
:MTESt:COUNt:TIME 330
:MTESt:COUNt:WAVeforms 331
:MTESt:DATA 332
:MTESt:DELete 333
:MTESt:ENABle 334
:MTESt:LOCK 335
:MTESt:OUTPut 336
:MTESt:RMODe 337
:MTESt:RMODe:FACTion:PRINt 338
:MTESt:RMODe:FACTion:SAVE 339
:MTESt:RMODe:FACTion:STOP 340
:MTESt:RMODe:SIGMa 341
:MTESt:RMODe:TIME 342
:MTESt:RMODe:WAVeforms 343
:MTESt:SCALe:BIND 344
:MTESt:SCALe:X1 345
:MTESt:SCALe:XDELta 346
:MTESt:SCALe:Y1 347
:MTESt:SCALe:Y2 348
:MTESt:SOURce 349
:MTESt:TITLe 350
:RECall Commands 351
:RECall:FILename 352
:RECall:IMAGe[:STARt] 353
:RECall:MASK[:STARt] 354
:RECall:PWD 355
:RECall:SETup[:STARt] 356
:SAVE Commands 357
:SAVE:FILename 359
:SAVE:IMAGe[:STARt] 360
:SAVE:IMAGe:AREA 361
:SAVE:IMAGe:FACTors 362
:SAVE:IMAGe:FORMat 363
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 11
:SAVE:IMAGe:INKSaver 364
:SAVE:IMAGe:PALette 365
:SAVE:MASK[:STARt] 366
:SAVE:PWD 367
:SAVE:SETup[:STARt] 368
:SAVE:WAVeform[:STARt] 369
:SAVE:WAVeform:FORMat 370
:SAVE:WAVeform:LENGth 371
:SAVE:WAVeform:SEGMented 372
:SBUS Commands 373
:SBUS:CAN:COUNt:ERRor 375
:SBUS:CAN:COUNt:OVERload 376
:SBUS:CAN:COUNt:RESet 377
:SBUS:CAN:COUNt:TOTal 378
:SBUS:CAN:COUNt:UTILization 379
:SBUS:DISPlay 380
:SBUS:IIC:ASIZe 381
:SBUS:LIN:PARity 382
:SBUS:MODE 383
:SBUS:SPI:WIDTh 384
:SBUS:UART:BASE 385
:SBUS:UART:COUNt:ERRor 386
:SBUS:UART:COUNt:RESet 387
:SBUS:UART:COUNt:RXFRames 388
:SBUS:UART:COUNt:TXFRames 389
:SBUS:UART:FRAMing 390
:SYSTem Commands 391
:SYSTem:DATE 392
:SYSTem:DSP 393
:SYSTem:ERRor 394
:SYSTem:LOCK 395
:SYSTem:PROTection:LOCK 396
:SYSTem:SETup 397
:SYSTem:TIME 399
:TIMebase Commands 400
:TIMebase:MODE 402
:TIMebase:POSition 403
:TIMebase:RANGe 404
:TIMebase:REFerence 405
:TIMebase:SCALe 406
12 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:TIMebase:VERNier 407
:TIMebase:WINDow:POSition 408
:TIMebase:WINDow:RANGe 409
:TIMebase:WINDow:SCALe 410
:TRIGger Commands 411
General :TRIGger Commands 414
:TRIGger:HFReject 415
:TRIGger:HOLDoff 416
:TRIGger:MODE 417
:TRIGger:NREJect 418
:TRIGger:PATTern 419
:TRIGger:SWEep 421
:TRIGger:CAN Commands 422
:TRIGger:CAN:PATTern:DATA 424
:TRIGger:CAN:PATTern:DATA:LENGth 425
:TRIGger:CAN:PATTern:ID 426
:TRIGger:CAN:PATTern:ID:MODE 427
:TRIGger:CAN:SAMPlepoint 428
:TRIGger:CAN:SIGNal:BAUDrate 429
:TRIGger:CAN:SOURce 430
:TRIGger:CAN:TRIGger 431
:TRIGger:DURation Commands 433
:TRIGger:DURation:GREaterthan 434
:TRIGger:DURation:LESSthan 435
:TRIGger:DURation:PATTern 436
:TRIGger:DURation:QUALifier 437
:TRIGger:DURation:RANGe 438
:TRIGger[:EDGE] Commands 439
:TRIGger[:EDGE]:COUPling 440
:TRIGger[:EDGE]:LEVel 441
:TRIGger[:EDGE]:REJect 442
:TRIGger[:EDGE]:SLOPe 443
:TRIGger[:EDGE]:SOURce 444
:TRIGger:GLITch Commands 445
:TRIGger:GLITch:GREaterthan 446
:TRIGger:GLITch:LESSthan 447
:TRIGger:GLITch:LEVel 448
:TRIGger:GLITch:POLarity 449
:TRIGger:GLITch:QUALifier 450
:TRIGger:GLITch:RANGe 451
:TRIGger:GLITch:SOURce 452
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 13
:TRIGger:IIC Commands 453
:TRIGger:IIC:PATTern:ADDRess 454
:TRIGger:IIC:PATTern:DATA 455
:TRIGger:IIC:PATTern:DATa2 456
:TRIGger:IIC[:SOURce]:CLOCk 457
:TRIGger:IIC[:SOURce]:DATA 458
:TRIGger:IIC:TRIGger:QUALifier 459
:TRIGger:IIC:TRIGger[:TYPE] 460
:TRIGger:LIN Commands 462
:TRIGger:LIN:ID 463
:TRIGger:LIN:SAMPlepoint 464
:TRIGger:LIN:SIGNal:BAUDrate 465
:TRIGger:LIN:SOURce 466
:TRIGger:LIN:STANdard 467
:TRIGger:LIN:SYNCbreak 468
:TRIGger:LIN:TRIGger 469
:TRIGger:SPI Commands 470
:TRIGger:SPI:CLOCk:SLOPe 471
:TRIGger:SPI:CLOCk:TIMeout 472
:TRIGger:SPI:FRAMing 473
:TRIGger:SPI:PATTern:DATA 474
:TRIGger:SPI:PATTern:WIDTh 475
:TRIGger:SPI:SOURce:CLOCk 476
:TRIGger:SPI:SOURce:DATA 477
:TRIGger:SPI:SOURce:FRAMe 478
:TRIGger:TV Commands 479
:TRIGger:TV:LINE 480
:TRIGger:TV:MODE 481
:TRIGger:TV:POLarity 482
:TRIGger:TV:SOURce 483
:TRIGger:TV:STANdard 484
:TRIGger:UART Commands 485
:TRIGger:UART:BASE 487
:TRIGger:UART:BAUDrate 488
:TRIGger:UART:BITorder 489
:TRIGger:UART:BURSt 490
:TRIGger:UART:DATA 491
:TRIGger:UART:IDLE 492
:TRIGger:UART:PARity 493
:TRIGger:UART:POLarity 494
:TRIGger:UART:QUALifier 495
:TRIGger:UART:SOURce:RX 496
14 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
:TRIGger:UART:SOURce:TX 497
:TRIGger:UART:TYPE 498
:TRIGger:UART:WIDTh 499
:WAVeform Commands 500
:WAVeform:BYTeorder 507
:WAVeform:COUNt 508
:WAVeform:DATA 509
:WAVeform:FORMat 511
:WAVeform:POINts 512
:WAVeform:POINts:MODE 514
:WAVeform:PREamble 516
:WAVeform:SEGMented:COUNt 519
:WAVeform:SEGMented:TTAG 520
:WAVeform:SOURce 521
:WAVeform:SOURce:SUBSource 525
:WAVeform:TYPE 526
:WAVeform:UNSigned 527
:WAVeform:VIEW 528
:WAVeform:XINCrement 529
:WAVeform:XORigin 530
:WAVeform:XREFerence 531
:WAVeform:YINCrement 532
:WAVeform:YORigin 533
:WAVeform:YREFerence 534
6 Commands A-Z
7 Obsolete and Discontinued Commands
:CHANnel:LABel 568
:CHANnel2:SKEW 569
:CHANnel<n>:INPut 570
:CHANnel<n>:PMODe 571
:DISPlay:CONNect 572
:ERASe 573
:EXTernal:INPut 574
:EXTernal:PMODe 575
:FUNCtion:SOURce 576
:FUNCtion:VIEW 577
:HARDcopy:DESTination 578
:HARDcopy:DEVice 579
:HARDcopy:FILename 580
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 15
:HARDcopy:FORMat 581
:HARDcopy:GRAYscale 582
:HARDcopy:IGColors 583
:HARDcopy:PDRiver 584
:MEASure:LOWer 585
:MEASure:SCRatch 586
:MEASure:TDELta 587
:MEASure:THResholds 588
:MEASure:TMAX 589
:MEASure:TMIN 590
:MEASure:TSTArt 591
:MEASure:TSTOp 592
:MEASure:TVOLt 593
:MEASure:UPPer 595
:MEASure:VDELta 596
:MEASure:VSTArt 597
:MEASure:VSTOp 598
:MTESt:AMASk:{SAVE | STORe} 599
:MTESt:AVERage 600
:MTESt:AVERage:COUNt 601
:MTESt:LOAD 602
:MTESt:RUMode 603
:MTESt:RUMode:SOFailure 604
:MTESt:{STARt | STOP} 605
:MTESt:TRIGger:SOURce 606
:PRINt? 607
:TIMebase:DELay 609
:TRIGger:CAN:ACKNowledge 610
:TRIGger:CAN:SIGNal:DEFinition 611
:TRIGger:LIN:SIGNal:DEFinition 612
:TRIGger:TV:TVMode 613
8 Error Messages
9 Status Reporting
Status Reporting Data Structures 626
Status Byte Register (STB) 629
Service Request Enable Register (SRE) 631
Trigger Event Register (TER) 632
Output Queue 633
16 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Message Queue 634
(Standard) Event Status Register (ESR) 635
(Standard) Event Status Enable Register (ESE) 636
Error Queue 637
Operation Status Event Register (:OPERegister[:EVENt]) 638
Operation Status Condition Register (:OPERegister:CONDition) 639
Arm Event Register (AER) 640
Overload Event Register (:OVLRegister) 641
Hardware Event Event Register (:HWERegister[:EVENt]) 642
Hardware Event Condition Register (:HWERegister:CONDition) 643
Mask Test Event Event Register (:MTERegister[:EVENt]) 644
Clearing Registers and Queues 645
Status Reporting Decision Chart 646
10 Synchronizing Acquisitions
Synchronization in the Programming Flow 648
Set Up the Oscilloscope 648
Acquire a Waveform 648
Retrieve Results 648
Blocking Synchronization 649
Polling Synchronization With Timeout 650
Synchronizing with a Single-Shot Device Under Test (DUT) 652
Synchronization with an Averaging Acquisition 654
11 More About Oscilloscope Commands
Command Classifications 658
Core Commands 658
Non-Core Commands 658
Obsolete Commands 658
Valid Command/Query Strings 659
Program Message Syntax 659
Command Tree 663
Duplicate Mnemonics 674
Tree Traversal Rules and Multiple Commands 675
Query Return Values 677
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 17
All Oscilloscope Commands Are Sequential 678
12 Programming Examples
SICL Examples 680
SICL Example in C 680
SICL Example in Visual Basic 689
VISA Examples 698
VISA Example in C 698
VISA Example in Visual Basic 707
VISA Example in C# 717
VISA Example in Visual Basic .NET 731
VISA COM Examples 744
VISA COM Example in Visual Basic 744
VISA COM Example in C# 754
VISA COM Example in Visual Basic .NET 765
Index
18 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 5000 Series Oscilloscopes
Programmer's Guide
1
What's New
What's New in Version 5.20 20
What's New in Version 5.15 23
What's New in Version 5.10 25
What's New in Version 5.00 26
What's New in Version 4.10 28
Version 4.00 at Introduction 29
A
19
1 What's New
What's New in Version 5.20
New features in version 5.20 of the InfiniiVision 5000 Series oscilloscope
software are:
• Mask testing, enabled with Option LMT.
• Tracking cursors (markers) have been added.
• Measurement statistics have been added.
• Labels can now be up to 10 characters.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command Description
:ACQuire:SEGMented:ANALyze (see page 171) Calculates measurement statistics and/or
infinite persistence over all segments that have
been acquired.
:CALibrate:OUTPut (see page 183) Selects the signal output on the rear panel
TRIG OUT BNC.
:HARDcopy:LAYout (see page 252) Sets the hardcopy layout mode.
:MEASure:RESults (see page 291) Returns measurement statistics values.
:MEASure:STATistics (see page 299) Sets the type of measurement statistics to
return.
:MEASure:STATistics:INCRement (see
page 300)
:MEASure:STATistics:RESet (see page 301) Resets the measurement statistics values.
:MTEenable (Mask Test Event Enable Register)
(see page 141)
:MTERegister[:EVENt] (Mask Test Event Event
Register) (see page 143)
:MTESt Commands (see page 318) Commands and queries to control the mask
:RECall:MASK[:STARt] (see page 366) Recalls a mask.
:SAVE:MASK[:STARt] (see page 366) Saves the current mask.
Updates the statistics once (incrementing the
count by one) using the current measurement
values.
Sets a mask in the Mask Test Event Enable
register.
Returns the integer value contained in the
Mask Test Event Event Register and clears the
register.
test (Option LMT) features.
:SAVE:WAVeform:SEGMented (see page 372) Specifies which segments are included when
the waveform is saved.
:TRIGger:UART:BASE (see page 487) Selects the front panel UART/RS232 trigger
setup data selection option from HEX or
BINary.
20 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Changed
Commands
What's New 1
Command Differences
:CHANnel<n>:LABel (see page 197) Labels can now be up to 10 characters.
:DISPlay:LABList (see page 214) Labels can now be up to 10 characters.
:MARKer:MODE (see page 258) You can now select the WAVeform tracking
cursors mode.
:RECall:PWD (see page 355) You can set the present working directory in
addition to querying for this information.
:SAVE:IMAGe[:STARt] (see page 360) The file extension specified will change the
:SAVE:IMAGe:FORMat setting if it is a valid
image file extension.
:SAVE:PWD (see page 367) You can set the present working directory in
addition to querying for this information.
:SAVE:WAVeform[:STARt] (see page 360) The file extension specified will change the
:SAVE:WAVeform:FORMat setting if it is a valid
waveform file extension.
Obsolete
Commands
:TRIGger:CAN:SIGNal:BAUDrate (see
page 429)
:TRIGger:LIN:SIGNal:BAUDrate (see page 465) The baud rate value can now be set in 100 b/s
:TRIGger:UART:BAUDrate (see page 488) The baud rate value can now be set in 100 b/s
:TRIGger:UART:DATA (see page 491) You can now specify the data value using a
Obsolete Command Current Command Equivalent Behavior Differences
:MTESt:AMASk:{SAVE |
STORe} (see page 599)
:MTESt:AVERage (see
page 600)
:MTESt:AVERage:COUNt (see
page 601)
:MTESt:LOAD (see page 602) :RECall:MASK[:STARt] (see
:SAVE:MASK[:STARt] (see
page 366)
:ACQuire:TYPE AVERage (see
page 177)
:ACQuire:COUNt (see
page 167)
page 354)
The baud rate value can now be set in 100 b/s
increments.
increments.
increments and the maximum baud rate is now
3Mb/s.
quoted ASCII character.
:MTESt:RUMode (see
page 603)
:MTESt:RUMode:SOFailure
(see page 604)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 21
:MTESt:RMODe (see
page 337)
:MTESt:RMODe:FACTion:STO
P (see page 340)
1 What's New
Obsolete Command Current Command Equivalent Behavior Differences
:MTESt:{STARt | STOP} (see
page 605)
:MTESt:TRIGger:SOURce (see
page 606)
:RUN (see page 156) or :STOP
(see page 160)
:TRIGger Commands (see
page 411)
There are various commands
for setting the source with
different types of triggers.
22 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
What's New in Version 5.15
New features in version 5.15 of the InfiniiVision 5000 Series oscilloscope
software are:
• Waveform math can be performed using channels 3 and 4, and there is
a new ADD operator.
• Ratio of AC RMS values measurement.
• Analog channel impedance protection lock.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command Description
:FUNCtion:GOFT:OPERation (see page 233) Selects the math operation for the internal g(t)
What's New 1
source that can be used as the input to the FFT,
INTegrate, DIFFerentiate, and SQRT functions.
:FUNCtion:GOFT:SOURce1 (see page 234) Selects the first input channel for the g(t)
source.
:FUNCtion:GOFT:SOURce2 (see page 235) Selects the second input channel for the g(t)
source.
:FUNCtion:SOURce1 (see page 241) Selects the first source for the ADD, SUBTract,
and MULTiply arithmetic operations or the
single source for the FFT, INTegrate,
DIFFerentiate, and SQRT functions.
:FUNCtion:SOURce2 (see page 242) Selects the second input channel for the ADD,
SUBTract, and MULTiply arithmetic operations.
:MEASure:VRATio (see page 312) Measures and returns the ratio of AC RMS
values of the specified sources expressed in
dB.
:SYSTem:PROTection:LOCK (see page 396) Disables/enables the fifty ohm input
impedance setting.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 23
1 What's New
Changed
Commands
Obsolete
Commands
Command Differences
:ACQuire:COUNt (see page 167) The :ACQuire:COUNt 1 command has been
deprecated. The AVERage acquisition type with
a count of 1 is functionally equivalent to the
HRESolution acquisition type; however, you
should select the high-resolution acquisition
mode with the :ACQuire:TYPE HRESolution
command instead.
:FUNCtion:OPERation (see page 237) The ADD parameter is new, and now that
waveform math can be performed using
channels 3 and 4, this command selects the
operation only.
:FUNCtion:WINDow (see page 244) You can now select the Blackman-Harris FFT
window.
Obsolete Command Current Command Equivalent Behavior Differences
:FUNCtion:SOURce (see
page 576)
:FUNCtion:SOURce1 (see
page 241)
Obsolete command has ADD,
SUBTract, and MULTiply
parameters; current command
has GOFT parameter.
24 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
What's New in Version 5.10
New features in version 5.10 of the InfiniiVision 5000 Series oscilloscope
software are:
• Segmented memory acquisition mode, enabled with Option SGM.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command Description
:ACQuire:SEGMented:COUNt (see page 172) Sets the number of memory segments.
:ACQuire:SEGMented:INDex (see page 173) Selects the segmented memory index.
:WAVeform:SEGMented:COUNt (see page 519) Returns the number of segments in the
:WAVeform:SEGMented:TTAG (see page 520) Returns the time tag for the selected
What's New 1
currently acquired waveform data.
segmented memory index.
Changed
Commands
Command Differences
:ACQuire:MODE (see page 169) You can now select the SEGMented memory
mode.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 25
1 What's New
What's New in Version 5.00
New features in version 5.00 of the InfiniiVision 5000 Series oscilloscope
software are:
• Serial triggering and decode options are now available.
• The :SAVE and :RECall command subsystems.
• Changes to the :HARDcopy command subsystem to make a clearer
distinction between printing and save/recall functionality.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command Description
:HARDcopy:STARt (see page 255) Starts a print job.
:HARDcopy:APRinter (see page 248) Sets the active printer.
:HARDcopy:AREA (see page 247) Specifies the area of the display to print
(currently SCReen only).
:HARDcopy:INKSaver (see page 251) Inverts screen colors to save ink when printing.
:HARDcopy:PRinter:LIST (see page 254) Returns a list of the available printers.
:RECall Commands (see page 351) Commands for recalling previously saved
oscilloscope setups and traces.
:SAVE Commands (see page 357) Commands for saving oscilloscope setups and
traces, screen images, and data.
:SBUS Commands (see page 373) Commands for controlling oscilloscope
functions associated with the serial decode
bus.
:TRIGger:CAN Commands (see page 422) Commands for triggering on Controller Area
Network (CAN) version 2.0A and 2.0B signals.
:TRIGger:IIC Commands (see page 453) Commands for triggering on Inter-IC (IIC)
signals.
:TRIGger:LIN Commands (see page 462) Commands for triggering on Local Interconnect
Network (LIN) signals.
:TRIGger:SPI Commands (see page 470) Commands for triggering on Serial Peripheral
Interface (SPI) signals.
:TRIGger:UART Commands (see page 485) Commands for triggering on UART/RS-232
signals.
:WAVeform:SOURce:SUBSource (see
page 525)
26 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Selects subsource when :WAVeform:SOURce
is SBUS (serial decode).
Changed
Commands
Obsolete
Commands
What's New 1
Command Differences
:BLANk (see page 130) Now, you can also use this command with the
serial decode bus.
:DIGitize (see page 132) Now, you can also use this command with the
serial decode bus.
:STATus (see page 159) Now, you can also use this command with the
serial decode bus.
:TRIGger:MODE (see page 417) You can now select the serial triggering modes.
:VIEW (see page 162) Now, you can now use this command with the
serial decode bus.
:WAVeform:SOURce (see page 521) Now, you can also use this command with the
serial decode bus.
Obsolete Command Current Command Equivalent Behavior Differences
:HARDcopy:FILename (see
page 580)
:HARDcopy:FORMat (see
page 581)
:HARDcopy:IGColors (see
page 583)
:HARDcopy:PDRiver (see
page 584)
:RECall:FILename (see
page 352)
:SAVE:FILename (see
page 352)
:HARDcopy:APRinter (see
page 248)
:SAVE:IMAGe:FORMat (see
page 363)
:SAVE:WAVeform:FORMat
(see page 370)
:HARDcopy:INKSaver (see
page 251)
:HARDcopy:APRinter (see
page 248)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 27
1 What's New
What's New in Version 4.10
New features in version 4.10 of the InfiniiVision 5000 Series oscilloscope
software are:
• The square root waveform math function.
• Several new hardcopy printer drivers.
More detailed descriptions of the new and changed commands appear
below.
Changed
Commands
Command Differences
:FUNCtion:OPERation (see page 237) You can now select the SQRT (square root)
:HARDcopy:PDRiver (see page 584) You can now select the new DJPR0kx50,
waveform math function.
DJ55xx, PS470, and LJFastraster printer
drivers.
28 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Version 4.00 at Introduction
The Agilent InfiniiVision 5000 Series oscilloscopes were introduced with
version 4.00 of oscilloscope operating software. The command set is
similar to the 6000 Series oscilloscopes (and the 54620/54640 Series
oscilloscopes before them) except that digital channels, rear-panel 10 Mhz
reference BNC input/output, and serial bus triggering/decode features are
not present.
What's New 1
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide 29
1 What's New
30 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide
Loading...