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
Commands Quick Reference 2
Table 7 :DISPlay Commands Summary
Command Query Options and Query Returns
:DISPlay:CLEar (see
page 163)
:DISPlay:DATA
[<format>][,][<area>]
[,][<palette>]<displa
y data> (see
page 164)
:DISPlay:LABel {{0 |
OFF} | {1 | ON}} (see
page 166)
:DISPlay:LABList
<binary block> (see
page 167)
:DISPlay:PERSistence
<value> (see
page 168)
n/a n/a
:DISPlay:DATA?
[<format>][,][<area>]
[,][<palette>] (see
page 164)
:DISPlay:LABel? (see
page 166)
:DISPlay:LABList?
(see page 167)
:DISPlay:PERSistence?
(see page 168)
<format> ::= {TIFF} (command)
<area> ::= {GRATicule} (command)
<palette> ::= {MONochrome}
(command)
<format> ::= {TIFF | BMP |
BMP8bit | PNG} (query)
<area> ::= {GRATicule | SCReen}
(query)
<palette> ::= {MONochrome |
GRAYscale | COLor} (query)
<display data> ::= data in IEEE
488.2 # format
{0 | 1}
<binary block> ::= an ordered
list of up to 75 labels, each 6
characters maximum, separated by
newline characters
<value> ::= {MINimum | INFinite}}
:DISPlay:SOURce
<value> (see
page 169)
:DISPlay:VECTors {{1
| ON} | {0 | OFF}}
(see page 170)
:DISPlay:SOURce? (see
page 169)
:DISPlay:VECTors?
(see page 170)
<value> ::= {PMEMory{0 | 1 | 2 |
3 | 4 | 5 | 6 | 7 | 8 | 9}}
{1 | 0}
Table 8 :EXTernal Trigger Commands Summary
Command Query Options and Query Returns
:EXTernal:BWLimit
<bwlimit> (see
page 173)
:EXTernal:IMPedance
<value> (see
page 174)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 31
:EXTernal:BWLimit?
(see page 173)
:EXTernal:IMPedance?
(see page 174)
<bwlimit> ::= {0 | OFF}
<impedance> ::= {ONEMeg | FIFTy}
2 Commands Quick Reference
Table 8 :EXTernal Trigger Commands Summary (continued)
Command Query Options and Query Returns
:EXTernal:PROBe
<attenuation> (see
page 175)
n/a :EXTernal:PROBe:ID?
:EXTernal:PROBe:STYPe
<signal type> (see
page 177)
:EXTernal:PROTection[
:CLEar] (see
page 178)
:EXTernal:RANGe
<range>[<suffix>]
(see page 179)
:EXTernal:UNITs
<units> (see
page 180)
Table 9 :FUNCtion Commands Summary
Command Query Options and Query Returns
:EXTernal:PROBe? (see
page 175)
(see page 176)
:EXTernal:PROBe:STYPe
? (see page 177)
:EXTernal:PROTection?
(see page 178)
:EXTernal:RANGe? (see
page 179)
:EXTernal:UNITs? (see
page 180)
<attenuation> ::= probe
attenuation ratio in NR3 format
<probe id> ::= unquoted ASCII
string up to 11 characters
<signal type> ::= {DIFFerential |
SINGle}
{NORM | TRIP}
<range> ::= vertical full-scale
range value in NR3 format
<suffix> ::= {V | mV}
<units> ::= {VOLT | AMPere}
:FUNCtion:CENTer
<frequency> (see
page 183)
:FUNCtion:DISPlay {{0
| OFF} | {1 | ON}}
(see page 184)
:FUNCtion:OFFSet
<offset> (see
page 185)
:FUNCtion:OPERation
<operation> (see
page 186)
:FUNCtion:CENTer?
(see page 183)
:FUNCtion:DISPlay?
(see page 184)
:FUNCtion:OFFSet?
(see page 185)
:FUNCtion:OPERation?
(see page 186)
<frequency> ::= the current
center frequency in NR3 format.
The range of legal values is from
0 Hz to 25 GHz.
{0 | 1}
<offset> ::= the value at center
screen in NR3 format.
The range of legal values is
+/-10 times the current
sensitivity of the selected
function.
<operation> ::= {SUBTract |
MULTiply | INTegrate |
DIFFerentiate | FFT | SQRT}
32 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 9 :FUNCtion Commands Summary (continued)
Command Query Options and Query Returns
:FUNCtion:RANGe
<range> (see
page 187)
:FUNCtion:REFerence
<level> (see
page 188)
:FUNCtion:SCALe
<scale
value>[<suffix>] (see
page 189)
:FUNCtion:SOURce
<source> (see
page 190)
:FUNCtion:RANGe? (see
page 187)
:FUNCtion:REFerence?
(see page 188)
:FUNCtion:SCALe? (see
page 189)
:FUNCtion:SOURce?
(see page 190)
<range> ::= the full-scale
vertical axis value in NR3
format.
The range for ADD, SUBT, MULT is
8E-6 to 800E+3. The range for the
INTegrate function is 8E-9 to
400E+3.
The range for the DIFFerentiate
function is 80E-3 to 8.0E12
(depends on current sweep speed).
The range for the FFT function is
8 to 800 dBV.
<level> ::= the current reference
level in NR3 format.
The range of legal values is from
400.0 dBV to +400.0 dBV
(depending on current range
value).
<scale value> ::= integer in NR1
format
<suffix> ::= {V | dB}
<source> ::= {CHANnel<n> | ADD |
SUBT | MULT}
<n> ::= 1-2 or 1-4 in NR1 format
:FUNCtion:SPAN <span>
(see page 191)
:FUNCtion:WINDow
<window> (see
page 192)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 33
:FUNCtion:SPAN? (see
page 191)
:FUNCtion:WINDow?
(see page 192)
<span> ::= the current frequency
span in NR3 format.
Legal values are 1 Hz to 100 GHz.
<window> ::= {RECTangular |
HANNing | FLATtop}
2 Commands Quick Reference
Table 1 0 :HARDcopy Commands Summary
Command Query Options and Query Returns
:HARDcopy:AREA <area>
(see page 195)
:HARDcopy:APRinter
<active_printer> (see
page 196)
:HARDcopy:FACTors {{0
| OFF} | {1 | ON}}
(see page 197)
:HARDcopy:FFEed {{0 |
OFF} | {1 | ON}} (see
page 198)
:HARDcopy:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 199)
:HARDcopy:PALette
<palette> (see
page 200)
n/a :HARDcopy:PRinter:LIS
:HARDcopy:AREA? (see
page 195)
:HARDcopy:APRinter?
(see page 196)
:HARDcopy:FACTors?
(see page 197)
:HARDcopy:FFEed? (see
page 198)
:HARDcopy:INKSaver?
(see page 199)
:HARDcopy:PALette?
(see page 200)
T? (see page 201)
<area> ::= SCReen
<active_printer> ::= {<index> |
<name>}
<index> ::= integer index of
printer in list
<name> ::= name of printer in
list
{0 | 1}
{0 | 1}
{0 | 1}
<palette> ::= {COLor | GRAYscale
| NONE}
<list> ::= [<printer_spec>] ...
[printer_spec>]
<printer_spec> ::=
"<index>,<active>,<name>;"
<index> ::= integer index of
printer
<active> ::= {Y | N}
<name> ::= name of printer
:HARDcopy:STARt (see
page 202)
34 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
n/a n/a
Commands Quick Reference 2
Table 1 1 :MARKer Commands Summary
Command Query Options and Query Returns
:MARKer:MODE <mode>
(see page 205)
:MARKer:X1Position
<position>[suffix]
(see page 206)
:MARKer:X1Y1source
<source> (see
page 207)
:MARKer:X2Position
<position>[suffix]
(see page 208)
:MARKer:X2Y2source
<source> (see
page 209)
:MARKer:MODE? (see
page 205)
:MARKer:X1Position?
(see page 206)
:MARKer:X1Y1source?
(see page 207)
:MARKer:X2Position?
(see page 208)
:MARKer:X2Y2source?
(see page 209)
<mode> ::= {OFF | MEASurement |
MANual}
<position> ::= X1 cursor position
value in NR3 format
[suffix] ::= {s | ms | us | ns |
ps | Hz | kHz | MHz}
<return_value> ::= X1 cursor
position value in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
<position> ::= X2 cursor position
value in NR3 format
[suffix] ::= {s | ms | us | ns |
ps | Hz | kHz | MHz}
<return_value> ::= X2 cursor
position value in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
n/a :MARKer:XDELta? (see
page 210)
:MARKer:Y1Position
<position>[suffix]
(see page 211)
:MARKer:Y2Position
<position>[suffix]
(see page 212)
n/a :MARKer:YDELta? (see
:MARKer:Y1Position?
(see page 211)
:MARKer:Y2Position?
(see page 212)
page 213)
<return_value> ::= X cursors
delta value in NR3 format
<position> ::= Y1 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y1 cursor
position value in NR3 format
<position> ::= Y2 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y2 cursor
position value in NR3 format
<return_value> ::= Y cursors
delta value in NR3 format
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 35
2 Commands Quick Reference
Table 1 2 :MEASure Commands Summary
Command Query Options and Query Returns
:MEASure:CLEar (see
page 220)
:MEASure:COUNter
[<source>] (see
page 221)
:MEASure:DEFine
DELay, <delay spec>
(see page 222)
:MEASure:DEFine
THResholds,
<threshold spec> (see
page 222)
:MEASure:DELay
[<source1>]
[,<source2>] (see
page 225)
n/a n/a
:MEASure:COUNter?
[<source>] (see
page 221)
:MEASure:DEFine?
DELay (see page 223)
:MEASure:DEFine?
THResholds (see
page 223)
:MEASure:DELay?
[<source1>]
[,<source2>] (see
page 225)
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= counter
frequency in Hertz in NR3 format
<delay spec> ::=
<edge_spec1>,<edge_spec2>
edge_spec1 ::=
[<slope>]<occurrence>
edge_spec2 ::=
[<slope>]<occurrence>
<slope> ::= {+ | -}
<occurrence> ::= integer
<threshold spec> ::= {STANdard} |
{<threshold mode>,<upper>,
<middle>,<lower>}
<threshold mode> ::= {PERCent |
ABSolute}
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::=
floating-point number delay time
in seconds in NR3 format
:MEASure:DUTYcycle
[<source>] (see
page 227)
:MEASure:FALLtime
[<source>] (see
page 228)
:MEASure:FREQuency
[<source>] (see
page 229)
36 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:MEASure:DUTYcycle?
[<source>] (see
page 227)
:MEASure:FALLtime?
[<source>] (see
page 228)
:MEASure:FREQuency?
[<source>] (see
page 229)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= ratio of
positive pulse width to period in
NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds between the lower and
upper thresholds in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= frequency in
Hertz in NR3 format
Commands Quick Reference 2
Table 1 2 :MEASure Commands Summary (continued)
Command Query Options and Query Returns
:MEASure:NWIDth
[<source>] (see
page 230)
:MEASure:OVERshoot
[<source>] (see
page 231)
:MEASure:PERiod
[<source>] (see
page 233)
:MEASure:PHASe
[<source1>]
[,<source2>] (see
page 234)
:MEASure:NWIDth?
[<source>] (see
page 230)
:MEASure:OVERshoot?
[<source>] (see
page 231)
:MEASure:PERiod?
[<source>] (see
page 233)
:MEASure:PHASe?
[<source1>]
[,<source2>] (see
page 234)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= negative
pulse width in seconds-NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the percent of
the overshoot of the selected
waveform in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= waveform
period in seconds in NR3 format
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the phase
angle value in degrees in NR3
format
:MEASure:PREShoot
[<source>] (see
page 235)
:MEASure:PWIDth
[<source>] (see
page 236)
:MEASure:RISEtime
[<source>] (see
page 237)
:MEASure:PREShoot?
[<source>] (see
page 235)
:MEASure:PWIDth?
[<source>] (see
page 236)
:MEASure:RISEtime?
[<source>] (see
page 237)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the percent of
preshoot of the selected waveform
in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= width of
positive pulse in seconds in NR3
format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= rise time in
seconds in NR3 format
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 37
2 Commands Quick Reference
Table 1 2 :MEASure Commands Summary (continued)
Command Query Options and Query Returns
:MEASure:SDEViation
[<source>] (see
page 238)
:MEASure:SHOW {1 |
ON} (see page 239)
:MEASure:SOURce
[<source1>]
[,<source2>] (see
page 240)
n/a :MEASure:TEDGe?
:MEASure:SDEViation?
[<source>] (see
page 238)
:MEASure:SHOW? (see
page 239)
:MEASure:SOURce? (see
page 240)
<slope><occurrence>[,
<source>] (see
page 242)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
std deviation in NR3 format
{1}
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= {<source> |
NONE}
<slope> ::= direction of the
waveform
<occurrence> ::= the transition
to be reported
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds of the specified
transition
n/a :MEASure:TVALue?
<value>,
[<slope>]<occurrence>
[,<source>] (see
page 244)
:MEASure:VAMPlitude
[<source>] (see
page 246)
:MEASure:VAMPlitude?
[<source>] (see
page 246)
<value> ::= voltage level that
the waveform must cross.
<slope> ::= direction of the
waveform when <value> is crossed.
<occurrence> ::= transitions
reported.
<return_value> ::= time in
seconds of specified voltage
crossing in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the amplitude
of the selected waveform in volts
in NR3 format
38 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 1 2 :MEASure Commands Summary (continued)
Command Query Options and Query Returns
:MEASure:VAVerage
[<source>] (see
page 247)
:MEASure:VBASe
[<source>] (see
page 248)
:MEASure:VMAX
[<source>] (see
page 249)
:MEASure:VMIN
[<source>] (see
page 250)
:MEASure:VAVerage?
[<source>] (see
page 247)
:MEASure:VBASe?
[<source>] (see
page 248)
:MEASure:VMAX?
[<source>] (see
page 249)
:MEASure:VMIN?
[<source>] (see
page 250)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
average voltage in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<base_voltage> ::= voltage at the
base of the selected waveform in
NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= maximum
voltage of the selected waveform
in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= minimum
voltage of the selected waveform
in NR3 format
:MEASure:VPP
[<source>] (see
page 251)
:MEASure:VRMS
[<source>] (see
page 252)
n/a :MEASure:VTIMe?
:MEASure:VPP?
[<source>] (see
page 251)
:MEASure:VRMS?
[<source>] (see
page 252)
<vtime>[,<source>]
(see page 253)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= voltage
peak-to-peak of the selected
waveform in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated dc
RMS voltage in NR3 format
<vtime> ::= displayed time from
trigger in seconds in NR3 format
<return_value> ::= voltage at the
specified time in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 39
2 Commands Quick Reference
Table 1 2 :MEASure Commands Summary (continued)
Command Query Options and Query Returns
:MEASure:VTOP
[<source>] (see
page 254)
:MEASure:XMAX
[<source>] (see
page 255)
:MEASure:XMIN
[<source>] (see
page 256)
:MEASure:VTOP?
[<source>] (see
page 254)
:MEASure:XMAX?
[<source>] (see
page 255)
:MEASure:XMIN?
[<source>] (see
page 256)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= voltage at the
top of the waveform in NR3 format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
Table 1 3 :RECall Commands Summary
Command Query Options and Query Returns
:RECall:FILename
<base_name> (see
page 258)
:RECall:IMAGe[:STARt]
[<file_spec>] (see
page 259)
n/a :RECall:PWD? (see
:RECall:SETup[:STARt]
[<file_spec>] (see
page 261)
:RECall:FILename?
(see page 258)
n/a <file_spec> ::= {<internal_loc>
page 260)
n/a <file_spec> ::= {<internal_loc>
<base_name> ::= quoted ASCII
string
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
<path_info> ::= quoted ASCII
string
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
40 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 1 4 :SAVE Commands Summary
Command Query Options and Query Returns
:SAVE:FILename
<base_name> (see
page 264)
:SAVE:IMAGe[:STARt]
[<file_spec>] (see
page 265)
:SAVE:IMAGe:AREA
<area> (see page 266)
:SAVE:IMAGe:FACTors
{{0 | OFF} | {1 |
ON}} (see page 267)
:SAVE:IMAGe:FORMat
<format> (see
page 268)
:SAVE:IMAGe:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 269)
:SAVE:IMAGe:PALette
<palette> (see
page 270)
:SAVE:FILename? (see
page 264)
n/a <file_spec> ::= {<internal_loc>
:SAVE:IMAGe:AREA?
(see page 266)
:SAVE:IMAGe:FACTors?
(see page 267)
:SAVE:IMAGe:FORMat?
(see page 268)
:SAVE:IMAGe:INKSaver?
(see page 269)
:SAVE:IMAGe:PALette?
(see page 270)
<base_name> ::= quoted ASCII
string
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
<area> ::= {GRATicule | SCReen}
{0 | 1}
<format> ::= {TIFF | {BMP |
BMP24bit} | BMP8bit | PNG | NONE}
{0 | 1}
<palette> ::= {COLor | GRAYscale
| MONochrome}
n/a :SAVE:PWD? (see
page 271)
:SAVE:SETup[:STARt]
[<file_spec>] (see
page 272)
:SAVE:WAVeform[:STARt
] [<file_name>] (see
page 273)
:SAVE:WAVeform:FORMat
<format> (see
page 274)
:SAVE:WAVeform:LENGth
<length> (see
page 275)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 41
n/a <file_spec> ::= {<internal_loc>
n/a <file_name> ::= quoted ASCII
:SAVE:WAVeform:FORMat
? (see page 274)
:SAVE:WAVeform:LENGth
? (see page 275)
<path_info> ::= quoted ASCII
string
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
string
<format> ::= {ALB | ASCiixy | CSV
| BINary | NONE}
<length> ::= 100 to max. length;
an integer in NR1 format
2 Commands Quick Reference
Table 1 5 :SBUS Commands Summary
Command Query Options and Query Returns
n/a :SBUS:CAN:COUNt:ERRor
? (see page 278)
n/a :SBUS:CAN:COUNt:OVERl
oad? (see page 279)
:SBUS:CAN:COUNt:RESet
(see page 280)
n/a :SBUS:CAN:COUNt:TOTal
n/a :SBUS:CAN:COUNt:UTILi
:SBUS:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 283)
:SBUS:IIC:ASIZe
<size> (see page 284)
:SBUS:LIN:PARity {{0
| OFF} | {1 | ON}}
(see page 285)
:SBUS:MODE <mode>
(see page 286)
n/a n/a
? (see page 281)
zation? (see
page 282)
:SBUS:DISPlay? (see
page 283)
:SBUS:IIC:ASIZe? (see
page 284)
:SBUS:LIN:PARity?
(see page 285)
:SBUS:MODE? (see
page 286)
<frame_count> ::= integer in NR1
format
<frame_count> ::= integer in NR1
format
<frame_count> ::= integer in NR1
format
<percent> ::= floating-point in
NR3 format
{0 | 1}
<size> ::= {BIT7 | BIT8}
{0 | 1}
<mode> ::= {IIC | SPI | CAN | LIN
| FLEXray | UART}
:SBUS:SPI:WIDTh
<word_width> (see
page 287)
:SBUS:UART:BASE
<base> (see page 288)
n/a :SBUS:UART:COUNt:ERRo
:SBUS:UART:COUNt:RESe
t (see page 290)
n/a :SBUS:UART:COUNt:RXFR
42 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:SBUS:SPI:WIDTh? (see
page 287)
:SBUS:UART:BASE? (see
page 288)
r? (see page 289)
n/a n/a
ames? (see page 291)
<word_width> ::= integer 4-16 in
NR1 format
<base> ::= {ASCii | BINary | HEX}
<frame_count> ::= integer in NR1
format
<frame_count> ::= integer in NR1
format
Commands Quick Reference 2
Table 1 5 :SBUS Commands Summary (continued)
Command Query Options and Query Returns
n/a :SBUS:UART:COUNt:TXFR
ames? (see page 292)
:SBUS:UART:FRAMing
<value> (see
page 293)
:SBUS:UART:FRAMing?
(see page 293)
<frame_count> ::= integer in NR1
format
<value> ::= {OFF | <decimal> |
<nondecimal>}
<decimal> ::= 8-bit integer from
0-255 (0x00-0xff)
<nondecimal> ::= #Hnn where n ::=
{0,..,9 | A,..,F} for hexadecimal
<nondecimal> ::= #Bnn...n where n
::= {0 | 1} for binary
Table 1 6 :SYSTem Commands Summary
Command Query Options and Query Returns
:SYSTem:DATE <date>
(see page 295)
:SYSTem:DATE? (see
page 295)
<date> ::= <year>,<month>,<day>
<year> ::= 4-digit year in NR1
format
<month> ::= {1,..,12 | JANuary |
FEBruary | MARch | APRil | MAY |
JUNe | JULy | AUGust | SEPtember
| OCTober | NOVember | DECember}
<day> ::= {1,..31}
:SYSTem:DSP <string>
(see page 296)
n/a :SYSTem:ERRor? (see
:SYSTem:LOCK (see
page 298)
:SYSTem:SETup
<setup_data> (see
page 299)
:SYSTem:TIME <time>
(see page 301)
n/a <string> ::= up to 254 characters
page 297)
:SYSTem:LOCK? (see
page 298)
:SYSTem:SETup? (see
page 299)
:SYSTem:TIME? (see
page 301)
as a quoted ASCII string
<error> ::= an integer error code
<error string> ::= quoted ASCII
string.
See Error Messages (see
page 499).
<value> ::= {ON | OFF}
<setup_data> ::= data in IEEE
488.2 # format.
<time> ::= hours,minutes,seconds
in NR1 format
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 43
2 Commands Quick Reference
Table 1 7 :TIMebase Commands Summary
Command Query Options and Query Returns
:TIMebase:MODE
<value> (see
page 304)
:TIMebase:POSition
<pos> (see page 305)
:TIMebase:RANGe
<range_value> (see
page 306)
:TIMebase:REFerence
{LEFT | CENTer |
RIGHt} (see page 307)
:TIMebase:SCALe
<scale_value> (see
page 308)
:TIMebase:VERNier {{0
| OFF} | {1 | ON}}
(see page 309)
:TIMebase:WINDow:POSi
tion <pos> (see
page 310)
:TIMebase:MODE? (see
page 304)
:TIMebase:POSition?
(see page 305)
:TIMebase:RANGe? (see
page 306)
:TIMebase:REFerence?
(see page 307)
:TIMebase:SCALe? (see
page 308)
:TIMebase:VERNier?
(see page 309)
:TIMebase:WINDow:POSi
tion? (see page 310)
<value> ::= {MAIN | WINDow | XY |
ROLL}
<pos> ::= time from the trigger
event to the display reference
point in NR3 format
<range_value> ::= 10 ns through
500 s in NR3 format
<return_value> ::= {LEFT | CENTer
| RIGHt}
<scale_value> ::= scale value in
seconds in NR3 format
{0 | 1}
<pos> ::= time from the trigger
event to the delayed view
reference point in NR3 format
:TIMebase:WINDow:RANG
e <range_value> (see
page 311)
:TIMebase:WINDow:SCAL
e <scale_value> (see
page 312)
:TIMebase:WINDow:RANG
e? (see page 311)
:TIMebase:WINDow:SCAL
e? (see page 312)
<range value> ::= range value in
seconds in NR3 format for the
delayed window
<scale_value> ::= scale value in
seconds in NR3 format for the
delayed window
Table 1 8 General :TRIGger Commands Summary
Command Query Options and Query Returns
:TRIGger:HFReject {{0
| OFF} | {1 | ON}}
(see page 317)
:TRIGger:HOLDoff
<holdoff_time> (see
page 318)
:TRIGger:HFReject?
(see page 317)
:TRIGger:HOLDoff?
(see page 318)
{0 | 1}
<holdoff_time> ::= 60 ns to 10 s
in NR3 format
44 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 1 8 General :TRIGger Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:MODE <mode>
(see page 319)
:TRIGger:NREJect {{0
| OFF} | {1 | ON}}
(see page 320)
:TRIGger:PATTern
<value>, <mask>
[,<edge
source>,<edge>] (see
page 321)
:TRIGger:SWEep
<sweep> (see
page 323)
:TRIGger:MODE? (see
page 319)
:TRIGger:NREJect?
(see page 320)
:TRIGger:PATTern?
(see page 321)
:TRIGger:SWEep? (see
page 323)
<mode> ::= {EDGE | GLITch |
PATTern | DURation | TV}
<return_value> ::= {<mode> |
<none>}
<none> ::= query returns "NONE"
if the :TIMebase:MODE is ROLL or
XY
{0 | 1}
<value> ::= integer in NR1 format
or <string>
<mask> ::= integer in NR1 format
or <string>
<string> ::= "0xnn"; n ::=
{0,..,9 | A,..,F} (# bits = #
channels)
<edge source> ::= {CHANnel<n> |
EXTernal | NONE}
<edge> ::= {POSitive | NEGative}
<n> ::= 1-2 or 1-4 in NR1 format
<sweep> ::= {AUTO | NORMal}
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 45
2 Commands Quick Reference
Table 1 9 :TRIGger:CAN Commands Summary
Command Query Options and Query Returns
:TRIGger:CAN:PATTern:
DATA <value>, <mask>
(see page 326)
:TRIGger:CAN:PATTern:
DATA:LENGth <length>
(see page 327)
:TRIGger:CAN:PATTern:
ID <value>, <mask>
(see page 328)
:TRIGger:CAN:PATTern:
DATA? (see page 326)
:TRIGger:CAN:PATTern:
DATA:LENGth? (see
page 327)
:TRIGger:CAN:PATTern:
ID? (see page 328)
<value> ::= 64-bit integer in
decimal, <nondecimal>, or
<string> (with Option AMS)
<mask> ::= 64-bit integer in
decimal, <nondecimal>, or
<string>
<nondecimal> ::= #Hnn...n where n
::= {0,..,9 | A,..,F} for
hexadecimal
<nondecimal> ::= #Bnn...n where n
::= {0 | 1} for binary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F} for
hexadecimal
<length> ::= integer from 1 to 8
in NR1 format (with Option AMS)
<value> ::= 32-bit integer in
decimal, <nondecimal>, or
<string> (with Option AMS)
<mask> ::= 32-bit integer in
decimal, <nondecimal>, or
<string>
<nondecimal> ::= #Hnn...n where n
::= {0,..,9 | A,..,F} for
hexadecimal
<nondecimal> ::= #Bnn...n where n
::= {0 | 1} for binary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F} for
hexadecimal
:TRIGger:CAN:PATTern:
ID:MODE <value> (see
page 329)
:TRIGger:CAN:SAMPlepo
int <value> (see
page 330)
:TRIGger:CAN:SIGNal:B
AUDrate <baudrate>
(see page 331)
46 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:TRIGger:CAN:PATTern:
ID:MODE? (see
page 329)
:TRIGger:CAN:SAMPlepo
int? (see page 330)
:TRIGger:CAN:SIGNal:B
AUDrate? (see
page 331)
<value> ::= {STANdard | EXTended}
(with Option AMS)
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
<baudrate> ::= {10000 | 20000 |
33300 | 50000 | 62500 | 83300 |
100000 | 125000 | 250000 | 500000
| 800000 | 1000000}
Commands Quick Reference 2
Table 1 9 :TRIGger:CAN Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:CAN:SOURce
<source> (see
page 332)
:TRIGger:CAN:TRIGger
<condition> (see
page 333)
:TRIGger:CAN:SOURce?
(see page 332)
:TRIGger:CAN:TRIGger?
(see page 334)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
<condition> ::= {SOF} (without
Option AMS)
<condition> ::= {SOF | DATA |
ERRor | IDData | IDEither |
IDRemote | ALLerrors | OVERload |
ACKerror} (with Option AMS)
Table 2 0 :TRIGger:DURation Commands Summary
Command Query Options and Query Returns
:TRIGger:DURation:GRE
aterthan <greater
than time>[suffix]
(see page 336)
:TRIGger:DURation:LES
Sthan <less than
time>[suffix] (see
page 337)
:TRIGger:DURation:GRE
aterthan? (see
page 336)
:TRIGger:DURation:LES
Sthan? (see page 337)
<greater than time> ::=
floating-point number from 5 ns
to 10 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
<less than time> ::=
floating-point number from 5 ns
to 10 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:DURation:PAT
Tern <value>, <mask>
(see page 338)
:TRIGger:DURation:QUA
Lifier <qualifier>
(see page 339)
:TRIGger:DURation:RAN
Ge <greater than
time>[suffix], <less
than time>[suffix]
(see page 340)
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 47
:TRIGger:DURation:PAT
Tern? (see page 338)
:TRIGger:DURation:QUA
Lifier? (see
page 339)
:TRIGger:DURation:RAN
Ge? (see page 340)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= ""0xnnnnnn"" n ::=
{0,..,9 | A,..,F}
<qualifier> ::= {GREaterthan |
LESSthan | INRange | OUTRange |
TIMeout}
<greater than time> ::= min
duration from 10 ns to
9.99 seconds in NR3 format
<less than time> ::= max duration
from 15 ns to 10 seconds in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
2 Commands Quick Reference
Table 2 1 :TRIGger[:EDGE] Commands Summary
Command Query Options and Query Returns
:TRIGger[:EDGE]:COUPl
ing {AC | DC | LF}
(see page 342)
:TRIGger[:EDGE]:LEVel
<level> [,<source>]
(see page 343)
:TRIGger[:EDGE]:REJec
t {OFF | LF | HF}
(see page 344)
:TRIGger[:EDGE]:SLOPe
<polarity> (see
page 345)
:TRIGger[:EDGE]:SOURc
e <source> (see
page 346)
:TRIGger[:EDGE]:COUPl
ing? (see page 342)
:TRIGger[:EDGE]:LEVel
? [<source>] (see
page 343)
:TRIGger[:EDGE]:REJec
t? (see page 344)
:TRIGger[:EDGE]:SLOPe
? (see page 345)
:TRIGger[:EDGE]:SOURc
e? (see page 346)
{AC | DC | LF}
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers, <level>
::= 2 volts with probe
attenuation at 1:1 in NR3 format.
<source> ::= {CHANnel<n> |
EXTernal}
<n> ::= 1-2 or 1-4 in NR1 format
{OFF | LF | HF}
<polarity> ::= {POSitive |
NEGative | EITHer | ALTernate}
<source> ::= {CHANnel<n> |
EXTernal}
<n> ::= 1-2 or 1-4 in NR1 format
Table 2 2 :TRIGger:GLITch Commands Summary
Command Query Options and Query Returns
:TRIGger:GLITch:GREat
erthan <greater than
time>[suffix] (see
page 348)
:TRIGger:GLITch:LESSt
han <less than
time>[suffix] (see
page 349)
:TRIGger:GLITch:GREat
erthan? (see
page 348)
:TRIGger:GLITch:LESSt
han? (see page 349)
<greater than time> ::=
floating-point number from 5 ns
to 10 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
<less than time> ::=
floating-point number from 5 ns
to 10 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
48 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 2 2 :TRIGger:GLITch Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:GLITch:LEVel
<level> [<source>]
(see page 350)
:TRIGger:GLITch:POLar
ity <polarity> (see
page 351)
:TRIGger:GLITch:QUALi
fier <qualifier> (see
page 352)
:TRIGger:GLITch:RANGe
<greater than
time>[suffix], <less
than time>[suffix]
(see page 353)
:TRIGger:GLITch:LEVel
? (see page 350)
:TRIGger:GLITch:POLar
ity? (see page 351)
:TRIGger:GLITch:QUALi
fier? (see page 352)
:TRIGger:GLITch:RANGe
? (see page 353)
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers, <level>
::= 2 volts with probe
attenuation at 1:1 in NR3 format.
<source> ::= {CHANnel<n> |
EXTernal}
<n> ::= 1-2 or 1-4 in NR1 format
<polarity> ::= {POSitive |
NEGative}
<qualifier> ::= {GREaterthan |
LESSthan | RANGe}
<greater than time> ::= start
time from 10 ns to 9.99 seconds
in NR3 format
<less than time> ::= stop time
from 15 ns to 10 seconds in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:SOURc
e <source> (see
page 354)
:TRIGger:GLITch:SOURc
e? (see page 354)
<source> ::= {CHANnel<n> |
EXTernal}
<n> ::= 1-2 or 1-4 in NR1 format
Table 2 3 :TRIGger:IIC Commands Summary
Command Query Options and Query Returns
:TRIGger:IIC:PATTern:
ADDRess <value> (see
page 356)
:TRIGger:IIC:PATTern:
DATA <value> (see
page 357)
:TRIGger:IIC:PATTern:
DATa2 <value> (see
page 358)
:TRIGger:IIC:PATTern:
ADDRess? (see
page 356)
:TRIGger:IIC:PATTern:
DATA? (see page 357)
:TRIGger:IIC:PATTern:
DATa2? (see page 358)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 49
2 Commands Quick Reference
Table 2 3 :TRIGger:IIC Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:IIC[:SOURce]
:CLOCk <source> (see
page 359)
:TRIGger:IIC[:SOURce]
:DATA <source> (see
page 360)
:TRIGger:IIC:TRIGger:
QUALifier <value>
(see page 361)
:TRIGger:IIC:TRIGger[
:TYPE] <type> (see
page 362)
Table 2 4 :TRIGger:LIN Commands Summary
:TRIGger:IIC[:SOURce]
:CLOCk? (see
page 359)
:TRIGger:IIC[:SOURce]
:DATA? (see page 360)
:TRIGger:IIC:TRIGger:
QUALifier? (see
page 361)
:TRIGger:IIC:TRIGger[
:TYPE]? (see
page 362)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
<value> ::= {EQUal | NOTequal |
LESSthan | GREaterthan}
<type> ::= {STARt | STOP | READ7
| READEprom | WRITe7 | WRITe10 |
NACKnowledge | ANACknowledge |
R7Data2 | W7Data2 | RESTart}
Command Query Options and Query Returns
:TRIGger:LIN:ID
<value> (see
page 365)
:TRIGger:LIN:SAMPlepo
int <value> (see
page 366)
:TRIGger:LIN:SIGNal:B
AUDrate <baudrate>
(see page 367)
:TRIGger:LIN:ID? (see
page 365)
:TRIGger:LIN:SAMPlepo
int? (see page 366)
:TRIGger:LIN:SIGNal:B
AUDrate? (see
page 367)
<value> ::= 7-bit integer in
decimal, <nondecimal>, or
<string> from 0-63 or 0x00-0x3f
(with Option AMS)
<nondecimal> ::= #Hnn where n ::=
{0,..,9 | A,..,F} for hexadecimal
<nondecimal> ::= #Bnn...n where n
::= {0 | 1} for binary
<string> ::= "0xnn" where n ::=
{0,..,9 | A,..,F} for hexadecimal
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
<baudrate> ::= {2400 | 9600 |
19200}
50 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 2 4 :TRIGger:LIN Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:LIN:SOURce
<source> (see
page 368)
:TRIGger:LIN:STANdard
<std> (see page 369)
:TRIGger:LIN:SYNCbrea
k <value> (see
page 370)
:TRIGger:LIN:TRIGger
<condition> (see
page 371)
:TRIGger:LIN:SOURce?
(see page 368)
:TRIGger:LIN:STANdard
? (see page 369)
:TRIGger:LIN:SYNCbrea
k? (see page 370)
:TRIGger:LIN:TRIGger?
(see page 371)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
<std> ::= {LIN13 | LIN20}
<value> ::= integer = {11 | 12 |
13}
<condition> ::= {SYNCbreak}
(without Option AMS)
<condition> ::= {SYNCbreak | ID}
(with Option AMS)
Table 2 5 :TRIGger:TV Commands Summary
Command Query Options and Query Returns
:TRIGger:TV:LINE
<line number> (see
page 382)
:TRIGger:TV:LINE?
(see page 382)
<line number> ::= integer in NR1
format
:TRIGger:TV:MODE <tv
mode> (see page 383)
:TRIGger:TV:POLarity
<polarity> (see
page 384)
:TRIGger:TV:SOURce
<source> (see
page 385)
:TRIGger:TV:STANdard
<standard> (see
page 386)
:TRIGger:TV:MODE?
(see page 383)
:TRIGger:TV:POLarity?
(see page 384)
:TRIGger:TV:SOURce?
(see page 385)
:TRIGger:TV:STANdard?
(see page 386)
<tv mode> ::= {FIEld1 | FIEld2 |
AFIelds | ALINes | LINE |
VERTical | LFIeld1 | LFIeld2 |
LALTernate | LVERtical}
<polarity> ::= {POSitive |
NEGative}
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 integer in NR1
format
<standard> ::= {GENeric | NTSC |
PALM | PAL | SECam | {P480L60HZ |
P480} | {P720L60HZ | P720} |
{P1080L24HZ | P1080} | P1080L25HZ
| {I1080L50HZ | I1080} |
I1080L60HZ}
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 51
2 Commands Quick Reference
Table 2 6 :TRIGger:UART Commands Summary
Command Query Options and Query Returns
:TRIGger:UART:BAUDrat
e <baudrate> (see
page 389)
:TRIGger:UART:BITorde
r <bitorder> (see
page 390)
:TRIGger:UART:BURSt
<value> (see
page 391)
:TRIGger:UART:DATA
<value> (see
page 392)
:TRIGger:UART:IDLE
<time_value> (see
page 393)
:TRIGger:UART:BAUDrat
e? (see page 389)
:TRIGger:UART:BITorde
r? (see page 390)
:TRIGger:UART:BURSt?
(see page 391)
:TRIGger:UART:DATA?
(see page 392)
:TRIGger:UART:IDLE?
(see page 393)
<baudrate> ::= {1200 | 1800 |
2000 | 2400 | 3600 | 4800 | 7200
| 9600 | 14400 | 15200 | 19200 |
28800 | 38400 | 56000 | 57600 |
76800 | 115200 | 128000 | 230400
| 460800 | 921600 | 1382400 |
1843200 | 2764800}
<bitorder> ::= {LSBFirst |
MSBFirst}
<value> ::= {OFF | 1 to 4096 in
NR1 format}
<value> ::= 8-bit integer in
decimal or <nondecimal> from
0-255 (0x00-0xff)
<nondecimal> ::= #Hnn where n ::=
{0,..,9 | A,..,F} for hexadecimal
<nondecimal> ::= #Bnn...n where n
::= {0 | 1} for binary
<time_value> ::= time from 10 us
to 10 s in NR3 format
:TRIGger:UART:PARity
<parity> (see
page 394)
:TRIGger:UART:POLarit
y <polarity> (see
page 395)
:TRIGger:UART:QUALifi
er <value> (see
page 396)
:TRIGger:UART:SOURce:
RX <source> (see
page 397)
:TRIGger:UART:PARity?
(see page 394)
:TRIGger:UART:POLarit
y? (see page 395)
:TRIGger:UART:QUALifi
er? (see page 396)
:TRIGger:UART:SOURce:
RX? (see page 397)
<parity> ::= {EVEN | ODD | NONE}
<polarity> ::= {HIGH | LOW}
<value> ::= {EQUal | NOTequal |
GREaterthan | LESSthan}
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
52 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference 2
Table 2 6 :TRIGger:UART Commands Summary (continued)
Command Query Options and Query Returns
:TRIGger:UART:SOURce:
TX <source> (see
page 398)
:TRIGger:UART:TYPE
<value> (see
page 399)
:TRIGger:UART:WIDTh
<width> (see
page 400)
:TRIGger:UART:SOURce:
TX? (see page 398)
:TRIGger:UART:TYPE?
(see page 399)
:TRIGger:UART:WIDTh?
(see page 400)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
<value> ::= {RSTArt | RSTop |
RDATa | RD1 | RD0 | RDX |
PARityerror | TSTArt | TSTOp |
TDATa | TD1 | TD0 | TDX}
<width> ::= {5 | 6 | 7 | 8 | 9}
Table 2 7 :WAVeform Commands Summary
Command Query Options and Query Returns
:WAVeform:BYTeorder
<value> (see
page 408)
n/a :WAVeform:COUNt? (see
:WAVeform:BYTeorder?
(see page 408)
page 409)
<value> ::= {LSBFirst | MSBFirst}
<count> ::= an integer from 1 to
65536 in NR1 format
n/a :WAVeform:DATA? (see
page 410)
:WAVeform:FORMat
<value> (see
page 412)
:WAVeform:FORMat?
(see page 412)
<binary block length bytes>,
<binary data>
For example, to transmit 1000
bytes of data, the syntax would
be: #800001000<1000 bytes of
data><NL>
8 is the number of digits that
follow
00001000 is the number of bytes
to be transmitted
<1000 bytes of data> is the
actual data
<value> ::= {WORD | BYTE | ASCII}
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 53
2 Commands Quick Reference
Table 2 7 :WAVeform Commands Summary (continued)
Command Query Options and Query Returns
:WAVeform:POINts
<# points> (see
page 413)
:WAVeform:POINts:MODE
<points_mode> (see
page 415)
n/a :WAVeform:PREamble?
:WAVeform:POINts?
(see page 413)
:WAVeform:POINts:MODE
? (see page 415)
(see page 417)
<# points> ::= {100 | 250 | 500 |
1000 | <points_mode>} if waveform
points mode is NORMal
<# points> ::= {100 | 250 | 500 |
1000 | 2000 ... 8000000 in 1-2-5
sequence | <points_mode>} if
waveform points mode is MAXimum
or RAW
<points_mode> ::= {NORMal |
MAXimum | RAW}
<points_mode> ::= {NORMal |
MAXimum | RAW}
<preamble_block> ::= <format
NR1>, <type NR1>,<points
NR1>,<count NR1>, <xincrement
NR3>, <xorigin NR3>, <xreference
NR1>,<yincrement NR3>, <yorigin
NR3>, <yreference NR1>
<format> ::= an integer in NR1
format:
• 0 for BYTE format
• 1 for WORD format
• 2 for ASCii format
<type> ::= an integer in NR1
format:
• 0 for NORMal type
• 1 for PEAK detect type
• 2 for AVERage type
• 3 for HRESolution type
<count> ::= Average count, or 1
if PEAK detect type or NORMal; an
integer in NR1 format
:WAVeform:SOURce
<source> (see
page 420)
:WAVeform:SOURce:SUBS
ource <subsource>
(see page 424)
n/a :WAVeform:TYPE? (see
54 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:WAVeform:SOURce?
(see page 420)
:WAVeform:SOURce:SUBS
ource? (see page 424)
page 425)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<subsource> ::= {{NONE | RX} |
TX}
<return_mode> ::= {NORM | PEAK |
AVER | HRES}
Commands Quick Reference 2
Table 2 7 :WAVeform Commands Summary (continued)
Command Query Options and Query Returns
:WAVeform:UNSigned
{{0 | OFF} | {1 |
ON}} (see page 426)
:WAVeform:VIEW <view>
(see page 427)
n/a :WAVeform:XINCrement?
n/a :WAVeform:XORigin?
n/a :WAVeform:XREFerence?
n/a :WAVeform:YINCrement?
n/a :WAVeform:YORigin?
n/a :WAVeform:YREFerence?
:WAVeform:UNSigned?
(see page 426)
:WAVeform:VIEW? (see
page 427)
(see page 428)
(see page 429)
(see page 430)
(see page 431)
(see page 432)
(see page 433)
{0 | 1}
<view> ::= {MAIN}
<return_value> ::= x-increment
in the current preamble in NR3
format
<return_value> ::= x-origin
value in the current preamble in
NR3 format
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
<return_value> ::= y-origin in
the current preamble in NR3
format
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 55
2 Commands Quick Reference
Syntax Elements
• "Number Format" on page 56
• "<NL> (Line Terminator)" on page 56
• "[ ] (Optional Syntax Terms)" on page 56
• "{ } (Braces)" on page 56
• "::= (Defined As)" on page 56
• "< > (Angle Brackets)" on page 57
• "... (Ellipsis)" on page 57
• "n,..,p (Value Ranges)" on page 57
• "d (Digits)" on page 57
• "Quoted ASCII String" on page 57
• "Definite- Length Block Response Data" on page 57
Number Format
NR1 specifies integer data.
NR3 specifies exponential data in floating point format (for example,
-1.0E-3).
<NL> (Line Terminator)
<NL> = new line or linefeed (ASCII decimal 10).
The line terminator, or a leading colon, will send the parser to the "root"
of the command tree.
[ ] (Optional Syntax Terms)
Items enclosed in square brackets, [ ], are optional.
{ } (Braces)
When several items are enclosed by braces, { }, only one of these elements
may be selected. Vertical line ( | ) indicates "or". For example, {ON | OFF}
indicates that only ON or OFF may be selected, not both.
::= (Defined As)
::= means "defined as".
56 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
For example, <A> ::= <B> indicates that <A> can be replaced by <B> in any
statement containing <A>.
< > (Angle Brackets)
< > Angle brackets enclose words or characters that symbolize a program
code parameter or an interface command.
... (Ellipsis)
... An ellipsis (trailing dots) indicates that the preceding element may be
repeated one or more times.
n,..,p (Value Ranges)
n,..,p ::= all integers between n and p inclusive.
d (Digits)
Commands Quick Reference 2
d ::= A single ASCII numeric character 0 - 9.
Quoted ASCII String
A quoted ASCII string is a string delimited by either double quotes (") or
single quotes ('). Some command parameters require a quoted ASCII
string. For example, when using the Agilent VISA COM library in Visual
Basic, the command:
myScope.WriteString ":CHANNEL1:LABEL 'One'"
has a quoted ASCII string of:
'One'
In order to read quoted ASCII strings from query return values, some
programming languages require special handling or syntax.
Definite-Length Block Response Data
Definite- length block response data allows any type of device-dependent
data to be transmitted over the system interface as a series of 8- bit binary
data bytes. This is particularly useful for sending large quantities of data
or 8- bit extended ASCII codes. This syntax is a pound sign (#) followed by
a non- zero digit representing the number of digits in the decimal integer.
After the non-zero digit is the decimal integer that states the number of
8- bit data bytes being sent. This is followed by the actual data.
For example, for transmitting 1000 bytes of data, the syntax would be
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 57
2 Commands Quick Reference
#800001000<1000 bytes of data> <NL>
8 is the number of digits that follow
00001000 is the number of bytes to be transmitted
<1000 bytes of data> is the actual data
58 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Agilent InfiniiVision 5000 Series Oscilloscopes
Programmer's Reference
3
Commands by Subsystem
Subsystem Description
"Common (*) Commands" on page 61 Commands defined by IEEE 488.2 standard that
are common to all instruments.
"Root (:) Commands" on page 86 Control many of the basic functions of the
oscilloscope and reside at the root level of the
command tree.
":ACQuire Commands" on page 123 Set the parameters for acquiring and storing
data.
":CALibrate Commands" on page 134 Utility commands for determining the state of
the calibration factor protection switch.
":CHANnel<n> Commands" on page 142 Control all oscilloscope functions associated
with individual analog channels or groups of
channels.
":DISPlay Commands" on page 161 Control how waveforms, graticule, and text are
displayed and written on the screen.
":EXTernal Trigger Commands" on page 171 Control the input characteristics of the external
trigger input.
":FUNCtion Commands" on page 181 Control functions in the measurement/storage
module.
":HARDcopy Commands" on page 193 Set and query the selection of hardcopy device
and formatting options.
":MARKer Commands" on page 203 Set and query the settings of X-axis markers
(X1 and X2 cursors) and the Y-axis markers (Y1
and Y2 cursors).
":MEASure Commands" on page 214 Select automatic measurements to be made
and control time markers.
":RECall Commands" on page 257 Recall previously saved oscilloscope setups
and traces.
":SAVE Commands" on page 262 Save oscilloscope setups and traces, screen
images, and data.
A
59
3 Commands by Subsystem
Subsystem Description
":SBUS Commands" on page 276 Control oscilloscope functions associated with
":SYSTem Commands" on page 294 Control basic system functions of the
":TIMebase Commands" on page 302 Control all horizontal sweep functions.
":TRIGger Commands" on page 313 Control the trigger modes and parameters for
":WAVeform Commands" on page 401 Provide access to waveform data.
Command Types Three types of commands are used:
• Common (*) Commands — See "Introduction to Common (*)
Commands" on page 63 for more information.
• Root Level (:) Commands — See "Introduction to Root (:) Commands"
on page 88 for more information.
the serial decode bus.
oscilloscope.
each trigger type.
• Subsystem Commands — Subsystem commands are grouped together
under a common node of the "Command Tree" on page 535, such as the
:TIMebase commands. Only one subsystem may be selected at any given
time. When the instrument is initially turned on, the command parser is
set to the root of the command tree; therefore, no subsystem is
selected.
60 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3
Common (*) Commands
Commands defined by IEEE 488.2 standard that are common to all
instruments. See "Introduction to Common (*) Commands" on page 63.
Table 2 8 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.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 61
3 Commands by Subsystem
Table 2 8 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)
n/a <value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*SAV <value> (see
page 78)
*SRE <mask> (see
page 79)
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
62 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3
Table 2 8 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
Introduction to
Common (*)
Commands
The common commands are defined by the IEEE 488.2 standard. They are
implemented by all instruments that comply with the IEEE 488.2 standard.
They provide some of the basic instrument functions, such as instrument
identification and reset, reading the instrument setup, and determining
how status is read and cleared.
Common commands can be received and processed by the instrument
whether they are sent over the interface as separate program messages or
within other program messages. If an instrument subsystem has been
selected and a common command is received by the instrument, the
instrument remains in the selected subsystem. For example, if the program
message ":ACQuire:TYPE AVERage; *CLS; COUNt 256" is received by the
instrument, the instrument sets the acquire type, then clears the status
information and sets the average count.
In contrast, if a root level command or some other subsystem command is
within the program message, you must re-enter the original subsystem
after the command. For example, the program message ":ACQuire:TYPE
AVERage; :AUToscale; :ACQuire:COUNt 256" sets the acquire type,
completes the autoscale, then sets the acquire count. In this example,
:ACQuire must be sent again after the :AUToscale command in order to
re- enter the ACQuire subsystem and set the count.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 63
3 Commands by Subsystem
NOTE
Each of the status registers has an enable (mask) register. By setting the bits in the enable
register, you can select the status information you want to use.
64 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*CLS (Clear Status)
(see page 530)
Commands by Subsystem 3
Command Syntax
NOTE
See Also • "Introduction to Common (*) Commands" on page 63
*CLS
The *CLS common command clears the status data structures, the
device-defined error queue, and the Request-for- OPC flag.
If the *CLS command immediately follows a program message terminator, the output queue
and the MAV (message available) bit are cleared.
• "*STB (Read Status Byte)" on page 81
• "*ESE (Standard Event Status Enable)" on page 66
• "*ESR (Standard Event Status Register)" on page 68
• "*SRE (Service Request Enable)" on page 79
• ":SYSTem:ERRor" on page 297
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 65
3 Commands by Subsystem
*ESE (Standard Event Status Enable)
(see page 530)
Command Syntax
*ESE <mask_argument>
<mask_argument> ::= integer from 0 to 255
The *ESE common command sets the bits in the Standard Event Status
Enable Register. The Standard Event Status Enable Register contains a
mask value for the bits to be enabled in the Standard Event Status
Register. A "1" in the Standard Event Status Enable Register enables the
corresponding bit in the Standard Event Status Register. A zero disables
the bit.
321 854 (;( ''( 4<( 54/ 23&&0(
(65"
(6(
(6("
6WDQGDUG(YHQW
6WDWXV5HJLVWHU
6WDQGDUG(YHQW
6WDWXV(QDEOH
0DVN5HJLVWHU
25
7R(6%ELWLQ
6WDWXV%\WH
5HJLVWHU
Table 2 9 Standard Event Status Enable (ESE)
Bit Name Description When Set (1 = High = True), Enables:
7 PON Power On Event when an OFF to ON transition occurs.
6 URQ User Request Event when a front-panel key is pressed.
5 CME Command Error Event when a command error is detected.
4 EXE Execution Error Event when an execution error is detected.
3 DDE Device Dependent Error Event when a device-dependent error is detected.
2 QYE Query Error Event when a query error is detected.
66 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Table 2 9 Standard Event Status Enable (ESE) (continued)
Bit Name Description When Set (1 = High = True), Enables:
1 RQL Request Control Event when the device is requesting control. (Not
0 OPC Operation Complete Event when an operation is complete.
Query Syntax *ESE?
The *ESE? query returns the current contents of the Standard Event
Status Enable Register.
Commands by Subsystem 3
used.)
Return Format
See Also • "Introduction to Common (*) Commands" on page 63
<mask_argument><NL>
<mask_argument> ::= 0,..,255; an integer in NR1 format.
• "*ESR (Standard Event Status Register)" on page 68
• "*OPC (Operation Complete)" on page 72
• "*CLS (Clear Status)" on page 65
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 67
3 Commands by Subsystem
*ESR (Standard Event Status Register)
(see page 530)
Query Syntax
*ESR?
The *ESR? query returns the contents of the Standard Event Status
Register. When you read the Event Status Register, the value returned is
the total bit weights of all of the bits that are high at the time you read
the byte. Reading the register clears the Event Status Register.
The following table shows bit weight, name, and condition for each bit.
321 854 (;( ''( 4<( 54/ 23&&0(
25
(65"
(6(
(6("
6WDQGDUG(YHQW
6WDWXV5HJLVWHU
6WDQGDUG(YHQW
6WDWXV(QDEOH
0DVN5HJLVWHU
7R(6%ELWLQ
6WDWXV%\WH
5HJLVWHU
Table 3 0 Standard Event Status Register (ESR)
Bit Name Description When Set (1 = High = True), Indicates:
7 PON Power On An OFF to ON transition has occurred.
6 URQ User Request A front-panel key has been pressed.
5 CME Command Error A command error has been detected.
4 EXE Execution Error An execution error has been detected.
3 DDE Device Dependent Error A device-dependent error has been detected.
2 QYE Query Error A query error has been detected.
68 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Table 3 0 Standard Event Status Register (ESR) (continued)
Bit Name Description When Set (1 = High = True), Indicates:
1 RQL Request Control The device is requesting control. (Not used.)
0 OPC Operation Complete Operation is complete.
Return Format <status><NL>
<status> ::= 0,..,255; an integer in NR1 format.
Commands by Subsystem 3
NOTE
See Also • "Introduction to Common (*) Commands" on page 63
Reading the Standard Event Status Register clears it. High or 1 indicates the bit is true.
• "*ESE (Standard Event Status Enable)" on page 66
• "*OPC (Operation Complete)" on page 72
• "*CLS (Clear Status)" on page 65
• ":SYSTem:ERRor" on page 297
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 69
3 Commands by Subsystem
*IDN (Identification Number)
(see page 530)
Query Syntax
Return Format
See Also • "Introduction to Common (*) Commands" on page 63
*IDN?
The *IDN? query identifies the instrument type and software version.
AGILENT TECHNOLOGIES,<model>,<serial number>,X.XX.XX <NL>
<model> ::= the model number of the instrument
<serial number> ::= the serial number of the instrument
X.XX.XX ::= the software revision of the instrument
• "*OPT (Option Identification)" on page 73
70 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*LRN (Learn Device Setup)
(see page 530)
Commands by Subsystem 3
Query Syntax
Return Format <learn_string><NL>
NOTE
See Also • "Introduction to Common (*) Commands" on page 63
*LRN?
The *LRN? query result contains the current state of the instrument. This
query is similar to the :SYSTem:SETup? (see page 299) query, except that
it contains ":SYST:SET " before the binary block data. The query result is a
valid command that can be used to restore instrument settings at a later
time.
<learn_string> ::= :SYST:SET <setup_data>
<setup_data> ::= binary block data in IEEE 488.2 # format
<learn string> specifies the current instrument setup. The block size is
subject to change with different firmware revisions.
The *LRN? query return format has changed from previous Agilent oscilloscopes to match
the IEEE 488.2 specification which says that the query result must contain ":SYST:SET "
before the binary block data.
• "*RCL (Recall)" on page 74
• "*SAV (Save)" on page 78
• ":SYSTem:SETup" on page 299
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 71
3 Commands by Subsystem
*OPC (Operation Complete)
(see page 530)
Command Syntax
Query Syntax
Return Format
See Also • "Introduction to Common (*) Commands" on page 63
*OPC
The *OPC command sets the operation complete bit in the Standard Event
Status Register when all pending device operations have finished.
*OPC?
The *OPC? query places an ASCII "1" in the output queue when all
pending device operations have completed. The interface hangs until this
query returns.
<complete><NL>
<complete> ::= 1
• "*ESE (Standard Event Status Enable)" on page 66
• "*ESR (Standard Event Status Register)" on page 68
• "*CLS (Clear Status)" on page 65
72 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*OPT (Option Identification)
(see page 530)
Commands by Subsystem 3
Query Syntax
Return Format
*OPT?
The *OPT? query reports the options installed in the instrument. This
query returns a string that identifies the module and its software revision
level.
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}
The *OPT? query returns the following:
Module Module Id
No modules attached 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
See Also • "Introduction to Common (*) Commands" on page 63
• "*IDN (Identification Number)" on page 70
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 73
3 Commands by Subsystem
*RCL (Recall)
(see page 530)
Command Syntax
See Also • "Introduction to Common (*) Commands" on page 63
*RCL <value>
<value> ::= {0|1|2|3|4|5|6|7|8|9}
The *RCL command restores the state of the instrument from the specified
save/recall register.
• "*SAV (Save)" on page 78
74 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*RST (Reset)
Commands by Subsystem 3
(see page 530)
Command Syntax
*RST
The *RST command places the instrument in a known state. Reset
conditions are:
Acquire Menu
Mode Normal
Realtime On
Averaging Off
# Averages 8
Analog Channel Menu
Channel 1 On
Channel 2 Off
Volts/division 5.00 V
Offset 0.00
Coupling DC
Probe attenuation AutoProbe (if AutoProbe is connected),
otherwise 1.0:1
Vernier Off
Invert Off
BW limit Off
Impedance 1 M Ohm
Units Volts
Skew 0
Cursor Menu
Source Channel 1
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 75
3 Commands by Subsystem
Display Menu
Definite persistence Off
Grid 33%
Vectors On
Quick Meas Menu
Source Channel 1
Run Control
Time Base Menu
Scope is running
Main time/division 100 us
Main time base delay 0.00 s
Delay time/division 500 ns
Delay time base delay 0.00 s
Reference center
Mode main
Vernier Off
Trigger Menu
Ty p e Ed g e
Mode Auto
Coupling dc
Source Channel 1
Level 0.0 V
Slope Positive
HF Reject and noise reject Off
Holdoff 60 ns
External probe attenuation AutoProbe (if AutoProbe is connected),
otherwise 1.0:1
76 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3
Trigger Menu
External Units Volts
External Impedance 1 M Ohm
See Also • "Introduction to Common (*) Commands" on page 63
Example Code
' RESET - This command puts the oscilloscope into a known state.
' This statement is very important for programs to work as expected.
' Most of the following initialization commands are initialized by
' *RST. It is not necessary to reinitialize them unless the default
' setting is not suitable for your application.
myScope.WriteString "*RST" ' Reset the oscilloscope to the defaults.
Example program from the start: "VISA COM Example in Visual Basic" on
page 578
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 77
3 Commands by Subsystem
*SAV (Save)
(see page 530)
Command Syntax
See Also • "Introduction to Common (*) Commands" on page 63
*SAV <value>
<value> ::= {0|1|2|3|4|5|6|7|8|9}
The *SAV command stores the current state of the instrument in a save
register. The data parameter specifies the register where the data will be
saved.
• "*RCL (Recall)" on page 74
78 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*SRE (Service Request Enable)
(see page 530)
Commands by Subsystem 3
Command Syntax
*SRE <mask>
<mask> ::= integer with values defined in the following table.
The *SRE command sets the bits in the Service Request Enable Register.
The Service Request Enable Register contains a mask value for the bits to
be enabled in the Status Byte Register. A one in the Service Request
Enable Register enables the corresponding bit in the Status Byte Register.
A zero disables the bit.
)URP
)URP
2SHUDWLRQ
6WDWXV
5HJLVWHUV
23(5 75*0$9(6%
546
066
6WDQGDUG
(YHQW
6WDWXV
5HJLVWHUV
2XWSXW
4XHXH
06*
865
75*
7(5" 7ULJJHU(YHQW5HJLVWHU
5HJ
67%" 6WDWXV%\WH5HJLVWHU
65(
65("
25
654
Table 3 1 Service Request Enable Register (SRE)
Bit Name Description When Set (1 = High = True), Enables:
7 OPER Operation Status Register Interrupts when enabled conditions in the
6 --- --- (Not used.)
6HUYLFH5HTXHVW
Operation Status Register (OPER) occur.
6HUYLFH5HTXHVW(QDEOH
0DVN5HJLVWHU
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 79
3 Commands by Subsystem
Table 3 1 Service Request Enable Register (SRE) (continued)
Bit Name Description When Set (1 = High = True), Enables:
5 ESB Event Status Bit Interrupts when enabled conditions in the
4 MAV Message Available Interrupts when messages are in the Output
3 --- --- (Not used.)
2 MSG Message Interrupts when an advisory has been displayed
1 USR User Event Interrupts when enabled user event conditions
0 TRG Trigger Interrupts when a trigger occurs.
Query Syntax *SRE?
Standard Event Status Register (ESR) occur.
Queue.
on the oscilloscope.
occur.
The *SRE? query returns the current value of the Service Request Enable
Register.
Return Format
<mask><NL>
<mask> ::= sum of all bits that are set, 0,..,255;
an integer in NR1 format
See Also • "Introduction to Common (*) Commands" on page 63
• "*STB (Read Status Byte)" on page 81
• "*CLS (Clear Status)" on page 65
80 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*STB (Read Status Byte)
(see page 530)
Commands by Subsystem 3
Query Syntax
Return Format
*STB?
The *STB? query returns the current value of the instrument's status byte.
The MSS (Master Summary Status) bit is reported on bit 6 instead of the
RQS (request service) bit. The MSS indicates whether or not the device
has at least one reason for requesting service.
<value><NL>
<value> ::= 0,..,255; an integer in NR1 format
)URP
)URP
2SHUDWLRQ
6WDWXV
5HJLVWHUV
23(5 75*0$9(6%
546
066
6WDQGDUG
(YHQW
6WDWXV
5HJLVWHUV
2XWSXW
4XHXH
06*
865
75*
7(5" 7ULJJHU(YHQW5HJLVWHU
5HJ
67%" 6WDWXV%\WH5HJLVWHU
65(
65("
25
654
Table 3 2 Status Byte Register (STB)
Bit Name Description When Set (1 = High = True), Indicates:
7 OPER Operation Status Register An enabled condition in the Operation Status
6HUYLFH5HTXHVW
Register (OPER) has occurred.
6HUYLFH5HTXHVW(QDEOH
0DVN5HJLVWHU
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 81
3 Commands by Subsystem
Table 3 2 Status Byte Register (STB) (continued)
Bit Name Description When Set (1 = High = True), Indicates:
6 RQS Request Service When polled, that the device is requesting service.
5 ESB Event Status Bit An enabled condition in the Standard Event Status
4 MAV Message Available There are messages in the Output Queue.
3 --- --- (Not used, always 0.)
2 MSG Message An advisory has been displayed on the
1 USR User Event An enabled user event condition has occurred.
0 TRG Trigger A trigger has occurred.
MSS Master Summary Status When read (by *STB?), whether the device has a
reason for requesting service.
Register (ESR) has occurred.
oscilloscope.
NOTE
See Also • "Introduction to Common (*) Commands" on page 63
To read the instrument's status byte with RQS reported on bit 6, use the interface Serial
Poll.
• "*SRE (Service Request Enable)" on page 79
82 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*TRG (Trigger)
Commands by Subsystem 3
(see page 530)
Command Syntax
See Also • "Introduction to Common (*) Commands" on page 63
*TRG
The *TRG command has the same effect as the :DIGitize command with no
parameters.
• ":DIGitize" on page 96
• ":RUN" on page 116
• ":STOP" on page 120
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 83
3 Commands by Subsystem
*TST (Self Test)
(see page 530)
Query Syntax
Return Format
See Also • "Introduction to Common (*) Commands" on page 63
*TST?
The *TST? query performs a self- test on the instrument. The result of the
test is placed in the output queue. A zero indicates the test passed and a
non-zero indicates the test failed. If the test fails, refer to the
troubleshooting section of the Service Guide.
<result><NL>
<result> ::= 0 or non-zero value; an integer in NR1 format
84 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
*WAI (Wait To Continue)
(see page 530)
Commands by Subsystem 3
Command Syntax
See Also • "Introduction to Common (*) Commands" on page 63
*WAI
The *WAI command has no function in the oscilloscope, but is parsed for
compatibility with other instruments.
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 85
3 Commands by Subsystem
Root (:) Commands
Control many of the basic functions of the oscilloscope and reside at the
root level of the command tree. See "Introduction to Root (:) Commands"
on page 88.
Table 3 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)
:CDISplay (see
page 95)
:DIGitize
[<source>[,..,<source
>]] (see page 96)
:HWEenable <n> (see
page 98)
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>} |
n/a n/a
n/a <source> ::= {CHANnel<n> |
:HWEenable? (see
page 98)
<value> ::= {NORMal | CURRent}}
<value> ::= {ALL | DISPlayed}}
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
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/a :HWERregister:CONDiti
on? (see page 100)
n/a :HWERegister[:EVENt]?
(see page 102)
:MERGe <pixel memory>
(see page 104)
:OPEE <n> (see
page 105)
n/a :OPERregister:CONDiti
n/a :OPERegister[:EVENt]?
86 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
n/a <pixel memory> ::= {PMEMory{0 | 1
:OPEE? (see page 106) <n> ::= 16-bit integer in NR1
on? (see page 107)
(see page 109)
<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
Commands by Subsystem 3
Table 3 3 Root (:) Commands Summary (continued)
Command Query Options and Query Returns
:OVLenable <mask>
(see page 111)
n/a :OVLRegister? (see
:PRINt [<options>]
(see page 115)
:OVLenable? (see
page 112)
page 113)
n/a <options> ::= [<print
<mask> ::= 16-bit integer in NR1
format as shown:
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.
: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
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 87
3 Commands by Subsystem
Introduction to
Root (:)
Commands
Root level commands control many of the basic operations of the
instrument. These commands are always recognized by the parser if they
are prefixed with a colon, regardless of current command tree position.
After executing a root- level command, the parser is positioned at the root
of the command tree.
88 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:AER (Arm Event Register)
(see page 530)
Commands by Subsystem 3
Query Syntax
Return Format
See Also • "Introduction to Root (:) Commands" on page 88
:AER?
The AER query reads the Arm Event Register. After the Arm Event
Register is read, it is cleared. A "1" indicates the trigger system is in the
armed state, ready to accept a trigger.
The Armed Event Register is summarized in the Wait Trig bit of the
Operation Status Event Register. A Service Request can be generated when
the Wait Trig bit transitions and the appropriate enable bits have been set
in the Operation Status Enable Register (OPEE) and the Service Request
Enable Register (SRE).
<value><NL>
<value> ::= {0 | 1}; an integer in NR1 format.
• ":OPEE (Operation Status Enable Register)" on page 105
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 107
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 109
• "*STB (Read Status Byte)" on page 81
• "*SRE (Service Request Enable)" on page 79
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 89
3 Commands by Subsystem
:AUToscale
(see page 530)
Command Syntax
:AUToscale
:AUToscale [<source>[,..,<source>]]
<source> ::= CHANnel<n>
<n>::={1|2|3|4}forthefour channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The <source> parameter may be repeated up to 5 times.
The :AUToscale command evaluates all input signals and sets the correct
conditions to display the signals. This is the same as pressing the
Autoscale key on the front panel.
If one or more sources are specified, those specified sources will be
enabled and all others blanked. The autoscale channels mode (see
":AUToscale:CHANnels" on page 93) is set to DISPlayed channels. Then, the
autoscale is performed.
When the :AUToscale command is sent, the following conditions are
affected and actions are taken:
• Thresholds.
• Channels with activity around the trigger point are turned on, others
are turned off.
• Channels are reordered on screen; analog channel 1 first, followed by
the remaining analog channels.
• Delay is set to 0 seconds.
• Time/Div.
The :AUToscale command does not affect the following conditions:
• Label names.
• Trigger conditioning.
The :AUToscale command turns off the following items:
• Cursors.
• Measurements.
• Trace memories.
• Delayed time base mode.
For further information on :AUToscale, see the User's Guide.
See Also • "Introduction to Root (:) Commands" on page 88
• ":AUToscale:CHANnels" on page 93
90 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
• ":AUToscale:AMODE" on page 92
Commands by Subsystem 3
Example Code
' AUTOSCALE - This command evaluates all the input signals and sets
' the correct conditions to display all of the active signals.
myScope.WriteString ":AUTOSCALE" ' Same as pressing Autoscale key.
Example program from the start: "VISA COM Example in Visual Basic" on
page 578
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 91
3 Commands by Subsystem
:AUToscale:AMODE
(see page 530)
Command Syntax
Query Syntax
Return Format
See Also • "Introduction to Root (:) Commands" on page 88
:AUToscale:AMODE <value>
<value> ::= {NORMal | CURRent}
The :AUTOscale:AMODE command specifies the acquisition mode that is
set by subsequent :AUToscales.
• When NORMal is selected, an :AUToscale command sets the NORMal
acquisition type and the RTIMe (real- time) acquisition mode.
• When CURRent is selected, the current acquisition type and mode are
kept on subsequent :AUToscales.
Use the :ACQuire:TYPE and :ACQuire:MODE commands to set the
acquisition type and mode.
:AUToscale:AMODE?
The :AUToscale:AMODE? query returns the autoscale acquire mode setting.
<value><NL>
<value> ::= {NORM | CURR}
• ":AUToscale" on page 90
• ":AUToscale:CHANnels" on page 93
• ":ACQuire:TYPE" on page 132
• ":ACQuire:MODE" on page 129
92 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:AUToscale:CHANnels
(see page 530)
Commands by Subsystem 3
Command Syntax
Query Syntax
Return Format
See Also • "Introduction to Root (:) Commands" on page 88
:AUToscale:CHANnels <value>
<value> ::= {ALL | DISPlayed}
The :AUTOscale:CHANnels command specifies which channels will be
displayed on subsequent :AUToscales.
• When ALL is selected, all channels that meet the requirements of
:AUToscale will be displayed.
• When DISPlayed is selected, only the channels that are turned on are
autoscaled.
Use the :VIEW or :BLANk root commands to turn channels on or off.
:AUToscale:CHANnels?
The :AUToscale:CHANnels? query returns the autoscale channels setting.
<value><NL>
<value> ::= {ALL | DISP}
• ":AUToscale" on page 90
• ":AUToscale:AMODE" on page 92
• ":VIEW" on page 122
• ":BLANk" on page 94
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 93
3 Commands by Subsystem
:BLANk
(see page 530)
Command Syntax
NOTE
NOTE
See Also • "Introduction to Root (:) Commands" on page 88
:BLANk [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n>::={1|2|3|4}forthefour channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :BLANk command turns off (stops displaying) the specified channel or
math function. The :BLANk command with no parameter turns off all
sources.
To turn on (start displaying) a channel, etc., use the :VIEW command. The DISPlay
commands, :CHANnel<n>:DISPlay or :FUNCtion:DISPlay are the preferred method to turn
on/off a channel, etc.
MATH is an alias for FUNCtion.
• ":CDISplay" on page 95
• ":CHANnel<n>:DISPlay" on page 147
• ":FUNCtion:DISPlay" on page 184
• ":STATus" on page 119
• ":VIEW" on page 122
Example Code • "Example Code" on page 122
94 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
:CDISplay
Commands by Subsystem 3
(see page 530)
Command Syntax
See Also • "Introduction to Root (:) Commands" on page 88
:CDISplay
The :CDISplay command clears the display and resets all associated
measurements. If the oscilloscope is stopped, all currently displayed data
is erased. If the oscilloscope is running, all the data in active channels and
functions is erased; however, new data is displayed on the next
acquisition.
• ":DISPlay:CLEar" on page 163
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 95
3 Commands by Subsystem
:DIGitize
(see page 530)
Command Syntax
NOTE
NOTE
:DIGitize [<source>[,..,<source>]]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n>::={1|2|3|4}forthefour channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The <source> parameter may be repeated up to 5 times.
The :DIGitize command is a specialized RUN command. It causes the
instrument to acquire waveforms according to the settings of the :ACQuire
commands subsystem. When the acquisition is complete, the instrument is
stopped. If no argument is given, :DIGitize acquires the channels currently
displayed. If no channels are displayed, all channels are acquired.
To halt a :DIGitize in progress, use the device clear command.
MATH is an alias for FUNCtion.
See Also • "Introduction to Root (:) Commands" on page 88
• ":RUN" on page 116
• ":SINGle" on page 118
• ":STOP" on page 120
• ":ACQuire Commands" on page 123
• ":WAVeform Commands" on page 401
Example Code
' DIGITIZE - Used to acquire the waveform data for transfer over
' the interface. Sending this command causes an acquisition to
' take place with the resulting data being placed in the buffer.
'
' NOTE! The DIGITIZE command is highly recommended for triggering
' modes other than SINGLE. This ensures that sufficient data is
' available for measurement. If DIGITIZE is used with single mode,
' the completion criteria may never be met. The number of points
' gathered in Single mode is related to the sweep speed, memory
' depth, and maximum sample rate. For example, take an oscilloscope
' with a 1000-point memory, a sweep speed of 10 us/div (100 us
' total time across the screen), and a 20 MSa/s maximum sample rate.
' 1000 divided by 100 us equals 10 MSa/s. Because this number is
' less than or equal to the maximum sample rate, the full 1000 points
' will be digitized in a single acquisition. Now, use 1 us/div
' (10 us across the screen). 1000 divided by 10 us equals 100 MSa/s;
96 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3
' because this is greater than the maximum sample rate by 5 times,
' only 400 points (or 1/5 the points) can be gathered on a single
' trigger. Keep in mind when the oscilloscope is running,
' communication with the computer interrupts data acquisition.
' Setting up the oscilloscope over the bus causes the data buffers
' to be cleared and internal hardware to be reconfigured. If a
' measurement is immediately requested, there may have not been
' enough time for the data acquisition process to collect data, and
' the results may not be accurate. An error value of 9.9E+37 may be
' returned over the bus in this situation.
'
myScope.WriteString ":DIGITIZE CHAN1"
Example program from the start: "VISA COM Example in Visual Basic" on
page 578
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 97
3 Commands by Subsystem
:HWEenable (Hardware Event Enable Register)
(see page 530)
Command Syntax
25
7R+:(ELWLQ
2SHUDWLRQ6WDWXV
&RQGLWLRQ5HJLVWHU
:HWEenable <mask>
<mask> ::= 16-bit integer
The :HWEenable command sets a mask in the Hardware Event Enable
register. Set any of the following bits to "1" to enable bit 12 in the
Operation Status Condition Register and potentially cause an SRQ (Service
Request interrupt to be generated.
3//
/RFNHG
3//
/RFNHG
+:(5HJLVWHU&21'LWLRQ"
+DUGZDUH(YHQW&RQGLWLRQ5HJLVWHU
+:(5HJLVWHU>(9(1W@"
+DUGZDUH(YHQW(YHQW5HJLVWHU
+:(HQDEOH
+:(HQDEOH"
+DUGZDUH(YHQW(QDEOH0DVN5HJLVWHU
Table 3 4 Hardware Event Enable Register (HWEenable)
Bit Name Description When Set (1 = High = True), Enables:
15-13 --- --- (Not used.)
12 PLL
Locked
PLL Locked This bit is for internal use and is not intended
for general use.
11-0 --- --- (Not used.)
Query Syntax
:HWEenable?
The :HWEenable? query returns the current value contained in the
Hardware Event Enable register as an integer number.
Return Format
<value><NL>
<value> ::= integer in NR1 format.
See Also • "Introduction to Root (:) Commands" on page 88
98 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem 3
• ":AER (Arm Event Register)" on page 89
• ":CHANnel<n>:PROTection" on page 156
• ":EXTernal:PROTection" on page 178
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 109
• ":OVLenable (Overload Event Enable Register)" on page 111
• ":OVLRegister (Overload Event Register)" on page 113
• "*STB (Read Status Byte)" on page 81
• "*SRE (Service Request Enable)" on page 79
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference 99
3 Commands by Subsystem
:HWERegister:CONDition (Hardware Event Condition Register)
(see page 530)
25
Query Syntax
7R+:(ELWLQ
2SHUDWLRQ6WDWXV
&RQGLWLRQ5HJLVWHU
:HWERegister:CONDition?
The :HWERegister:CONDition? query returns the integer value contained in
the Hardware Event Condition Register.
3//
/RFNHG
3//
/RFNHG
+:(5HJLVWHU&21'LWLRQ"
+DUGZDUH(YHQW&RQGLWLRQ5HJLVWHU
+:(5HJLVWHU>(9(1W@"
+DUGZDUH(YHQW(YHQW5HJLVWHU
+:(HQDEOH
+:(HQDEOH"
+DUGZDUH(YHQW(QDEOH0DVN5HJLVWHU
Table 3 5 Hardware Event Condition Register
Bit Name Description When Set (1 = High = True), Indicates:
15-13 --- --- (Not used.)
12 PLL
Locked
PLL Locked This bit is for internal use and is not intended
for general use.
11-0 --- --- (Not used.)
Return Format
<value><NL>
<value> ::= integer in NR1 format.
See Also • "Introduction to Root (:) Commands" on page 88
• ":CHANnel<n>:PROTection" on page 156
• ":EXTernal:PROTection" on page 178
• ":OPEE (Operation Status Enable Register)" on page 105
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 109
• ":OVLenable (Overload Event Enable Register)" on page 111
100 Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Reference
Loading...