Agilent Technologies 5000 User Manual
Agilent InfiniiVision
5000 Series
Oscilloscopes
Programmer's Reference
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.00.0001
Edition
January 28, 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 programmer's reference gives detailed information on all the
commands available for controlling these oscilloscope models:
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 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 23
• "Commands by Subsystem" on page 59
• "Commands A- Z" on page 435
• "Obsolete and Discontinued Commands" on page 457
• "Error Messages" on page 499
• "Status Reporting" on page 507
• "More About Oscilloscope Commands" on page 529
• "Programming Examples" on page 549
See the Agilent InfiniiVision 5000 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.
Example
Programs
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 3
The example programs are designed to work with multiple InfiniiVision
5000 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.
4 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Contents
1 What's New
2 Commands Quick Reference
In This Book 3
What's New in Version 5.00 18
What's New in Version 4.10 20
Version 4.00 at Introduction 21
Command Summary 24
Syntax Elements 56
Number Format 56
<NL> (Line Terminator) 56
[ ] (Optional Syntax Terms) 56
{ } (Braces) 56
::= (Defined As) 56
< > (Angle Brackets) 57
... (Ellipsis) 57
n,..,p (Value Ranges) 57
d (Digits) 57
Quoted ASCII String 57
Definite-Length Block Response Data 57
3 Commands by Subsystem
Common (*) Commands 61
*CLS (Clear Status) 65
*ESE (Standard Event Status Enable) 66
*ESR (Standard Event Status Register) 68
*IDN (Identification Number) 70
*LRN (Learn Device Setup) 71
*OPC (Operation Complete) 72
*OPT (Option Identification) 73
*RCL (Recall) 74
*RST (Reset) 75
*SAV (Save) 78
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 5
*SRE (Service Request Enable) 79
*STB (Read Status Byte) 81
*TRG (Trigger) 83
*TST (Self Test) 84
*WAI (Wait To Continue) 85
Root (:) Commands 86
:AER (Arm Event Register) 89
:AUToscale 90
:AUToscale:AMODE 92
:AUToscale:CHANnels 93
:BLANk 94
:CDISplay 95
:DIGitize 96
:HWEenable (Hardware Event Enable Register) 98
:HWERegister:CONDition (Hardware Event Condition Register) 100
:HWERegister[:EVENt] (Hardware Event Event Register) 102
:MERGe 104
:OPEE (Operation Status Enable Register) 105
:OPERegister:CONDition (Operation Status Condition Register) 107
:OPERegister[:EVENt] (Operation Status Event Register) 109
:OVLenable (Overload Event Enable Register) 111
:OVLRegister (Overload Event Register) 113
:PRINt 115
:RUN 116
:SERial 117
:SINGle 118
:STATus 119
:STOP 120
:TER (Trigger Event Register) 121
:VIEW 122
:ACQuire Commands 123
:ACQuire:AALias 125
:ACQuire:COMPlete 126
:ACQuire:COUNt 127
:ACQuire:DAALias 128
:ACQuire:MODE 129
:ACQuire:POINts 130
:ACQuire:SRATe 131
:ACQuire:TYPE 132
:CALibrate Commands 134
6 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:CALibrate:DATE 135
:CALibrate:LABel 136
:CALibrate:STARt 137
:CALibrate:STATus 138
:CALibrate:SWITch 139
:CALibrate:TEMPerature 140
:CALibrate:TIME 141
:CHANnel<n> Commands 142
:CHANnel<n>:BWLimit 145
:CHANnel<n>:COUPling 146
:CHANnel<n>:DISPlay 147
:CHANnel<n>:IMPedance 148
:CHANnel<n>:INVert 149
:CHANnel<n>:LABel 150
:CHANnel<n>:OFFSet 151
:CHANnel<n>:PROBe 152
:CHANnel<n>:PROBe:ID 153
:CHANnel<n>:PROBe:SKEW 154
:CHANnel<n>:PROBe:STYPe 155
:CHANnel<n>:PROTection 156
:CHANnel<n>:RANGe 157
:CHANnel<n>:SCALe 158
:CHANnel<n>:UNITs 159
:CHANnel<n>:VERNier 160
:DISPlay Commands 161
:DISPlay:CLEar 163
:DISPlay:DATA 164
:DISPlay:LABel 166
:DISPlay:LABList 167
:DISPlay:PERSistence 168
:DISPlay:SOURce 169
:DISPlay:VECTors 170
:EXTernal Trigger Commands 171
:EXTernal:BWLimit 173
:EXTernal:IMPedance 174
:EXTernal:PROBe 175
:EXTernal:PROBe:ID 176
:EXTernal:PROBe:STYPe 177
:EXTernal:PROTection 178
:EXTernal:RANGe 179
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 7
:EXTernal:UNITs 180
:FUNCtion Commands 181
:FUNCtion:CENTer 183
:FUNCtion:DISPlay 184
:FUNCtion:OFFSet 185
:FUNCtion:OPERation 186
:FUNCtion:RANGe 187
:FUNCtion:REFerence 188
:FUNCtion:SCALe 189
:FUNCtion:SOURce 190
:FUNCtion:SPAN 191
:FUNCtion:WINDow 192
:HARDcopy Commands 193
:HARDcopy:AREA 195
:HARDcopy:APRinter 196
:HARDcopy:FACTors 197
:HARDcopy:FFEed 198
:HARDcopy:INKSaver 199
:HARDcopy:PALette 200
:HARDcopy:PRinter:LIST 201
:HARDcopy:STARt 202
:MARKer Commands 203
:MARKer:MODE 205
:MARKer:X1Position 206
:MARKer:X1Y1source 207
:MARKer:X2Position 208
:MARKer:X2Y2source 209
:MARKer:XDELta 210
:MARKer:Y1Position 211
:MARKer:Y2Position 212
:MARKer:YDELta 213
:MEASure Commands 214
:MEASure:CLEar 220
:MEASure:COUNter 221
:MEASure:DEFine 222
:MEASure:DELay 225
:MEASure:DUTYcycle 227
:MEASure:FALLtime 228
:MEASure:FREQuency 229
:MEASure:NWIDth 230
8 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:MEASure:OVERshoot 231
:MEASure:PERiod 233
:MEASure:PHASe 234
:MEASure:PREShoot 235
:MEASure:PWIDth 236
:MEASure:RISetime 237
:MEASure:SDEViation 238
:MEASure:SHOW 239
:MEASure:SOURce 240
:MEASure:TEDGe 242
:MEASure:TVALue 244
:MEASure:VAMPlitude 246
:MEASure:VAVerage 247
:MEASure:VBASe 248
:MEASure:VMAX 249
:MEASure:VMIN 250
:MEASure:VPP 251
:MEASure:VRMS 252
:MEASure:VTIMe 253
:MEASure:VTOP 254
:MEASure:XMAX 255
:MEASure:XMIN 256
:RECall Commands 257
:RECall:FILename 258
:RECall:IMAGe[:STARt] 259
:RECall:PWD 260
:RECall:SETup[:STARt] 261
:SAVE Commands 262
:SAVE:FILename 264
:SAVE:IMAGe[:STARt] 265
:SAVE:IMAGe:AREA 266
:SAVE:IMAGe:FACTors 267
:SAVE:IMAGe:FORMat 268
:SAVE:IMAGe:INKSaver 269
:SAVE:IMAGe:PALette 270
:SAVE:PWD 271
:SAVE:SETup[:STARt] 272
:SAVE:WAVeform[:STARt] 273
:SAVE:WAVeform:FORMat 274
:SAVE:WAVeform:LENGth 275
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 9
:SBUS Commands 276
:SBUS:CAN:COUNt:ERRor 278
:SBUS:CAN:COUNt:OVERload 279
:SBUS:CAN:COUNt:RESet 280
:SBUS:CAN:COUNt:TOTal 281
:SBUS:CAN:COUNt:UTILization 282
:SBUS:DISPlay 283
:SBUS:IIC:ASIZe 284
:SBUS:LIN:PARity 285
:SBUS:MODE 286
:SBUS:SPI:WIDTh 287
:SBUS:UART:BASE 288
:SBUS:UART:COUNt:ERRor 289
:SBUS:UART:COUNt:RESet 290
:SBUS:UART:COUNt:RXFRames 291
:SBUS:UART:COUNt:TXFRames 292
:SBUS:UART:FRAMing 293
:SYSTem Commands 294
:SYSTem:DATE 295
:SYSTem:DSP 296
:SYSTem:ERRor 297
:SYSTem:LOCK 298
:SYSTem:SETup 299
:SYSTem:TIME 301
:TIMebase Commands 302
:TIMebase:MODE 304
:TIMebase:POSition 305
:TIMebase:RANGe 306
:TIMebase:REFerence 307
:TIMebase:SCALe 308
:TIMebase:VERNier 309
:TIMebase:WINDow:POSition 310
:TIMebase:WINDow:RANGe 311
:TIMebase:WINDow:SCALe 312
:TRIGger Commands 313
General :TRIGger Commands 316
:TRIGger:HFReject 317
:TRIGger:HOLDoff 318
:TRIGger:MODE 319
:TRIGger:NREJect 320
10 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:TRIGger:PATTern 321
:TRIGger:SWEep 323
:TRIGger:CAN Commands 324
:TRIGger:CAN:PATTern:DATA 326
:TRIGger:CAN:PATTern:DATA:LENGth 327
:TRIGger:CAN:PATTern:ID 328
:TRIGger:CAN:PATTern:ID:MODE 329
:TRIGger:CAN:SAMPlepoint 330
:TRIGger:CAN:SIGNal:BAUDrate 331
:TRIGger:CAN:SOURce 332
:TRIGger:CAN:TRIGger 333
:TRIGger:DURation Commands 335
:TRIGger:DURation:GREaterthan 336
:TRIGger:DURation:LESSthan 337
:TRIGger:DURation:PATTern 338
:TRIGger:DURation:QUALifier 339
:TRIGger:DURation:RANGe 340
:TRIGger[:EDGE] Commands 341
:TRIGger[:EDGE]:COUPling 342
:TRIGger[:EDGE]:LEVel 343
:TRIGger[:EDGE]:REJect 344
:TRIGger[:EDGE]:SLOPe 345
:TRIGger[:EDGE]:SOURce 346
:TRIGger:GLITch Commands 347
:TRIGger:GLITch:GREaterthan 348
:TRIGger:GLITch:LESSthan 349
:TRIGger:GLITch:LEVel 350
:TRIGger:GLITch:POLarity 351
:TRIGger:GLITch:QUALifier 352
:TRIGger:GLITch:RANGe 353
:TRIGger:GLITch:SOURce 354
:TRIGger:IIC Commands 355
:TRIGger:IIC:PATTern:ADDRess 356
:TRIGger:IIC:PATTern:DATA 357
:TRIGger:IIC:PATTern:DATa2 358
:TRIGger:IIC:SOURce:CLOCk 359
:TRIGger:IIC:SOURce:DATA 360
:TRIGger:IIC:TRIGger:QUALifier 361
:TRIGger:IIC:TRIGger[:TYPE] 362
:TRIGger:LIN Commands 364
:TRIGger:LIN:ID 365
:TRIGger:LIN:SAMPlepoint 366
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 11
:TRIGger:LIN:SIGNal:BAUDrate 367
:TRIGger:LIN:SOURce 368
:TRIGger:LIN:STANdard 369
:TRIGger:LIN:SYNCbreak 370
:TRIGger:LIN:TRIGger 371
:TRIGger:SPI Commands 372
:TRIGger:SPI:CLOCk:SLOPe 373
:TRIGger:SPI:CLOCk:TIMeout 374
:TRIGger:SPI:FRAMing 375
:TRIGger:SPI:PATTern:DATA 376
:TRIGger:SPI:PATTern:WIDTh 377
:TRIGger:SPI:SOURce:CLOCk 378
:TRIGger:SPI:SOURce:DATA 379
:TRIGger:SPI:SOURce:FRAMe 380
:TRIGger:TV Commands 381
:TRIGger:TV:LINE 382
:TRIGger:TV:MODE 383
:TRIGger:TV:POLarity 384
:TRIGger:TV:SOURce 385
:TRIGger:TV:STANdard 386
:TRIGger:UART Commands 387
:TRIGger:UART:BAUDrate 389
:TRIGger:UART:BITorder 390
:TRIGger:UART:BURSt 391
:TRIGger:UART:DATA 392
:TRIGger:UART:IDLE 393
:TRIGger:UART:PARity 394
:TRIGger:UART:POLarity 395
:TRIGger:UART:QUALifier 396
:TRIGger:UART:SOURce:RX 397
:TRIGger:UART:SOURce:TX 398
:TRIGger:UART:TYPE 399
:TRIGger:UART:WIDTh 400
:WAVeform Commands 401
:WAVeform:BYTeorder 408
:WAVeform:COUNt 409
:WAVeform:DATA 410
:WAVeform:FORMat 412
:WAVeform:POINts 413
:WAVeform:POINts:MODE 415
:WAVeform:PREamble 417
12 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:WAVeform:SOURce 420
:WAVeform:SOURce:SUBSource 424
:WAVeform:TYPE 425
:WAVeform:UNSigned 426
:WAVeform:VIEW 427
:WAVeform:XINCrement 428
:WAVeform:XORigin 429
:WAVeform:XREFerence 430
:WAVeform:YINCrement 431
:WAVeform:YORigin 432
:WAVeform:YREFerence 433
4 Commands A-Z
5 Obsolete and Discontinued Commands
:CHANnel:LABel 462
:CHANnel2:SKEW 463
:CHANnel<n>:INPut 464
:CHANnel<n>:PMODe 465
:DISPlay:CONNect 466
:ERASe 467
:EXTernal:INPut 468
:EXTernal:PMODe 469
:FUNCtion:VIEW 470
:HARDcopy:DESTination 471
:HARDcopy:DEVice 472
:HARDcopy:FILename 473
:HARDcopy:FORMat 474
:HARDcopy:GRAYscale 475
:HARDcopy:IGColors 476
:HARDcopy:PDRiver 477
:MEASure:LOWer 478
:MEASure:SCRatch 479
:MEASure:TDELta 480
:MEASure:THResholds 481
:MEASure:TMAX 482
:MEASure:TMIN 483
:MEASure:TSTArt 484
:MEASure:TSTOp 485
:MEASure:TVOLt 486
:MEASure:UPPer 488
:MEASure:VDELta 489
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 13
:MEASure:VSTArt 490
:MEASure:VSTOp 491
:PRINt? 492
:TIMebase:DELay 494
:TRIGger:CAN:ACKNowledge 495
:TRIGger:CAN:SIGNal:DEFinition 496
:TRIGger:LIN:SIGNal:DEFinition 497
:TRIGger:TV:TVMode 498
6 Error Messages
7 Status Reporting
Status Reporting Data Structures 509
Status Byte Register (STB) 512
Service Request Enable Register (SRE) 514
Trigger Event Register (TER) 515
Output Queue 516
Message Queue 517
(Standard) Event Status Register (ESR) 518
(Standard) Event Status Enable Register (ESE) 519
Error Queue 520
Operation Status Event Register (:OPERegister[:EVENt]) 521
Operation Status Condition Register (:OPERegister:CONDition) 522
Arm Event Register (AER) 523
Hardware Event Event Register (:HWERegister[:EVENt]) 524
Hardware Event Condition Register (:HWERegister:CONDition) 525
Clearing Registers and Queues 526
Status Reporting Decision Chart 527
8 More About Oscilloscope Commands
Command Classifications 530
Core Commands 530
Non-Core Commands 530
Obsolete Commands 530
14 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Valid Command/Query Strings 531
Program Message Syntax 531
Command Tree 535
Duplicate Mnemonics 545
Tree Traversal Rules and Multiple Commands 545
Query Return Values 547
All Oscilloscope Commands Are Sequential 548
9 Programming Examples
SICL Example in C 550
VISA Example in C 559
VISA Example in Visual Basic 568
VISA COM Example in Visual Basic 578
Index
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 15
16 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes
Programmer's Reference
1
What's New
What's New in Version 5.00 18
What's New in Version 4.10 20
Version 4.00 at Introduction 21
A
17
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 sommand 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 202) Starts a print job.
:HARDcopy:APRinter (see page 196) Sets the active printer.
:HARDcopy:AREA (see page 195) Specifies the area of the display to print
(currently SCReen only).
:HARDcopy:INKSaver (see page 199) Inverts screen colors to save ink when printing.
:HARDcopy:PRinter:LIST (see page 201) Returns a list of the available printers.
:RECall Commands (see page 257) Commands for recalling previously saved
oscilloscope setups and traces.
:SAVE Commands (see page 262) Commands for saving oscilloscope setups and
traces, screen images, and data.
:SBUS Commands (see page 276) Commands for controlling oscilloscope
functions associated with the serial decode
bus.
:TRIGger:CAN Commands (see page 324) Commands for triggering on Controller Area
Network (CAN) version 2.0A and 2.0B signals.
:TRIGger:IIC Commands (see page 355) Commands for triggering on Inter-IC (IIC)
signals.
:TRIGger:LIN Commands (see page 364) Commands for triggering on Local Interconnect
Network (LIN) signals.
:TRIGger:SPI Commands (see page 372) Commands for triggering on Serial Peripheral
Interface (SPI) signals.
:TRIGger:UART Commands (see page 387) Commands for triggering on UART/RS-232
signals.
:WAVeform:SOURce:SUBSource (see
page 424)
18 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Selects subsource when :WAVeform:SOURce
is SBUS (serial decode).
Changed
Commands
Obsolete
Commands
What's New 1
Command Differences
:TRIGger:MODE (see page 319) You can now select the serial triggering modes.
Obsolete Command Current Command Equivalent Behavior Differences
:HARDcopy:FILename (see
page 473)
:HARDcopy:FORMat (see
page 474)
:HARDcopy:IGColors (see
page 476)
:HARDcopy:PDRiver (see
page 477)
:RECall:FILename (see
page 258)
:SAVE:FILename (see
page 258)
:HARDcopy:APRinter (see
page 196)
:SAVE:IMAGe:FORMat (see
page 268)
:SAVE:WAVeform:FORMat
(see page 274)
:HARDcopy:INKSaver (see
page 199)
:HARDcopy:APRinter (see
page 196)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 19
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 186) You can now select the SQRT (square root)
:HARDcopy:PDRiver (see page 477) You can now select the new DJPR0kx50,
waveform math function.
DJ55xx, PS470, and LJFastraster printer
drivers.
20 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
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 Reference 21
1 What's New
22 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes
Programmer's Reference
2
Commands Quick Reference
Command Summary 24
Syntax Elements 56
A
23
2 Commands Quick Reference
Command Summary
Table 2 Common (*) Commands Summary
Command Query Options and Query Returns
*CLS (see page 65) n/a n/a
*ESE <mask> (see
page 66)
n/a *ESR? (see page 68) <status> ::= 0 to 255; an integer
n/a *IDN? (see page 68) AGILENT TECHNOLOGIES,<model>,
n/a *LRN? (see page 71) <learn_string> ::= current
*ESE? (see page 67) <mask> ::= 0 to 255; an integer
in NR1 format:
Bit Weight Name Enables
--- ------ ---- ---------7 128 PON Power On
6 64 URQ User Request
5 32 CME Command Error
4 16 EXE Execution Error
3 8 DDE Dev. Dependent Error
2 4 QYE Query Error
1 2 RQL Request Control
0 1 OPC Operation Complete
in NR1 format
<serial number>,X.XX.XX
<model> ::= the model number of
the instrument
<serial number> ::= the serial
number of the instrument
<X.XX.XX> ::= the software
revision of the instrument
instrument setup as a block of
data in IEEE 488.2 # format
*OPC (see page 72) *OPC? (see page 72) ASCII "1" is placed in the output
queue when all pending device
operations have completed.
24 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 2 Common (*) Commands Summary (continued)
Command Query Options and Query Returns
n/a *OPT? (see page 73) <return_value> ::= 0,0,<license
info>
<license info> ::= <All field>,
<reserved>, <reserved>,
<reserved>, <reserved>,
<reserved>, <Low Speed Serial>,
<Automotive Serial>, <reserved>,
<Secure>, <reserved>,
<reserved>, <reserved>,
<reserved>,
<RS-232/UART Serial>, <reserved>
<All field> ::= {0 | All}
<reserved> ::= 0
<Low Speed Serial> ::= {0 | LSS}
<Automotive Serial> ::= {0 | AMS}
<Secure> ::= {0 | SEC}
<RS-232/UART Serial> ::= {0 |
232}
*RCL <value> (see
page 74)
*RST (see page 75) n/a See *RST (Reset) (see page 75)
*SAV <value> (see
page 78)
*SRE <mask> (see
page 79)
n/a <value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
n/a <value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*SRE? (see page 80) <mask> ::= sum of all bits that
are set, 0 to 255; an integer in
NR1 format. <mask> ::= following
values:
Bit Weight Name Enables
--- ------ ---- ---------7 128 OPER Operation Status Reg
6 64 ---- (Not used.)
5 32 ESB Event Status Bit
4 16 MAV Message Available
3 8 ---- (Not used.)
2 4 MSG Message
1 2 USR User
0 1 TRG Trigger
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 25
2 Commands Quick Reference
Table 2 Common (*) Commands Summary (continued)
Command Query Options and Query Returns
n/a *STB? (see page 81) <value> ::= 0 to 255; an integer
in NR1 format, as shown in the
following:
Bit Weight Name "1" Indicates
--- ------ ---- --------------7 128 OPER Operation status
condition occurred.
6 64 RQS/ Instrument is
MSS requesting service.
5 32 ESB Enabled event status
condition occurred.
4 16 MAV Message available.
3 8 ---- (Not used.)
2 4 MSG Message displayed.
1 2 USR User event
condition occurred.
0 1 TRG A trigger occurred.
*TRG (see page 83) n/a n/a
n/a *TST? (see page 84) <result> ::= 0 or non-zero value;
an integer in NR1 format
*WAI (see page 85) n/a n/a
Table 3 Root (:) Commands Summary
Command Query Options and Query Returns
n/a :AER? (see page 89) {0 | 1}; an integer in NR1 format
:AUToscale
[<source>[,..,<source
>]] (see page 90)
:AUToscale:AMODE
<value> (see page 92)
:AUToscale:CHANnels
<value> (see page 93)
:BLANk [<source>]
(see page 94)
n/a <source> ::= CHANnel<n>
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
:AUToscale:AMODE?
(see page 92)
:AUToscale:CHANnels?
(see page 93)
n/a <source> ::= {CHANnel<n>} |
<value> ::= {NORMal | CURRent}}
<value> ::= {ALL | DISPlayed}}
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
:CDISplay (see
page 95)
26 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
n/a n/a
Commands Quick Reference 2
Table 3 Root (:) Commands Summary (continued)
Command Query Options and Query Returns
:DIGitize
[<source>[,..,<source
>]] (see page 96)
:HWEenable <n> (see
page 98)
n/a :HWERregister:CONDiti
n/a :HWERegister[:EVENt]?
:MERGe <pixel memory>
(see page 104)
:OPEE <n> (see
page 105)
n/a :OPERregister:CONDiti
n/a :OPERegister[:EVENt]?
:OVLenable <mask>
(see page 111)
n/a <source> ::= {CHANnel<n> |
:HWEenable? (see
page 98)
on? (see page 100)
(see page 102)
n/a <pixel memory> ::= {PMEMory{0 | 1
:OPEE? (see page 106) <n> ::= 16-bit integer in NR1
on? (see page 107)
(see page 109)
:OVLenable? (see
page 112)
FUNCtion | MATH}
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
<n> ::= 16-bit integer in NR1
format
<n> ::= 16-bit integer in NR1
format
<n> ::= 16-bit integer in NR1
format
| 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}}
format
<n> ::= 16-bit integer in NR1
format
<n> ::= 16-bit integer in NR1
format
<mask> ::= 16-bit integer in NR1
format as shown:
n/a :OVLRegister? (see
page 113)
:PRINt [<options>]
(see page 115)
n/a <options> ::= [<print
Bit Weight Input
--- ------ ---------10 1024 Ext Trigger Fault
9 512 Channel 4 Fault
8 256 Channel 3 Fault
7 128 Channel 2 Fault
6 64 Channel 1 Fault
4 16 Ext Trigger OVL
3 8 Channel 4 OVL
2 4 Channel 3 OVL
1 2 Channel 2 OVL
0 1 Channel 1 OVL
<value> ::= integer in NR1
format. See OVLenable for <value>
option>][,..,<print option>]
<print option> ::= {COLor |
GRAYscale | PRINter0 | BMP8bit |
BMP | PNG | NOFactors | FACTors}
<print option> can be repeated up
to 5 times.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 27
2 Commands Quick Reference
Table 3 Root (:) Commands Summary (continued)
Command Query Options and Query Returns
:RUN (see page 116) n/a n/a
n/a :SERial (see
page 117)
:SINGle (see
page 118)
n/a :STATus? <display>
:STOP (see page 120) n/a n/a
n/a :TER? (see page 121) {0 | 1}
:VIEW <source> (see
page 122)
n/a n/a
(see page 119)
n/a <source> ::= {CHANnel<n> |
<return value> ::= unquoted
string containing serial number
{0 | 1}
<display> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
PMEMory{0 | 1 | 2 | 3 | 4 | 5 | 6
| 7 | 8 | 9} | FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
Table 4 :ACQuire Commands Summary
Command Query Options and Query Returns
n/a :ACQuire:AALias? (see
page 125)
{1 | 0}
:ACQuire:COMPlete
<complete> (see
page 126)
:ACQuire:COUNt
<count> (see
page 127)
:ACQuire:DAALias
<mode> (see page 128)
:ACQuire:MODE <mode>
(see page 129)
n/a :ACQuire:POINts? (see
n/a :ACQuire:SRATe? (see
:ACQuire:TYPE <type>
(see page 132)
28 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:ACQuire:COMPlete?
(see page 126)
:ACQuire:COUNt? (see
page 127)
:ACQuire:DAALias?
(see page 128)
:ACQuire:MODE? (see
page 129)
page 130)
page 131)
:ACQuire:TYPE? (see
page 132)
<complete> ::= 100; an integer in
NR1 format
<count> ::= an integer from 1 to
65536 in NR1 format
<mode> ::= {DISable | AUTO}
<mode> ::= {RTIMe | ETIMe}
<# points> ::= an integer in NR1
format
<sample_rate> ::= sample rate
(samples/s) in NR3 format
<type> ::= {NORMal | AVERage |
HRESolution | PEAK}
Commands Quick Reference 2
Table 5 :CALibrate Commands Summary
Command Query Options and Query Returns
n/a :CALibrate:DATE? (see
page 135)
:CALibrate:LABel
<string> (see
page 136)
:CALibrate:STARt (see
page 137)
n/a :CALibrate:STATus?
n/a :CALibrate:SWITch?
n/a :CALibrate:TEMPeratur
n/a :CALibrate:TIME? (see
:CALibrate:LABel?
(see page 136)
n/a n/a
(see page 138)
(see page 139)
e? (see page 140)
page 141)
<return value> ::=
<day>,<month>,<year>; all in NR1
format
<string> ::= quoted ASCII string
up to 32 characters
<return value> ::=
ALL,<status_code>,<status_string
>
<status_code> ::= an integer
status code
<status_string> ::= an ASCII
status string
{PROTected | UNPRotected}
<return value> ::= degrees C
delta since last cal in NR3
format
<return value> ::=
<hours>,<minutes>,<seconds>; all
in NR1 format
Table 6 :CHANnel<n> Commands Summary
Command Query Options and Query Returns
:CHANnel<n>:BWLimit
{{0 | OFF} | {1 |
ON}} (see page 145)
:CHANnel<n>:COUPling
<coupling> (see
page 146)
:CHANnel<n>:DISPlay
{{0 | OFF} | {1 |
ON}} (see page 147)
:CHANnel<n>:IMPedance
<impedance> (see
page 148)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 29
:CHANnel<n>:BWLimit?
(see page 145)
:CHANnel<n>:COUPling?
(see page 146)
:CHANnel<n>:DISPlay?
(see page 147)
:CHANnel<n>:IMPedance
? (see page 148)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
<coupling> ::= {AC | DC}
<n> ::= 1-2 or 1-4 in NR1 format
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
<impedance> ::= {ONEMeg | FIFTy}
<n> ::= 1-2 or 1-4 in NR1 format
2 Commands Quick Reference
Table 6 :CHANnel<n> Commands Summary (continued)
Command Query Options and Query Returns
:CHANnel<n>:INVert
{{0 | OFF} | {1 |
ON}} (see page 149)
:CHANnel<n>:LABel
<string> (see
page 150)
:CHANnel<n>:OFFSet
<offset>[suffix] (see
page 151)
:CHANnel<n>:PROBe
<attenuation> (see
page 152)
n/a :CHANnel<n>:PROBe:ID?
:CHANnel<n>:PROBe:SKE
W <skew_value> (see
page 154)
:CHANnel<n>:PROBe:STY
Pe <signal type> (see
page 155)
:CHANnel<n>:INVert?
(see page 149)
:CHANnel<n>:LABel?
(see page 150)
:CHANnel<n>:OFFSet?
(see page 151)
:CHANnel<n>:PROBe?
(see page 152)
(see page 153)
:CHANnel<n>:PROBe:SKE
W? (see page 154)
:CHANnel<n>:PROBe:STY
Pe? (see page 155)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
<string> ::= any series of 6 or
less ASCII characters enclosed in
quotation marks
<n> ::= 1-2 or 1-4 in NR1 format
<offset> ::= Vertical offset
value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4; in NR1 format
<attenuation> ::= Probe
attenuation ratio in NR3 format
<n> ::= 1-2 or 1-4r in NR1 format
<probe id> ::= unquoted ASCII
string up to 11 characters
<n> ::= 1-2 or 1-4 in NR1 format
<skew_value> ::= -100 ns to +100
ns in NR3 format
<n> ::= 1-2 or 1-4 in NR1 format
<signal type> ::= {DIFFerential |
SINGle}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROTectio
n (see page 156)
:CHANnel<n>:RANGe
<range>[suffix] (see
page 157)
:CHANnel<n>:SCALe
<scale>[suffix] (see
page 158)
:CHANnel<n>:UNITs
<units> (see
page 159)
:CHANnel<n>:VERNier
{{0 | OFF} | {1 |
ON}} (see page 160)
30 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:CHANnel<n>:PROTectio
n? (see page 156)
:CHANnel<n>:RANGe?
(see page 157)
:CHANnel<n>:SCALe?
(see page 158)
:CHANnel<n>:UNITs?
(see page 159)
:CHANnel<n>:VERNier?
(see page 160)
{NORM | TRIP}
<n> ::= 1-2 or 1-4 in NR1 format
<range> ::= Vertical full-scale
range value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
<scale> ::= Vertical units per
division value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
<units> ::= {VOLT | AMPere}
<n> ::= 1-2 or 1-4 in NR1 format
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
Loading...