Agilent Technologies InfiniiVision 6000 Series Technical data

Agilent InfiniiVision
6000 Series
Oscilloscopes
Programmer's Guide

Notices
© Agilent Technologies, Inc. 2005-2010
Manual Part Number
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.
Version 06.00.0000
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.
Edition
January 21, 2010
Available in electronic format only
Agilent Technologies, Inc.
1900 Garden of the Gods Road
Colorado Springs, CO 80907 USA
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.
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
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
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.
WA R N I N G
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.
In This Book
This book is your guide to programming the 6000 Series oscilloscopes:
Table 1
InfiniiVision 6000 Series Oscilloscope Models
Channels
Input Bandwidth
1 GHz
500 MHz
300 MHz
100 MHz
4 analog + 16
digital
(mixed-signal)
MSO6104A/L
MSO6054A/L
MSO6034A
MSO6014A/L
2 analog + 16
digital
(mixed-signal)
MSO6102A
MSO6052A
MSO6032A
MSO6012A
4 analog
DSO6104A/L
DSO6054A/L
DSO6034A
DSO6014A/L
2 analog
DSO6102A
DSO6052A
DSO6032A
DSO6012A
The first few chapters describe how to set up and get started:
• Chapter 1, Chapter 1, “What's New,” starting on page 21, describes
programming command changes in the latest version of oscilloscope
software.
• Chapter 2, Chapter 2, “Setting Up,” starting on page 47, describes the
steps you must take before you can program the oscilloscope.
• Chapter 3, Chapter 3, “Getting Started,” starting on page 57, gives a
general overview of oscilloscope program structure and shows how to
program the oscilloscope using a few simple examples.
• Chapter 4, Chapter 4, “Commands Quick Reference,” starting on page
71, is a brief listing of the 6000 Series oscilloscope commands and
syntax.
The next chapters provide reference information:
• Chapter 5, Chapter 5, “Commands by Subsystem,” starting on page 123,
describes the set of commands that belong to an individual subsystem
and explains the function of each command. Command arguments and
syntax are described. Some command descriptions have example code.
• Chapter 6, Chapter 6, “Commands A- Z,” starting on page 665, contains
an alphabetical listing of all command elements.
• Chapter 7, Chapter 7, “Obsolete and Discontinued Commands,” starting
on page 699, describes obsolete commands which still work but have
been replaced by newer commands and discontinued commands which
are no longer supported.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
3
• Chapter 8, Chapter 8, “Error Messages,” starting on page 755, lists the
instrument error messages that can occur while programming the
oscilloscope.
The command descriptions in this reference show upper and lowercase
characters. For example, :AUToscale indicates that the entire command
name is :AUTOSCALE. The short form, :AUT, is also accepted by the
oscilloscope.
Then, there are chapters that describe programming topics and conceptual
information in more detail:
• Chapter 9, Chapter 9, “Status Reporting,” starting on page 763,
describes the oscilloscope's status registers and how to check the status
of the instrument.
• Chapter 10, Chapter 10, “Synchronizing Acquisitions,” starting on page
787, describes how to wait for acquisitions to complete before querying
measurement results or performing other operations with the captured
data.
• Chapter 11, Chapter 11, “More About Oscilloscope Commands,” starting
on page 797, contains additional information about oscilloscope
programming commands.
Finally, there is a chapter that contains programming examples:
• Chapter 12, Chapter 12, “Programming Examples,” starting on page 823.
Mixed-Signal
Oscilloscope
Channel
Differences
Because both the "analog channels only" oscilloscopes (DSO models) and
the mixed- signal oscilloscopes (MSO models) have analog channels, topics
that describe analog channels refer to all oscilloscope models. Whenever a
topic describes digital channels, that information applies only to the
mixed- signal oscilloscope models.
See Also
• For more information on using the SICL, VISA, and VISA COM libraries
in general, see the documentation that comes with the Agilent IO
Libraries Suite.
• For information on controller PC interface configuration, see the
documentation for the interface card used (for example, the Agilent
82350A GPIB interface).
• For information on oscilloscope front- panel operation, see the User's
Guide.
• For detailed connectivity information, refer to the Agilent Technologies
USB/LAN/GPIB Connectivity Guide. For a printable electronic copy of
the Connectivity Guide, direct your Web browser to "www.agilent.com"
and search for "Connectivity Guide".
• For the latest versions of this and other manuals, see:
"http://www.agilent.com/find/6000manual"
4
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Contents
In This Book
3
1 What's New
What's New in Version 6.00
22
What's New in Version 5.25
25
What's New in Version 5.20
27
What's New in Version 5.15
30
What's New in Version 5.10
32
What's New in Version 5.00
33
What's New in Version 4.10
35
What's New in Version 4.00
37
What's New in Version 3.50
39
What's New in Version 3.00
41
Command Differences From 54620/54640 Series Oscilloscopes
43
2 Setting Up
Step 1. Install Agilent IO Libraries Suite software
Step 2. Connect and set up the oscilloscope
Using the USB (Device) Interface 49
Using the LAN Interface 49
Using the GPIB Interface 50
Step 3. Verify the oscilloscope connection
48
49
51
3 Getting Started
Basic Oscilloscope Program Structure
Initializing 58
Capturing Data 58
Analyzing Captured Data 59
58
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Programming the Oscilloscope 60
Referencing the IO Library 60
Opening the Oscilloscope Connection via the IO Library 61
Initializing the Interface and the Oscilloscope 61
Using :AUToscale to Automate Oscilloscope Setup 62
Using Other Oscilloscope Setup Commands 62
Capturing Data with the :DIGitize Command 63
Reading Query Responses from the Oscilloscope 65
Reading Query Results into String Variables 66
Reading Query Results into Numeric Variables 66
Reading Definite-Length Block Query Response Data 66
Sending Multiple Queries and Reading Results 67
Checking Instrument Status 68
Other Ways of Sending Commands 69
Telnet Sockets 69
Sending SCPI Commands Using Browser Web Control
69
4 Commands Quick Reference
Command Summary
72
Syntax Elements 120
Number Format 120
<NL> (Line Terminator) 120
[ ] (Optional Syntax Terms) 120
{ } (Braces) 120
::= (Defined As) 120
< > (Angle Brackets) 121
... (Ellipsis) 121
n,..,p (Value Ranges) 121
d (Digits) 121
Quoted ASCII String 121
Definite-Length Block Response Data
121
5 Commands by Subsystem
Common (*) Commands 125
*CLS (Clear Status) 129
*ESE (Standard Event Status Enable) 130
*ESR (Standard Event Status Register) 132
*IDN (Identification Number) 134
*LRN (Learn Device Setup) 135
*OPC (Operation Complete) 136
6
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
*OPT (Option Identification) 137
*RCL (Recall) 139
*RST (Reset) 140
*SAV (Save) 143
*SRE (Service Request Enable) 144
*STB (Read Status Byte) 146
*TRG (Trigger) 148
*TST (Self Test) 149
*WAI (Wait To Continue) 150
Root (:) Commands 151
:ACTivity 154
:AER (Arm Event Register) 155
:AUToscale 156
:AUToscale:AMODE 158
:AUToscale:CHANnels 159
:BLANk 160
:CDISplay 161
:DIGitize 162
:HWEenable (Hardware Event Enable Register) 164
:HWERegister:CONDition (Hardware Event Condition Register)
:HWERegister[:EVENt] (Hardware Event Event Register) 168
:MERGe 170
:MTEenable (Mask Test Event Enable Register) 171
:MTERegister[:EVENt] (Mask Test Event Event Register) 173
:OPEE (Operation Status Enable Register) 175
:OPERegister:CONDition (Operation Status Condition Register)
:OPERegister[:EVENt] (Operation Status Event Register) 179
:OVLenable (Overload Event Enable Register) 181
:OVLRegister (Overload Event Register) 183
:PRINt 185
:RUN 186
:SERial 187
:SINGle 188
:STATus 189
:STOP 190
:TER (Trigger Event Register) 191
:VIEW 192
166
177
:ACQuire Commands 193
:ACQuire:AALias 195
:ACQuire:COMPlete 196
:ACQuire:COUNt 197
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
:ACQuire:DAALias 198
:ACQuire:MODE 199
:ACQuire:POINts 200
:ACQuire:RSIGnal 201
:ACQuire:SEGMented:ANALyze 202
:ACQuire:SEGMented:COUNt 203
:ACQuire:SEGMented:INDex 204
:ACQuire:SRATe 207
:ACQuire:TYPE 208
:BUS<n> Commands 210
:BUS<n>:BIT<m> 212
:BUS<n>:BITS 213
:BUS<n>:CLEar 215
:BUS<n>:DISPlay 216
:BUS<n>:LABel 217
:BUS<n>:MASK 218
:CALibrate Commands 219
:CALibrate:DATE 221
:CALibrate:LABel 222
:CALibrate:OUTPut 223
:CALibrate:STARt 224
:CALibrate:STATus 225
:CALibrate:SWITch 226
:CALibrate:TEMPerature 227
:CALibrate:TIME 228
:CHANnel<n> Commands 229
:CHANnel<n>:BWLimit 232
:CHANnel<n>:COUPling 233
:CHANnel<n>:DISPlay 234
:CHANnel<n>:IMPedance 235
:CHANnel<n>:INVert 236
:CHANnel<n>:LABel 237
:CHANnel<n>:OFFSet 238
:CHANnel<n>:PROBe 239
:CHANnel<n>:PROBe:HEAD[:TYPE]
:CHANnel<n>:PROBe:ID 241
:CHANnel<n>:PROBe:SKEW 242
:CHANnel<n>:PROBe:STYPe 243
:CHANnel<n>:PROTection 244
:CHANnel<n>:RANGe 245
8
240
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
:CHANnel<n>:SCALe 246
:CHANnel<n>:UNITs 247
:CHANnel<n>:VERNier 248
:DIGital<n> Commands 249
:DIGital<n>:DISPlay 251
:DIGital<n>:LABel 252
:DIGital<n>:POSition 253
:DIGital<n>:SIZE 254
:DIGital<n>:THReshold 255
:DISPlay Commands 256
:DISPlay:CLEar 258
:DISPlay:DATA 259
:DISPlay:LABel 261
:DISPlay:LABList 262
:DISPlay:PERSistence 263
:DISPlay:SOURce 264
:DISPlay:VECTors 265
:EXTernal Trigger Commands 266
:EXTernal:BWLimit 268
:EXTernal:IMPedance 269
:EXTernal:PROBe 270
:EXTernal:PROBe:ID 271
:EXTernal:PROBe:STYPe 272
:EXTernal:PROTection 273
:EXTernal:RANGe 274
:EXTernal:UNITs 275
:FUNCtion Commands 276
:FUNCtion:CENTer 279
:FUNCtion:DISPlay 280
:FUNCtion:GOFT:OPERation 281
:FUNCtion:GOFT:SOURce1 282
:FUNCtion:GOFT:SOURce2 283
:FUNCtion:OFFSet 284
:FUNCtion:OPERation 285
:FUNCtion:RANGe 286
:FUNCtion:REFerence 287
:FUNCtion:SCALe 288
:FUNCtion:SOURce1 289
:FUNCtion:SOURce2 290
:FUNCtion:SPAN 291
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
9
:FUNCtion:WINDow
292
:HARDcopy Commands 293
:HARDcopy:AREA 295
:HARDcopy:APRinter 296
:HARDcopy:FACTors 297
:HARDcopy:FFEed 298
:HARDcopy:INKSaver 299
:HARDcopy:LAYout 300
:HARDcopy:PALette 301
:HARDcopy:PRINter:LIST 302
:HARDcopy:STARt 303
:LISTer Commands 304
:LISTer:DATA 305
:LISTer:DISPlay 306
:MARKer Commands 307
:MARKer:MODE 309
:MARKer:X1Position 310
:MARKer:X1Y1source 311
:MARKer:X2Position 312
:MARKer:X2Y2source 313
:MARKer:XDELta 314
:MARKer:Y1Position 315
:MARKer:Y2Position 316
:MARKer:YDELta 317
:MEASure Commands 318
:MEASure:CLEar 326
:MEASure:COUNter 327
:MEASure:DEFine 328
:MEASure:DELay 331
:MEASure:DUTYcycle 333
:MEASure:FALLtime 334
:MEASure:FREQuency 335
:MEASure:NWIDth 336
:MEASure:OVERshoot 337
:MEASure:PERiod 339
:MEASure:PHASe 340
:MEASure:PREShoot 341
:MEASure:PWIDth 342
:MEASure:RESults 343
:MEASure:RISetime 346
10
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
:MEASure:SDEViation 347
:MEASure:SHOW 348
:MEASure:SOURce 349
:MEASure:STATistics 351
:MEASure:STATistics:INCRement 352
:MEASure:STATistics:RESet 353
:MEASure:TEDGe 354
:MEASure:TVALue 356
:MEASure:VAMPlitude 358
:MEASure:VAVerage 359
:MEASure:VBASe 360
:MEASure:VMAX 361
:MEASure:VMIN 362
:MEASure:VPP 363
:MEASure:VRATio 364
:MEASure:VRMS 365
:MEASure:VTIMe 366
:MEASure:VTOP 367
:MEASure:XMAX 368
:MEASure:XMIN 369
:MTESt Commands 370
:MTESt:AMASk:CREate 375
:MTESt:AMASk:SOURce 376
:MTESt:AMASk:UNITs 377
:MTESt:AMASk:XDELta 378
:MTESt:AMASk:YDELta 379
:MTESt:COUNt:FWAVeforms 380
:MTESt:COUNt:RESet 381
:MTESt:COUNt:TIME 382
:MTESt:COUNt:WAVeforms 383
:MTESt:DATA 384
:MTESt:DELete 385
:MTESt:ENABle 386
:MTESt:LOCK 387
:MTESt:OUTPut 388
:MTESt:RMODe 389
:MTESt:RMODe:FACTion:MEASure 390
:MTESt:RMODe:FACTion:PRINt 391
:MTESt:RMODe:FACTion:SAVE 392
:MTESt:RMODe:FACTion:STOP 393
:MTESt:RMODe:SIGMa 394
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
11
:MTESt:RMODe:TIME 395
:MTESt:RMODe:WAVeforms 396
:MTESt:SCALe:BIND 397
:MTESt:SCALe:X1 398
:MTESt:SCALe:XDELta 399
:MTESt:SCALe:Y1 400
:MTESt:SCALe:Y2 401
:MTESt:SOURce 402
:MTESt:TITLe 403
:POD Commands 404
:POD<n>:DISPlay 405
:POD<n>:SIZE 406
:POD<n>:THReshold 407
:RECall Commands 409
:RECall:FILename 410
:RECall:IMAGe[:STARt] 411
:RECall:MASK[:STARt] 412
:RECall:PWD 413
:RECall:SETup[:STARt] 414
:SAVE Commands 415
:SAVE:FILename 417
:SAVE:IMAGe[:STARt] 418
:SAVE:IMAGe:AREA 419
:SAVE:IMAGe:FACTors 420
:SAVE:IMAGe:FORMat 421
:SAVE:IMAGe:INKSaver 422
:SAVE:IMAGe:PALette 423
:SAVE:LISTer[:STARt] 424
:SAVE:MASK[:STARt] 425
:SAVE:PWD 426
:SAVE:SETup[:STARt] 427
:SAVE:WAVeform[:STARt] 428
:SAVE:WAVeform:FORMat 429
:SAVE:WAVeform:LENGth 430
:SAVE:WAVeform:SEGMented 431
:SBUS Commands 432
:SBUS:CAN:COUNt:ERRor 434
:SBUS:CAN:COUNt:OVERload 435
:SBUS:CAN:COUNt:RESet 436
:SBUS:CAN:COUNt:TOTal 437
12
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
:SBUS:CAN:COUNt:UTILization 438
:SBUS:DISPlay 439
:SBUS:FLEXray:COUNt:NULL 440
:SBUS:FLEXray:COUNt:RESet 441
:SBUS:FLEXray:COUNt:SYNC 442
:SBUS:FLEXray:COUNt:TOTal 443
:SBUS:I2S:BASE 444
:SBUS:IIC:ASIZe 445
:SBUS:LIN:PARity 446
:SBUS:M1553:BASE 447
:SBUS:MODE 448
:SBUS:SPI:BITorder 449
:SBUS:SPI:WIDTh 450
:SBUS:UART:BASE 451
:SBUS:UART:COUNt:ERRor 452
:SBUS:UART:COUNt:RESet 453
:SBUS:UART:COUNt:RXFRames 454
:SBUS:UART:COUNt:TXFRames 455
:SBUS:UART:FRAMing 456
:SYSTem Commands 457
:SYSTem:DATE 458
:SYSTem:DSP 459
:SYSTem:ERRor 460
:SYSTem:LOCK 461
:SYSTem:PRECision 462
:SYSTem:PROTection:LOCK
:SYSTem:SETup 464
:SYSTem:TIME 466
463
:TIMebase Commands 467
:TIMebase:MODE 469
:TIMebase:POSition 470
:TIMebase:RANGe 471
:TIMebase:REFClock 472
:TIMebase:REFerence 473
:TIMebase:SCALe 474
:TIMebase:VERNier 475
:TIMebase:WINDow:POSition 476
:TIMebase:WINDow:RANGe 477
:TIMebase:WINDow:SCALe 478
:TRIGger Commands
479
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
13
General :TRIGger Commands 482
:TRIGger:HFReject 483
:TRIGger:HOLDoff 484
:TRIGger:MODE 485
:TRIGger:NREJect 486
:TRIGger:PATTern 487
:TRIGger:SWEep 489
:TRIGger:CAN Commands 490
:TRIGger:CAN:PATTern:DATA 492
:TRIGger:CAN:PATTern:DATA:LENGth 493
:TRIGger:CAN:PATTern:ID 494
:TRIGger:CAN:PATTern:ID:MODE 495
:TRIGger:CAN:SAMPlepoint 496
:TRIGger:CAN:SIGNal:BAUDrate 497
:TRIGger:CAN:SOURce 498
:TRIGger:CAN:TRIGger 499
:TRIGger:DURation Commands 501
:TRIGger:DURation:GREaterthan 502
:TRIGger:DURation:LESSthan 503
:TRIGger:DURation:PATTern 504
:TRIGger:DURation:QUALifier 505
:TRIGger:DURation:RANGe 506
:TRIGger:EBURst Commands 507
:TRIGger:EBURst:COUNt 508
:TRIGger:EBURst:IDLE 509
:TRIGger:EBURst:SLOPe 510
:TRIGger[:EDGE] Commands 511
:TRIGger[:EDGE]:COUPling 512
:TRIGger[:EDGE]:LEVel 513
:TRIGger[:EDGE]:REJect 514
:TRIGger[:EDGE]:SLOPe 515
:TRIGger[:EDGE]:SOURce 516
:TRIGger:FLEXray Commands 517
:TRIGger:FLEXray:AUTosetup 518
:TRIGger:FLEXray:BAUDrate 519
:TRIGger:FLEXray:CHANnel 520
:TRIGger:FLEXray:ERRor:TYPE 521
:TRIGger:FLEXray:EVENt:TYPE 522
:TRIGger:FLEXray:FRAMe:CCBase 523
:TRIGger:FLEXray:FRAMe:CCRepetition 524
:TRIGger:FLEXray:FRAMe:ID 525
:TRIGger:FLEXray:FRAMe:TYPE 526
14
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
:TRIGger:FLEXray:SOURce 527
:TRIGger:FLEXray:TRIGger 528
:TRIGger:GLITch Commands 529
:TRIGger:GLITch:GREaterthan 531
:TRIGger:GLITch:LESSthan 532
:TRIGger:GLITch:LEVel 533
:TRIGger:GLITch:POLarity 534
:TRIGger:GLITch:QUALifier 535
:TRIGger:GLITch:RANGe 536
:TRIGger:GLITch:SOURce 537
:TRIGger:I2S Commands 538
:TRIGger:I2S:ALIGnment 540
:TRIGger:I2S:AUDio 541
:TRIGger:I2S:CLOCk:SLOPe 542
:TRIGger:I2S:PATTern:DATA 543
:TRIGger:I2S:PATTern:FORMat 545
:TRIGger:I2S:RANGe 546
:TRIGger:I2S:RWIDth 548
:TRIGger:I2S:SOURce:CLOCk 549
:TRIGger:I2S:SOURce:DATA 550
:TRIGger:I2S:SOURce:WSELect 551
:TRIGger:I2S:TRIGger 552
:TRIGger:I2S:TWIDth 554
:TRIGger:I2S:WSLow 555
:TRIGger:IIC Commands 556
:TRIGger:IIC:PATTern:ADDRess 557
:TRIGger:IIC:PATTern:DATA 558
:TRIGger:IIC:PATTern:DATa2 559
:TRIGger:IIC[:SOURce]:CLOCk 560
:TRIGger:IIC[:SOURce]:DATA 561
:TRIGger:IIC:TRIGger:QUALifier 562
:TRIGger:IIC:TRIGger[:TYPE] 563
:TRIGger:LIN Commands 565
:TRIGger:LIN:ID 567
:TRIGger:LIN:PATTern:DATA 568
:TRIGger:LIN:PATTern:DATA:LENGth 570
:TRIGger:LIN:PATTern:FORMat 571
:TRIGger:LIN:SAMPlepoint 572
:TRIGger:LIN:SIGNal:BAUDrate 573
:TRIGger:LIN:SOURce 574
:TRIGger:LIN:STANdard 575
:TRIGger:LIN:SYNCbreak 576
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
15
:TRIGger:LIN:TRIGger 577
:TRIGger:M1553 Commands 578
:TRIGger:M1553:AUTosetup 579
:TRIGger:M1553:PATTern:DATA 580
:TRIGger:M1553:RTA 581
:TRIGger:M1553:SOURce:LOWer 582
:TRIGger:M1553:SOURce:UPPer 583
:TRIGger:M1553:TYPE 584
:TRIGger:SEQuence Commands 585
:TRIGger:SEQuence:COUNt 586
:TRIGger:SEQuence:EDGE 587
:TRIGger:SEQuence:FIND 588
:TRIGger:SEQuence:PATTern 589
:TRIGger:SEQuence:RESet 590
:TRIGger:SEQuence:TIMer 591
:TRIGger:SEQuence:TRIGger 592
:TRIGger:SPI Commands 593
:TRIGger:SPI:CLOCk:SLOPe 594
:TRIGger:SPI:CLOCk:TIMeout 595
:TRIGger:SPI:FRAMing 596
:TRIGger:SPI:PATTern:DATA 597
:TRIGger:SPI:PATTern:WIDTh 598
:TRIGger:SPI:SOURce:CLOCk 599
:TRIGger:SPI:SOURce:DATA 600
:TRIGger:SPI:SOURce:FRAMe 601
:TRIGger:TV Commands 602
:TRIGger:TV:LINE 603
:TRIGger:TV:MODE 604
:TRIGger:TV:POLarity 605
:TRIGger:TV:SOURce 606
:TRIGger:TV:STANdard 607
:TRIGger:UART Commands 608
:TRIGger:UART:BASE 610
:TRIGger:UART:BAUDrate 611
:TRIGger:UART:BITorder 612
:TRIGger:UART:BURSt 613
:TRIGger:UART:DATA 614
:TRIGger:UART:IDLE 615
:TRIGger:UART:PARity 616
:TRIGger:UART:POLarity 617
:TRIGger:UART:QUALifier 618
:TRIGger:UART:SOURce:RX 619
16
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
:TRIGger:UART:SOURce:TX 620
:TRIGger:UART:TYPE 621
:TRIGger:UART:WIDTh 622
:TRIGger:USB Commands 623
:TRIGger:USB:SOURce:DMINus 624
:TRIGger:USB:SOURce:DPLus 625
:TRIGger:USB:SPEed 626
:TRIGger:USB:TRIGger 627
:WAVeform Commands 628
:WAVeform:BYTeorder 636
:WAVeform:COUNt 637
:WAVeform:DATA 638
:WAVeform:FORMat 640
:WAVeform:POINts 641
:WAVeform:POINts:MODE 643
:WAVeform:PREamble 645
:WAVeform:SEGMented:COUNt 648
:WAVeform:SEGMented:TTAG 649
:WAVeform:SOURce 650
:WAVeform:SOURce:SUBSource 654
:WAVeform:TYPE 655
:WAVeform:UNSigned 656
:WAVeform:VIEW 657
:WAVeform:XINCrement 658
:WAVeform:XORigin 659
:WAVeform:XREFerence 660
:WAVeform:YINCrement 661
:WAVeform:YORigin 662
:WAVeform:YREFerence 663
6 Commands A-Z
7 Obsolete and Discontinued Commands
:CHANnel:ACTivity 705
:CHANnel:LABel 706
:CHANnel:THReshold 707
:CHANnel2:SKEW 708
:CHANnel<n>:INPut 709
:CHANnel<n>:PMODe 710
:DISPlay:CONNect 711
:DISPlay:ORDer 712
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
17
:ERASe 713
:EXTernal:INPut 714
:EXTernal:PMODe 715
:FUNCtion:SOURce 716
:FUNCtion:VIEW 717
:HARDcopy:DESTination 718
:HARDcopy:DEVice 719
:HARDcopy:FILename 720
:HARDcopy:FORMat 721
:HARDcopy:GRAYscale 722
:HARDcopy:IGColors 723
:HARDcopy:PDRiver 724
:MEASure:LOWer 725
:MEASure:SCRatch 726
:MEASure:TDELta 727
:MEASure:THResholds 728
:MEASure:TMAX 729
:MEASure:TMIN 730
:MEASure:TSTArt 731
:MEASure:TSTOp 732
:MEASure:TVOLt 733
:MEASure:UPPer 735
:MEASure:VDELta 736
:MEASure:VSTArt 737
:MEASure:VSTOp 738
:MTESt:AMASk:{SAVE | STORe} 739
:MTESt:AVERage 740
:MTESt:AVERage:COUNt 741
:MTESt:LOAD 742
:MTESt:RUMode 743
:MTESt:RUMode:SOFailure 744
:MTESt:{STARt | STOP} 745
:MTESt:TRIGger:SOURce 746
:PRINt? 747
:TIMebase:DELay 749
:TRIGger:CAN:ACKNowledge 750
:TRIGger:CAN:SIGNal:DEFinition 751
:TRIGger:LIN:SIGNal:DEFinition 752
:TRIGger:THReshold 753
:TRIGger:TV:TVMode 754
18
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
8 Error Messages
9 Status Reporting
Status Reporting Data Structures
Status Byte Register (STB)
766
769
Service Request Enable Register (SRE)
Trigger Event Register (TER)
Output Queue
771
772
773
Message Queue
774
(Standard) Event Status Register (ESR)
775
(Standard) Event Status Enable Register (ESE)
Error Queue
776
777
Operation Status Event Register (:OPERegister[:EVENt])
778
Operation Status Condition Register (:OPERegister:CONDition)
Arm Event Register (AER)
779
780
Overload Event Register (:OVLRegister)
781
Hardware Event Event Register (:HWERegister[:EVENt])
782
Hardware Event Condition Register (:HWERegister:CONDition)
Mask Test Event Event Register (:MTERegister[:EVENt])
Clearing Registers and Queues
Status Reporting Decision Chart
783
784
785
786
10 Synchronizing Acquisitions
Synchronization in the Programming Flow
Set Up the Oscilloscope 788
Acquire a Waveform 788
Retrieve Results 788
Blocking Synchronization
788
789
Polling Synchronization With Timeout
790
Synchronizing with a Single-Shot Device Under Test (DUT)
Synchronization with an Averaging Acquisition
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
792
794
19
11 More About Oscilloscope Commands
Command Classifications 798
Core Commands 798
Non-Core Commands 798
Obsolete Commands 798
Valid Command/Query Strings 799
Program Message Syntax
799
Command Tree 803
Duplicate Mnemonics 817
Tree Traversal Rules and Multiple Commands
Query Return Values
818
820
All Oscilloscope Commands Are Sequential
821
12 Programming Examples
VISA COM Examples 824
VISA COM Example in Visual Basic 824
VISA COM Example in C# 834
VISA COM Example in Visual Basic .NET 846
VISA Examples 857
VISA Example in C 857
VISA Example in Visual Basic 866
VISA Example in C# 876
VISA Example in Visual Basic .NET 889
SICL Examples 903
SICL Example in C 903
SICL Example in Visual Basic
912
Index
20
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
1
What's New
What's New in Version 6.00 22
What's New in Version 5.25 25
What's New in Version 5.20 27
What's New in Version 5.15 30
What's New in Version 5.10 32
What's New in Version 5.00 33
What's New in Version 4.10 35
What's New in Version 4.00 37
What's New in Version 3.50 39
What's New in Version 3.00 41
Command Differences From 54620/54640 Series Oscilloscopes 43

21
1
What's New
What's New in Version 6.00
New features in version 6.00 of the InfiniiVision 6000 Series oscilloscope
software are:
• The ability to perform measurements and math functions on a
10K- point (maximum) precision analysis data record.
• Support for the new N5469A MIL- STD 1553 triggering and decode
option (Option 553).
• Support for the new N5432C FlexRay triggering and decode option
(Option FLX) which replaces previous FlexRay triggering and serial
decode options.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Changed
Commands
22
Command
Description
:SBUS:M1553:BASE (see page 447)
Determines the base to use for the MIL-STD
1553 decode display.
:SBUS:SPI:BITorder (see page 449)
Selects the bit order used when displaying data
in the SPI serial decode waveform and in the
Lister.
:SYSTem:PRECision (see page 462)
Allows measurements and math functions to
be performed on a precision analysis record (at
the expense of waveform update rate).
:TRIGger:FLEXray:AUTosetup (see page 518)
Performs automated oscilloscope setup for
FlexRay triggering and decode.
:TRIGger:FLEXray:BAUDrate (see page 519)
Specifies the baud rate of the FlexRay signal.
:TRIGger:FLEXray:CHANnel (see page 520)
Specified whether the FlexRay input signal is
for bus type A or B.
:TRIGger:FLEXray:SOURce (see page 527)
Specifies the input source channel probing the
FlexRay signal.
:TRIGger:M1553 Commands (see page 578)
Commands for triggering on MIL-STD 1553
signals.
Command
Differences
:SBUS:MODE (see page 448)
You can now select the M1553 serial bus
decode mode.
:TRIGger:FLEXray:ERRor:TYPE (see page 521)
Now, only the FCRC, HCRC, or ALL error types
can be selected.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
What's New
Discontinued
Commands
Command
Differences
:TRIGger:FLEXray:EVENt:TYPE (see page 522)
The BSS (Byte Start Sequence) has been added
and the FSS (Frame Start Sequence) has been
removed.
:TRIGger:FLEXray:TRIGger (see page 528)
The TIME trigger type is no longer supported.
:TRIGger:MODE (see page 485)
You can now select the M1553 trigger mode.
:WAVeform:POINts (see page 643)
In the RAW or MAXimum waveform points
modes, you can now specify 4,000,000 or
8,000,000 points in place of the previous
5,000,000 option.
:WAVeform:POINts:MODE (see page 643)
Command syntax is the same, but the NORMal
mode returns:
• The measurement record when
:SYSTem:PRECision is OFF.
• The precision analysis record when
:SYSTem:PRECision is ON.
1
Most of the following commands have been discontinued because they are
not supported by the new N5432C FlexRay triggering and decode option
(Option FLX) which replaces previous FlexRay triggering and serial decode
options.
Discontinued Command
Current Command Equivalent
:DISPlay:FREeze
none
:SBUS:BUSDoctor:ADDRess
none
The VPT1000 (BusDoctor)
vehicle protocol tester module
is not used with the new FLX
option.
:SBUS:BUSDoctor:BAUDrate
none
The VPT1000 (BusDoctor)
vehicle protocol tester module
is not used with the new FLX
option. You now specify the
baud rate using the
:TRIGger:FLEXray:BAUDrate
(see page 519) command.
:SBUS:BUSDoctor:CHANnel
none
The VPT1000 (BusDoctor)
vehicle protocol tester module
is not used with the new FLX
option. You now specify bus A
or B using the
:TRIGger:FLEXray:CHANnel
(see page 520) command.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Comments
23
1
24
What's New
Discontinued Command
Current Command Equivalent
Comments
:SBUS:BUSDoctor:MODE
none
The VPT1000 (BusDoctor)
vehicle protocol tester module
is not used with the new FLX
option.
:TRIGger:FLEXray:TIME:CBAS
e
none
Time triggering not supported
by new FLX option.
:TRIGger:FLEXray:TIME:CREPe
tition
none
Time triggering not supported
by new FLX option.
:TRIGger:FLEXray:TIME:SEGM
ent
none
Time triggering not supported
by new FLX option.
:TRIGger:FLEXray:TIME:SLOT
none
Time triggering not supported
by new FLX option.
:TRIGger:FLEXray:EVENt:LEVel
none
The :TRIGger[:EDGE]:LEVel
(see page 513) command is
used instead, as with other
trigger modes.
:TRIGger:FLEXray:EVENt:SOU
Rce
none
The input source channels are
now specified using the
:TRIGger:FLEXray:SOURce
(see page 527) command.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 5.25
New features in version 5.25 of the InfiniiVision 6000 Series oscilloscope
software are:
• The Lister display for showing decoded serial data in tabular format.
• The ability to trigger on and decode I2S serial bus data with a
four- channel oscilloscope that includes the Option SND license.
• FlexRay event triggering.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:CHANnel<n>:PROBe:HEAD[:TYPE] (see
page 240)
Sets an analog channel probe head type and dB
value.
:DISPlay:FREeze
Freezes the display without stopping currently
running acquisitions.
:LISTer Commands (see page 304)
Commands for turning the Lister display on/off
and for returning the Lister data.
:MTESt:RMODe:FACTion:MEASure (see
page 390)
Lets you enable or disable measurements on
mask test failures.
:SAVE:LISTer[:STARt] (see page 424)
Saves the Lister display data to a file.
:SBUS:I2S:BASE (see page 444)
Determines the base to use for the I2S decode
display.
:TRIGger:FLEXray:EVENt:AUToset
Automatically changes oscilloscope settings
for the selected FlexRay event trigger type.
:TRIGger:FLEXray:EVENt:LEVel
Lets you fine-tune the voltage level for the
FlexRay event trigger.
:TRIGger:FLEXray:EVENt:SOURce
Specifies the FlexRay event trigger source.
:TRIGger:FLEXray:EVENt:TYPE (see page 522)
Specifies the FlexRay event type to trigger on.
:TRIGger:I2S Commands (see page 538)
Commands for triggering on I2S signals.
:TRIGger:LIN:PATTern:DATA (see page 568)
Sets the data value when triggering on a LIN
frame ID and data.
:TRIGger:LIN:PATTern:DATA:LENGth (see
page 570)
Sets the byte length of the LIN data string.
:TRIGger:LIN:PATTern:FORMat (see page 571)
Sets the entry (and query) number base used
by the :TRIGger:LIN:PATTern:DATA command.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
25
1
What's New
Changed
Commands
26
Command
Differences
:SBUS:MODE (see page 448)
You can now select the I2S serial bus decode
mode.
:TRIGger:FLEXray:TRIGger (see page 528)
You can now select FlexRay EVENt triggers.
:TRIGger:LIN:TRIGger (see page 577)
You can now select the DATA option for
triggering on a LIN frame ID and data.
:TRIGger:MODE (see page 485)
You can now select the I2S trigger mode.
:TRIGger:TV:STANdard (see page 607)
The P1080L50HZ and P1080L60HZ standards
have been added.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 5.20
New features in version 5.20 of the InfiniiVision 6000 Series oscilloscope
software are:
• Mask testing, enabled with Option LMT.
• Tracking cursors (markers) have been added.
• Measurement statistics have been added.
• Labels can now be up to 10 characters.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:ACQuire:SEGMented:ANALyze (see page 202)
Calculates measurement statistics and/or
infinite persistence over all segments that have
been acquired.
:CALibrate:OUTPut (see page 223)
Selects the signal output on the rear panel
TRIG OUT BNC.
:HARDcopy:LAYout (see page 300)
Sets the hardcopy layout mode.
:MEASure:RESults (see page 343)
Returns measurement statistics values.
:MEASure:STATistics (see page 351)
Sets the type of measurement statistics to
return.
:MEASure:STATistics:INCRement (see
page 352)
Updates the statistics once (incrementing the
count by one) using the current measurement
values.
:MEASure:STATistics:RESet (see page 353)
Resets the measurement statistics values.
:MTEenable (Mask Test Event Enable Register)
(see page 171)
Sets a mask in the Mask Test Event Enable
register.
:MTERegister[:EVENt] (Mask Test Event Event
Register) (see page 173)
Returns the integer value contained in the
Mask Test Event Event Register and clears the
register.
:MTESt Commands (see page 370)
Commands and queries to control the mask
test (Option LMT) features.
:RECall:MASK[:STARt] (see page 425)
Recalls a mask.
:SAVE:MASK[:STARt] (see page 425)
Saves the current mask.
:SAVE:WAVeform:SEGMented (see page 431)
Specifies which segments are included when
the waveform is saved.
:TRIGger:UART:BASE (see page 610)
Selects the front panel UART/RS232 trigger
setup data selection option from HEX or
BINary.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
27
1
What's New
Changed
Commands
Obsolete
Commands
28
Command
Differences
:BUS<n>:LABel (see page 217)
Labels can now be up to 10 characters.
:CHANnel<n>:LABel (see page 237)
Labels can now be up to 10 characters.
:DIGital<n>:LABel (see page 252)
Labels can now be up to 10 characters.
:DISPlay:LABList (see page 262)
Labels can now be up to 10 characters.
:MARKer:MODE (see page 309)
You can now select the WAVeform tracking
cursors mode.
:RECall:PWD (see page 413)
You can set the present working directory in
addition to querying for this information.
:SAVE:IMAGe[:STARt] (see page 418)
The file extension specified will change the
:SAVE:IMAGe:FORMat setting if it is a valid
image file extension.
:SAVE:PWD (see page 426)
You can set the present working directory in
addition to querying for this information.
:SAVE:WAVeform[:STARt] (see page 418)
The file extension specified will change the
:SAVE:WAVeform:FORMat setting if it is a valid
waveform file extension.
:TRIGger:CAN:SIGNal:BAUDrate (see
page 497)
The baud rate value can now be set in 100 b/s
increments.
:TRIGger:LIN:SIGNal:BAUDrate (see page 573)
The baud rate value can now be set in 100 b/s
increments.
:TRIGger:UART:BAUDrate (see page 611)
The baud rate value can now be set in 100 b/s
increments and the maximum baud rate is now
3 Mb/s.
:TRIGger:UART:DATA (see page 614)
You can now specify the data value using a
quoted ASCII character.
Obsolete Command
Current Command Equivalent
:MTESt:AMASk:{SAVE |
STORe} (see page 739)
:SAVE:MASK[:STARt] (see
page 425)
:MTESt:AVERage (see
page 740)
:ACQuire:TYPE AVERage (see
page 208)
:MTESt:AVERage:COUNt (see
page 741)
:ACQuire:COUNt (see
page 197)
:MTESt:LOAD (see page 742)
:RECall:MASK[:STARt] (see
page 412)
:MTESt:RUMode (see
page 743)
:MTESt:RMODe (see
page 389)
Behavior Differences
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
What's New
Obsolete Command
Current Command Equivalent
:MTESt:RUMode:SOFailure
(see page 744)
:MTESt:RMODe:FACTion:STO
P (see page 393)
:MTESt:{STARt | STOP} (see
page 745)
:RUN (see page 186) or :STOP
(see page 190)
:MTESt:TRIGger:SOURce (see
page 746)
:TRIGger Commands (see
page 479)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
Behavior Differences
There are various commands
for setting the source with
different types of triggers.
29
1
What's New
What's New in Version 5.15
New features in version 5.15 of the InfiniiVision 6000 Series oscilloscope
software are:
• Waveform math can be performed using channels 3 and 4, and there is
a new ADD operator.
• Ratio of AC RMS values measurement.
• Analog channel impedance protection lock.
More detailed descriptions of the new and changed commands appear
below.
New Commands
30
Command
Description
:FUNCtion:GOFT:OPERation (see page 281)
Selects the math operation for the internal g(t)
source that can be used as the input to the FFT,
INTegrate, DIFFerentiate, and SQRT functions.
:FUNCtion:GOFT:SOURce1 (see page 282)
Selects the first input channel for the g(t)
source.
:FUNCtion:GOFT:SOURce2 (see page 283)
Selects the second input channel for the g(t)
source.
:FUNCtion:SOURce1 (see page 289)
Selects the first source for the ADD, SUBTract,
and MULTiply arithmetic operations or the
single source for the FFT, INTegrate,
DIFFerentiate, and SQRT functions.
:FUNCtion:SOURce2 (see page 290)
Selects the second input channel for the ADD,
SUBTract, and MULTiply arithmetic operations.
:MEASure:VRATio (see page 364)
Measures and returns the ratio of AC RMS
values of the specified sources expressed in
dB.
:SYSTem:PROTection:LOCK (see page 463)
Disables/enables the fifty ohm input
impedance setting.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
What's New
Changed
Commands
Obsolete
Commands
Command
Differences
:ACQuire:COUNt (see page 197)
The :ACQuire:COUNt 1 command has been
deprecated. The AVERage acquisition type with
a count of 1 is functionally equivalent to the
HRESolution acquisition type; however, you
should select the high-resolution acquisition
mode with the :ACQuire:TYPE HRESolution
command instead.
:FUNCtion:OPERation (see page 285)
The ADD parameter is new, and now that
waveform math can be performed using
channels 3 and 4, this command selects the
operation only.
:FUNCtion:WINDow (see page 292)
You can now select the Blackman-Harris FFT
window.
Obsolete Command
Current Command Equivalent
Behavior Differences
:FUNCtion:SOURce (see
page 716)
:FUNCtion:SOURce1 (see
page 289)
Obsolete command has ADD,
SUBTract, and MULTiply
parameters; current command
has GOFT parameter.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
31
1
What's New
What's New in Version 5.10
New features in version 5.10 of the InfiniiVision 6000 Series oscilloscope
software are:
• Segmented memory acquisition mode, enabled with Option SGM.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Changed
Commands
32
Command
Description
:ACQuire:SEGMented:COUNt (see page 203)
Sets the number of memory segments.
:ACQuire:SEGMented:INDex (see page 204)
Selects the segmented memory index.
:WAVeform:SEGMented:COUNt (see page 648)
Returns the number of segments in the
currently acquired waveform data.
:WAVeform:SEGMented:TTAG (see page 649)
Returns the time tag for the selected
segmented memory index.
Command
Differences
:ACQuire:MODE (see page 199)
You can now select the SEGMented memory
mode.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 5.00
New features in version 5.00 of the InfiniiVision 6000 Series oscilloscope
software are:
• The ability to trigger on and decode UART/RS- 232 serial bus data with
a four- channel oscilloscope that includes the Option 232 license.
• The :SAVE and :RECall command subsystems.
• Changes to the :HARDcopy command subsystem to make a clearer
distinction between printing and save/recall functionality.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:HARDcopy:STARt (see page 303)
Starts a print job.
:HARDcopy:APRinter (see page 296)
Sets the active printer.
:HARDcopy:AREA (see page 295)
Specifies the area of the display to print
(currently SCReen only).
:HARDcopy:INKSaver (see page 299)
Inverts screen colors to save ink when printing.
:HARDcopy:PRinter:LIST (see page 302)
Returns a list of the available printers.
:RECall Commands (see page 409)
Commands for recalling previously saved
oscilloscope setups and traces.
:SAVE Commands (see page 415)
Commands for saving oscilloscope setups and
traces, screen images, and data.
:SBUS:UART:BASE (see page 451)
Determines the base to use for the UART
decode display.
:SBUS:UART:COUNt:ERRor (see page 452)
Returns the UART error frame count.
:SBUS:UART:COUNt:RESet (see page 453)
Resets the UART frame counters.
:SBUS:UART:COUNt:RXFRames (see page 454)
Returns the UART Rx frame count.
:SBUS:UART:COUNt:TXFRames (see page 455)
Returns the UART Tx frame count.
:SBUS:UART:FRAMing (see page 456)
Determines the byte value to use for framing
(end of packet) or to turn off framing for UART
decode.
:TRIGger:UART Commands (see page 608)
Commands for triggering on UART/RS-232
signals.
:WAVeform:SOURce:SUBSource (see
page 654)
Selects subsource when :WAVeform:SOURce
is SBUS (serial decode).
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
33
1
What's New
Changed
Commands
Obsolete
Commands
34
Command
Differences
:SBUS:MODE (see page 448)
You can now select the UART serial bus decode
mode.
:TRIGger:MODE (see page 485)
You can now select the UART trigger mode.
Obsolete Command
Current Command Equivalent
:HARDcopy:FILename (see
page 720)
:RECall:FILename (see
page 410)
:SAVE:FILename (see
page 410)
:HARDcopy:FORMat (see
page 721)
:HARDcopy:APRinter (see
page 296)
:SAVE:IMAGe:FORMat (see
page 421)
:SAVE:WAVeform:FORMat
(see page 429)
:HARDcopy:IGColors (see
page 723)
:HARDcopy:INKSaver (see
page 299)
:HARDcopy:PDRiver (see
page 724)
:HARDcopy:APRinter (see
page 296)
Behavior Differences
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 4.10
New features in version 4.10 of the InfiniiVision 6000 Series oscilloscope
software are:
• The ability to trigger on and decode FlexRay serial bus data using a
Decomsys BusDoctor 2 protocol analyzer with a four- channel
mixed- signal oscilloscope that includes the Option FRS license.
• The square root waveform math function.
• Several new hardcopy printer drivers.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:SBUS:BUSDoctor:ADDRess
Sets/queries the four fields in the BusDoctor
LAN IP Address.
:SBUS:BUSDoctor:BAUDrate
Sets/queries the baud rate for the BusDosctor
from 2.5 Mb/s to 10 Mb/s.
:SBUS:BUSDoctor:CHANnel
Sets/queries the FlexRay channel that the
BusDoctor analyzes/preprocesses.
:SBUS:BUSDoctor:MODE
Sets/queries the operating mode of the
BusDoctor.
:SBUS:FLEXray:COUNt:NULL? (see page 440)
Returns the FlexRay null frame count.
:SBUS:FLEXray:COUNt:RESet (see page 441)
Resets the FlexRay frame counters.
:SBUS:FLEXray:COUNt:SYNC? (see page 442)
Returns the FlexRay sync frame count.
:SBUS:FLEXray:COUNt:TOTal? (see page 443)
Returns the FlexRay total frame count.
:TRIGger:FLEXray:ERRor:TYPE (see page 521)
Sets/queries the FlexRay error type to trigger
on.
:TRIGger:FLEXray:FRAMe:CCBase (see
page 523)
Sets/queries the base of the FlexRay cycle
count (in the frame header) to trigger on.
:TRIGger:FLEXray:FRAMe:CCRepetition (see
page 524)
Sets/queries the repetition number of the
FlexRay cycle count (in the frame header) to
trigger on.
:TRIGger:FLEXray:FRAMe:ID (see page 525)
Sets/queries the FlexRay frame ID to trigger
on.
:TRIGger:FLEXray:FRAMe:TYPE (see page 526)
Sets/queries the FlexRay frame type to trigger
on.
:TRIGger:FLEXray:TIME:CBASe
Sets/queries the base of the FlexRay cycle to
trigger on.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
35
1
What's New
Changed
Commands
36
Command
Description
:TRIGger:FLEXray:TIME:CREPetition
Sets/queries the repetition number of the
FlexRay cycle to trigger on.
:TRIGger:FLEXray:TIME:SEGMent
Sets/queries the FlexRay segment type.
:TRIGger:FLEXray:TIME:SLOT
Sets/queries the FlexRay slot type and ID.
:TRIGger:FLEXray:TRIGger (see page 528)
Sets/queries the FlexRay trigger mode.
Command
Differences
:FUNCtion:OPERation (see page 285)
You can now select the SQRT (square root)
waveform math function.
:SBUS:MODE (see page 448)
You can now select the FLEXray serial bus
decode mode.
:TRIGger:MODE (see page 485)
You can now select the FLEXray trigger mode.
:HARDcopy:PDRiver (see page 724)
You can now select the new DJPR0kx50,
DJ55xx, PS470, and LJFastraster printer
drivers.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 4.00
New features in version 4.00 of the InfiniiVision 6000 Series oscilloscope
software are:
• The ability to :AUToscale selected channels only and specify the
acquisition type and mode that is set after an :AUToscale.
• The :BUS command subsystem for controlling up to two buses made up
of digital channels.
• Additional :CALibrate commands for starting the user calibration
procedure, displaying the status of the last user calibration, and
displaying the temperature change since the last user calibration.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:AUToscale:AMODE (see page 158)
Specifies whether to keep the current
acquisition type and mode after subsequent
autoscales.
:AUToscale:CHANnels (see page 159)
Specifies whether to autoscale the currently
displayed channels or all channels.
:BUS<n>:BIT<m> (see page 212)
Includes or excludes the selected bit in a bus
definition.
:BUS<n>:BITS (see page 213)
Includes or excludes a list of bits in a bus
definition.
:BUS<n>:CLEar (see page 215)
Excludes all digital channels from a bus
definition
:BUS<n>:DISPlay (see page 216)
Displays or hides the bus on the oscilloscope
display.
:BUS<n>:LABel (see page 217)
Assigns a label string to a bus.
:BUS<n>:MASK (see page 218)
Includes or excludes bits in a bus definition
according to a mask.
:CALibrate:STARt (see page 224)
Starts the user calibration procedure.
:CALibrate:STATus? (see page 225)
Displays the summary results of the last user
calibration procedure.
:CALibrate:TEMPerature? (see page 227)
Displays the change in temperature since the
last user calibration procedure.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
37
1
What's New
Changed
Commands
38
Command
Differences
:AUToscale (see page 156)
You can now specify which channels to
autoscale.
:BLANk (see page 160)
Now, you can also use this command with
digital channel buses.
:DIGitize (see page 162)
Now, you can also use this command with
digital channel buses.
:STATus (see page 189)
Now, you can also use this command with
digital channel buses.
:VIEW (see page 192)
Now, you can also use this command with
digital channel buses.
:WAVeform:SOURce (see page 650)
Now, you can also use this command with
digital channel buses.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 3.50
New features in version 3.50 of the InfiniiVision 6000 Series oscilloscope
software are:
• The CAN and LIN options have been added to the :SBUS:MODE (serial
decode mode) command.
• The :SBUS:CAN:COUNt commands have been added to count CAN bus
frames, count load utilization, and reset the counters.
• The ALLerrors, OVERload, and ACKerror options have been added to
the :TRIGger:CAN:TRIGger command.
• The :TRIGger:LIN:ID, :TRIGger:LIN:SAMPlepoint, :TRIGger:LIN:STANdard,
and :TRIGger:LIN:SYNCbreak commands have been added.
• The :SBUS:LIN:PARity command has been added.
• The ID (for Frame Id) option has been added to the
:TRIGger:LIN:TRIGger command.
• The :HWERegister:CONDition, :HWERegister[:EVENt], and :HWE
commands for the hardware event condition, event, and enable registers
have been added.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:SBUS:CAN:COUNt:ERRor? (see page 434)
Returns the CAN bus error frame count.
:SBUS:CAN:COUNt:OVERload? (see page 434)
Returns the CAN bus overload frame count.
:SBUS:CAN:COUNt:RESet (see page 434)
Resets the CAN bus counters.
:SBUS:CAN:COUNt:TOTal? (see page 434)
Returns the CAN bus total frame count.
:SBUS:CAN:COUNt:UTILization? (see page 434)
Returns a percentage showing CAN bus
utilization.
:SBUS:IIC:ASIZe (see page 445)
Determines whether the Read/Write bit is
included as the LSB in the display of the IIC
address field of the decode bus.
:SBUS:LIN:PARity (see page 446)
Determines whether the parity bits are
included as the most significant bits (MSB) in
the display of the Frame Id field in the LIN
decode bus.
:TRIGger:LIN:ID (see page 567)
Defines the LIN identifier searched for in each
CAN message when the LIN trigger mode is set
to frame ID.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
39
1
What's New
Changed
Commands
Obsolete
Commands
40
Command
Description
:TRIGger:LIN:SAMPlepoint (see page 572)
Sets the point during the bit time where the bit
level is sampled to determine whether the bit is
dominant or recessive. The sample point
represents the percentage of time between the
beginning of the bit time to the end of the bit
time.
:TRIGger:LIN:STANdard (see page 575)
Sets the LIN standard in effect for triggering
and decoding to be LIN1.3 or LIN2.0.
:TRIGger:LIN:SYNCbreak (see page 576)
Sets the length of the LIN sync break to be
greater than or equal to 11,12, or 13 clock
lengths. The sync break is the idle period in the
bus activity at the beginning of each packet
that distinguishes one information packet from
the previous one.
:HWEenable (see page 164)
Sets or reads the hardware event enable mask
register.
:HWERegister:CONDition? (see page 166)
Queries the hardware event condition register.
:HWERegister[:EVENt]? (see page 168)
Queries the hardware event event register.
Command
Differences
:SBUS:MODE (see page 448)
The CAN and LIN serial bus decode modes
have been added.
:TRIGger:CAN:TRIGger (see page 499)
The ALLerrors, OVERload, and ACKerror
options have been added.
:TRIGger:LIN:TRIGger (see page 577)
The ID (for Frame Id) option has been added.
Obsolete Command
Current Command Equivalent
:TRIGger:CAN:SIGNal:DEFiniti
on (see page 751)
none
:TRIGger:LIN:SIGNal:DEFinitio
n (see page 752)
none
Behavior Differences
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
What's New in Version 3.00
New features in version 3.00 of the InfiniiVision 6000 Series oscilloscope
software are:
• The :SBUS command subsystem for controlling serial decode bus
display, mode, and other options.
• The EBURst trigger mode and supporting :TRIGger:EBURst commands.
• The :ACQuire:AALias and :ACQuire:DAALias commands.
• The :WAVeform:POINts:MODE command.
• The :MEASure:SDEViation command.
• The :TIMebase:REFClock command.
• Changes to the :TRIGger:IIC commands.
• Changes to the :TRIGger:SEQuence:TRIGger command.
• Changes to the :ACQuire:TYPE and :WAVeform:TYPE commands to add
HRESolution type.
• Changes to the :BLANk, :DIGitize, :STATus, :VIEW, and
:WAVeform:SOURce commands to include the serial decode bus.
• Changes to the :HARDcopy:FORMat command to support the PNG,
ASCiixy, and BINary format types.
• Changes to the :DISPlay:DATA? query and the :PRINt command to
support the PNG format.
• Changes to the :WAVeform:POINts command to set from 2000 to
8,000,000 points (in 1- 2- 5 sequence) when the waveform points mode is
MAXimum or RAW.
More detailed descriptions of the new and changed commands appear
below.
New Commands
Command
Description
:ACQuire:AALias? (see page 195)
Returns the current state of the oscilloscope's
anti-alias control.
:ACQuire:DAALias (see page 198)
Sets the oscilloscope's disable anti-alias mode.
:MEASure:SDEViation (see page 347)
Measures the std deviation of a waveform.
:SBUS:DISPlay (see page 439)
Controls the decoded serial bus display.
:SBUS:MODE (see page 448)
Determines the decode mode for the serial bus.
:SBUS:SPI:WIDTh (see page 450)
Determines the number of bits in a word of
decoded data for SPI.
:TIMebase:REFClock (see page 472)
Enables or disables the 10 MHz REF BNC
input/output.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
41
1
What's New
Changed
Commands
42
Command
Description
:TRIGger:EBURst:COUNt (see page 508)
Sets the Nth edge of burst edge counter
resource.
:TRIGger:EBURst:IDLE (see page 509)
Sets the Nth edge in a burst idle resource.
:TRIGger:EBURst:SLOPe (see page 508)
Specifies whether the rising edge (POSitive) or
falling edge (NEGative) of the Nth edge in a
burst will generate a trigger.
:TRIGger:IIC:PATTern:DATa2 (see page 559)
Sets IIC data 2.
:WAVeform:POINts:MODE (see page 643)
Sets the waveform points mode.
Command
Differences
:ACQuire:TYPE (see page 208)
The HRESolution type has been added for
smoothing at slower sweep speeds.
:BLANk (see page 160)
Now, you can also use this command with the
serial decode bus.
:DIGitize (see page 162)
Now, you can also use this command with the
serial decode bus.
:DISPlay:DATA (see page 259)
Now, the PNG format is supported in the query.
:HARDcopy:FORMat (see page 721)
Now, the PNG, ASCiixy, and BINary formats are
also supported.
:PRINt (see page 185)
Now, the PNG option is supported
:STATus (see page 189)
Now, you can also use this command with the
serial decode bus.
:TRIGger:IIC:TRIGger[:TYPE] (see page 563)
The ANACknowledge, R7Data2, and W7Data2
types have been added.
:TRIGger:MODE (see page 485)
The EBURst mode has been added.
:TRIGger:SEQuence:TRIGger (see page 592)
The EDGE2,COUNt,NREFind (no re-find) option
has been added.
:VIEW (see page 192)
Now, you can now use this command with the
serial decode bus.
:WAVeform:POINts (see page 641)
Now, you can set from 2000 to 8,000,000 points
(in 1-2-5 sequence) when the waveform points
mode is MAXimum or RAW.
:WAVeform:SOURce (see page 650)
Now, you can also use this command with the
serial decode bus.
:WAVeform:TYPE (see page 655)
The HRESolution type has been added for
smoothing at slower sweep speeds.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
What's New
Command Differences From 54620/54640 Series Oscilloscopes
The main differences between the version 1.00 programming command set
for the InfiniiVision 6000 Series oscilloscopes and the 54620/54640 Series
oscilloscopes are related to:
• :HARDcopy and :DISPlay command subsystem changes for USB printers
and the high resolution color display.
• New standards supported by the :TRIGger:TV commands.
• Support for 113xA Series probes.
• New "RAW" :WAVeform:POINts option for retrieving raw acquisition
record data.
• Discontinuance of the common commands for macros.
More detailed descriptions of the new, changed, obsolete, and discontinued
commands appear below.
New Commands
Command
Description
:ACQuire:RSIGnal (see page 201)
Selects the 10 MHz reference signal mode.
:CHANnel<n>:PROBe:ID? (see page 241)
Returns the type of probe attached to the
specified oscilloscope channel.
:CHANnel<n>:PROBe:STYPe (see page 243)
Sets the channel probe signal type (STYPe) to
differential or single-ended when using the
113xA Series probes, and determines how
offset is applied.
:CHANnel<n>:VERNier (see page 248)
Specifies whether the channel's vernier (fine
vertical adjustment) setting is ON (1) or OFF (0).
:DIGital<n>:SIZE (see page 254)
Specifies the size of digital channels on the
display.
:EXTernal:PROBe:ID (see page 271)
Returns the type of probe attached to the
external trigger input.
:EXTernal:PROBe:STYPe (see page 272)
Sets the external trigger probe signal type
(STYPe) to differential or single-ended when
using the 113xA Series probes, and determines
how offset is applied.
:HARDcopy:FILename (see page 720)
Sets the output filename for print formats
whose output is a file. Replaces the 5462x/4x
:HARDcopy:DESTination (see page 718)
command.
:HARDcopy:PDRiver (see page 724)
Sets the hardcopy printer driver.
:HARDcopy:IGColors (see page 723)
Specifies whether graticule colors are inverted.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
43
1
What's New
Changed
Commands
44
Command
Description
:HARDcopy:PALette (see page 301)
Sets the hardcopy palette color. Replaces the
5462x/4x :HARDcopy:GRAYscale (see
page 722) command.
:OPERegister:CONDition? (see page 177)
Returns the integer value contained in the
Table 52 (a new register in addition to the
Table 53 whose value is returned by the
:OPERegister[:EVENt]? (see page 179) query).
:POD<n>:SIZE (see page 406)
Specifies the size of digital channels on the
display.
:TIMebase:VERNier (see page 475)
Specifies whether the time base control's
vernier (fine horizontal adjustment) setting is
ON (1) or OFF (0).
Command
Differences From 5462x/4x Oscilloscopes
:ACQuire:COUNt (see page 197)
The count can be set to any value from 1 to
65536 (instead of 16383).
:DISPlay:DATA (see page 259)
The BMP8bit <format> option has been added
to the query. There is a new <palette> option
which can be MONochrome, GRAYscale, or
COLor in the query, or just MONochrome in the
command.
:DISPlay:SOURce (see page 264)
The number of pixel memory locations is 10
(instead of 3).
:HARDcopy:FORMat (see page 721)
There is now the BMP8bit format (instead of
TIFF) and the PRINter0 or PRINter1 formats (in
place of LASerjet, DESKjet, EPSon, or SEIKo).
See the new :HARDcopy:PDRiver (see
page 724) command for setting the hardcopy
printer driver.
*LRN (see page 135)
The Learn Device Setup query return format
matches the IEEE 488.2 specification which
says that the query result must contain
":SYST:SET " before the binary block data.
(This was not the case in the 5462x/4x
oscilloscopes.)
:MERGe (see page 170)
The number of pixel memory locations is 10
(instead of 3).
*OPT (see page 137)
The Option Identification query return format
now has license information (in addition to the
I/O module ID information fields which are
now always zero).
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
What's New
Command
Differences From 5462x/4x Oscilloscopes
:OVLRegister (see page 183)
The Overload Event Register is now a 16-bit
register (instead of 8-bit) and it contains bits
that identify when faults occur on the
oscilloscope channels (in addition to the bits
that identify when overloads occur).
:PRINt (see page 185)
The options are now: COLor (instead of HIRes),
GRAYscale (instead of LORes), PRINter0
(instead of PARallel), BMP8bit (instead of
TIFF). (The PCL option is now invalid.)
*RCL (Recall) (see page 139)
The number of instrument state locations is 10
(instead of 3 for the 54620 Series oscilloscopes
or 4 for the 54640 Series oscilloscopes).
*SAV (Save) (see page 143)
The number of instrument state locations is 10
(instead of 3 for the 54620 Series oscilloscopes
or 4 for the 54640 Series oscilloscopes).
*TRG (Trigger) (see page 148)
The *TRG has the same effect as the :DIGitize
command with no parameters (instead of the
:RUN command).
:TRIGger:TV:MODE (see page 604)
The modes have been renamed (however, old
forms of the mode names are still accepted).
:TRIGger:TV:STANdard (see page 607)
The P480L60HZ, P720L60HZ, P1080L24HZ,
P1080L25HZ, I1080L50HZ, and I1080L60HZ
standards are supported (in addition to
GENeric, NTSC, PALM, PAL, and SECam).
:VIEW (see page 192)
The number of pixel memory locations is 10
(instead of 3).
:WAVeform:COUNt? (see page 637)
The count can be any value from 1 to 65536
(instead of 16383).
:WAVeform:POINts (see page 641)
There is a new RAW "number of points" option
for retrieving the raw acquisition record data.
Also the maximum number of points that can
be retrieved from the normal measurement
record is 1000 (instead of 2000).
:WAVeform:PREamble (see page 645)
The xincrement format is 64-bit floating point
NR3 (instead of 32-bit), and the yreference
format is 32-bit NR1 (instead of 16-bit).
:WAVeform:XINCrement (see page 658)
The x-increment value from the preamble is
returned in 64-bit (instead of 32-bit) floating
point NR3 format.
:WAVeform:YREFerence (see page 663)
The y-reference value from the preamble is
returned in 32-bit (instead of 16-bit) NR1
format.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
1
45
1
What's New
Obsolete
Commands
Discontinued
Commands
46
Obsolete Command
Current Command Equivalent
:HARDcopy:DESTination (see
page 718)
:HARDcopy:FILename (see
page 720)
:HARDcopy:GRAYscale (see
page 722)
:HARDcopy:PALette (see
page 301)
:PRINt? (see page 747)
:DISPlay:DATA? (see
page 259)
Behavior Differences
The options are now: COLor
(instead of HIRes), GRAYscale
(instead of LORes), PRINter0
(instead of PARallel), BMP8bit
(instead of TIFF). (The DISK
and PCL options are now
invalid.)
Command
Description
*DMC
Define Macro.
*EMC
Enable Macro.
*GMC
Get Macro Contents.
*LMC
Learn Macro.
*PMC
Purge Macro.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
2
Setting Up
Step 1. Install Agilent IO Libraries Suite software 48
Step 2. Connect and set up the oscilloscope 49
Step 3. Verify the oscilloscope connection 51
This chapter explains how to install the Agilent IO Libraries Suite
software, connect the oscilloscope to the controller PC, set up the
oscilloscope, and verify the oscilloscope connection.

47
2
Setting Up
Step 1. Install Agilent IO Libraries Suite software
Insert the Automation- Ready CD that was shipped with your oscilloscope
into the controller PC's CD- ROM drive, and follow its installation
instructions.
You can also download the Agilent IO Libraries Suite software from the
web at:
• "http://www.agilent.com/find/iolib"
48
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
2
Setting Up
Step 2. Connect and set up the oscilloscope
The 6000 Series oscilloscope has three different interfaces you can use for
programming: USB (device), LAN, or GPIB.
All three interfaces are "live" by default, but you can turn them off if
desired. To access these settings press the Utility key on the front panel,
then press the I/O softkey, then press the Control softkey.
USB
HOST DEVICE
Figure 1
LAN Non-Auto-MDIX
GPIB
Control Connectors on Rear Panel
Using the USB (Device) Interface
1 Connect a USB cable from the controller PC's USB port to the "USB
DEVICE" port on the back of the oscilloscope.
This is a USB 2.0 high- speed port.
2 On the oscilloscope, verify that the controller interface is enabled:
a Press the Utility button.
b Using the softkeys, press I/O and Control.
c Ensure the box next to USB is selected (
). If not ( ), use the
Entry knob to select USB; then, press the Control softkey again.
Using the LAN Interface
1 If the controller PC isn't already connected to the local area network
(LAN), do that first.
2 Get the oscilloscope's network parameters (hostname, domain, IP
address, subnet mask, gateway IP, DNS IP, etc.) from your network
administrator.
3 Connect the oscilloscope to the local area network (LAN) by inserting
LAN cable into the "LAN" port on the back of the oscilloscope.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
49
2
Setting Up
4 On the oscilloscope, verify that the controller interface is enabled:
a Press the Utility button.
b Using the softkeys, press I/O and Control.
c Ensure the box next to LAN is selected (
). If not ( ), use the
Entry knob to select LAN; then, press the Control softkey again.
5 Configure the oscilloscope's LAN interface:
a Press the Configure softkey until "LAN" is selected.
b Press the LAN Settings softkey.
c Press the Addresses softkey. Use the IP Options softkey and the
Entry knob to select DHCP, AutoIP, or netBIOS. Use the Modify
softkey (and the other softkeys and the Entry knob) to enter the IP
Address, Subnet Mask, Gateway IP, and DNS IP values. When you are
done, press the return (up arrow) softkey.
d Press the Domain softkey. Use the Modify softkey (and the other
softkeys and the Entry knob) to enter the Host name and the
Domain name. When you are done, press the return (up arrow)
softkey.
Using the GPIB Interface
1 Connect a GPIB cable from the controller PC's GPIB interface to the
"GPIB" port on the back of the oscilloscope.
2 On the oscilloscope, verify that the controller interface is enabled:
a Press the Utility button.
b Using the softkeys, press I/O and Control.
c Use the Entry knob to select "GPIB"; then, press the Control softkey
again.
Ensure the box next to GPIB is selected ( ). If not ( ), use the
Entry knob to select GPIB; then, press the Control softkey again.
3 Configure the oscilloscope's GPIB interface:
a Press the Configure softkey until "GPIB" is selected.
b Use the Entry knob to select the Address value.
50
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Setting Up
2
Step 3. Verify the oscilloscope connection
1 On the controller PC, click on the Agilent IO Control icon in the
taskbar and choose Agilent Connection Expert from the popup menu.
2 In the Agilent Connection Expert application, instruments connected to
the controller's USB and GPIB interfaces should automatically appear.
(You can click Refresh All to update the list of instruments on these
interfaces.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
51
2
Setting Up
You must manually add instruments on LAN interfaces:
a Right- click on the LAN interface, choose Add Instrument from the
popup menu
b If the oscilloscope is on the same subnet, select it, and click OK.
52
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Setting Up
2
Otherwise, if the instrument is not on the same subnet, click Add
Address.
i
In the next dialog, select either Hostname or IP address, and
enter the oscilloscope's hostname or IP address.
ii Click Test Connection.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
53
2
Setting Up
iii If the instrument is successfully opened, click OK to close the
dialog. If the instrument is not opened successfully, go back and
verify the LAN connections and the oscilloscope setup.
54
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
2
Setting Up
3 Test some commands on the instrument:
a Right- click on the instrument and choose Send Commands To This
Instrument from the popup menu.
b In the Agilent Interactive IO application, enter commands in the
Command field and press Send Command, Read Response, or
Send&Read.
c Choose Connect>Exit from the menu to exit the Agilent Interactive
IO application.
4 In the Agilent Connection Expert application, choose File>Exit from the
menu to exit the application.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
55
2
56
Setting Up
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
3
Getting Started
Basic Oscilloscope Program Structure 58
Programming the Oscilloscope 60
Other Ways of Sending Commands 69
This chapter gives you an overview of programming the 6000 Series
oscilloscopes. It describes basic oscilloscope program structure and shows
how to program the oscilloscope using a few simple examples.
The getting started examples show how to send oscilloscope setup, data
capture, and query commands, and they show how to read query results.
NOTE
Language for Program Examples
The programming examples in this guide are written in Visual Basic using the Agilent VISA
COM library.

57
3
Getting Started
Basic Oscilloscope Program Structure
The following figure shows the basic structure of every program you will
write for the oscilloscope.
Initializing
To ensure consistent, repeatable performance, you need to start the
program, controller, and oscilloscope in a known state. Without correct
initialization, your program may run correctly in one instance and not in
another. This might be due to changes made in configuration by previous
program runs or from the front panel of the oscilloscope.
• Program initialization defines and initializes variables, allocates
memory, or tests system configuration.
• Controller initialization ensures that the interface to the oscilloscope is
properly set up and ready for data transfer.
• Oscilloscope initialization sets the channel configuration, channel labels,
threshold voltages, trigger specification, trigger mode, timebase, and
acquisition type.
Capturing Data
Once you initialize the oscilloscope, you can begin capturing data for
analysis. Remember that while the oscilloscope is responding to commands
from the controller, it is not performing acquisitions. Also, when you
change the oscilloscope configuration, any data already captured will most
likely be rendered.
58
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Getting Started
3
To collect data, you use the :DIGitize command. This command clears the
waveform buffers and starts the acquisition process. Acquisition continues
until acquisition memory is full, then stops. The acquired data is displayed
by the oscilloscope, and the captured data can be measured, stored in
trace memory in the oscilloscope, or transferred to the controller for
further analysis. Any additional commands sent while :DIGitize is working
are buffered until :DIGitize is complete.
You could also put the oscilloscope into run mode, then use a wait loop in
your program to ensure that the oscilloscope has completed at least one
acquisition before you make a measurement. Agilent does not recommend
this because the needed length of the wait loop may vary, causing your
program to fail. :DIGitize, on the other hand, ensures that data capture is
complete. Also, :DIGitize, when complete, stops the acquisition process so
that all measurements are on displayed data, not on a constantly changing
data set.
Analyzing Captured Data
After the oscilloscope has completed an acquisition, you can find out more
about the data, either by using the oscilloscope measurements or by
transferring the data to the controller for manipulation by your program.
Built- in measurements include: frequency, duty cycle, period, positive
pulse width, and negative pulse width.
Using the :WAVeform commands, you can transfer the data to your
controller. You may want to display the data, compare it to a known good
measurement, or simply check logic patterns at various time intervals in
the acquisition.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
59
3
Getting Started
Programming the Oscilloscope
• "Referencing the IO Library" on page 60
• "Opening the Oscilloscope Connection via the IO Library" on page 61
• "Using :AUToscale to Automate Oscilloscope Setup" on page 62
• "Using Other Oscilloscope Setup Commands" on page 62
• "Capturing Data with the :DIGitize Command" on page 63
• "Reading Query Responses from the Oscilloscope" on page 65
• "Reading Query Results into String Variables" on page 66
• "Reading Query Results into Numeric Variables" on page 66
• "Reading Definite- Length Block Query Response Data" on page 66
• "Sending Multiple Queries and Reading Results" on page 67
• "Checking Instrument Status" on page 68
Referencing the IO Library
No matter which instrument programming library you use (SICL, VISA, or
VISA COM), you must reference the library from your program.
In C/C++, you must tell the compiler where to find the include and library
files (see the Agilent IO Libraries Suite documentation for more
information).
To reference the Agilent VISA COM library in Visual Basic for Applications
(VBA, which comes with Microsoft Office products like Excel):
1 Choose Tools>References... from the main menu.
2 In the References dialog, check the "VISA COM 3.0 Type Library".
60
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
3
Getting Started
3 Click OK.
To reference the Agilent VISA COM library in Microsoft Visual Basic 6.0:
1 Choose Project>References... from the main menu.
2 In the References dialog, check the "VISA COM 3.0 Type Library".
3 Click OK.
Opening the Oscilloscope Connection via the IO Library
PC controllers communicate with the oscilloscope by sending and receiving
messages over a remote interface. Once you have opened a connection to
the oscilloscope over the remote interface, programming instructions
normally appear as ASCII character strings embedded inside write
statements of the programing language. Read statements are used to read
query responses from the oscilloscope.
For example, when using the Agilent VISA COM library in Visual Basic
(after opening the connection to the instrument using the
ResourceManager object's Open method), the FormattedIO488 object's
WriteString, WriteNumber, WriteList, or WriteIEEEBlock methods are used
for sending commands and queries. After a query is sent, the response is
read using the ReadString, ReadNumber, ReadList, or ReadIEEEBlock
methods.
The following Visual Basic statements open the connection and send a
command that turns on the oscilloscope's label display.
Dim myMgr As VisaComLib.ResourceManager
Dim myScope As VisaComLib.FormattedIO488
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
' Open the connection to the oscilloscope. Get the VISA Address from the
' Agilent Connection Expert (installed with Agilent IO Libraries Suite).
Set myScope.IO = myMgr.Open("<VISA Address>")
' Send a command.
myScope.WriteString ":DISPlay:LABel ON"
The ":DISPLAY:LABEL ON" in the above example is called a program
message. Program messages are explained in more detail in "Program
Message Syntax" on page 799.
Initializing the Interface and the Oscilloscope
To make sure the bus and all appropriate interfaces are in a known state,
begin every program with an initialization statement. When using the
Agilent VISA COM library, you can use the resource session object's Clear
method to clears the interface buffer:
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
61
3
Getting Started
Dim myMgr As VisaComLib.ResourceManager
Dim myScope As VisaComLib.FormattedIO488
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
' Open the connection to the oscilloscope. Get the VISA Address from the
' Agilent Connection Expert (installed with Agilent IO Libraries Suite).
Set myScope.IO = myMgr.Open("<VISA Address>")
' Clear the interface buffer.
myScope.IO.Clear
When you are using GPIB, CLEAR also resets the oscilloscope's parser. The
parser is the program which reads in the instructions which you send it.
After clearing the interface, initialize the instrument to a preset state:
myScope.WriteString "*RST"
NOTE
Information for Initializing the Instrument
The actual commands and syntax for initializing the instrument are discussed in "Common
(*) Commands" on page 125.
Refer to the Agilent IO Libraries Suite documentation for information on initializing the
interface.
Using :AUToscale to Automate Oscilloscope Setup
The :AUToscale command performs a very useful function for unknown
waveforms by setting up the vertical channel, time base, and trigger level
of the instrument.
The syntax for the autoscale command is:
myScope.WriteString ":AUToscale"
Using Other Oscilloscope Setup Commands
A typical oscilloscope setup would set the vertical range and offset voltage,
the horizontal range, delay time, delay reference, trigger mode, trigger
level, and slope. An example of the commands that might be sent to the
oscilloscope are:
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
62
":CHANnel1:PROBe 10"
":CHANnel1:RANGe 16"
":CHANnel1:OFFSet 1.00"
":TIMebase:MODE MAIN"
":TIMebase:RANGe 1E-3"
":TIMebase:DELay 100E-6"
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Getting Started
3
Vertical is set to 16 V full- scale (2 V/div) with center of screen at 1 V and
probe attenuation set to 10. This example sets the time base at 1 ms
full- scale (100 ms/div) with a delay of 100 µs.
Example Oscilloscope Setup Code
This program demonstrates the basic command structure used to program
the oscilloscope.
' Initialize the instrument interface to a known state.
myScope.IO.Clear
' Initialize the instrument to a preset state.
myScope.WriteString "*RST"
' Set the time base mode to normal with the horizontal time at
' 50 ms/div with 0 s of delay referenced at the center of the
' graticule.
myScope.WriteString ":TIMebase:RANGe 5E-4"
' Time base to 50 us/div.
myScope.WriteString ":TIMebase:DELay 0"
' Delay to zero.
myScope.WriteString ":TIMebase:REFerence CENTer"
' Display ref. at
' center.
' Set the vertical range to 1.6 volts full scale with center screen
' at -0.4 volts with 10:1 probe attenuation and DC coupling.
myScope.WriteString ":CHANnel1:PROBe 10"
' Probe attenuation
' to 10:1.
myScope.WriteString ":CHANnel1:RANGe 1.6"
' Vertical range
' 1.6 V full scale.
myScope.WriteString ":CHANnel1:OFFSet -.4"
' Offset to -0.4.
myScope.WriteString ":CHANnel1:COUPling DC" ' Coupling to DC.
' Configure the instrument to trigger at -0.4 volts with normal
' triggering.
myScope.WriteString ":TRIGger:SWEep NORMal" ' Normal triggering.
myScope.WriteString ":TRIGger:LEVel -.4"
' Trigger level to -0.4.
myScope.WriteString ":TRIGger:SLOPe POSitive" ' Trigger on pos. slope.
' Configure the instrument for normal acquisition.
myScope.WriteString ":ACQuire:TYPE NORMal"
' Normal acquisition.
Capturing Data with the :DIGitize Command
The :DIGitize command captures data that meets the specifications set up
by the :ACQuire subsystem. When the digitize process is complete, the
acquisition is stopped. The captured data can then be measured by the
instrument or transferred to the controller for further analysis. The
captured data consists of two parts: the waveform data record, and the
preamble.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
63
3
Getting Started
NOTE
Ensure New Data is Collected
When you change the oscilloscope configuration, the waveform buffers are cleared. Before
doing a measurement, send the :DIGitize command to the oscilloscope to ensure new data
has been collected.
When you send the :DIGitize command to the oscilloscope, the specified
channel signal is digitized with the current :ACQuire parameters. To obtain
waveform data, you must specify the :WAVeform parameters for the
SOURce channel, the FORMat type, and the number of POINts prior to
sending the :WAVeform:DATA? query.
NOTE
Set :TIMebase:MODE to MAIN when using :DIGitize
:TIMebase:MODE must be set to MAIN to perform a :DIGitize command or to perform any
:WAVeform subsystem query. A "Settings conflict" error message will be returned if these
commands are executed when MODE is set to ROLL, XY, or WINDow (zoomed). Sending the
*RST (reset) command will also set the time base mode to normal.
The number of data points comprising a waveform varies according to the
number requested in the :ACQuire subsystem. The :ACQuire subsystem
determines the number of data points, type of acquisition, and number of
averages used by the :DIGitize command. This allows you to specify exactly
what the digitized information contains.
The following program example shows a typical setup:
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
myScope.WriteString
":ACQuire:TYPE AVERage"
":ACQuire:COMPlete 100"
":ACQuire:COUNt 8"
":DIGitize CHANnel1"
":WAVeform:SOURce CHANnel1"
":WAVeform:FORMat BYTE"
":WAVeform:POINts 500"
":WAVeform:DATA?"
This setup places the instrument into the averaged mode with eight
averages. This means that when the :DIGitize command is received, the
command will execute until the signal has been averaged at least eight
times.
After receiving the :WAVeform:DATA? query, the instrument will start
passing the waveform information.
Digitized waveforms are passed from the instrument to the controller by
sending a numerical representation of each digitized point. The format of
the numerical representation is controlled with the :WAVeform:FORMat
command and may be selected as BYTE, WORD, or ASCii.
64
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
3
Getting Started
The easiest method of transferring a digitized waveform depends on data
structures, formatting available and I/O capabilities. You must scale the
integers to determine the voltage value of each point. These integers are
passed starting with the left most point on the instrument's display.
For more information, see the waveform subsystem commands and
corresponding program code examples in ":WAVeform Commands" on
page 628.
NOTE
Aborting a Digitize Operation Over the Programming Interface
When using the programming interface, you can abort a digitize operation by sending a
Device Clear over the bus (for example, myScope.IO.Clear).
Reading Query Responses from the Oscilloscope
After receiving a query (command header followed by a question mark),
the instrument interrogates the requested function and places the answer
in its output queue. The answer remains in the output queue until it is
read or another command is issued. When read, the answer is transmitted
across the interface to the designated listener (typically a controller).
The statement for reading a query response message from an instrument's
output queue typically has a format specification for handling the response
message.
When using the VISA COM library in Visual Basic, you use different read
methods (ReadString, ReadNumber, ReadList, or ReadIEEEBlock) for the
various query response formats. For example, to read the result of the
query command :CHANnel1:COUPling? you would execute the statements:
myScope.WriteString ":CHANnel1:COUPling?"
Dim strQueryResult As String
strQueryResult = myScope.ReadString
This reads the current setting for the channel one coupling into the string
variable strQueryResult.
All results for queries (sent in one program message) must be read before
another program message is sent.
Sending another command before reading the result of the query clears
the output buffer and the current response. This also causes an error to
be placed in the error queue.
Executing a read statement before sending a query causes the controller to
wait indefinitely.
The format specification for handling response messages depends on the
programming language.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
65
3
Getting Started
Reading Query Results into String Variables
The output of the instrument may be numeric or character data depending
on what is queried. Refer to the specific command descriptions in
Chapter 5, “Commands by Subsystem,” starting on page 123 for the
formats and types of data returned from queries.
NOTE
Express String Variables Using Exact Syntax
In Visual Basic, string variables are case sensitive and must be expressed exactly the same
each time they are used.
The following example shows numeric data being returned to a string
variable:
myScope.WriteString ":CHANnel1:RANGe?"
Dim strQueryResult As String
strQueryResult = myScope.ReadString
MsgBox "Range (string):" + strQueryResult
After running this program, the controller displays:
Range (string): +40.0E+00
Reading Query Results into Numeric Variables
The following example shows numeric data being returned to a numeric
variable:
myScope.WriteString ":CHANnel1:RANGe?"
Dim varQueryResult As Variant
strQueryResult = myScope.ReadNumber
MsgBox "Range (variant):" + CStr(varQueryResult)
After running this program, the controller displays:
Range (variant): 40
Reading Definite-Length Block Query Response Data
Definite- length block query 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. The 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:
66
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
3
Getting Started
/TLADQNE%HFHSR
5G@S'NKKNV
"BST@K%@S@
AXSDRNEC@S@SDQLHM@SNQ
/TLADQNE#XSDR
SNAD5Q@MRLHSSDC
Figure 2
Definite-length block response data
The "8" states the number of digits that follow, and "00001000" states the
number of bytes to be transmitted.
The VISA COM library's ReadIEEEBlock and WriteIEEEBlock methods
understand the definite- length block syntax, so you can simply use
variables that contain the data:
' Read oscilloscope setup using ":SYSTem:SETup?" query.
myScope.WriteString ":SYSTem:SETup?"
Dim varQueryResult As Variant
varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1)
' Write learn string back to oscilloscope using ":SYSTem:SETup" command:
myScope.WriteIEEEBlock ":SYSTem:SETup ", varQueryResult
Sending Multiple Queries and Reading Results
You can send multiple queries to the instrument within a single command
string, but you must also read them back as a single query result. This can
be accomplished by reading them back into a single string variable,
multiple string variables, or multiple numeric variables.
For example, to read the :TIMebase:RANGe?;DELay? query result into a
single string variable, you could use the commands:
myScope.WriteString ":TIMebase:RANGe?;DELay?"
Dim strQueryResult As String
strQueryResult = myScope.ReadString
MsgBox "Timebase range; delay:" + strQueryResult
When you read the result of multiple queries into a single string variable,
each response is separated by a semicolon. For example, the output of the
previous example would be:
Timebase range; delay: <range_value>;<delay_value>
To read the :TIMebase:RANGe?;DELay? query result into multiple string
variables, you could use the ReadList method to read the query results
into a string array variable using the commands:
myScope.WriteString ":TIMebase:RANGe?;DELay?"
Dim strResults() As String
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
67
3
Getting Started
strResults() = myScope.ReadList(ASCIIType_BSTR)
MsgBox "Timebase range: " + strResults(0) + ", delay: " + strResults(1)
To read the :TIMebase:RANGe?;DELay? query result into multiple numeric
variables, you could use the ReadList method to read the query results
into a variant array variable using the commands:
myScope.WriteString ":TIMebase:RANGe?;DELay?"
Dim varResults() As Variant
varResults() = myScope.ReadList
MsgBox "Timebase range: " + FormatNumber(varResults(0) * 1000, 4) + _
" ms, delay: " + FormatNumber(varResults(1) * 1000000, 4) + " us"
Checking Instrument Status
Status registers track the current status of the instrument. By checking
the instrument status, you can find out whether an operation has been
completed, whether the instrument is receiving triggers, and more.
For more information, see Chapter 9, “Status Reporting,” starting on page
763 which explains how to check the status of the instrument.
68
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Getting Started
3
Other Ways of Sending Commands
Standard Commands for Programmable Instrumentation (SCPI) can be sent
via a Telnet socket or through the Browser Web Control.
Telnet Sockets
The following information is provided for programmers who wish to
control the oscilloscope with SCPI commands in a Telnet session.
To connect to the oscilloscope via a telnet socket, issue the following
command:
telnet <hostname> 5024
where <hostname> is the hostname of the oscilloscope. This will give you a
command line with prompt.
For a command line without a prompt, use port 5025. For example:
telnet <hostname> 5025
Sending SCPI Commands Using Browser Web Control
To send SCPI commands using the Browser Web Control feature, establish
a connection to the oscilloscope via LAN as described in the 6000 Series
Oscilloscopes User's Guide. When you make the connection to the
oscilloscope via LAN and the instrument's welcome page is displayed,
select the Browser Web Control tab, then select the Remote
Programming link.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
69
3
70
Getting Started
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
4
Commands Quick Reference
Command Summary 72
Syntax Elements 120

71
4
Commands Quick Reference
Command Summary
Table 2
Common (*) Commands Summary
Command
Query
Options and Query Returns
*CLS (see page 129)
n/a
n/a
*ESE <mask> (see
page 130)
*ESE? (see page 131)
<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
n/a
*ESR? (see page 132)
<status> ::= 0 to 255; an integer
in NR1 format
n/a
*IDN? (see page 132)
AGILENT TECHNOLOGIES,<model>,
<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
n/a
*LRN? (see page 135)
<learn_string> ::= current
instrument setup as a block of
data in IEEE 488.2 # format
*OPC (see page 136)
*OPC? (see page 136)
ASCII "1" is placed in the output
queue when all pending device
operations have completed.
72
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 2
Common (*) Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
*OPT? (see page 137)
<return_value> ::= 0,0,<license
info>
<license info> ::= <All field>,
<reserved>, <Factory MSO>,
<Upgraded MSO>,
<Xilinx FPGA Probe>, <Memory>,
<Low Speed Serial>,
<Automotive Serial>, <reserved>,
<Secure>, <Battery>,
<Altera FPGA Probe>,
<FlexRay Serial>,
<Power Measurements>,
<RS-232/UART Serial>,
<reserved>, <Segmented Memory>,
<Mask Test>, <reserved>,
<reserved>, <FlexRay
Conformance>, <reserved>,
<reserved>, <I2S Serial>,
<FlexRay Trigger/Decode>,
<reserved>, <reserved>, <MIL-STD
1553 Trigger/Decode>, <reserved>
<All field> ::= {0 | All}
<reserved> ::= 0
<Factory MSO> ::= {0 | MSO}
<Upgraded MSO> ::= {0 | MSO}
<Xilinx FPGA Probe> ::= {0 | FPG}
<Memory> ::= {0 | mem2M | mem8M}
<Low Speed Serial> ::= {0 | LSS}
<Automotive Serial> ::= {0 | AMS}
<Secure> ::= {0 | SEC}
<Battery> ::= {0 | BAT}
<Altera FPGA Probe> ::= {0 | ALT}
<FlexRay Serial> ::= {0 | FRS}
<Power Measurements> ::= {0 |
PWR}
<RS-232/UART Serial> ::= {0 |
232}
<Segmented Memory> ::= {0 | SGM}
<Mask Test> ::= {0 | LMT}
<FlexRay Conformance> ::= {0 |
FRC}
<I2S Serial> ::= {0 | SND}
<FlexRay Trigger/Decode> ::= {0 |
FLX}
<MIL-STD 1553 Trigger/Decode>
::= {0 | 553}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
73
4
Commands Quick Reference
Table 2
Common (*) Commands Summary (continued)
Command
Query
Options and Query Returns
*RCL <value> (see
page 139)
n/a
<value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*RST (see page 140)
n/a
See *RST (Reset) (see page 140)
*SAV <value> (see
page 143)
n/a
<value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*SRE <mask> (see
page 144)
*SRE? (see page 145)
<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
n/a
*STB? (see page 146)
<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 148)
n/a
n/a
n/a
*TST? (see page 149)
<result> ::= 0 or non-zero value;
an integer in NR1 format
*WAI (see page 150)
n/a
n/a
74
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 3
Root (:) Commands Summary
Command
Query
Options and Query Returns
:ACTivity (see
page 154)
:ACTivity? (see
page 154)
<return value> ::=
<edges>,<levels>
<edges> ::= presence of edges
(32-bit integer in NR1 format)
<levels> ::= logical highs or
lows (32-bit integer in NR1
format)
n/a
:AER? (see page 155)
{0 | 1}; an integer in NR1 format
:AUToscale
[<source>[,..,<source
>]] (see page 156)
n/a
<source> ::= CHANnel<n> for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD1 |
POD2} for MSO models
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
:AUToscale:AMODE
<value> (see
page 158)
:AUToscale:AMODE?
(see page 158)
<value> ::= {NORMal | CURRent}}
:AUToscale:CHANnels
<value> (see
page 159)
:AUToscale:CHANnels?
(see page 159)
<value> ::= {ALL | DISPlayed}}
:BLANk [<source>]
(see page 160)
n/a
<source> ::= {CHANnel<n>} |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:CDISplay (see
page 161)
n/a
n/a
:DIGitize
[<source>[,..,<source
>]] (see page 162)
n/a
<source> ::= {CHANnel<n> |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS} for MSO models
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
75
4
Commands Quick Reference
Table 3
Root (:) Commands Summary (continued)
Command
Query
Options and Query Returns
:HWEenable <n> (see
page 164)
:HWEenable? (see
page 164)
<n> ::= 16-bit integer in NR1
format
n/a
:HWERregister:CONDiti
on? (see page 166)
<n> ::= 16-bit integer in NR1
format
n/a
:HWERegister[:EVENt]?
(see page 168)
<n> ::= 16-bit integer in NR1
format
:MERGe <pixel memory>
(see page 170)
n/a
<pixel memory> ::= {PMEMory{0 | 1
| 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}}
:MTEenable <n> (see
page 171)
:MTEenable? (see
page 171)
<n> ::= 16-bit integer in NR1
format
n/a
:MTERegister[:EVENt]?
(see page 173)
<n> ::= 16-bit integer in NR1
format
:OPEE <n> (see
page 175)
:OPEE? (see page 176)
<n> ::= 16-bit integer in NR1
format
n/a
:OPERregister:CONDiti
on? (see page 177)
<n> ::= 16-bit integer in NR1
format
n/a
:OPERegister[:EVENt]?
(see page 179)
<n> ::= 16-bit integer in NR1
format
:OVLenable <mask>
(see page 181)
:OVLenable? (see
page 182)
<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
n/a
:OVLRegister? (see
page 183)
<value> ::= integer in NR1
format. See OVLenable for <value>
:PRINt [<options>]
(see page 185)
n/a
<options> ::= [<print
option>][,..,<print option>]
<print option> ::= {COLor |
GRAYscale | PRINter0 | BMP8bit |
BMP | PNG | NOFactors | FACTors}
<print option> can be repeated up
to 5 times.
76
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands Quick Reference
Table 3
Root (:) Commands Summary (continued)
Command
Query
Options and Query Returns
:RUN (see page 186)
n/a
n/a
n/a
:SERial (see
page 187)
<return value> ::= unquoted
string containing serial number
:SINGle (see
page 188)
n/a
n/a
n/a
:STATus? <display>
(see page 189)
{0 | 1}
<display> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS}
<n> ::= 1-2 or 1-4 in NR1 format
:STOP (see page 190)
n/a
n/a
n/a
:TER? (see page 191)
{0 | 1}
:VIEW <source> (see
page 192)
n/a
<source> ::= {CHANnel<n> |
PMEMory{0 | 1 | 2 | 3 | 4 | 5 | 6
| 7 | 8 | 9} | FUNCtion | MATH |
SBUS} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
PMEMory{0 | 1 | 2 | 3 | 4 | 5 | 6
| 7 | 8 | 9} | POD{1 | 2} | BUS{1
| 2} | FUNCtion | MATH | SBUS}
for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
Table 4
4
:ACQuire Commands Summary
Command
Query
Options and Query Returns
n/a
:ACQuire:AALias? (see
page 195)
{1 | 0}
:ACQuire:COMPlete
<complete> (see
page 196)
:ACQuire:COMPlete?
(see page 196)
<complete> ::= 100; an integer in
NR1 format
:ACQuire:COUNt
<count> (see
page 197)
:ACQuire:COUNt? (see
page 197)
<count> ::= an integer from 2 to
65536 in NR1 format
:ACQuire:DAALias
<mode> (see page 198)
:ACQuire:DAALias?
(see page 198)
<mode> ::= {DISable | AUTO}
:ACQuire:MODE <mode>
(see page 199)
:ACQuire:MODE? (see
page 199)
<mode> ::= {RTIMe | ETIMe |
SEGMented}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
77
4
Commands Quick Reference
Table 4
:ACQuire Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:ACQuire:POINts? (see
page 200)
<# points> ::= an integer in NR1
format
:ACQuire:RSIGnal
<ref_signal_mode>
(see page 201)
:ACQuire:RSIGnal?
(see page 201)
<ref_signal_mode> ::= {OFF | OUT
| IN}
:ACQuire:SEGMented:AN
ALyze (see page 202)
n/a
n/a (with Option SGM)
:ACQuire:SEGMented:CO
UNt <count> (see
page 203)
:ACQuire:SEGMented:CO
UNt? (see page 203)
<count> ::= an integer from 2 to
2000 (w/8M memory) in NR1 format
(with Option SGM)
:ACQuire:SEGMented:IN
Dex <index> (see
page 204)
:ACQuire:SEGMented:IN
Dex? (see page 204)
<index> ::= an integer from 2 to
2000 (w/8M memory) in NR1 format
(with Option SGM)
n/a
:ACQuire:SRATe? (see
page 207)
<sample_rate> ::= sample rate
(samples/s) in NR3 format
:ACQuire:TYPE <type>
(see page 208)
:ACQuire:TYPE? (see
page 208)
<type> ::= {NORMal | AVERage |
HRESolution | PEAK}
Table 5
:BUS<n> Commands Summary
Command
Query
Options and Query Returns
:BUS<n>:BIT<m> {{0 |
OFF} | {1 | ON}} (see
page 212)
:BUS<n>:BIT<m>? (see
page 212)
{0 | 1}
<n> ::= 1 or 2; an integer in NR1
format
<m> ::= 0-15; an integer in NR1
format
:BUS<n>:BITS
<channel_list>, {{0 |
OFF} | {1 | ON}} (see
page 213)
:BUS<n>:BITS? (see
page 213)
<channel_list>, {0 | 1}
<channel_list> ::= (@<m>,<m>:<m>
...) where "," is separator and
":" is range
<n> ::= 1 or 2; an integer in NR1
format
<m> ::= 0-15; an integer in NR1
format
:BUS<n>:CLEar (see
page 215)
n/a
<n> ::= 1 or 2; an integer in NR1
format
:BUS<n>:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 216)
:BUS<n>:DISPlay? (see
page 216)
{0 | 1}
<n> ::= 1 or 2; an integer in NR1
format
78
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands Quick Reference
Table 5
:BUS<n> Commands Summary (continued)
Command
Query
Options and Query Returns
:BUS<n>:LABel
<string> (see
page 217)
:BUS<n>:LABel? (see
page 217)
<string> ::= quoted ASCII string
up to 10 characters
<n> ::= 1 or 2; an integer in NR1
format
:BUS<n>:MASK <mask>
(see page 218)
:BUS<n>:MASK? (see
page 218)
<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
<n> ::= 1 or 2; an integer in NR1
format
Table 6
4
:CALibrate Commands Summary
Command
Query
Options and Query Returns
n/a
:CALibrate:DATE? (see
page 221)
<return value> ::=
<day>,<month>,<year>; all in NR1
format
:CALibrate:LABel
<string> (see
page 222)
:CALibrate:LABel?
(see page 222)
<string> ::= quoted ASCII string
up to 32 characters
:CALibrate:OUTPut
<signal> (see
page 223)
:CALibrate:OUTPut?
(see page 223)
<signal> ::= {TRIGgers | SOURce |
DSOurce | MASK}
:CALibrate:STARt (see
page 224)
n/a
n/a
n/a
:CALibrate:STATus?
(see page 225)
<return value> ::=
ALL,<status_code>,<status_string
>
<status_code> ::= an integer
status code
<status_string> ::= an ASCII
status string
n/a
:CALibrate:SWITch?
(see page 226)
{PROTected | UNPRotected}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
79
4
Commands Quick Reference
Table 6
:CALibrate Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:CALibrate:TEMPeratur
e? (see page 227)
<return value> ::= degrees C
delta since last cal in NR3
format
n/a
:CALibrate:TIME? (see
page 228)
<return value> ::=
<hours>,<minutes>,<seconds>; all
in NR1 format
Table 7
:CHANnel<n> Commands Summary
Command
Query
Options and Query Returns
:CHANnel<n>:BWLimit
{{0 | OFF} | {1 |
ON}} (see page 232)
:CHANnel<n>:BWLimit?
(see page 232)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:COUPling
<coupling> (see
page 233)
:CHANnel<n>:COUPling?
(see page 233)
<coupling> ::= {AC | DC}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:DISPlay
{{0 | OFF} | {1 |
ON}} (see page 234)
:CHANnel<n>:DISPlay?
(see page 234)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:IMPedance
<impedance> (see
page 235)
:CHANnel<n>:IMPedance
? (see page 235)
<impedance> ::= {ONEMeg | FIFTy}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:INVert
{{0 | OFF} | {1 |
ON}} (see page 236)
:CHANnel<n>:INVert?
(see page 236)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:LABel
<string> (see
page 237)
:CHANnel<n>:LABel?
(see page 237)
<string> ::= any series of 10 or
less ASCII characters enclosed in
quotation marks
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:OFFSet
<offset>[suffix] (see
page 238)
:CHANnel<n>:OFFSet?
(see page 238)
<offset> ::= Vertical offset
value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4; in NR1 format
:CHANnel<n>:PROBe
<attenuation> (see
page 239)
:CHANnel<n>:PROBe?
(see page 239)
<attenuation> ::= Probe
attenuation ratio in NR3 format
<n> ::= 1-2 or 1-4r in NR1 format
:CHANnel<n>:PROBe:HEA
D[:TYPE] <head_param>
(see page 240)
:CHANnel<n>:PROBe:HEA
D[:TYPE]? (see
page 240)
<head_param> ::= {SEND0 | SEND6 |
SEND12 | SEND20 | DIFF0 | DIFF6 |
DIFF12 | DIFF20 | NONE}
<n> ::= 1-2 or 1-4 in NR1 format
80
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands Quick Reference
Table 7
:CHANnel<n> Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:CHANnel<n>:PROBe:ID?
(see page 241)
<probe id> ::= unquoted ASCII
string up to 11 characters
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROBe:SKE
W <skew_value> (see
page 242)
:CHANnel<n>:PROBe:SKE
W? (see page 242)
<skew_value> ::= -100 ns to +100
ns in NR3 format
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROBe:STY
Pe <signal type> (see
page 243)
:CHANnel<n>:PROBe:STY
Pe? (see page 243)
<signal type> ::= {DIFFerential |
SINGle}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROTectio
n (see page 244)
:CHANnel<n>:PROTectio
n? (see page 244)
{NORM | TRIP}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:RANGe
<range>[suffix] (see
page 245)
:CHANnel<n>:RANGe?
(see page 245)
<range> ::= Vertical full-scale
range value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:SCALe
<scale>[suffix] (see
page 246)
:CHANnel<n>:SCALe?
(see page 246)
<scale> ::= Vertical units per
division value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:UNITs
<units> (see
page 247)
:CHANnel<n>:UNITs?
(see page 247)
<units> ::= {VOLT | AMPere}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:VERNier
{{0 | OFF} | {1 |
ON}} (see page 248)
:CHANnel<n>:VERNier?
(see page 248)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
Table 8
4
:DIGital<n> Commands Summary
Command
Query
Options and Query Returns
:DIGital<n>:DISPlay
{{0 | OFF} | {1 |
ON}} (see page 251)
:DIGital<n>:DISPlay?
(see page 251)
{0 | 1}
<n> ::= 0-15; an integer in NR1
format
:DIGital<n>:LABel
<string> (see
page 252)
:DIGital<n>:LABel?
(see page 252)
<string> ::= any series of 10 or
less ASCII characters enclosed in
quotation marks
<n> ::= 0-15; an integer in NR1
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
81
4
Commands Quick Reference
Table 8
:DIGital<n> Commands Summary (continued)
Command
Query
Options and Query Returns
:DIGital<n>:POSition
<position> (see
page 253)
:DIGital<n>:POSition?
(see page 253)
<n> ::= 0-15; an integer in NR1
format
<position> ::= 0-7 if display
size = large, 0-15 if size =
medium, 0-31 if size = small
:DIGital<n>:SIZE
<value> (see
page 254)
:DIGital<n>:SIZE?
(see page 254)
<value> ::= {SMALl | MEDium |
LARGe}
:DIGital<n>:THReshold
<value>[suffix] (see
page 255)
:DIGital<n>:THReshold
? (see page 255)
<n> ::= 0-15; an integer in NR1
format
<value> ::= {CMOS | ECL | TTL |
<user defined value>}
<user defined value> ::= value in
NR3 format from -8.00 to +8.00
[suffix] ::= {V | mV | uV}
Table 9
:DISPlay Commands Summary
Command
Query
Options and Query Returns
:DISPlay:CLEar (see
page 258)
n/a
n/a
:DISPlay:DATA
[<format>][,][<area>]
[,][<palette>]<displa
y data> (see
page 259)
:DISPlay:DATA?
[<format>][,][<area>]
[,][<palette>] (see
page 259)
<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
:DISPlay:LABel {{0 |
OFF} | {1 | ON}} (see
page 261)
:DISPlay:LABel? (see
page 261)
{0 | 1}
:DISPlay:LABList
<binary block> (see
page 262)
:DISPlay:LABList?
(see page 262)
<binary block> ::= an ordered
list of up to 75 labels, each 10
characters maximum, separated by
newline characters
82
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 9
:DISPlay Commands Summary (continued)
Command
Query
Options and Query Returns
:DISPlay:PERSistence
<value> (see
page 263)
:DISPlay:PERSistence?
(see page 263)
<value> ::= {MINimum | INFinite}}
:DISPlay:SOURce
<value> (see
page 264)
:DISPlay:SOURce? (see
page 264)
<value> ::= {PMEMory{0 | 1 | 2 |
3 | 4 | 5 | 6 | 7 | 8 | 9}}
:DISPlay:VECTors {{1
| ON} | {0 | OFF}}
(see page 265)
:DISPlay:VECTors?
(see page 265)
{1 | 0}
Table 10 :EXTernal Trigger Commands Summary
Command
Query
Options and Query Returns
:EXTernal:BWLimit
<bwlimit> (see
page 268)
:EXTernal:BWLimit?
(see page 268)
<bwlimit> ::= {0 | OFF}
:EXTernal:IMPedance
<value> (see
page 269)
:EXTernal:IMPedance?
(see page 269)
<impedance> ::= {ONEMeg | FIFTy}
:EXTernal:PROBe
<attenuation> (see
page 270)
:EXTernal:PROBe? (see
page 270)
<attenuation> ::= probe
attenuation ratio in NR3 format
n/a
:EXTernal:PROBe:ID?
(see page 271)
<probe id> ::= unquoted ASCII
string up to 11 characters
:EXTernal:PROBe:STYPe
<signal type> (see
page 272)
:EXTernal:PROBe:STYPe
? (see page 272)
<signal type> ::= {DIFFerential |
SINGle}
:EXTernal:PROTection[
:CLEar] (see
page 273)
:EXTernal:PROTection?
(see page 273)
{NORM | TRIP}
:EXTernal:RANGe
<range>[<suffix>]
(see page 274)
:EXTernal:RANGe? (see
page 274)
<range> ::= vertical full-scale
range value in NR3 format
<suffix> ::= {V | mV}
:EXTernal:UNITs
<units> (see
page 275)
:EXTernal:UNITs? (see
page 275)
<units> ::= {VOLT | AMPere}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
83
4
Commands Quick Reference
Table 11 :FUNCtion Commands Summary
Command
Query
Options and Query Returns
:FUNCtion:CENTer
<frequency> (see
page 279)
:FUNCtion:CENTer?
(see page 279)
<frequency> ::= the current
center frequency in NR3 format.
The range of legal values is from
0 Hz to 25 GHz.
:FUNCtion:DISPlay {{0
| OFF} | {1 | ON}}
(see page 280)
:FUNCtion:DISPlay?
(see page 280)
{0 | 1}
:FUNCtion:GOFT:OPERat
ion <operation> (see
page 281)
:FUNCtion:GOFT:OPERat
ion? (see page 281)
<operation> ::= {ADD | SUBTract |
MULTiply}
:FUNCtion:GOFT:SOURce
1 <source> (see
page 282)
:FUNCtion:GOFT:SOURce
1? (see page 282)
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
:FUNCtion:GOFT:SOURce
2 <source> (see
page 283)
:FUNCtion:GOFT:SOURce
2? (see page 283)
<source> ::= CHANnel<n>
<n> ::= {{1 | 2} | {3 | 4}} for
4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
:FUNCtion:OFFSet
<offset> (see
page 284)
:FUNCtion:OFFSet?
(see page 284)
<offset> ::= the value at center
screen in NR3 format.
The range of legal values is
+/-10 times the current
sensitivity of the selected
function.
:FUNCtion:OPERation
<operation> (see
page 285)
:FUNCtion:OPERation?
(see page 285)
<operation> ::= {ADD | SUBTract |
MULTiply | INTegrate |
DIFFerentiate | FFT | SQRT}
:FUNCtion:RANGe
<range> (see
page 286)
:FUNCtion:RANGe? (see
page 286)
<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.
84
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 11 :FUNCtion Commands Summary (continued)
Command
Query
Options and Query Returns
:FUNCtion:REFerence
<level> (see
page 287)
:FUNCtion:REFerence?
(see page 287)
<level> ::= the value at center
screen in NR3 format.
The range of legal values is
+/-10 times the current
sensitivity of the selected
function.
:FUNCtion:SCALe
<scale
value>[<suffix>] (see
page 288)
:FUNCtion:SCALe? (see
page 288)
<scale value> ::= integer in NR1
format
<suffix> ::= {V | dB}
:FUNCtion:SOURce1
<source> (see
page 289)
:FUNCtion:SOURce1?
(see page 289)
<source> ::= {CHANnel<n> | GOFT}
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
GOFT is only for FFT, INTegrate,
DIFFerentiate, and SQRT
operations.
:FUNCtion:SOURce2
<source> (see
page 290)
:FUNCtion:SOURce2?
(see page 290)
<source> ::= {CHANnel<n> | NONE}
<n> ::= {{1 | 2} | {3 | 4}} for
4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
:FUNCtion:SPAN <span>
(see page 291)
:FUNCtion:SPAN? (see
page 291)
<span> ::= the current frequency
span in NR3 format.
Legal values are 1 Hz to 100 GHz.
:FUNCtion:WINDow
<window> (see
page 292)
:FUNCtion:WINDow?
(see page 292)
<window> ::= {RECTangular |
HANNing | FLATtop | BHARris}
Table 12 :HARDcopy Commands Summary
Command
Query
Options and Query Returns
:HARDcopy:AREA <area>
(see page 295)
:HARDcopy:AREA? (see
page 295)
<area> ::= SCReen
:HARDcopy:APRinter
<active_printer> (see
page 296)
:HARDcopy:APRinter?
(see page 296)
<active_printer> ::= {<index> |
<name>}
<index> ::= integer index of
printer in list
<name> ::= name of printer in
list
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
85
4
Commands Quick Reference
Table 12 :HARDcopy Commands Summary (continued)
Command
Query
Options and Query Returns
:HARDcopy:FACTors {{0
| OFF} | {1 | ON}}
(see page 297)
:HARDcopy:FACTors?
(see page 297)
{0 | 1}
:HARDcopy:FFEed {{0 |
OFF} | {1 | ON}} (see
page 298)
:HARDcopy:FFEed? (see
page 298)
{0 | 1}
:HARDcopy:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 299)
:HARDcopy:INKSaver?
(see page 299)
{0 | 1}
:HARDcopy:LAYout
<layout> (see
page 300)
:HARDcopy:LAYout?
(see page 300)
<layout> ::= {LANDscape |
PORTrait}
:HARDcopy:PALette
<palette> (see
page 301)
:HARDcopy:PALette?
(see page 301)
<palette> ::= {COLor | GRAYscale
| NONE}
n/a
:HARDcopy:PRINter:LIS
T? (see page 302)
<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 303)
n/a
n/a
Table 13 :LISTer Commands Summary
Command
Query
Options and Query Returns
n/a
:LISTer:DATA? (see
page 305)
<binary_block> ::=
comma-separated data with
newlines at the end of each row
:LISTer:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 306)
:LISTer:DISPlay? (see
page 306)
{0 | 1}
86
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands Quick Reference
4
Table 14 :MARKer Commands Summary
Command
Query
Options and Query Returns
:MARKer:MODE <mode>
(see page 309)
:MARKer:MODE? (see
page 309)
<mode> ::= {OFF | MEASurement |
MANual | WAVeform}
:MARKer:X1Position
<position>[suffix]
(see page 310)
:MARKer:X1Position?
(see page 310)
<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
:MARKer:X1Y1source
<source> (see
page 311)
:MARKer:X1Y1source?
(see page 311)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
:MARKer:X2Position
<position>[suffix]
(see page 312)
:MARKer:X2Position?
(see page 312)
<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
:MARKer:X2Y2source
<source> (see
page 313)
:MARKer:X2Y2source?
(see page 313)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
n/a
:MARKer:XDELta? (see
page 314)
<return_value> ::= X cursors
delta value in NR3 format
:MARKer:Y1Position
<position>[suffix]
(see page 315)
:MARKer:Y1Position?
(see page 315)
<position> ::= Y1 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y1 cursor
position value in NR3 format
:MARKer:Y2Position
<position>[suffix]
(see page 316)
:MARKer:Y2Position?
(see page 316)
<position> ::= Y2 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y2 cursor
position value in NR3 format
n/a
:MARKer:YDELta? (see
page 317)
<return_value> ::= Y cursors
delta value in NR3 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
87
4
Commands Quick Reference
Table 15 :MEASure Commands Summary
Command
Query
Options and Query Returns
:MEASure:CLEar (see
page 326)
n/a
n/a
:MEASure:COUNter
[<source>] (see
page 327)
:MEASure:COUNter?
[<source>] (see
page 327)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= counter
frequency in Hertz in NR3 format
:MEASure:DEFine
DELay, <delay spec>
(see page 328)
:MEASure:DEFine?
DELay (see page 329)
<delay spec> ::=
<edge_spec1>,<edge_spec2>
edge_spec1 ::=
[<slope>]<occurrence>
edge_spec2 ::=
[<slope>]<occurrence>
<slope> ::= {+ | -}
<occurrence> ::= integer
:MEASure:DEFine
THResholds,
<threshold spec> (see
page 328)
:MEASure:DEFine?
THResholds (see
page 329)
<threshold spec> ::= {STANdard} |
{<threshold mode>,<upper>,
<middle>,<lower>}
<threshold mode> ::= {PERCent |
ABSolute}
:MEASure:DELay
[<source1>]
[,<source2>] (see
page 331)
:MEASure:DELay?
[<source1>]
[,<source2>] (see
page 331)
<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 333)
:MEASure:DUTYcycle?
[<source>] (see
page 333)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= ratio of
positive pulse width to period in
NR3 format
88
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 15 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:FALLtime
[<source>] (see
page 334)
:MEASure:FALLtime?
[<source>] (see
page 334)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds between the lower and
upper thresholds in NR3 format
:MEASure:FREQuency
[<source>] (see
page 335)
:MEASure:FREQuency?
[<source>] (see
page 335)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= frequency in
Hertz in NR3 format
:MEASure:NWIDth
[<source>] (see
page 336)
:MEASure:NWIDth?
[<source>] (see
page 336)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= negative
pulse width in seconds-NR3 format
:MEASure:OVERshoot
[<source>] (see
page 337)
:MEASure:OVERshoot?
[<source>] (see
page 337)
<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
:MEASure:PERiod
[<source>] (see
page 339)
:MEASure:PERiod?
[<source>] (see
page 339)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= waveform
period in seconds in NR3 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
89
4
Commands Quick Reference
Table 15 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:PHASe
[<source1>]
[,<source2>] (see
page 340)
:MEASure:PHASe?
[<source1>]
[,<source2>] (see
page 340)
<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 341)
:MEASure:PREShoot?
[<source>] (see
page 341)
<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
:MEASure:PWIDth
[<source>] (see
page 342)
:MEASure:PWIDth?
[<source>] (see
page 342)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= width of
positive pulse in seconds in NR3
format
n/a
:MEASure:RESults?
<result_list> (see
page 343)
<result_list> ::=
comma-separated list of
measurement results
:MEASure:RISetime
[<source>] (see
page 346)
:MEASure:RISetime?
[<source>] (see
page 346)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= rise time in
seconds in NR3 format
:MEASure:SDEViation
[<source>] (see
page 347)
:MEASure:SDEViation?
[<source>] (see
page 347)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
std deviation in NR3 format
:MEASure:SHOW {1 |
ON} (see page 348)
:MEASure:SHOW? (see
page 348)
{1}
90
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 15 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:SOURce
<source1>
[,<source2>] (see
page 349)
:MEASure:SOURce? (see
page 349)
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH | EXTernal} for
DSO models
<source1,2> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH | EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= {<source> |
NONE}
:MEASure:STATistics
<type> (see page 351)
:MEASure:STATistics?
(see page 351)
<type> ::= {{ON | 1} | CURRent |
MEAN | MINimum | MAXimum | STDDev
| COUNt}
ON ::= all statistics returned
:MEASure:STATistics:I
NCRement (see
page 352)
n/a
n/a
:MEASure:STATistics:R
ESet (see page 353)
n/a
n/a
n/a
:MEASure:TEDGe?
<slope><occurrence>[,
<source>] (see
page 354)
<slope> ::= direction of the
waveform
<occurrence> ::= the transition
to be reported
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds of the specified
transition
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
91
4
Commands Quick Reference
Table 15 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:MEASure:TVALue?
<value>,
[<slope>]<occurrence>
[,<source>] (see
page 356)
<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} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:MEASure:VAMPlitude
[<source>] (see
page 358)
:MEASure:VAMPlitude?
[<source>] (see
page 358)
<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
:MEASure:VAVerage
[<source>] (see
page 359)
:MEASure:VAVerage?
[<source>] (see
page 359)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
average voltage in NR3 format
:MEASure:VBASe
[<source>] (see
page 360)
:MEASure:VBASe?
[<source>] (see
page 360)
<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
:MEASure:VMAX
[<source>] (see
page 361)
:MEASure:VMAX?
[<source>] (see
page 361)
<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
:MEASure:VMIN
[<source>] (see
page 362)
:MEASure:VMIN?
[<source>] (see
page 362)
<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
92
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 15 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:VPP
[<source>] (see
page 363)
:MEASure:VPP?
[<source>] (see
page 363)
<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
:MEASure:VRATio
[<source1>]
[,<source2>] (see
page 340)
:MEASure:VRATio?
[<source1>]
[,<source2>] (see
page 364)
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the ratio
value in dB in NR3 format
:MEASure:VRMS
[<source>] (see
page 365)
:MEASure:VRMS?
[<source>] (see
page 365)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated dc
RMS voltage in NR3 format
n/a
:MEASure:VTIMe?
<vtime>[,<source>]
(see page 366)
<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} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:MEASure:VTOP
[<source>] (see
page 367)
:MEASure:VTOP?
[<source>] (see
page 367)
<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
:MEASure:XMAX
[<source>] (see
page 368)
:MEASure:XMAX?
[<source>] (see
page 368)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
:MEASure:XMIN
[<source>] (see
page 369)
:MEASure:XMIN?
[<source>] (see
page 369)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
93
4
Commands Quick Reference
Table 16 :MTESt Commands Summary
Command
Query
Options and Query Returns
:MTESt:AMASk:CREate
(see page 375)
n/a
n/a
:MTESt:AMASk:SOURce
<source> (see
page 376)
:MTESt:AMASk:SOURce?
(see page 376)
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
:MTESt:AMASk:UNITs
<units> (see
page 377)
:MTESt:AMASk:UNITs?
(see page 377)
<units> ::= {CURRent | DIVisions}
:MTESt:AMASk:XDELta
<value> (see
page 378)
:MTESt:AMASk:XDELta?
(see page 378)
<value> ::= X delta value in NR3
format
:MTESt:AMASk:YDELta
<value> (see
page 379)
:MTESt:AMASk:YDELta?
(see page 379)
<value> ::= Y delta value in NR3
format
n/a
:MTESt:COUNt:FWAVefor
ms? [CHANnel<n>] (see
page 380)
<failed> ::= number of failed
waveforms in NR1 format
:MTESt:COUNt:RESet
(see page 381)
n/a
n/a
n/a
:MTESt:COUNt:TIME?
(see page 382)
<time> ::= elapsed seconds in NR3
format
n/a
:MTESt:COUNt:WAVeform
s? (see page 383)
<count> ::= number of waveforms
in NR1 format
:MTESt:DATA <mask>
(see page 384)
:MTESt:DATA? (see
page 384)
<mask> ::= data in IEEE 488.2 #
format.
:MTESt:DELete (see
page 385)
n/a
n/a
:MTESt:ENABle {{0 |
OFF} | {1 | ON}} (see
page 386)
:MTESt:ENABle? (see
page 386)
{0 | 1}
:MTESt:LOCK {{0 |
OFF} | {1 | ON}} (see
page 387)
:MTESt:LOCK? (see
page 387)
{0 | 1}
:MTESt:OUTPut
<signal> (see
page 388)
:MTESt:OUTPut? (see
page 388)
<signal> ::= {FAIL | PASS}
:MTESt:RMODe <rmode>
(see page 389)
:MTESt:RMODe? (see
page 389)
<rmode> ::= {FORever | TIME |
SIGMa | WAVeforms}
94
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands Quick Reference
4
Table 16 :MTESt Commands Summary (continued)
Command
Query
Options and Query Returns
:MTESt:RMODe:FACTion:
MEASure {{0 | OFF} |
{1 | ON}} (see
page 390)
:MTESt:RMODe:FACTion:
MEASure? (see
page 390)
{0 | 1}
:MTESt:RMODe:FACTion:
PRINt {{0 | OFF} | {1
| ON}} (see page 391)
:MTESt:RMODe:FACTion:
PRINt? (see page 391)
{0 | 1}
:MTESt:RMODe:FACTion:
SAVE {{0 | OFF} | {1
| ON}} (see page 392)
:MTESt:RMODe:FACTion:
SAVE? (see page 392)
{0 | 1}
:MTESt:RMODe:FACTion:
STOP {{0 | OFF} | {1
| ON}} (see page 393)
:MTESt:RMODe:FACTion:
STOP? (see page 393)
{0 | 1}
:MTESt:RMODe:SIGMa
<level> (see
page 394)
:MTESt:RMODe:SIGMa?
(see page 394)
<level> ::= from 0.1 to 9.3 in
NR3 format
:MTESt:RMODe:TIME
<seconds> (see
page 395)
:MTESt:RMODe:TIME?
(see page 395)
<seconds> ::= from 1 to 86400 in
NR3 format
:MTESt:RMODe:WAVeform
s <count> (see
page 396)
:MTESt:RMODe:WAVeform
s? (see page 396)
<count> ::= number of waveforms
in NR1 format
:MTESt:SCALe:BIND {{0
| OFF} | {1 | ON}}
(see page 397)
:MTESt:SCALe:BIND?
(see page 397)
{0 | 1}
:MTESt:SCALe:X1
<x1_value> (see
page 398)
:MTESt:SCALe:X1? (see
page 398)
<x1_value> ::= X1 value in NR3
format
:MTESt:SCALe:XDELta
<xdelta_value> (see
page 399)
:MTESt:SCALe:XDELta?
(see page 399)
<xdelta_value> ::= X delta value
in NR3 format
:MTESt:SCALe:Y1
<y1_value> (see
page 400)
:MTESt:SCALe:Y1? (see
page 400)
<y1_value> ::= Y1 value in NR3
format
:MTESt:SCALe:Y2
<y2_value> (see
page 401)
:MTESt:SCALe:Y2? (see
page 401)
<y2_value> ::= Y2 value in NR3
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
95
4
Commands Quick Reference
Table 16 :MTESt Commands Summary (continued)
Command
Query
Options and Query Returns
:MTESt:SOURce
<source> (see
page 402)
:MTESt:SOURce? (see
page 402)
<source> ::= {CHANnel<n> | NONE}
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
n/a
:MTESt:TITLe? (see
page 403)
<title> ::= a string of up to 128
ASCII characters
Table 17 :POD<n> Commands Summary
Command
Query
Options and Query Returns
:POD<n>:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 405)
:POD<n>:DISPlay? (see
page 405)
{0 | 1}
<n> ::= 1-2 in NR1 format
:POD<n>:SIZE <value>
(see page 406)
:POD<n>:SIZE? (see
page 406)
<value> ::= {SMALl | MEDium |
LARGe}
:POD<n>:THReshold
<type>[suffix] (see
page 407)
:POD<n>:THReshold?
(see page 407)
<n> ::= 1-2 in NR1 format
<type> ::= {CMOS | ECL | TTL |
<user defined value>}
<user defined value> ::= value in
NR3 format
[suffix] ::= {V | mV | uV }
Table 18 :RECall Commands Summary
Command
Query
Options and Query Returns
:RECall:FILename
<base_name> (see
page 410)
:RECall:FILename?
(see page 410)
<base_name> ::= quoted ASCII
string
:RECall:IMAGe[:STARt]
[<file_spec>] (see
page 411)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:RECall:MASK[:STARt]
[<file_spec>] (see
page 412)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-3; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
96
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 18 :RECall Commands Summary (continued)
Command
Query
Options and Query Returns
:RECall:PWD
<path_name> (see
page 413)
:RECall:PWD? (see
page 413)
<path_name> ::= quoted ASCII
string
:RECall:SETup[:STARt]
[<file_spec>] (see
page 414)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
Table 19 :SAVE Commands Summary
Command
Query
Options and Query Returns
:SAVE:FILename
<base_name> (see
page 417)
:SAVE:FILename? (see
page 417)
<base_name> ::= quoted ASCII
string
:SAVE:IMAGe[:STARt]
[<file_spec>] (see
page 418)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
n/a
:SAVE:IMAGe:AREA?
(see page 419)
<area> ::= {GRAT | SCR}
:SAVE:IMAGe:FACTors
{{0 | OFF} | {1 |
ON}} (see page 420)
:SAVE:IMAGe:FACTors?
(see page 420)
{0 | 1}
:SAVE:IMAGe:FORMat
<format> (see
page 421)
:SAVE:IMAGe:FORMat?
(see page 421)
<format> ::= {TIFF | {BMP |
BMP24bit} | BMP8bit | PNG | NONE}
:SAVE:IMAGe:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 422)
:SAVE:IMAGe:INKSaver?
(see page 422)
{0 | 1}
:SAVE:IMAGe:PALette
<palette> (see
page 423)
:SAVE:IMAGe:PALette?
(see page 423)
<palette> ::= {COLor | GRAYscale
| MONochrome}
:SAVE:LISTer[:STARt]
[<file_name>] (see
page 424)
n/a
<file_name> ::= quoted ASCII
string
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
97
4
Commands Quick Reference
Table 19 :SAVE Commands Summary (continued)
Command
Query
Options and Query Returns
:SAVE:MASK[:STARt]
[<file_spec>] (see
page 425)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-3; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:SAVE:PWD <path_name>
(see page 426)
:SAVE:PWD? (see
page 426)
<path_name> ::= quoted ASCII
string
:SAVE:SETup[:STARt]
[<file_spec>] (see
page 427)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:SAVE:WAVeform[:STARt
] [<file_name>] (see
page 428)
n/a
<file_name> ::= quoted ASCII
string
:SAVE:WAVeform:FORMat
<format> (see
page 429)
:SAVE:WAVeform:FORMat
? (see page 429)
<format> ::= {ALB | ASCiixy | CSV
| BINary | NONE}
:SAVE:WAVeform:LENGth
<length> (see
page 430)
:SAVE:WAVeform:LENGth
? (see page 430)
<length> ::= 100 to max. length;
an integer in NR1 format
:SAVE:WAVeform:SEGMen
ted <option> (see
page 431)
:SAVE:WAVeform:SEGMen
ted? (see page 431)
<option> ::= {ALL | CURRent}
Table 20 :SBUS Commands Summary
Command
Query
Options and Query Returns
n/a
:SBUS:CAN:COUNt:ERRor
? (see page 434)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:CAN:COUNt:OVERl
oad? (see page 435)
<frame_count> ::= integer in NR1
format
:SBUS:CAN:COUNt:RESet
(see page 436)
n/a
n/a
n/a
:SBUS:CAN:COUNt:TOTal
? (see page 437)
<frame_count> ::= integer in NR1
format
98
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 20 :SBUS Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:SBUS:CAN:COUNt:UTILi
zation? (see
page 438)
<percent> ::= floating-point in
NR3 format
:SBUS:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 439)
:SBUS:DISPlay? (see
page 439)
{0 | 1}
n/a
:SBUS:FLEXray:COUNt:N
ULL? (see page 440)
<frame_count> ::= integer in NR1
format
:SBUS:FLEXray:COUNt:R
ESet (see page 441)
n/a
n/a
n/a
:SBUS:FLEXray:COUNt:S
YNC? (see page 442)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:FLEXray:COUNt:T
OTal? (see page 443)
<frame_count> ::= integer in NR1
format
:SBUS:I2S:BASE <base>
(see page 444)
:SBUS:I2S:BASE? (see
page 444)
<base> ::= {DECimal | HEX}
:SBUS:IIC:ASIZe
<size> (see page 445)
:SBUS:IIC:ASIZe? (see
page 445)
<size> ::= {BIT7 | BIT8}
:SBUS:LIN:PARity {{0
| OFF} | {1 | ON}}
(see page 446)
:SBUS:LIN:PARity?
(see page 446)
{0 | 1}
:SBUS:M1553:BASE
<base> (see page 447)
:SBUS:M1553:BASE?
(see page 447)
<base> ::= {DECimal | HEX}
:SBUS:MODE <mode>
(see page 448)
:SBUS:MODE? (see
page 448)
<mode> ::= {CAN | FLEXray | I2S |
IIC | LIN | SPI | UART}
:SBUS:SPI:BITorder
<order> (see
page 449)
:SBUS:SPI:BITorder?
(see page 449)
<order> ::= {LSBFirst | MSBFirst}
:SBUS:SPI:WIDTh
<word_width> (see
page 450)
:SBUS:SPI:WIDTh? (see
page 450)
<word_width> ::= integer 4-16 in
NR1 format
:SBUS:UART:BASE
<base> (see page 451)
:SBUS:UART:BASE? (see
page 451)
<base> ::= {ASCii | BINary | HEX}
n/a
:SBUS:UART:COUNt:ERRo
r? (see page 452)
<frame_count> ::= integer in NR1
format
:SBUS:UART:COUNt:RESe
t (see page 453)
n/a
n/a
n/a
:SBUS:UART:COUNt:RXFR
ames? (see page 454)
<frame_count> ::= integer in NR1
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
99
4
Commands Quick Reference
Table 20 :SBUS Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:SBUS:UART:COUNt:TXFR
ames? (see page 455)
<frame_count> ::= integer in NR1
format
:SBUS:UART:FRAMing
<value> (see
page 456)
:SBUS:UART:FRAMing?
(see page 456)
<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 21 :SYSTem Commands Summary
Command
Query
Options and Query Returns
:SYSTem:DATE <date>
(see page 458)
:SYSTem:DATE? (see
page 458)
<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 459)
n/a
<string> ::= up to 254 characters
as a quoted ASCII string
n/a
:SYSTem:ERRor? (see
page 460)
<error> ::= an integer error code
<error string> ::= quoted ASCII
string.
See Error Messages (see
page 755).
:SYSTem:LOCK <value>
(see page 461)
:SYSTem:LOCK? (see
page 461)
<value> ::= {{1 | ON} | {0 |
OFF}}
:SYSTem:PRECision
<value> (see
page 462)
:SYSTem:PRECision?
(see page 462)
<value> ::= {{1 | ON} | {0 |
OFF}}
:SYSTem:PROTection:LO
CK <value> (see
page 463)
:SYSTem:PROTection:LO
CK? (see page 463)
<value> ::= {{1 | ON} | {0 |
OFF}}
100
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 21 :SYSTem Commands Summary (continued)
Command
Query
Options and Query Returns
:SYSTem:SETup
<setup_data> (see
page 464)
:SYSTem:SETup? (see
page 464)
<setup_data> ::= data in IEEE
488.2 # format.
:SYSTem:TIME <time>
(see page 466)
:SYSTem:TIME? (see
page 466)
<time> ::= hours,minutes,seconds
in NR1 format
Table 22 :TIMebase Commands Summary
Command
Query
Options and Query Returns
:TIMebase:MODE
<value> (see
page 469)
:TIMebase:MODE? (see
page 469)
<value> ::= {MAIN | WINDow | XY |
ROLL}
:TIMebase:POSition
<pos> (see page 470)
:TIMebase:POSition?
(see page 470)
<pos> ::= time from the trigger
event to the display reference
point in NR3 format
:TIMebase:RANGe
<range_value> (see
page 471)
:TIMebase:RANGe? (see
page 471)
<range_value> ::= 5 ns through
500 s in NR3 format
:TIMebase:REFClock
{{0 | OFF} | {1 |
ON}} (see page 472)
:TIMebase:REFClock?
(see page 472)
{0 | 1}
:TIMebase:REFerence
{LEFT | CENTer |
RIGHt} (see page 473)
:TIMebase:REFerence?
(see page 473)
<return_value> ::= {LEFT | CENTer
| RIGHt}
:TIMebase:SCALe
<scale_value> (see
page 474)
:TIMebase:SCALe? (see
page 474)
<scale_value> ::= scale value in
seconds in NR3 format
:TIMebase:VERNier {{0
| OFF} | {1 | ON}}
(see page 475)
:TIMebase:VERNier?
(see page 475)
{0 | 1}
:TIMebase:WINDow:POSi
tion <pos> (see
page 476)
:TIMebase:WINDow:POSi
tion? (see page 476)
<pos> ::= time from the trigger
event to the zoomed view
reference point in NR3 format
:TIMebase:WINDow:RANG
e <range_value> (see
page 477)
:TIMebase:WINDow:RANG
e? (see page 477)
<range value> ::= range value in
seconds in NR3 format for the
zoomed window
:TIMebase:WINDow:SCAL
e <scale_value> (see
page 478)
:TIMebase:WINDow:SCAL
e? (see page 478)
<scale_value> ::= scale value in
seconds in NR3 format for the
zoomed window
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
101
4
Commands Quick Reference
Table 23 General :TRIGger Commands Summary
Command
Query
Options and Query Returns
:TRIGger:HFReject {{0
| OFF} | {1 | ON}}
(see page 483)
:TRIGger:HFReject?
(see page 483)
{0 | 1}
:TRIGger:HOLDoff
<holdoff_time> (see
page 484)
:TRIGger:HOLDoff?
(see page 484)
<holdoff_time> ::= 60 ns to 10 s
in NR3 format
:TRIGger:MODE <mode>
(see page 485)
:TRIGger:MODE? (see
page 485)
<mode> ::= {EDGE | GLITch |
PATTern | CAN | DURation | I2S
|IIC | EBURst | LIN | M1553|
SEQuence | SPI | TV | UART | USB
| FLEXray}
<return_value> ::= {<mode> |
<none>}
<none> ::= query returns "NONE"
if the :TIMebase:MODE is ROLL or
XY
:TRIGger:NREJect {{0
| OFF} | {1 | ON}}
(see page 486)
:TRIGger:NREJect?
(see page 486)
{0 | 1}
:TRIGger:PATTern
<value>, <mask>
[,<edge
source>,<edge>] (see
page 487)
:TRIGger:PATTern?
(see page 488)
<value> ::= integer in NR1 format
or <string>
<mask> ::= integer in NR1 format
or <string>
<string> ::= "0xnnnnn"; n ::=
{0,..,9 | A,..,F} (# bits = #
channels)
<edge source> ::= {CHANnel<n> |
EXTernal | NONE} for DSO models
<edge source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | NONE}
for MSO models
<edge> ::= {POSitive | NEGative}
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SWEep
<sweep> (see
page 489)
:TRIGger:SWEep? (see
page 489)
<sweep> ::= {AUTO | NORMal}
102
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 24 :TRIGger:CAN Commands Summary
Command
Query
Options and Query Returns
:TRIGger:CAN:PATTern:
DATA <value>, <mask>
(see page 492)
:TRIGger:CAN:PATTern:
DATA? (see page 492)
<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
:TRIGger:CAN:PATTern:
DATA:LENGth <length>
(see page 493)
:TRIGger:CAN:PATTern:
DATA:LENGth? (see
page 493)
<length> ::= integer from 1 to 8
in NR1 format (with Option AMS)
:TRIGger:CAN:PATTern:
ID <value>, <mask>
(see page 494)
:TRIGger:CAN:PATTern:
ID? (see page 494)
<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 495)
:TRIGger:CAN:PATTern:
ID:MODE? (see
page 495)
<value> ::= {STANdard | EXTended}
(with Option AMS)
:TRIGger:CAN:SAMPlepo
int <value> (see
page 496)
:TRIGger:CAN:SAMPlepo
int? (see page 496)
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
:TRIGger:CAN:SIGNal:B
AUDrate <baudrate>
(see page 497)
:TRIGger:CAN:SIGNal:B
AUDrate? (see
page 497)
<baudrate> ::= integer from 10000
to 1000000 in 100 b/s increments
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
103
4
Commands Quick Reference
Table 24 :TRIGger:CAN Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:CAN:SOURce
<source> (see
page 498)
:TRIGger:CAN:SOURce?
(see page 498)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:CAN:TRIGger
<condition> (see
page 499)
:TRIGger:CAN:TRIGger?
(see page 500)
<condition> ::= {SOF} (without
Option AMS)
<condition> ::= {SOF | DATA |
ERRor | IDData | IDEither |
IDRemote | ALLerrors | OVERload |
ACKerror} (with Option AMS)
Table 25 :TRIGger:DURation Commands Summary
Command
Query
Options and Query Returns
:TRIGger:DURation:GRE
aterthan <greater
than time>[suffix]
(see page 502)
:TRIGger:DURation:GRE
aterthan? (see
page 502)
<greater_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:DURation:LES
Sthan <less than
time>[suffix] (see
page 503)
:TRIGger:DURation:LES
Sthan? (see page 503)
<less_than_time> ::=
floating-point number from in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:DURation:PAT
Tern <value>, <mask>
(see page 504)
:TRIGger:DURation:PAT
Tern? (see page 504)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= ""0xnnnnnn"" n ::=
{0,..,9 | A,..,F}
:TRIGger:DURation:QUA
Lifier <qualifier>
(see page 505)
:TRIGger:DURation:QUA
Lifier? (see
page 505)
<qualifier> ::= {GREaterthan |
LESSthan | INRange | OUTRange |
TIMeout}
:TRIGger:DURation:RAN
Ge
<less_than_time>[suff
ix],
<greater_than_time>[s
uffix] (see page 506)
:TRIGger:DURation:RAN
Ge? (see page 506)
<less_than_time> ::= 15 ns to
10 seconds in NR3 format
<greater_than_time> ::= 10 ns to
9.99 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
104
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 26 :TRIGger:EBURst Commands Summary
Command
Query
Options and Query Returns
:TRIGger:EBURst:COUNt
<count> (see
page 508)
:TRIGger:EBURst:COUNt
? (see page 508)
<count> ::= integer in NR1 format
:TRIGger:EBURst:IDLE
<time_value> (see
page 509)
:TRIGger:EBURst:IDLE?
(see page 509)
<time_value> ::= time in seconds
in NR3 format
:TRIGger:EBURst:SLOPe
<slope> (see
page 510)
:TRIGger:EBURst:SLOPe
? (see page 510)
<slope> ::= {NEGative | POSitive}
Table 27 :TRIGger[:EDGE] Commands Summary
Command
Query
Options and Query Returns
:TRIGger[:EDGE]:COUPl
ing {AC | DC | LF}
(see page 512)
:TRIGger[:EDGE]:COUPl
ing? (see page 512)
{AC | DC | LF}
:TRIGger[:EDGE]:LEVel
<level> [,<source>]
(see page 513)
:TRIGger[:EDGE]:LEVel
? [<source>] (see
page 513)
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers, <level>
::= ±(external range setting) in
NR3 format.
For digital channels (MSO
models), <level> ::= ±8 V.
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | EXTernal
} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger[:EDGE]:REJec
t {OFF | LF | HF}
(see page 514)
:TRIGger[:EDGE]:REJec
t? (see page 514)
{OFF | LF | HF}
:TRIGger[:EDGE]:SLOPe
<polarity> (see
page 515)
:TRIGger[:EDGE]:SLOPe
? (see page 515)
<polarity> ::= {POSitive |
NEGative | EITHer | ALTernate}
:TRIGger[:EDGE]:SOURc
e <source> (see
page 516)
:TRIGger[:EDGE]:SOURc
e? (see page 516)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
105
4
Commands Quick Reference
Table 28 :TRIGger:FLEXray Commands Summary
Command
Query
Options and Query Returns
:TRIGger:FLEXray:AUTo
setup (see page 518)
n/a
n/a
:TRIGger:FLEXray:BAUD
rate <baudrate> (see
page 519)
:TRIGger:FLEXray:BAUD
rate? (see page 519)
<baudrate> ::= {2500000 | 5000000
| 10000000}
:TRIGger:FLEXray:CHAN
nel <channel> (see
page 520)
:TRIGger:FLEXray:CHAN
nel? (see page 520)
<channel> ::= {A | B}
:TRIGger:FLEXray:ERRo
r:TYPE <error_type>
(see page 521)
:TRIGger:FLEXray:ERRo
r:TYPE? (see
page 521)
<error_type> ::= {ALL | HCRC |
FCRC}
:TRIGger:FLEXray:EVEN
t:TYPE <event> (see
page 522)
:TRIGger:FLEXray:EVEN
t:TYPE? (see
page 522)
<event> ::= {WAKeup | TSS | {FES
| DTS} | BSS}
:TRIGger:FLEXray:FRAM
e:CCBase
<cycle_count_base>
(see page 523)
:TRIGger:FLEXray:FRAM
e:CCBase? (see
page 523)
<cycle_count_base> ::= integer
from 0-63
:TRIGger:FLEXray:FRAM
e:CCRepetition
<cycle_count_repetiti
on> (see page 524)
:TRIGger:FLEXray:FRAM
e:CCRepetition? (see
page 524)
<cycle_count_repetition> ::=
{ALL | <rep #>}
<rep #> ::= integer from 2-64
:TRIGger:FLEXray:FRAM
e:ID <frame_id> (see
page 525)
:TRIGger:FLEXray:FRAM
e:ID? (see page 525)
<frame_id> ::= {ALL | <frame #>}
<frame #> ::= integer from 1-2047
:TRIGger:FLEXray:FRAM
e:TYPE <frame_type>
(see page 526)
:TRIGger:FLEXray:FRAM
e:TYPE? (see
page 526)
<frame_type> ::= {NORMal |
STARtup | NULL | SYNC | NSTArtup
| NNULl | NSYNc | ALL}
:TRIGger:FLEXray:SOUR
ce <source> (see
page 527)
:TRIGger:FLEXray:SOUR
ce? (see page 527)
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:FLEXray:TRIG
ger <condition> (see
page 528)
:TRIGger:FLEXray:TRIG
ger? (see page 528)
<condition> ::= {FRAMe | ERRor |
EVENt}
106
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 29 :TRIGger:GLITch Commands Summary
Command
Query
Options and Query Returns
:TRIGger:GLITch:GREat
erthan
<greater_than_time>[s
uffix] (see page 531)
:TRIGger:GLITch:GREat
erthan? (see
page 531)
<greater_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:LESSt
han
<less_than_time>[suff
ix] (see page 532)
:TRIGger:GLITch:LESSt
han? (see page 532)
<less_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:LEVel
<level> [<source>]
(see page 533)
:TRIGger:GLITch:LEVel
? (see page 533)
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers (DSO
models), <level> ::= ±(external
range setting) in NR3 format.
For digital channels (MSO
models), <level> ::= ±8 V.
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:GLITch:POLar
ity <polarity> (see
page 534)
:TRIGger:GLITch:POLar
ity? (see page 534)
<polarity> ::= {POSitive |
NEGative}
:TRIGger:GLITch:QUALi
fier <qualifier> (see
page 535)
:TRIGger:GLITch:QUALi
fier? (see page 535)
<qualifier> ::= {GREaterthan |
LESSthan | RANGe}
:TRIGger:GLITch:RANGe
<less_than_time>[suff
ix],
<greater_than_time>[s
uffix] (see page 536)
:TRIGger:GLITch:RANGe
? (see page 536)
<less_than_time> ::= 15 ns to
10 seconds in NR3 format
<greater_than_time> ::= 10 ns to
9.99 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:SOURc
e <source> (see
page 537)
:TRIGger:GLITch:SOURc
e? (see page 537)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
107
4
Commands Quick Reference
Table 30 :TRIGger:I2S Commands Summary
Command
Query
Options and Query Returns
:TRIGger:I2S:ALIGnmen
t <setting> (see
page 540)
:TRIGger:I2S:ALIGnmen
t? (see page 540)
<setting> ::= {I2S | LJ | RJ}
:TRIGger:I2S:AUDio
<audio_ch> (see
page 541)
:TRIGger:I2S:AUDio?
(see page 541)
<audio_ch> ::= {RIGHt | LEFT |
EITHer}
:TRIGger:I2S:CLOCk:SL
OPe <slope> (see
page 542)
:TRIGger:I2S:CLOCk:SL
OPe? (see page 542)
<slope> ::= {NEGative | POSitive}
:TRIGger:I2S:PATTern:
DATA <string> (see
page 543)
:TRIGger:I2S:PATTern:
DATA? (see page 544)
<string> ::= "n" where n ::=
32-bit integer in signed decimal
when <base> = DECimal
<string> ::= "nn...n" where n ::=
{0 | 1 | X | $} when <base> =
BINary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F | X | $}
when <base> = HEX
:TRIGger:I2S:PATTern:
FORMat <base> (see
page 545)
:TRIGger:I2S:PATTern:
FORMat? (see
page 545)
<base> ::= {BINary | HEX |
DECimal}
:TRIGger:I2S:RANGe
<upper>,<lower> (see
page 546)
:TRIGger:I2S:RANGe?
(see page 546)
<upper> ::= 32-bit integer in
signed decimal, <nondecimal>, or
<string>
<lower> ::= 32-bit integer in
signed 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:I2S:RWIDth
<receiver> (see
page 548)
:TRIGger:I2S:RWIDth?
(see page 548)
<receiver> ::= 4-32 in NR1 format
108
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 30 :TRIGger:I2S Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:I2S:SOURce:C
LOCk <source> (see
page 549)
:TRIGger:I2S:SOURce:C
LOCk? (see page 549)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:SOURce:D
ATA <source> (see
page 550)
:TRIGger:I2S:SOURce:D
ATA? (see page 550)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:SOURce:W
SELect <source> (see
page 551)
:TRIGger:I2S:SOURce:W
SELect? (see
page 551)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:TRIGger
<operator> (see
page 552)
:TRIGger:I2S:TRIGger?
(see page 552)
<operator> ::= {EQUal | NOTequal
| LESSthan | GREaterthan |
INRange | OUTRange | INCReasing |
DECReasing}
:TRIGger:I2S:TWIDth
<word_size> (see
page 554)
:TRIGger:I2S:TWIDth?
(see page 554)
<word_size> ::= 4-32 in NR1
format
:TRIGger:I2S:WSLow
<low_def> (see
page 555)
:TRIGger:I2S:WSLow?
(see page 555)
<low_def> ::= {LEFT | RIGHt}
Table 31 :TRIGger:IIC Commands Summary
Command
Query
Options and Query Returns
:TRIGger:IIC:PATTern:
ADDRess <value> (see
page 557)
:TRIGger:IIC:PATTern:
ADDRess? (see
page 557)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
:TRIGger:IIC:PATTern:
DATA <value> (see
page 558)
:TRIGger:IIC:PATTern:
DATA? (see page 558)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
:TRIGger:IIC:PATTern:
DATa2 <value> (see
page 559)
:TRIGger:IIC:PATTern:
DATa2? (see page 559)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
109
4
Commands Quick Reference
Table 31 :TRIGger:IIC Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:IIC[:SOURce]
:CLOCk <source> (see
page 560)
:TRIGger:IIC[:SOURce]
:CLOCk? (see
page 560)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:IIC[:SOURce]
:DATA <source> (see
page 561)
:TRIGger:IIC[:SOURce]
:DATA? (see page 561)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:IIC:TRIGger:
QUALifier <value>
(see page 562)
:TRIGger:IIC:TRIGger:
QUALifier? (see
page 562)
<value> ::= {EQUal | NOTequal |
LESSthan | GREaterthan}
:TRIGger:IIC:TRIGger[
:TYPE] <type> (see
page 563)
:TRIGger:IIC:TRIGger[
:TYPE]? (see
page 563)
<type> ::= {STARt | STOP | READ7
| READEprom | WRITe7 | WRITe10 |
NACKnowledge | ANACknowledge |
R7Data2 | W7Data2 | RESTart}
Table 32 :TRIGger:LIN Commands Summary
Command
Query
Options and Query Returns
:TRIGger:LIN:ID
<value> (see
page 567)
:TRIGger:LIN:ID? (see
page 567)
<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
:TRIGger:LIN:PATTern:
DATA <string> (see
page 568)
:TRIGger:LIN:PATTern:
DATA? (see page 569)
<string> ::= "n" where n ::=
32-bit integer in signed decimal
when <base> = DECimal
<string> ::= "nn...n" where n ::=
{0 | 1 | X | $} when <base> =
BINary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F | X | $}
when <base> = HEX
110
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 32 :TRIGger:LIN Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:LIN:PATTern:
DATA:LENGth <length>
(see page 570)
:TRIGger:LIN:PATTern:
DATA:LENGth? (see
page 570)
<length> ::= integer from 1 to 8
in NR1 format
:TRIGger:LIN:PATTern:
FORMat <base> (see
page 571)
:TRIGger:LIN:PATTern:
FORMat? (see
page 571)
<base> ::= {BINary | HEX |
DECimal}
:TRIGger:LIN:SAMPlepo
int <value> (see
page 572)
:TRIGger:LIN:SAMPlepo
int? (see page 572)
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
:TRIGger:LIN:SIGNal:B
AUDrate <baudrate>
(see page 573)
:TRIGger:LIN:SIGNal:B
AUDrate? (see
page 573)
<baudrate> ::= integer from 2400
to 625000 in 100 b/s increments
:TRIGger:LIN:SOURce
<source> (see
page 574)
:TRIGger:LIN:SOURce?
(see page 574)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:LIN:STANdard
<std> (see page 575)
:TRIGger:LIN:STANdard
? (see page 575)
<std> ::= {LIN13 | LIN20}
:TRIGger:LIN:SYNCbrea
k <value> (see
page 576)
:TRIGger:LIN:SYNCbrea
k? (see page 576)
<value> ::= integer = {11 | 12 |
13}
:TRIGger:LIN:TRIGger
<condition> (see
page 577)
:TRIGger:LIN:TRIGger?
(see page 577)
<condition> ::= {SYNCbreak}
(without Option AMS)
<condition> ::= {SYNCbreak | ID |
DATA} (with Option AMS)
Table 33 :TRIGger:M1553 Commands Summary
Command
Query
Options and Query Returns
:TRIGger:M1553:AUTose
tup (see page 579)
n/a
n/a
:TRIGger:M1553:PATTer
n:DATA <string> (see
page 580)
:TRIGger:M1553:PATTer
n:DATA? (see
page 580)
<string> ::= "nn...n" where n ::=
{0 | 1 | X}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
111
4
Commands Quick Reference
Table 33 :TRIGger:M1553 Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:M1553:RTA
<value> (see
page 581)
:TRIGger:M1553:RTA?
(see page 581)
<value> ::= 5-bit integer in
decimal, <nondecimal>, or
<string> from 0-31
<nondecimal> ::= #Hnn where n ::=
{0,..,9|A,..,F}
<string> ::= "0xnn" where n::=
{0,..,9|A,..,F}
:TRIGger:M1553:SOURce
:LOWer <source> (see
page 582)
:TRIGger:M1553:SOURce
:LOWer? (see
page 582)
<source> ::= {CHANnel<n>}
<n> ::= {2 | 4}
:TRIGger:M1553:SOURce
:UPPer <source> (see
page 583)
:TRIGger:M1553:SOURce
:UPPer? (see
page 583)
<source> ::= {CHANnel<n>}
<n> ::= {1 | 3}
:TRIGger:M1553:TYPE
<type> (see page 584)
:TRIGger:M1553:TYPE?
(see page 584)
<type> ::= {DSTArt | DSTOp |
CSTArt | CSTOp | RTA | PERRor |
SERRor | MERRor | RTA11}
Table 34 :TRIGger:SEQuence Commands Summary
Command
Query
Options and Query Returns
:TRIGger:SEQuence:COU
Nt <count> (see
page 586)
:TRIGger:SEQuence:COU
Nt? (see page 586)
<count> ::= integer in NR1 format
:TRIGger:SEQuence:EDG
E{1|2} <source>,
<slope> (see
page 587)
:TRIGger:SEQuence:EDG
E{1|2}? (see
page 587)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<slope> ::= {POSitive | NEGative}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= query returns
"NONE" if edge source is disabled
:TRIGger:SEQuence:FIN
D <value> (see
page 588)
:TRIGger:SEQuence:FIN
D? (see page 588)
<value> ::= {PATTern1,ENTered |
PATTern1,EXITed | EDGE1 |
PATTern1,AND,EDGE1}
:TRIGger:SEQuence:PAT
Tern{1|2} <value>,
<mask> (see page 589)
:TRIGger:SEQuence:PAT
Tern{1|2}? (see
page 589)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" n ::=
{0,..,9 | A,..,F}
112
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 34 :TRIGger:SEQuence Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:SEQuence:RES
et <value> (see
page 590)
:TRIGger:SEQuence:RES
et? (see page 590)
<value> ::= {NONE |
PATTern1,ENTered |
PATTern1,EXITed | EDGE1 |
PATTern1,AND,EDGE1 |
PATTern2,ENTered |
PATTern2,EXITed | EDGE2 | TIMer}
Values used in find and trigger
stages not available. EDGE2 not
available if EDGE2,COUNt used in
trigger stage.
:TRIGger:SEQuence:TIM
er <time_value> (see
page 591)
:TRIGger:SEQuence:TIM
er? (see page 591)
<time_value> ::= time from 10 ns
to 10 seconds in NR3 format
:TRIGger:SEQuence:TRI
Gger <value> (see
page 592)
:TRIGger:SEQuence:TRI
Gger? (see page 592)
<value> ::= {PATTern2,ENTered |
PATTern2,EXITed | EDGE2 |
PATTern2,AND,EDGE2 | EDGE2,COUNt
| EDGE2,COUNt,NREFind}
Table 35 :TRIGger:SPI Commands Summary
Command
Query
Options and Query Returns
:TRIGger:SPI:CLOCk:SL
OPe <slope> (see
page 594)
:TRIGger:SPI:CLOCk:SL
OPe? (see page 594)
<slope> ::= {NEGative | POSitive}
:TRIGger:SPI:CLOCk:TI
Meout <time_value>
(see page 595)
:TRIGger:SPI:CLOCk:TI
Meout? (see page 595)
<time_value> ::= time in seconds
in NR1 format
:TRIGger:SPI:FRAMing
<value> (see
page 596)
:TRIGger:SPI:FRAMing?
(see page 596)
<value> ::= {CHIPselect |
NOTChipselect | TIMeout}
:TRIGger:SPI:PATTern:
DATA <value>, <mask>
(see page 597)
:TRIGger:SPI:PATTern:
DATA? (see page 597)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" where n
::= {0,..,9 | A,..,F}
:TRIGger:SPI:PATTern:
WIDTh <width> (see
page 598)
:TRIGger:SPI:PATTern:
WIDTh? (see page 598)
<width> ::= integer from 4 to 32
in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
113
4
Commands Quick Reference
Table 35 :TRIGger:SPI Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:SPI:SOURce:C
LOCk <source> (see
page 599)
:TRIGger:SPI:SOURce:C
LOCk? (see page 599)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SPI:SOURce:D
ATA <source> (see
page 600)
:TRIGger:SPI:SOURce:D
ATA? (see page 600)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SPI:SOURce:F
RAMe <source> (see
page 601)
:TRIGger:SPI:SOURce:F
RAMe? (see page 601)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
Table 36 :TRIGger:TV Commands Summary
Command
Query
Options and Query Returns
:TRIGger:TV:LINE
<line number> (see
page 603)
:TRIGger:TV:LINE?
(see page 603)
<line number> ::= integer in NR1
format
:TRIGger:TV:MODE <tv
mode> (see page 604)
:TRIGger:TV:MODE?
(see page 604)
<tv mode> ::= {FIEld1 | FIEld2 |
AFIelds | ALINes | LINE |
VERTical | LFIeld1 | LFIeld2 |
LALTernate | LVERtical}
:TRIGger:TV:POLarity
<polarity> (see
page 605)
:TRIGger:TV:POLarity?
(see page 605)
<polarity> ::= {POSitive |
NEGative}
:TRIGger:TV:SOURce
<source> (see
page 606)
:TRIGger:TV:SOURce?
(see page 606)
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 integer in NR1
format
:TRIGger:TV:STANdard
<standard> (see
page 607)
:TRIGger:TV:STANdard?
(see page 607)
<standard> ::= {GENeric | NTSC |
PALM | PAL | SECam | {P480L60HZ |
P480} | {P720L60HZ | P720} |
{P1080L24HZ | P1080} | P1080L25HZ
| P1080L50HZ | P1080L60HZ |
{I1080L50HZ | I1080} |
I1080L60HZ}
114
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 37 :TRIGger:UART Commands Summary
Command
Query
Options and Query Returns
:TRIGger:UART:BASE
<base> (see page 610)
:TRIGger:UART:BASE?
(see page 610)
<base> ::= {ASCii | HEX}
:TRIGger:UART:BAUDrat
e <baudrate> (see
page 611)
:TRIGger:UART:BAUDrat
e? (see page 611)
<baudrate> ::= integer from 1200
to 3000000 in 100 b/s increments
:TRIGger:UART:BITorde
r <bitorder> (see
page 612)
:TRIGger:UART:BITorde
r? (see page 612)
<bitorder> ::= {LSBFirst |
MSBFirst}
:TRIGger:UART:BURSt
<value> (see
page 613)
:TRIGger:UART:BURSt?
(see page 613)
<value> ::= {OFF | 1 to 4096 in
NR1 format}
:TRIGger:UART:DATA
<value> (see
page 614)
:TRIGger:UART:DATA?
(see page 614)
<value> ::= 8-bit integer from
0-255 (0x00-0xff) in decimal,
<hexadecimal>, <binary>, or
<quoted_string> format
<hexadecimal> ::= #Hnn where n
::= {0,..,9 | A,..,F} for
hexadecimal
<binary> ::= #Bnn...n where n ::=
{0 | 1} for binary
<quoted_string> ::= any of the
128 valid 7-bit ASCII characters
(or standard abbreviations)
:TRIGger:UART:IDLE
<time_value> (see
page 615)
:TRIGger:UART:IDLE?
(see page 615)
<time_value> ::= time from 1 us
to 10 s in NR3 format
:TRIGger:UART:PARity
<parity> (see
page 616)
:TRIGger:UART:PARity?
(see page 616)
<parity> ::= {EVEN | ODD | NONE}
:TRIGger:UART:POLarit
y <polarity> (see
page 617)
:TRIGger:UART:POLarit
y? (see page 617)
<polarity> ::= {HIGH | LOW}
:TRIGger:UART:QUALifi
er <value> (see
page 618)
:TRIGger:UART:QUALifi
er? (see page 618)
<value> ::= {EQUal | NOTequal |
GREaterthan | LESSthan}
:TRIGger:UART:SOURce:
RX <source> (see
page 619)
:TRIGger:UART:SOURce:
RX? (see page 619)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
115
4
Commands Quick Reference
Table 37 :TRIGger:UART Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:UART:SOURce:
TX <source> (see
page 620)
:TRIGger:UART:SOURce:
TX? (see page 620)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:UART:TYPE
<value> (see
page 621)
:TRIGger:UART:TYPE?
(see page 621)
<value> ::=
RDATa | RD1
PARityerror
TDATa | TD1
:TRIGger:UART:WIDTh
<width> (see
page 622)
:TRIGger:UART:WIDTh?
(see page 622)
<width> ::= {5 | 6 | 7 | 8 | 9}
{RSTArt | RSTOp |
| RD0 | RDX |
| TSTArt | TSTOp |
| TD0 | TDX}
Table 38 :TRIGger:USB Commands Summary
Command
Query
Options and Query Returns
:TRIGger:USB:SOURce:D
MINus <source> (see
page 624)
:TRIGger:USB:SOURce:D
MINus? (see page 624)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:USB:SOURce:D
PLus <source> (see
page 625)
:TRIGger:USB:SOURce:D
PLus? (see page 625)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:USB:SPEed
<value> (see
page 626)
:TRIGger:USB:SPEed?
(see page 626)
<value> ::= {LOW | FULL}
:TRIGger:USB:TRIGger
<value> (see
page 627)
:TRIGger:USB:TRIGger?
(see page 627)
<value> ::= {SOP | EOP |
ENTersuspend | EXITsuspend |
RESet}
116
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 39 :WAVeform Commands Summary
Command
Query
Options and Query Returns
:WAVeform:BYTeorder
<value> (see
page 636)
:WAVeform:BYTeorder?
(see page 636)
<value> ::= {LSBFirst | MSBFirst}
n/a
:WAVeform:COUNt? (see
page 637)
<count> ::= an integer from 1 to
65536 in NR1 format
n/a
:WAVeform:DATA? (see
page 638)
<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
:WAVeform:FORMat
<value> (see
page 640)
:WAVeform:FORMat?
(see page 640)
<value> ::= {WORD | BYTE | ASCII}
:WAVeform:POINts
<# points> (see
page 641)
:WAVeform:POINts?
(see page 641)
<# 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}
:WAVeform:POINts:MODE
<points_mode> (see
page 643)
:WAVeform:POINts:MODE
? (see page 644)
<points_mode> ::= {NORMal |
MAXimum | RAW}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
117
4
Commands Quick Reference
Table 39 :WAVeform Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:WAVeform:PREamble?
(see page 645)
<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
1
2
3
for
for
for
for
NORMal type
PEAK detect type
AVERage type
HRESolution type
<count> ::= Average count, or 1
if PEAK detect type or NORMal; an
integer in NR1 format
n/a
:WAVeform:SEGMented:C
OUNt? (see page 648)
<count> ::= an integer from 2 to
2000 in NR1 format (with Option
SGM)
n/a
:WAVeform:SEGMented:T
TAG? (see page 649)
<time_tag> ::= in NR3 format
(with Option SGM)
:WAVeform:SOURce
<source> (see
page 650)
:WAVeform:SOURce?
(see page 650)
<source> ::= {CHANnel<n> |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> | POD{1
| 2} | BUS{1 | 2} | FUNCtion |
MATH | SBUS} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:WAVeform:SOURce:SUBS
ource <subsource>
(see page 654)
:WAVeform:SOURce:SUBS
ource? (see page 654)
<subsource> ::= {{NONE | RX} |
TX}
n/a
:WAVeform:TYPE? (see
page 655)
<return_mode> ::= {NORM | PEAK |
AVER | HRES}
:WAVeform:UNSigned
{{0 | OFF} | {1 |
ON}} (see page 656)
:WAVeform:UNSigned?
(see page 656)
{0 | 1}
:WAVeform:VIEW <view>
(see page 657)
:WAVeform:VIEW? (see
page 657)
<view> ::= {MAIN}
118
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick Reference
Table 39 :WAVeform Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:WAVeform:XINCrement?
(see page 658)
<return_value> ::= x-increment
in the current preamble in NR3
format
n/a
:WAVeform:XORigin?
(see page 659)
<return_value> ::= x-origin
value in the current preamble in
NR3 format
n/a
:WAVeform:XREFerence?
(see page 660)
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
n/a
:WAVeform:YINCrement?
(see page 661)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
n/a
:WAVeform:YORigin?
(see page 662)
<return_value> ::= y-origin in
the current preamble in NR3
format
n/a
:WAVeform:YREFerence?
(see page 663)
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
119
4
Commands Quick Reference
Syntax Elements
• "Number Format" on page 120
• "<NL> (Line Terminator)" on page 120
• "[ ] (Optional Syntax Terms)" on page 120
• "{ } (Braces)" on page 120
• "::= (Defined As)" on page 120
• "< > (Angle Brackets)" on page 121
• "... (Ellipsis)" on page 121
• "n,..,p (Value Ranges)" on page 121
• "d (Digits)" on page 121
• "Quoted ASCII String" on page 121
• "Definite- Length Block Response Data" on page 121
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".
120
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
4
Commands Quick 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)
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 6000 Series Oscilloscopes Programmer's Guide
121
4
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
122
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
5
Commands by Subsystem
Subsystem
Description
"Common (*) Commands" on page 125
Commands defined by IEEE 488.2 standard that
are common to all instruments.
"Root (:) Commands" on page 151
Control many of the basic functions of the
oscilloscope and reside at the root level of the
command tree.
":ACQuire Commands" on page 193
Set the parameters for acquiring and storing
data.
":BUS<n> Commands" on page 210
Control all oscilloscope functions associated
with the digital channels bus display.
":CALibrate Commands" on page 219
Utility commands for determining the state of
the calibration factor protection switch.
":CHANnel<n> Commands" on page 229
Control all oscilloscope functions associated
with individual analog channels or groups of
channels.
":DIGital<n> Commands" on page 249
Control all oscilloscope functions associated
with individual digital channels.
":DISPlay Commands" on page 256
Control how waveforms, graticule, and text are
displayed and written on the screen.
":EXTernal Trigger Commands" on page 266
Control the input characteristics of the external
trigger input.
":FUNCtion Commands" on page 276
Control functions in the measurement/storage
module.
":HARDcopy Commands" on page 293
Set and query the selection of hardcopy device
and formatting options.
":LISTer Commands" on page 304
Turn on/off the Lister display for decoded serial
data and get the Lister data.
":MARKer Commands" on page 307
Set and query the settings of X-axis markers
(X1 and X2 cursors) and the Y-axis markers (Y1
and Y2 cursors).

123
5
Commands by Subsystem
Command Types
Subsystem
Description
":MEASure Commands" on page 318
Select automatic measurements to be made
and control time markers.
":MTESt Commands" on page 370
Control the mask test features provided with
Option LMT.
":POD Commands" on page 404
Control all oscilloscope functions associated
with groups of digital channels.
":RECall Commands" on page 409
Recall previously saved oscilloscope setups
and traces.
":SAVE Commands" on page 415
Save oscilloscope setups and traces, screen
images, and data.
":SBUS Commands" on page 432
Control oscilloscope functions associated with
the serial decode bus.
":SYSTem Commands" on page 457
Control basic system functions of the
oscilloscope.
":TIMebase Commands" on page 467
Control all horizontal sweep functions.
":TRIGger Commands" on page 479
Control the trigger modes and parameters for
each trigger type.
":WAVeform Commands" on page 628
Provide access to waveform data.
Three types of commands are used:
• Common (*) Commands — See "Introduction to Common (*)
Commands" on page 128 for more information.
• Root Level (:) Commands — See "Introduction to Root (:) Commands"
on page 153 for more information.
• Subsystem Commands — Subsystem commands are grouped together
under a common node of the "Command Tree" on page 803, 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.
124
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Common (*) Commands
Commands defined by IEEE 488.2 standard that are common to all
instruments. See "Introduction to Common (*) Commands" on page 128.
Table 40 Common (*) Commands Summary
Command
Query
Options and Query Returns
*CLS (see page 129)
n/a
n/a
*ESE <mask> (see
page 130)
*ESE? (see page 131)
<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
n/a
*ESR? (see page 132)
<status> ::= 0 to 255; an integer
in NR1 format
n/a
*IDN? (see page 132)
AGILENT TECHNOLOGIES,<model>,
<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
n/a
*LRN? (see page 135)
<learn_string> ::= current
instrument setup as a block of
data in IEEE 488.2 # format
*OPC (see page 136)
*OPC? (see page 136)
ASCII "1" is placed in the output
queue when all pending device
operations have completed.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
125
5
Commands by Subsystem
Table 40 Common (*) Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
*OPT? (see page 137)
<return_value> ::= 0,0,<license
info>
<license info> ::= <All field>,
<reserved>, <Factory MSO>,
<Upgraded MSO>,
<Xilinx FPGA Probe>, <Memory>,
<Low Speed Serial>,
<Automotive Serial>, <reserved>,
<Secure>, <Battery>,
<Altera FPGA Probe>,
<FlexRay Serial>,
<Power Measurements>,
<RS-232/UART Serial>,
<reserved>, <Segmented Memory>,
<Mask Test>, <reserved>,
<reserved>, <FlexRay
Conformance>, <reserved>,
<reserved>, <I2S Serial>,
<FlexRay Trigger/Decode>,
<reserved>, <reserved>, <MIL-STD
1553 Trigger/Decode>, <reserved>
<All field> ::= {0 | All}
<reserved> ::= 0
<Factory MSO> ::= {0 | MSO}
<Upgraded MSO> ::= {0 | MSO}
<Xilinx FPGA Probe> ::= {0 | FPG}
<Memory> ::= {0 | mem2M | mem8M}
<Low Speed Serial> ::= {0 | LSS}
<Automotive Serial> ::= {0 | AMS}
<Secure> ::= {0 | SEC}
<Battery> ::= {0 | BAT}
<Altera FPGA Probe> ::= {0 | ALT}
<FlexRay Serial> ::= {0 | FRS}
<Power Measurements> ::= {0 |
PWR}
<RS-232/UART Serial> ::= {0 |
232}
<Segmented Memory> ::= {0 | SGM}
<Mask Test> ::= {0 | LMT}
<FlexRay Conformance> ::= {0 |
FRC}
<I2S Serial> ::= {0 | SND}
<FlexRay Trigger/Decode> ::= {0 |
FLX}
<MIL-STD 1553 Trigger/Decode>
::= {0 | 553}
126
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 40 Common (*) Commands Summary (continued)
Command
Query
Options and Query Returns
*RCL <value> (see
page 139)
n/a
<value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*RST (see page 140)
n/a
See *RST (Reset) (see page 140)
*SAV <value> (see
page 143)
n/a
<value> ::= {0 | 1 | 2 | 3 | 4 |
5 | 6 | 7 | 8 | 9}
*SRE <mask> (see
page 144)
*SRE? (see page 145)
<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
n/a
*STB? (see page 146)
<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 148)
n/a
n/a
n/a
*TST? (see page 149)
<result> ::= 0 or non-zero value;
an integer in NR1 format
*WAI (see page 150)
n/a
n/a
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
127
5
Commands by Subsystem
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.
NOTE
128
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.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
*CLS (Clear Status)
(see page 798)
Command Syntax
*CLS
The *CLS common command clears the status data structures, the
device- defined error queue, and the Request- for- OPC flag.
NOTE
See Also
If the *CLS command immediately follows a program message terminator, the output queue
and the MAV (message available) bit are cleared.
• "Introduction to Common (*) Commands" on page 128
• "*STB (Read Status Byte)" on page 146
• "*ESE (Standard Event Status Enable)" on page 130
• "*ESR (Standard Event Status Register)" on page 132
• "*SRE (Service Request Enable)" on page 144
• ":SYSTem:ERRor" on page 460
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
129
5
Commands by Subsystem
*ESE (Standard Event Status Enable)
(see page 798)
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.
OR
PON
URQ
CME
EXE
DDE
QYE
RQL
OPC
7
6
5
4
3
2
1
0
*ESR?
Standard Event
Status Register
*ESE
*ESE?
Standard Event
Status Enable
(Mask) Register
+
To ESB bit in
Status Byte
Register
Table 41 Standard Event Status Enable (ESE)
130
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.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 41 Standard Event Status Enable (ESE) (continued)
Query Syntax
Bit
Name
Description
When Set (1 = High = True), Enables:
1
RQL
Request Control
Event when the device is requesting control. (Not
used.)
0
OPC
Operation Complete
Event when an operation is complete.
*ESE?
The *ESE? query returns the current contents of the Standard Event
Status Enable Register.
Return Format
<mask_argument><NL>
<mask_argument> ::= 0,..,255; an integer in NR1 format.
See Also
• "Introduction to Common (*) Commands" on page 128
• "*ESR (Standard Event Status Register)" on page 132
• "*OPC (Operation Complete)" on page 136
• "*CLS (Clear Status)" on page 129
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
131
5
Commands by Subsystem
*ESR (Standard Event Status Register)
(see page 798)
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.
OR
PON
URQ
CME
EXE
DDE
QYE
RQL
OPC
7
6
5
4
3
2
1
0
*ESR?
Standard Event
Status Register
*ESE
*ESE?
Standard Event
Status Enable
(Mask) Register
+
To ESB bit in
Status Byte
Register
Table 42 Standard Event Status Register (ESR)
132
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.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Table 42 Standard Event Status Register (ESR) (continued)
Return Format
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.
<status><NL>
<status> ::= 0,..,255; an integer in NR1 format.
NOTE
See Also
Reading the Standard Event Status Register clears it. High or 1 indicates the bit is true.
• "Introduction to Common (*) Commands" on page 128
• "*ESE (Standard Event Status Enable)" on page 130
• "*OPC (Operation Complete)" on page 136
• "*CLS (Clear Status)" on page 129
• ":SYSTem:ERRor" on page 460
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
133
5
Commands by Subsystem
*IDN (Identification Number)
(see page 798)
Query Syntax
*IDN?
The *IDN? query identifies the instrument type and software version.
Return Format
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
See Also
• "Introduction to Common (*) Commands" on page 128
• "*OPT (Option Identification)" on page 137
134
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
*LRN (Learn Device Setup)
(see page 798)
Query Syntax
*LRN?
The *LRN? query result contains the current state of the instrument. This
query is similar to the :SYSTem:SETup? (see page 464) 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.
Return Format
<learn_string><NL>
<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.
NOTE
See Also
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.
• "Introduction to Common (*) Commands" on page 128
• "*RCL (Recall)" on page 139
• "*SAV (Save)" on page 143
• ":SYSTem:SETup" on page 464
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
135
5
Commands by Subsystem
*OPC (Operation Complete)
(see page 798)
Command Syntax
*OPC
The *OPC command sets the operation complete bit in the Standard Event
Status Register when all pending device operations have finished.
Query Syntax
*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.
Return Format
<complete><NL>
<complete> ::= 1
See Also
• "Introduction to Common (*) Commands" on page 128
• "*ESE (Standard Event Status Enable)" on page 130
• "*ESR (Standard Event Status Register)" on page 132
• "*CLS (Clear Status)" on page 129
136
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
*OPT (Option Identification)
(see page 798)
Query Syntax
*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.
Return Format
0,0,<license info>
<license info> ::= <All field>,<reserved>,<Factory MSO>,<Upgraded MSO>,
<Xilinx FPGA Probe>,<Memory>,<Low Speed Serial>,
<Automotive Serial>,<reserved>,<Secure>,<Battery>,
<Altera FPGA Probe>,<FlexRay Serial>,
<Power Measurements>,<RS-232/UART Serial>,<reserved>,
<Segmented Memory>,<Mask Test>,<reserved>,<reserved>,
<FlexRay Conformance>,<reserved>,<reserved>,
<I2S Serial>,<FlexRay Trigger/Decode>,<reserved>,
<reserved>,<MIL-STD 1553 Trigger/Decode>,<reserved>
<All field> ::= {0 | All}
<reserved> ::= 0
<Factory MSO> ::= {0 | MSO}
<Upgraded MSO> ::= {0 | MSO}
<Xilinx FPGA Probe> ::= {0 | FPG}
<Memory> ::= {0 | mem2M | mem8M}
<Low Speed Serial> ::= {0 | LSS}
<Automotive Serial> ::= {0 | AMS}
<Secure> ::= {0 | SEC}
<Battery> ::= {0 | BAT}
<Altera FPGA Probe> ::= {0 | ALT}
<FlexRay Serial> ::= {0 | FRS}
<Power Measurements> ::= {0 | PWR}
<RS-232/UART Serial> ::= {0 | 232}
<Segmented Memory> ::= {0 | SGM}
<Mask Test> ::= {0 | LMT}
<FlexRay Conformance> ::= {0 | FRC}
<I2S Serial> ::= {0 | SND}
<FlexRay Trigger/Decode> ::= {0 | FLX}
<MIL-STD 1553 Trigger/Decode> ::= {0 | 553}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
137
5
Commands by Subsystem
The <Factory MSO> <Upgraded MSO> fields indicate whether the unit is a
mixed-signal oscilloscope and, if so, whether it was factory installed
or upgraded from an analog channels only oscilloscope (DSO).
The *OPT? query returns the following:
See Also
Module
Module Id
No modules attached
0,0,0,0,MSO,0,0,mem8M,0,0,0,0,0,0,0,0,0,0,0,0,0
,0,0,0,0,0,0
• "Introduction to Common (*) Commands" on page 128
• "*IDN (Identification Number)" on page 134
138
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
*RCL (Recall)
(see page 798)
Command Syntax
*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.
See Also
• "Introduction to Common (*) Commands" on page 128
• "*SAV (Save)" on page 143
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
139
5
Commands by Subsystem
*RST (Reset)
(see page 798)
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
140
Channel 1
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Digital Channel Menu (MSO models only)
Channel 0 - 15
Off
Labels
Off
Threshold
TTL (1.4V)
Display Menu
Definite persistence
Off
Grid
33%
Vectors
On
Quick Meas Menu
Source
Channel 1
Run Control
Scope is running
Time Base Menu
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
Type
Edge
Mode
Auto
Coupling
dc
Source
Channel 1
Level
0.0 V
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
141
5
Commands by Subsystem
Trigger Menu
See Also
Example Code
Slope
Positive
HF Reject and noise reject
Off
Holdoff
60 ns
External probe attenuation
AutoProbe (if AutoProbe is connected),
otherwise 1.0:1
External Units
Volts
External Impedance
1 M Ohm
• "Introduction to Common (*) Commands" on page 128
' 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 824
142
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
*SAV (Save)
(see page 798)
Command Syntax
*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.
See Also
• "Introduction to Common (*) Commands" on page 128
• "*RCL (Recall)" on page 139
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
143
5
Commands by Subsystem
*SRE (Service Request Enable)
(see page 798)
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.
From
Operation
Status
Registers
From
Standard
Event
Status
Registers
TRG
Reg
TER?
Trigger Event Register
*STB?
Status Byte Register
*SRE
*SRE?
Service Request Enable
(Mask) Register
Output
Queue
RQS/
OPER MSS ESB MAV
7
OR
6
5
4
MSG USR TRG
3
2
1
0
+
SRQ
Service Request
Table 43 Service Request Enable Register (SRE)
144
Bit
Name
Description
When Set (1 = High = True), Enables:
7
OPER
Operation Status Register
Interrupts when enabled conditions in the
Operation Status Register (OPER) occur.
6
---
---
(Not used.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Table 43 Service Request Enable Register (SRE) (continued)
Query Syntax
Bit
Name
Description
When Set (1 = High = True), Enables:
5
ESB
Event Status Bit
Interrupts when enabled conditions in the
Standard Event Status Register (ESR) occur.
4
MAV
Message Available
Interrupts when messages are in the Output
Queue.
3
---
---
(Not used.)
2
MSG
Message
Interrupts when an advisory has been displayed
on the oscilloscope.
1
USR
User Event
Interrupts when enabled user event conditions
occur.
0
TRG
Trigger
Interrupts when a trigger occurs.
*SRE?
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 128
• "*STB (Read Status Byte)" on page 146
• "*CLS (Clear Status)" on page 129
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
145
5
Commands by Subsystem
*STB (Read Status Byte)
(see page 798)
Query Syntax
*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.
Return Format
<value><NL>
<value> ::= 0,..,255; an integer in NR1 format
From
Operation
Status
Registers
From
Standard
Event
Status
Registers
TRG
Reg
TER?
Trigger Event Register
*STB?
Status Byte Register
*SRE
*SRE?
Service Request Enable
(Mask) Register
Output
Queue
RQS/
OPER MSS ESB MAV
7
OR
6
5
4
MSG USR TRG
3
2
1
0
+
SRQ
Service Request
Table 44 Status Byte Register (STB)
146
Bit
Name
Description
When Set (1 = High = True), Indicates:
7
OPER
Operation Status Register
An enabled condition in the Operation Status
Register (OPER) has occurred.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 44 Status Byte Register (STB) (continued)
NOTE
See Also
Bit
Name
Description
When Set (1 = High = True), Indicates:
6
RQS
Request Service
When polled, that the device is requesting service.
MSS
Master Summary Status
When read (by *STB?), whether the device has a
reason for requesting service.
5
ESB
Event Status Bit
An enabled condition in the Standard Event Status
Register (ESR) has occurred.
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
oscilloscope.
1
USR
User Event
An enabled user event condition has occurred.
0
TRG
Trigger
A trigger has occurred.
To read the instrument's status byte with RQS reported on bit 6, use the interface Serial
Poll.
• "Introduction to Common (*) Commands" on page 128
• "*SRE (Service Request Enable)" on page 144
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
147
5
Commands by Subsystem
*TRG (Trigger)
(see page 798)
Command Syntax
*TRG
The *TRG command has the same effect as the :DIGitize command with no
parameters.
See Also
• "Introduction to Common (*) Commands" on page 128
• ":DIGitize" on page 162
• ":RUN" on page 186
• ":STOP" on page 190
148
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
*TST (Self Test)
(see page 798)
Query Syntax
*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.
Return Format
<result><NL>
<result> ::= 0 or non-zero value; an integer in NR1 format
See Also
• "Introduction to Common (*) Commands" on page 128
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
149
5
Commands by Subsystem
*WAI (Wait To Continue)
(see page 798)
Command Syntax
*WAI
The *WAI command has no function in the oscilloscope, but is parsed for
compatibility with other instruments.
See Also
150
• "Introduction to Common (*) Commands" on page 128
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
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 153.
Table 45 Root (:) Commands Summary
Command
Query
Options and Query Returns
:ACTivity (see
page 154)
:ACTivity? (see
page 154)
<return value> ::=
<edges>,<levels>
<edges> ::= presence of edges
(32-bit integer in NR1 format)
<levels> ::= logical highs or
lows (32-bit integer in NR1
format)
n/a
:AER? (see page 155)
{0 | 1}; an integer in NR1 format
:AUToscale
[<source>[,..,<source
>]] (see page 156)
n/a
<source> ::= CHANnel<n> for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD1 |
POD2} for MSO models
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
:AUToscale:AMODE
<value> (see
page 158)
:AUToscale:AMODE?
(see page 158)
<value> ::= {NORMal | CURRent}}
:AUToscale:CHANnels
<value> (see
page 159)
:AUToscale:CHANnels?
(see page 159)
<value> ::= {ALL | DISPlayed}}
:BLANk [<source>]
(see page 160)
n/a
<source> ::= {CHANnel<n>} |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:CDISplay (see
page 161)
n/a
n/a
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
151
5
Commands by Subsystem
Table 45 Root (:) Commands Summary (continued)
Command
Query
Options and Query Returns
:DIGitize
[<source>[,..,<source
>]] (see page 162)
n/a
<source> ::= {CHANnel<n> |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS} for MSO models
<source> can be repeated up to 5
times
<n> ::= 1-2 or 1-4 in NR1 format
:HWEenable <n> (see
page 164)
:HWEenable? (see
page 164)
<n> ::= 16-bit integer in NR1
format
n/a
:HWERregister:CONDiti
on? (see page 166)
<n> ::= 16-bit integer in NR1
format
n/a
:HWERegister[:EVENt]?
(see page 168)
<n> ::= 16-bit integer in NR1
format
:MERGe <pixel memory>
(see page 170)
n/a
<pixel memory> ::= {PMEMory{0 | 1
| 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}}
:MTEenable <n> (see
page 171)
:MTEenable? (see
page 171)
<n> ::= 16-bit integer in NR1
format
n/a
:MTERegister[:EVENt]?
(see page 173)
<n> ::= 16-bit integer in NR1
format
:OPEE <n> (see
page 175)
:OPEE? (see page 176)
<n> ::= 16-bit integer in NR1
format
n/a
:OPERregister:CONDiti
on? (see page 177)
<n> ::= 16-bit integer in NR1
format
n/a
:OPERegister[:EVENt]?
(see page 179)
<n> ::= 16-bit integer in NR1
format
:OVLenable <mask>
(see page 181)
:OVLenable? (see
page 182)
<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
152
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 45 Root (:) Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:OVLRegister? (see
page 183)
<value> ::= integer in NR1
format. See OVLenable for <value>
:PRINt [<options>]
(see page 185)
n/a
<options> ::= [<print
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 186)
n/a
n/a
n/a
:SERial (see
page 187)
<return value> ::= unquoted
string containing serial number
:SINGle (see
page 188)
n/a
n/a
n/a
:STATus? <display>
(see page 189)
{0 | 1}
<display> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH
| SBUS}
<n> ::= 1-2 or 1-4 in NR1 format
:STOP (see page 190)
n/a
n/a
n/a
:TER? (see page 191)
{0 | 1}
:VIEW <source> (see
page 192)
n/a
<source> ::= {CHANnel<n> |
PMEMory{0 | 1 | 2 | 3 | 4 | 5 | 6
| 7 | 8 | 9} | FUNCtion | MATH |
SBUS} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
PMEMory{0 | 1 | 2 | 3 | 4 | 5 | 6
| 7 | 8 | 9} | POD{1 | 2} | BUS{1
| 2} | FUNCtion | MATH | SBUS}
for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
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.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
153
5
Commands by Subsystem
:ACTivity
(see page 798)
Command Syntax
:ACTivity
The :ACTivity command clears the cumulative edge variables for the next
activity query.
Query Syntax
:ACTivity?
The :ACTivity? query returns whether there has been activity (edges) on
the digital channels since the last query, and returns the current logic
levels.
NOTE
Return Format
Because the :ACTivity? query returns edge activity since the last :ACTivity? query, you must
send this query twice before the edge activity result is valid.
<edges>,<levels><NL>
<edges> ::= presence of edges (16-bit integer in NR1 format).
<levels> ::= logical highs or lows (16-bit integer in NR1 format).
bit 0 ::= DIGital 0
bit 15 ::= DIGital 15
NOTE
A bit = 0 (zero) in the <edges> result indicates that no edges were detected on that channel
(across the specified threshold voltage) since the last query.
A bit = 1 (one) in the <edges> result indicates that edges have been detected on that
channel (across the specified threshold voltage) since the last query.
(The threshold voltage must be set appropriately for the logic levels of the signals being
probed.)
See Also
• "Introduction to Root (:) Commands" on page 153
• ":POD<n>:THReshold" on page 407
• ":DIGital<n>:THReshold" on page 255
154
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:AER (Arm Event Register)
(see page 798)
Query Syntax
: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).
Return Format
<value><NL>
<value> ::= {0 | 1}; an integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
155
5
Commands by Subsystem
:AUToscale
(see page 798)
Command Syntax
:AUToscale
:AUToscale [<source>[,..,<source>]]
<source> ::= CHANnel<n> for the DSO models
<source> ::= {DIGital0,..,DIGital15 | POD1 | POD2 | CHANnel<n>} for the
MSO models
<n> ::= {1 | 2 | 3 | 4} for the four 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 159) 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, then the digital channels 0- 15.
• 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.
• Zoomed (delayed) time base mode.
For further information on :AUToscale, see the User's Guide.
156
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AUToscale:CHANnels" on page 159
• ":AUToscale:AMODE" on page 158
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 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
157
5
Commands by Subsystem
:AUToscale:AMODE
(see page 798)
Command Syntax
: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.
Query Syntax
:AUToscale:AMODE?
The :AUToscale:AMODE? query returns the autoscale acquire mode setting.
Return Format
<value><NL>
<value> ::= {NORM | CURR}
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AUToscale" on page 156
• ":AUToscale:CHANnels" on page 159
• ":ACQuire:TYPE" on page 208
• ":ACQuire:MODE" on page 199
158
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:AUToscale:CHANnels
(see page 798)
Command Syntax
: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.
Query Syntax
:AUToscale:CHANnels?
The :AUToscale:CHANnels? query returns the autoscale channels setting.
Return Format
<value><NL>
<value> ::= {ALL | DISP}
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AUToscale" on page 156
• ":AUToscale:AMODE" on page 158
• ":VIEW" on page 192
• ":BLANk" on page 160
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
159
5
Commands by Subsystem
:BLANk
(see page 798)
Command Syntax
:BLANk [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | POD{1 | 2}
| BUS{1 | 2} | FUNCtion | MATH | SBUS} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :BLANk command turns off (stops displaying) the specified channel,
digital pod, math function, or serial decode bus. The :BLANk command
with no parameter turns off all sources.
NOTE
To turn on (start displaying) a channel, etc., use the :VIEW command. The DISPlay
commands, :CHANnel<n>:DISPlay, :FUNCtion:DISPlay, :POD<n>:DISPlay, or
:DIGital<n>:DISPlay, are the preferred method to turn on/off a channel, etc.
NOTE
MATH is an alias for FUNCtion.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CDISplay" on page 161
• ":CHANnel<n>:DISPlay" on page 234
• ":DIGital<n>:DISPlay" on page 251
• ":FUNCtion:DISPlay" on page 280
• ":POD<n>:DISPlay" on page 405
• ":STATus" on page 189
• ":VIEW" on page 192
Example Code
160
• "Example Code" on page 192
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CDISplay
(see page 798)
Command Syntax
: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.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":DISPlay:CLEar" on page 258
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
161
5
Commands by Subsystem
:DIGitize
(see page 798)
Command Syntax
:DIGitize [<source>[,..,<source>]]
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | POD{1 | 2}
| BUS{1 | 2} | FUNCtion | MATH | SBUS} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four 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.
NOTE
To halt a :DIGitize in progress, use the device clear command.
NOTE
MATH is an alias for FUNCtion.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":RUN" on page 186
• ":SINGle" on page 188
• ":STOP" on page 190
• ":ACQuire Commands" on page 193
• ":WAVeform Commands" on page 628
Example Code
162
'
'
'
'
'
'
'
'
'
'
'
'
'
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
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
' 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;
' 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 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
163
5
Commands by Subsystem
:HWEenable (Hardware Event Enable Register)
(see page 798)
Command Syntax
: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.
PLL
Locked
15
14
13
Bat
ON
12
0
PLL
Locked
Bat
ON
12
11
10
9
8
7
6
5
4
3
2
1
:HWERegister:CONDition?
Hardware Event Condition Register
:HWERegister[:EVENt]?
Hardware Event Event Register
0
:HWEenable
:HWEenable?
Hardware Event Enable (Mask) Register
OR
+
To HWE bit in
Operation Status
Condition Register
Table 46 Hardware Event Enable Register (HWEenable)
Query Syntax
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-1
---
---
(Not used.)
0
Bat On
Battery On
Event when the battery is on.
: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.
164
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AER (Arm Event Register)" on page 155
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
165
5
Commands by Subsystem
:HWERegister:CONDition (Hardware Event Condition Register)
(see page 798)
Query Syntax
:HWERegister:CONDition?
The :HWERegister:CONDition? query returns the integer value contained in
the Hardware Event Condition Register.
15
14
13
PLL
Locked
Bat
ON
12
0
PLL
Locked
Bat
ON
12
11
10
9
8
7
6
5
4
3
2
1
:HWERegister:CONDition?
Hardware Event Condition Register
:HWERegister[:EVENt]?
Hardware Event Event Register
0
:HWEenable
:HWEenable?
Hardware Event Enable (Mask) Register
OR
+
To HWE bit in
Operation Status
Condition Register
Table 47 Hardware Event Condition Register
Return Format
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-1
---
---
(Not used.)
0
Bat On
Battery On
The battery is on.
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
166
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
167
5
Commands by Subsystem
:HWERegister[:EVENt] (Hardware Event Event Register)
(see page 798)
Query Syntax
:HWERegister[:EVENt]?
The :HWERegister[:EVENt]? query returns the integer value contained in
the Hardware Event Event Register.
15
14
13
PLL
Locked
Bat
ON
12
0
PLL
Locked
Bat
ON
12
11
10
9
8
7
6
5
4
3
2
1
:HWERegister:CONDition?
Hardware Event Condition Register
:HWERegister[:EVENt]?
Hardware Event Event Register
0
:HWEenable
:HWEenable?
Hardware Event Enable (Mask) Register
OR
+
To HWE bit in
Operation Status
Condition Register
Table 48 Hardware Event Event Register
Return Format
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-1
---
---
(Not used.)
0
Bat On
Battery On
The battery is on.
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
168
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
169
5
Commands by Subsystem
:MERGe
(see page 798)
Command Syntax
:MERGe <pixel memory>
<pixel memory> ::= {PMEMory0 | PMEMory1 | PMEMory2 | PMEMory3
| PMEMory4 | PMEMory5 | PMEMory6 | PMEMory7
| PMEMory8 | PMEMory9}
The :MERGe command stores the contents of the active display in the
specified pixel memory. The previous contents of the pixel memory are
overwritten. The pixel memories are PMEMory0 through PMEMory9. This
command is similar to the function of the "Save To: INTERN_<n>" key in
the Save/Recall menu.
See Also
• "Introduction to Root (:) Commands" on page 153
• "*SAV (Save)" on page 143
• "*RCL (Recall)" on page 139
• ":VIEW" on page 192
• ":BLANk" on page 160
170
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTEenable (Mask Test Event Enable Register)
(see page 798)
Command Syntax
:MTEenable <mask>
<mask> ::= 16-bit integer
The :MTEenable command sets a mask in the Mask Test Event Enable
register. Set any of the following bits to "1" to enable bit 9 in the
Operation Status Condition Register and potentially cause an SRQ (Service
Request interrupt to be generated.
Auto
Mask
15
14
13
12
11
10
Started
9
8
7
6
5
4
3
Fail
Complete
1
0
2
:MTERegister[:EVENt]?
Mask Test Event Event Register
:MTEenable
:MTEenable?
Mask Test Event Enable (Mask) Register
OR
+
To MTE bit in
Operation Status
Condition Register
Table 49 Mask Test Event Enable Register (MTEenable)
Query Syntax
Bit
Name
Description
When Set (1 = High = True), Enables:
15-11
---
---
(Not used.)
10
Auto
Mask
Auto Mask Created
Auto mask creation completed.
9
---
---
(Not used.)
8
Started
Mask Testing Started
Mask testing started.
7-2
---
---
(Not used.)
1
Fail
Mask Test Fail
Mask test failed.
0
Comple
te
Mask Test Complete
Mask test is complete.
:MTEenable?
The :MTEenable? query returns the current value contained in the Mask
Test Event Enable register as an integer number.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
171
5
Commands by Subsystem
Return Format
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AER (Arm Event Register)" on page 155
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
172
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTERegister[:EVENt] (Mask Test Event Event Register)
(see page 798)
Query Syntax
:MTERegister[:EVENt]?
The :MTERegister[:EVENt]? query returns the integer value contained in
the Mask Test Event Event Register and clears the register.
Auto
Mask
15
14
13
12
11
10
Started
9
8
7
6
5
4
3
Fail
Complete
1
0
2
:MTERegister[:EVENt]?
Mask Test Event Event Register
:MTEenable
:MTEenable?
Mask Test Event Enable (Mask) Register
OR
+
To MTE bit in
Operation Status
Condition Register
Table 50 Mask Test Event Event Register
Return Format
Bit
Name
Description
When Set (1 = High = True), Indicates:
15-11
---
---
(Not used.)
10
Auto
Mask
Auto Mask Created
Auto mask creation completed.
9
---
---
(Not used.)
8
Started
Mask Testing Started
Mask testing started.
7-2
---
---
(Not used.)
1
Fail
Mask Test Fail
The mask test failed.
0
Comple
te
Mask Test Complete
The mask test is complete.
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
173
5
Commands by Subsystem
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
174
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:OPEE (Operation Status Enable Register)
(see page 798)
Command Syntax
:OPEE <mask>
<mask> ::= 16-bit integer
The :OPEE command sets a mask in the Operation Status Enable register.
Set any of the following bits to "1" to enable bit 7 in the Status Byte
Register and potentially cause an SRQ (Service Request interrupt to be
generated.
From Hardware
Event Registers
From Mask Test
Event Registers
From Overload
Event Registers
Arm
Reg
AER?
Run bit set if oscilloscope not stopped
HWE OVLR
MTE
Wait
Trig
Run
11
9
5
3
HWE OVLR
MTE
Wait
Trig
Run
12
15
14
13
12
11
10
9
8
7
6
5
4
3
:OPEReration:CONDition?
Operation Status Condition Register
:OPERation[:EVENt]?
Operation Status Event Register
2
1
0
:OPEE
:OPEE?
Operation Status Enable
(Mask) Register
OR
+
To OPER bit in
Status Byte
Register
Table 51 Operation Status Enable Register (OPEE)
Bit
Name
Description
When Set (1 = High = True), Enables:
15-13
---
---
(Not used.)
12
HWE
Hardware Event
Event when hardware event occurs.
11
OVLR
Overload
Event when 50Ω input overload occurs.
10
---
---
(Not used.)
9
MTE
Mask Test Event
Event when mask test event occurs.
8-6
---
---
(Not used.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
175
5
Commands by Subsystem
Table 51 Operation Status Enable Register (OPEE) (continued)
Query Syntax
Bit
Name
Description
When Set (1 = High = True), Enables:
5
Wait
Trig
Wait Trig
Event when the trigger is armed.
4
---
---
(Not used.)
3
Run
Running
Event when the oscilloscope is running (not
stopped).
2-0
---
---
(Not used.)
:OPEE?
The :OPEE? query returns the current value contained in the Operation
Status Enable register as an integer number.
Return Format
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":AER (Arm Event Register)" on page 155
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
176
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:OPERegister:CONDition (Operation Status Condition Register)
(see page 798)
Query Syntax
:OPERegister:CONDition?
The :OPERegister:CONDition? query returns the integer value contained in
the Operation Status Condition Register.
From Hardware
Event Registers
From Mask Test
Event Registers
From Overload
Event Registers
Arm
Reg
AER?
Run bit set if oscilloscope not stopped
13
9
5
3
MTE
Wait
Trig
Run
11
HWE OVLR
14
Run
MTE
12
15
Wait
Trig
HWE OVLR
12
11
10
9
8
7
6
5
4
3
:OPEReration:CONDition?
Operation Status Condition Register
:OPERation[:EVENt]?
Operation Status Event Register
2
1
0
:OPEE
:OPEE?
Operation Status Enable
(Mask) Register
OR
+
To OPER bit in
Status Byte
Register
Table 52 Operation Status Condition Register
Bit
Name
Description
When Set (1 = High = True), Indicates:
15-13
---
---
(Not used.)
12
HWE
Hardware Event
A hardware event has occurred..
11
OVLR
Overload
A 50Ω input overload has occurred.
10
---
---
(Not used.)
9
MTE
Mask Test Event
A mask test event has occurred.
8-6
---
---
(Not used.)
5
Wait
Trig
Wait Trig
The trigger is armed (set by the Trigger Armed
Event Register (TER)).
4
---
---
(Not used.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
177
5
Commands by Subsystem
Table 52 Operation Status Condition Register (continued)
Return Format
Bit
Name
Description
When Set (1 = High = True), Indicates:
3
Run
Running
The oscilloscope is running (not stopped).
2-0
---
---
(Not used.)
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
• ":HWERegister[:EVENt] (Hardware Event Event Register)" on page 168
• ":HWEenable (Hardware Event Enable Register)" on page 164
• ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 173
• ":MTEenable (Mask Test Event Enable Register)" on page 171
178
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:OPERegister[:EVENt] (Operation Status Event Register)
(see page 798)
Query Syntax
:OPERegister[:EVENt]?
The :OPERegister[:EVENt]? query returns the integer value contained in
the Operation Status Event Register.
From Hardware
Event Registers
From Mask Test
Event Registers
From Overload
Event Registers
Arm
Reg
AER?
Run bit set if oscilloscope not stopped
13
9
5
3
MTE
Wait
Trig
Run
11
HWE OVLR
14
Run
MTE
12
15
Wait
Trig
HWE OVLR
12
11
10
9
8
7
6
5
4
3
:OPEReration:CONDition?
Operation Status Condition Register
:OPERation[:EVENt]?
Operation Status Event Register
2
1
0
:OPEE
:OPEE?
Operation Status Enable
(Mask) Register
OR
+
To OPER bit in
Status Byte
Register
Table 53 Operation Status Event Register
Bit
Name
Description
When Set (1 = High = True), Indicates:
15-13
---
---
(Not used.)
12
HWE
Hardware Event
A hardware event has occurred.
11
OVLR
Overload
A 50Ω input overload has occurred.
10
---
---
(Not used.)
9
MTE
Mask Test Event
A mask test event has occurred.
8-6
---
---
(Not used.)
5
Wait
Trig
Wait Trig
The trigger is armed (set by the Trigger Armed
Event Register (TER)).
4
---
---
(Not used.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
179
5
Commands by Subsystem
Table 53 Operation Status Event Register (continued)
Return Format
Bit
Name
Description
When Set (1 = High = True), Indicates:
3
Run
Running
The oscilloscope has gone from a stop state to
a single or running state.
2-0
---
---
(Not used.)
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
• ":HWERegister[:EVENt] (Hardware Event Event Register)" on page 168
• ":HWEenable (Hardware Event Enable Register)" on page 164
• ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 173
• ":MTEenable (Mask Test Event Enable Register)" on page 171
180
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:OVLenable (Overload Event Enable Register)
(see page 798)
Command Syntax
:OVLenable <enable_mask>
<enable_mask> ::= 16-bit integer
The overload enable mask is an integer representing an input as described
in the following table.
The :OVLenable command sets the mask in the Overload Event Enable
Register and enables the reporting of the Overload Event Register. If an
overvoltage is sensed on a 50Ω input, the input will automatically switch
to 1 MΩ input impedance. If enabled, such an event will set bit 11 in the
Operation Status Register.
You can set analog channel input impedance to 50Ω on the 300 MHz, 500 MHz, and 1 GHz
bandwidth oscilloscope models. On these same bandwidth models, if there are only two
analog channels, you can also set external trigger input impedance to 50Ω.
NOTE
Ext Trig Chan4 Chan3 Chan2 Chan1
Fault Fault Fault Fault Fault
15
14
13
12
11
10
9
8
7
6
Ext Trig Chan4 Chan3 Chan2 Chan1
OVL OVL OVL OVL OVL
5
4
3
2
1
:OVLR?
Overload Event Register
0
:OVL
:OVL?
Overload Event Enable
(Mask) Register
+
OR
To OVLR bit in
O peration Status
Register
Table 54 Overload Event Enable Register (OVL)
Bit
Description
When Set (1 = High = True), Enables:
15-11
---
(Not used.)
10
External Trigger Fault
Event when fault occurs on External Trigger input.
9
Channel 4 Fault
Event when fault occurs on Channel 4 input.
8
Channel 3 Fault
Event when fault occurs on Channel 3 input.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
181
5
Commands by Subsystem
Table 54 Overload Event Enable Register (OVL) (continued)
Query Syntax
Bit
Description
When Set (1 = High = True), Enables:
7
Channel 2 Fault
Event when fault occurs on Channel 2 input.
6
Channel 1 Fault
Event when fault occurs on Channel 1 input.
5
---
(Not used.)
4
External Trigger OVL
Event when overload occurs on External Trigger
input.
3
Channel 4 OVL
Event when overload occurs on Channel 4 input.
2
Channel 3 OVL
Event when overload occurs on Channel 3 input.
1
Channel 2 OVL
Event when overload occurs on Channel 2 input.
0
Channel 1 OVL
Event when overload occurs on Channel 1 input.
:OVLenable?
The :OVLenable query returns the current enable mask value contained in
the Overload Event Enable Register.
Return Format
<enable_mask><NL>
<enable_mask> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• ":OVLRegister (Overload Event Register)" on page 183
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
182
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:OVLRegister (Overload Event Register)
(see page 798)
Query Syntax
:OVLRegister?
The :OVLRegister query returns the overload protection value stored in the
Overload Event Register (OVLR). If an overvoltage is sensed on a 50Ω
input, the input will automatically switch to 1 MΩ input impedance. A "1"
indicates an overload has occurred.
You can set analog channel input impedance to 50Ω on the 300 MHz, 500 MHz, and 1 GHz
bandwidth oscilloscope models. On these same bandwidth models, if there are only two
analog channels, you can also set external trigger input impedance to 50Ω.
NOTE
Ext Trig Chan4 Chan3 Chan2 Chan1
Fault Fault Fault Fault Fault
15
14
13
12
11
10
9
8
7
6
Ext Trig Chan4 Chan3 Chan2 Chan1
OVL OVL OVL OVL OVL
5
4
3
2
1
:OVLR?
Overload Event Register
0
:OVL
:OVL?
Overload Event Enable
(Mask) Register
+
OR
To OVLR bit in
O peration Status
Register
Table 55 Overload Event Register (OVLR)
Bit
Description
When Set (1 = High = True), Indicates:
15-11
---
(Not used.)
10
External Trigger Fault
Fault has occurred on External Trigger input.
9
Channel 4 Fault
Fault has occurred on Channel 4 input.
8
Channel 3 Fault
Fault has occurred on Channel 3 input.
7
Channel 2 Fault
Fault has occurred on Channel 2 input.
6
Channel 1 Fault
Fault has occurred on Channel 1 input.
5
---
(Not used.)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
183
5
Commands by Subsystem
Table 55 Overload Event Register (OVLR) (continued)
Return Format
Bit
Description
When Set (1 = High = True), Indicates:
4
External Trigger OVL
Overload has occurred on External Trigger input.
3
Channel 4 OVL
Overload has occurred on Channel 4 input.
2
Channel 3 OVL
Overload has occurred on Channel 3 input.
1
Channel 2 OVL
Overload has occurred on Channel 2 input.
0
Channel 1 OVL
Overload has occurred on Channel 1 input.
<value><NL>
<value> ::= integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":OPEE (Operation Status Enable Register)" on page 175
• ":OVLenable (Overload Event Enable Register)" on page 181
• "*STB (Read Status Byte)" on page 146
• "*SRE (Service Request Enable)" on page 144
184
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:PRINt
(see page 798)
Command Syntax
:PRINt [<options>]
<options> ::= [<print option>][,..,<print option>]
<print option> ::= {COLor | GRAYscale | PRINter0 | BMP8bit | BMP | PNG
| NOFactors | FACTors}
The <print option> parameter may be repeated up to 5 times.
The PRINt command formats the output according to the currently
selected format (device). If an option is not specified, the value selected in
the Print Config menu is used. Refer to ":HARDcopy:FORMat" on page 721
for more information.
See Also
• "Introduction to Root (:) Commands" on page 153
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:FORMat" on page 721
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:GRAYscale" on page 722
• ":DISPlay:DATA" on page 259
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
185
5
Commands by Subsystem
:RUN
(see page 798)
Command Syntax
:RUN
The :RUN command starts repetitive acquisitions. This is the same as
pressing the Run key on the front panel.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":SINGle" on page 188
• ":STOP" on page 190
Example Code
' RUN_STOP - (not executed in this example)
' - RUN starts the data acquisition for the active waveform display.
' - STOP stops the data acquisition and turns off AUTOSTORE.
' myScope.WriteString ":RUN"
' Start data acquisition.
' myScope.WriteString ":STOP"
' Stop the data acquisition.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
186
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SERial
(see page 798)
Query Syntax
:SERial?
The :SERial? query returns the serial number of the instrument.
Return Format:
See Also
Unquoted string<NL>
• "Introduction to Root (:) Commands" on page 153
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
187
5
Commands by Subsystem
:SINGle
(see page 798)
Command Syntax
:SINGle
The :SINGle command causes the instrument to acquire a single trigger of
data. This is the same as pressing the Single key on the front panel.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":RUN" on page 186
• ":STOP" on page 190
188
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:STATus
(see page 798)
Query Syntax
:STATus? <source>
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | POD{1 | 2}
| BUS{1 | 2} | FUNCtion | MATH | SBUS} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :STATus? query reports whether the channel, function, trace memory,
or serial decode bus specified by <source> is displayed.
NOTE
Return Format
MATH is an alias for FUNCtion.
<value><NL>
<value> ::= {1 | 0}
See Also
• "Introduction to Root (:) Commands" on page 153
• ":BLANk" on page 160
• ":CHANnel<n>:DISPlay" on page 234
• ":DIGital<n>:DISPlay" on page 251
• ":FUNCtion:DISPlay" on page 280
• ":POD<n>:DISPlay" on page 405
• ":VIEW" on page 192
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
189
5
Commands by Subsystem
:STOP
(see page 798)
Command Syntax
:STOP
The :STOP command stops the acquisition. This is the same as pressing
the Stop key on the front panel.
See Also
• "Introduction to Root (:) Commands" on page 153
• ":RUN" on page 186
• ":SINGle" on page 188
Example Code
190
• "Example Code" on page 186
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TER (Trigger Event Register)
(see page 798)
Query Syntax
:TER?
The :TER? query reads the Trigger Event Register. After the Trigger Event
Register is read, it is cleared. A one indicates a trigger has occurred. A
zero indicates a trigger has not occurred.
The Trigger Event Register is summarized in the TRG bit of the Status
Byte Register (STB). A Service Request (SRQ) can be generated when the
TRG bit of the Status Byte transitions, and the TRG bit is set in the
Service Request Enable register. The Trigger Event Register must be
cleared each time you want a new service request to be generated.
Return Format
<value><NL>
<value> ::= {1 | 0}; a 16-bit integer in NR1 format.
See Also
• "Introduction to Root (:) Commands" on page 153
• "*SRE (Service Request Enable)" on page 144
• "*STB (Read Status Byte)" on page 146
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
191
5
Commands by Subsystem
:VIEW
(see page 798)
Command Syntax
:VIEW <source>
<source> ::= {CHANnel<n> | PMEMory0,..,PMEMory9 | FUNCtion | MATH
| SBUS} for DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | PMEMory0,..,PMEMory9
| POD{1 | 2} | BUS{1 | 2} | FUNCtion | MATH | SBUS} for
MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :VIEW command turns on the specified channel, function, trace
memory, or serial decode bus.
NOTE
See Also
MATH is an alias for FUNCtion.
• "Introduction to Root (:) Commands" on page 153
• ":BLANk" on page 160
• ":CHANnel<n>:DISPlay" on page 234
• ":DIGital<n>:DISPlay" on page 251
• ":FUNCtion:DISPlay" on page 280
• ":POD<n>:DISPlay" on page 405
• ":STATus" on page 189
Example Code
' VIEW_BLANK - (not executed in this example)
' - VIEW turns on (starts displaying) a channel or pixel memory.
' - BLANK turns off (stops displaying) a channel or pixel memory.
' myScope.WriteString ":BLANK CHANNEL1"
' Turn channel 1 off.
' myScope.WriteString ":VIEW CHANNEL1"
' Turn channel 1 on.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
192
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:ACQuire Commands
Set the parameters for acquiring and storing data. See "Introduction to
:ACQuire Commands" on page 193.
Table 56 :ACQuire Commands Summary
Command
Query
Options and Query Returns
n/a
:ACQuire:AALias? (see
page 195)
{1 | 0}
:ACQuire:COMPlete
<complete> (see
page 196)
:ACQuire:COMPlete?
(see page 196)
<complete> ::= 100; an integer in
NR1 format
:ACQuire:COUNt
<count> (see
page 197)
:ACQuire:COUNt? (see
page 197)
<count> ::= an integer from 2 to
65536 in NR1 format
:ACQuire:DAALias
<mode> (see page 198)
:ACQuire:DAALias?
(see page 198)
<mode> ::= {DISable | AUTO}
:ACQuire:MODE <mode>
(see page 199)
:ACQuire:MODE? (see
page 199)
<mode> ::= {RTIMe | ETIMe |
SEGMented}
n/a
:ACQuire:POINts? (see
page 200)
<# points> ::= an integer in NR1
format
:ACQuire:RSIGnal
<ref_signal_mode>
(see page 201)
:ACQuire:RSIGnal?
(see page 201)
<ref_signal_mode> ::= {OFF | OUT
| IN}
:ACQuire:SEGMented:AN
ALyze (see page 202)
n/a
n/a (with Option SGM)
:ACQuire:SEGMented:CO
UNt <count> (see
page 203)
:ACQuire:SEGMented:CO
UNt? (see page 203)
<count> ::= an integer from 2 to
2000 (w/8M memory) in NR1 format
(with Option SGM)
:ACQuire:SEGMented:IN
Dex <index> (see
page 204)
:ACQuire:SEGMented:IN
Dex? (see page 204)
<index> ::= an integer from 2 to
2000 (w/8M memory) in NR1 format
(with Option SGM)
n/a
:ACQuire:SRATe? (see
page 207)
<sample_rate> ::= sample rate
(samples/s) in NR3 format
:ACQuire:TYPE <type>
(see page 208)
:ACQuire:TYPE? (see
page 208)
<type> ::= {NORMal | AVERage |
HRESolution | PEAK}
Introduction to
:ACQuire
Commands
The ACQuire subsystem controls the way in which waveforms are
acquired. These acquisition types are available: normal, averaging, peak
detect, and high resolution. Two acquisition modes are available: real- time
mode, and equivalent- time mode.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
193
5
Commands by Subsystem
Normal
The :ACQuire:TYPE NORMal command sets the oscilloscope in the normal
acquisition mode. For the majority of user models and signals, NORMal
mode yields the best oscilloscope picture of the waveform.
Averaging
The :ACQuire:TYPE AVERage command sets the oscilloscope in the
averaging mode. You can set the count by sending the :ACQuire:COUNt
command followed by the number of averages. In this mode, the value for
averages is an integer from 2 to 65536. The COUNt value determines the
number of averages that must be acquired.
High-Resolution
The :ACQuire:TYPE HRESolution command sets the oscilloscope in the
high- resolution mode (also known as smoothing). This mode is used to
reduce noise at slower sweep speeds where the digitizer samples faster
than needed to fill memory for the displayed time range. Instead of
decimating samples, they are averaged together to provide the value for
one display point. The slower the sweep speed, the greater the number of
samples that are averaged together for each display point.
Peak Detect
The :ACQuire:TYPE PEAK command sets the oscilloscope in the peak
detect mode. In this mode, :ACQuire:COUNt has no meaning.
Real-time Mode
The :ACQuire:MODE RTIMe command sets the oscilloscope in real- time
mode. This mode is useful to inhibit equivalent time sampling at fast
sweep speeds.
Equivalent-time Mode
The :ACQuire:MODE ETIME command sets the oscilloscope in
equivalent- time mode.
Reporting the Setup
Use :ACQuire? to query setup information for the ACQuire subsystem.
Return Format
The following is a sample response from the :ACQuire? query. In this case,
the query was issued following a *RST command.
:ACQ:MODE RTIM;TYPE NORM;COMP 100;COUNT 8;SEGM:COUN 2
194
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:ACQuire:AALias
(see page 798)
Query Syntax
:ACQuire:AALias?
The :ACQuire:AALias? query returns the current state of the oscilloscope
acquisition anti- alias control. This control can be directly disabled or
disabled automatically.
Return Format
<value><NL>
<value> ::= {1 | 0}
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:DAALias" on page 198
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
195
5
Commands by Subsystem
:ACQuire:COMPlete
(see page 798)
Command Syntax
:ACQuire:COMPlete <complete>
<complete> ::= 100; an integer in NR1 format
The :ACQuire:COMPlete command affects the operation of the :DIGitize
command. It specifies the minimum completion criteria for an acquisition.
The parameter determines the percentage of the time buckets that must be
"full" before an acquisition is considered complete. If :ACQuire:TYPE is
NORMal, it needs only one sample per time bucket for that time bucket to
be considered full.
The only legal value for the :COMPlete command is 100. All time buckets
must contain data for the acquisition to be considered complete.
Query Syntax
:ACQuire:COMPlete?
The :ACQuire:COMPlete? query returns the completion criteria (100) for
the currently selected mode.
Return Format
<completion_criteria><NL>
<completion_criteria> ::= 100; an integer in NR1 format
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:TYPE" on page 208
• ":DIGitize" on page 162
• ":WAVeform:POINts" on page 641
Example Code
' AQUIRE_COMPLETE - Specifies the minimum completion criteria for
' an acquisition. The parameter determines the percentage of time
' buckets needed to be "full" before an acquisition is considered
' to be complete.
myScope.WriteString ":ACQUIRE:COMPLETE 100"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
196
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:ACQuire:COUNt
(see page 798)
Command Syntax
:ACQuire:COUNt <count>
<count> ::= integer in NR1 format
In averaging mode, the :ACQuire:COUNt command specifies the number of
values to be averaged for each time bucket before the acquisition is
considered to be complete for that time bucket. When :ACQuire:TYPE is set
to AVERage, the count can be set to any value from 2 to 65536.
NOTE
Query Syntax
The :ACQuire:COUNt 1 command has been deprecated. The AVERage acquisition type with
a count of 1 is functionally equivalent to the HRESolution acquisition type; however, you
should select the high-resolution acquisition mode with the :ACQuire:TYPE HRESolution
command instead.
:ACQuire:COUNT?
The :ACQuire:COUNT? query returns the currently selected count value for
averaging mode.
Return Format
<count_argument><NL>
<count_argument> ::= an integer from 2 to 65536 in NR1 format
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:TYPE" on page 208
• ":DIGitize" on page 162
• ":WAVeform:COUNt" on page 637
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
197
5
Commands by Subsystem
:ACQuire:DAALias
(see page 798)
Command Syntax
:ACQuire:DAALias <mode>
<mode> ::= {DISable | AUTO}
The :ACQuire:DAALias command sets the disable anti- alias mode of the
oscilloscope.
When set to DISable, anti- alias is always disabled. This is good for cases
where dithered data is not desired.
When set to AUTO, the oscilloscope turns off anti- alias control as needed.
Such cases are when the FFT or differentiate math functions are silent.
The :DIGitize command always turns off the anti- alias control as well.
Query Syntax
:ACQuire:DAALias?
The :ACQuire:DAALias? query returns the oscilloscope's current disable
anti- alias mode setting.
Return Format
<mode><NL>
<mode> ::= {DIS | AUTO}
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:AALias" on page 195
198
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:ACQuire:MODE
(see page 798)
Command Syntax
:ACQuire:MODE <mode>
<mode> ::= {RTIMe | ETIMe | SEGMented}
The :ACQuire:MODE command sets the acquisition mode of the
oscilloscope.
• The :ACQuire:MODE RTIMe command sets the oscilloscope in real time
mode. This mode is useful to inhibit equivalent time sampling at fast
sweep speeds.
Real time mode is not available when averaging (:ACQuire:TYPE
AVERage).
NOTE
The obsolete command ACQuire:TYPE:REALtime is functionally equivalent to sending
ACQuire:MODE RTIMe; TYPE NORMal.
• The :ACQuire:MODE ETIMe command sets the oscilloscope in equivalent
time mode.
• The :ACQuire:MODE SEGMented command sets the oscilloscope in
segmented memory mode.
Query Syntax
:ACQuire:MODE?
The :ACQuire:MODE? query returns the acquisition mode of the
oscilloscope.
Return Format
<mode_argument><NL>
<mode_argument> ::= {RTIM | ETIM | SEGM}
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:TYPE" on page 208
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
199
5
Commands by Subsystem
:ACQuire:POINts
(see page 798)
Query Syntax
:ACQuire:POINts?
The :ACQuire:POINts? query returns the number of data points that the
hardware will acquire from the input signal. The number of points
acquired is not directly controllable. To set the number of points to be
transferred from the oscilloscope, use the command :WAVeform:POINts. The
:WAVeform:POINts? query will return the number of points available to be
transferred from the oscilloscope.
Return Format
<points_argument><NL>
<points_argument> ::= an integer in NR1 format
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":DIGitize" on page 162
• ":WAVeform:POINts" on page 641
200
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:ACQuire:RSIGnal
(see page 798)
Command Syntax
:ACQuire:RSIGnal <ref_signal_mode>
<ref_signal_mode> ::= {OFF | OUT | IN}
The :ACQuire:RSIGnal command selects the 10 MHz reference signal mode.
• The OFF mode disables the oscilloscope's 10 MHz REF BNC connector.
• The OUT mode is used to synchronize the timebase of two or more
instruments.
• The IN mode is used to supply a sample clock to the oscilloscope. A
10 MHz square or sine wave signal is input to the BNC connector
labeled 10 MHz REF. The amplitude must be between 180 mV and 1 V,
with an offset of between 0 V and 2 V.
CAUTION
Query Syntax
Do not apply more than ±15 V at the 10 MHz REF BNC connector on the rear panel,
or damage to the instrument may occur.
:ACQuire:RSIGnal?
The :ACQuire:RSIGnal? query returns the current 10 MHz reference signal
mode.
Return Format
<ref_signal_mode><NL>
<ref_signal_mode> ::= {OFF | OUT | IN}
See Also
• ":TIMebase:REFClock" on page 472
• The Agilent InfiniiVision 6000 Series Oscilloscope User's Guide for
information on using the 10 MHz reference clock.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
201
5
Commands by Subsystem
:ACQuire:SEGMented:ANALyze
(see page 798)
Command Syntax
NOTE
:ACQuire:SEGMented:ANALyze
This command is available when the segmented memory option (Option SGM) is enabled.
This command calculates measurement statistics and/or infinite
persistence over all segments that have been acquired. It corresponds to
the front panel Analyze Segments softkey which appears in both the
Measurement Statistics and Segmented Memory Menus.
In order to use this command, the oscilloscope must be stopped and in
segmented acquisition mode, with either quick measurements or infinite
persistence on.
See Also
• ":ACQuire:MODE" on page 199
• ":ACQuire:SEGMented:COUNt" on page 203
• "Introduction to :ACQuire Commands" on page 193
202
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:ACQuire:SEGMented:COUNt
(see page 798)
Command Syntax
:ACQuire:SEGMented:COUNt <count>
<count> ::= an integer from 2 to 2000 (w/8M memory) in NR1 format
NOTE
This command is available when the segmented memory option (Option SGM) is enabled.
The :ACQuire:SEGMented:COUNt command sets the number of memory
segments to acquire.
The segmented memory acquisition mode is enabled with the
:ACQuire:MODE command, and data is acquired using the :DIGitize,
:SINGle, or :RUN commands. The number of memory segments in the
current acquisition is returned by the :WAVeform:SEGMented:COUNt?
query.
The maximum number of segments may be limited by the memory depth
of your oscilloscope. For example, an oscilloscope with 1M memory allows
a maximum of 250 segments.
Query Syntax
:ACQuire:SEGMented:COUNt?
The :ACQuire:SEGMented:COUNt? query returns the current count setting.
Return Format
<count><NL>
<count> ::= an integer from 2 to 2000 (w/8M memory) in NR1 format
See Also
• ":ACQuire:MODE" on page 199
• ":DIGitize" on page 162
• ":SINGle" on page 188
• ":RUN" on page 186
• ":WAVeform:SEGMented:COUNt" on page 648
• ":ACQuire:SEGMented:ANALyze" on page 202
• "Introduction to :ACQuire Commands" on page 193
Example Code
• "Example Code" on page 204
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
203
5
Commands by Subsystem
:ACQuire:SEGMented:INDex
(see page 798)
Command Syntax
:ACQuire:SEGMented:INDex <index>
<index> ::= an integer from 2 to 2000 (w/8M memory) in NR1 format
NOTE
This command is available when the segmented memory option (Option SGM) is enabled.
The :ACQuire:SEGMented:INDex command sets the index into the memory
segments that have been acquired.
The segmented memory acquisition mode is enabled with the
:ACQuire:MODE command. The number of segments to acquire is set using
the :ACQuire:SEGMented:COUNt command, and data is acquired using the
:DIGitize, :SINGle, or :RUN commands. The number of memory segments
that have been acquired is returned by the :WAVeform:SEGMented:COUNt?
query. The time tag of the currently indexed memory segment is returned
by the :WAVeform:SEGMented:TTAG? query.
The maximum number of segments may be limited by the memory depth
of your oscilloscope. For example, an oscilloscope with 1M memory allows
a maximum of 250 segments.
Query Syntax
:ACQuire:SEGMented:INDex?
The :ACQuire:SEGMented:INDex? query returns the current segmented
memory index setting.
Return Format
<index><NL>
<index> ::= an integer from 2 to 2000 (w/8M memory) in NR1 format
See Also
• ":ACQuire:MODE" on page 199
• ":ACQuire:SEGMented:COUNt" on page 203
• ":DIGitize" on page 162
• ":SINGle" on page 188
• ":RUN" on page 186
• ":WAVeform:SEGMented:COUNt" on page 648
• ":WAVeform:SEGMented:TTAG" on page 649
• ":ACQuire:SEGMented:ANALyze" on page 202
• "Introduction to :ACQuire Commands" on page 193
Example Code
204
' Segmented memory commands example.
' -------------------------------------------------------------------
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.70.228::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
' Turn on segmented memory acquisition mode.
myScope.WriteString ":ACQuire:MODE SEGMented"
myScope.WriteString ":ACQuire:MODE?"
strQueryResult = myScope.ReadString
Debug.Print "Acquisition mode: " + strQueryResult
' Set the number of segments to 50.
myScope.WriteString ":ACQuire:SEGMented:COUNt 50"
myScope.WriteString ":ACQuire:SEGMented:COUNt?"
strQueryResult = myScope.ReadString
Debug.Print "Acquisition memory segments: " + strQueryResult
' If data will be acquired within the IO timeout:
'myScope.IO.Timeout = 10000
'myScope.WriteString ":DIGitize"
'Debug.Print ":DIGitize blocks until all segments acquired."
'myScope.WriteString ":WAVeform:SEGMented:COUNt?"
'varQueryResult = myScope.ReadNumber
' Or, to poll until the desired number of segments acquired:
myScope.WriteString ":SINGle"
Debug.Print ":SINGle does not block until all segments acquired."
Do
Sleep 100
' Small wait to prevent excessive queries.
myScope.WriteString ":WAVeform:SEGMented:COUNt?"
varQueryResult = myScope.ReadNumber
Loop Until varQueryResult = 50
Debug.Print "Number of segments in acquired data: " _
+ FormatNumber(varQueryResult)
Dim lngSegments As Long
lngSegments = varQueryResult
' For each segment:
Dim dblTimeTag As Double
Dim lngI As Long
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
205
5
Commands by Subsystem
For lngI = lngSegments To 1 Step -1
' Set the segmented memory index.
myScope.WriteString ":ACQuire:SEGMented:INDex " + CStr(lngI)
myScope.WriteString ":ACQuire:SEGMented:INDex?"
strQueryResult = myScope.ReadString
Debug.Print "Acquisition memory segment index: " + strQueryResult
' Display the segment time tag.
myScope.WriteString ":WAVeform:SEGMented:TTAG?"
dblTimeTag = myScope.ReadNumber
Debug.Print "Segment " + CStr(lngI) + " time tag: " _
+ FormatNumber(dblTimeTag, 12)
Next lngI
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
206
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:ACQuire:SRATe
(see page 798)
Query Syntax
:ACQuire:SRATe?
The :ACQuire:SRATe? query returns the current oscilloscope acquisition
sample rate. The sample rate is not directly controllable.
Return Format
<sample_rate><NL>
<sample_rate> ::= sample rate in NR3 format
See Also
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:POINts" on page 200
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
207
5
Commands by Subsystem
:ACQuire:TYPE
(see page 798)
Command Syntax
:ACQuire:TYPE <type>
<type> ::= {NORMal | AVERage | HRESolution | PEAK}
The :ACQuire:TYPE command selects the type of data acquisition that is to
take place. The acquisition types are: NORMal, AVERage, HRESolution, and
PEAK.
• The :ACQuire:TYPE NORMal command sets the oscilloscope in the
normal mode.
• The :ACQuire:TYPE AVERage command sets the oscilloscope in the
averaging mode. You can set the count by sending the :ACQuire:COUNt
command followed by the number of averages. In this mode, the value
for averages is an integer from 1 to 65536. The COUNt value determines
the number of averages that must be acquired.
Setting the :ACQuire:TYPE to AVERage automatically sets
:ACQuire:MODE to ETIMe (equivalent time sampling).
The AVERage type is not available when in segmented memory mode
(:ACQuire:MODE SEGMented).
• The :ACQuire:TYPE HRESolution command sets the oscilloscope in the
high- resolution mode (also known as smoothing). This mode is used to
reduce noise at slower sweep speeds where the digitizer samples faster
than needed to fill memory for the displayed time range.
For example, if the digitizer samples at 200 MSa/s, but the effective
sample rate is 1 MSa/s (because of a slower sweep speed), only 1 out of
every 200 samples needs to be stored. Instead of storing one sample
(and throwing others away), the 200 samples are averaged together to
provide the value for one display point. The slower the sweep speed,
the greater the number of samples that are averaged together for each
display point.
• The :ACQuire:TYPE PEAK command sets the oscilloscope in the peak
detect mode. In this mode, :ACQuire:COUNt has no meaning.
NOTE
Query Syntax
The obsolete command ACQuire:TYPE:REALtime is functionally equivalent to sending
ACQuire:MODE RTIME; TYPE NORMal.
:ACQuire:TYPE?
The :ACQuire:TYPE? query returns the current acquisition type.
Return Format
<acq_type><NL>
<acq_type> ::= {NORM | AVER | HRES | PEAK}
208
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
See Also
5
• "Introduction to :ACQuire Commands" on page 193
• ":ACQuire:COUNt" on page 197
• ":ACQuire:MODE" on page 199
• ":DIGitize" on page 162
• ":WAVeform:TYPE" on page 655
• ":WAVeform:PREamble" on page 645
Example Code
' AQUIRE_TYPE - Sets the acquisition mode, which can be NORMAL,
' PEAK, or AVERAGE.
myScope.WriteString ":ACQUIRE:TYPE NORMAL"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
209
5
Commands by Subsystem
:BUS<n> Commands
Control all oscilloscope functions associated with buses made up of digital
channels. See "Introduction to :BUS<n> Commands" on page 211.
Table 57 :BUS<n> Commands Summary
Command
Query
Options and Query Returns
:BUS<n>:BIT<m> {{0 |
OFF} | {1 | ON}} (see
page 212)
:BUS<n>:BIT<m>? (see
page 212)
{0 | 1}
<n> ::= 1 or 2; an integer in NR1
format
<m> ::= 0-15; an integer in NR1
format
:BUS<n>:BITS
<channel_list>, {{0 |
OFF} | {1 | ON}} (see
page 213)
:BUS<n>:BITS? (see
page 213)
<channel_list>, {0 | 1}
<channel_list> ::= (@<m>,<m>:<m>
...) where "," is separator and
":" is range
<n> ::= 1 or 2; an integer in NR1
format
<m> ::= 0-15; an integer in NR1
format
:BUS<n>:CLEar (see
page 215)
n/a
<n> ::= 1 or 2; an integer in NR1
format
:BUS<n>:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 216)
:BUS<n>:DISPlay? (see
page 216)
{0 | 1}
<n> ::= 1 or 2; an integer in NR1
format
:BUS<n>:LABel
<string> (see
page 217)
:BUS<n>:LABel? (see
page 217)
<string> ::= quoted ASCII string
up to 10 characters
<n> ::= 1 or 2; an integer in NR1
format
:BUS<n>:MASK <mask>
(see page 218)
:BUS<n>:MASK? (see
page 218)
<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
<n> ::= 1 or 2; an integer in NR1
format
210
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Introduction to
:BUS<n>
Commands
NOTE
<n> ::= {1 | 2}
The BUS subsystem commands control the viewing, labeling, and digital
channel makeup of two possible buses.
These commands are only valid for the MSO models.
Reporting the Setup
Use :BUS<n>? to query setup information for the BUS subsystem.
Return Format
The following is a sample response from the :BUS1? query. In this case,
the query was issued following a *RST command.
:BUS1:DISP 0;LAB "BUS1";MASK +255
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
211
5
Commands by Subsystem
:BUS<n>:BIT<m>
(see page 798)
Command Syntax
:BUS<n>:BIT<m> <display>
<display> ::= {{1 | ON} | {0 | OFF}}
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
<m> ::= An integer, 0,..,15, is attached as a suffix to BIT
and defines the digital channel that is affected by the command.
The :BUS<n>:BIT<m> command includes or excludes the selected bit as
part of the definition for the selected bus. If the parameter is a 1 (ON),
the bit is included in the definition. If the parameter is a 0 (OFF), the bit
is excluded from the definition. Note: BIT0- 15 correspond to DIGital0- 15.
NOTE
Query Syntax
This command is only valid for the MSO models.
:BUS<n>:BIT<m>?
The :BUS<n>:BIT<m>? query returns the value indicating whether the
specified bit is included or excluded from the specified bus definition.
Return Format
<display><NL>
<display> ::= {0 | 1}
See Also
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:LABel" on page 217
• ":BUS<n>:MASK" on page 218
Example Code
212
' Include digital channel 1 in bus 1:
myScope.WriteString ":BUS1:BIT1 ON"
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:BUS<n>:BITS
(see page 798)
Command Syntax
:BUS<n>:BITS <channel_list>, <display>
<channel_list> ::= (@<m>,<m>:<m>, ...) where commas separate bits and
colons define bit ranges.
<m> ::= An integer, 0,..,15, defines a digital channel affected by the
command.
<display> ::= {{1 | ON} | {0 | OFF}}
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:BITS command includes or excludes the selected bits in the
channel list in the definition of the selected bus. If the parameter is a 1
(ON) then the bits in the channel list are included as part of the selected
bus definition. If the parameter is a 0 (OFF) then the bits in the channel
list are excluded from the definition of the selected bus.
NOTE
Query Syntax
This command is only valid for the MSO models.
:BUS<n>:BITS?
The :BUS<n>:BITS? query returns the definition for the specified bus.
Return Format
<channel_list>, <display><NL>
<channel_list> ::= (@<m>,<m>:<m>, ...) where commas separate bits and
colons define bit ranges.
<display> ::= {0 | 1}
See Also
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:LABel" on page 217
• ":BUS<n>:MASK" on page 218
Example Code
' Include digital channels 1, 2, 4, 5, 6, 7, 8, and 9 in bus 1:
myScope.WriteString ":BUS1:BITS (@1,2,4:9), ON"
' Include digital channels 1, 5, 7, and 9 in bus 1:
myScope.WriteString ":BUS1:BITS (@1,5,7,9), ON"
' Include digital channels 1 through 15 in bus 1:
myScope.WriteString ":BUS1:BITS (@1:15), ON"
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
213
5
Commands by Subsystem
' Include digital channels 1 through 5, 8, and 14 in bus 1:
myScope.WriteString ":BUS1:BITS (@1:5,8,14), ON"
214
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:BUS<n>:CLEar
(see page 798)
Command Syntax
:BUS<n>:CLEar
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:CLEar command excludes all of the digital channels from the
selected bus definition.
NOTE
See Also
This command is only valid for the MSO models.
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:LABel" on page 217
• ":BUS<n>:MASK" on page 218
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
215
5
Commands by Subsystem
:BUS<n>:DISPlay
(see page 798)
Command Syntax
:BUS<n>:DISplay <value>
<value> ::= {{1 | ON} | {0 | OFF}}
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:DISPlay command enables or disables the view of the selected
bus.
NOTE
Query Syntax
This command is only valid for the MSO models.
:BUS<n>:DISPlay?
The :BUS<n>:DISPlay? query returns the display value of the selected bus.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:LABel" on page 217
• ":BUS<n>:MASK" on page 218
216
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:BUS<n>:LABel
(see page 798)
Command Syntax
:BUS<n>:LABel <quoted_string>
<quoted_string> ::= any series of 10 or less characters as a
quoted ASCII string.
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:LABel command sets the bus label to the quoted string.
Setting a label for a bus will also result in the name being added to the
label list.
NOTE
This command is only valid for the MSO models.
NOTE
Label strings are 10 characters or less, and may contain any commonly used ASCII
characters. Labels with more than 10 characters are truncated to 10 characters.
Query Syntax
:BUS<n>:LABel?
The :BUS<n>:LABel? query returns the name of the specified bus.
Return Format
<quoted_string><NL>
<quoted_string> ::= any series of 10 or less characters as a
quoted ASCII string.
See Also
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:MASK" on page 218
• ":CHANnel<n>:LABel" on page 237
• ":DISPlay:LABList" on page 262
• ":DIGital<n>:LABel" on page 252
Example Code
' Set the bus 1 label to "Data":
myScope.WriteString ":BUS1:LABel 'Data'"
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
217
5
Commands by Subsystem
:BUS<n>:MASK
(see page 798)
Command Syntax
:BUS<n>:MASK <mask>
<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
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:MASK command defines the bits included and excluded in
the selected bus according to the mask. Set a mask bit to a "1" to include
that bit in the selected bus, and set a mask bit to a "0" to exclude it.
NOTE
Query Syntax
This command is only valid for the MSO models.
:BUS<n>:MASK?
The :BUS<n>:MASK? query returns the mask value for the specified bus.
Return Format
See Also
<mask><NL> in decimal format
• "Introduction to :BUS<n> Commands" on page 211
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:LABel" on page 217
218
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CALibrate Commands
Utility commands for viewing calibration status and for starting the user
calibration procedure. See "Introduction to :CALibrate Commands" on
page 219.
Table 58 :CALibrate Commands Summary
Command
Query
Options and Query Returns
n/a
:CALibrate:DATE? (see
page 221)
<return value> ::=
<day>,<month>,<year>; all in NR1
format
:CALibrate:LABel
<string> (see
page 222)
:CALibrate:LABel?
(see page 222)
<string> ::= quoted ASCII string
up to 32 characters
:CALibrate:OUTPut
<signal> (see
page 223)
:CALibrate:OUTPut?
(see page 223)
<signal> ::= {TRIGgers | SOURce |
DSOurce | MASK}
:CALibrate:STARt (see
page 224)
n/a
n/a
n/a
:CALibrate:STATus?
(see page 225)
<return value> ::=
ALL,<status_code>,<status_string
>
<status_code> ::= an integer
status code
<status_string> ::= an ASCII
status string
n/a
:CALibrate:SWITch?
(see page 226)
{PROTected | UNPRotected}
n/a
:CALibrate:TEMPeratur
e? (see page 227)
<return value> ::= degrees C
delta since last cal in NR3
format
n/a
:CALibrate:TIME? (see
page 228)
<return value> ::=
<hours>,<minutes>,<seconds>; all
in NR1 format
Introduction to
:CALibrate
Commands
The CALibrate subsystem provides utility commands for:
• Determining the state of the calibration factor protection switch
(CAL PROTECT).
• Saving and querying the calibration label string.
• Reporting the calibration time and date.
• Reporting changes in the temperature since the last calibration.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
219
5
Commands by Subsystem
• Starting the user calibration procedure.
220
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CALibrate:DATE
(see page 798)
Query Syntax
:CALibrate:DATE?
The :CALibrate:DATE? query returns the date of the last calibration.
Return Format
<date><NL>
<date> ::= day,month,year in NR1 format<NL>
See Also
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
221
5
Commands by Subsystem
:CALibrate:LABel
(see page 798)
Command Syntax
:CALibrate:LABel <string>
<string> ::= quoted ASCII string of up to 32 characters in length,
not including the quotes
The CALibrate:LABel command saves a string that is up to 32 characters
in length into the instrument's non- volatile memory. The string may be
used to record calibration dates or other information as needed.
Query Syntax
:CALibrate:LABel?
The :CALibrate:LABel? query returns the contents of the calibration label
string.
Return Format
<string><NL>
<string>::= unquoted ASCII string of up to 32 characters in length
See Also
222
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CALibrate:OUTPut
(see page 798)
Command Syntax
:CALibrate:OUTPut <signal>
<signal> ::= {TRIGgers | SOURce | DSOurce | MASK}
The CALibrate:OUTPut command sets the signal that is available on the
rear panel TRIG OUT BNC:
• TRIGgers — pulse when a trigger event occurs.
• SOURce — raw output of trigger comparator.
• DSOurce — SOURce frequency divided by 8.
• MASK — signal from mask test indicating a success or fail mask test.
Query Syntax
:CALibrate:OUTPut?
The :CALibrate:OUTPut query returns the current source of the TRIG OUT
BNC signal.
Return Format
<signal><NL>
<signal> ::= {TRIG | SOUR | DSO | MASK}
See Also
• "Introduction to :CALibrate Commands" on page 219
• ":MTESt:OUTPut" on page 388
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
223
5
Commands by Subsystem
:CALibrate:STARt
(see page 798)
Command Syntax
:CALibrate:STARt
The CALibrate:STARt command starts the user calibration procedure.
NOTE
See Also
Before starting the user calibration procedure, you must set the rear panel CALIBRATION
switch to UNPROTECTED, and you must connect BNC cables from the TRIG OUT connector
to the analog channel inputs. See the User's Guide for details.
• "Introduction to :CALibrate Commands" on page 219
• ":CALibrate:SWITch" on page 226
224
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CALibrate:STATus
(see page 798)
Query Syntax
:CALibrate:STATus?
The :CALibrate:STATus? query returns the summary results of the last
user calibration procedure.
Return Format
<return value><NL>
<return value> ::= ALL,<status_code>,<status_string>
<status_code> ::= an integer status code
<status_string> ::= an ASCII status string
See Also
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
225
5
Commands by Subsystem
:CALibrate:SWITch
(see page 798)
Query Syntax
:CALibrate:SWITch?
The :CALibrate:SWITch? query returns the rear- panel calibration protect
(CAL PROTECT) switch state. The value PROTected indicates calibration is
disabled, and UNPRotected indicates calibration is enabled.
Return Format
<switch><NL>
<switch> ::= {PROT | UNPR}
See Also
226
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CALibrate:TEMPerature
(see page 798)
Query Syntax
:CALibrate:TEMPerature?
The :CALibrate:TEMPerature? query returns the change in temperature
since the last user calibration procedure.
Return Format
<return value><NL>
<return value> ::= degrees C delta since last cal in NR3 format
See Also
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
227
5
Commands by Subsystem
:CALibrate:TIME
(see page 798)
Query Syntax
:CALibrate:TIME?
The :CALibrate:TIME? query returns the time of the last calibration.
Return Format
<date><NL>
<date> ::= hour,minutes,seconds in NR1 format
See Also
228
• "Introduction to :CALibrate Commands" on page 219
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n> Commands
Control all oscilloscope functions associated with individual analog
channels or groups of channels. See "Introduction to :CHANnel<n>
Commands" on page 230.
Table 59 :CHANnel<n> Commands Summary
Command
Query
Options and Query Returns
:CHANnel<n>:BWLimit
{{0 | OFF} | {1 |
ON}} (see page 232)
:CHANnel<n>:BWLimit?
(see page 232)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:COUPling
<coupling> (see
page 233)
:CHANnel<n>:COUPling?
(see page 233)
<coupling> ::= {AC | DC}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:DISPlay
{{0 | OFF} | {1 |
ON}} (see page 234)
:CHANnel<n>:DISPlay?
(see page 234)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:IMPedance
<impedance> (see
page 235)
:CHANnel<n>:IMPedance
? (see page 235)
<impedance> ::= {ONEMeg | FIFTy}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:INVert
{{0 | OFF} | {1 |
ON}} (see page 236)
:CHANnel<n>:INVert?
(see page 236)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:LABel
<string> (see
page 237)
:CHANnel<n>:LABel?
(see page 237)
<string> ::= any series of 10 or
less ASCII characters enclosed in
quotation marks
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:OFFSet
<offset>[suffix] (see
page 238)
:CHANnel<n>:OFFSet?
(see page 238)
<offset> ::= Vertical offset
value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4; in NR1 format
:CHANnel<n>:PROBe
<attenuation> (see
page 239)
:CHANnel<n>:PROBe?
(see page 239)
<attenuation> ::= Probe
attenuation ratio in NR3 format
<n> ::= 1-2 or 1-4r in NR1 format
:CHANnel<n>:PROBe:HEA
D[:TYPE] <head_param>
(see page 240)
:CHANnel<n>:PROBe:HEA
D[:TYPE]? (see
page 240)
<head_param> ::= {SEND0 | SEND6 |
SEND12 | SEND20 | DIFF0 | DIFF6 |
DIFF12 | DIFF20 | NONE}
<n> ::= 1-2 or 1-4 in NR1 format
n/a
:CHANnel<n>:PROBe:ID?
(see page 241)
<probe id> ::= unquoted ASCII
string up to 11 characters
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
229
5
Commands by Subsystem
Table 59 :CHANnel<n> Commands Summary (continued)
Command
Query
Options and Query Returns
:CHANnel<n>:PROBe:SKE
W <skew_value> (see
page 242)
:CHANnel<n>:PROBe:SKE
W? (see page 242)
<skew_value> ::= -100 ns to +100
ns in NR3 format
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROBe:STY
Pe <signal type> (see
page 243)
:CHANnel<n>:PROBe:STY
Pe? (see page 243)
<signal type> ::= {DIFFerential |
SINGle}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:PROTectio
n (see page 244)
:CHANnel<n>:PROTectio
n? (see page 244)
{NORM | TRIP}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:RANGe
<range>[suffix] (see
page 245)
:CHANnel<n>:RANGe?
(see page 245)
<range> ::= Vertical full-scale
range value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:SCALe
<scale>[suffix] (see
page 246)
:CHANnel<n>:SCALe?
(see page 246)
<scale> ::= Vertical units per
division value in NR3 format
[suffix] ::= {V | mV}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:UNITs
<units> (see
page 247)
:CHANnel<n>:UNITs?
(see page 247)
<units> ::= {VOLT | AMPere}
<n> ::= 1-2 or 1-4 in NR1 format
:CHANnel<n>:VERNier
{{0 | OFF} | {1 |
ON}} (see page 248)
:CHANnel<n>:VERNier?
(see page 248)
{0 | 1}
<n> ::= 1-2 or 1-4 in NR1 format
Introduction to
:CHANnel<n>
Commands
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The CHANnel<n> subsystem commands control an analog channel (vertical
or Y- axis of the oscilloscope). Channels are independently programmable
for all offset, probe, coupling, bandwidth limit, inversion, vernier, and
range (scale) functions. The channel number (1, 2, 3, or 4) specified in the
command selects the analog channel that is affected by the command.
A label command provides identifying annotations of up to 10 characters.
You can toggle the channel displays on and off with the
:CHANnel<n>:DISPlay command as well as with the root level commands
:VIEW and :BLANk.
NOTE
230
The obsolete CHANnel subsystem is supported.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Reporting the Setup
Use :CHANnel1?, :CHANnel2?, :CHANnel3? or :CHANnel4? to query setup
information for the CHANnel<n> subsystem.
Return Format
The following are sample responses from the :CHANnel<n>? query. In this
case, the query was issued following a *RST command.
:CHAN1:RANG +40.0E+00;OFFS +0.00000E+00;COUP DC;IMP ONEM;DISP 1;BWL 0;
INV 0;LAB "1";UNIT VOLT;PROB +10E+00;PROB:SKEW +0.00E+00;STYP SING
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
231
5
Commands by Subsystem
:CHANnel<n>:BWLimit
(see page 798)
Command Syntax
:CHANnel<n>:BWLimit <bwlimit>
<bwlimit> ::= {{1 | ON} | {0 | OFF}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:BWLimit command controls an internal low- pass filter.
When the filter is on, the bandwidth of the specified channel is limited to
approximately 25 MHz.
Query Syntax
:CHANnel<n>:BWLimit?
The :CHANnel<n>:BWLimit? query returns the current setting of the
low- pass filter.
Return Format
<bwlimit><NL>
<bwlimit> ::= {1 | 0}
See Also
232
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CHANnel<n>:COUPling
(see page 798)
Command Syntax
:CHANnel<n>:COUPling <coupling>
<coupling> ::= {AC | DC}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:COUPling command selects the input coupling for the
specified channel. The coupling for each analog channel can be set to AC
or DC.
Query Syntax
:CHANnel<n>:COUPling?
The :CHANnel<n>:COUPling? query returns the current coupling for the
specified channel.
Return Format
<coupling value><NL>
<coupling value> ::= {AC | DC}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
233
5
Commands by Subsystem
:CHANnel<n>:DISPlay
(see page 798)
Command Syntax
:CHANnel<n>:DISPlay <display value>
<display value> ::= {{1 | ON} | {0 | OFF}}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:DISPlay command turns the display of the specified
channel on or off.
Query Syntax
:CHANnel<n>:DISPlay?
The :CHANnel<n>:DISPlay? query returns the current display setting for
the specified channel.
Return Format
<display value><NL>
<display value> ::= {1 | 0}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":VIEW" on page 192
• ":BLANk" on page 160
• ":STATus" on page 189
• ":POD<n>:DISPlay" on page 405
• ":DIGital<n>:DISPlay" on page 251
234
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n>:IMPedance
(see page 798)
Command Syntax
:CHANnel<n>:IMPedance <impedance>
<impedance> ::= {ONEMeg | FIFTy}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:IMPedance command selects the input impedance setting
for the specified analog channel. The legal values for this command are
ONEMeg (1 MΩ) and FIFTy (50Ω).
NOTE
Query Syntax
The analog channel input impedance of the 100 MHz bandwidth oscilloscope models is
fixed at ONEMeg (1 MΩ).
:CHANnel<n>:IMPedance?
The :CHANnel<n>:IMPedance? query returns the current input impedance
setting for the specified channel.
Return Format
<impedance value><NL>
<impedance value> ::= {ONEM | FIFT}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
235
5
Commands by Subsystem
:CHANnel<n>:INVert
(see page 798)
Command Syntax
:CHANnel<n>:INVert <invert value>
<invert value> ::= {{1 | ON} | {0 | OFF}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:INVert command selects whether or not to invert the
input signal for the specified channel. The inversion may be 1
(ON/inverted) or 0 (OFF/not inverted).
Query Syntax
:CHANnel<n>:INVert?
The :CHANnel<n>:INVert? query returns the current state of the channel
inversion.
Return Format
<invert value><NL>
<invert value> ::= {0 | 1}
See Also
236
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CHANnel<n>:LABel
(see page 798)
Command Syntax
:CHANnel<n>:LABel <string>
<string> ::= quoted ASCII string
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
NOTE
Label strings are 10 characters or less, and may contain any commonly used ASCII
characters. Labels with more than 10 characters are truncated to 10 characters. Lower case
characters are converted to upper case.
The :CHANnel<n>:LABel command sets the analog channel label to the
string that follows. Setting a label for a channel also adds the name to the
label list in non- volatile memory (replacing the oldest label in the list).
Query Syntax
:CHANnel<n>:LABel?
The :CHANnel<n>:LABel? query returns the label associated with a
particular analog channel.
Return Format
<string><NL>
<string> ::= quoted ASCII string
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":DISPlay:LABel" on page 261
• ":DIGital<n>:LABel" on page 252
• ":DISPlay:LABList" on page 262
• ":BUS<n>:LABel" on page 217
Example Code
' LABEL - This command allows you to write a name (10 characters
' maximum) next to the channel number. It is not necessary, but
' can be useful for organizing the display.
myScope.WriteString ":CHANNEL1:LABEL ""CAL 1""" ' Label ch1 "CAL 1".
myScope.WriteString ":CHANNEL2:LABEL ""CAL2"""
' Label ch1 "CAL2".
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
237
5
Commands by Subsystem
:CHANnel<n>:OFFSet
(see page 798)
Command Syntax
:CHANnel<n>:OFFSet <offset> [<suffix>]
<offset> ::= Vertical offset value in NR3 format
<suffix> ::= {V | mV}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:OFFSet command sets the value that is represented at
center screen for the selected channel. The range of legal values varies
with the value set by the :CHANnel<n>:RANGe and :CHANnel<n>:SCALe
commands. If you set the offset to a value outside of the legal range, the
offset value is automatically set to the nearest legal value. Legal values are
affected by the probe attenuation setting.
Query Syntax
:CHANnel<n>:OFFSet?
The :CHANnel<n>:OFFSet? query returns the current offset value for the
selected channel.
Return Format
<offset><NL>
<offset> ::= Vertical offset value in NR3 format
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:SCALe" on page 246
• ":CHANnel<n>:PROBe" on page 239
238
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n>:PROBe
(see page 798)
Command Syntax
:CHANnel<n>:PROBe <attenuation>
<attenuation> ::= probe attenuation ratio in NR3 format
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The obsolete attenuation values X1, X10, X20, X100 are also supported.
The :CHANnel<n>:PROBe command specifies the probe attenuation factor
for the selected channel. The probe attenuation factor may be 0.1 to 1000.
This command does not change the actual input sensitivity of the
oscilloscope. It changes the reference constants for scaling the display
factors, for making automatic measurements, and for setting trigger levels.
If an AutoProbe probe is connected to the oscilloscope, the attenuation
value cannot be changed from the sensed value. Attempting to set the
oscilloscope to an attenuation value other than the sensed value produces
an error.
Query Syntax
:CHANnel<n>:PROBe?
The :CHANnel<n>:PROBe? query returns the current probe attenuation
factor for the selected channel.
Return Format
<attenuation><NL>
<attenuation> ::= probe attenuation ratio in NR3 format
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:SCALe" on page 246
• ":CHANnel<n>:OFFSet" on page 238
Example Code
' CHANNEL_PROBE - Sets the probe attenuation factor for the selected
' channel. The probe attenuation factor may be set from 0.1 to 1000.
myScope.WriteString ":CHAN1:PROBE 10"
' Set Probe to 10:1.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
239
5
Commands by Subsystem
:CHANnel<n>:PROBe:HEAD[:TYPE]
(see page 798)
Command Syntax
NOTE
This command is valid only for the 113xA Series probes.
:CHANnel<n>:PROBe:HEAD[:TYPE] <head_param>
<head_param> ::= {SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6
| DIFF12 | DIFF20 | NONE}
<n> ::= {1 | 2 | 3 | 4}
The :CHANnel<n>:PROBe:HEAD[:TYPE] command sets an analog channel
probe head type and dB value. You can choose from:
• SEND0 — Single- ended, 0dB.
• SEND6 — Single- ended, 6dB.
• SEND12 — Single- ended, 12dB.
• SEND20 — Single- ended, 20dB.
• DIFF0 — Differential, 0dB.
• DIFF6 — Differential, 6dB.
• DIFF12 — Differential, 12dB.
• DIFF20 — Differential, 20dB.
Query Syntax
:CHANnel<n>:PROBe:HEAD[:TYPE]?
The :CHANnel<n>:PROBe:HEAD[:TYPE]? query returns the current probe
head type setting for the selected channel.
Return Format
<head_param><NL>
<head_param> ::= {SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6
| DIFF12 | DIFF20 | NONE}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:PROBe" on page 239
• ":CHANnel<n>:PROBe:ID" on page 241
• ":CHANnel<n>:PROBe:SKEW" on page 242
• ":CHANnel<n>:PROBe:STYPe" on page 243
240
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n>:PROBe:ID
(see page 798)
Query Syntax
:CHANnel<n>:PROBe:ID?
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:PROBe:ID? query returns the type of probe attached to
the specified oscilloscope channel.
Return Format
<probe id><NL>
<probe id> ::= unquoted ASCII string up to 11 characters
Some of the possible returned values are:
• 1131A
• 1132A
• 1134A
• 1147A
• 1153A
• 1154A
• 1156A
• 1157A
• 1158A
• 1159A
• AutoProbe
• E2621A
• E2622A
• E2695A
• E2697A
• HP1152A
• HP1153A
• NONE
• Probe
• Unknown
• Unsupported
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
241
5
Commands by Subsystem
:CHANnel<n>:PROBe:SKEW
(see page 798)
Command Syntax
:CHANnel<n>:PROBe:SKEW <skew value>
<skew value> ::= skew time in NR3 format
<skew value> ::= -100 ns to +100 ns
<n> ::= {1 | 2 | 3 | 4}
The :CHANnel<n>:PROBe:SKEW command sets the channel- to- channel
skew factor for the specified channel. Each analog channel can be adjusted
+ or - 100 ns for a total of 200 ns difference between channels. You can
use the oscilloscope's probe skew control to remove cable- delay errors
between channels.
Query Syntax
:CHANnel<n>:PROBe:SKEW?
The :CHANnel<n>:PROBe:SKEW? query returns the current probe skew
setting for the selected channel.
Return Format
<skew value><NL>
<skew value> ::= skew value in NR3 format
See Also
242
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:CHANnel<n>:PROBe:STYPe
(see page 798)
Command Syntax
NOTE
This command is valid only for the 113xA Series probes.
:CHANnel<n>:PROBe:STYPe <signal type>
<signal type> ::= {DIFFerential | SINGle}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:PROBe:STYPe command sets the channel probe signal
type (STYPe) to differential or single- ended when using the 113xA Series
probes and determines how offset is applied.
When single- ended is selected, the :CHANnel<n>:OFFset command changes
the offset value of the probe amplifier. When differential is selected, the
:CHANnel<n>:OFFset command changes the offset value of the channel
amplifier.
Query Syntax
:CHANnel<n>:PROBe:STYPe?
The :CHANnel<n>:PROBe:STYPe? query returns the current probe signal
type setting for the selected channel.
Return Format
<signal type><NL>
<signal type> ::= {DIFF | SING}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:OFFSet" on page 238
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
243
5
Commands by Subsystem
:CHANnel<n>:PROTection
(see page 798)
Command Syntax
:CHANnel<n>:PROTection[:CLEar]
<n> ::= {1 | 2 | 3 | 4}
When the analog channel input impedance is set to 50Ω (on the 300 MHz,
500 MHz, and 1 GHz bandwidth oscilloscope models), the input channels
are protected against overvoltage. When an overvoltage condition is sensed,
the input impedance for the channel is automatically changed to 1 MΩ.
The :CHANnel<n>:PROTection[:CLEar] command is used to clear (reset) the
overload protection. It allows the channel to be used again in 50Ω mode
after the signal that caused the overload has been removed from the
channel input. Reset the analog channel input impedance to 50Ω (see
":CHANnel<n>:IMPedance" on page 235) after clearing the overvoltage
protection.
Query Syntax
:CHANnel<n>:PROTection?
The :CHANnel<n>:PROTection query returns the state of the input
protection for CHANnel<n>. If a channel input has experienced an
overload, TRIP (tripped) will be returned; otherwise NORM (normal) is
returned.
Return Format
See Also
{NORM | TRIP}<NL>
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:COUPling" on page 233
• ":CHANnel<n>:IMPedance" on page 235
• ":CHANnel<n>:PROBe" on page 239
244
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n>:RANGe
(see page 798)
Command Syntax
:CHANnel<n>:RANGe <range>[<suffix>]
<range> ::= vertical full-scale range value in NR3 format
<suffix> ::= {V | mV}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:RANGe command defines the full- scale vertical axis of
the selected channel. When using 1:1 probe attenuation, legal values for
the range are shown in the following table.
Table 60 Vertical Range Values with 1:1 Probe Attenuation
Models
Input Impedance
1 MΩ
50 Ω
DSO/MSO601xA/L
8 mV to 40 V
n/a
DSO/MSO603xA
16 mV to 40 V
16 mV to 40 V
DSO/MSO605xA/L
16 mV to 40 V
16 mV to 40 V
DSO/MSO610xA/L
16 mV to 40 V
16 mV to 8 V
If the probe attenuation is changed, the range value is multiplied by the
probe attenuation factor.
Query Syntax
:CHANnel<n>:RANGe?
The :CHANnel<n>:RANGe? query returns the current full- scale range
setting for the specified channel.
Return Format
<range_argument><NL>
<range_argument> ::= vertical full-scale range value in NR3 format
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:SCALe" on page 246
• ":CHANnel<n>:PROBe" on page 239
Example Code
' CHANNEL_RANGE - Sets the full scale vertical range in volts. The
' range value is 8 times the volts per division.
myScope.WriteString ":CHANNEL1:RANGE 8"
' Set the vertical range to
8 volts.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
245
5
Commands by Subsystem
:CHANnel<n>:SCALe
(see page 798)
Command Syntax
:CHANnel<n>:SCALe <scale>[<suffix>]
<scale> ::= vertical units per division in NR3 format
<suffix> ::= {V | mV}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:SCALe command sets the vertical scale, or units per
division, of the selected channel. When using 1:1 probe attenuation, legal
values for the scale are shown in the following table.
Table 61 Vertical Scale Values with 1:1 Probe Attenuation
Models
Input Impedance
1 MΩ
50 Ω
DSO/MSO601xA/L
1 mV to 5 V
n/a
DSO/MSO603xA
2 mV to 5 V
2 mV to 5 V
DSO/MSO605xA/L
2 mV to 5 V
2 mV to 5 V
DSO/MSO610xA/L
2 mV to 5 V
2 mV to 1 V
If the probe attenuation is changed, the scale value is multiplied by the
probe's attenuation factor.
Query Syntax
:CHANnel<n>:SCALe?
The :CHANnel<n>:SCALe? query returns the current scale setting for the
specified channel.
Return Format
<scale value><NL>
<scale value> ::= vertical units per division in NR3 format
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:PROBe" on page 239
246
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:CHANnel<n>:UNITs
(see page 798)
Command Syntax
:CHANnel<n>:UNITs <units>
<units> ::= {VOLT | AMPere}
<n> ::= {1 | 2} for the two channel oscilloscope models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
The :CHANnel<n>:UNITs command sets the measurement units for the
connected probe. Select VOLT for a voltage probe and select AMPere for a
current probe. Measurement results, channel sensitivity, and trigger level
will reflect the measurement units you select.
Query Syntax
:CHANnel<n>:UNITs?
The :CHANnel<n>:UNITs? query returns the current units setting for the
specified channel.
Return Format
<units><NL>
<units> ::= {VOLT | AMP}
See Also
• "Introduction to :CHANnel<n> Commands" on page 230
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:PROBe" on page 239
• ":EXTernal:UNITs" on page 275
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
247
5
Commands by Subsystem
:CHANnel<n>:VERNier
(see page 798)
Command Syntax
:CHANnel<n>:VERNier <vernier value>
<vernier value> ::= {{1 | ON} | {0 | OFF}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:VERNier command specifies whether the channel's
vernier (fine vertical adjustment) setting is ON (1) or OFF (0).
Query Syntax
:CHANnel<n>:VERNier?
The :CHANnel<n>:VERNier? query returns the current state of the
channel's vernier setting.
Return Format
<vernier value><NL>
<vernier value> ::= {0 | 1}
See Also
248
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DIGital<n> Commands
Control all oscilloscope functions associated with individual digital
channels. See "Introduction to :DIGital<n> Commands" on page 249.
Table 62 :DIGital<n> Commands Summary
Command
Query
Options and Query Returns
:DIGital<n>:DISPlay
{{0 | OFF} | {1 |
ON}} (see page 251)
:DIGital<n>:DISPlay?
(see page 251)
{0 | 1}
<n> ::= 0-15; an integer in NR1
format
:DIGital<n>:LABel
<string> (see
page 252)
:DIGital<n>:LABel?
(see page 252)
<string> ::= any series of 10 or
less ASCII characters enclosed in
quotation marks
<n> ::= 0-15; an integer in NR1
format
:DIGital<n>:POSition
<position> (see
page 253)
:DIGital<n>:POSition?
(see page 253)
<n> ::= 0-15; an integer in NR1
format
<position> ::= 0-7 if display
size = large, 0-15 if size =
medium, 0-31 if size = small
:DIGital<n>:SIZE
<value> (see
page 254)
:DIGital<n>:SIZE?
(see page 254)
<value> ::= {SMALl | MEDium |
LARGe}
:DIGital<n>:THReshold
<value>[suffix] (see
page 255)
:DIGital<n>:THReshold
? (see page 255)
<n> ::= 0-15; an integer in NR1
format
<value> ::= {CMOS | ECL | TTL |
<user defined value>}
<user defined value> ::= value in
NR3 format from -8.00 to +8.00
[suffix] ::= {V | mV | uV}
Introduction to
:DIGital<n>
Commands
NOTE
<n> ::= {0,..,15}
The DIGital subsystem commands control the viewing, labeling, and
positioning of digital channels. They also control threshold settings for
groups of digital channels (D0- D7, D8- D15).
These commands are only valid for the MSO models.
Reporting the Setup
Use :DIGital<n>? to query setup information for the DIGital subsystem.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
249
5
Commands by Subsystem
Return Format
The following is a sample response from the :DIGital0? query. In this case,
the query was issued following a *RST command.
:DIG0:DISP 0;THR +1.40E+00;LAB 'D0';POS +0
250
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DIGital<n>:DISPlay
(see page 798)
Command Syntax
:DIGital<n>:DISPlay <display>
<display> ::= {{1 | ON} | {0 | OFF}}
<n> ::= An integer, 0, 1,..,15, is attached as a suffix to the command
and defines the logic channel that is affected by the command.
The :DIGital<n>:DISPlay command turns digital display on or off for the
specified channel.
NOTE
Query Syntax
This command is only valid for the MSO models.
:DIGital<n>:DISPlay?
The :DIGital<n>:DISPlay? query returns the current digital display setting
for the specified channel.
Return Format
<display><NL>
<display> ::= {0 | 1}
See Also
• "Introduction to :DIGital<n> Commands" on page 249
• ":POD<n>:DISPlay" on page 405
• ":CHANnel<n>:DISPlay" on page 234
• ":VIEW" on page 192
• ":BLANk" on page 160
• ":STATus" on page 189
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
251
5
Commands by Subsystem
:DIGital<n>:LABel
(see page 798)
Command Syntax
:DIGital<n>:LABel <string>
<string> ::= any series of 10 or less characters as quoted ASCII string.
<n> ::= An integer, 0,..,15, is attached as a suffix to the command and
defines the logic channel that is affected by the command.
The :DIGital<n>:LABel command sets the channel label to the string that
follows. Setting a label for a channel also adds the name to the label list
in non- volatile memory (replacing the oldest label in the list).
NOTE
This command is only valid for the MSO models.
NOTE
Label strings are 10 characters or less, and may contain any commonly used ASCII
characters. Labels with more than 10 characters are truncated to 10 characters.
Query Syntax
:DIGital<n>:LABel?
The :DIGital<n>:LABel? query returns the name of the specified channel.
Return Format
<label string><NL>
<label string> ::= any series of 10 or less characters as a quoted
ASCII string.
See Also
• "Introduction to :DIGital<n> Commands" on page 249
• ":CHANnel<n>:LABel" on page 237
• ":DISPlay:LABList" on page 262
• ":BUS<n>:LABel" on page 217
252
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DIGital<n>:POSition
(see page 798)
Command Syntax
:DIGital<n>:POSition <position>
<position> ::= integer in NR1 format.
<n> ::= An integer, 0, 1,..,15, is attached as a suffix to the command
and defines the logic channel that is affected by the command.
Channel Size
Position
Top
Bottom
Large
0-7
7
0
Medium
0-15
15
0
Small
0-31
31
0
The :DIGital<n>:POSition command sets the position of the specified
channel.
NOTE
Query Syntax
This command is only valid for the MSO models.
:DIGital<n>:POSition?
The :DIGital<n>:POSition? query returns the position of the specified
channel.
Return Format
<position><NL>
<position> ::= integer in NR1 format.
See Also
• "Introduction to :DIGital<n> Commands" on page 249
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
253
5
Commands by Subsystem
:DIGital<n>:SIZE
(see page 798)
Command Syntax
:DIGital<n>:SIZE <value>
<n> ::= An integer, 0, 1,..,15, is attached as a suffix to the command
and defines the logic channel that is affected by the command.
<value> ::= {SMALl | MEDium | LARGe}
The :DIGital<n>:SIZE command specifies the size of digital channels on the
display. Sizes are set for all digital channels. Therefore, if you set the size
on digital channel 0 (for example), the same size is set on channels 1
through 15 as well.
NOTE
Query Syntax
This command is only valid for the MSO models.
:DIGital<n>:SIZE?
The :DIGital<n>:SIZE? query returns the size setting for the specified
digital channels.
Return Format
<size_value><NL>
<size_value> ::= {SMAL | MED | LARG}
See Also
• "Introduction to :DIGital<n> Commands" on page 249
• ":POD<n>:SIZE" on page 406
• ":DIGital<n>:POSition" on page 253
254
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DIGital<n>:THReshold
(see page 798)
Command Syntax
:DIGital<n>:THReshold <value>
<value> ::= {CMOS | ECL | TTL | <user defined value>[<suffix>]}
<user defined value> ::= -8.00 to +8.00 in NR3 format
<suffix> ::= {V | mV | uV}
<n> ::= An integer, 0, 1,..,15, is attached as a suffix to the command
and defines the logic channel that is affected by the command.
• TTL = 1.4V
• CMOS = 2.5V
• ECL = - 1.3V
The :DIGital<n>:THReshold command sets the logic threshold value for all
channels grouped with the specified channel (D0- D7, D8- D15). The
threshold is used for triggering purposes and for displaying the digital
data as high (above the threshold) or low (below the threshold).
NOTE
Query Syntax
This command is only valid for the MSO models.
:DIGital<n>:THReshold?
The :DIGital<n>:THReshold? query returns the threshold value for the
specified channel.
Return Format
<value><NL>
<value> ::= threshold value in NR3 format
See Also
• "Introduction to :DIGital<n> Commands" on page 249
• ":POD<n>:THReshold" on page 407
• ":TRIGger[:EDGE]:LEVel" on page 513
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
255
5
Commands by Subsystem
:DISPlay Commands
Control how waveforms, graticule, and text are displayed and written on
the screen. See "Introduction to :DISPlay Commands" on page 256.
Table 63 :DISPlay Commands Summary
Command
Query
Options and Query Returns
:DISPlay:CLEar (see
page 258)
n/a
n/a
:DISPlay:DATA
[<format>][,][<area>]
[,][<palette>]<displa
y data> (see
page 259)
:DISPlay:DATA?
[<format>][,][<area>]
[,][<palette>] (see
page 259)
<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
:DISPlay:LABel {{0 |
OFF} | {1 | ON}} (see
page 261)
:DISPlay:LABel? (see
page 261)
{0 | 1}
:DISPlay:LABList
<binary block> (see
page 262)
:DISPlay:LABList?
(see page 262)
<binary block> ::= an ordered
list of up to 75 labels, each 10
characters maximum, separated by
newline characters
:DISPlay:PERSistence
<value> (see
page 263)
:DISPlay:PERSistence?
(see page 263)
<value> ::= {MINimum | INFinite}}
:DISPlay:SOURce
<value> (see
page 264)
:DISPlay:SOURce? (see
page 264)
<value> ::= {PMEMory{0 | 1 | 2 |
3 | 4 | 5 | 6 | 7 | 8 | 9}}
:DISPlay:VECTors {{1
| ON} | {0 | OFF}}
(see page 265)
:DISPlay:VECTors?
(see page 265)
{1 | 0}
Introduction to
:DISPlay
Commands
The DISPlay subsystem is used to control the display storage and retrieval
of waveform data, labels, and text. This subsystem allows the following
actions:
• Clear the waveform area on the display.
• Turn vectors on or off.
256
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
• Set waveform persistence.
• Specify labels.
• Save and Recall display data.
Reporting the Setup
Use :DISPlay? to query the setup information for the DISPlay subsystem.
Return Format
The following is a sample response from the :DISPlay? query. In this case,
the query was issued following a *RST command.
:DISP:LAB 0;CONN 1;PERS MIN;SOUR PMEM9
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
257
5
Commands by Subsystem
:DISPlay:CLEar
(see page 798)
Command Syntax
:DISPlay:CLEar
The :DISPlay:CLEar 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 of the data for active channels
and functions is erased; however, new data is displayed on the next
acquisition.
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":CDISplay" on page 161
258
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:DISPlay:DATA
(see page 798)
Command Syntax
:DISPlay:DATA [<format>][,][<area>][,][<palette>]<display data>
<format> ::= {TIFF}
<area> ::= {GRATicule}
<palette> ::= {MONochrome}
<display data> ::= binary block data in IEEE-488.2 # format.
The :DISPlay:DATA command writes trace memory data (a display bitmap)
to the display or to one of the trace memories in the instrument.
If a data format or area is specified, the :DISPlay:DATA command
transfers the data directly to the display. If neither the data format nor
the area is specified, the command transfers data to the trace memory
specified by the :DISPlay:SOURce command. Available trace memories are
PMEMory0- 9 and these memories correspond to the INTERN_0- 9 files in
the front panel Save/Recall menu.
Graticule data is a low resolution bitmap of the graticule area in TIFF
format. This is the same data saved using the front panel Save/Recall
menu or the *SAV (Save) command.
Query Syntax
:DISPlay:DATA? [<format>][,] [<area>][,] [<palette>]
<format> ::= {TIFF | BMP | BMP8bit | PNG}
<area> ::= {GRATicule | SCReen}
<palette> ::= {MONochrome | GRAYscale | COLor}
The :DISPlay:DATA? query reads display data from the screen or from one
of the trace memories in the instrument. The format for the data
transmission is the # format defined in the IEEE 488.2 specification.
If a data format or area is specified, the :DISPlay:DATA query transfers
the data directly from the display. If neither the data format nor the area
is specified, the query transfers data from the trace memory specified by
the :DISPlay:SOURce command.
Screen data is the full display and is high resolution in grayscale or color.
The :HARDcopy:INKSaver setting also affects the screen data. It may be
read from the instrument in 24- bit bmp, 8- bit bmp, or 24- bit png format.
This data cannot be sent back to the instrument.
Graticule data is a low resolution bitmap of the graticule area in TIFF
format. You can get this data and send it back to the oscilloscope.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
259
5
Commands by Subsystem
NOTE
If the format is TIFF, the only valid value area parameter is GRATicule, and the only valid
palette parameter is MONOchrome.
If the format is something other than TIFF, the only valid area parameter is SCReen, and the
only valid values for palette are GRAYscale or COLor.
Return Format
<display data><NL>
<display data> ::= binary block data in IEEE-488.2 # format.
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":DISPlay:SOURce" on page 264
• ":HARDcopy:INKSaver" on page 299
• ":MERGe" on page 170
• ":PRINt" on page 185
• "*RCL (Recall)" on page 139
• "*SAV (Save)" on page 143
• ":VIEW" on page 192
Example Code
' IMAGE_TRANSFER - In this example, we will query for the image data
' with ":DISPLAY:DATA?", read the data, and then save it to a file.
Dim byteData() As Byte
myScope.IO.Timeout = 15000
myScope.WriteString ":DISPLAY:DATA? BMP, SCREEN, COLOR"
byteData = myScope.ReadIEEEBlock(BinaryType_UI1)
' Output display data to a file:
strPath = "c:\scope\data\screen.bmp"
' Remove file if it exists.
If Len(Dir(strPath)) Then
Kill strPath
End If
Close #1
' If #1 is open, close it.
Open strPath For Binary Access Write Lock Write As #1
' Open file f
or output.
Put #1, , byteData
' Write data.
Close #1
' Close file.
myScope.IO.Timeout = 5000
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
260
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DISPlay:LABel
(see page 798)
Command Syntax
:DISPlay:LABel <value>
<value> ::= {{1 | ON} | {0 | OFF}}
The :DISPlay:LABel command turns the analog and digital channel labels
on and off.
Query Syntax
:DISPlay:LABel?
The :DISPlay:LABel? query returns the display mode of the analog and
digital labels.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":CHANnel<n>:LABel" on page 237
Example Code
' DISP_LABEL (not executed in this example)
' - Turns label names ON or OFF on the analyzer display.
myScope.WriteString ":DISPLAY:LABEL ON"
' Turn on labels.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
261
5
Commands by Subsystem
:DISPlay:LABList
(see page 798)
Command Syntax
:DISPlay:LABList <binary block data>
<binary block> ::= an ordered list of up to 75 labels, a maximum of 10
characters each, separated by newline characters.
The :DISPlay:LABList command adds labels to the label list. Labels are
added in alphabetical order.
NOTE
Query Syntax
Labels that begin with the same alphabetic base string followed by decimal digits are
considered duplicate labels. Duplicate labels are not added to the label list. For example, if
label "A0" is in the list and you try to add a new label called "A123456789", the new label is
not added.
:DISPlay:LABList?
The :DISPlay:LABList? query returns the label list.
Return Format
<binary block><NL>
<binary block> ::= an ordered list of up to 75 labels, a maximum of 10
characters each, separated by newline characters.
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":DISPlay:LABel" on page 261
• ":CHANnel<n>:LABel" on page 237
• ":DIGital<n>:LABel" on page 252
• ":BUS<n>:LABel" on page 217
262
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DISPlay:PERSistence
(see page 798)
Command Syntax
:DISPlay:PERSistence <value>
<value> ::= {MINimum | INFinite}
The :DISPlay:PERSistence command specifies the persistence setting.
MINimum indicates zero persistence and INFinite indicates infinite
persistence. Use the :DISPlay:CLEar or :CDISplay root command to erase
points stored by infinite persistence.
Query Syntax
:DISPlay:PERSistence?
The :DISPlay:PERSistence? query returns the specified persistence value.
Return Format
<value><NL>
<value> ::= {MIN | INF}
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":DISPlay:CLEar" on page 258
• ":CDISplay" on page 161
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
263
5
Commands by Subsystem
:DISPlay:SOURce
(see page 798)
Command Syntax
:DISPlay:SOURce <value>
<value> ::= {PMEMory0 | PMEMory1 | PMEMory2 | PMEMory3 | PMEMory4
| PMEMory5 | PMEMory6 | PMEMory7 | PMEMory8 | PMEMory9}
PMEMory0-9 ::= pixel memory 0 through 9
The :DISPlay:SOURce command specifies the default source and
destination for the :DISPlay:DATA command and query. PMEMory0- 9
correspond to the INTERN_0- 9 files found in the front panel Save/Recall
menu.
Query Syntax
:DISPlay:SOURce?
The :DISPlay:SOURce? query returns the specified SOURce.
Return Format
<value><NL>
<value> ::= {PMEM0 | PMEM1 | PMEM2 | PMEM3 | PMEM4 | PMEM5 | PMEM6
| PMEM7 | PMEM8 | PMEM9}
See Also
• "Introduction to :DISPlay Commands" on page 256
• ":DISPlay:DATA" on page 259
264
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:DISPlay:VECTors
(see page 798)
Command Syntax
:DISPlay:VECTors <vectors>
<vectors> ::= {{1 | ON} | {0 | OFF}}
The :DISPlay:VECTors command turns vector display on or off. When
vectors are turned on, the oscilloscope displays lines connecting sampled
data points. When vectors are turned off, only the sampled data is
displayed.
Query Syntax
:DISPlay:VECTors?
The :DISPlay:VECTors? query returns whether vector display is on or off.
Return Format
<vectors><NL>
<vectors> ::= {1 | 0}
See Also
• "Introduction to :DISPlay Commands" on page 256
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
265
5
Commands by Subsystem
:EXTernal Trigger Commands
Control the input characteristics of the external trigger input. See
"Introduction to :EXTernal Trigger Commands" on page 266.
Table 64 :EXTernal Trigger Commands Summary
Command
Query
Options and Query Returns
:EXTernal:BWLimit
<bwlimit> (see
page 268)
:EXTernal:BWLimit?
(see page 268)
<bwlimit> ::= {0 | OFF}
:EXTernal:IMPedance
<value> (see
page 269)
:EXTernal:IMPedance?
(see page 269)
<impedance> ::= {ONEMeg | FIFTy}
:EXTernal:PROBe
<attenuation> (see
page 270)
:EXTernal:PROBe? (see
page 270)
<attenuation> ::= probe
attenuation ratio in NR3 format
n/a
:EXTernal:PROBe:ID?
(see page 271)
<probe id> ::= unquoted ASCII
string up to 11 characters
:EXTernal:PROBe:STYPe
<signal type> (see
page 272)
:EXTernal:PROBe:STYPe
? (see page 272)
<signal type> ::= {DIFFerential |
SINGle}
:EXTernal:PROTection[
:CLEar] (see
page 273)
:EXTernal:PROTection?
(see page 273)
{NORM | TRIP}
:EXTernal:RANGe
<range>[<suffix>]
(see page 274)
:EXTernal:RANGe? (see
page 274)
<range> ::= vertical full-scale
range value in NR3 format
<suffix> ::= {V | mV}
:EXTernal:UNITs
<units> (see
page 275)
:EXTernal:UNITs? (see
page 275)
<units> ::= {VOLT | AMPere}
Introduction to
:EXTernal Trigger
Commands
The EXTernal trigger subsystem commands control the input
characteristics of the external trigger input. The probe factor, impedance,
input range, input protection state, units, and bandwidth limit settings
may all be queried. Depending on the instrument type, some settings may
be changeable.
Reporting the Setup
Use :EXTernal? to query setup information for the EXTernal subsystem.
Return Format
266
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
The following is a sample response from the :EXTernal query. In this case,
the query was issued following a *RST command.
:EXT:BWL 0;IMP ONEM;RANG +8.0E+00;UNIT VOLT;PROB +1.0E+00;PROB:STYP SING
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
267
5
Commands by Subsystem
:EXTernal:BWLimit
(see page 798)
Command Syntax
:EXTernal:BWLimit <bwlimit>
<bwlimit> ::= {0 | OFF}
The :EXTernal:BWLimit command is provided for product compatibility.
The only legal value is 0 or OFF. Use the :TRIGger:HFReject command to
limit bandwidth on the external trigger input.
Query Syntax
:EXTernal:BWLimit?
The :EXTernal:BWLimit? query returns the current setting of the low- pass
filter (always 0).
Return Format
<bwlimit><NL>
<bwlimit> ::= 0
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:HFReject" on page 483
268
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:EXTernal:IMPedance
(see page 798)
Command Syntax
:EXTernal:IMPedance <value>
<value> ::= {ONEMeg | FIFTy}
The :EXTernal:IMPedance command selects the input impedance setting for
the external trigger. The legal values for this command are ONEMeg
(1 MΩ) and FIFTy (50Ω).
NOTE
Query Syntax
You can set external trigger input impedance to FIFTy (50Ω) on the 2-channel, 300 MHz,
500 MHz, and 1 GHz bandwidth oscilloscope models.
:EXTernal:IMPedance?
The :EXTernal:IMPedance? query returns the current input impedance
setting for the external trigger.
Return Format
<impedance value><NL>
<impedance value> ::= {ONEM | FIFT}
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• "Introduction to :TRIGger Commands" on page 479
• ":CHANnel<n>:IMPedance" on page 235
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
269
5
Commands by Subsystem
:EXTernal:PROBe
(see page 798)
Command Syntax
:EXTernal:PROBe <attenuation>
<attenuation> ::= probe attenuation ratio in NR3 format
The :EXTernal:PROBe command specifies the probe attenuation factor for
the external trigger. The probe attenuation factor may be 0.1 to 1000. This
command does not change the actual input sensitivity of the oscilloscope.
It changes the reference constants for scaling the display factors and for
setting trigger levels.
If an AutoProbe probe is connected to the oscilloscope, the attenuation
value cannot be changed from the sensed value. Attempting to set the
oscilloscope to an attenuation value other than the sensed value produces
an error.
Query Syntax
:EXTernal:PROBe?
The :EXTernal:PROBe? query returns the current probe attenuation factor
for the external trigger.
Return Format
<attenuation><NL>
<attenuation> ::= probe attenuation ratio in NR3 format
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• ":EXTernal:RANGe" on page 274
• "Introduction to :TRIGger Commands" on page 479
• ":CHANnel<n>:PROBe" on page 239
270
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:EXTernal:PROBe:ID
(see page 798)
Query Syntax
:EXTernal:PROBe:ID?
The :EXTernal:PROBe:ID? query returns the type of probe attached to the
external trigger input.
Return Format
<probe id><NL>
<probe id> ::= unquoted ASCII string up to 11 characters
Some of the possible returned values are:
• 1131A
• 1132A
• 1134A
• 1147A
• 1153A
• 1154A
• 1156A
• 1157A
• 1158A
• 1159A
• AutoProbe
• E2621A
• E2622A
• E2695A
• E2697A
• HP1152A
• HP1153A
• NONE
• Probe
• Unknown
• Unsupported
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
271
5
Commands by Subsystem
:EXTernal:PROBe:STYPe
(see page 798)
Command Syntax
NOTE
This command is valid only for the 113xA Series probes.
:EXTernal:PROBe:STYPe <signal type>
<signal type> ::= {DIFFerential | SINGle}
The :EXTernal:PROBe:STYPe command sets the external trigger probe
signal type (STYPe) to differential or single- ended when using the 113xA
Series probes and determines how offset is applied.
Query Syntax
:EXTernal:PROBe:STYPe?
The :EXTernal:PROBe:STYPe? query returns the current probe signal type
setting for the external trigger.
Return Format
<signal type><NL>
<signal type> ::= {DIFF | SING}
See Also
272
• "Introduction to :EXTernal Trigger Commands" on page 266
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:EXTernal:PROTection
(see page 798)
Command Syntax
:EXTernal:PROTection[:CLEar]
When the external trigger input impedance is set to 50Ω (on the
2- channel, 300 MHz, 500 MHz, and 1 GHz bandwidth oscilloscope models),
the external trigger input is protected against overvoltage. When an
overvoltage condition is sensed, the input impedance for the external
trigger is automatically changed to 1 MΩ. The
:EXTernal:PROTection[:CLEar] command is used to clear (reset) the
overload protection. It allows the external trigger to be used again in 50Ω
mode after the signal that caused the overload has been removed from the
external trigger input. Reset the external trigger input impedance to 50Ω
(see ":EXTernal:IMPedance" on page 269) after clearing the overvoltage
protection.
Query Syntax
:EXTernal:PROTection?
The :EXTernal:PROTection query returns the state of the input protection
for external trigger. If the external trigger input has experienced an
overload, TRIP (tripped) will be returned; otherwise NORM (normal) is
returned.
Return Format
See Also
{NORM | TRIP}<NL>
• "Introduction to :EXTernal Trigger Commands" on page 266
• ":EXTernal:IMPedance" on page 269
• ":EXTernal:PROBe" on page 270
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
273
5
Commands by Subsystem
:EXTernal:RANGe
(see page 798)
Command Syntax
:EXTernal:RANGe <range>[<suffix>]
<range> ::= vertical full-scale range value in NR3 format
<suffix> ::= {V | mV}
The :EXTernal:RANGe command is provided for product compatibility.
When using 1:1 probe attenuation:
• In 2- channel models, the range can be set to 1.0 V or 8.0 V.
• In 4- channel models, the range can only be set to 5.0 V.
If the probe attenuation is changed, the range value is multiplied by the
probe attenuation factor.
Query Syntax
:EXTernal:RANGe?
The :EXTernal:RANGe? query returns the current full- scale range setting
for the external trigger.
Return Format
<range_argument><NL>
<range_argument> ::= external trigger range value in NR3 format
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• ":EXTernal:PROBe" on page 270
• "Introduction to :TRIGger Commands" on page 479
274
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:EXTernal:UNITs
(see page 798)
Command Syntax
:EXTernal:UNITs <units>
<units> ::= {VOLT | AMPere}
The :EXTernal:UNITs command sets the measurement units for the probe
connected to the external trigger input. Select VOLT for a voltage probe
and select AMPere for a current probe. Measurement results, channel
sensitivity, and trigger level will reflect the measurement units you select.
Query Syntax
:EXTernal:UNITs?
The :CHANnel<n>:UNITs? query returns the current units setting for the
external trigger.
Return Format
<units><NL>
<units> ::= {VOLT | AMP}
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• "Introduction to :TRIGger Commands" on page 479
• ":EXTernal:RANGe" on page 274
• ":EXTernal:PROBe" on page 270
• ":CHANnel<n>:UNITs" on page 247
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
275
5
Commands by Subsystem
:FUNCtion Commands
Control functions in the measurement/storage module. See "Introduction to
:FUNCtion Commands" on page 278.
Table 65 :FUNCtion Commands Summary
Command
Query
Options and Query Returns
:FUNCtion:CENTer
<frequency> (see
page 279)
:FUNCtion:CENTer?
(see page 279)
<frequency> ::= the current
center frequency in NR3 format.
The range of legal values is from
0 Hz to 25 GHz.
:FUNCtion:DISPlay {{0
| OFF} | {1 | ON}}
(see page 280)
:FUNCtion:DISPlay?
(see page 280)
{0 | 1}
:FUNCtion:GOFT:OPERat
ion <operation> (see
page 281)
:FUNCtion:GOFT:OPERat
ion? (see page 281)
<operation> ::= {ADD | SUBTract |
MULTiply}
:FUNCtion:GOFT:SOURce
1 <source> (see
page 282)
:FUNCtion:GOFT:SOURce
1? (see page 282)
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
:FUNCtion:GOFT:SOURce
2 <source> (see
page 283)
:FUNCtion:GOFT:SOURce
2? (see page 283)
<source> ::= CHANnel<n>
<n> ::= {{1 | 2} | {3 | 4}} for
4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
:FUNCtion:OFFSet
<offset> (see
page 284)
:FUNCtion:OFFSet?
(see page 284)
<offset> ::= the value at center
screen in NR3 format.
The range of legal values is
+/-10 times the current
sensitivity of the selected
function.
:FUNCtion:OPERation
<operation> (see
page 285)
:FUNCtion:OPERation?
(see page 285)
<operation> ::= {ADD | SUBTract |
MULTiply | INTegrate |
DIFFerentiate | FFT | SQRT}
276
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 65 :FUNCtion Commands Summary (continued)
Command
Query
Options and Query Returns
:FUNCtion:RANGe
<range> (see
page 286)
:FUNCtion:RANGe? (see
page 286)
<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.
:FUNCtion:REFerence
<level> (see
page 287)
:FUNCtion:REFerence?
(see page 287)
<level> ::= the value at center
screen in NR3 format.
The range of legal values is
+/-10 times the current
sensitivity of the selected
function.
:FUNCtion:SCALe
<scale
value>[<suffix>] (see
page 288)
:FUNCtion:SCALe? (see
page 288)
<scale value> ::= integer in NR1
format
<suffix> ::= {V | dB}
:FUNCtion:SOURce1
<source> (see
page 289)
:FUNCtion:SOURce1?
(see page 289)
<source> ::= {CHANnel<n> | GOFT}
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
GOFT is only for FFT, INTegrate,
DIFFerentiate, and SQRT
operations.
:FUNCtion:SOURce2
<source> (see
page 290)
:FUNCtion:SOURce2?
(see page 290)
<source> ::= {CHANnel<n> | NONE}
<n> ::= {{1 | 2} | {3 | 4}} for
4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
:FUNCtion:SPAN <span>
(see page 291)
:FUNCtion:SPAN? (see
page 291)
<span> ::= the current frequency
span in NR3 format.
Legal values are 1 Hz to 100 GHz.
:FUNCtion:WINDow
<window> (see
page 292)
:FUNCtion:WINDow?
(see page 292)
<window> ::= {RECTangular |
HANNing | FLATtop | BHARris}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
277
5
Commands by Subsystem
Introduction to
:FUNCtion
Commands
The FUNCtion subsystem controls the math functions in the oscilloscope.
Add, subtract, multiply, differentiate, integrate, square root, and FFT (Fast
Fourier Transform) operations are available. These math operations only
use the analog (vertical) channels.
The SOURce1, DISPlay, RANGe, and OFFSet commands apply to any
function. The SPAN, CENTer, and WINDow commands are only useful for
FFT functions. When FFT is selected, the cursors change from volts and
time to decibels (dB) and frequency (Hz).
Reporting the Setup
Use :FUNCtion? to query setup information for the FUNCtion subsystem.
Return Format
The following is a sample response from the :FUNCtion? queries. In this
case, the query was issued following a *RST command.
:FUNC:OPER ADD;DISP 0;SOUR1 CHAN1;SOUR2 CHAN2;RANG +8.00E+00;OFFS
+0.0E+00;:FUNC:GOFT:OPER ADD;SOUR1 CHAN1;SOUR2 CHAN2
278
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:FUNCtion:CENTer
(see page 798)
Command Syntax
:FUNCtion:CENTer <frequency>
<frequency> ::= the current center frequency in NR3 format.
of legal values is from 0 Hz to 25 GHz.
The range
The :FUNCtion:CENTer command sets the center frequency when FFT
(Fast Fourier Transform) is selected.
Query Syntax
:FUNCtion:CENTer?
The :FUNCtion:CENTer? query returns the current center frequency in
Hertz.
Return Format
<frequency><NL>
<frequency> ::= the current center frequency in NR3 format.
of legal values is from 0 Hz to 25 GHz.
NOTE
See Also
The range
After a *RST (Reset) or :AUToscale command, the values returned by the
:FUNCtion:CENTer? and :FUNCtion:SPAN? queries depend on the current :TIMebase:RANGe
value. Once you change either the :FUNCtion:CENTer or :FUNCtion:SPAN value, they no
longer track the :TIMebase:RANGe value.
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:SPAN" on page 291
• ":TIMebase:RANGe" on page 471
• ":TIMebase:SCALe" on page 474
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
279
5
Commands by Subsystem
:FUNCtion:DISPlay
(see page 798)
Command Syntax
:FUNCtion:DISPlay <display>
<display> ::= {{1 | ON} | {0 | OFF}}
The :FUNCtion:DISPlay command turns the display of the function on or
off. When ON is selected, the function performs as specified using the
other FUNCtion commands. When OFF is selected, function is neither
calculated nor displayed.
Query Syntax
:FUNCtion:DISPlay?
The :FUNCtion:DISPlay? query returns whether the function display is on
or off.
Return Format
<display><NL>
<display> ::= {1 | 0}
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":VIEW" on page 192
• ":BLANk" on page 160
• ":STATus" on page 189
280
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:FUNCtion:GOFT:OPERation
(see page 798)
Command Syntax
:FUNCtion:GOFT:OPERation <operation>
<operation> ::= {ADD | SUBTract | MULTiply}
The :FUNCtion:GOFT:OPERation command sets the math operation for the
g(t) source that can be used as the input to the FFT, INTegrate,
DIFFerentiate, or SQRT functions:
• ADD — Source1 + source2.
• SUBTract — Source1 - source2.
• MULTiply — Source1 * source2.
The :FUNCtion:GOFT:SOURce1 and :FUNCtion:GOFT:SOURce2 commands
are used to select source1 and source2.
Query Syntax
:FUNCtion:GOFT:OPERation?
The :FUNCtion:GOFT:OPERation? query returns the current g(t) source
operation setting.
Return Format
<operation><NL>
<operation> ::= {ADD | SUBT | MULT}
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:GOFT:SOURce2" on page 283
• ":FUNCtion:SOURce1" on page 289
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
281
5
Commands by Subsystem
:FUNCtion:GOFT:SOURce1
(see page 798)
Command Syntax
:FUNCtion:GOFT:SOURce1 <value>
<value> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for 4ch models
<n> ::= {1 | 2} for 2ch models
The :FUNCtion:GOFT:SOURce1 command selects the first input channel for
the g(t) source that can be used as the input to the FFT, INTegrate,
DIFFerentiate, or SQRT functions.
Query Syntax
:FUNCtion:GOFT:SOURce1?
The :FUNCtion:GOFT:SOURce1? query returns the current selection for the
first input channel for the g(t) source.
Return Format
<value><NL>
<value> ::= CHAN<n>
<n> ::= {1 | 2 | 3 | 4} for the 4ch models
<n> ::= {1 | 2} for the 2ch models
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:GOFT:SOURce2" on page 283
• ":FUNCtion:GOFT:OPERation" on page 281
282
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:FUNCtion:GOFT:SOURce2
(see page 798)
Command Syntax
:FUNCtion:GOFT:SOURce2 <value>
<value> ::= CHANnel<n>
<n> ::= {{1 | 2} | {3 | 4}} for 4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
The :FUNCtion:GOFT:SOURce2 command selects the second input channel
for the g(t) source that can be used as the input to the FFT, INTegrate,
DIFFerentiate, or SQRT functions.
If CHANnel1 or CHANnel2 is selected for :FUNCtion:GOFT:SOURce1, the
SOURce2 selection can be CHANnel1 or CHANnel2. Likewise, if CHANnel3
or CHANnel4 is selected for :FUNCtion:GOFT:SOURce1, the SOURce2
selection can be CHANnel3 or CHANnel4.
Query Syntax
:FUNCtion:GOFT:SOURce2?
The :FUNCtion:GOFT:SOURce2? query returns the current selection for the
second input channel for the g(t) source.
Return Format
<value><NL>
<value> ::= CHAN<n>
<n> ::= {{1 | 2} | {3 | 4}} for 4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:GOFT:OPERation" on page 281
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
283
5
Commands by Subsystem
:FUNCtion:OFFSet
(see page 798)
Command Syntax
:FUNCtion:OFFSet <offset>
<offset> ::= the value at center screen in NR3 format.
The :FUNCtion:OFFSet command sets the voltage or vertical value
represented at center screen for the selected function. The range of legal
values is generally +/- 10 times the current scale of the selected function,
but will vary by function. If you set the offset to a value outside of the
legal range, the offset value is automatically set to the nearest legal value.
NOTE
Query Syntax
The :FUNCtion:OFFset command is equivalent to the :FUNCtion:REFerence command.
:FUNCtion:OFFSet?
The :FUNCtion:OFFSet? query outputs the current offset value for the
selected function.
Return Format
<offset><NL>
<offset> ::= the value at center screen in NR3 format.
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:RANGe" on page 286
• ":FUNCtion:REFerence" on page 287
• ":FUNCtion:SCALe" on page 288
284
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:FUNCtion:OPERation
(see page 798)
Command Syntax
:FUNCtion:OPERation <operation>
<operation> ::= {ADD | SUBTract | MULTiply | INTegrate | DIFFerentiate
| FFT | SQRT}
The :FUNCtion:OPERation command sets the desired waveform math
operation:
• ADD — Source1 + source2.
• SUBTract — Source1 - source2.
• MULTiply — Source1 * source2.
• INTegrate — Integrate the selected waveform source.
• DIFFerentiate — Differentiate the selected waveform source.
• FFT — Fast Fourier Transform on the selected waveform source.
• SQRT — Square root on the selected waveform source.
When the operation is ADD, SUBTract, or MULTiply, the
:FUNCtion:SOURce1 and :FUNCtion:SOURce2 commands are used to select
source1 and source2. For all other operations, the :FUNCtion:SOURce1
command selects the waveform source.
Query Syntax
:FUNCtion:OPERation?
The :FUNCtion:OPERation? query returns the current operation for the
selected function.
Return Format
<operation><NL>
<operation> ::= {ADD | SUBT | MULT | INT | DIFF | FFT | SQRT}
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:SOURce1" on page 289
• ":FUNCtion:SOURce2" on page 290
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
285
5
Commands by Subsystem
:FUNCtion:RANGe
(see page 798)
Command Syntax
:FUNCtion:RANGe <range>
<range> ::= the full-scale vertical axis value in NR3 format.
The :FUNCtion:RANGe command defines the full- scale vertical axis for the
selected function.
Query Syntax
:FUNCtion:RANGe?
The :FUNCtion:RANGe? query returns the current full- scale range value for
the selected function.
Return Format
<range><NL>
<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 (depends on sweep
speed).
The range for the DIFFerentiate function is 80E- 3 to 8.0E12 (depends on
sweep speed).
The range for the FFT (Fast Fourier Transform) function is 8 to 800 dBV.
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:SCALe" on page 288
286
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:FUNCtion:REFerence
(see page 798)
Command Syntax
:FUNCtion:REFerence <level>
<level> ::= the current reference level in NR3 format.
The :FUNCtion:REFerence command sets the voltage or vertical value
represented at center screen for the selected function. The range of legal
values is generally +/- 10 times the current scale of the selected function,
but will vary by function. If you set the reference level to a value outside
of the legal range, the level is automatically set to the nearest legal value.
NOTE
Query Syntax
The FUNCtion:REFerence command is equivalent to the :FUNCtion:OFFSet command.
:FUNCtion:REFerence?
The :FUNCtion:REFerence? query outputs the current reference level value
for the selected function.
Return Format
<level><NL>
<level> ::= the current reference level in NR3 format.
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:OFFSet" on page 284
• ":FUNCtion:RANGe" on page 286
• ":FUNCtion:SCALe" on page 288
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
287
5
Commands by Subsystem
:FUNCtion:SCALe
(see page 798)
Command Syntax
:FUNCtion:SCALe <scale value>[<suffix>]
<scale value> ::= integer in NR1 format
<suffix> ::= {V | dB}
The :FUNCtion:SCALe command sets the vertical scale, or units per
division, of the selected function. Legal values for the scale depend on the
selected function.
Query Syntax
:FUNCtion:SCALe?
The :FUNCtion:SCALe? query returns the current scale value for the
selected function.
Return Format
<scale value><NL>
<scale value> ::= integer in NR1 format
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:RANGe" on page 286
288
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:FUNCtion:SOURce1
(see page 798)
Command Syntax
:FUNCtion:SOURce1 <value>
<value> ::= {CHANnel<n> | GOFT}
<n> ::= {1 | 2 | 3 | 4} for 4ch models
<n> ::= {1 | 2} for 2ch models
The :FUNCtion:SOURce1 command is used for any :FUNCtion:OPERation
selection (including the ADD, SUBTract, or MULTiply channel math
operations and the FFT, INTegrate, DIFFerentiate, or SQRT transforms).
This command selects the first source for channel math operations or the
single source for the transforms.
The GOFT parameter is only available for the FFT, INTegrate,
DIFFerentiate, or SQRT functions. It lets you specify, as the function input
source, the addition, subtraction, or multiplication of two channels. When
GOFT is used, the g(t) source is specified by the
:FUNCtion:GOFT:OPERation, :FUNCtion:GOFT:SOURce1, and
:FUNCtion:GOFT:SOURce2 commands.
NOTE
Query Syntax
Another shorthand notation for SOURce1 in this command/query (besides SOUR1) is
SOUR.
:FUNCtion:SOURce1?
The :FUNCtion:SOURce1? query returns the current source1 for function
operations.
Return Format
<value><NL>
<value> ::= {CHAN<n> | GOFT}
<n> ::= {1 | 2 | 3 | 4} for 4ch models
<n> ::= {1 | 2} for 2ch models
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:OPERation" on page 285
• ":FUNCtion:GOFT:OPERation" on page 281
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:GOFT:SOURce2" on page 283
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
289
5
Commands by Subsystem
:FUNCtion:SOURce2
(see page 798)
Command Syntax
:FUNCtion:SOURce2 <value>
<value> ::= {CHANnel<n> | NONE}
<n> ::= {{1 | 2} | {3 | 4}} for 4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
The :FUNCtion:SOURce2 command is only used when an FFT (Fast Fourier
Transform), DIFF, or INT operation is selected (see
the:FUNCtion:OPERation command for more information about selecting an
operation). The :FUNCtion:SOURce2 command selects the source for
function operations. Choose CHANnel<n>, or ADD, SUBT, or MULT to
specify the desired source for function DIFFerentiate, INTegrate, and FFT
operations specified by the :FUNCtion:OPERation command.
If CHANnel1 or CHANnel2 is selected for :FUNCtion:SOURce1, the
SOURce2 selection can be CHANnel1 or CHANnel2. Likewise, if CHANnel3
or CHANnel4 is selected for :FUNCtion:SOURce1, the SOURce2 selection
can be CHANnel3 or CHANnel4.
Query Syntax
:FUNCtion:SOURce2?
The :FUNCtion:SOURce2? query returns the second source for function
operations on two waveforms.
Return Format
<value><NL>
<value> ::= {CHAN<n> | NONE}
<n> ::= {{1 | 2} | {3 | 4}} for 4ch models, depending on SOURce1
selection
<n> ::= {1 | 2} for 2ch models
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:OPERation" on page 285
290
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:FUNCtion:SPAN
(see page 798)
Command Syntax
:FUNCtion:SPAN <span>
<span> ::= the current frequency span in NR3 format. Legal values are
1 Hz to 100 GHz.
If you set the frequency span to a value outside of the legal range, the
step size is automatically set to the nearest legal value.
The :FUNCtion:SPAN command sets the frequency span of the display (left
graticule to right graticule) when FFT (Fast Fourier Transform) is selected.
Query Syntax
:FUNCtion:SPAN?
The :FUNCtion:SPAN? query returns the current frequency span in Hertz.
NOTE
Return Format
After a *RST (Reset) or :AUToscale command, the values returned by the
:FUNCtion:CENTer? and :FUNCtion:SPAN? queries depend on the current :TIMebase:RANGe
value. Once you change either the :FUNCtion:CENTer or :FUNCtion:SPAN value, they no
longer track the :TIMebase:RANGe value.
<span><NL>
<span> ::= the current frequency span in NR3 format. Legal values are 1
Hz to 100 GHz.
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:CENTer" on page 279
• ":TIMebase:RANGe" on page 471
• ":TIMebase:SCALe" on page 474
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
291
5
Commands by Subsystem
:FUNCtion:WINDow
(see page 798)
Command Syntax
:FUNCtion:WINDow <window>
<window> ::= {RECTangular | HANNing | FLATtop | BHARris}
The :FUNCtion:WINDow command allows the selection of four different
windowing transforms or operations for the FFT (Fast Fourier Transform)
function.
The FFT operation assumes that the time record repeats. Unless an
integral number of sampled waveform cycles exist in the record, a
discontinuity is created between the end of one record and the beginning
of the next. This discontinuity introduces additional frequency components
about the peaks into the spectrum. This is referred to as leakage. To
minimize leakage, windows that approach zero smoothly at the start and
end of the record are employed as filters to the FFTs. Each window is
useful for certain classes of input signals.
• RECTangular — useful for transient signals, and signals where there are
an integral number of cycles in the time record.
• HANNing — useful for frequency resolution and general purpose use. It
is good for resolving two frequencies that are close together, or for
making frequency measurements. This is the default window.
• FLATtop — best for making accurate amplitude measurements of
frequency peaks.
• BHARris (Blackman- Harris) — reduces time resolution compared to the
rectangular window, but it improves the capacity to detect smaller
impulses due to lower secondary lobes (provides minimal spectral
leakage).
Query Syntax
:FUNCtion:WINDow?
The :FUNCtion:WINDow? query returns the value of the window selected
for the FFT function.
Return Format
<window><NL>
<window> ::= {RECT | HANN | FLAT | BHAR}
See Also
292
• "Introduction to :FUNCtion Commands" on page 278
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:HARDcopy Commands
Set and query the selection of hardcopy device and formatting options. See
"Introduction to :HARDcopy Commands" on page 294.
Table 66 :HARDcopy Commands Summary
Command
Query
Options and Query Returns
:HARDcopy:AREA <area>
(see page 295)
:HARDcopy:AREA? (see
page 295)
<area> ::= SCReen
:HARDcopy:APRinter
<active_printer> (see
page 296)
:HARDcopy:APRinter?
(see page 296)
<active_printer> ::= {<index> |
<name>}
<index> ::= integer index of
printer in list
<name> ::= name of printer in
list
:HARDcopy:FACTors {{0
| OFF} | {1 | ON}}
(see page 297)
:HARDcopy:FACTors?
(see page 297)
{0 | 1}
:HARDcopy:FFEed {{0 |
OFF} | {1 | ON}} (see
page 298)
:HARDcopy:FFEed? (see
page 298)
{0 | 1}
:HARDcopy:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 299)
:HARDcopy:INKSaver?
(see page 299)
{0 | 1}
:HARDcopy:LAYout
<layout> (see
page 300)
:HARDcopy:LAYout?
(see page 300)
<layout> ::= {LANDscape |
PORTrait}
:HARDcopy:PALette
<palette> (see
page 301)
:HARDcopy:PALette?
(see page 301)
<palette> ::= {COLor | GRAYscale
| NONE}
n/a
:HARDcopy:PRINter:LIS
T? (see page 302)
<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 303)
n/a
n/a
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
293
5
Commands by Subsystem
Introduction to
:HARDcopy
Commands
The HARDcopy subsystem provides commands to set and query the
selection of hardcopy device and formatting options such as inclusion of
instrument settings (FACTors) and generation of formfeed (FFEed).
:HARDC is an acceptable short form for :HARDcopy.
Reporting the Setup
Use :HARDcopy? to query setup information for the HARDcopy subsystem.
Return Format
The following is a sample response from the :HARDcopy? query. In this
case, the query was issued following the *RST command.
:HARD:APR "";AREA SCR;FACT 0;FFE 0;INKS 1;PAL NONE;LAY PORT
294
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:HARDcopy:AREA
(see page 798)
Command Syntax
:HARDcopy:AREA <area>
<area> ::= SCReen
The :HARDcopy:AREA command controls what part of the display area is
printed. Currently, the only legal choice is SCReen.
Query Syntax
:HARDcopy:AREA?
The :HARDcopy:AREA? query returns the selected display area.
Return Format
<area><NL>
<area> ::= SCR
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:APRinter" on page 296
• ":HARDcopy:PRINter:LIST" on page 302
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:INKSaver" on page 299
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
295
5
Commands by Subsystem
:HARDcopy:APRinter
(see page 798)
Command Syntax
:HARDcopy:APRinter <active_printer>
<active_printer> ::= {<index> | <name>}
<index> ::= integer index of printer in list
<name> ::= name of printer in list
The :HARDcopy:APRinter command sets the active printer.
Query Syntax
:HARDcopy:APRinter?
The :HARDcopy:APRinter? query returns the name of the active printer.
Return Format
<name><NL>
<name> ::= name of printer in list
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:PRINter:LIST" on page 302
• ":HARDcopy:STARt" on page 303
296
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:HARDcopy:FACTors
(see page 798)
Command Syntax
:HARDcopy:FACTors <factors>
<factors> ::= {{OFF | 0} | {ON | 1}}
The HARDcopy:FACTors command controls whether the scale factors are
output on the hardcopy dump.
Query Syntax
:HARDcopy:FACTors?
The :HARDcopy:FACTors? query returns a flag indicating whether
oscilloscope instrument settings are output on the hardcopy.
Return Format
<factors><NL>
<factors> ::= {0 | 1}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:INKSaver" on page 299
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
297
5
Commands by Subsystem
:HARDcopy:FFEed
(see page 798)
Command Syntax
:HARDcopy:FFEed <ffeed>
<ffeed> ::= {{OFF | 0} | {ON | 1}}
The HARDcopy:FFEed command controls whether a formfeed is output
between the screen image and factors of a hardcopy dump.
ON (or 1) is only valid when PRINter0 or PRINter1 is set as the
:HARDcopy:FORMat type.
Query Syntax
:HARDcopy:FFEed?
The :HARDcopy:FFEed? query returns a flag indicating whether a formfeed
is output at the end of the hardcopy dump.
Return Format
<ffeed><NL>
<ffeed> ::= {0 | 1}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:INKSaver" on page 299
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
298
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:HARDcopy:INKSaver
(see page 798)
Command Syntax
:HARDcopy:INKSaver <value>
<value> ::= {{OFF | 0} | {ON | 1}}
The HARDcopy:INKSaver command controls whether the graticule colors
are inverted or not.
Query Syntax
:HARDcopy:INKSaver?
The :HARDcopy:INKSaver? query returns a flag indicating whether
graticule colors are inverted or not.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
299
5
Commands by Subsystem
:HARDcopy:LAYout
(see page 798)
Command Syntax
:HARDcopy:LAYout <layout>
<layout> ::= {LANDscape | PORTrait}
The :HARDcopy:LAYout command sets the hardcopy layout mode.
Query Syntax
:HARDcopy:LAYout?
The :HARDcopy:LAYout? query returns the selected hardcopy layout mode.
Return Format
<layout><NL>
<layout> ::= {LAND | PORT}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:PALette" on page 301
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:INKSaver" on page 299
300
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:HARDcopy:PALette
(see page 798)
Command Syntax
:HARDcopy:PALette <palette>
<palette> ::= {COLor | GRAYscale | NONE}
The :HARDcopy:PALette command sets the hardcopy palette color.
NOTE
Query Syntax
If no printer is connected, NONE is the only valid parameter.
:HARDcopy:PALette?
The :HARDcopy:PALette? query returns the selected hardcopy palette color.
Return Format
<palette><NL>
<palette> ::= {COL | GRAY | NONE}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:STARt" on page 303
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:INKSaver" on page 299
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
301
5
Commands by Subsystem
:HARDcopy:PRINter:LIST
(see page 798)
Query Syntax
:HARDcopy:PRINter:LIST?
The :HARDcopy:PRINter:LIST? query returns a list of available printers.
The list can be empty.
Return Format
<list><NL>
<list> ::= [<printer_spec>] ... [printer_spec>]
<printer_spec> ::= "<index>,<active>,<name>;"
<index> ::= integer index of printer
<active> ::= {Y | N}
<name> ::= name of printer (for example "DESKJET 950C")
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:APRinter" on page 296
• ":HARDcopy:STARt" on page 303
302
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:HARDcopy:STARt
(see page 798)
Command Syntax
:HARDcopy:STARt
The :HARDcopy:STARt command starts a print job.
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:APRinter" on page 296
• ":HARDcopy:PRINter:LIST" on page 302
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:INKSaver" on page 299
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
303
5
Commands by Subsystem
:LISTer Commands
Table 67 :LISTer Commands Summary
Command
Query
Options and Query Returns
n/a
:LISTer:DATA? (see
page 305)
<binary_block> ::=
comma-separated data with
newlines at the end of each row
:LISTer:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 306)
:LISTer:DISPlay? (see
page 306)
{0 | 1}
Introduction to
:LISTer
Commands
304
The LISTer subsystem is used to turn on/off the serial decode Lister
display and return data from the Lister display.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:LISTer:DATA
(see page 798)
Query Syntax
:LISTer:DATA?
The :LISTer:DATA? query returns the lister data.
Return Format
<binary block><NL>
<binary_block> ::= comma-separated data with newlines at the
end of each row
See Also
• "Introduction to :LISTer Commands" on page 304
• ":LISTer:DISPlay" on page 306
• "Definite- Length Block Response Data" on page 121
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
305
5
Commands by Subsystem
:LISTer:DISPlay
(see page 798)
Command Syntax
:LISTer:DISPlay <value>
<value> ::= {{1 | ON} | {0 | OFF}}
The :LISTer:DISPlay command turns on or off the on- screen lister display.
Query Syntax
:LISTer:DISPlay?
The :LISTer:DISPlay? query returns lister display setting.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :LISTer Commands" on page 304
• ":LISTer:DATA" on page 305
306
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer Commands
Set and query the settings of X- axis markers (X1 and X2 cursors) and the
Y- axis markers (Y1 and Y2 cursors). See "Introduction to :MARKer
Commands" on page 308.
Table 68 :MARKer Commands Summary
Command
Query
Options and Query Returns
:MARKer:MODE <mode>
(see page 309)
:MARKer:MODE? (see
page 309)
<mode> ::= {OFF | MEASurement |
MANual | WAVeform}
:MARKer:X1Position
<position>[suffix]
(see page 310)
:MARKer:X1Position?
(see page 310)
<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
:MARKer:X1Y1source
<source> (see
page 311)
:MARKer:X1Y1source?
(see page 311)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
:MARKer:X2Position
<position>[suffix]
(see page 312)
:MARKer:X2Position?
(see page 312)
<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
:MARKer:X2Y2source
<source> (see
page 313)
:MARKer:X2Y2source?
(see page 313)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= <source>
n/a
:MARKer:XDELta? (see
page 314)
<return_value> ::= X cursors
delta value in NR3 format
:MARKer:Y1Position
<position>[suffix]
(see page 315)
:MARKer:Y1Position?
(see page 315)
<position> ::= Y1 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y1 cursor
position value in NR3 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
307
5
Commands by Subsystem
Table 68 :MARKer Commands Summary (continued)
Command
Query
Options and Query Returns
:MARKer:Y2Position
<position>[suffix]
(see page 316)
:MARKer:Y2Position?
(see page 316)
<position> ::= Y2 cursor position
value in NR3 format
[suffix] ::= {V | mV | dB}
<return_value> ::= Y2 cursor
position value in NR3 format
n/a
:MARKer:YDELta? (see
page 317)
<return_value> ::= Y cursors
delta value in NR3 format
Introduction to
:MARKer
Commands
The MARKer subsystem commands set and query the settings of X- axis
markers (X1 and X2 cursors) and the Y- axis markers (Y1 and Y2 cursors).
You can set and query the marker mode and source, the position of the X
and Y cursors, and query delta X and delta Y cursor values.
Reporting the Setup
Use :MARKer? to query setup information for the MARKer subsystem.
Return Format
The following is a sample response from the :MARKer? query. In this case,
the query was issued following a *RST and :MARKer:MODE:MANual
command.
:MARK:X1Y1 NONE;X2Y2 NONE;MODE OFF
308
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer:MODE
(see page 798)
Command Syntax
:MARKer:MODE <mode>
<mode> ::= {OFF | MEASurement | MANual | WAVeform}
The :MARKer:MODE command sets the cursors mode:
• OFF — removes the cursor information from the display.
• MANual — enables manual placement of the X and Y cursors.
If the front- panel cursors are off, or are set to the front- panel Hex or
Binary mode, setting :MARKer:MODE MANual will put the cursors in
the front- panel Normal mode.
• MEASurement — cursors track the most recent measurement.
Setting the mode to MEASurement sets the marker sources
(:MARKer:X1Y1source and :MARKer:X2Y2source) to the measurement
source (:MEASure:SOURce). Setting the measurement source remotely
always sets the marker sources.
• WAVeform — the Y1 cursor tracks the voltage value at the X1 cursor of
the waveform specified by the X1Y1source, and the Y2 cursor does the
same for the X2 cursor and its X2Y2source.
Query Syntax
:MARKer:MODE?
The :MARKer:MODE? query returns the current cursors mode.
Return Format
<mode><NL>
<mode> ::= {OFF | MEAS | MAN | WAV}
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MEASure:SOURce" on page 349
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Position" on page 312
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
309
5
Commands by Subsystem
:MARKer:X1Position
(see page 798)
Command Syntax
:MARKer:X1Position <position> [suffix]
<position> ::= X1 cursor position in NR3 format
<suffix> ::= {s | ms | us | ns | ps | Hz | kHz | MHz}
The :MARKer:X1Position command:
• Sets :MARKer:MODE to MANual if it is not currently set to WAVeform
(see ":MARKer:MODE" on page 309).
• Sets the X1 cursor position to the specified value.
Query Syntax
:MARKer:X1Position?
The :MARKer:X1Position? query returns the current X1 cursor position.
This is functionally equivalent to the obsolete :MEASure:TSTArt
command/query.
NOTE
Return Format
If the front-panel cursors are off, the marker position values are not defined and an error is
generated. Make sure to set :MARKer:MODE to MANual or WAVeform to put the cursors in
the front-panel Normal mode.
<position><NL>
<position> ::= X1 cursor position in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X2Position" on page 312
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MEASure:TSTArt" on page 731
310
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer:X1Y1source
(see page 798)
Command Syntax
:MARKer:X1Y1source <source>
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MARKer:X1Y1source command sets the source for the cursors. The
channel you specify must be enabled for cursors to be displayed. If the
channel or function is not on, an error message is issued.
If the marker mode is not currently WAVeform (see ":MARKer:MODE" on
page 309):
• Sending a :MARKer:X1Y1source command will put the cursors in the
MANual mode.
• Setting the source for one pair of markers (for example, X1Y1) sets the
source for the other (for example, X2Y2).
If the marker mode is currently WAVeform, the X1Y1 source can be set
separate from the X2Y2 source.
If :MARKer:MODE is set to OFF or MANual, setting :MEASure:SOURce to
CHANnel<n>, FUNCtion, or MATH will also set :MARKer:X1Y1source and
:MARKer:X2Y2source to this value.
NOTE
Query Syntax
MATH is an alias for FUNCtion. The query will return FUNC if the source is FUNCtion or
MATH.
:MARKer:X1Y1source?
The :MARKer:X1Y1source? query returns the current source for the
cursors. If all channels are off or if :MARKer:MODE is set to OFF, the
query returns NONE.
Return Format
<source><NL>
<source> ::= {CHAN<n> | FUNC | NONE}
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X2Y2source" on page 313
• ":MEASure:SOURce" on page 349
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
311
5
Commands by Subsystem
:MARKer:X2Position
(see page 798)
Command Syntax
:MARKer:X2Position <position> [suffix]
<position> ::= X2 cursor position in NR3 format
<suffix> ::= {s | ms | us | ns | ps | Hz | kHz | MHz}
The :MARKer:X2Position command:
• Sets :MARKer:MODE to MANual if it is not currently set to WAVeform
(see ":MARKer:MODE" on page 309).
• Sets the X2 cursor position to the specified value.
Query Syntax
:MARKer:X2Position?
The :MARKer:X2Position? query returns current X2 cursor position. This is
functionally equivalent to the obsolete :MEASure:TSTOp command/query.
NOTE
Return Format
If the front-panel cursors are off, the marker position values are not defined and an error is
generated. Make sure to set :MARKer:MODE to MANual or WAVeform to put the cursors in
the front-panel Normal mode.
<position><NL>
<position> ::= X2 cursor position in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Y2source" on page 313
• ":MEASure:TSTOp" on page 732
312
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer:X2Y2source
(see page 798)
Command Syntax
:MARKer:X2Y2source <source>
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MARKer:X2Y2source command sets the source for the cursors. The
channel you specify must be enabled for cursors to be displayed. If the
channel or function is not on, an error message is issued.
If the marker mode is not currently WAVeform (see ":MARKer:MODE" on
page 309):
• Sending a :MARKer:X2Y2source command will put the cursors in the
MANual mode.
• Setting the source for one pair of markers (for example, X2Y2) sets the
source for the other (for example, X1Y1).
If the marker mode is currently WAVeform, the X2Y2 source can be set
separate from the X1Y1 source.
If :MARKer:MODE is set to OFF or MANual, setting :MEASure:SOURce to
CHANnel<n>, FUNCtion, or MATH will also set :MARKer:X1Y1source and
:MARKer:X2Y2source to this value.
NOTE
Query Syntax
MATH is an alias for FUNCtion. The query will return FUNC if the source is FUNCtion or
MATH.
:MARKer:X2Y2source?
The :MARKer:X2Y2source? query returns the current source for the
cursors. If all channels are off or if :MARKer:MODE is set to OFF, the
query returns NONE.
Return Format
<source><NL>
<source> ::= {CHAN<n> | FUNC | NONE}
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Y1source" on page 311
• ":MEASure:SOURce" on page 349
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
313
5
Commands by Subsystem
:MARKer:XDELta
(see page 798)
Query Syntax
:MARKer:XDELta?
The MARKer:XDELta? query returns the value difference between the
current X1 and X2 cursor positions.
Xdelta = (Value at X2 cursor) - (Value at X1 cursor)
NOTE
Return Format
If the front-panel cursors are off, the marker position values are not defined. Make sure to
set :MARKer:MODE to MANual or WAVeform to put the cursors in the front-panel Normal
mode.
<value><NL>
<value> ::= difference value in NR3 format.
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Position" on page 312
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
314
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer:Y1Position
(see page 798)
Command Syntax
:MARKer:Y1Position <position> [suffix]
<position> ::= Y1 cursor position in NR3 format
<suffix> ::= {mV | V | dB}
If the :MARKer:MODE is not currently set to WAVeform (see
":MARKer:MODE" on page 309), the :MARKer:Y1Position command:
• Sets :MARKer:MODE to MANual.
• Sets the Y1 cursor position to the specified value.
When the :MARKer:MODE is set to WAVeform, Y positions cannot be set.
Query Syntax
:MARKer:Y1Position?
The :MARKer:Y1Position? query returns current Y1 cursor position. This is
functionally equivalent to the obsolete :MEASure:VSTArt command/query.
NOTE
Return Format
If the front-panel cursors are off or are set to Binary or Hex Mode, the marker position
values are not defined and an error is generated. Make sure to set :MARKer:MODE to
MANual or WAVeform to put the cursors in the front-panel Normal mode.
<position><NL>
<position> ::= Y1 cursor position in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MARKer:Y2Position" on page 316
• ":MEASure:VSTArt" on page 737
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
315
5
Commands by Subsystem
:MARKer:Y2Position
(see page 798)
Command Syntax
:MARKer:Y2Position <position> [suffix]
<position> ::= Y2 cursor position in NR3 format
<suffix> ::= {mV | V | dB}
If the :MARKer:MODE is not currently set to WAVeform (see
":MARKer:MODE" on page 309), the :MARKer:Y1Position command:
• Sets :MARKer:MODE to MANual.
• Sets the Y2 cursor position to the specified value.
When the :MARKer:MODE is set to WAVeform, Y positions cannot be set.
Query Syntax
:MARKer:Y2Position?
The :MARKer:Y2Position? query returns current Y2 cursor position. This is
functionally equivalent to the obsolete :MEASure:VSTOp command/query.
NOTE
Return Format
If the front-panel cursors are off or are set to Binary or Hex Mode, the marker position
values are not defined and an error is generated. Make sure to set :MARKer:MODE to
MANual or WAVeform to put the cursors in the front-panel Normal mode.
<position><NL>
<position> ::= Y2 cursor position in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MARKer:Y1Position" on page 315
• ":MEASure:VSTOp" on page 738
316
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MARKer:YDELta
(see page 798)
Query Syntax
:MARKer:YDELta?
The :MARKer:YDELta? query returns the value difference between the
current Y1 and Y2 cursor positions.
Ydelta = (Value at Y2 cursor) - (Value at Y1 cursor)
NOTE
Return Format
If the front-panel cursors are off or are set to Binary or Hex Mode, the marker position
values are not defined. Make sure to set :MARKer:MODE to MANual or WAVeform to put
the cursors in the front-panel Normal mode.
<value><NL>
<value> ::= difference value in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• ":MARKer:MODE" on page 309
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
317
5
Commands by Subsystem
:MEASure Commands
Select automatic measurements to be made and control time markers. See
"Introduction to :MEASure Commands" on page 324.
Table 69 :MEASure Commands Summary
Command
Query
Options and Query Returns
:MEASure:CLEar (see
page 326)
n/a
n/a
:MEASure:COUNter
[<source>] (see
page 327)
:MEASure:COUNter?
[<source>] (see
page 327)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= counter
frequency in Hertz in NR3 format
:MEASure:DEFine
DELay, <delay spec>
(see page 328)
:MEASure:DEFine?
DELay (see page 329)
<delay spec> ::=
<edge_spec1>,<edge_spec2>
edge_spec1 ::=
[<slope>]<occurrence>
edge_spec2 ::=
[<slope>]<occurrence>
<slope> ::= {+ | -}
<occurrence> ::= integer
:MEASure:DEFine
THResholds,
<threshold spec> (see
page 328)
:MEASure:DEFine?
THResholds (see
page 329)
<threshold spec> ::= {STANdard} |
{<threshold mode>,<upper>,
<middle>,<lower>}
<threshold mode> ::= {PERCent |
ABSolute}
:MEASure:DELay
[<source1>]
[,<source2>] (see
page 331)
:MEASure:DELay?
[<source1>]
[,<source2>] (see
page 331)
<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 333)
:MEASure:DUTYcycle?
[<source>] (see
page 333)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= ratio of
positive pulse width to period in
NR3 format
318
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 69 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:FALLtime
[<source>] (see
page 334)
:MEASure:FALLtime?
[<source>] (see
page 334)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds between the lower and
upper thresholds in NR3 format
:MEASure:FREQuency
[<source>] (see
page 335)
:MEASure:FREQuency?
[<source>] (see
page 335)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= frequency in
Hertz in NR3 format
:MEASure:NWIDth
[<source>] (see
page 336)
:MEASure:NWIDth?
[<source>] (see
page 336)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= negative
pulse width in seconds-NR3 format
:MEASure:OVERshoot
[<source>] (see
page 337)
:MEASure:OVERshoot?
[<source>] (see
page 337)
<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
:MEASure:PERiod
[<source>] (see
page 339)
:MEASure:PERiod?
[<source>] (see
page 339)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= waveform
period in seconds in NR3 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
319
5
Commands by Subsystem
Table 69 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:PHASe
[<source1>]
[,<source2>] (see
page 340)
:MEASure:PHASe?
[<source1>]
[,<source2>] (see
page 340)
<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 341)
:MEASure:PREShoot?
[<source>] (see
page 341)
<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
:MEASure:PWIDth
[<source>] (see
page 342)
:MEASure:PWIDth?
[<source>] (see
page 342)
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= width of
positive pulse in seconds in NR3
format
n/a
:MEASure:RESults?
<result_list> (see
page 343)
<result_list> ::=
comma-separated list of
measurement results
:MEASure:RISetime
[<source>] (see
page 346)
:MEASure:RISetime?
[<source>] (see
page 346)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= rise time in
seconds in NR3 format
:MEASure:SDEViation
[<source>] (see
page 347)
:MEASure:SDEViation?
[<source>] (see
page 347)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
std deviation in NR3 format
:MEASure:SHOW {1 |
ON} (see page 348)
:MEASure:SHOW? (see
page 348)
{1}
320
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 69 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:SOURce
<source1>
[,<source2>] (see
page 349)
:MEASure:SOURce? (see
page 349)
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH | EXTernal} for
DSO models
<source1,2> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH | EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= {<source> |
NONE}
:MEASure:STATistics
<type> (see page 351)
:MEASure:STATistics?
(see page 351)
<type> ::= {{ON | 1} | CURRent |
MEAN | MINimum | MAXimum | STDDev
| COUNt}
ON ::= all statistics returned
:MEASure:STATistics:I
NCRement (see
page 352)
n/a
n/a
:MEASure:STATistics:R
ESet (see page 353)
n/a
n/a
n/a
:MEASure:TEDGe?
<slope><occurrence>[,
<source>] (see
page 354)
<slope> ::= direction of the
waveform
<occurrence> ::= the transition
to be reported
<source> ::= {CHANnel<n> |
FUNCtion | MATH} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= time in
seconds of the specified
transition
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
321
5
Commands by Subsystem
Table 69 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:MEASure:TVALue?
<value>,
[<slope>]<occurrence>
[,<source>] (see
page 356)
<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} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:MEASure:VAMPlitude
[<source>] (see
page 358)
:MEASure:VAMPlitude?
[<source>] (see
page 358)
<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
:MEASure:VAVerage
[<source>] (see
page 359)
:MEASure:VAVerage?
[<source>] (see
page 359)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated
average voltage in NR3 format
:MEASure:VBASe
[<source>] (see
page 360)
:MEASure:VBASe?
[<source>] (see
page 360)
<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
:MEASure:VMAX
[<source>] (see
page 361)
:MEASure:VMAX?
[<source>] (see
page 361)
<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
:MEASure:VMIN
[<source>] (see
page 362)
:MEASure:VMIN?
[<source>] (see
page 362)
<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
322
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 69 :MEASure Commands Summary (continued)
Command
Query
Options and Query Returns
:MEASure:VPP
[<source>] (see
page 363)
:MEASure:VPP?
[<source>] (see
page 363)
<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
:MEASure:VRATio
[<source1>]
[,<source2>] (see
page 340)
:MEASure:VRATio?
[<source1>]
[,<source2>] (see
page 364)
<source1,2> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= the ratio
value in dB in NR3 format
:MEASure:VRMS
[<source>] (see
page 365)
:MEASure:VRMS?
[<source>] (see
page 365)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= calculated dc
RMS voltage in NR3 format
n/a
:MEASure:VTIMe?
<vtime>[,<source>]
(see page 366)
<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} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | FUNCtion
| MATH} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:MEASure:VTOP
[<source>] (see
page 367)
:MEASure:VTOP?
[<source>] (see
page 367)
<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
:MEASure:XMAX
[<source>] (see
page 368)
:MEASure:XMAX?
[<source>] (see
page 368)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
:MEASure:XMIN
[<source>] (see
page 369)
:MEASure:XMIN?
[<source>] (see
page 369)
<source> ::= {CHANnel<n> |
FUNCtion | MATH}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= horizontal
value of the maximum in NR3
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
323
5
Commands by Subsystem
Introduction to
:MEASure
Commands
The commands in the MEASure subsystem are used to make parametric
measurements on displayed waveforms.
Measurement Setup
To make a measurement, the portion of the waveform required for that
measurement must be displayed on the oscilloscope screen.
Measurement Type
Portion of waveform that must be displayed
period, duty cycle, or frequency
at least one complete cycle
pulse width
the entire pulse
rise time
rising edge, top and bottom of pulse
fall time
falling edge, top and bottom of pulse
Measurement Error
If a measurement cannot be made (typically because the proper portion of
the waveform is not displayed), the value +9.9E+37 is returned for that
measurement.
Making Measurements
If more than one waveform, edge, or pulse is displayed, time
measurements are made on the portion of the displayed waveform closest
to the trigger reference (left, center, or right).
When making measurements in the zoomed (delayed) time base mode
(:TIMebase:MODE WINDow), the oscilloscope will attempt to make the
measurement inside the zoomed sweep window. If the measurement is an
average and there are not three edges, the oscilloscope will revert to the
mode of making the measurement at the start of the main sweep.
When the command form is used, the measurement result is displayed on
the instrument. When the query form of these measurements is used, the
measurement is made one time, and the measurement result is returned
over the bus.
Measurements are made on the displayed waveforms specified by the
:MEASure:SOURce command. The MATH source is an alias for the
FUNCtion source.
Not all measurements are available on the digital channels or FFT (Fast
Fourier Transform).
Reporting the Setup
Use the :MEASure? query to obtain setup information for the MEASure
subsystem. (Currently, this is only :MEASure:SOURce.)
324
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Return Format
The following is a sample response from the :MEASure? query. In this
case, the query was issued following a *RST command.
:MEAS:SOUR CHAN1,CHAN2;STAT ON
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
325
5
Commands by Subsystem
:MEASure:CLEar
(see page 798)
Command Syntax
:MEASure:CLEar
This command clears all selected measurements and markers from the
screen.
See Also
326
• "Introduction to :MEASure Commands" on page 324
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:COUNter
(see page 798)
Command Syntax
:MEASure:COUNter [<source>]
<source> ::= {<digital channels> | CHANnel<n> | EXTernal}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:COUNter command installs a screen measurement and
starts a counter measurement. If the optional source parameter is
specified, the current source is modified. Any channel except Math may be
selected for the source.
The counter measurement counts trigger level crossings at the selected
trigger slope and displays the results in Hz. The gate time for the
measurement is automatically adjusted to be 100 ms or twice the current
time window, whichever is longer, up to 1 second. The counter
measurement can measure frequencies up to 125 MHz. The minimum
frequency supported is 1/(2 X gate time).
The Y cursor shows the the edge threshold level used in the measurement.
Only one counter measurement may be displayed at a time.
NOTE
Query Syntax
This command is not available if the source is MATH.
:MEASure:COUNter? [<source>]
The :MEASure:COUNter? query measures and outputs the counter
frequency of the specified source.
NOTE
Return Format
The :MEASure:COUNter? query times out if the counter measurement is installed on the
front panel. Use :MEASure:CLEar to remove the front-panel measurement before executing
the :MEASure:COUNter? query.
<source><NL>
<source> ::= count in Hertz in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:FREQuency" on page 335
• ":MEASure:CLEar" on page 326
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
327
5
Commands by Subsystem
:MEASure:DEFine
(see page 798)
Command Syntax
:MEASure:DEFine <meas_spec>
<meas_spec> ::= {DELay | THResholds}
The :MEASure:DEFine command sets up the definition for measurements
by specifying the delta time or threshold values. Changing these values
may affect the results of other measure commands. The table below
identifies which measurement results that can be affected by redefining
the DELay specification or the THResholds values. For example, changing
the THResholds definition from the default 10%, 50%, and 90% values may
change the returned measurement result.
MEASure Command
DELay
DUTYcycle
x
DELay
:MEASure:DEFine
DELay Command
Syntax
THResholds
x
x
FALLtime
x
FREQuency
x
NWIDth
x
OVERshoot
x
PERiod
x
PHASe
x
PREShoot
x
PWIDth
x
RISetime
x
VAVerage
x
VRMS
x
:MEASure:DEFine DELay,<delay spec>
<delay spec> ::= <edge_spec1>,<edge_spec2>
<edge_spec1> ::= [<slope>]<occurrence>
<edge_spec2> ::= [<slope>]<occurrence>
<slope> ::= {+ | -}
<occurrence> ::= integer
328
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
This command defines the behavior of the :MEASure:DELay? query by
specifying the start and stop edge to be used. <edge_spec1> specifies the
slope and edge number on source1. <edge_spec2> specifies the slope and
edge number on source2. The measurement is taken as:
delay = t(<edge_spec2>) - t(<edge_spec1>)
NOTE
:MEASure:DEFine
THResholds
Command Syntax
The :MEASure:DELay command and the front-panel delay measurement use an auto-edge
selection method to determine the actual edge used for the measurement. The
:MEASure:DEFine command has no effect on these delay measurements. The edges
specified by the :MEASure:DEFine command only define the edges used by the
:MEASure:DELay? query.
:MEASure:DEFine THResholds,<threshold spec>
<threshold spec> ::= {STANdard}
| {<threshold mode>,<upper>,<middle>,<lower>}
<threshold mode> ::= {PERCent | ABSolute}
for <threshold mode> = PERCent:
<upper>, <middle>, <lower> ::= A number specifying the upper, middle,
and lower threshold percentage values
between Vbase and Vtop in NR3 format.
for <threshold mode> = ABSolute:
<upper>, <middle>, <lower> ::= A number specifying the upper, middle,
and lower threshold absolute values in
NR3 format.
• STANdard threshold specification sets the lower, middle, and upper
measurement thresholds to 10%, 50%, and 90% values between Vbase
and Vtop.
• Threshold mode PERCent sets the measurement thresholds to any
user- defined percentages between 5% and 95% of values between Vbase
and Vtop.
• Threshold mode ABSolute sets the measurement thresholds to absolute
values. ABSolute thresholds are dependent on channel scaling
(:CHANnel<n>:RANGe or ":CHANnel<n>:SCALe" on
page 246:CHANnel<n>:SCALe), probe attenuation (:CHANnel<n>:PROBe),
and probe units (:CHANnel<n>:UNITs). Always set these values first
before setting ABSolute thresholds.
Query Syntax
:MEASure:DEFine? <meas_spec>
<meas_spec> ::= {DELay | THResholds}
The :MEASure:DEFine? query returns the current edge specification for the
delay measurements setup or the current specification for the thresholds
setup.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
329
5
Commands by Subsystem
Return Format
for <meas_spec> = DELay:
{ <edge_spec1> | <edge_spec2> | <edge_spec1>,<edge_spec2>} <NL>
for <meas_spec> = THResholds and <threshold mode> = PERCent:
THR,PERC,<upper>,<middle>,<lower><NL>
<upper>, <middle>, <lower> ::= A number specifying the upper, middle,
and lower threshold percentage values
between Vbase and Vtop in NR3 format.
for <meas_spec> = THResholds and <threshold mode> = ABSolute:
THR,ABS,<upper>,<middle>,<lower><NL>
<upper>, <middle>, <lower> ::= A number specifying the upper, middle,
and lower threshold voltages in NR3
format.
for <threshold spec> = STANdard:
THR,PERC,+90.0,+50.0,+10.0
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:DELay" on page 331
• ":MEASure:SOURce" on page 349
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:SCALe" on page 246
• ":CHANnel<n>:PROBe" on page 239
• ":CHANnel<n>:UNITs" on page 247
330
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:DELay
(see page 798)
Command Syntax
:MEASure:DELay [<source1>][,<source2>]
<source1>, <source2> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:DELay command places the instrument in the continuous
measurement mode and starts a delay measurement.
The measurement is taken as:
delay = t(<edge spec 2>) - t(<edge spec 1>)
where the <edge spec> definitions are set by the :MEASure:DEFine
command
NOTE
The :MEASure:DELay command and the front-panel delay measurement differ from the
:MEASure:DELay? query.
The delay command or front-panel measurement run the delay measurement in auto-edge
select mode. In this mode, you can select the edge polarity, but the instrument will select
the edges that will make the best possible delay measurement. The source1 edge chosen
will be the edge that meets the polarity specified and is closest to the trigger reference
point. The source2 edge selected will be that edge of the specified polarity that gives the
first of the following criteria:
• The smallest positive delay value that is less than source1 period.
• The smallest negative delay that is less than source1 period.
• The smallest absolute value of delay.
The :MEASure:DELay? query will make the measurement using the edges specified by the
:MEASure:DEFine command.
Query Syntax
:MEASure:DELay? [<source1>][,<source2>]
The :MEASure:DELay? query measures and returns the delay between
source1 and source2. The delay measurement is made from the
user- defined slope and edge count of the signal connected to source1, to
the defined slope and edge count of the signal connected to source2. Delay
measurement slope and edge parameters are selected using the
:MEASure:DEFine command.
Also in the :MEASure:DEFine command, you can set upper, middle, and
lower threshold values. It is the middle threshold value that is used when
performing the delay query. The standard upper, middle, and lower
measurement thresholds are 90%, 50%, and 10% values between Vbase and
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
331
5
Commands by Subsystem
Vtop. If you want to move the delay measurement point nearer to Vtop or
Vbase, you must change the threshold values with the :MEASure:DEFine
THResholds command.
Return Format
<value><NL>
<value> ::= floating-point number delay time in seconds in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:DEFine" on page 328
• ":MEASure:PHASe" on page 340
332
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:DUTYcycle
(see page 798)
Command Syntax
:MEASure:DUTYcycle [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:DUTYcycle command installs a screen measurement and
starts a duty cycle measurement on the current :MEASure:SOURce. If the
optional source parameter is specified, the current source is modified.
NOTE
Query Syntax
The signal must be displayed to make the measurement. This command is not available if
the source is FFT (Fast Fourier Transform).
:MEASure:DUTYcycle? [<source>]
The :MEASure:DUTYcycle? query measures and outputs the duty cycle of
the signal specified by the :MEASure:SOURce command. The value
returned for the duty cycle is the ratio of the positive pulse width to the
period. The positive pulse width and the period of the specified signal are
measured, then the duty cycle is calculated with the following formula:
duty cycle = (+pulse width/period)*100
Return Format
<value><NL>
<value> ::= ratio of positive pulse width to period in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:PERiod" on page 339
• ":MEASure:PWIDth" on page 342
• ":MEASure:SOURce" on page 349
Example Code
• "Example Code" on page 350
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
333
5
Commands by Subsystem
:MEASure:FALLtime
(see page 798)
Command Syntax
:MEASure:FALLtime [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:FALLtime command installs a screen measurement and
starts a fall- time measurement. For highest measurement accuracy, set the
sweep speed as fast as possible, while leaving the falling edge of the
waveform on the display. If the optional source parameter is specified, the
current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:FALLtime? [<source>]
The :MEASure:FALLtime? query measures and outputs the fall time of the
displayed falling (negative- going) edge closest to the trigger reference. The
fall time is determined by measuring the time at the upper threshold of
the falling edge, then measuring the time at the lower threshold of the
falling edge, and calculating the fall time with the following formula:
fall time = time at lower threshold - time at upper threshold
Return Format
<value><NL>
<value> ::= time in seconds between the lower threshold and upper
threshold in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:RISetime" on page 346
• ":MEASure:SOURce" on page 349
334
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:FREQuency
(see page 798)
Command Syntax
:MEASure:FREQuency [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:FREQuency command installs a screen measurement and
starts a frequency measurement. If the optional source parameter is
specified, the current source is modified.
IF the edge on the screen closest to the trigger reference is rising:
THEN frequency = 1/(time at trailing rising edge - time at leading rising
edge)
ELSE frequency = 1/(time at trailing falling edge - time at leading falling
edge)
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:FREQuency? [<source>]
The :MEASure:FREQuency? query measures and outputs the frequency of
the cycle on the screen closest to the trigger reference.
Return Format
<source><NL>
<source> ::= frequency in Hertz in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:PERiod" on page 339
Example Code
• "Example Code" on page 350
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
335
5
Commands by Subsystem
:MEASure:NWIDth
(see page 798)
Command Syntax
:MEASure:NWIDth [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:NWIDth command installs a screen measurement and starts
a negative pulse width measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:NWIDth? [<source>]
The :MEASure:NWIDth? query measures and outputs the width of the
negative pulse on the screen closest to the trigger reference using the
midpoint between the upper and lower thresholds.
FOR the negative pulse closest to the trigger point:
width = (time at trailing rising edge - time at leading falling edge)
Return Format
<value><NL>
<value> ::= negative pulse width in seconds in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:PWIDth" on page 342
• ":MEASure:PERiod" on page 339
336
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:OVERshoot
(see page 798)
Command Syntax
:MEASure:OVERshoot [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:OVERshoot command installs a screen measurement and
starts an overshoot measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:OVERshoot? [<source>]
The :MEASure:OVERshoot? query measures and returns the overshoot of
the edge closest to the trigger reference, displayed on the screen. The
method used to determine overshoot is to make three different vertical
value measurements: Vtop, Vbase, and either Vmax or Vmin, depending on
whether the edge is rising or falling.
For a rising edge:
overshoot = ((Vmax- Vtop) / (Vtop- Vbase)) x 100
For a falling edge:
overshoot = ((Vbase- Vmin) / (Vtop- Vbase)) x 100
Vtop and Vbase are taken from the normal histogram of all waveform
vertical values. The extremum of Vmax or Vmin is taken from the
waveform interval right after the chosen edge, halfway to the next edge.
This more restricted definition is used instead of the normal one, because
it is conceivable that a signal may have more preshoot than overshoot, and
the normal extremum would then be dominated by the preshoot of the
following edge.
Return Format
<overshoot><NL>
<overshoot>::= the percent of the overshoot of the selected waveform in
NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:PREShoot" on page 341
• ":MEASure:SOURce" on page 349
• ":MEASure:VMAX" on page 361
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
337
5
Commands by Subsystem
• ":MEASure:VTOP" on page 367
• ":MEASure:VBASe" on page 360
• ":MEASure:VMIN" on page 362
338
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:PERiod
(see page 798)
Command Syntax
:MEASure:PERiod [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:PERiod command installs a screen measurement and starts
the period measurement. If the optional source parameter is specified, the
current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:PERiod? [<source>]
The :MEASure:PERiod? query measures and outputs the period of the
cycle closest to the trigger reference on the screen. The period is measured
at the midpoint of the upper and lower thresholds.
IF the edge closest to the trigger reference on screen is rising:
THEN period = (time at trailing rising edge - time at leading rising edge)
ELSE period = (time at trailing falling edge - time at leading falling edge)
Return Format
<value><NL>
<value> ::= waveform period in seconds in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:NWIDth" on page 336
• ":MEASure:PWIDth" on page 342
• ":MEASure:FREQuency" on page 335
Example Code
• "Example Code" on page 350
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
339
5
Commands by Subsystem
:MEASure:PHASe
(see page 798)
Command Syntax
:MEASure:PHASe [<source1>][,<source2>]
<source1>, <source2> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:PHASe command places the instrument in the continuous
measurement mode and starts a phase measurement.
Query Syntax
:MEASure:PHASe? [<source1>][,<source2>]
The :MEASure:PHASe? query measures and returns the phase between the
specified sources.
A phase measurement is a combination of the period and delay
measurements. First, the period is measured on source1. Then the delay is
measured between source1 and source2. The edges used for delay are the
source1 rising edge used for the period measurement closest to the
horizontal reference and the rising edge on source 2. See :MEASure:DELay
for more detail on selecting the 2nd edge.
The phase is calculated as follows:
phase = (delay / period of input 1) x 360
Return Format
<value><NL>
<value> ::= the phase angle value in degrees in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:DELay" on page 331
• ":MEASure:PERiod" on page 339
• ":MEASure:SOURce" on page 349
340
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:PREShoot
(see page 798)
Command Syntax
:MEASure:PREShoot [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:PREShoot command installs a screen measurement and
starts a preshoot measurement. If the optional source parameter is
specified, the current source is modified.
Query Syntax
:MEASure:PREShoot? [<source>]
The :MEASure:PREShoot? query measures and returns the preshoot of the
edge closest to the trigger, displayed on the screen. The method used to
determine preshoot is to make three different vertical value measurements:
Vtop, Vbase, and either Vmin or Vmax, depending on whether the edge is
rising or falling.
For a rising edge:
preshoot = ((Vmin- Vbase) / (Vtop- Vbase)) x 100
For a falling edge:
preshoot = ((Vmax- Vtop) / (Vtop- Vbase)) x 100
Vtop and Vbase are taken from the normal histogram of all waveform
vertical values. The extremum of Vmax or Vmin is taken from the
waveform interval right before the chosen edge, halfway back to the
previous edge. This more restricted definition is used instead of the
normal one, because it is likely that a signal may have more overshoot
than preshoot, and the normal extremum would then be dominated by the
overshoot of the preceding edge.
Return Format
<value><NL>
<value> ::= the percent of preshoot of the selected waveform
in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VMIN" on page 362
• ":MEASure:VMAX" on page 361
• ":MEASure:VTOP" on page 367
• ":MEASure:VBASe" on page 360
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
341
5
Commands by Subsystem
:MEASure:PWIDth
(see page 798)
Command Syntax
:MEASure:PWIDth [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:PWIDth command installs a screen measurement and starts
the positive pulse width measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:PWIDth? [<source>]
The :MEASure:PWIDth? query measures and outputs the width of the
displayed positive pulse closest to the trigger reference. Pulse width is
measured at the midpoint of the upper and lower thresholds.
IF the edge on the screen closest to the trigger is falling:
THEN width = (time at trailing falling edge - time at leading rising edge)
ELSE width = (time at leading falling edge - time at leading rising edge)
Return Format
<value><NL>
<value> ::= width of positive pulse in seconds in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:NWIDth" on page 336
• ":MEASure:PERiod" on page 339
342
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:RESults
(see page 798)
Query Syntax
:MEASure:RESults?
The :MEASure:RESults? query returns the results of the continuously
displayed measurements. The response to the MEASure:RESults? query is a
list of comma- separated values.
If more than one measurement is running continuously, the
:MEASure:RESults return values are duplicated for each continuous
measurement from the first to last (left to right) result displayed. Each
result returned is separated from the previous result by a comma. There is
a maximum of four continuous measurements that can be continuously
displayed at a time.
When no quick measurements are installed, the :MEASure:RESults? query
returns nothing (empty string). When the count for any of the
measurements is 0, the value of infinity (9.9E+37) is returned for the min,
max, mean, and standard deviation.
Return Format
<result_list><NL>
<result_list> ::= comma-separated list of measurement results
The following shows the order of values received for a single measurement
if :MEASure:STATistics is set to ON.
Measurem
ent label
current
min
max
mean
std dev
count
Measurement label, current, min, max, mean, std dev, and count are only
returned if :MEASure:STATistics is ON.
If :MEASure:STATistics is set to CURRent, MIN, MAX, MEAN, STDDev, or
COUNt only that particular statistic value is returned for each
measurement that is on.
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:STATistics" on page 351
Example Code
' This program shows the InfiniiVision oscilloscopes' measurement
' statistics commands.
' ------------------------------------------------------------------Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
343
5
Commands by Subsystem
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.70.228::inst0::INSTR")
' Initialize.
myScope.IO.Clear
' Clear the interface.
myScope.WriteString "*RST"
' Reset to the defaults.
myScope.WriteString "*CLS"
' Clear the status data structures.
myScope.WriteString ":AUToscale"
' Install some measurements.
myScope.WriteString ":MEASure:SOURce CHANnel1"
' Input source.
Dim MeasurementArray(3) As String
MeasurementArray(0) = "FREQuency"
MeasurementArray(1) = "DUTYcycle"
MeasurementArray(2) = "VAMPlitude"
MeasurementArray(3) = "VPP"
Dim Measurement As Variant
For Each Measurement In MeasurementArray
myScope.WriteString ":MEASure:" + Measurement
myScope.WriteString ":MEASure:" + Measurement + "?"
varQueryResult = myScope.ReadNumber
' Read measurement value.
Debug.Print Measurement + ": " + FormatNumber(varQueryResult, 4)
Next
myScope.WriteString ":MEASure:STATistics:RESet"
Sleep 5000
' Wait for 5 seconds.
' Reset stats.
' Select the statistics results type.
Dim ResultsTypeArray(6) As String
ResultsTypeArray(0) = "CURRent"
ResultsTypeArray(1) = "MINimum"
ResultsTypeArray(2) = "MAXimum"
ResultsTypeArray(3) = "MEAN"
ResultsTypeArray(4) = "STDDev"
ResultsTypeArray(5) = "COUNt"
ResultsTypeArray(6) = "ON"
' All results.
Dim ResultType As Variant
Dim ResultsList()
Dim ValueColumnArray(6) As String
ValueColumnArray(0) = "Meas_Lbl"
ValueColumnArray(1) = "Current"
ValueColumnArray(2) = "Min"
ValueColumnArray(3) = "Max"
ValueColumnArray(4) = "Mean"
344
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
ValueColumnArray(5) = "Std_Dev"
ValueColumnArray(6) = "Count"
Dim ValueColumn As Variant
For Each ResultType In ResultsTypeArray
myScope.WriteString ":MEASure:STATistics " + ResultType
' Get the statistics results.
Dim intCounter As Integer
intCounter = 0
myScope.WriteString ":MEASure:RESults?"
ResultsList() = myScope.ReadList
For Each Measurement In MeasurementArray
If ResultType = "ON" Then
' All statistics.
For Each ValueColumn In ValueColumnArray
If VarType(ResultsList(intCounter)) <> vbString Then
Debug.Print "Measure statistics result CH1, " + _
Measurement + ", "; ValueColumn + ": " + _
FormatNumber(ResultsList(intCounter), 4)
Else
' Result is a string (e.g., measurement label).
Debug.Print "Measure statistics result CH1, " + _
Measurement + ", "; ValueColumn + ": " + _
ResultsList(intCounter)
End If
intCounter = intCounter + 1
Next
Else
' Specific statistic (e.g., Current, Max, Min, etc.).
Debug.Print "Measure statistics result CH1, " + _
Measurement + ", "; ResultType + ": " + _
FormatNumber(ResultsList(intCounter), 4)
intCounter = intCounter + 1
End If
Next
Next
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
345
5
Commands by Subsystem
:MEASure:RISetime
(see page 798)
Command Syntax
:MEASure: RISetime [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:RISetime command installs a screen measurement and
starts a rise- time measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure: RISetime? [<source>]
The :MEASure:RISetime? query measures and outputs the rise time of the
displayed rising (positive- going) edge closest to the trigger reference. For
maximum measurement accuracy, set the sweep speed as fast as possible
while leaving the leading edge of the waveform on the display. The rise
time is determined by measuring the time at the lower threshold of the
rising edge and the time at the upper threshold of the rising edge, then
calculating the rise time with the following formula:
rise time = time at upper threshold - time at lower threshold
Return Format
<value><NL>
<value> ::= rise time in seconds in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:FALLtime" on page 334
346
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:SDEViation
(see page 798)
Command Syntax
:MEASure:SDEViation [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:SDEViation command installs a screen measurement and
starts std deviation measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:SDEViation? [<source>]
The :MEASure:SDEViation? query measures and outputs the std deviation
of the selected waveform. The oscilloscope computes the std deviation on
all displayed data points.
Return Format
<value><NL>
<value> ::= calculated std deviation value in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
347
5
Commands by Subsystem
:MEASure:SHOW
(see page 798)
Command Syntax
:MEASure:SHOW <show>
<show> ::= {1 | ON}
The :MEASure:SHOW command enables markers for tracking measurements
on the display. This feature is always on.
Query Syntax
:MEASure:SHOW?
The :MEASure:SHOW? query returns the current state of the markers.
Return Format
<show><NL>
<show> ::= 1
See Also
348
• "Introduction to :MEASure Commands" on page 324
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:SOURce
(see page 798)
Command Syntax
:MEASure:SOURce <source1>[,<source2>]
<source1>,<source2> ::= {<digital channels> | CHANnel<n> | FUNCtion
| MATH | EXTernal}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:SOURce command sets the default sources for
measurements. The specified sources are used as the sources for the
MEASure subsystem commands if the sources are not explicitly set with
the command.
If a source is specified for any measurement, the current source is
changed to this new value.
If :MARKer:MODE is set to OFF or MANual, setting :MEASure:SOURce to
CHANnel<n>, FUNCtion, or MATH will also set :MARKer:X1Y1source to
source1 and :MARKer:X2Y2source to source2.
EXTernal is only a valid source for the counter measurement (and
<source1>).
Query Syntax
:MEASure:SOURce?
The :MEASure:SOURce? query returns the current source selections. If
source2 is not specified, the query returns "NONE" for source2. If all
channels are off, the query returns "NONE,NONE". Source2 only applies to
:MEASure:DELay and :MEASure:PHASe measurements.
NOTE
Return Format
MATH is an alias for FUNCtion. The query will return FUNC if the source is FUNCtion or
MATH.
<source1>,<source2><NL>
<source1>,<source2> ::= {<digital channels> | CHAN<n> | FUNC | EXT
| NONE}
See Also:
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:MODE" on page 309
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Y2source" on page 313
• ":MEASure:DELay" on page 331
• ":MEASure:PHASe" on page 340
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
349
5
Commands by Subsystem
Example Code
' MEASURE - The commands in the MEASURE subsystem are used to make
' measurements on displayed waveforms.
myScope.WriteString ":MEASURE:SOURCE CHANNEL1"
' Source to measure.
myScope.WriteString ":MEASURE:FREQUENCY?"
' Query for frequency.
varQueryResult = myScope.ReadNumber
' Read frequency.
MsgBox "Frequency:" + vbCrLf _
+ FormatNumber(varQueryResult / 1000, 4) + " kHz"
myScope.WriteString ":MEASURE:DUTYCYCLE?"
' Query for duty cycle.
varQueryResult = myScope.ReadNumber
' Read duty cycle.
MsgBox "Duty cycle:" + vbCrLf _
+ FormatNumber(varQueryResult, 3) + "%"
myScope.WriteString ":MEASURE:RISETIME?"
' Query for risetime.
varQueryResult = myScope.ReadNumber
' Read risetime.
MsgBox "Risetime:" + vbCrLf _
+ FormatNumber(varQueryResult * 1000000, 4) + " us"
myScope.WriteString ":MEASURE:VPP?"
' Query for Pk to Pk voltage.
varQueryResult = myScope.ReadNumber
' Read VPP.
MsgBox "Peak to peak voltage:" + vbCrLf _
+ FormatNumber(varQueryResult, 4) + " V"
myScope.WriteString ":MEASURE:VMAX?"
' Query for Vmax.
varQueryResult = myScope.ReadNumber
' Read Vmax.
MsgBox "Maximum voltage:" + vbCrLf _
+ FormatNumber(varQueryResult, 4) + " V"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
350
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:STATistics
(see page 798)
Command Syntax
:MEASure:STATistics <type>
<type> ::= {{ON | 1} | CURRent | MINimum | MAXimum | MEAN | STDDev
| COUNt}
The :MEASure:STATistics command determines the type of information
returned by the :MEASure:RESults? query. ON means all the statistics are
on.
Query Syntax
:MEASure:STATistics?
The :MEASure:STATistics? query returns the current statistics mode.
Return Format
<type><NL>
<type> ::= {ON | CURR | MIN | MAX | MEAN | STDD | COUN}
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:RESults" on page 343
• ":MEASure:STATistics:RESet" on page 353
• ":MEASure:STATistics:INCRement" on page 352
Example Code
• "Example Code" on page 343
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
351
5
Commands by Subsystem
:MEASure:STATistics:INCRement
(see page 798)
Command Syntax
:MEASure:STATistics:INCRement
This command updates the statistics once (incrementing the count by one)
using the current measurement values. It corresponds to the front panel
Increment Statistics softkey in the Measurement Statistics Menu. This
command lets you, for example, gather statistics over multiple pulses
captured in a single acquisition. To do this, change the horizontal position
and enter the command for each new pulse that is measured.
This command is only allowed when the oscilloscope is stopped and quick
measurements are on.
The command is allowed in segmented acquisition mode even though the
corresponding front panel softkey is not available.
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:STATistics" on page 351
• ":MEASure:STATistics:RESet" on page 353
• ":MEASure:RESults" on page 343
352
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:STATistics:RESet
(see page 798)
Command Syntax
:MEASure:STATistics:RESet
This command resets the measurement statistics, zeroing the counts.
Note that the measurement (statistics) configuration is not deleted.
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:STATistics" on page 351
• ":MEASure:RESults" on page 343
• ":MEASure:STATistics:INCRement" on page 352
Example Code
• "Example Code" on page 343
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
353
5
Commands by Subsystem
:MEASure:TEDGe
(see page 798)
Query Syntax
:MEASure:TEDGe? <slope><occurrence>[,<source>]
<slope> ::= direction of the waveform. A rising slope is indicated by a
space or plus sign (+). A falling edge is indicated by a
minus sign (-).
<occurrence> ::= the transition to be reported. If the occurrence number
is one, the first crossing from the left screen edge is
reported. If the number is two, the second crossing is
reported, etc.
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
When the :MEASure:TEDGe query is sent, the displayed signal is searched
for the specified transition. The time interval between the trigger event
and this occurrence is returned as the response to the query. The sign of
the slope selects a rising (+) or falling (- ) edge. If no sign is specified for
the slope, it is assumed to be the rising edge.
The magnitude of occurrence defines the occurrence to be reported. For
example, +3 returns the time for the third time the waveform crosses the
midpoint threshold in the positive direction. Once this crossing is found,
the oscilloscope reports the time at that crossing in seconds, with the
trigger point (time zero) as the reference.
If the specified crossing cannot be found, the oscilloscope reports
+9.9E+37. This value is returned if the waveform does not cross the
specified vertical value, or if the waveform does not cross the specified
vertical value for the specific number of times in the direction specified.
You can make delay and phase measurements using the MEASure:TEDGe
command:
Delay = time at the nth rising or falling edge of the channel - time at
the same edge of another channel
Phase = (delay between channels / period of channel) x 360
For an example of making a delay and phase measurement, see
":MEASure:TEDGe Code" on page 355.
If the optional source parameter is specified, the current source is
modified.
354
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
NOTE
Return Format
5
This query is not available if the source is FFT (Fast Fourier Transform).
<value><NL>
<value> ::= time in seconds of the specified transition in NR3 format
:MEASure:TEDGe
Code
' Make a delay measurement between channel 1 and 2.
Dim dblChan1Edge1 As Double
Dim dblChan2Edge1 As Double
Dim dblChan1Edge2 As Double
Dim dblDelay As Double
Dim dblPeriod As Double
Dim dblPhase As Double
' Query time at 1st rising edge on ch1.
myScope.WriteString ":MEASURE:TEDGE? +1, CHAN1"
' Read time at edge 1 on ch 1.
dblChan1Edge1 = myScope.ReadNumber
' Query time at 1st rising edge on ch2.
myScope.WriteString ":MEASURE:TEDGE? +1, CHAN2"
' Read time at edge 1 on ch 2.
dblChan2Edge1 = myScope.ReadNumber
' Calculate delay time between ch1 and ch2.
dblDelay = dblChan2Edge1 - dblChan1Edge1
' Write calculated delay time to screen.
MsgBox "Delay = " + vbCrLf + CStr(dblDelay)
' Make a phase difference measurement between channel 1 and 2.
' Query time at 1st rising edge on ch1.
myScope.WriteString ":MEASURE:TEDGE? +2, CHAN1"
' Read time at edge 2 on ch 1.
dblChan1Edge2 = myScope.ReadNumber
' Calculate period of ch 1.
dblPeriod = dblChan1Edge2 - dblChan1Edge1
' Calculate phase difference between ch1 and ch2.
dblPhase = (dblDelay / dblPeriod) * 360
MsgBox "Phase = " + vbCrLf + CStr(dblPhase)
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:TVALue" on page 356
• ":MEASure:VTIMe" on page 366
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
355
5
Commands by Subsystem
:MEASure:TVALue
(see page 798)
Query Syntax
:MEASure:TVALue? <value>, [<slope>]<occurrence>[,<source>]
<value> ::= the vertical value that the waveform must cross. The
value can be volts or a math function value such as dB,
Vs, or V/s.
<slope> ::= direction of the waveform. A rising slope is indicated
by a plus sign (+). A falling edge is indicated by a
minus sign (-).
<occurrence> ::= the transition to be reported. If the occurrence
number is one, the first crossing is reported. If
the number is two, the second crossing is reported,
etc.
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
When the :MEASure:TVALue? query is sent, the displayed signal is
searched for the specified value level and transition. The time interval
between the trigger event and this defined occurrence is returned as the
response to the query.
The specified value can be negative or positive. To specify a negative
value, use a minus sign (- ). The sign of the slope selects a rising (+) or
falling (- ) edge. If no sign is specified for the slope, it is assumed to be
the rising edge.
The magnitude of the occurrence defines the occurrence to be reported.
For example, +3 returns the time for the third time the waveform crosses
the specified value level in the positive direction. Once this value crossing
is found, the oscilloscope reports the time at that crossing in seconds,
with the trigger point (time zero) as the reference.
If the specified crossing cannot be found, the oscilloscope reports
+9.9E+37. This value is returned if the waveform does not cross the
specified value, or if the waveform does not cross the specified value for
the specified number of times in the direction specified.
If the optional source parameter is specified, the current source is
modified.
NOTE
Return Format
356
This query is not available if the source is FFT (Fast Fourier Transform).
<value><NL>
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
<value> ::= time in seconds of the specified value crossing in
NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:TEDGe" on page 354
• ":MEASure:VTIMe" on page 366
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
357
5
Commands by Subsystem
:MEASure:VAMPlitude
(see page 798)
Command Syntax
:MEASure:VAMPlitude [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VAMPlitude command installs a screen measurement and
starts a vertical amplitude measurement. If the optional source parameter
is specified, the current source is modified.
Query Syntax
:MEASure:VAMPlitude? [<source>]
The :MEASure:VAMPlitude? query measures and returns the vertical
amplitude of the waveform. To determine the amplitude, the instrument
measures Vtop and Vbase, then calculates the amplitude as follows:
vertical amplitude = Vtop - Vbase
Return Format
<value><NL>
<value> ::= the amplitude of the selected waveform in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VBASe" on page 360
• ":MEASure:VTOP" on page 367
• ":MEASure:VPP" on page 363
358
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:VAVerage
(see page 798)
Command Syntax
:MEASure:VAVerage [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VAVerage command installs a screen measurement and
starts an average value measurement. If the optional source parameter is
specified, the current source is modified.
Query Syntax
:MEASure:VAVerage? [<source>]
The :MEASure:VAVerage? query returns the average value of an integral
number of periods of the signal. If at least three edges are not present, the
oscilloscope averages all data points.
Return Format
<value><NL>
<value> ::= calculated average value in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
359
5
Commands by Subsystem
:MEASure:VBASe
(see page 798)
Command Syntax
:MEASure:VBASe [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VBASe command installs a screen measurement and starts a
waveform base value measurement. If the optional source parameter is
specified, the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:VBASe? [<source>]
The :MEASure:VBASe? query returns the vertical value at the base of the
waveform. The base value of a pulse is normally not the same as the
minimum value.
Return Format
<base_voltage><NL>
<base_voltage> ::= value at the base of the selected waveform in
NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VTOP" on page 367
• ":MEASure:VAMPlitude" on page 358
• ":MEASure:VMIN" on page 362
360
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:VMAX
(see page 798)
Command Syntax
:MEASure:VMAX [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VMAX command installs a screen measurement and starts a
maximum vertical value measurement. If the optional source parameter is
specified, the current source is modified.
Query Syntax
:MEASure:VMAX? [<source>]
The :MEASure:VMAX? query measures and outputs the maximum vertical
value present on the selected waveform.
Return Format
<value><NL>
<value> ::= maximum vertical value of the selected waveform in
NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VMIN" on page 362
• ":MEASure:VPP" on page 363
• ":MEASure:VTOP" on page 367
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
361
5
Commands by Subsystem
:MEASure:VMIN
(see page 798)
Command Syntax
:MEASure:VMIN [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VMIN command installs a screen measurement and starts a
minimum vertical value measurement. If the optional source parameter is
specified, the current source is modified.
Query Syntax
:MEASure:VMIN? [<source>]
The :MEASure:VMIN? query measures and outputs the minimum vertical
value present on the selected waveform.
Return Format
<value><NL>
<value> ::= minimum vertical value of the selected waveform in
NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VBASe" on page 360
• ":MEASure:VMAX" on page 361
• ":MEASure:VPP" on page 363
362
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:VPP
(see page 798)
Command Syntax
:MEASure:VPP [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VPP command installs a screen measurement and starts a
vertical peak- to- peak measurement. If the optional source parameter is
specified, the current source is modified.
Query Syntax
:MEASure:VPP? [<source>]
The :MEASure:VPP? query measures the maximum and minimum vertical
value for the selected source, then calculates the vertical peak- to- peak
value and returns that value. The peak- to- peak value (Vpp) is calculated
with the following formula:
Vpp = Vmax - Vmin
Vmax and Vmin are the vertical maximum and minimum values present on
the selected source.
Return Format
<value><NL>
<value> ::= vertical peak to peak value in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VMAX" on page 361
• ":MEASure:VMIN" on page 362
• ":MEASure:VAMPlitude" on page 358
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
363
5
Commands by Subsystem
:MEASure:VRATio
(see page 798)
Command Syntax
:MEASure:VRATio [<source1>][,<source2>]
<source1>, <source2> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VRATio command places the instrument in the continuous
measurement mode and starts a ratio measurement.
Query Syntax
:MEASure:VRATio? [<source1>][,<source2>]
The :MEASure:VRATio? query measures and returns the ratio of AC RMS
values of the specified sources expressed as dB.
Return Format
<value><NL>
<value> ::= the ratio value in dB in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:VRMS" on page 365
• ":MEASure:SOURce" on page 349
364
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MEASure:VRMS
(see page 798)
Command Syntax
:MEASure:VRMS [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VRMS command installs a screen measurement and starts a
dc RMS value measurement. If the optional source parameter is specified,
the current source is modified.
NOTE
Query Syntax
This command is not available if the source is FFT (Fast Fourier Transform).
:MEASure:VRMS? [<source>]
The :MEASure:VRMS? query measures and outputs the dc RMS value of
the selected waveform. The dc RMS value is measured on an integral
number of periods of the displayed signal. If at least three edges are not
present, the oscilloscope computes the RMS value on all displayed data
points.
Return Format
<value><NL>
<value> ::= calculated dc RMS value in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
365
5
Commands by Subsystem
:MEASure:VTIMe
(see page 798)
Query Syntax
:MEASure:VTIMe? <vtime_argument>[,<source>]
<vtime_argument> ::= time from trigger in seconds
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= DIGital0,..,DIGital15 for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VTIMe? query returns the value at a specified time on the
source specified with :MEASure:SOURce. The specified time must be on
the screen and is referenced to the trigger event. If the optional source
parameter is specified, the current source is modified.
NOTE
Return Format
This query is not available if the source is FFT (Fast Fourier Transform).
<value><NL>
<value> ::= value at the specified time in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:TEDGe" on page 354
• ":MEASure:TVALue" on page 356
366
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:VTOP
(see page 798)
Command Syntax
:MEASure:VTOP [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:VTOP command installs a screen measurement and starts a
waveform top value measurement.
NOTE
Query Syntax
This query is not available if the source is FFT (Fast Fourier Transform).
:MEASure:VTOP? [<source>]
The :MEASure:VTOP? query returns the vertical value at the top of the
waveform. The top value of the pulse is normally not the same as the
maximum value.
Return Format
<value><NL>
<value> ::= vertical value at the top of the waveform in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:SOURce" on page 349
• ":MEASure:VMAX" on page 361
• ":MEASure:VAMPlitude" on page 358
• ":MEASure:VBASe" on page 360
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
367
5
Commands by Subsystem
:MEASure:XMAX
(see page 798)
Command Syntax
:MEASure:XMAX [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:XMAX command installs a screen measurement and starts
an X- at- Max- Y measurement on the selected window. If the optional
source parameter is specified, the current source is modified.
NOTE
Query Syntax
:MEASure:XMAX is an alias for :MEASure:TMAX.
:MEASure:XMAX? [<source>]
The :MEASure:XMAX? query measures and returns the horizontal axis
value at which the maximum vertical value occurs. If the optional source
is specified, the current source is modified. If all channels are off, the
query returns 9.9E+37.
Return Format
<value><NL>
<value> ::= horizontal value of the maximum in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:XMIN" on page 369
• ":MEASure:TMAX" on page 729
368
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MEASure:XMIN
(see page 798)
Command Syntax
:MEASure:XMIN [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:XMIN command installs a screen measurement and starts
an X- at- Min- Y measurement on the selected window. If the optional source
parameter is specified, the current source is modified.
NOTE
Query Syntax
:MEASure:XMIN is an alias for :MEASure:TMIN.
:MEASure:XMIN? [<source>]
The :MEASure:XMIN? query measures and returns the horizontal axis
value at which the minimum vertical value occurs. If the optional source is
specified, the current source is modified. If all channels are off, the query
returns 9.9E+37.
Return Format
<value><NL>
<value> ::= horizontal value of the minimum in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:XMAX" on page 368
• ":MEASure:TMIN" on page 730
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
369
5
Commands by Subsystem
:MTESt Commands
The MTESt subsystem commands and queries control the mask test
features. See "Introduction to :MTESt Commands" on page 372.
Table 70 :MTESt Commands Summary
Command
Query
Options and Query Returns
:MTESt:AMASk:CREate
(see page 375)
n/a
n/a
:MTESt:AMASk:SOURce
<source> (see
page 376)
:MTESt:AMASk:SOURce?
(see page 376)
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
:MTESt:AMASk:UNITs
<units> (see
page 377)
:MTESt:AMASk:UNITs?
(see page 377)
<units> ::= {CURRent | DIVisions}
:MTESt:AMASk:XDELta
<value> (see
page 378)
:MTESt:AMASk:XDELta?
(see page 378)
<value> ::= X delta value in NR3
format
:MTESt:AMASk:YDELta
<value> (see
page 379)
:MTESt:AMASk:YDELta?
(see page 379)
<value> ::= Y delta value in NR3
format
n/a
:MTESt:COUNt:FWAVefor
ms? [CHANnel<n>] (see
page 380)
<failed> ::= number of failed
waveforms in NR1 format
:MTESt:COUNt:RESet
(see page 381)
n/a
n/a
n/a
:MTESt:COUNt:TIME?
(see page 382)
<time> ::= elapsed seconds in NR3
format
n/a
:MTESt:COUNt:WAVeform
s? (see page 383)
<count> ::= number of waveforms
in NR1 format
:MTESt:DATA <mask>
(see page 384)
:MTESt:DATA? (see
page 384)
<mask> ::= data in IEEE 488.2 #
format.
:MTESt:DELete (see
page 385)
n/a
n/a
:MTESt:ENABle {{0 |
OFF} | {1 | ON}} (see
page 386)
:MTESt:ENABle? (see
page 386)
{0 | 1}
:MTESt:LOCK {{0 |
OFF} | {1 | ON}} (see
page 387)
:MTESt:LOCK? (see
page 387)
{0 | 1}
370
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 70 :MTESt Commands Summary (continued)
Command
Query
Options and Query Returns
:MTESt:OUTPut
<signal> (see
page 388)
:MTESt:OUTPut? (see
page 388)
<signal> ::= {FAIL | PASS}
:MTESt:RMODe <rmode>
(see page 389)
:MTESt:RMODe? (see
page 389)
<rmode> ::= {FORever | TIME |
SIGMa | WAVeforms}
:MTESt:RMODe:FACTion:
MEASure {{0 | OFF} |
{1 | ON}} (see
page 390)
:MTESt:RMODe:FACTion:
MEASure? (see
page 390)
{0 | 1}
:MTESt:RMODe:FACTion:
PRINt {{0 | OFF} | {1
| ON}} (see page 391)
:MTESt:RMODe:FACTion:
PRINt? (see page 391)
{0 | 1}
:MTESt:RMODe:FACTion:
SAVE {{0 | OFF} | {1
| ON}} (see page 392)
:MTESt:RMODe:FACTion:
SAVE? (see page 392)
{0 | 1}
:MTESt:RMODe:FACTion:
STOP {{0 | OFF} | {1
| ON}} (see page 393)
:MTESt:RMODe:FACTion:
STOP? (see page 393)
{0 | 1}
:MTESt:RMODe:SIGMa
<level> (see
page 394)
:MTESt:RMODe:SIGMa?
(see page 394)
<level> ::= from 0.1 to 9.3 in
NR3 format
:MTESt:RMODe:TIME
<seconds> (see
page 395)
:MTESt:RMODe:TIME?
(see page 395)
<seconds> ::= from 1 to 86400 in
NR3 format
:MTESt:RMODe:WAVeform
s <count> (see
page 396)
:MTESt:RMODe:WAVeform
s? (see page 396)
<count> ::= number of waveforms
in NR1 format
:MTESt:SCALe:BIND {{0
| OFF} | {1 | ON}}
(see page 397)
:MTESt:SCALe:BIND?
(see page 397)
{0 | 1}
:MTESt:SCALe:X1
<x1_value> (see
page 398)
:MTESt:SCALe:X1? (see
page 398)
<x1_value> ::= X1 value in NR3
format
:MTESt:SCALe:XDELta
<xdelta_value> (see
page 399)
:MTESt:SCALe:XDELta?
(see page 399)
<xdelta_value> ::= X delta value
in NR3 format
:MTESt:SCALe:Y1
<y1_value> (see
page 400)
:MTESt:SCALe:Y1? (see
page 400)
<y1_value> ::= Y1 value in NR3
format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
371
5
Commands by Subsystem
Table 70 :MTESt Commands Summary (continued)
Command
Query
Options and Query Returns
:MTESt:SCALe:Y2
<y2_value> (see
page 401)
:MTESt:SCALe:Y2? (see
page 401)
<y2_value> ::= Y2 value in NR3
format
:MTESt:SOURce
<source> (see
page 402)
:MTESt:SOURce? (see
page 402)
<source> ::= {CHANnel<n> | NONE}
<n> ::= {1 | 2 | 3 | 4} for 4ch
models
<n> ::= {1 | 2} for 2ch models
n/a
:MTESt:TITLe? (see
page 403)
<title> ::= a string of up to 128
ASCII characters
Introduction to
:MTESt
Commands
Mask testing automatically compares the current displayed waveform with
the boundaries of a set of polygons that you define. Any waveform or
sample that falls within the boundaries of one or more polygons is
recorded as a failure.
Reporting the Setup
Use :MTESt? to query setup information for the MTESt subsystem.
Return Format
The following is a sample response from the :MTESt? query. In this case,
the query was issued following a *RST command.
:MTES:SOUR CHAN1;ENAB 0;LOCK 1;:MTES:AMAS:SOUR CHAN1;UNIT DIV;XDEL
+2.50000000E-001;YDEL +2.50000000E-001;:MTES:SCAL:X1 +200.000E-06;XDEL
+400.000E-06;Y1 -3.00000E+00;Y2 +3.00000E+00;BIND 0;:MTES:RMOD
FOR;RMOD:TIME +1E+00;WAV 1000;SIGM +6.0E+00;:MTES:RMOD:FACT:STOP
0;PRIN 0;SAVE 0
Example Code
' Mask testing commands example.
' ------------------------------------------------------------------Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.70.228::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
' Make sure oscilloscope is running.
myScope.WriteString ":RUN"
' Set mask test termination conditions.
myScope.WriteString ":MTESt:RMODe SIGMa"
myScope.WriteString ":MTESt:RMODe?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test termination mode: " + strQueryResult
myScope.WriteString ":MTESt:RMODe:SIGMa 4.2"
myScope.WriteString ":MTESt:RMODe:SIGMa?"
varQueryResult = myScope.ReadNumber
Debug.Print "Mask test termination 'test sigma': " + _
FormatNumber(varQueryResult)
' Use auto-mask to create mask.
myScope.WriteString ":MTESt:AMASk:SOURce CHANnel1"
myScope.WriteString ":MTESt:AMASk:SOURce?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test auto-mask source: " + strQueryResult
myScope.WriteString ":MTESt:AMASk:UNITs DIVisions"
myScope.WriteString ":MTESt:AMASk:UNITs?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test auto-mask units: " + strQueryResult
myScope.WriteString ":MTESt:AMASk:XDELta 0.1"
myScope.WriteString ":MTESt:AMASk:XDELta?"
varQueryResult = myScope.ReadNumber
Debug.Print "Mask test auto-mask X delta: " + _
FormatNumber(varQueryResult)
myScope.WriteString ":MTESt:AMASk:YDELta 0.1"
myScope.WriteString ":MTESt:AMASk:YDELta?"
varQueryResult = myScope.ReadNumber
Debug.Print "Mask test auto-mask Y delta: " + _
FormatNumber(varQueryResult)
' Enable "Auto Mask Created" event (bit 10, &H400)
myScope.WriteString "*CLS"
myScope.WriteString ":MTEenable " + CStr(CInt("&H400"))
' Create mask.
myScope.WriteString ":MTESt:AMASk:CREate"
Debug.Print "Auto-mask created, mask test automatically enabled."
' Set up timeout variables.
Dim lngTimeout As Long
' Max millisecs to wait.
Dim lngElapsed As Long
lngTimeout = 60000
' 60 seconds.
' Wait until mask is created.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
373
5
Commands by Subsystem
lngElapsed = 0
Do While lngElapsed <= lngTimeout
myScope.WriteString ":OPERegister:CONDition?"
varQueryResult = myScope.ReadNumber
' Operation Status Condition Register MTE bit (bit 9, &H200).
If (varQueryResult And &H200) <> 0 Then
Exit Do
Else
Sleep 100
' Small wait to prevent excessive queries.
lngElapsed = lngElapsed + 100
End If
Loop
' Look for RUN bit = stopped (mask test termination).
lngElapsed = 0
Do While lngElapsed <= lngTimeout
myScope.WriteString ":OPERegister:CONDition?"
varQueryResult = myScope.ReadNumber
' Operation Status Condition Register RUN bit (bit 3, &H8).
If (varQueryResult And &H8) = 0 Then
Exit Do
Else
Sleep 100
' Small wait to prevent excessive queries.
lngElapsed = lngElapsed + 100
End If
Loop
' Get total waveforms, failed waveforms, and test time.
myScope.WriteString ":MTESt:COUNt:WAVeforms?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test total waveforms: " + strQueryResult
myScope.WriteString ":MTESt:COUNt:FWAVeforms?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test failed waveforms: " + strQueryResult
myScope.WriteString ":MTESt:COUNt:TIME?"
strQueryResult = myScope.ReadString
Debug.Print "Mask test elapsed seconds: " + strQueryResult
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
374
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:AMASk:CREate
(see page 798)
Command Syntax
:MTESt:AMASk:CREate
The :MTESt:AMASk:CREate command automatically constructs a mask
around the current selected channel, using the tolerance parameters
defined by the :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and
:MTESt:AMASk:UNITs commands. The mask only encompasses the portion
of the waveform visible on the display, so you must ensure that the
waveform is acquired and displayed consistently to obtain repeatable
results.
The :MTESt:SOURce command selects the channel and should be set before
using this command.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:YDELta" on page 379
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:SOURce" on page 402
Example Code
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
375
5
Commands by Subsystem
:MTESt:AMASk:SOURce
(see page 798)
Command Syntax
:MTESt:AMASk:SOURce <source>
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MTESt:AMASk:SOURce command selects the source for the
interpretation of the :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta
parameters when :MTESt:AMASk:UNITs is set to CURRent.
When UNITs are CURRent, the XDELta and YDELta parameters are
defined in terms of the channel units, as set by the :CHANnel<n>:UNITs
command, of the selected source.
Suppose that UNITs are CURRent and that you set SOURce to CHANNEL1,
which is using units of volts. Then you can define AMASk:XDELta in
terms of volts and AMASk:YDELta in terms of seconds.
This command is the same as the :MTESt:SOURce command.
Query Syntax
:MTESt:AMASk:SOURce?
The :MTESt:AMASk:SOURce? query returns the currently set source.
Return Format
<source> ::= CHAN<n>
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:YDELta" on page 379
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:SOURce" on page 402
Example Code
376
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTESt:AMASk:UNITs
(see page 798)
Command Syntax
:MTESt:AMASk:UNITs <units>
<units> ::= {CURRent | DIVisions}
The :MTESt:AMASk:UNITs command alters the way the mask test
subsystem interprets the tolerance parameters for automasking as defined
by :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta commands.
• CURRent — the mask test subsystem uses the units as set by the
:CHANnel<n>:UNITs command, usually time for ΔX and voltage for ΔY.
• DIVisions — the mask test subsystem uses the graticule as the
measurement system, so tolerance settings are specified as parts of a
screen division. The mask test subsystem maintains separate XDELta
and YDELta settings for CURRent and DIVisions. Thus, XDELta and
YDELta are not converted to new values when the UNITs setting is
changed.
Query Syntax
:MTESt:AMASk:UNITs?
The :MTESt:AMASk:UNITs query returns the current measurement units
setting for the mask test automask feature.
Return Format
<units><NL>
<units> ::= {CURR | DIV}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:YDELta" on page 379
• ":CHANnel<n>:UNITs" on page 247
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:SOURce" on page 402
Example Code
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
377
5
Commands by Subsystem
:MTESt:AMASk:XDELta
(see page 798)
Command Syntax
:MTESt:AMASk:XDELta <value>
<value> ::= X delta value in NR3 format
The :MTESt:AMASk:XDELta command sets the tolerance in the X direction
around the waveform for the automasking feature. The absolute value of
the tolerance will be added and subtracted to horizontal values of the
waveform to determine the boundaries of the mask.
The horizontal tolerance value is interpreted based on the setting specified
by the :MTESt:AMASk:UNITs command; thus, if you specify 250- E3, the
setting for :MTESt:AMASk:UNITs is CURRent, and the current setting
specifies time in the horizontal direction, the tolerance will be ±250 ms. If
the setting for :MTESt:AMASk:UNITs is DIVisions, the same X delta value
will set the tolerance to ±250 millidivisions, or 1/4 of a division.
Query Syntax
:MTESt:AMASk:XDELta?
The :MTEST:AMASk:XDELta? query returns the current setting of the ΔX
tolerance for automasking. If your computer program will interpret this
value, it should also request the current measurement system using the
:MTESt:AMASk:UNITs query.
Return Format
<value><NL>
<value> ::= X delta value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:AMASk:YDELta" on page 379
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:SOURce" on page 402
Example Code
378
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTESt:AMASk:YDELta
(see page 798)
Command Syntax
:MTESt:AMASk:YDELta <value>
<value> ::= Y delta value in NR3 format
The :MTESt:AMASk:YDELta command sets the vertical tolerance around
the waveform for the automasking feature. The absolute value of the
tolerance will be added and subtracted to vertical values of the waveform
to determine the boundaries of the mask.
The vertical tolerance value is interpreted based on the setting specified
by the :MTESt:AMASk:UNITs command; thus, if you specify 250- E3, the
setting for :MTESt:AMASk:UNITs is CURRent, and the current setting
specifies voltage in the vertical direction, the tolerance will be ±250 mV. If
the setting for :MTESt:AMASk:UNITs is DIVisions, the same Y delta value
will set the tolerance to ±250 millidivisions, or 1/4 of a division.
Query Syntax
:MTESt:AMASk:YDELta?
The :MTESt:AMASk:YDELta? query returns the current setting of the ΔY
tolerance for automasking. If your computer program will interpret this
value, it should also request the current measurement system using the
:MTESt:AMASk:UNITs query.
Return Format
<value><NL>
<value> ::= Y delta value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:SOURce" on page 402
Example Code
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
379
5
Commands by Subsystem
:MTESt:COUNt:FWAVeforms
(see page 798)
Query Syntax
:MTESt:COUNt:FWAVeforms? [CHANnel<n>]
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MTESt:COUNt:FWAVeforms? query returns the total number of failed
waveforms in the current mask test run. This count is for all regions and
all waveforms.
Return Format
<failed><NL>
<failed> ::= number of failed waveforms in NR1 format.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:COUNt:WAVeforms" on page 383
• ":MTESt:COUNt:TIME" on page 382
• ":MTESt:COUNt:RESet" on page 381
• ":MTESt:SOURce" on page 402
Example Code
380
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:COUNt:RESet
(see page 798)
Command Syntax
:MTESt:COUNt:RESet
The :MTESt:COUNt:RESet command resets the mask statistics.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:COUNt:WAVeforms" on page 383
• ":MTESt:COUNt:FWAVeforms" on page 380
• ":MTESt:COUNt:TIME" on page 382
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
381
5
Commands by Subsystem
:MTESt:COUNt:TIME
(see page 798)
Query Syntax
:MTESt:COUNt:TIME?
The :MTESt:COUNt:TIME? query returns the elapsed time in the current
mask test run.
Return Format
<time><NL>
<time> ::= elapsed seconds in NR3 format.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:COUNt:WAVeforms" on page 383
• ":MTESt:COUNt:FWAVeforms" on page 380
• ":MTESt:COUNt:RESet" on page 381
Example Code
382
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:COUNt:WAVeforms
(see page 798)
Query Syntax
:MTESt:COUNt:WAVeforms?
The :MTESt:COUNt:WAVeforms? query returns the total number of
waveforms acquired in the current mask test run.
Return Format
<count><NL>
<count> ::= number of waveforms in NR1 format.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:COUNt:FWAVeforms" on page 380
• ":MTESt:COUNt:TIME" on page 382
• ":MTESt:COUNt:RESet" on page 381
Example Code
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
383
5
Commands by Subsystem
:MTESt:DATA
(see page 798)
Command Syntax
:MTESt:DATA <mask>
<mask> ::= binary block data in IEEE 488.2 # format.
The :MTESt:DATA command loads a mask from binary block data.
Query Syntax
:MTESt:DATA?
The :MTESt:DATA? query returns a mask in binary block data format. The
format for the data transmission is the # format defined in the IEEE 488.2
specification.
Return Format
<mask><NL>
<mask> ::= binary block data in IEEE 488.2 # format
See Also
• ":SAVE:MASK[:STARt]" on page 425
• ":RECall:MASK[:STARt]" on page 412
384
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:DELete
(see page 798)
Command Syntax
:MTESt:DELete
The :MTESt:DELete command clears the currently loaded mask.
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:CREate" on page 375
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
385
5
Commands by Subsystem
:MTESt:ENABle
(see page 798)
Command Syntax
:MTESt:ENABle <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:ENABle command enables or disables the mask test features.
• ON — Enables the mask test features.
• OFF — Disables the mask test features.
Query Syntax
:MTESt:ENABle?
The :MTESt:ENABle? query returns the current state of mask test features.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
386
• "Introduction to :MTESt Commands" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:LOCK
(see page 798)
Command Syntax
:MTESt:LOCK <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:LOCK command enables or disables the mask lock feature:
• ON — Locks a mask to the SOURce. As the vertical or horizontal scaling
or position of the SOURce changes, the mask is redrawn accordingly.
• OFF — The mask is static and does not move.
Query Syntax
:MTESt:LOCK?
The :MTESt:LOCK? query returns the current mask lock setting.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SOURce" on page 402
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
387
5
Commands by Subsystem
:MTESt:OUTPut
(see page 798)
Command Syntax
:MTESt:OUTPut <signal>
<signal> ::= {FAIL | PASS}
The :MTESt:OUTPut command selects the mask test output condition:
• FAIL — the output occurs when there are mask test failures.
• PASS — the output occurs when the mask test passes.
You can place the mask test signal on the rear panel TRIG OUT BNC using
the ":CALibrate:OUTPut" on page 223 command.
Query Syntax
:MTESt:OUTPut?
The :MTESt:OUTPut? query returns the currently set output signal.
Return Format
<signal><NL>
<signal> ::= {FAIL | PASS}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":CALibrate:OUTPut" on page 223
388
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:RMODe
(see page 798)
Command Syntax
:MTESt:RMODe <rmode>
<rmode> ::= {FORever | SIGMa | TIME | WAVeforms}
The :MTESt:RMODe command specifies the termination conditions for the
mask test:
• FORever — the mask test runs until it is turned off.
• SIGMa — the mask test runs until the Sigma level is reached. This level
is set by the ":MTESt:RMODe:SIGMa" on page 394 command.
• TIME — the mask test runs for a fixed amount of time. The amount of
time is set by the ":MTESt:RMODe:TIME" on page 395 command.
• WAVeforms — the mask test runs until a fixed number of waveforms are
acquired. The number of waveforms is set by the
":MTESt:RMODe:WAVeforms" on page 396 command.
Query Syntax
:MTESt:RMODe?
The :MTESt:RMODe? query returns the currently set termination condition.
Return Format
<rmode><NL>
<rmode> ::= {FOR | SIGM | TIME | WAV}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe:SIGMa" on page 394
• ":MTESt:RMODe:TIME" on page 395
• ":MTESt:RMODe:WAVeforms" on page 396
Example Code
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
389
5
Commands by Subsystem
:MTESt:RMODe:FACTion:MEASure
(see page 798)
Command Syntax
:MTESt:RMODe:FACTion:MEASure <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:RMODe:FACTion:MEASure command sets measuring only mask
failures on or off.
When ON, measurements and measurement statistics run only on
waveforms that contain a mask violation; passing waveforms do not affect
measurements and measurement statistics.
This mode is not available when the acquisition mode is set to Averaging.
Query Syntax
:MTESt:RMODe:FACTion:MEASure?
The :MTESt:RMODe:FACTion:MEASure? query returns the current mask
failure measure setting.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":MTESt:RMODe:FACTion:STOP" on page 393
390
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:RMODe:FACTion:PRINt
(see page 798)
Command Syntax
:MTESt:RMODe:FACTion:PRINt <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:RMODe:FACTion:PRINt command sets printing on mask failures
on or off.
NOTE
Setting :MTESt:RMODe:FACTion:PRINt ON automatically sets
:MTESt:RMODe:FACTion:SAVE OFF.
See ":HARDcopy Commands" on page 293 for more information on setting
the hardcopy device and formatting options.
Query Syntax
:MTESt:RMODe:FACTion:PRINt?
The :MTESt:RMODe:FACTion:PRINt? query returns the current mask failure
print setting.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":MTESt:RMODe:FACTion:STOP" on page 393
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
391
5
Commands by Subsystem
:MTESt:RMODe:FACTion:SAVE
(see page 798)
Command Syntax
:MTESt:RMODe:FACTion:SAVE <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:RMODe:FACTion:SAVE command sets saving on mask failures
on or off.
NOTE
Setting :MTESt:RMODe:FACTion:SAVE ON automatically sets
:MTESt:RMODe:FACTion:PRINt OFF.
See ":SAVE Commands" on page 415 for more information on save options.
Query Syntax
:MTESt:RMODe:FACTion:SAVE?
The :MTESt:RMODe:FACTion:SAVE? query returns the current mask failure
save setting.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:STOP" on page 393
392
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:RMODe:FACTion:STOP
(see page 798)
Command Syntax
:MTESt:RMODe:FACTion:STOP <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:RMODe:FACTion:STOP command sets stopping on a mask
failure on or off. When this setting is ON and a mask violation is detected,
the mask test is stopped and the acquisition system is stopped.
Query Syntax
:MTESt:RMODe:FACTion:STOP?
The :MTESt:RMODe:FACTion:STOP? query returns the current mask failure
stop setting.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:SAVE" on page 392
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
393
5
Commands by Subsystem
:MTESt:RMODe:SIGMa
(see page 798)
Command Syntax
:MTESt:RMODe:SIGMa <level>
<level> ::= from 0.1 to 9.3 in NR3 format
When the :MTESt:RMODe command is set to SIGMa, the
:MTESt:RMODe:SIGMa command sets the test sigma level to which a mask
test runs. Test sigma is the best achievable process sigma, assuming no
failures. (Process sigma is calculated using the number of failures per
test.) The test sigma level indirectly specifies the number of waveforms
that must be tested (in order to reach the sigma level).
Query Syntax
:MTESt:RMODe:SIGMa?
The :MTESt:RMODe:SIGMa? query returns the current Sigma level setting.
Return Format
<level><NL>
<level> ::= from 0.1 to 9.3 in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe" on page 389
Example Code
394
• "Example Code" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:RMODe:TIME
(see page 798)
Command Syntax
:MTESt:RMODe:TIME <seconds>
<seconds> ::= from 1 to 86400 in NR3 format
When the :MTESt:RMODe command is set to TIME, the
:MTESt:RMODe:TIME command sets the number of seconds for a mask test
to run.
Query Syntax
:MTESt:RMODe:TIME?
The :MTESt:RMODe:TIME? query returns the number of seconds currently
set.
Return Format
<seconds><NL>
<seconds> ::= from 1 to 86400 in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe" on page 389
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
395
5
Commands by Subsystem
:MTESt:RMODe:WAVeforms
(see page 798)
Command Syntax
:MTESt:RMODe:WAVeforms <count>
<count> ::= number of waveforms in NR1 format
from 1 to 2,000,000,000
When the :MTESt:RMODe command is set to WAVeforms, the
:MTESt:RMODe:WAVeforms command sets the number of waveform
acquisitions that are mask tested.
Query Syntax
:MTESt:RMODe:WAVeforms?
The :MTESt:RMODe:WAVeforms? query returns the number of waveforms
currently set.
Return Format
<count><NL>
<count> ::= number of waveforms in NR1 format
from 1 to 2,000,000,000
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RMODe" on page 389
396
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTESt:SCALe:BIND
(see page 798)
Command Syntax
:MTESt:SCALe:BIND <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:SCALe:BIND command enables or disables Bind 1 & 0 Levels
(Bind - 1 & 0 Levels for inverted masks) control:
• ON —
If the Bind 1 & 0 Levels control is enabled, the 1 Level and the 0 Level
controls track each other. Adjusting either the 1 Level or the 0 Level
control shifts the position of the mask up or down without changing its
size.
If the Bind - 1 & 0 Levels control is enabled, the - 1 Level and the 0
Level controls track each other. Adjusting either the - 1 Level or the 0
Level control shifts the position of the mask up or down without
changing its size.
• OFF —
If the Bind 1 & 0 Levels control is disabled, adjusting either the 1 Level
or the 0 Level control changes the vertical height of the mask.
If the Bind - 1 & 0 Levels control is disabled, adjusting either the - 1
Level or the 0 Level control changes the vertical height of the mask.
Query Syntax
:MTESt:SCALe:BIND?
The :MTESt:SCALe:BIND? query returns the value of the Bind 1&0 control
(Bind - 1&0 for inverted masks).
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y1" on page 400
• ":MTESt:SCALe:Y2" on page 401
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
397
5
Commands by Subsystem
:MTESt:SCALe:X1
(see page 798)
Command Syntax
:MTESt:SCALe:X1 <x1_value>
<x1_value> ::= X1 value in NR3 format
The :MTESt:SCALe:X1 command defines where X=0 in the base coordinate
system used for mask testing. The other X- coordinate is defined by the
:MTESt:SCALe:XDELta command. Once the X1 and XDELta coordinates are
set, all X values of vertices in the mask regions are defined with respect
to this value, according to the equation:
X = (X * ΔX) + X1
Thus, if you set X1 to 100 ms, and XDELta to 100 ms, an X value of 0.100
is a vertex at 110 ms.
The oscilloscope uses this equation to normalize vertices. This simplifies
reprogramming to handle different data rates. For example, if you halve
the period of the waveform of interest, you need only to adjust the
XDELta value to set up the mask for the new waveform.
The X1 value is a time value specifying the location of the X1 coordinate,
which will then be treated as X=0 for mask regions coordinates.
Query Syntax
:MTESt:SCALe:X1?
The :MTESt:SCALe:X1? query returns the current X1 coordinate setting.
Return Format
<x1_value><NL>
<x1_value> ::= X1 value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y1" on page 400
• ":MTESt:SCALe:Y2" on page 401
398
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:SCALe:XDELta
(see page 798)
Command Syntax
:MTESt:SCALe:XDELta <xdelta_value>
<xdelta_value> ::= X delta value in NR3 format
The :MTESt:SCALe:XDELta command defines the position of the X2
marker with respect to the X1 marker. In the mask test coordinate system,
the X1 marker defines where X=0; thus, the X2 marker defines where X=1.
Because all X vertices of the regions defined for mask testing are
normalized with respect to X1 and ΔX, redefining ΔX also moves those
vertices to stay in the same locations with respect to X1 and ΔX. Thus, in
many applications, it is best if you define XDELta as a pulse width or bit
period. Then, a change in data rate without corresponding changes in the
waveform can easily be handled by changing ΔX.
The X- coordinate of polygon vertices is normalized using this equation:
X = (X * ΔX) + X1
The X delta value is a time value specifying the distance of the X2 marker
with respect to the X1 marker.
For example, if the period of the waveform you wish to test is 1 ms,
setting ΔX to 1 ms ensures that the waveform's period is between the X1
and X2 markers.
Query Syntax
:MTESt:SCALe:XDELta?
The :MTESt:SCALe:XDELta? query returns the current value of ΔX.
Return Format
<xdelta_value><NL>
<xdelta_value> ::= X delta value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:Y1" on page 400
• ":MTESt:SCALe:Y2" on page 401
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
399
5
Commands by Subsystem
:MTESt:SCALe:Y1
(see page 798)
Command Syntax
:MTESt:SCALe:Y1 <y1_value>
<y1_value> ::= Y1 value in NR3 format
The :MTESt:SCALe:Y1 command defines where Y=0 in the coordinate
system for mask testing. All Y values of vertices in the coordinate system
are defined with respect to the boundaries set by SCALe:Y1 and SCALe:Y2
according to the equation:
Y = (Y * (Y2 - Y1)) + Y1
Thus, if you set Y1 to 100 mV, and Y2 to 1 V, a Y value of 0.100 in a
vertex is at 190 mV.
The Y1 value is a voltage value specifying the point at which Y=0.
Query Syntax
:MTESt:SCALe:Y1?
The :MTESt:SCALe:Y1? query returns the current setting of the Y1 marker.
Return Format
<y1_value><NL>
<y1_value> ::= Y1 value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y2" on page 401
400
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:MTESt:SCALe:Y2
(see page 798)
Command Syntax
:MTESt:SCALe:Y2 <y2_value>
<y2_value> ::= Y2 value in NR3 format
The :MTESt:SCALe:Y2 command defines the Y2 marker in the coordinate
system for mask testing. All Y values of vertices in the coordinate system
are defined with respect to the boundaries defined by SCALe:Y1 and
SCALe:Y2 according to the following equation:
Y = (Y * (Y2 - Y1)) + Y1
Thus, if you set Y1 to 100 mV, and Y2 to 1 V, a Y value of 0.100 in a
vertex is at 190 mV.
The Y2 value is a voltage value specifying the location of the Y2 marker.
Query Syntax
:MTESt:SCALe:Y2?
The :MTESt:SCALe:Y2? query returns the current setting of the Y2 marker.
Return Format
<y2_value><NL>
<y2_value> ::= Y2 value in NR3 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y1" on page 400
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
401
5
Commands by Subsystem
:MTESt:SOURce
(see page 798)
Command Syntax
:MTESt:SOURce <source>
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MTESt:SOURce command selects the channel which is configured by
the commands contained in a mask file when it is loaded.
Query Syntax
:MTESt:SOURce?
The :MTESt:SOURce? query returns the channel which is configured by the
commands contained in the current mask file.
Return Format
<source><NL>
<source> ::= {CHAN<n> | NONE}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:SOURce" on page 376
402
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:MTESt:TITLe
(see page 798)
Query Syntax
:MTESt:TITLe?
The :MTESt:TITLe? query returns the mask title which is a string of up to
128 characters. The title is displayed in the mask test dialog box and mask
test tab when a mask file is loaded.
Return Format
<title><NL>
<title> ::= a string of up to 128 ASCII characters.
See Also
• "Introduction to :MTESt Commands" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
403
5
Commands by Subsystem
:POD Commands
Control all oscilloscope functions associated with groups of digital
channels. See "Introduction to :POD<n> Commands" on page 404.
Table 71 :POD<n> Commands Summary
Command
Query
Options and Query Returns
:POD<n>:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 405)
:POD<n>:DISPlay? (see
page 405)
{0 | 1}
<n> ::= 1-2 in NR1 format
:POD<n>:SIZE <value>
(see page 406)
:POD<n>:SIZE? (see
page 406)
<value> ::= {SMALl | MEDium |
LARGe}
:POD<n>:THReshold
<type>[suffix] (see
page 407)
:POD<n>:THReshold?
(see page 407)
<n> ::= 1-2 in NR1 format
<type> ::= {CMOS | ECL | TTL |
<user defined value>}
<user defined value> ::= value in
NR3 format
[suffix] ::= {V | mV | uV }
Introduction to
:POD<n>
Commands
<n> ::= {1 | 2}
The POD subsystem commands control the viewing and threshold of
groups of digital channels.
POD1 ::= D0- D7
POD2 ::= D8- D15
NOTE
These commands are only valid for the MSO models.
Reporting the Setup
Use :POD1? or :POD2? to query setup information for the POD subsystem.
Return Format
The following is a sample response from the :POD1? query. In this case,
the query was issued following a *RST command.
:POD1:DISP 0;THR +1.40E+00
404
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:POD<n>:DISPlay
(see page 798)
Command Syntax
:POD<n>:DISPlay <display>
<display> ::= {{1 | ON} | {0 | OFF}}
<n> ::= An integer, 1 or 2, is attached as a suffix to the command and
defines the group of channels that are affected by the command.
POD1 ::= D0-D7
POD2 ::= D8-D15
The :POD<n>:DISPlay command turns displaying of the specified group of
channels on or off.
NOTE
Query Syntax
This command is only valid for the MSO models.
:POD<n>:DISPlay?
The :POD<n>:DISPlay? query returns the current display setting of the
specified group of channels.
Return Format
<display><NL>
<display> ::= {0 | 1}
See Also
• "Introduction to :POD<n> Commands" on page 404
• ":DIGital<n>:DISPlay" on page 251
• ":CHANnel<n>:DISPlay" on page 234
• ":VIEW" on page 192
• ":BLANk" on page 160
• ":STATus" on page 189
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
405
5
Commands by Subsystem
:POD<n>:SIZE
(see page 798)
Command Syntax
:POD<n>:SIZE <value>
<n> ::= An integer, 1 or 2, is attached as a suffix to the command and
defines the group of channels that are affected by the command.
POD1 ::= D0-D7
POD2 ::= D8-D15
<value> ::= {SMALl | MEDium | LARGe}
The :POD<n>:SIZE command specifies the size of digital channels on the
display.
NOTE
Query Syntax
This command is only valid for the MSO models.
:POD<n>:SIZE?
The :POD<n>:SIZE? query returns the size setting for the specified group of
channels.
Return Format
<size_value><NL>
<size_value> ::= {SMAL | MED | LARG}
See Also
• "Introduction to :POD<n> Commands" on page 404
• ":DIGital<n>:SIZE" on page 254
• ":DIGital<n>:POSition" on page 253
406
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:POD<n>:THReshold
(see page 798)
Command Syntax
:POD<n>:THReshold <type>[<suffix>]
<n> ::= An integer, 1 or 2, is attached as a suffix to the command and
defines the group of channels that are affected by the command.
<type> ::= {CMOS | ECL | TTL | <user defined value>}
<user defined value> ::= -8.00 to +8.00 in NR3 format
<suffix> ::= {V | mV | uV}
POD1 ::= D0-D7
POD2 ::= D8-D15
TTL ::= 1.4V
CMOS ::= 2.5V
ECL ::= -1.3V
The :POD<n>:THReshold command sets the threshold for the specified
group of channels. The threshold is used for triggering purposes and for
displaying the digital data as high (above the threshold) or low (below the
threshold).
NOTE
Query Syntax
This command is only valid for the MSO models.
:POD<n>:THReshold?
The :POD<n>:THReshold? query returns the threshold value for the
specified group of channels.
Return Format
<threshold><NL>
<threshold> ::= Floating point number in NR3 format
See Also
• "Introduction to :POD<n> Commands" on page 404
• ":DIGital<n>:THReshold" on page 255
• ":TRIGger[:EDGE]:LEVel" on page 513
Example Code
'
'
'
'
'
'
'
'
'
THRESHOLD - This command is used to set the voltage threshold for
the waveforms. There are three preset values (TTL, CMOS, and ECL)
and you can also set a user-defined threshold value between
-8.0 volts and +8.0 volts.
In this example, we set channels 0-7 to CMOS, then set channels
8-15 to a user-defined 2.0 volts, and then set the external trigger
to TTL. Of course, you only need to set the thresholds for the
channels you will be using in your program.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
407
5
Commands by Subsystem
' Set channels 0-7 to CMOS threshold.
myScope.WriteString ":POD1:THRESHOLD CMOS"
' Set channels 8-15 to 2.0 volts.
myScope.WriteString ":POD2:THRESHOLD 2.0"
' Set external channel to TTL threshold (short form).
myScope.WriteString ":TRIG:LEV TTL,EXT"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
408
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:RECall Commands
Recall previously saved oscilloscope setups and traces. See "Introduction to
:RECall Commands" on page 409.
Table 72 :RECall Commands Summary
Command
Query
Options and Query Returns
:RECall:FILename
<base_name> (see
page 410)
:RECall:FILename?
(see page 410)
<base_name> ::= quoted ASCII
string
:RECall:IMAGe[:STARt]
[<file_spec>] (see
page 411)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:RECall:MASK[:STARt]
[<file_spec>] (see
page 412)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-3; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:RECall:PWD
<path_name> (see
page 413)
:RECall:PWD? (see
page 413)
<path_name> ::= quoted ASCII
string
:RECall:SETup[:STARt]
[<file_spec>] (see
page 414)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
Introduction to
:RECall
Commands
The :RECall subsystem provides commands to recall previously saved
oscilloscope setups and traces.
Reporting the Setup
Use :RECall? to query setup information for the RECall subsystem.
Return Format
The following is a sample response from the :RECall? query. In this case,
the query was issued following the *RST command.
:REC:FIL "scope_0"
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
409
5
Commands by Subsystem
:RECall:FILename
(see page 798)
Command Syntax
:RECall:FILename <base_name>
<base_name> ::= quoted ASCII string
The :RECall:FILename command specifies the source for any RECall
operations.
NOTE
Query Syntax
This command specifies a file's base name only, without path information or an extension.
:RECall:FILename?
The :RECall:FILename? query returns the current RECall filename.
Return Format
<base_name><NL>
<base_name> ::= quoted ASCII string
See Also
• "Introduction to :RECall Commands" on page 409
• ":RECall:IMAGe[:STARt]" on page 411
• ":RECall:SETup[:STARt]" on page 414
• ":SAVE:FILename" on page 417
410
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:RECall:IMAGe[:STARt]
(see page 798)
Command Syntax
:RECall:IMAGe[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-9; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :RECall:IMAGe[:STARt] command recalls a trace (TIFF) image.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".tif".
• "Introduction to :RECall Commands" on page 409
• ":RECall:FILename" on page 410
• ":SAVE:IMAGe[:STARt]" on page 418
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
411
5
Commands by Subsystem
:RECall:MASK[:STARt]
(see page 798)
Command Syntax
:RECall:MASK[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-3; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :RECall:MASK[:STARt] command recalls a mask.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".msk".
• "Introduction to :RECall Commands" on page 409
• ":RECall:FILename" on page 410
• ":SAVE:MASK[:STARt]" on page 425
• ":MTESt:DATA" on page 384
412
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:RECall:PWD
(see page 798)
Command Syntax
:RECall:PWD <path_name>
<path_name> ::= quoted ASCII string
The :RECall:PWD command sets the present working directory for recall
operations.
Query Syntax
:RECall:PWD?
The :RECall:PWD? query returns the currently set working directory for
recall operations.
Return Format
<path_name><NL>
<path_name> ::= quoted ASCII string
See Also
• "Introduction to :RECall Commands" on page 409
• ":SAVE:PWD" on page 426
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
413
5
Commands by Subsystem
:RECall:SETup[:STARt]
(see page 798)
Command Syntax
:RECall:SETup[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-9; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :RECall:SETup[:STARt] command recalls an oscilloscope setup.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".scp".
• "Introduction to :RECall Commands" on page 409
• ":RECall:FILename" on page 410
• ":SAVE:SETup[:STARt]" on page 427
414
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SAVE Commands
Save oscilloscope setups and traces, screen images, and data. See
"Introduction to :SAVE Commands" on page 416.
Table 73 :SAVE Commands Summary
Command
Query
Options and Query Returns
:SAVE:FILename
<base_name> (see
page 417)
:SAVE:FILename? (see
page 417)
<base_name> ::= quoted ASCII
string
:SAVE:IMAGe[:STARt]
[<file_spec>] (see
page 418)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
n/a
:SAVE:IMAGe:AREA?
(see page 419)
<area> ::= {GRAT | SCR}
:SAVE:IMAGe:FACTors
{{0 | OFF} | {1 |
ON}} (see page 420)
:SAVE:IMAGe:FACTors?
(see page 420)
{0 | 1}
:SAVE:IMAGe:FORMat
<format> (see
page 421)
:SAVE:IMAGe:FORMat?
(see page 421)
<format> ::= {TIFF | {BMP |
BMP24bit} | BMP8bit | PNG | NONE}
:SAVE:IMAGe:INKSaver
{{0 | OFF} | {1 |
ON}} (see page 422)
:SAVE:IMAGe:INKSaver?
(see page 422)
{0 | 1}
:SAVE:IMAGe:PALette
<palette> (see
page 423)
:SAVE:IMAGe:PALette?
(see page 423)
<palette> ::= {COLor | GRAYscale
| MONochrome}
:SAVE:LISTer[:STARt]
[<file_name>] (see
page 424)
n/a
<file_name> ::= quoted ASCII
string
:SAVE:MASK[:STARt]
[<file_spec>] (see
page 425)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-3; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:SAVE:PWD <path_name>
(see page 426)
:SAVE:PWD? (see
page 426)
<path_name> ::= quoted ASCII
string
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
415
5
Commands by Subsystem
Table 73 :SAVE Commands Summary (continued)
Command
Query
Options and Query Returns
:SAVE:SETup[:STARt]
[<file_spec>] (see
page 427)
n/a
<file_spec> ::= {<internal_loc>
| <file_name>}
<internal_loc> ::= 0-9; an
integer in NR1 format
<file_name> ::= quoted ASCII
string
:SAVE:WAVeform[:STARt
] [<file_name>] (see
page 428)
n/a
<file_name> ::= quoted ASCII
string
:SAVE:WAVeform:FORMat
<format> (see
page 429)
:SAVE:WAVeform:FORMat
? (see page 429)
<format> ::= {ALB | ASCiixy | CSV
| BINary | NONE}
:SAVE:WAVeform:LENGth
<length> (see
page 430)
:SAVE:WAVeform:LENGth
? (see page 430)
<length> ::= 100 to max. length;
an integer in NR1 format
:SAVE:WAVeform:SEGMen
ted <option> (see
page 431)
:SAVE:WAVeform:SEGMen
ted? (see page 431)
<option> ::= {ALL | CURRent}
Introduction to
:SAVE Commands
The :SAVE subsystem provides commands to save oscilloscope setups and
traces, screen images, and data.
:SAV is an acceptable short form for :SAVE.
Reporting the Setup
Use :SAVE? to query setup information for the SAVE subsystem.
Return Format
The following is a sample response from the :SAVE? query. In this case,
the query was issued following the *RST command.
:SAVE:FIL "";:SAVE:IMAG:AREA GRAT;FACT 0;FORM TIFF;INKS 0;PAL
MON;:SAVE:PWD "C:/setups/";:SAVE:WAV:FORM NONE;LENG 1000;SEGM CURR
416
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SAVE:FILename
(see page 798)
Command Syntax
:SAVE:FILename <base_name>
<base_name> ::= quoted ASCII string
The :SAVE:FILename command specifies the source for any SAVE
operations.
NOTE
Query Syntax
This command specifies a file's base name only, without path information or an extension.
:SAVE:FILename?
The :SAVE:FILename? query returns the current SAVE filename.
Return Format
<base_name><NL>
<base_name> ::= quoted ASCII string
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:SETup[:STARt]" on page 427
• ":SAVE:WAVeform[:STARt]" on page 428
• ":SAVE:PWD" on page 426
• ":RECall:FILename" on page 410
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
417
5
Commands by Subsystem
:SAVE:IMAGe[:STARt]
(see page 798)
Command Syntax
:SAVE:IMAGe[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-9; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :SAVE:IMAGe[:STARt] command saves an image.
NOTE
If a file extension is provided as part of a specified <file_name>, and it does not match the
extension expected by the format specified in :SAVE:IMAGe:FORMat, the format will be
changed if the extension is a valid image file extension.
NOTE
If the extension ".bmp" is used and the current :SAVE:IMAGe:FORMat is not BMP or BMP8,
the format will be changed to BMP.
NOTE
When the <internal_loc> option is used, the :SAVE:IMAGe:FORMat will be changed to TIFF.
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
• ":SAVE:FILename" on page 417
• ":RECall:IMAGe[:STARt]" on page 411
418
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SAVE:IMAGe:AREA
(see page 798)
Query Syntax
:SAVE:IMAGe:AREA?
The :SAVE:IMAGe:AREA? query returns the selected image area. If the
:SAVE:IMAGe:FORMat is TIFF, the area is GRAT (graticule). Otherwise, it is
SCR (screen).
Return Format
<area><NL>
<area> ::= {GRAT | SCR}
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
419
5
Commands by Subsystem
:SAVE:IMAGe:FACTors
(see page 798)
Command Syntax
:SAVE:IMAGe:FACTors <factors>
<factors> ::= {{OFF | 0} | {ON | 1}}
The :SAVE:IMAGe:FACTors command controls whether the oscilloscope
factors are output along with the image.
NOTE
Query Syntax
Factors are written to a separate file with the same path and base name but with the ".txt"
extension.
:SAVE:IMAGe:FACTors?
The :SAVE:IMAGe:FACTors? query returns a flag indicating whether
oscilloscope factors are output along with the image.
Return Format
<factors><NL>
<factors> ::= {0 | 1}
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
420
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SAVE:IMAGe:FORMat
(see page 798)
Command Syntax
:SAVE:IMAGe:FORMat <format>
<format> ::= {TIFF | {BMP | BMP24bit} | BMP8bit | PNG}
The :SAVE:IMAGe:FORMat command sets the image format type.
Query Syntax
:SAVE:IMAGe:FORMat?
The :SAVE:IMAGe:FORMat? query returns the selected image format type.
Return Format
<format><NL>
<format> ::= {TIFF | BMP | BMP8 | PNG | NONE}
When NONE is returned, it indicates that a waveform data file format is
currently selected.
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
• ":SAVE:WAVeform:FORMat" on page 429
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
421
5
Commands by Subsystem
:SAVE:IMAGe:INKSaver
(see page 798)
Command Syntax
:SAVE:IMAGe:INKSaver <value>
<value> ::= {{OFF | 0} | {ON | 1}}
The :SAVE:IMAGe:INKSaver command controls whether the graticule colors
are inverted or not.
Query Syntax
:SAVE:IMAGe:INKSaver?
The :SAVE:IMAGe:INKSaver? query returns a flag indicating whether
graticule colors are inverted or not.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:PALette" on page 423
422
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SAVE:IMAGe:PALette
(see page 798)
Command Syntax
:SAVE:IMAGe:PALette <palette>
<palette> ::= {COLor | GRAYscale | MONochrome}
The :SAVE:IMAGe:PALette command sets the image palette color.
NOTE
Query Syntax
MONochrome is the only valid choice when the :SAVE:IMAGe:FORMat is TIFF. COLor and
GRAYscale are the only valid choices when the format is not TIFF.
:SAVE:IMAGe:PALette?
The :SAVE:IMAGe:PALette? query returns the selected image palette color.
Return Format
<palette><NL>
<palette> ::= {COL | GRAY | MON}
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
423
5
Commands by Subsystem
:SAVE:LISTer[:STARt]
(see page 798)
Command Syntax
:SAVE:LISTer[:STARt] [<file_name>]
<file_name> ::= quoted ASCII string
The :SAVE:LISTer[:STARt] command saves the Lister display data to a file.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".csv".
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:FILename" on page 417
• ":LISTer Commands" on page 304
424
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SAVE:MASK[:STARt]
(see page 798)
Command Syntax
:SAVE:MASK[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-3; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :SAVE:MASK[:STARt] command saves a mask.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".msk".
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:FILename" on page 417
• ":RECall:MASK[:STARt]" on page 412
• ":MTESt:DATA" on page 384
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
425
5
Commands by Subsystem
:SAVE:PWD
(see page 798)
Command Syntax
:SAVE:PWD <path_name>
<path_name> ::= quoted ASCII string
The :SAVE:PWD command sets the present working directory for save
operations.
Query Syntax
:SAVE:PWD?
The :SAVE:PWD? query returns the currently set working directory for
save operations.
Return Format
<path_name><NL>
<path_name> ::= quoted ASCII string
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:FILename" on page 417
• ":RECall:PWD" on page 413
426
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SAVE:SETup[:STARt]
(see page 798)
Command Syntax
:SAVE:SETup[:STARt] [<file_spec>]
<file_spec> ::= {<internal_loc> | <file_name>}
<internal_loc> ::= 0-9; an integer in NR1 format
<file_name> ::= quoted ASCII string
The :SAVE:SETup[:STARt] command saves an oscilloscope setup.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, it must be ".scp".
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:FILename" on page 417
• ":RECall:SETup[:STARt]" on page 414
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
427
5
Commands by Subsystem
:SAVE:WAVeform[:STARt]
(see page 798)
Command Syntax
:SAVE:WAVeform[:STARt] [<file_name>]
<file_name> ::= quoted ASCII string
The :SAVE:WAVeform[:STARt] command saves oscilloscope waveform data
to a file.
NOTE
See Also
If a file extension is provided as part of a specified <file_name>, and it does not match the
extension expected by the format specified in :SAVE:WAVeform:FORMat, the format will be
changed if the extension is a valid waveform file extension.
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:WAVeform:FORMat" on page 429
• ":SAVE:WAVeform:LENGth" on page 430
• ":SAVE:FILename" on page 417
• ":RECall:SETup[:STARt]" on page 414
428
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SAVE:WAVeform:FORMat
(see page 798)
Command Syntax
:SAVE:WAVeform:FORMat <format>
<format> ::= {ALB | ASCiixy | CSV | BINary}
The :SAVE:WAVeform:FORMat command sets the waveform data format
type:
• ALB — creates an Agilent module binary format file. These files can be
viewed offline by the Agilent Logic Analyzer application software. The
proper file extension for this format is ".alb".
• ASCiixy — creates comma- separated value files for each analog channel
that is displayed (turned on). The proper file extension for this format
is ".csv".
• CSV — creates one comma- separated value file that contains
information for all analog channels that are displayed (turned on). The
proper file extension for this format is ".csv".
• BINary — creates an oscilloscope binary data format file. See the User's
Guide for a description of this format. The proper file extension for this
format is ".bin".
Query Syntax
:SAVE:WAVeform:FORMat?
The :SAVE:WAVeform:FORMat? query returns the selected waveform data
format type.
Return Format
<format><NL>
<format> ::= {ALB | ASC | CSV | BIN | NONE}
When NONE is returned, it indicates that an image file format is currently
selected.
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:WAVeform[:STARt]" on page 428
• ":SAVE:WAVeform:LENGth" on page 430
• ":SAVE:IMAGe:FORMat" on page 421
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
429
5
Commands by Subsystem
:SAVE:WAVeform:LENGth
(see page 798)
Command Syntax
:SAVE:WAVeform:LENGth <length>
<length> ::= 100 to max. length; an integer in NR1 format
The :SAVE:WAVeform:LENGth command sets the waveform data length
(that is, the number of points saved).
Query Syntax
:SAVE:WAVeform:LENGth?
The :SAVE:WAVeform:LENGth? query returns the specified waveform data
length.
Return Format
<length><NL>
<length> ::= 100 to max. length; an integer in NR1 format
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:WAVeform[:STARt]" on page 428
• ":WAVeform:POINts" on page 641
• ":SAVE:WAVeform:FORMat" on page 429
430
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SAVE:WAVeform:SEGMented
(see page 798)
Command Syntax
:SAVE:WAVeform:SEGMented <option>
<option> ::= {ALL | CURRent}
When segmented memory is used for acquisitions, the
:SAVE:WAVeform:SEGMented command specifies which segments are
included when the waveform is saved:
• ALL — all acquired segments are saved.
• CURRent — only the currently selected segment is saved.
Query Syntax
:SAVE:WAVeform:SEGMented?
The :SAVE:WAVeform:SEGMented? query returns the current segmented
waveform save option setting.
Return Format
<option><NL>
<option> ::= {ALL | CURR}
See Also
• "Introduction to :SAVE Commands" on page 416
• ":SAVE:WAVeform[:STARt]" on page 428
• ":SAVE:WAVeform:FORMat" on page 429
• ":SAVE:WAVeform:LENGth" on page 430
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
431
5
Commands by Subsystem
:SBUS Commands
Control oscilloscope functions associated with the serial decode bus. See
"Introduction to :SBUS Commands" on page 433.
Table 74 :SBUS Commands Summary
Command
Query
Options and Query Returns
n/a
:SBUS:CAN:COUNt:ERRor
? (see page 434)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:CAN:COUNt:OVERl
oad? (see page 435)
<frame_count> ::= integer in NR1
format
:SBUS:CAN:COUNt:RESet
(see page 436)
n/a
n/a
n/a
:SBUS:CAN:COUNt:TOTal
? (see page 437)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:CAN:COUNt:UTILi
zation? (see
page 438)
<percent> ::= floating-point in
NR3 format
:SBUS:DISPlay {{0 |
OFF} | {1 | ON}} (see
page 439)
:SBUS:DISPlay? (see
page 439)
{0 | 1}
n/a
:SBUS:FLEXray:COUNt:N
ULL? (see page 440)
<frame_count> ::= integer in NR1
format
:SBUS:FLEXray:COUNt:R
ESet (see page 441)
n/a
n/a
n/a
:SBUS:FLEXray:COUNt:S
YNC? (see page 442)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:FLEXray:COUNt:T
OTal? (see page 443)
<frame_count> ::= integer in NR1
format
:SBUS:I2S:BASE <base>
(see page 444)
:SBUS:I2S:BASE? (see
page 444)
<base> ::= {DECimal | HEX}
:SBUS:IIC:ASIZe
<size> (see page 445)
:SBUS:IIC:ASIZe? (see
page 445)
<size> ::= {BIT7 | BIT8}
:SBUS:LIN:PARity {{0
| OFF} | {1 | ON}}
(see page 446)
:SBUS:LIN:PARity?
(see page 446)
{0 | 1}
:SBUS:M1553:BASE
<base> (see page 447)
:SBUS:M1553:BASE?
(see page 447)
<base> ::= {DECimal | HEX}
:SBUS:MODE <mode>
(see page 448)
:SBUS:MODE? (see
page 448)
<mode> ::= {CAN | FLEXray | I2S |
IIC | LIN | SPI | UART}
432
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 74 :SBUS Commands Summary (continued)
Command
Query
Options and Query Returns
:SBUS:SPI:BITorder
<order> (see
page 449)
:SBUS:SPI:BITorder?
(see page 449)
<order> ::= {LSBFirst | MSBFirst}
:SBUS:SPI:WIDTh
<word_width> (see
page 450)
:SBUS:SPI:WIDTh? (see
page 450)
<word_width> ::= integer 4-16 in
NR1 format
:SBUS:UART:BASE
<base> (see page 451)
:SBUS:UART:BASE? (see
page 451)
<base> ::= {ASCii | BINary | HEX}
n/a
:SBUS:UART:COUNt:ERRo
r? (see page 452)
<frame_count> ::= integer in NR1
format
:SBUS:UART:COUNt:RESe
t (see page 453)
n/a
n/a
n/a
:SBUS:UART:COUNt:RXFR
ames? (see page 454)
<frame_count> ::= integer in NR1
format
n/a
:SBUS:UART:COUNt:TXFR
ames? (see page 455)
<frame_count> ::= integer in NR1
format
:SBUS:UART:FRAMing
<value> (see
page 456)
:SBUS:UART:FRAMing?
(see page 456)
<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
Introduction to
:SBUS
Commands
NOTE
The :SBUS subsystem commands control the serial decode bus viewing,
mode, and other options.
These commands are only valid on 4 (analog) channel oscilloscope models when a serial
decode option has been licensed.
Reporting the Setup
Use :SBUS? to query setup information for the :SBUS subsystem.
Return Format
The following is a sample response from the :SBUS? query. In this case,
the query was issued following a *RST command.
:SBUS:DISP 0;MODE IIC
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
433
5
Commands by Subsystem
:SBUS:CAN:COUNt:ERRor
(see page 798)
Query Syntax
:SBUS:CAN:COUNt:ERRor?
Returns the error frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:CAN:COUNt:RESet" on page 436
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:CAN Commands" on page 490
434
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:CAN:COUNt:OVERload
(see page 798)
Query Syntax
:SBUS:CAN:COUNt:OVERload?
Returns the overload frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:CAN:COUNt:RESet" on page 436
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:CAN Commands" on page 490
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
435
5
Commands by Subsystem
:SBUS:CAN:COUNt:RESet
(see page 798)
Command Syntax
:SBUS:CAN:COUNt:RESet
Resets the frame counters.
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:CAN:COUNt:ERRor" on page 434
• ":SBUS:CAN:COUNt:OVERload" on page 435
• ":SBUS:CAN:COUNt:TOTal" on page 437
• ":SBUS:CAN:COUNt:UTILization" on page 438
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:CAN Commands" on page 490
436
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:CAN:COUNt:TOTal
(see page 798)
Query Syntax
:SBUS:CAN:COUNt:TOTal?
Returns the total frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:CAN:COUNt:RESet" on page 436
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:CAN Commands" on page 490
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
437
5
Commands by Subsystem
:SBUS:CAN:COUNt:UTILization
(see page 798)
Query Syntax
:SBUS:CAN:COUNt:UTILization?
Returns the percent utilization.
Return Format
<percent><NL>
<percent> ::= floating-point in NR3 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:CAN:COUNt:RESet" on page 436
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:CAN Commands" on page 490
438
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:DISPlay
(see page 798)
Command Syntax
:SBUS:DISPlay <display>
<display> ::= {{1 | ON} | {0 | OFF}}
The :SBUS:DISPlay command turns displaying of the serial decode bus on
or off.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when a serial decode
option has been licensed.
:SBUS:DISPlay?
The :SBUS:DISPlay? query returns the current display setting of the serial
decode bus.
Return Format
<display><NL>
<display> ::= {0 | 1}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":CHANnel<n>:DISPlay" on page 234
• ":DIGital<n>:DISPlay" on page 251
• ":POD<n>:DISPlay" on page 405
• ":VIEW" on page 192
• ":BLANk" on page 160
• ":STATus" on page 189
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
439
5
Commands by Subsystem
:SBUS:FLEXray:COUNt:NULL
(see page 798)
Query Syntax
:SBUS:FLEXray:COUNt:NULL?
Returns the FlexRay null frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:FLEXray Commands" on page 517
440
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:FLEXray:COUNt:RESet
(see page 798)
Command Syntax
:SBUS:FLEXray:COUNt:RESet
Resets the FlexRay frame counters.
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:FLEXray:COUNt:NULL" on page 440
• ":SBUS:FLEXray:COUNt:SYNC" on page 442
• ":SBUS:FLEXray:COUNt:TOTal" on page 443
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:FLEXray Commands" on page 517
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
441
5
Commands by Subsystem
:SBUS:FLEXray:COUNt:SYNC
(see page 798)
Query Syntax
:SBUS:FLEXray:COUNt:SYNC?
Returns the FlexRay sync frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:FLEXray Commands" on page 517
442
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:FLEXray:COUNt:TOTal
(see page 798)
Query Syntax
:SBUS:FLEXray:COUNt:TOTal?
Returns the FlexRay total frame count.
Return Format
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:FLEXray Commands" on page 517
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
443
5
Commands by Subsystem
:SBUS:I2S:BASE
(see page 798)
Command Syntax
:SBUS:I2S:BASE <base>
<base> ::= {DECimal | HEX}
The :SBUS:I2S:BASE command determines the base to use for the I2S
decode display.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the I2S serial
decode option (Option SND) has been licensed.
:SBUS:I2S:BASE?
The :SBUS:I2S:BASE? query returns the current I2S display decode base.
Return Format
<base><NL>
<base> ::= {DECimal | HEX}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:I2S Commands" on page 538
444
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:IIC:ASIZe
(see page 798)
Command Syntax
:SBUS:IIC:ASIZe <size>
<size> ::= {BIT7 | BIT8}
The :SBUS:IIC:ASIZe command determines whether the Read/Write bit is
included as the LSB in the display of the IIC address field of the decode
bus.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the low-speed
IIC and SPI serial decode option (Option LSS) has been licensed.
:SBUS:IIC:ASIZe?
The :SBUS:IIC:ASIZe? query returns the current IIC address width setting.
Return Format
<mode><NL>
<mode> ::= {BIT7 | BIT8}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:IIC Commands" on page 556
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
445
5
Commands by Subsystem
:SBUS:LIN:PARity
(see page 798)
Command Syntax
:SBUS:LIN:PARity <display>
<display> ::= {{1 | ON} | {0 | OFF}}
The :SBUS:LIN:PARity command determines whether the parity bits are
included as the most significant bits (MSB) in the display of the Frame Id
field in the LIN decode bus.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the
automotive CAN and LIN serial decode option (Option AMS) has been licensed.
:SBUS:LIN:PARity?
The :SBUS:LIN:PARity? query returns the current LIN parity bits display
setting of the serial decode bus.
Return Format
<display><NL>
<display> ::= {0 | 1}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:LIN Commands" on page 565
446
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SBUS:M1553:BASE
(see page 798)
Command Syntax
:SBUS:M1553:BASE <base>
<base> ::= {BINary | HEX}
The :SBUS:M1553:BASE command determines the base to use for the
MIL- STD 1553 decode display.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the MIL-STD
1553 serial decode option (Option 553) has been licensed.
:SBUS:M1553:BASE?
The :SBUS:M1553:BASE? query returns the current MIL- STD 1553 display
decode base.
Return Format
<base><NL>
<base> ::= {BIN | HEX}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:M1553 Commands" on page 578
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
447
5
Commands by Subsystem
:SBUS:MODE
(see page 798)
Command Syntax
:SBUS:MODE <mode>
<mode> ::= {CAN | FLEXray | I2S | IIC | LIN | M1553 | SPI | UART}
The :SBUS:MODE command determines the decode mode for the serial
bus.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when a serial decode
option has been licensed.
:SBUS:MODE?
The :SBUS:MODE? query returns the current serial bus decode mode
setting.
Return Format
<mode><NL>
<mode> ::= {CAN | FLEX | I2S | IIC | LIN | M1553 | SPI | UART | NONE}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN Commands" on page 490
• ":TRIGger:FLEXray Commands" on page 517
• ":TRIGger:I2S Commands" on page 538
• ":TRIGger:IIC Commands" on page 556
• ":TRIGger:LIN Commands" on page 565
• ":TRIGger:M1553 Commands" on page 578
• ":TRIGger:SPI Commands" on page 593
• ":TRIGger:UART Commands" on page 608
448
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SBUS:SPI:BITorder
(see page 798)
Command Syntax
:SBUS:SPI:BITorder <order>
<order> ::= {LSBFirst | MSBFirst}
The :SBUS:SPI:BITorder command selects the bit order, most significant bit
first (MSB) or least significant bit first (LSB), used when displaying data
in the serial decode waveform and in the Lister.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the low-speed
IIC and SPI serial decode option (Option LSS) has been licensed.
:SBUS:SPI:BITorder?
The :SBUS:SPI:BITorder? query returns the current SPI decode bit order.
Return Format
<order><NL>
<order> ::= {LSBF | MSBF}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:SPI Commands" on page 593
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
449
5
Commands by Subsystem
:SBUS:SPI:WIDTh
(see page 798)
Command Syntax
:SBUS:SPI:WIDTh <word_width>
<word_width> ::= integer 4-16 in NR1 format
The :SBUS:SPI:WIDTh command determines the number of bits in a word
of data for SPI.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the low-speed
IIC and SPI serial decode option (Option LSS) has been licensed.
:SBUS:SPI:WIDTh?
The :SBUS:SPI:WIDTh? query returns the current SPI decode word width.
Return Format
<word_width><NL>
<word_width> ::= integer 4-16 in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:SPI Commands" on page 593
450
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:UART:BASE
(see page 798)
Command Syntax
:SBUS:UART:BASE <base>
<base> ::= {ASCii | BINary | HEX}
The :SBUS:UART:BASE command determines the base to use for the UART
decode display.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
:SBUS:UART:BASE?
The :SBUS:UART:BASE? query returns the current UART decode base
setting.
Return Format
<base><NL>
<base> ::= {ASCii | BINary | HEX}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:UART Commands" on page 608
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
451
5
Commands by Subsystem
:SBUS:UART:COUNt:ERRor
(see page 798)
Query Syntax
:SBUS:UART:COUNt:ERRor?
Returns the UART error frame count.
NOTE
Return Format
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:UART:COUNt:RESet" on page 453
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:UART Commands" on page 608
452
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:UART:COUNt:RESet
(see page 798)
Command Syntax
:SBUS:UART:COUNt:RESet
Resets the UART frame counters.
NOTE
Errors
See Also
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
• "- 241, Hardware missing" on page 757
• ":SBUS:UART:COUNt:ERRor" on page 452
• ":SBUS:UART:COUNt:RXFRames" on page 454
• ":SBUS:UART:COUNt:TXFRames" on page 455
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:UART Commands" on page 608
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
453
5
Commands by Subsystem
:SBUS:UART:COUNt:RXFRames
(see page 798)
Query Syntax
:SBUS:UART:COUNt:RXFRames?
Returns the UART Rx frame count.
NOTE
Return Format
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:UART:COUNt:RESet" on page 453
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:UART Commands" on page 608
454
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SBUS:UART:COUNt:TXFRames
(see page 798)
Query Syntax
:SBUS:UART:COUNt:TXFRames?
Returns the UART Tx frame count.
NOTE
Return Format
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
<frame_count><NL>
<frame_count> ::= integer in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• ":SBUS:UART:COUNt:RESet" on page 453
• "Introduction to :SBUS Commands" on page 433
• ":SBUS:MODE" on page 448
• ":TRIGger:UART Commands" on page 608
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
455
5
Commands by Subsystem
:SBUS:UART:FRAMing
(see page 798)
Command Syntax
:SBUS:UART:FRAMing <value>
<value> ::= {OFF | <decimal> | <nondecimal>}
<decimal> ::= 8-bit integer in decimal from 0-255 (0x00-0xff)
<nondecimal> ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal
<nondecimal> ::= #Bnn...n where n ::= {0 | 1} for binary
The :SBUS:UART:FRAMing command determines the byte value to use for
framing (end of packet) or to turn off framing for UART decode.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the
UART/RS-232 triggering and serial decode option (Option 232) has been licensed.
:SBUS:UART:FRAMing?
The :SBUS:UART:FRAMing? query returns the current UART decode base
setting.
Return Format
<value><NL>
<value> ::= {OFF | <decimal>}
<decimal> ::= 8-bit integer in decimal from 0-255
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :SBUS Commands" on page 433
• ":TRIGger:UART Commands" on page 608
456
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:SYSTem Commands
Control basic system functions of the oscilloscope. See "Introduction to
:SYSTem Commands" on page 457.
Table 75 :SYSTem Commands Summary
Command
Query
Options and Query Returns
:SYSTem:DATE <date>
(see page 458)
:SYSTem:DATE? (see
page 458)
<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 459)
n/a
<string> ::= up to 254 characters
as a quoted ASCII string
n/a
:SYSTem:ERRor? (see
page 460)
<error> ::= an integer error code
<error string> ::= quoted ASCII
string.
See Error Messages (see
page 755).
:SYSTem:LOCK <value>
(see page 461)
:SYSTem:LOCK? (see
page 461)
<value> ::= {{1 | ON} | {0 |
OFF}}
:SYSTem:PRECision
<value> (see
page 462)
:SYSTem:PRECision?
(see page 462)
<value> ::= {{1 | ON} | {0 |
OFF}}
:SYSTem:PROTection:LO
CK <value> (see
page 463)
:SYSTem:PROTection:LO
CK? (see page 463)
<value> ::= {{1 | ON} | {0 |
OFF}}
:SYSTem:SETup
<setup_data> (see
page 464)
:SYSTem:SETup? (see
page 464)
<setup_data> ::= data in IEEE
488.2 # format.
:SYSTem:TIME <time>
(see page 466)
:SYSTem:TIME? (see
page 466)
<time> ::= hours,minutes,seconds
in NR1 format
Introduction to
:SYSTem
Commands
SYSTem subsystem commands enable writing messages to the display,
setting and reading both the time and the date, querying for errors, and
saving and recalling setups.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
457
5
Commands by Subsystem
:SYSTem:DATE
(see page 798)
Command Syntax
:SYSTem:DATE <date>
<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}
The :SYSTem:DATE command sets the date. Validity checking is performed
to ensure that the date is valid.
Query Syntax
:SYSTem:DATE?
The SYSTem:DATE? query returns the date.
Return Format
See Also
<year>,<month>,<day><NL>
• "Introduction to :SYSTem Commands" on page 457
• ":SYSTem:TIME" on page 466
458
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SYSTem:DSP
(see page 798)
Command Syntax
:SYSTem:DSP <string>
<string> ::= quoted ASCII string (up to 254 characters)
The :SYSTem:DSP command writes the quoted string (excluding quotation
marks) to a text box in the center of the display. Use :SYStem:DSP "" to
remotely remove the message from the display. (Two sets of quote marks
without a space between them creates a NULL string.) Press any menu key
to manually remove the message from the display.
See Also
• "Introduction to :SYSTem Commands" on page 457
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
459
5
Commands by Subsystem
:SYSTem:ERRor
(see page 798)
Query Syntax
:SYSTem:ERRor?
The :SYSTem:ERRor? query outputs the next error number and text from
the error queue. The instrument has an error queue that is 30 errors deep
and operates on a first- in, first- out basis. Repeatedly sending the
:SYSTem:ERRor? query returns the errors in the order that they occurred
until the queue is empty. Any further queries then return zero until
another error occurs.
Return Format
<error number>,<error string><NL>
<error number> ::= an integer error code in NR1 format
<error string> ::= quoted ASCII string containing the error message
Error messages are listed in Chapter 8, “Error Messages,” starting on page
755.
See Also
• "Introduction to :SYSTem Commands" on page 457
• "*ESR (Standard Event Status Register)" on page 132
• "*CLS (Clear Status)" on page 129
460
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SYSTem:LOCK
(see page 798)
Command Syntax
:SYSTem:LOCK <value>
<value> ::= {{1 | ON} | {0 | OFF}}
The :SYSTem:LOCK command disables the front panel. LOCK ON is the
equivalent of sending a local lockout message over the programming
interface.
Query Syntax
:SYSTem:LOCK?
The :SYSTem:LOCK? query returns the lock status of the front panel.
Return Format
<value><NL>
<value> ::= {1 | 0}
See Also
• "Introduction to :SYSTem Commands" on page 457
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
461
5
Commands by Subsystem
:SYSTem:PRECision
(see page 798)
Command Syntax
:SYSTem:PRECision <value>
<value> ::= {{1 | ON} | {0 | OFF}}
The :SYSTem:PRECision command turns the oscilloscope's precision
analysis setting on or off.
• OFF (0) — provides the maximum oscilloscope waveform update rate by
performing measurements and math functions on a 1000- point
measurement record.
• ON (1) — at the expense of oscilloscope waveform update rate, this
setting allows measurements and math functions to be performed on a
precision analysis record (see ":WAVeform:POINts:MODE" on page 643).
The precision analysis setting is OFF after a *RST command.
Precision analysis is not available when:
• Realtime sampling mode is off.
• Averaging or High Resolution acquisition modes are selected.
• XY or Roll time modes are selected.
Query Syntax
:SYSTem:PRECision?
The :SYSTem:PRECision? query returns the current precision analysis
setting.
Return Format
<value><NL>
<value> ::= {1 | 0}
See Also
• "Introduction to :SYSTem Commands" on page 457
• ":WAVeform:POINts:MODE" on page 643
• "*RST (Reset)" on page 140
462
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:SYSTem:PROTection:LOCK
(see page 798)
Command Syntax
:SYSTem:PROTection:LOCK <value>
<value> ::= {{1 | ON} | {0 | OFF}}
The :SYSTem:PROTection:LOCK command disables the fifty ohm impedance
setting for all analog channels.
Query Syntax
:SYSTem:PROTection:LOCK?
The :SYSTem:PROTection:LOCK? query returns the analog channel
protection lock status.
Return Format
<value><NL>
<value> ::= {1 | 0}
See Also
• "Introduction to :SYSTem Commands" on page 457
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
463
5
Commands by Subsystem
:SYSTem:SETup
(see page 798)
Command Syntax
:SYSTem:SETup <setup_data>
<setup_data> ::= binary block data in IEEE 488.2 # format.
The :SYSTem:SETup command sets the oscilloscope as defined by the data
in the setup (learn) string sent from the controller. The setup string does
not change the interface mode or interface address.
Query Syntax
:SYSTem:SETup?
The :SYSTem:SETup? query operates the same as the *LRN? query. It
outputs the current oscilloscope setup in the form of a learn string to the
controller. The setup (learn) string is sent and received as a binary block
of data. The format for the data transmission is the # format defined in
the IEEE 488.2 specification.
Return Format
<setup_data><NL>
<setup_data> ::= binary block data in IEEE 488.2 # format
See Also
• "Introduction to :SYSTem Commands" on page 457
• "*LRN (Learn Device Setup)" on page 135
Example Code
' SAVE_SYSTEM_SETUP - The :SYSTEM:SETUP? query returns a program
' message that contains the current state of the instrument. Its
' format is a definite-length binary block, for example,
' #800002204<setup string><NL>
' where the setup string is 2204 bytes in length.
myScope.WriteString ":SYSTEM:SETUP?"
varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1)
CheckForInstrumentErrors
' After reading query results.
' Output setup string to a file:
Dim strPath As String
strPath = "c:\scope\config\setup.dat"
' Open file for output.
Close #1
' If #1 is open, close it.
Open strPath For Binary Access Write Lock Write As #1
Put #1, , varQueryResult
' Write data.
Close #1
' Close file.
' RESTORE_SYSTEM_SETUP - Read the setup string from a file and
' write it back to the oscilloscope.
Dim varSetupString As Variant
strPath = "c:\scope\config\setup.dat"
' Open file for input.
Open strPath For Binary Access Read As #1
Get #1, , varSetupString
' Read data.
Close #1
' Close file.
464
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
' Write setup string back to oscilloscope using ":SYSTEM:SETUP"
' command:
myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString
CheckForInstrumentErrors
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
465
5
Commands by Subsystem
:SYSTem:TIME
(see page 798)
Command Syntax
:SYSTem:TIME <time>
<time> ::= hours,minutes,seconds in NR1 format
The :SYSTem:TIME command sets the system time, using a 24- hour format.
Commas are used as separators. Validity checking is performed to ensure
that the time is valid.
Query Syntax
:SYSTem:TIME? <time>
The :SYSTem:TIME? query returns the current system time.
Return Format
<time><NL>
<time> ::= hours,minutes,seconds in NR1 format
See Also
• "Introduction to :SYSTem Commands" on page 457
• ":SYSTem:DATE" on page 458
466
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TIMebase Commands
Control all horizontal sweep functions. See "Introduction to :TIMebase
Commands" on page 468.
Table 76 :TIMebase Commands Summary
Command
Query
Options and Query Returns
:TIMebase:MODE
<value> (see
page 469)
:TIMebase:MODE? (see
page 469)
<value> ::= {MAIN | WINDow | XY |
ROLL}
:TIMebase:POSition
<pos> (see page 470)
:TIMebase:POSition?
(see page 470)
<pos> ::= time from the trigger
event to the display reference
point in NR3 format
:TIMebase:RANGe
<range_value> (see
page 471)
:TIMebase:RANGe? (see
page 471)
<range_value> ::= 5 ns through
500 s in NR3 format
:TIMebase:REFClock
{{0 | OFF} | {1 |
ON}} (see page 472)
:TIMebase:REFClock?
(see page 472)
{0 | 1}
:TIMebase:REFerence
{LEFT | CENTer |
RIGHt} (see page 473)
:TIMebase:REFerence?
(see page 473)
<return_value> ::= {LEFT | CENTer
| RIGHt}
:TIMebase:SCALe
<scale_value> (see
page 474)
:TIMebase:SCALe? (see
page 474)
<scale_value> ::= scale value in
seconds in NR3 format
:TIMebase:VERNier {{0
| OFF} | {1 | ON}}
(see page 475)
:TIMebase:VERNier?
(see page 475)
{0 | 1}
:TIMebase:WINDow:POSi
tion <pos> (see
page 476)
:TIMebase:WINDow:POSi
tion? (see page 476)
<pos> ::= time from the trigger
event to the zoomed view
reference point in NR3 format
:TIMebase:WINDow:RANG
e <range_value> (see
page 477)
:TIMebase:WINDow:RANG
e? (see page 477)
<range value> ::= range value in
seconds in NR3 format for the
zoomed window
:TIMebase:WINDow:SCAL
e <scale_value> (see
page 478)
:TIMebase:WINDow:SCAL
e? (see page 478)
<scale_value> ::= scale value in
seconds in NR3 format for the
zoomed window
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
467
5
Commands by Subsystem
Introduction to
:TIMebase
Commands
The TIMebase subsystem commands control the horizontal (X- axis)
functions and set the oscilloscope to X- Y mode (where channel 1 becomes
the X input and channel 2 becomes the Y input). The time per division,
delay, vernier control, and reference can be controlled for the main and
window (zoomed) time bases.
Reporting the Setup
Use :TIMebase? to query setup information for the TIMebase subsystem.
Return Format
The following is a sample response from the :TIMebase? query. In this
case, the query was issued following a *RST command.
:TIM:MODE MAIN;REF CENT;MAIN:RANG +1.00E-03;POS +0.0E+00
468
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TIMebase:MODE
(see page 798)
Command Syntax
:TIMebase:MODE <value>
<value> ::= {MAIN | WINDow | XY | ROLL}
The :TIMebase:MODE command sets the current time base. There are four
time base modes:
• MAIN — The normal time base mode is the main time base. It is the
default time base mode after the *RST (Reset) command.
• WINDow — In the WINDow (zoomed or delayed) time base mode,
measurements are made in the zoomed time base if possible; otherwise,
the measurements are made in the main time base.
• XY — In the XY mode, the :TIMebase:RANGe, :TIMebase:POSition, and
:TIMebase:REFerence commands are not available. No measurements are
available in this mode.
• ROLL — In the ROLL mode, data moves continuously across the display
from left to right. The oscilloscope runs continuously and is untriggered.
The :TIMebase:REFerence selection changes to RIGHt.
NOTE
Query Syntax
If a :DIGitize command is executed when the :TIMebase:MODE is not MAIN, the
:TIMebase:MODE is set to MAIN.
:TIMebase:MODE?
The :TIMebase:MODE query returns the current time base mode.
Return Format
<value><NL>
<value> ::= {MAIN | WIND | XY | ROLL}
See Also
• "Introduction to :TIMebase Commands" on page 468
• "*RST (Reset)" on page 140
• ":TIMebase:RANGe" on page 471
• ":TIMebase:POSition" on page 470
• ":TIMebase:REFerence" on page 473
Example Code
' TIMEBASE_MODE - (not executed in this example)
' Set the time base mode to MAIN, DELAYED, XY, or ROLL.
' Set time base mode to main.
myScope.WriteString ":TIMEBASE:MODE MAIN"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
469
5
Commands by Subsystem
:TIMebase:POSition
(see page 798)
Command Syntax
:TIMebase:POSition <pos>
<pos> ::= time in seconds from the trigger to the display reference
in NR3 format
The :TIMebase:POSition command sets the time interval between the
trigger event and the display reference point on the screen. The display
reference point is either left, right, or center and is set with the
:TIMebase:REFerence command. The maximum position value depends on
the time/division settings.
NOTE
Query Syntax
This command is an alias for the :TIMebase:DELay command.
:TIMebase:POSition?
The :TIMebase:POSition? query returns the current time from the trigger to
the display reference in seconds.
Return Format
<pos><NL>
<pos> ::= time in seconds from the trigger to the display reference
in NR3 format
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:REFerence" on page 473
• ":TIMebase:RANGe" on page 471
• ":TIMebase:SCALe" on page 474
• ":TIMebase:WINDow:POSition" on page 476
• ":TIMebase:DELay" on page 749
470
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TIMebase:RANGe
(see page 798)
Command Syntax
:TIMebase:RANGe <range_value>
<range_value> ::= 5 ns through 500 s in NR3 format
The :TIMebase:RANGe command sets the full- scale horizontal time in
seconds for the main window. The range is 10 times the current
time- per- division setting.
Query Syntax
:TIMebase:RANGe?
The :TIMebase:RANGe query returns the current full- scale range value for
the main window.
Return Format
<range_value><NL>
<range_value> ::= 5 ns through 500 s in NR3 format
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:MODE" on page 469
• ":TIMebase:SCALe" on page 474
• ":TIMebase:WINDow:RANGe" on page 477
Example Code
' TIME_RANGE - Sets the full scale horizontal time in seconds. The
' range value is 10 times the time per division.
myScope.WriteString ":TIM:RANG 2e-3"
' Set the time range to 0.002
seconds.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
471
5
Commands by Subsystem
:TIMebase:REFClock
(see page 798)
Command Syntax
:TIMebase:REFClock <value>
<value> ::= {{1 | ON} | {0 | OFF}
The :TIMebase:REFClock command enables or disables the 10 MHz REF
BNC located on the rear panel of the oscilloscope.
The 10 MHz REF BNC can be used as an input for the oscilloscope's
reference clock (instead of the internal 10 MHz reference), or it can be
used to output the internal 10 MHz reference clock when synchronizing
multiple instruments (see ":ACQuire:RSIGnal" on page 201).
The :TIMebase:REFClock ON command enables the 10 MHz REF BNC and
sets the reference signal mode to IN. The :TIMebase:REFClock OFF
command disables the 10 MHz REF BNC (the same as setting the reference
signal mode to OFF).
Query Syntax
:TIMebase:REFClock?
The :TIMebase:REFClock? query returns the current state of the 10 MHz
reference signal mode. A "1" indicates that the 10 MHz REF input is
enabled (on), and a "0" indicates that either the 10 MHz REF BNC is
disabled (off) or that it is set as an output (by the :ACQuire:RSIGnal
command).
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
472
• ":ACQuire:RSIGnal" on page 201
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TIMebase:REFerence
(see page 798)
Command Syntax
:TIMebase:REFerence <reference>
<reference> ::= {LEFT | CENTer | RIGHt}
The :TIMebase:REFerence command sets the time reference to one division
from the left side of the screen, to the center of the screen, or to one
division from the right side of the screen. Time reference is the point on
the display where the trigger point is referenced.
Query Syntax
:TIMebase:REFerence?
The :TIMebase:REFerence? query returns the current display reference for
the main window.
Return Format
<reference><NL>
<reference> ::= {LEFT | CENT | RIGH}
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:MODE" on page 469
Example Code
' TIME_REFERENCE - Possible values are LEFT and CENTER.
' - LEFT sets the display reference on time division from the left.
' - CENTER sets the display reference to the center of the screen.
myScope.WriteString ":TIMEBASE:REFERENCE CENTER"
' Set reference to
center.
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
473
5
Commands by Subsystem
:TIMebase:SCALe
(see page 798)
Command Syntax
:TIMebase:SCALe <scale_value>
<scale_value> ::= 500 ps through 50 s in NR3 format
The :TIMebase:SCALe command sets the horizontal scale or units per
division for the main window.
Query Syntax
:TIMebase:SCALe?
The :TIMebase:SCALe? query returns the current horizontal scale setting in
seconds per division for the main window.
Return Format
<scale_value><NL>
<scale_value> ::= 500 ps through 50 s in NR3 format
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:RANGe" on page 471
• ":TIMebase:WINDow:SCALe" on page 478
• ":TIMebase:WINDow:RANGe" on page 477
474
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TIMebase:VERNier
(see page 798)
Command Syntax
:TIMebase:VERNier <vernier value>
<vernier value> ::= {{1 | ON} | {0 | OFF}
The :TIMebase:VERNier command specifies whether the time base control's
vernier (fine horizontal adjustment) setting is ON (1) or OFF (0).
Query Syntax
:TIMebase:VERNier?
The :TIMebase:VERNier? query returns the current state of the time base
control's vernier setting.
Return Format
<vernier value><NL>
<vernier value> ::= {0 | 1}
See Also
• "Introduction to :TIMebase Commands" on page 468
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
475
5
Commands by Subsystem
:TIMebase:WINDow:POSition
(see page 798)
Command Syntax
:TIMebase:WINDow:POSition <pos value>
<pos value> ::= time from the trigger event to the zoomed (delayed)
view reference point in NR3 format
The :TIMebase:WINDow:POSition command sets the horizontal position in
the zoomed (delayed) view of the main sweep. The main sweep range and
the main sweep horizontal position determine the range for this command.
The value for this command must keep the zoomed view window within
the main sweep range.
Query Syntax
:TIMebase:WINDow:POSition?
The :TIMebase:WINDow:POSition? query returns the current horizontal
window position setting in the zoomed view.
Return Format
<value><NL>
<value> ::= position value in seconds
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:MODE" on page 469
• ":TIMebase:POSition" on page 470
• ":TIMebase:RANGe" on page 471
• ":TIMebase:SCALe" on page 474
• ":TIMebase:WINDow:RANGe" on page 477
• ":TIMebase:WINDow:SCALe" on page 478
476
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TIMebase:WINDow:RANGe
(see page 798)
Command Syntax
:TIMebase:WINDow:RANGe <range value>
<range value> ::= range value in seconds in NR3 format
The :TIMebase:WINDow:RANGe command sets the full- scale horizontal time
in seconds for the zoomed (delayed) window. The range is 10 times the
current zoomed view window seconds per division setting. The main sweep
range determines the range for this command. The maximum value is one
half of the :TIMebase:RANGe value.
Query Syntax
:TIMebase:WINDow:RANGe?
The :TIMebase:WINDow:RANGe? query returns the current window
timebase range setting.
Return Format
<value><NL>
<value> ::= range value in seconds
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:RANGe" on page 471
• ":TIMebase:POSition" on page 470
• ":TIMebase:SCALe" on page 474
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
477
5
Commands by Subsystem
:TIMebase:WINDow:SCALe
(see page 798)
Command Syntax
:TIMebase:WINDow:SCALe <scale_value>
<scale_value> ::= scale value in seconds in NR3 format
The :TIMebase:WINDow:SCALe command sets the zoomed (delayed)
window horizontal scale (seconds/division). The main sweep scale
determines the range for this command. The maximum value is one half of
the :TIMebase:SCALe value.
Query Syntax
:TIMebase:WINDow:SCALe?
The :TIMebase:WINDow:SCALe? query returns the current zoomed window
scale setting.
Return Format
<scale_value><NL>
<scale_value> ::= current seconds per division for the zoomed window
See Also
• "Introduction to :TIMebase Commands" on page 468
• ":TIMebase:RANGe" on page 471
• ":TIMebase:POSition" on page 470
• ":TIMebase:SCALe" on page 474
• ":TIMebase:WINDow:RANGe" on page 477
478
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger Commands
Control the trigger modes and parameters for each trigger type. See:
• "Introduction to :TRIGger Commands" on page 479
• "General :TRIGger Commands" on page 482
• ":TRIGger:CAN Commands" on page 490
• ":TRIGger:DURation Commands" on page 501
• ":TRIGger:EBURst Commands" on page 507
• ":TRIGger[:EDGE] Commands" on page 511
• ":TRIGger:FLEXray Commands" on page 517
• ":TRIGger:GLITch Commands" on page 529 (Pulse Width trigger)
• ":TRIGger:I2S Commands" on page 538
• ":TRIGger:IIC Commands" on page 556
• ":TRIGger:LIN Commands" on page 565
• ":TRIGger:M1553 Commands" on page 578
• ":TRIGger:SEQuence Commands" on page 585
• ":TRIGger:SPI Commands" on page 593
• ":TRIGger:TV Commands" on page 602
• ":TRIGger:USB Commands" on page 623
• ":TRIGger:UART Commands" on page 608
Introduction to
:TRIGger
Commands
The commands in the TRIGger subsystem define the conditions for an
internal trigger. Many of these commands are valid in multiple trigger
modes.
The default trigger mode is :EDGE.
The trigger subsystem controls the trigger sweep mode and the trigger
specification. The trigger sweep (see ":TRIGger:SWEep" on page 489) can
be AUTO or NORMal.
• NORMal mode — displays a waveform only if a trigger signal is present
and the trigger conditions are met. Otherwise the oscilloscope does not
trigger and the display is not updated. This mode is useful for
low- repetitive- rate signals.
• AUTO trigger mode — generates an artificial trigger event if the trigger
specification is not satisfied within a preset time, acquires
unsynchronized data and displays it.
AUTO mode is useful for signals other than low- repetitive- rate signals.
You must use this mode to display a DC signal because there are no
edges on which to trigger.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
479
5
Commands by Subsystem
The following trigger types are available (see ":TRIGger:MODE" on
page 485).
• CAN (Controller Area Network) triggering— will trigger on CAN
version 2.0A and 2.0B signals. Setup consists of connecting the
oscilloscope to a CAN signal. Baud rate, signal source, and signal
polarity, and type of data to trigger on can be specified. With the
automotive CAN and LIN serial decode option (Option ASM), you can
also trigger on CAN data and identifier patterns, set the bit sample
point, and have the module send an acknowledge to the bus when it
receives a valid message.
NOTE
The CAN and LIN serial decode option (Option ASM) replaces the functionality that was
available with the N2758A CAN trigger module for the 54620/54640 Series oscilloscopes.
• Edge triggering— identifies a trigger by looking for a specified slope
and voltage level on a waveform.
• Nth Edge Burst triggering— lets you trigger on the Nth edge of a burst
that occurs after an idle time.
• Pulse width triggering— (:TRIGger:GLITch commands) sets the
oscilloscope to trigger on a positive pulse or on a negative pulse of a
specified width.
• Pattern triggering— identifies a trigger condition by looking for a
specified pattern. This pattern is a logical AND combination of the
channels.
• Duration triggering— lets you define a pattern, then trigger on a
specified time duration.
• FlexRay triggering— will, when used with a BusDoctor 2 protocol
analyzer and a four- channel mixed- signal oscilloscope with Option FRS,
trigger on FlexRay bus frames, times, or errors.
• I2S (Inter- IC Sound or Integrated Interchip Sound bus) triggering—
consists of connecting the oscilloscope to the serial clock, word select,
and serial data lines, then triggering on a data value.
• IIC (Inter- IC bus) triggering— consists of connecting the oscilloscope
to the serial data (SDA) line and the serial clock (SCL) line, then
triggering on a stop/start condition, a restart, a missing acknowledge, or
on a read/write frame with a specific device address and data value.
• LIN (Local Interconnect Network) triggering— will trigger on LIN sync
break at the beginning of a message frame. With the automotive CAN
and LIN serial decode option (Option ASM), you can also trigger on
Frame IDs.
• MIL- STD 1553 triggering (with Option 553) — lets you trigger on
MIL- STD 1553 serial data.
480
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
• Sequence triggering— allows you to trigger the oscilloscope after
finding a sequence of events. Defining a sequence trigger requires three
steps:
a Define the event to find before you trigger on the next event. This
event can be a pattern, and edge from a single channel, or the
combination of a pattern and a channel edge.
b Define the trigger event. This event can be a pattern, and edge from
a single channel, the combination of a pattern and a channel edge,
or the nth occurrence of an edge from a single channel.
c Set an optional reset event. This event can be a pattern, an edge
from a single channel, the combination of a pattern and a channel
edge, or a timeout value.
• SPI (Serial Peripheral Interface) triggering— consists of connecting
the oscilloscope to a clock, data, and framing signal. You can then
trigger on a data pattern during a specific framing period. The serial
data string can be specified to be from 4 to 32 bits long.
• TV triggering— is used to capture the complicated waveforms of
television equipment. The trigger circuitry detects the vertical and
horizontal interval of the waveform and produces triggers based on the
TV trigger settings you selected. TV triggering requires greater than º
division of sync amplitude with any analog channel as the trigger
source.
• UART/RS- 232 triggering (with Option 232) — lets you trigger on
RS- 232 serial data.
• USB (Universal Serial Bus) triggering— will trigger on a Start of
Packet (SOP), End of Packet (EOP), Reset Complete, Enter Suspend, or
Exit Suspend signal on the differential USB data lines. USB Low Speed
and Full Speed are supported by this trigger.
Reporting the Setup
Use :TRIGger? to query setup information for the TRIGger subsystem.
Return Format
The return format for the TRIGger? query varies depending on the current
mode. The following is a sample response from the :TRIGger? query. In
this case, the query was issued following a *RST command.
:TRIG:MODE EDGE;SWE AUTO;NREJ 0;HFR 0;HOLD +60.0000000000000E-09;
:TRIG:EDGE:SOUR CHAN1;LEV +0.00000E+00;SLOP POS;REJ OFF;COUP DC
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
481
5
Commands by Subsystem
General :TRIGger Commands
Table 77 General :TRIGger Commands Summary
Command
Query
Options and Query Returns
:TRIGger:HFReject {{0
| OFF} | {1 | ON}}
(see page 483)
:TRIGger:HFReject?
(see page 483)
{0 | 1}
:TRIGger:HOLDoff
<holdoff_time> (see
page 484)
:TRIGger:HOLDoff?
(see page 484)
<holdoff_time> ::= 60 ns to 10 s
in NR3 format
:TRIGger:MODE <mode>
(see page 485)
:TRIGger:MODE? (see
page 485)
<mode> ::= {EDGE | GLITch |
PATTern | CAN | DURation | I2S
|IIC | EBURst | LIN | M1553|
SEQuence | SPI | TV | UART | USB
| FLEXray}
<return_value> ::= {<mode> |
<none>}
<none> ::= query returns "NONE"
if the :TIMebase:MODE is ROLL or
XY
:TRIGger:NREJect {{0
| OFF} | {1 | ON}}
(see page 486)
:TRIGger:NREJect?
(see page 486)
{0 | 1}
:TRIGger:PATTern
<value>, <mask>
[,<edge
source>,<edge>] (see
page 487)
:TRIGger:PATTern?
(see page 488)
<value> ::= integer in NR1 format
or <string>
<mask> ::= integer in NR1 format
or <string>
<string> ::= "0xnnnnn"; n ::=
{0,..,9 | A,..,F} (# bits = #
channels)
<edge source> ::= {CHANnel<n> |
EXTernal | NONE} for DSO models
<edge source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | NONE}
for MSO models
<edge> ::= {POSitive | NEGative}
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SWEep
<sweep> (see
page 489)
:TRIGger:SWEep? (see
page 489)
<sweep> ::= {AUTO | NORMal}
482
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:HFReject
(see page 798)
Command Syntax
:TRIGger:HFReject <value>
<value> ::= {{0 | OFF} | {1 | ON}}
The :TRIGger:HFReject command turns the high frequency reject filter off
and on. The high frequency reject filter adds a 50 kHz low- pass filter in
the trigger path to remove high frequency components from the trigger
waveform. Use this filter to remove high- frequency noise, such as AM or
FM broadcast stations, from the trigger path.
Query Syntax
:TRIGger:HFReject?
The :TRIGger:HFReject? query returns the current high frequency reject
filter mode.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger[:EDGE]:REJect" on page 514
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
483
5
Commands by Subsystem
:TRIGger:HOLDoff
(see page 798)
Command Syntax
:TRIGger:HOLDoff <holdoff_time>
<holdoff_time> ::= 60 ns to 10 s in NR3 format
The :TRIGger:HOLDoff command defines the holdoff time value in seconds.
Holdoff keeps a trigger from occurring until after a certain amount of time
has passed since the last trigger. This feature is valuable when a waveform
crosses the trigger level multiple times during one period of the waveform.
Without holdoff, the oscilloscope could trigger on each of the crossings,
producing a confusing waveform. With holdoff set correctly, the
oscilloscope always triggers on the same crossing. The correct holdoff
setting is typically slightly less than one period.
Query Syntax
:TRIGger:HOLDoff?
The :TRIGger:HOLDoff? query returns the holdoff time value for the
current trigger mode.
Return Format
<holdoff_time><NL>
<holdoff_time> ::= the holdoff time value in seconds in NR3 format.
See Also
484
• "Introduction to :TRIGger Commands" on page 479
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:MODE
(see page 798)
Command Syntax
:TRIGger:MODE <mode>
<mode> ::= {EDGE | GLITch | PATTern | CAN | DURation | I2S |IIC
| EBURst | LIN | M1553| SEQuence | SPI | TV | UART
| USB | FLEXray}
The :TRIGger:MODE command selects the trigger mode (trigger type).
Query Syntax
:TRIGger:MODE?
The :TRIGger:MODE? query returns the current trigger mode. If the
:TIMebase:MODE is ROLL or XY, the query returns "NONE".
Return Format
<mode><NL>
<mode> ::= {NONE | EDGE | GLIT | PATT | CAN | DUR | I2S
| IIC | EBUR | LIN | M1553| SEQ | SPI | TV | UART
| USB | FLEX}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SWEep" on page 489
• ":TIMebase:MODE" on page 469
Example Code
' TRIGGER_MODE - Set the trigger mode to EDGE.
myScope.WriteString ":TRIGGER:MODE EDGE"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
485
5
Commands by Subsystem
:TRIGger:NREJect
(see page 798)
Command Syntax
:TRIGger:NREJect <value>
<value> ::= {{0 | OFF} | {1 | ON}}
The :TRIGger:NREJect command turns the noise reject filter off and on.
When the noise reject filter is on, the trigger circuitry is less sensitive to
noise but may require a greater amplitude waveform to trigger the
oscilloscope. This command is not valid in TV trigger mode.
Query Syntax
:TRIGger:NREJect?
The :TRIGger:NREJect? query returns the current noise reject filter mode.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
486
• "Introduction to :TRIGger Commands" on page 479
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:PATTern
(see page 798)
Command Syntax
:TRIGger:PATTern <pattern>
<pattern> ::= <value>, <mask> [, <edge source>, <edge>]
<value> ::= integer in NR1 format or <string>
<mask> ::= integer in NR1 format or <string>
<string> ::= "0xnnnnn"; n ::= {0,..,9 | A,..,F}
(# bits = # channels, see following table)
<edge source> ::= {CHANnel<n> | EXTernal | NONE} for DSO models
<edge source> ::= {CHANnel<n> | DIGital0,..,DIGital15
| NONE} for MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
<edge> ::= {POSitive | NEGative}
The :TRIGger:PATTern command defines the specified pattern resource
according to the value and the mask. For both <value> and <mask>, each
bit corresponds to a possible trigger channel. The bit assignments vary by
instrument:
Oscilloscope Models
Value and Mask Bit Assignments
4 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 through 19 - analog channels 1
through 4.
2 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 and 17 - analog channels 1 and 2.
4 analog channels only
Bits 0 through 3 - analog channels 1 through 4.
Bit 4 - external trigger.
2 analog channels only
Bits 0 and 1 - analog channels 1 and 2. Bit 4 external trigger.
Set a <value> bit to "0" to set the pattern for the corresponding channel to
low. Set a <value> bit to "1" to set the pattern to high.
Set a <mask> bit to "0" to ignore the data for the corresponding channel.
Only channels with a "1" set on the appropriate mask bit are used.
NOTE
The optional source and the optional edge should be sent together or not at all. The edge
will be set in the simple pattern if it is included. If the edge source is also specified in the
mask, the edge takes precedence.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
487
5
Commands by Subsystem
Query Syntax
:TRIGger:PATTern?
The :TRIGger:PATTern? query returns the pattern value, the mask, and the
edge of interest in the simple pattern.
Return Format
See Also
<pattern><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
488
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SWEep
(see page 798)
Command Syntax
:TRIGger:SWEep <sweep>
<sweep> ::= {AUTO | NORMal}
The :TRIGger:SWEep command selects the trigger sweep mode.
When AUTO sweep mode is selected, a baseline is displayed in the absence
of a signal. If a signal is present but the oscilloscope is not triggered, the
unsynchronized signal is displayed instead of a baseline.
When NORMal sweep mode is selected and no trigger is present, the
instrument does not sweep, and the data acquired on the previous trigger
remains on the screen.
NOTE
Query Syntax
This feature is called "Mode" on the instrument's front panel.
:TRIGger:SWEep?
The :TRIGger:SWEep? query returns the current trigger sweep mode.
Return Format
<sweep><NL>
<sweep> ::= current trigger sweep mode
See Also
• "Introduction to :TRIGger Commands" on page 479
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
489
5
Commands by Subsystem
:TRIGger:CAN Commands
Table 78 :TRIGger:CAN Commands Summary
Command
Query
Options and Query Returns
:TRIGger:CAN:PATTern:
DATA <value>, <mask>
(see page 492)
:TRIGger:CAN:PATTern:
DATA? (see page 492)
<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
:TRIGger:CAN:PATTern:
DATA:LENGth <length>
(see page 493)
:TRIGger:CAN:PATTern:
DATA:LENGth? (see
page 493)
<length> ::= integer from 1 to 8
in NR1 format (with Option AMS)
:TRIGger:CAN:PATTern:
ID <value>, <mask>
(see page 494)
:TRIGger:CAN:PATTern:
ID? (see page 494)
<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 495)
:TRIGger:CAN:PATTern:
ID:MODE? (see
page 495)
<value> ::= {STANdard | EXTended}
(with Option AMS)
:TRIGger:CAN:SAMPlepo
int <value> (see
page 496)
:TRIGger:CAN:SAMPlepo
int? (see page 496)
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
:TRIGger:CAN:SIGNal:B
AUDrate <baudrate>
(see page 497)
:TRIGger:CAN:SIGNal:B
AUDrate? (see
page 497)
<baudrate> ::= integer from 10000
to 1000000 in 100 b/s increments
490
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 78 :TRIGger:CAN Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:CAN:SOURce
<source> (see
page 498)
:TRIGger:CAN:SOURce?
(see page 498)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:CAN:TRIGger
<condition> (see
page 499)
:TRIGger:CAN:TRIGger?
(see page 500)
<condition> ::= {SOF} (without
Option AMS)
<condition> ::= {SOF | DATA |
ERRor | IDData | IDEither |
IDRemote | ALLerrors | OVERload |
ACKerror} (with Option AMS)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
491
5
Commands by Subsystem
:TRIGger:CAN:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:CAN:PATTern:DATA <value>,<mask>
<value> ::= 64-bit integer in decimal, <nondecimal>, or <string>
<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
The :TRIGger:CAN:PATTern:DATA command defines the CAN data pattern
resource according to the value and the mask. This pattern, along with the
data length (set by the :TRIGger:CAN:PATTern:DATA:LENGth command),
control the data pattern searched for in each CAN message.
Set a <value> bit to "0" to set the corresponding bit in the data pattern to
low. Set a <value> bit to "1" to set the bit to high.
Set a <mask> bit to "0" to ignore that bit in the data stream. Only bits
with a "1" set on the mask are used.
NOTE
If more bytes are sent for <value> or <mask> than specified by the
:TRIGger:CAN:PATTern:DATA:LENGth command, the most significant bytes will be
truncated. If the data length is changed after the <value> and <mask> are programmed, the
added or deleted bytes will be added to or deleted from the least significant bytes.
NOTE
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
Query Syntax
:TRIGger:CAN:PATTern:DATA?
The :TRIGger:CAN:PATTern:DATA? query returns the current settings of
the specified CAN data pattern resource.
Return Format
Errors
See Also
<value>, <mask><NL> in nondecimal format
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:CAN:PATTern:ID" on page 494
492
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:CAN:PATTern:DATA:LENGth
(see page 798)
Command Syntax
:TRIGger:CAN:PATTern:DATA:LENGth <length>
<length> ::= integer from 1 to 8 in NR1 format
The :TRIGger:CAN:PATTern:DATA:LENGth command sets the number of
8- bit bytes in the CAN data string. The number of bytes in the string can
be anywhere from 0 bytes to 8 bytes (64 bits). The value for these bytes is
set by the :TRIGger:CAN:PATTern:DATA command.
NOTE
Query Syntax
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
:TRIGger:CAN:PATTern:DATA:LENGth?
The :TRIGger:CAN:PATTern:DATA:LENGth? query returns the current CAN
data pattern length setting.
Return Format
<count><NL>
<count> ::= integer from 1 to 8 in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:SOURce" on page 498
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
493
5
Commands by Subsystem
:TRIGger:CAN:PATTern:ID
(see page 798)
Command Syntax
:TRIGger:CAN:PATTern:ID <value>, <mask>
<value> ::= 32-bit integer in decimal, <nondecimal>, or <string>
<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
The :TRIGger:CAN:PATTern:ID command defines the CAN identifier pattern
resource according to the value and the mask. This pattern, along with the
identifier mode (set by the :TRIGger:CAN:PATTern:ID:MODE command),
control the identifier pattern searched for in each CAN message.
Set a <value> bit to "0" to set the corresponding bit in the identifier
pattern to low. Set a <value> bit to "1" to set the bit to high.
Set a <mask> bit to "0" to ignore that bit in the identifier stream. Only bits
with a "1" set on the mask are used.
NOTE
If more bits are sent than allowed (11 bits in standard mode, 29 bits in extended mode) by
the :TRIGger:CAN:PATTern:ID:MODE command, the most significant bytes will be
truncated. If the ID mode is changed after the <value> and <mask> are programmed, the
added or deleted bits will be added to or deleted from the most significant bits.
NOTE
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
Query Syntax
:TRIGger:CAN:PATTern:ID?
The :TRIGger:CAN:PATTern:ID? query returns the current settings of the
specified CAN identifier pattern resource.
Return Format
Errors
See Also
<value>, <mask><NL> in nondecimal format
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:CAN:PATTern:DATA" on page 492
494
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:CAN:PATTern:ID:MODE
(see page 798)
Command Syntax
:TRIGger:CAN:PATTern:ID:MODE <value>
<value> ::= {STANdard | EXTended}
The :TRIGger:CAN:PATTern:ID:MODE command sets the CAN identifier
mode. STANdard selects the standard 11- bit identifier. EXTended selects
the extended 29- bit identifier. The CAN identifier is set by the
:TRIGger:CAN:PATTern:ID command.
NOTE
Query Syntax
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
:TRIGger:CAN:PATTern:ID:MODE?
The :TRIGger:CAN:PATTern:ID:MODE? query returns the current setting of
the CAN identifier mode.
Return Format
<value><NL>
<value> ::= {STAN | EXT}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:CAN:PATTern:ID" on page 494
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
495
5
Commands by Subsystem
:TRIGger:CAN:SAMPlepoint
(see page 798)
Command Syntax
:TRIGger:CAN:SAMPlepoint <value>
<value><NL>
<value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format
The :TRIGger:CAN:SAMPlepoint command sets the point during the bit
time where the bit level is sampled to determine whether the bit is
dominant or recessive. The sample point represents the percentage of time
between the beginning of the bit time to the end of the bit time.
Query Syntax
:TRIGger:CAN:SAMPlepoint?
The :TRIGger:CAN:SAMPlepoint? query returns the current CAN sample
point setting.
Return Format
<value><NL>
<value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:TRIGger" on page 499
496
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:CAN:SIGNal:BAUDrate
(see page 798)
Command Syntax
:TRIGger:CAN:SIGNal:BAUDrate <baudrate>
<baudrate> ::= integer from 10000 to 1000000 in 100 b/s increments
The :TRIGger:CAN:SIGNal:BAUDrate command sets the standard baud rate
of the CAN signal from 10 kb/s to 1 Mb/s in 100 b/s increments. If you
enter a baud rate that is not divisible by 100 b/s, the baud rate is set to
the nearest baud rate divisible by 100 b/s.
If the baud rate you select does not match the system baud rate, false
triggers may occur.
Query Syntax
:TRIGger:CAN:SIGNal:BAUDrate?
The :TRIGger:CAN:SIGNal:BAUDrate? query returns the current CAN baud
rate setting.
Return Format
<baudrate><NL>
<baudrate> ::= integer from 10000 to 1000000 in 100 b/s increments
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:TRIGger" on page 499
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
• ":TRIGger:CAN:SOURce" on page 498
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
497
5
Commands by Subsystem
:TRIGger:CAN:SOURce
(see page 798)
Command Syntax
:TRIGger:CAN:SOURce <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:CAN:SOURce command sets the source for the CAN signal.
The source setting is only valid when :TRIGger:CAN:TRIGger is set to SOF
(start of frame).
Query Syntax
:TRIGger:CAN:SOURce?
The :TRIGger:CAN:SOURce? query returns the current source for the CAN
signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:TRIGger" on page 499
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
498
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:CAN:TRIGger
(see page 798)
Command Syntax
:TRIGger:CAN:TRIGger <condition>
<condition> ::= {SOF | DATA | ERRor | IDData | IDEither | IDRemote |
ALLerrors | OVERload | ACKerror}
The :TRIGger:CAN:TRIGger command sets the CAN trigger on condition:
• SOF - will trigger on the Start of Frame (SOF) bit of a Data frame,
Remote Transfer Request (RTR) frame, or an Overload frame.
• DATA - will trigger on CAN Data frames matching the specified Id,
Data, and the DLC (Data length code).
• ERRor - will trigger on CAN Error frame.
• IDData - will trigger on CAN frames matching the specified Id of a
Data frame.
• IDEither - will trigger on the specified Id, regardless if it is a Remote
frame or a Data frame.
• IDRemote - will trigger on CAN frames matching the specified Id of a
Remote frame.
• ALLerrors - will trigger on CAN active error frames and unknown bus
conditions.
• OVERload - will trigger on CAN overload frames.
• ACKerror - will trigger on a data or remote frame acknowledge bit that
is recessive.
The table below shows the programming parameter and the corresponding
front- panel softkey selection:
Remote <condition> parameter
Front-panel Trigger on: softkey selection
(softkey text - softkey popup text)
SOF
SOF - Start of Frame
DATA
Id & Data - Data Frame Id and Data
ERRor
Error - Error frame
IDData
Id & ~RTR - Data Frame Id (~RTR)
IDEither
Id - Remote or Data Frame Id
IDRemote
Id & RTR - Remote Frame Id (RTR)
ALLerrors
All Errors - All Errors
OVERload
Overload - Overload Frame
ACKerror
Ack Error - Acknowledge Error
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
499
5
Commands by Subsystem
CAN Id specification is set by the :TRIGger:CAN:PATTern:ID
and:TRIGger:CAN:PATTern:ID:MODE commands.
CAN Data specification is set by the :TRIGger:CAN:PATTern:DATA
command.
CAN Data Length Code is set by the :TRIGger:CAN:PATTern:DATA:LENGth
command.
NOTE
Query Syntax
SOF is the only valid selection for analog oscilloscopes. If the automotive CAN and LIN
serial decode option (Option AMS) has not been licensed, SOF is the only valid selection.
:TRIGger:CAN:TRIGger?
The :TRIGger:CAN:TRIGger? query returns the current CAN trigger on
condition.
Return Format
<condition><NL>
<condition> ::= {SOF | DATA | ERR | IDD | IDE | IDR | ALL | OVER | ACK}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:CAN:PATTern:ID" on page 494
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
• ":TRIGger:CAN:SOURce" on page 498
500
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:DURation Commands
Table 79 :TRIGger:DURation Commands Summary
Command
Query
Options and Query Returns
:TRIGger:DURation:GRE
aterthan <greater
than time>[suffix]
(see page 502)
:TRIGger:DURation:GRE
aterthan? (see
page 502)
<greater_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:DURation:LES
Sthan <less than
time>[suffix] (see
page 503)
:TRIGger:DURation:LES
Sthan? (see page 503)
<less_than_time> ::=
floating-point number from in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:DURation:PAT
Tern <value>, <mask>
(see page 504)
:TRIGger:DURation:PAT
Tern? (see page 504)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= ""0xnnnnnn"" n ::=
{0,..,9 | A,..,F}
:TRIGger:DURation:QUA
Lifier <qualifier>
(see page 505)
:TRIGger:DURation:QUA
Lifier? (see
page 505)
<qualifier> ::= {GREaterthan |
LESSthan | INRange | OUTRange |
TIMeout}
:TRIGger:DURation:RAN
Ge
<less_than_time>[suff
ix],
<greater_than_time>[s
uffix] (see page 506)
:TRIGger:DURation:RAN
Ge? (see page 506)
<less_than_time> ::= 15 ns to
10 seconds in NR3 format
<greater_than_time> ::= 10 ns to
9.99 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
501
5
Commands by Subsystem
:TRIGger:DURation:GREaterthan
(see page 798)
Command Syntax
:TRIGger:DURation:GREaterthan <greater_than_time>[<suffix>]
<greater_than_time> ::= minimum trigger duration in seconds
in NR3 format
<suffix> ::= {s | ms | us | ns | ps }
The :TRIGger:DURation:GREaterthan command sets the minimum duration
for the defined pattern when :TRIGger:DURation:QUALifier is set to
GREaterthan. The command also sets the timeout value when the
:TRIGger:DURation:QUALifier is set to TIMeout.
Query Syntax
:TRIGger:DURation:GREaterthan?
The :TRIGger:DURation:GREaterthan? query returns the minimum duration
time for the defined pattern.
Return Format
See Also
<greater_than_time><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:DURation:PATTern" on page 504
• ":TRIGger:DURation:QUALifier" on page 505
• ":TRIGger:MODE" on page 485
502
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:DURation:LESSthan
(see page 798)
Command Syntax
:TRIGger:DURation:LESSthan <less_than_time>[<suffix>]
<less_than_time> ::= maximum trigger duration in seconds
in NR3 format
<suffix> ::= {s | ms | us | ns | ps}
The :TRIGger:DURation:LESSthan command sets the maximum duration for
the defined pattern when :TRIGger:DURation:QUALifier is set to LESSthan.
Query Syntax
:TRIGger:DURation:LESSthan?
The :TRIGger:DURation:LESSthan? query returns the duration time for the
defined pattern.
Return Format
See Also
<less_than_time><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:DURation:PATTern" on page 504
• ":TRIGger:DURation:QUALifier" on page 505
• ":TRIGger:MODE" on page 485
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
503
5
Commands by Subsystem
:TRIGger:DURation:PATTern
(see page 798)
Command Syntax
:TRIGger:DURation:PATTern <value>, <mask>
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn"; n ::= {0,..,9 | A,..,F}
The :TRIGger:DURation:PATTern command defines the specified duration
pattern resource according to the value and the mask. For both <value>
and <mask>, each bit corresponds to a possible trigger channel. The bit
assignments vary by instrument:
Oscilloscope Models
Value and Mask Bit Assignments
4 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 through 19 - analog channels 1
through 4.
2 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 and 17 - analog channels 1 and 2.
4 analog channels only
Bits 0 through 3 - analog channels 1 through 4.
Bit 4 - external trigger.
2 analog channels only
Bits 0 and 1 - analog channels 1 and 2. Bit 4 external trigger.
Set a <value> bit to "0" to set the pattern for the corresponding channel to
low. Set a <value> bit to "1" to set the pattern to high.
Set a <mask> bit to "0" to ignore the data for the corresponding channel.
Only channels with a "1" set on the appropriate mask bit are used.
Query Syntax
:TRIGger:DURation:PATTern?
The :TRIGger:DURation:PATTern? query returns the pattern value.
Return Format
<value>, <mask><NL>
<value> ::= a 32-bit integer in NR1 format.
<mask> ::= a 32-bit integer in NR1 format.
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:PATTern" on page 487
504
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:DURation:QUALifier
(see page 798)
Command Syntax
:TRIGger:DURation:QUALifier <qualifier>
<qualifier> ::= {GREaterthan | LESSthan | INRange | OUTRange | TIMeout}
The :TRIGger:DURation:QUALifier command qualifies the trigger duration.
Set the GREaterthan qualifier value with the
:TRIGger:DURation:GREaterthan command.
Set the LESSthan qualifier value with the :TRIGger:DURation:LESSthan
command.
Set the INRange and OUTRange qualifier values with the
:TRIGger:DURation:RANGe command.
Set the TIMeout qualifier value with the :TRIGger:DURation:GREaterthan
command.
Query Syntax
:TRIGger:DURation:QUALifier?
The :TRIGger:DURation:QUALifier? query returns the trigger duration
qualifier.
Return Format
See Also
<qualifier><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:DURation:GREaterthan" on page 502
• ":TRIGger:DURation:LESSthan" on page 503
• ":TRIGger:DURation:RANGe" on page 506
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
505
5
Commands by Subsystem
:TRIGger:DURation:RANGe
(see page 798)
Command Syntax
:TRIGger:DURation:RANGe <less_than_time>[<suffix>],
<greater_than_time>[<suffix>]
<greater_than_time> ::= 10 ns to 9.99 seconds in NR3 format
<less_than_time> ::= 15 ns to 10 seconds in NR3 format
<suffix> ::= {s | ms | us | ns | ps}
The :TRIGger:DURation:RANGe command sets the duration for the defined
pattern when the :TRIGger:DURation:QUALifier command is set to INRange
or OUTRange. You can enter the parameters in any order — the smaller
value becomes the <greater_than_time> and the larger value becomes the
<less_than_time>.
Query Syntax
:TRIGger:DURation:RANGe?
The :TRIGger:DURation:RANGe? query returns the duration time for the
defined pattern.
Return Format
See Also
<less_than_time>,<greater_than_time><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:DURation:PATTern" on page 504
• ":TRIGger:DURation:QUALifier" on page 505
• ":TRIGger:MODE" on page 485
506
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:EBURst Commands
Table 80 :TRIGger:EBURst Commands Summary
Command
Query
Options and Query Returns
:TRIGger:EBURst:COUNt
<count> (see
page 508)
:TRIGger:EBURst:COUNt
? (see page 508)
<count> ::= integer in NR1 format
:TRIGger:EBURst:IDLE
<time_value> (see
page 509)
:TRIGger:EBURst:IDLE?
(see page 509)
<time_value> ::= time in seconds
in NR3 format
:TRIGger:EBURst:SLOPe
<slope> (see
page 510)
:TRIGger:EBURst:SLOPe
? (see page 510)
<slope> ::= {NEGative | POSitive}
The :TRIGger:EDGE:SOURce command is used to specify the source
channel for the Nth Edge Burst trigger. If an analog channel is selected as
the source, the :TRIGger:EDGE:LEVel command is used to set the Nth Edge
Burst trigger level. If a digital channel is selected as the source, the
:DIGital<n>:THReshold or :POD<n>:THReshold command is used to set the
Nth Edge Burst trigger level.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
507
5
Commands by Subsystem
:TRIGger:EBURst:COUNt
(see page 798)
Command Syntax
:TRIGger:EBURst:COUNt <count>
<count> ::= integer in NR1 format
The :TRIGger:EBURst:COUNt command sets the Nth edge at burst counter
resource. The edge counter is used in the trigger stage to determine which
edge in a burst will generate a trigger.
Query Syntax
:TRIGger:EBURst:COUNt?
The :TRIGger:EBURst:COUNt? query returns the current Nth edge of burst
edge counter setting.
Return Format
<count><NL>
<count> ::= integer in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:EBURst:SLOPe" on page 510
• ":TRIGger:EBURst:IDLE" on page 509
508
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:EBURst:IDLE
(see page 798)
Command Syntax
:TRIGger:EBURst:IDLE <time_value>
<time_value> ::= time in seconds in NR3 format
The :TRIGger:EBURst:IDLE command sets the Nth edge in a burst idle
resource in seconds from 10 ns to 10 s. The timer is used to set the
minimum time before the next burst.
Query Syntax
:TRIGger:EBURst:IDLE?
The :TRIGger:EBURst:IDLE? query returns current Nth edge in a burst idle
setting.
Return Format
<time value><NL>
<time_value> ::= time in seconds in NR3 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:EBURst:SLOPe" on page 510
• ":TRIGger:EBURst:COUNt" on page 508
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
509
5
Commands by Subsystem
:TRIGger:EBURst:SLOPe
(see page 798)
Command Syntax
:TRIGger:EBURst:SLOPe <slope>
<slope> ::= {NEGative | POSitive}
The :TRIGger:EBURst:SLOPe command specifies whether the rising edge
(POSitive) or falling edge (NEGative) of the Nth edge in a burst will
generate a trigger.
Query Syntax
:TRIGger:EBURst:SLOPe?
The :TRIGger:EBURst:SLOPe? query returns the current Nth edge in a
burst slope.
Return Format
<slope><NL>
<slope> ::= {NEG | POS}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:EBURst:IDLE" on page 509
• ":TRIGger:EBURst:COUNt" on page 508
510
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger[:EDGE] Commands
Table 81 :TRIGger[:EDGE] Commands Summary
Command
Query
Options and Query Returns
:TRIGger[:EDGE]:COUPl
ing {AC | DC | LF}
(see page 512)
:TRIGger[:EDGE]:COUPl
ing? (see page 512)
{AC | DC | LF}
:TRIGger[:EDGE]:LEVel
<level> [,<source>]
(see page 513)
:TRIGger[:EDGE]:LEVel
? [<source>] (see
page 513)
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers, <level>
::= ±(external range setting) in
NR3 format.
For digital channels (MSO
models), <level> ::= ±8 V.
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 | EXTernal
} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger[:EDGE]:REJec
t {OFF | LF | HF}
(see page 514)
:TRIGger[:EDGE]:REJec
t? (see page 514)
{OFF | LF | HF}
:TRIGger[:EDGE]:SLOPe
<polarity> (see
page 515)
:TRIGger[:EDGE]:SLOPe
? (see page 515)
<polarity> ::= {POSitive |
NEGative | EITHer | ALTernate}
:TRIGger[:EDGE]:SOURc
e <source> (see
page 516)
:TRIGger[:EDGE]:SOURc
e? (see page 516)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 |
EXTernal} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
511
5
Commands by Subsystem
:TRIGger[:EDGE]:COUPling
(see page 798)
Command Syntax
:TRIGger[:EDGE]:COUPling <coupling>
<coupling> ::= {AC | DC | LFReject}
The :TRIGger[:EDGE]:COUPling command sets the input coupling for the
selected trigger sources. The coupling can be set to AC, DC, or LFReject.
• AC coupling places a high- pass filter (10 Hz for analog channels, and
3.5 Hz for all External trigger inputs) in the trigger path, removing dc
offset voltage from the trigger waveform. Use AC coupling to get a
stable edge trigger when your waveform has a large dc offset.
• LFReject coupling places a 50 KHz high- pass filter in the trigger path.
• DC coupling allows dc and ac signals into the trigger path.
NOTE
Query Syntax
The :TRIGger[:EDGE]:COUPling and the :TRIGger[:EDGE]:REJect selections are coupled.
Changing the setting of the :TRIGger[:EDGE]:REJect can change the COUPling setting.
:TRIGger[:EDGE]:COUPling?
The :TRIGger[:EDGE]:COUPling? query returns the current coupling
selection.
Return Format
<coupling><NL>
<coupling> ::= {AC | DC | LFR}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger[:EDGE]:REJect" on page 514
512
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger[:EDGE]:LEVel
(see page 798)
Command Syntax
:TRIGger[:EDGE]:LEVel <level>
<level> ::= <level>[,<source>]
<level> ::= 0.75 x full-scale voltage from center screen in NR3 format
for internal triggers
<level> ::= ±(external range setting) in NR3 format
for external triggers
<level> ::= ±8 V for digital channels (MSO models)
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | EXTernal}
for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger[:EDGE]:LEVel command sets the trigger level voltage for the
active trigger source.
NOTE
Query Syntax
If the optional source is specified and is not the active source, the level on the active source
is not affected and the active source is not changed.
:TRIGger[:EDGE]:LEVel? [<source>]
The :TRIGger[:EDGE]:LEVel? query returns the trigger level of the current
trigger source.
Return Format
See Also
<level><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger[:EDGE]:SOURce" on page 516
• ":EXTernal:RANGe" on page 274
• ":POD<n>:THReshold" on page 407
• ":DIGital<n>:THReshold" on page 255
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
513
5
Commands by Subsystem
:TRIGger[:EDGE]:REJect
(see page 798)
Command Syntax
:TRIGger[:EDGE]:REJect <reject>
<reject> ::= {OFF | LFReject | HFReject}
The :TRIGger[:EDGE]:REJect command turns the low- frequency or
high- frequency reject filter on or off. You can turn on one of these filters
at a time.
• The high frequency reject filter adds a 50 kHz low- pass filter in the
trigger path to remove high frequency components from the trigger
waveform. Use the high frequency reject filter to remove high- frequency
noise, such as AM or FM broadcast stations, from the trigger path.
• The low frequency reject filter adds a 50 kHz high- pass filter in series
with the trigger waveform to remove any unwanted low frequency
components from a trigger waveform, such as power line frequencies,
that can interfere with proper triggering.
NOTE
Query Syntax
The :TRIGger[:EDGE]:REJect and the :TRIGger[:EDGE]:COUPling selections are coupled.
Changing the setting of the :TRIGger[:EDGE]:COUPling can change the COUPling setting.
:TRIGger[:EDGE]:REJect?
The :TRIGger[:EDGE]:REJect? query returns the current status of the reject
filter.
Return Format
<reject><NL>
<reject> ::= {OFF | LFR | HFR}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:HFReject" on page 483
• ":TRIGger[:EDGE]:COUPling" on page 512
514
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger[:EDGE]:SLOPe
(see page 798)
Command Syntax
:TRIGger[:EDGE]:SLOPe <slope>
<slope> ::= {NEGative | POSitive | EITHer | ALTernate}
The :TRIGger[:EDGE]:SLOPe command specifies the slope of the edge for
the trigger. The SLOPe command is not valid in TV trigger mode. Instead,
use :TRIGger:TV:POLarity to set the polarity in TV trigger mode.
Query Syntax
:TRIGger[:EDGE]:SLOPe?
The :TRIGger[:EDGE]:SLOPe? query returns the current trigger slope.
Return Format
<slope><NL>
<slope> ::= {NEG | POS | EITH | ALT}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:TV:POLarity" on page 605
Example Code
' TRIGGER_EDGE_SLOPE - Sets the slope of the edge for the trigger.
' Set the slope to positive.
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
515
5
Commands by Subsystem
:TRIGger[:EDGE]:SOURce
(see page 798)
Command Syntax
:TRIGger[:EDGE]:SOURce <source>
<source> ::= {CHANnel<n> | EXTernal | LINE} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15 | EXTernal | LINE}
for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger[:EDGE]:SOURce command selects the channel that produces
the trigger.
Query Syntax
:TRIGger[:EDGE]:SOURce?
The :TRIGger[:EDGE]:SOURce? query returns the current source. If all
channels are off, the query returns "NONE."
Return Format
<source><NL>
<source> ::= {CHAN<n> | EXT | LINE | NONE} for the DSO models
<source> ::= {CHAN<n> | DIG0,..,DIG15 | EXTernal | LINE | NONE}
for the MSO models
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
Example Code
' TRIGGER_EDGE_SOURCE - Selects the channel that actually produces th
e
' edge trigger. Any channel can be selected.
myScope.WriteString ":TRIGGER:EDGE:SOURCE CHANNEL1"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
516
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray Commands
Table 82 :TRIGger:FLEXray Commands Summary
Command
Query
Options and Query Returns
:TRIGger:FLEXray:AUTo
setup (see page 518)
n/a
n/a
:TRIGger:FLEXray:BAUD
rate <baudrate> (see
page 519)
:TRIGger:FLEXray:BAUD
rate? (see page 519)
<baudrate> ::= {2500000 | 5000000
| 10000000}
:TRIGger:FLEXray:CHAN
nel <channel> (see
page 520)
:TRIGger:FLEXray:CHAN
nel? (see page 520)
<channel> ::= {A | B}
:TRIGger:FLEXray:ERRo
r:TYPE <error_type>
(see page 521)
:TRIGger:FLEXray:ERRo
r:TYPE? (see
page 521)
<error_type> ::= {ALL | HCRC |
FCRC}
:TRIGger:FLEXray:EVEN
t:TYPE <event> (see
page 522)
:TRIGger:FLEXray:EVEN
t:TYPE? (see
page 522)
<event> ::= {WAKeup | TSS | {FES
| DTS} | BSS}
:TRIGger:FLEXray:FRAM
e:CCBase
<cycle_count_base>
(see page 523)
:TRIGger:FLEXray:FRAM
e:CCBase? (see
page 523)
<cycle_count_base> ::= integer
from 0-63
:TRIGger:FLEXray:FRAM
e:CCRepetition
<cycle_count_repetiti
on> (see page 524)
:TRIGger:FLEXray:FRAM
e:CCRepetition? (see
page 524)
<cycle_count_repetition> ::=
{ALL | <rep #>}
<rep #> ::= integer from 2-64
:TRIGger:FLEXray:FRAM
e:ID <frame_id> (see
page 525)
:TRIGger:FLEXray:FRAM
e:ID? (see page 525)
<frame_id> ::= {ALL | <frame #>}
<frame #> ::= integer from 1-2047
:TRIGger:FLEXray:FRAM
e:TYPE <frame_type>
(see page 526)
:TRIGger:FLEXray:FRAM
e:TYPE? (see
page 526)
<frame_type> ::= {NORMal |
STARtup | NULL | SYNC | NSTArtup
| NNULl | NSYNc | ALL}
:TRIGger:FLEXray:SOUR
ce <source> (see
page 527)
:TRIGger:FLEXray:SOUR
ce? (see page 527)
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:FLEXray:TRIG
ger <condition> (see
page 528)
:TRIGger:FLEXray:TRIG
ger? (see page 528)
<condition> ::= {FRAMe | ERRor |
EVENt}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
517
5
Commands by Subsystem
:TRIGger:FLEXray:AUTosetup
(see page 798)
Command Syntax
:TRIGger:FLEXray:AUTosetup
The :TRIGger:FLEXray:AUTosetup command automatically configures
oscilloscope settings to facilitate FlexRay triggering and serial decode.
• Sets the selected source channel's impedance to 50 Ohms.
• Sets the selected source channel&#8217;s probe attenuation to 10:1.
• Sets the trigger level (on the selected source channel) to - 300 mV.
• Turns on trigger Noise Reject.
• Turns on Serial Decode.
• Sets the trigger type to FlexRay.
NOTE
See Also
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
• ":TRIGger:FLEXray:BAUDrate" on page 519
• ":TRIGger[:EDGE]:LEVel" on page 513
• ":TRIGger:FLEXray:SOURce" on page 527
518
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray:BAUDrate
(see page 798)
Command Syntax
:TRIGger:FLEXray:BAUDrate <baudrate>
<baudrate> ::= {2500000 | 5000000 | 10000000}
The :TRIGger:FLEXray:BAUDrate command specifies the baud rate as
2.5 Mb/s, 5 Mb/s, or 10 Mb/s.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the FlexRay
triggering and serial decode option (Option FLX) has been licensed.
:TRIGger:FLEXray:BAUDrate?
The :TRIGger:FLEXray:BAUDrate? query returns the current baud rate
setting.
Return Format
<baudrate><NL>
<baudrate> ::= {2500000 | 5000000 | 10000000}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray Commands" on page 517
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
519
5
Commands by Subsystem
:TRIGger:FLEXray:CHANnel
(see page 798)
Command Syntax
:TRIGger:FLEXray:CHANnel <channel>
<channel> ::= {A | B}
The :TRIGger:FLEXray:CHANnel command specifies the bus channel, A or
B, of the FlexRay signal.
NOTE
Query Syntax
This command is only valid on 4 (analog) channel oscilloscope models when the FlexRay
triggering and serial decode option (Option FLX) has been licensed.
:TRIGger:FLEXray:CHANnel?
The :TRIGger:FLEXray:CHANnel? query returns the current bus channel
setting.
Return Format
<channel><NL>
<channel> ::= {A | B}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray Commands" on page 517
520
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray:ERRor:TYPE
(see page 798)
Command Syntax
:TRIGger:FLEXray:ERRor:TYPE <error_type>
<error_type> ::= {ALL | HCRC | FCRC}
Selects the FlexRay error type to trigger on. The error type setting is only
valid when the FlexRay trigger mode is set to ERRor.
• ALL — triggers on ALL errors.
• HCRC — triggers on only Header CRC errors.
• FCRC — triggers on only Frame CRC errors.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:ERRor:TYPE?
The :TRIGger:FLEXray:ERRor:TYPE? query returns the currently selected
FLEXray error type.
Return Format
<error_type><NL>
<error_type> ::= {ALL | HCRC | FCRC}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
521
5
Commands by Subsystem
:TRIGger:FLEXray:EVENt:TYPE
(see page 798)
Command Syntax
:TRIGger:FLEXray:EVENt:TYPE <event>
<event> ::= {WAKeup | TSS | {FES | DTS} | BSS}
Selects the FlexRay event to trigger on. The event setting is only valid
when the FlexRay trigger mode is set to EVENt.
• WAKeup — triggers on Wake- Up event.
• TSS — triggers on Transmission Start Sequence event.
• FES — triggers on Frame End Sequence event.
• DTS — triggers on Dynamic Trailing Sequence event.
• BSS — triggers on Byte Start Sequence event.
NOTE
FES and DTS are equivalent.
NOTE
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
Query Syntax
:TRIGger:FLEXray:EVENt:TYPE?
The :TRIGger:FLEXray:EVENt:TYPE? query returns the currently selected
FLEXray event.
Return Format
<event><NL>
<event> ::= {WAK | TSS | {FES | DTS} | BSS}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
• ":TRIGger:FLEXray:AUTosetup" on page 518
• ":TRIGger:FLEXray:SOURce" on page 527
522
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray:FRAMe:CCBase
(see page 798)
Command Syntax
:TRIGger:FLEXray:FRAMe:CCBase <cycle_count_base>
<cycle_count_base> ::= integer from 0-63
The :TRIGger:FLEXray:FRAMe:CCBase command sets the base of the
FlexRay cycle count (in the frame header) to trigger on. The cycle count
base setting is only valid when the FlexRay trigger mode is set to FRAME.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:FRAMe:CCBase?
The :TRIGger:FLEXray:FRAMe:CCBase? query returns the current cycle
count base setting for the FlexRay frame trigger setup.
Return Format
<cycle_count_base><NL>
<cycle_count_base> ::= integer from 0-63
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
523
5
Commands by Subsystem
:TRIGger:FLEXray:FRAMe:CCRepetition
(see page 798)
Command Syntax
:TRIGger:FLEXray:FRAMe:CCRepetition <cycle_count_repetition>
<cycle_count_repetition> ::= {ALL | <rep #>}
<rep #> ::= integer from 2-64
The :TRIGger:FLEXray:FRAMe:CCRepetition command sets the repetition
number of the FlexRay cycle count (in the frame header) to trigger on. The
cycle count repetition setting is only valid when the FlexRay trigger mode
is set to FRAME.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:FRAMe:CCRepetition?
The :TRIGger:FLEXray:FRAMe:CCRepetition? query returns the current
cycle count repetition setting for the FlexRay frame trigger setup.
Return Format
<cycle_count_repetition><NL>
<cycle_count_repetition> ::= {ALL | <rep #>}
<rep #> ::= integer from 2-64
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
524
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray:FRAMe:ID
(see page 798)
Command Syntax
:TRIGger:FLEXray:FRAMe:ID <frame_id>
<frame_id> ::= {ALL | <frame #>}
<frame #> ::= integer from 1-2047
The :TRIGger:FLEXray:FRAMe:ID command sets the FlexRay frame ID to
trigger on . The frame IF setting is only valid when the FlexRay trigger
mode is set to FRAME.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:FRAMe:ID?
The :TRIGger:FLEXray:FRAMe:ID? query returns the current frame ID
setting for the FlexRay frame trigger setup.
Return Format
<frame_id><NL>
<frame_id> ::= {ALL | <frame #>}
<frame #> ::= integer from 1-2047
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:FLEXray:TRIGger" on page 528
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
525
5
Commands by Subsystem
:TRIGger:FLEXray:FRAMe:TYPE
(see page 798)
Command Syntax
:TRIGger:FLEXray:FRAMe:TYPE <frame_type>
<frame_type> ::= {NORMal | STARtup | NULL | SYNC | NSTArtup | NNULl |
NSYNc | ALL}
The :TRIGger:FLEXray:FRAMe:TYPE command sets the FlexRay frame type
to trigger on. The frame type setting is only valid when the FlexRay trigger
mode is set to FRAME.
• NORMal — will trigger on only normal (NSTArtup & NNULl & NSYNc)
frames.
• STARtup — will trigger on only startup frames.
• NULL — will trigger on only null frames.
• SYNC — will trigger on only sync frames.
• NSTArtup — will trigger on frames other than startup frames.
• NNULl — will trigger on frames other than null frames.
• NSYNc — will trigger on frames other than sync frames.
• ALL — will trigger on all FlexRay frame types.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:FRAMe:TYPE?
The :TRIGger:FLEXray:FRAMe:TYPE? query returns the current frame type
setting for the FlexRay frame trigger setup.
Return Format
<frame_type><NL>
<frame_type> ::= {NORM | STAR | NULL | SYNC | NSTA | NNUL |
NSYN | ALL}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:FLEXray:TRIGger" on page 528
526
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:FLEXray:SOURce
(see page 798)
Command Syntax
:TRIGger:FLEXray:SOURce <source>
<source> ::= {CHANnel<n>}
<n> ::= {1 | 2 | 3 | 4}
The :TRIGger:FLEXray:SOURce command specifies the input source for the
FlexRay signal.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:SOURce?
The :TRIGger:FLEXray:SOURce? query returns the current source for the
FlexRay signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:FLEXray:TRIGger" on page 528
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":TRIGger:FLEXray:AUTosetup" on page 518
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
527
5
Commands by Subsystem
:TRIGger:FLEXray:TRIGger
(see page 798)
Command Syntax
:TRIGger:FLEXray:TRIGger <condition>
<condition> ::= {FRAMe | ERRor | EVENt}
The :TRIGger:FLEXray:TRIGger command sets the FLEXray trigger on
condition:
• FRAMe — triggers on specified frames (without errors).
• ERRor — triggers on selected active error frames and unknown bus
conditions.
• EVENt — triggers on specified FlexRay event/symbol.
NOTE
Query Syntax
This command is only valid when the FLEXray triggering and serial decode option (Option
FLX) has been licensed.
:TRIGger:FLEXray:TRIGger?
The :TRIGger:FLEXray:TRIGger? query returns the current FLEXray trigger
on condition.
Return Format
<condition><NL>
<condition> ::= {FRAM | ERR | EVEN}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:FLEXray:ERRor:TYPE" on page 521
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":TRIGger:FLEXray:FRAMe:CCBase" on page 523
• ":TRIGger:FLEXray:FRAMe:CCRepetition" on page 524
• ":TRIGger:FLEXray:FRAMe:ID" on page 525
• ":TRIGger:FLEXray:FRAMe:TYPE" on page 526
528
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:GLITch Commands
Table 83 :TRIGger:GLITch Commands Summary
Command
Query
Options and Query Returns
:TRIGger:GLITch:GREat
erthan
<greater_than_time>[s
uffix] (see page 531)
:TRIGger:GLITch:GREat
erthan? (see
page 531)
<greater_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:LESSt
han
<less_than_time>[suff
ix] (see page 532)
:TRIGger:GLITch:LESSt
han? (see page 532)
<less_than_time> ::=
floating-point number in NR3
format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:LEVel
<level> [<source>]
(see page 533)
:TRIGger:GLITch:LEVel
? (see page 533)
For internal triggers, <level>
::= .75 x full-scale voltage from
center screen in NR3 format.
For external triggers (DSO
models), <level> ::= ±(external
range setting) in NR3 format.
For digital channels (MSO
models), <level> ::= ±8 V.
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:GLITch:POLar
ity <polarity> (see
page 534)
:TRIGger:GLITch:POLar
ity? (see page 534)
<polarity> ::= {POSitive |
NEGative}
:TRIGger:GLITch:QUALi
fier <qualifier> (see
page 535)
:TRIGger:GLITch:QUALi
fier? (see page 535)
<qualifier> ::= {GREaterthan |
LESSthan | RANGe}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
529
5
Commands by Subsystem
Table 83 :TRIGger:GLITch Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:GLITch:RANGe
<less_than_time>[suff
ix],
<greater_than_time>[s
uffix] (see page 536)
:TRIGger:GLITch:RANGe
? (see page 536)
<less_than_time> ::= 15 ns to
10 seconds in NR3 format
<greater_than_time> ::= 10 ns to
9.99 seconds in NR3 format
[suffix] ::= {s | ms | us | ns |
ps}
:TRIGger:GLITch:SOURc
e <source> (see
page 537)
:TRIGger:GLITch:SOURc
e? (see page 537)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
530
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:GLITch:GREaterthan
(see page 798)
Command Syntax
:TRIGger:GLITch:GREaterthan <greater_than_time>[<suffix>]
<greater_than_time> ::= floating-point number in NR3 format
<suffix> ::= {s | ms | us | ns | ps}
The :TRIGger:GLITch:GREaterthan command sets the minimum pulse width
duration for the selected :TRIGger:GLITch:SOURce.
Query Syntax
:TRIGger:GLITch:GREaterthan?
The :TRIGger:GLITch:GREaterthan? query returns the minimum pulse
width duration time for :TRIGger:GLITch:SOURce.
Return Format
<greater_than_time><NL>
<greater_than_time> ::= floating-point number in NR3 format.
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:MODE" on page 485
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
531
5
Commands by Subsystem
:TRIGger:GLITch:LESSthan
(see page 798)
Command Syntax
:TRIGger:GLITch:LESSthan <less_than_time>[<suffix>]
<less_than_time> ::= floating-point number in NR3 format
<suffix> ::= {s | ms | us | ns | ps}
The :TRIGger:GLITch:LESSthan command sets the maximum pulse width
duration for the selected :TRIGger:GLITch:SOURce.
Query Syntax
:TRIGger:GLITch:LESSthan?
The :TRIGger:GLITch:LESSthan? query returns the pulse width duration
time for :TRIGger:GLITch:SOURce.
Return Format
<less_than_time><NL>
<less_than_time> ::= floating-point number in NR3 format.
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:MODE" on page 485
532
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:GLITch:LEVel
(see page 798)
Command Syntax
:TRIGger:GLITch:LEVel <level_argument>
<level_argument> ::= <level>[, <source>]
<level> ::= .75 x full-scale voltage from center screen in NR3 format
for internal triggers
<level> ::= ±(external range setting) in NR3 format
for external triggers (DSO models)
<level> ::= ±8 V for digital channels (MSO models)
<source> ::= {CHANnel<n> | EXTernal} for DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:GLITch:LEVel command sets the trigger level voltage for the
active pulse width trigger.
Query Syntax
:TRIGger:GLITch:LEVel?
The :TRIGger:GLITch:LEVel? query returns the trigger level of the current
pulse width trigger mode. If all channels are off, the query returns
"NONE."
Return Format
See Also
<level_argument><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:GLITch:SOURce" on page 537
• ":EXTernal:RANGe" on page 274
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
533
5
Commands by Subsystem
:TRIGger:GLITch:POLarity
(see page 798)
Command Syntax
:TRIGger:GLITch:POLarity <polarity>
<polarity> ::= {POSitive | NEGative}
The :TRIGger:GLITch:POLarity command sets the polarity for the glitch
pulse width trigger.
Query Syntax
:TRIGger:GLITch:POLarity?
The :TRIGger:GLITch:POLarity? query returns the glitch pulse width trigger
polarity.
Return Format
<polarity><NL>
<polarity> ::= {POS | NEG}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:GLITch:SOURce" on page 537
534
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:GLITch:QUALifier
(see page 798)
Command Syntax
:TRIGger:GLITch:QUALifier <operator>
<operator> ::= {GREaterthan | LESSthan | RANGe}
This command sets the mode of operation of the glitch pulse width trigger.
The oscilloscope can trigger on a pulse width that is greater than a time
value, less than a time value, or within a range of time values.
Query Syntax
:TRIGger:GLITch:QUALifier?
The :TRIGger:GLITch:QUALifier? query returns the glitch pulse width
qualifier.
Return Format
<operator><NL>
<operator> ::= {GRE | LESS | RANG}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:MODE" on page 485
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
535
5
Commands by Subsystem
:TRIGger:GLITch:RANGe
(see page 798)
Command Syntax
:TRIGger:GLITch:RANGe <less_than_time>[suffix],
<greater_than_time>[suffix]
<less_than_time> ::= (15 ns - 10 seconds) in NR3 format
<greater_than_time> ::= (10 ns - 9.99 seconds) in NR3 format
[suffix] ::= {s | ms | us | ns | ps}
The :TRIGger:GLITch:RANGe command sets the pulse width duration for
the selected :TRIGger:GLITch:SOURce. You can enter the parameters in any
order — the smaller value becomes the <greater_than_time> and the larger
value becomes the <less_than_time>.
Query Syntax
:TRIGger:GLITch:RANGe?
The :TRIGger:GLITch:RANGe? query returns the pulse width duration time
for :TRIGger:GLITch:SOURce.
Return Format
See Also
<less_than_time>,<greater_than_time><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:MODE" on page 485
536
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:GLITch:SOURce
(see page 798)
Command Syntax
:TRIGger:GLITch:SOURce <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {DIGital0,..,DIGital15 | CHANnel<n>} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:GLITch:SOURce command selects the channel that produces
the pulse width trigger.
Query Syntax
:TRIGger:GLITch:SOURce?
The :TRIGger:GLITch:SOURce? query returns the current pulse width
source. If all channels are off, the query returns "NONE."
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:GLITch:LEVel" on page 533
• ":TRIGger:GLITch:POLarity" on page 534
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:GLITch:RANGe" on page 536
Example Code
• "Example Code" on page 516
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
537
5
Commands by Subsystem
:TRIGger:I2S Commands
Table 84 :TRIGger:I2S Commands Summary
Command
Query
Options and Query Returns
:TRIGger:I2S:ALIGnmen
t <setting> (see
page 540)
:TRIGger:I2S:ALIGnmen
t? (see page 540)
<setting> ::= {I2S | LJ | RJ}
:TRIGger:I2S:AUDio
<audio_ch> (see
page 541)
:TRIGger:I2S:AUDio?
(see page 541)
<audio_ch> ::= {RIGHt | LEFT |
EITHer}
:TRIGger:I2S:CLOCk:SL
OPe <slope> (see
page 542)
:TRIGger:I2S:CLOCk:SL
OPe? (see page 542)
<slope> ::= {NEGative | POSitive}
:TRIGger:I2S:PATTern:
DATA <string> (see
page 543)
:TRIGger:I2S:PATTern:
DATA? (see page 544)
<string> ::= "n" where n ::=
32-bit integer in signed decimal
when <base> = DECimal
<string> ::= "nn...n" where n ::=
{0 | 1 | X | $} when <base> =
BINary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F | X | $}
when <base> = HEX
:TRIGger:I2S:PATTern:
FORMat <base> (see
page 545)
:TRIGger:I2S:PATTern:
FORMat? (see
page 545)
<base> ::= {BINary | HEX |
DECimal}
:TRIGger:I2S:RANGe
<upper>,<lower> (see
page 546)
:TRIGger:I2S:RANGe?
(see page 546)
<upper> ::= 32-bit integer in
signed decimal, <nondecimal>, or
<string>
<lower> ::= 32-bit integer in
signed 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:I2S:RWIDth
<receiver> (see
page 548)
:TRIGger:I2S:RWIDth?
(see page 548)
<receiver> ::= 4-32 in NR1 format
538
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 84 :TRIGger:I2S Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:I2S:SOURce:C
LOCk <source> (see
page 549)
:TRIGger:I2S:SOURce:C
LOCk? (see page 549)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:SOURce:D
ATA <source> (see
page 550)
:TRIGger:I2S:SOURce:D
ATA? (see page 550)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:SOURce:W
SELect <source> (see
page 551)
:TRIGger:I2S:SOURce:W
SELect? (see
page 551)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:I2S:TRIGger
<operator> (see
page 552)
:TRIGger:I2S:TRIGger?
(see page 552)
<operator> ::= {EQUal | NOTequal
| LESSthan | GREaterthan |
INRange | OUTRange | INCReasing |
DECReasing}
:TRIGger:I2S:TWIDth
<word_size> (see
page 554)
:TRIGger:I2S:TWIDth?
(see page 554)
<word_size> ::= 4-32 in NR1
format
:TRIGger:I2S:WSLow
<low_def> (see
page 555)
:TRIGger:I2S:WSLow?
(see page 555)
<low_def> ::= {LEFT | RIGHt}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
539
5
Commands by Subsystem
:TRIGger:I2S:ALIGnment
(see page 798)
Command Syntax
:TRIGger:I2S:ALIGnment <setting>
<setting> ::= {I2S | LJ | RJ}
The :TRIGger:I2S:ALIGnment command selects the data alignment of the
I2S bus for the serial decoder and/or trigger when in I2S mode:
• I2S — standard.
• LJ — left justified.
• RJ — right justified.
Note that the word select (WS) polarity is specified separately with the
:TRIGger:I2S:WSHigh command.
Query Syntax
:TRIGger:I2S:ALIGnment?
The :TRIGger:I2S:ALIGnment? query returns the currently selected I2S data
alignment.
Return Format
<setting><NL>
<setting> ::= {I2S | LJ | RJ}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:WSLow" on page 555
540
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:I2S:AUDio
(see page 798)
Command Syntax
:TRIGger:I2S:AUDio <audio_ch>
<audio_ch> ::= {RIGHt | LEFT | EITHer}
The :TRIGger:I2S:AUDio command specifies the audio channel to trigger
on:
• RIGHt — right channel.
• LEFT— left channel.
• EITHer — right channel.
Query Syntax
:TRIGger:I2S:AUDio?
The :TRIGger:I2S:AUDio? query returns the current audio channel for the
I2S trigger.
Return Format
<audio_ch><NL>
<audio_ch> ::= {RIGH | LEFT | EITH}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:TRIGger" on page 552
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
541
5
Commands by Subsystem
:TRIGger:I2S:CLOCk:SLOPe
(see page 798)
Command Syntax
:TRIGger:I2S:CLOCk:SLOPe <slope>
<slope> ::= {NEGative | POSitive}
The :TRIGger:I2S:CLOCk:SLOPe command specifies which edge of the I2S
serial clock signal clocks in data.
• NEGative — Falling edge.
• POSitive — Rising edge.
Query Syntax
:TRIGger:I2S:CLOCk:SLOPe?
The :TRIGger:I2S:CLOCk:SLOPe? query returns the current I2S clock slope
setting.
Return Format
<slope><NL>
<slope> ::= {NEG | POS}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:ALIGnment" on page 540
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:WSLow" on page 555
542
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:I2S:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:I2S:PATTern:DATA <string>
<string> ::= "n" where n ::= 32-bit integer in signed decimal when
<base> = DECimal
<string> ::= "nn...n" where n ::= {0 | 1 | X | $} when
<base> = BINary
<string> ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} when
<base> = HEX
NOTE
<base> is specified with the :TRIGger:I2S:PATTern:FORMat command. The default <base>
is DECimal.
The :TRIGger:I2S:PATTern:DATA command specifies the I2S trigger data
pattern searched for in each I2S message.
Set a <string> bit to "0" or "1" to set the corresponding bit in the data
pattern to low or high, respectively.
Set a <string> bit to "X" to ignore (mask off) that bit in the data pattern.
Use the "$" character to indicate that the value of the corresponding bit
will not be changed (the existing bit value is used).
When <base> = DECimal, the "X" and "$" characters cannot be entered.
When queried, the "$" character is returned when any bits in the pattern
have the value of "X" and <base> = DECimal. When any bits in a given
nibble have the value of "X" and <base> = HEX, the "$" character is
returned for the corresponding nibble.
NOTE
The :TRIGger:I2S:PATTern:DATA command specifies the I2S trigger data pattern used by the
EQUal, NOTequal, GREaterthan, and LESSthan trigger conditions. If the GREaterthan or
LESSthan trigger condition is selected, the bits specified to be masked off ("X") will be
interpreted as 0's.
NOTE
The length of the trigger data value is determined by the :TRIGger:I2S:RWIDth and
:TRIGger:I2S:TWIDth commands. When the receiver word size is less than the transmitter
word size, the data length is equal to the receiver word size. When the receiver word size is
greater than the transmitter word size, the data length is equal to the transmitter word size.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
543
5
Commands by Subsystem
NOTE
Query Syntax
If more bits are sent for <string> than the specified trigger data length, the most significant
bits will be truncated. If the word size is changed after the <string> is programmed, the
added or deleted bits will be added to or deleted from the least significant bits.
:TRIGger:I2S:PATTern:DATA?
The :TRIGger:I2S:PATTern:DATA? query returns the currently specified I2S
trigger data pattern.
Return Format
See Also
<string><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:PATTern:FORMat" on page 545
• ":TRIGger:I2S:TRIGger" on page 552
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:AUDio" on page 541
544
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:I2S:PATTern:FORMat
(see page 798)
Command Syntax
:TRIGger:I2S:PATTern:FORMat <base>
<base> ::= {BINary | HEX | DECimal}
The :TRIGger:I2S:PATTern:FORMat command sets the entry (and query)
number base used by the :TRIGger:I2S:PATTern:DATA command. The
default <base> is DECimal.
Query Syntax
:TRIGger:I2S:PATTern:FORMat?
The :TRIGger:I2S:PATTern:FORMat? query returns the currently set number
base for I2S pattern data.
Return Format
<base><NL>
<base> ::= {BIN | HEX | DEC}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:AUDio" on page 541
• ":TRIGger:I2S:TRIGger" on page 552
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
545
5
Commands by Subsystem
:TRIGger:I2S:RANGe
(see page 798)
Command Syntax
:TRIGger:I2S:RANGe <upper>,<lower>
<upper> ::= 32-bit integer in signed decimal, <nondecimal>,
or <string>
<lower> ::= 32-bit integer in signed 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
The :TRIGger:I2S:RANGe command sets the upper and lower range
boundaries used by the INRange, OUTRange, INCReasing, and DECReasing
trigger conditions. You can enter the parameters in any order — the
smaller value becomes the <lower> and the larger value becomes the
<upper>.
Note that for INCReasing and DECReasing, the <upper> and <lower> values
correspond to the "Armed" and "Trigger" softkeys.
NOTE
Query Syntax
The length of the <upper> and <lower> values is determined by the :TRIGger:I2S:RWIDth
and :TRIGger:I2S:TWIDth commands. When the receiver word size is less than the
transmitter word size, the length is equal to the receiver word size. When the receiver word
size is greater than the transmitter word size, the length is equal to the transmitter word
size.
:TRIGger:I2S:RANGe?
The :TRIGger:I2S:RANGe? query returns the currently set upper and lower
range boundaries.
Return Format
<upper>,<lower><NL>
<upper> ::= 32-bit integer in signed decimal, <nondecimal>,
or <string>
<lower> ::= 32-bit integer in signed 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
See Also
546
• "Introduction to :TRIGger Commands" on page 479
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
• ":TRIGger:I2S:TRIGger" on page 552
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:WSLow" on page 555
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
547
5
Commands by Subsystem
:TRIGger:I2S:RWIDth
(see page 798)
Command Syntax
:TRIGger:I2S:RWIDth <receiver>
<receiver> ::= 4-32 in NR1 format
The :TRIGger:I2S:RWIDth command sets the width of the receiver
(decoded) data word in I2S anywhere from 4 bits to 32 bits.
Query Syntax
:TRIGger:I2S:RWIDth?
The :TRIGger:I2S:RWIDth? query returns the currently set I2S receiver data
word width.
Return Format
<receiver><NL>
<receiver> ::= 4-32 in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:ALIGnment" on page 540
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:WSLow" on page 555
548
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:I2S:SOURce:CLOCk
(see page 798)
Command Syntax
:TRIGger:I2S:SOURce:CLOCk <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:I2S:SOURce:CLOCk controls which signal is used as the serial
clock (SCLK) source by the serial decoder and/or trigger when in I2S
mode.
Query Syntax
:TRIGger:I2S:SOURce:CLOCk?
The :TRIGger:I2S:SOURce:CLOCk? query returns the current source for the
I2S serial clock (SCLK).
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:SOURce:DATA" on page 550
• ":TRIGger:I2S:SOURce:WSELect" on page 551
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
549
5
Commands by Subsystem
:TRIGger:I2S:SOURce:DATA
(see page 798)
Command Syntax
:TRIGger:I2S:SOURce:DATA <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:I2S:SOURce:DATA command controls which signal is used as
the serial data (SDATA) source by the serial decoder and/or trigger when
in I2S mode.
Query Syntax
:TRIGger:I2S:SOURce:DATA?
The :TRIGger:I2S:SOURce:DATA? query returns the current source for the
I2S serial data (SDATA).
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:SOURce:CLOCk" on page 549
• ":TRIGger:I2S:SOURce:WSELect" on page 551
550
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:I2S:SOURce:WSELect
(see page 798)
Command Syntax
:TRIGger:I2S:SOURce:WSELect <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:I2S:SOURce:WSELect command controls which signal is used
as the word select (WS) source by the serial decoder and/or trigger when
in I2S mode.
Query Syntax
:TRIGger:I2S:SOURce:WSELect?
The :TRIGger:I2S:SOURce:WSELect? query returns the current source for
I2S word select (WS).
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:SOURce:CLOCk" on page 549
• ":TRIGger:I2S:SOURce:DATA" on page 550
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
551
5
Commands by Subsystem
:TRIGger:I2S:TRIGger
(see page 798)
Command Syntax
:TRIGger:I2S:TRIGger <operator>
<operator> ::= {EQUal | NOTequal | LESSthan | GREaterthan | INRange
| OUTRange | INCReasing | DECReasing}
The :TRIGger:I2S:TRIGger command sets the I2S trigger operator:
• EQUal— triggers on the specified audio channel's data word when it
equals the specified word.
• NOTequal — triggers on any word other than the specified word.
• LESSthan — triggers when the channel's data word is less than the
specified value.
• GREaterthan — triggers when the channel's data word is greater than
the specified value.
• INRange — enter upper and lower values to specify the range in which
to trigger.
• OUTRange — enter upper and lower values to specify range in which
trigger will not occur.
• INCReasing — triggers when the data value makes a certain increase
over time and the specified value is met or exceeded. Use the
:TRIGger:I2S:RANGe command to set "Trigger" and "Armed" values. The
"Trigger" value is the value that must be met or exceeded to cause the
trigger. The "Armed" value is the value the data must go below in order
to re- arm the oscilloscope (ready it to trigger again).
Trigger
Trigger
No trigger
"Trigger" value
"Armed" value
• DECReasing — similar to INCReasing except the trigger occurs on a
certain descrease over time and the "Trigger" data value is less than the
"Armed" data value.
Query Syntax
552
:TRIGger:I2S:TRIGger?
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
The :TRIGger:I2S:TRIGger? query returns the current I2S trigger operator.
Return Format
<operator><NL>
<operator> ::= {EQU | NOT | LESS | GRE | INR | OUTR | INCR | DECR}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:AUDio" on page 541
• ":TRIGger:I2S:RANGe" on page 546
• ":TRIGger:I2S:PATTern:FORMat" on page 545
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
553
5
Commands by Subsystem
:TRIGger:I2S:TWIDth
(see page 798)
Command Syntax
:TRIGger:I2S:TWIDth <word_size>
<word_size> ::= 4-32 in NR1 format
The :TRIGger:I2S:TWIDth command sets the width of the transmitted data
word in I2S anywhere from 4 bits to 32 bits.
Query Syntax
:TRIGger:I2S:TWIDth?
The :TRIGger:I2S:TWIDth? query returns the currently set I2S transmitted
data word width.
Return Format
<word_size><NL>
<word_size> ::= 4-32 in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:ALIGnment" on page 540
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:WSLow" on page 555
554
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:I2S:WSLow
(see page 798)
Command Syntax
:TRIGger:I2S:WSLow <low_def>
<low_def> ::= {LEFT | RIGHt}
The :TRIGger:I2S:WSLow command selects the polarity of the word select
(WS) signal:
• LEFT— a word select (WS) state of low indicates left channel data is
active on the I2S bus, and a WS state of high indicates right channel
data is active on the bus.
• RIGHt — a word select (WS) state of low indicates right channel data is
active on the I2S bus, and a WS state of high indicates left channel
data is active on the bus.
Query Syntax
:TRIGger:I2S:WSLow?
The :TRIGger:I2S:WSLow? query returns the currently selected I2S word
select (WS) polarity.
Return Format
<low_def><NL>
<low_def> ::= {LEFT | RIGHt}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:I2S:ALIGnment" on page 540
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:TWIDth" on page 554
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
555
5
Commands by Subsystem
:TRIGger:IIC Commands
Table 85 :TRIGger:IIC Commands Summary
Command
Query
Options and Query Returns
:TRIGger:IIC:PATTern:
ADDRess <value> (see
page 557)
:TRIGger:IIC:PATTern:
ADDRess? (see
page 557)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
:TRIGger:IIC:PATTern:
DATA <value> (see
page 558)
:TRIGger:IIC:PATTern:
DATA? (see page 558)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
:TRIGger:IIC:PATTern:
DATa2 <value> (see
page 559)
:TRIGger:IIC:PATTern:
DATa2? (see page 559)
<value> ::= integer or <string>
<string> ::= "0xnn" n ::= {0,..,9
| A,..,F}
:TRIGger:IIC[:SOURce]
:CLOCk <source> (see
page 560)
:TRIGger:IIC[:SOURce]
:CLOCk? (see
page 560)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:IIC[:SOURce]
:DATA <source> (see
page 561)
:TRIGger:IIC[:SOURce]
:DATA? (see page 561)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15 } for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:IIC:TRIGger:
QUALifier <value>
(see page 562)
:TRIGger:IIC:TRIGger:
QUALifier? (see
page 562)
<value> ::= {EQUal | NOTequal |
LESSthan | GREaterthan}
:TRIGger:IIC:TRIGger[
:TYPE] <type> (see
page 563)
:TRIGger:IIC:TRIGger[
:TYPE]? (see
page 563)
<type> ::= {STARt | STOP | READ7
| READEprom | WRITe7 | WRITe10 |
NACKnowledge | ANACknowledge |
R7Data2 | W7Data2 | RESTart}
556
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:IIC:PATTern:ADDRess
(see page 798)
Command Syntax
:TRIGger:IIC:PATTern:ADDRess <value>
<value> ::= integer or <string>
<string> ::= "0xnn" where n ::= {0,..,9 | A,..,F}
The :TRIGger:IIC:PATTern:ADDRess command sets the address for IIC
data.The address can range from 0x00 to 0x7F (7- bit) or 0x3FF (10- bit)
hexadecimal. Use the don't care address (- 1 or 0xFFFFFFFF) to ignore the
address value.
Query Syntax
:TRIGger:IIC:PATTern:ADDRess?
The :TRIGger:IIC:PATTern:ADDRess? query returns the current address for
IIC data.
Return Format
<value><NL>
<value> ::= integer
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:IIC:PATTern:DATA" on page 558
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
557
5
Commands by Subsystem
:TRIGger:IIC:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:IIC:PATTern:DATA <value>
<value> ::= integer or <string>
<string> ::= "0xnn" where n ::= {0,..,9 | A,..,F}
The :TRIGger:IIC:PATTern:DATA command sets IIC data. The data value
can range from 0x00 to 0x0FF (hexadecimal). Use the don't care data
pattern (- 1 or 0xFFFFFFFF) to ignore the data value.
Query Syntax
:TRIGger:IIC:PATTern:DATA?
The :TRIGger:IIC:PATTern:DATA? query returns the current pattern for IIC
data.
Return Format
See Also
<value><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
558
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:IIC:PATTern:DATa2
(see page 798)
Command Syntax
:TRIGger:IIC:PATTern:DATa2 <value>
<value> ::= integer or <string>
<string> ::= "0xnn" where n ::= {0,..,9 | A,..,F}
The :TRIGger:IIC:PATTern:DATa2 command sets IIC data 2. The data value
can range from 0x00 to 0x0FF (hexadecimal). Use the don't care data
pattern (- 1 or 0xFFFFFFFF) to ignore the data value.
Query Syntax
:TRIGger:IIC:PATTern:DATa2?
The :TRIGger:IIC:PATTern:DATa2? query returns the current pattern for IIC
data 2.
Return Format
See Also
<value><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":TRIGger:IIC:PATTern:DATA" on page 558
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
559
5
Commands by Subsystem
:TRIGger:IIC[:SOURce]:CLOCk
(see page 798)
Command Syntax
:TRIGger:IIC:[SOURce:]CLOCk <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:IIC:[SOURce:]CLOCk command sets the source for the IIC
serial clock (SCL).
Query Syntax
:TRIGger:IIC:[SOURce:]CLOCk?
The :TRIGger:IIC:[SOURce:]CLOCk? query returns the current source for
the IIC serial clock.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:IIC[:SOURce]:DATA" on page 561
560
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:IIC[:SOURce]:DATA
(see page 798)
Command Syntax
:TRIGger:IIC:[SOURce:]DATA <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:IIC:[SOURce:]DATA command sets the source for IIC serial
data (SDA).
Query Syntax
:TRIGger:IIC:[SOURce:]DATA?
The :TRIGger:IIC:[SOURce:]DATA? query returns the current source for IIC
serial data.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:IIC[:SOURce]:CLOCk" on page 560
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
561
5
Commands by Subsystem
:TRIGger:IIC:TRIGger:QUALifier
(see page 798)
Command Syntax
:TRIGger:IIC:TRIGger:QUALifier <value>
<value> ::= {EQUal | NOTequal | LESSthan | GREaterthan}
The :TRIGger:IIC:TRIGger:QUALifier command sets the IIC data qualifier
when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom.
Query Syntax
:TRIGger:IIC:TRIGger:QUALifier?
The :TRIGger:IIC:TRIGger:QUALifier? query returns the current IIC data
qualifier value.
Return Format
<value><NL>
<value> ::= {EQUal | NOTequal | LESSthan | GREaterthan}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
562
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:IIC:TRIGger[:TYPE]
(see page 798)
Command Syntax
:TRIGger:IIC:TRIGger[:TYPE] <value>
<value> ::= {STARt | STOP | READ7 | READEprom | WRITe7 | WRITe10
| NACKnowledge | ANACknowledge | R7Data2 | W7Data2 | RESTart}
The :TRIGger:IIC:TRIGger[:TYPE] command sets the IIC trigger type:
• STARt — Start condition.
• STOP — Stop condition.
• READ7 — 7- bit address frame containing
(Start:Address7:Read:Ack:Data). The value READ is also accepted for
READ7.
• R7Data2 — 7- bit address frame containing
(Start:Address7:Read:Ack:Data:Ack:Data2).
• READEprom — EEPROM data read.
• WRITe7 — 7- bit address frame containing
(Start:Address7:Write:Ack:Data). The value WRITe is also accepted for
WRITe7.
• W7Data2 — 7- bit address frame containing
(Start:Address7:Write:Ack:Data:Ack:Data2).
• WRITe10 — 10- bit address frame containing (Start:Address
byte1:Write:Ack:Address byte 2:Data).
• NACKnowledge — Missing acknowledge.
• ANACknowledge — Address with no acknowledge.
• RESTart — Another start condition occurs before a stop condition.
NOTE
Query Syntax
The short form of READ7 (READ7), READEprom (READE), WRITe7 (WRIT7), and WRITe10
(WRIT10) do not follow the defined Long Form to Short Form Truncation Rules (see
page 800).
:TRIGger:IIC:TRIGger[:TYPE]?
The :TRIGger:IIC:TRIGger[:TYPE]? query returns the current IIC trigger
type value.
Return Format
<value><NL>
<value> ::= {STAR | STOP | READ7 | READE | WRIT7 | WRIT10 | NACK | ANAC
| R7D2 | W7D2 | REST}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
563
5
Commands by Subsystem
• ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":TRIGger:IIC:PATTern:DATA" on page 558
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:IIC:TRIGger:QUALifier" on page 562
• "Long Form to Short Form Truncation Rules" on page 800
564
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:LIN Commands
Table 86 :TRIGger:LIN Commands Summary
Command
Query
Options and Query Returns
:TRIGger:LIN:ID
<value> (see
page 567)
:TRIGger:LIN:ID? (see
page 567)
<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
:TRIGger:LIN:PATTern:
DATA <string> (see
page 568)
:TRIGger:LIN:PATTern:
DATA? (see page 569)
<string> ::= "n" where n ::=
32-bit integer in signed decimal
when <base> = DECimal
<string> ::= "nn...n" where n ::=
{0 | 1 | X | $} when <base> =
BINary
<string> ::= "0xnn...n" where n
::= {0,..,9 | A,..,F | X | $}
when <base> = HEX
:TRIGger:LIN:PATTern:
DATA:LENGth <length>
(see page 570)
:TRIGger:LIN:PATTern:
DATA:LENGth? (see
page 570)
<length> ::= integer from 1 to 8
in NR1 format
:TRIGger:LIN:PATTern:
FORMat <base> (see
page 571)
:TRIGger:LIN:PATTern:
FORMat? (see
page 571)
<base> ::= {BINary | HEX |
DECimal}
:TRIGger:LIN:SAMPlepo
int <value> (see
page 572)
:TRIGger:LIN:SAMPlepo
int? (see page 572)
<value> ::= {60 | 62.5 | 68 | 70
| 75 | 80 | 87.5} in NR3 format
:TRIGger:LIN:SIGNal:B
AUDrate <baudrate>
(see page 573)
:TRIGger:LIN:SIGNal:B
AUDrate? (see
page 573)
<baudrate> ::= integer from 2400
to 625000 in 100 b/s increments
:TRIGger:LIN:SOURce
<source> (see
page 574)
:TRIGger:LIN:SOURce?
(see page 574)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:LIN:STANdard
<std> (see page 575)
:TRIGger:LIN:STANdard
? (see page 575)
<std> ::= {LIN13 | LIN20}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
565
5
Commands by Subsystem
Table 86 :TRIGger:LIN Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:LIN:SYNCbrea
k <value> (see
page 576)
:TRIGger:LIN:SYNCbrea
k? (see page 576)
<value> ::= integer = {11 | 12 |
13}
:TRIGger:LIN:TRIGger
<condition> (see
page 577)
:TRIGger:LIN:TRIGger?
(see page 577)
<condition> ::= {SYNCbreak}
(without Option AMS)
<condition> ::= {SYNCbreak | ID |
DATA} (with Option AMS)
566
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:LIN:ID
(see page 798)
Command Syntax
:TRIGger:LIN:ID <value>
<value> ::= 7-bit integer in decimal, <nondecimal>, or <string>
from 0-63 or 0x00-0x3f
<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
The :TRIGger:LIN:ID command defines the LIN identifier searched for in
each CAN message when the LIN trigger mode is set to frame ID.
NOTE
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
Setting the ID to a value of "- 1" results in "0xXX" which is equivalent to
all IDs.
Query Syntax
:TRIGger:LIN:ID?
The :TRIGger:LIN:ID? query returns the current LIN identifier setting.
Return Format
<value><NL>
<value> ::= integer in decimal
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
567
5
Commands by Subsystem
:TRIGger:LIN:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:LIN:PATTern:DATA <string>
<string> ::= "n" where n ::= 32-bit integer in signed decimal when
<base> = DECimal
<string> ::= "nn...n" where n ::= {0 | 1 | X | $} when
<base> = BINary
<string> ::= "0xnn...n" where n ::= {0,..,9 | A,..,F | X | $} when
<base> = HEX
NOTE
<base> is specified with the :TRIGger:LIN:PATTern:FORMat command. The default <base>
is DECimal.
The :TRIGger:LIN:PATTern:DATA command specifies the LIN trigger data
pattern searched for in each LIN data field.
Set a <string> bit to "0" or "1" to set the corresponding bit in the data
pattern to low or high, respectively.
Set a <string> bit to "X" to ignore (mask off) that bit in the data pattern.
Use the "$" character to indicate that the value of the corresponding bit
will not be changed (the existing bit value is used).
When <base> = DECimal, the "X" and "$" characters cannot be entered.
When queried, the "$" character is returned when any bits in the pattern
have the value of "X" and <base> = DECimal. When any bits in a given
nibble have the value of "X" and <base> = HEX, the "$" character is
returned for the corresponding nibble.
568
NOTE
The :TRIGger:LIN:PATTern:DATA command specifies the LIN trigger data pattern used by
the DATA trigger condition. This command is only valid when the automotive CAN and LIN
serial decode option (Option AMS) has been licensed.
NOTE
The length of the trigger data value is determined by the
:TRIGger:LIN:PATTern:DATA:LENGth command.
NOTE
If more bits are sent for <string> than the specified trigger pattern data length, the most
significant bits will be truncated. If the data length size is changed after the <string> is
programmed, the added or deleted bits will be added to or deleted from the least significant
bits.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
Query Syntax
5
:TRIGger:LIN:PATTern:DATA?
The :TRIGger:LIN:PATTern:DATA? query returns the currently specified LIN
trigger data pattern.
Return Format
See Also
<string><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:LIN:PATTern:FORMat" on page 571
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
569
5
Commands by Subsystem
:TRIGger:LIN:PATTern:DATA:LENGth
(see page 798)
Command Syntax
:TRIGger:LIN:PATTern:DATA:LENGth <length>
<length> ::= integer from 1 to 8 in NR1 format
The :TRIGger:LIN:PATTern:DATA:LENGth command sets the number of
8- bit bytes in the LIN data string. The number of bytes in the string can
be anywhere from 0 bytes to 8 bytes (64 bits). The value for these bytes is
set by the :TRIGger:LIN:PATTern:DATA command.
NOTE
Query Syntax
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
:TRIGger:LIN:PATTern:DATA:LENGth?
The :TRIGger:LIN:PATTern:DATA:LENGth? query returns the current LIN
data pattern length setting.
Return Format
<count><NL>
<count> ::= integer from 1 to 8 in NR1 format
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:SOURce" on page 574
570
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:LIN:PATTern:FORMat
(see page 798)
Command Syntax
:TRIGger:LIN:PATTern:FORMat <base>
<base> ::= {BINary | HEX | DECimal}
The :TRIGger:LIN:PATTern:FORMat command sets the entry (and query)
number base used by the :TRIGger:LIN:PATTern:DATA command. The
default <base> is DECimal.
NOTE
Query Syntax
This command is only valid when the automotive CAN and LIN serial decode option (Option
AMS) has been licensed.
:TRIGger:LIN:PATTern:FORMat?
The :TRIGger:LIN:PATTern:FORMat? query returns the currently set
number base for LIN pattern data.
Return Format
<base><NL>
<base> ::= {BIN | HEX | DEC}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
571
5
Commands by Subsystem
:TRIGger:LIN:SAMPlepoint
(see page 798)
Command Syntax
:TRIGger:LIN:SAMPlepoint <value>
<value><NL>
<value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format
The :TRIGger:LIN:SAMPlepoint command sets the point during the bit time
where the bit level is sampled to determine whether the bit is dominant or
recessive. The sample point represents the percentage of time between the
beginning of the bit time to the end of the bit time.
NOTE
Query Syntax
The sample point values are not limited by the baud rate.
:TRIGger:LIN:SAMPlepoint?
The :TRIGger:LIN:SAMPlepoint? query returns the current LIN sample
point setting.
Return Format
<value><NL>
<value> ::= {60 | 62.5 | 68 | 70 | 75 | 80 | 87.5} in NR3 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:TRIGger" on page 577
572
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:LIN:SIGNal:BAUDrate
(see page 798)
Command Syntax
:TRIGger:LIN:SIGNal:BAUDrate <baudrate>
<baudrate> ::= integer from 2400 to 625000 in 100 b/s increments
The :TRIGger:LIN:SIGNal:BAUDrate command sets the standard baud rate
of the LIN signal from 2400 b/s to 625 kb/s in 100 b/s increments. If you
enter a baud rate that is not divisible by 100 b/s, the baud rate is set to
the nearest baud rate divisible by 100 b/s.
Query Syntax
:TRIGger:LIN:SIGNal:BAUDrate?
The :TRIGger:LIN:SIGNal:BAUDrate? query returns the current LIN baud
rate setting.
Return Format
<baudrate><NL>
<baudrate> ::= integer from 2400 to 625000 in 100 b/s increments
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
573
5
Commands by Subsystem
:TRIGger:LIN:SOURce
(see page 798)
Command Syntax
:TRIGger:LIN:SOURce <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:LIN:SOURce command sets the source for the LIN signal.
Query Syntax
:TRIGger:LIN:SOURce?
The :TRIGger:LIN:SOURce? query returns the current source for the LIN
signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
574
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:LIN:STANdard
(see page 798)
Command Syntax
:TRIGger:LIN:STANdard <std>
<std> ::= {LIN13 | LIN20}
The :TRIGger:LIN:STANdard command sets the LIN standard in effect for
triggering and decoding to be LIN1.3 or LIN2.0.
Query Syntax
:TRIGger:LIN:STANdard?
The :TRIGger:LIN:STANdard? query returns the current LIN standard
setting.
Return Format
<std><NL>
<std> ::= {LIN13 | LIN20}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
575
5
Commands by Subsystem
:TRIGger:LIN:SYNCbreak
(see page 798)
Command Syntax
:TRIGger:LIN:SYNCbreak <value>
<value> ::= integer = {11 | 12 | 13}
The :TRIGger:LIN:SYNCbreak command sets the length of the LIN sync
break to be greater than or equal to 11, 12, or 13 clock lengths. The sync
break is the idle period in the bus activity at the beginning of each packet
that distinguishes one information packet from the previous one.
Query Syntax
:TRIGger:LIN:SYNCbreak?
The :TRIGger:LIN:STANdard? query returns the current LIN sync break
setting.
Return Format
<value><NL>
<value> ::= {11 | 12 | 13}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
576
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:LIN:TRIGger
(see page 798)
Command Syntax
:TRIGger:LIN:TRIGger <condition>
<condition> ::= {SYNCbreak | ID | DATA}
The :TRIGger:LIN:TRIGger command sets the LIN trigger condition to be:
• SYNCbreak — Sync Break.
• ID — Frame ID.
Use the :TRIGger:LIN:ID command to specify the frame ID.
• DATA — Frame ID and Data.
Use the :TRIGger:LIN:ID command to specify the frame ID.
Use the :TRIGger:LIN:PATTern:DATA:LENGth and
:TRIGger:LIN:PATTern:DATA commands to specify the data string length
and value.
NOTE
Query Syntax
The ID and DATA options are available when the automotive CAN and LIN serial decode
option (Option AMS) has been licensed.
:TRIGger:LIN:TRIGger?
The :TRIGger:LIN:TRIGger? query returns the current LIN trigger value.
Return Format
<condition><NL>
<condition> ::= {SYNC | ID | DATA}
Errors
See Also
• "- 241, Hardware missing" on page 757
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:ID" on page 567
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
577
5
Commands by Subsystem
:TRIGger:M1553 Commands
Table 87 :TRIGger:M1553 Commands Summary
Command
Query
Options and Query Returns
:TRIGger:M1553:AUTose
tup (see page 579)
n/a
n/a
:TRIGger:M1553:PATTer
n:DATA <string> (see
page 580)
:TRIGger:M1553:PATTer
n:DATA? (see
page 580)
<string> ::= "nn...n" where n ::=
{0 | 1 | X}
:TRIGger:M1553:RTA
<value> (see
page 581)
:TRIGger:M1553:RTA?
(see page 581)
<value> ::= 5-bit integer in
decimal, <nondecimal>, or
<string> from 0-31
<nondecimal> ::= #Hnn where n ::=
{0,..,9|A,..,F}
<string> ::= "0xnn" where n::=
{0,..,9|A,..,F}
:TRIGger:M1553:SOURce
:LOWer <source> (see
page 582)
:TRIGger:M1553:SOURce
:LOWer? (see
page 582)
<source> ::= {CHANnel<n>}
<n> ::= {2 | 4}
:TRIGger:M1553:SOURce
:UPPer <source> (see
page 583)
:TRIGger:M1553:SOURce
:UPPer? (see
page 583)
<source> ::= {CHANnel<n>}
<n> ::= {1 | 3}
:TRIGger:M1553:TYPE
<type> (see page 584)
:TRIGger:M1553:TYPE?
(see page 584)
<type> ::= {DSTArt | DSTOp |
CSTArt | CSTOp | RTA | PERRor |
SERRor | MERRor | RTA11}
578
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:M1553:AUTosetup
(see page 798)
Command Syntax
:TRIGger:M1553:AUTosetup
The :TRIGger:M1553:AUTosetup command copies the position, volts/div,
and probe attenuation from the upper threshold channel to the lower
threshold channel, sets the upper/lower trigger levels to +/- 500 mV, turns
on serial decode, and sets the trigger mode to M1553.
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:M1553:SOURce:UPPer" on page 583
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
579
5
Commands by Subsystem
:TRIGger:M1553:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:M1553:PATTern:DATA <string>
<string> ::= "nn...n" where n ::= {0 | 1 | X}
The :TRIGger:M1553:PATTern:DATA command sets the 11 bits to trigger on
if the trigger type has been set to RTA11 (RTA + 11 Bits) using the
:TRIG:M1553:TYPE command.
Query Syntax
:TRIGger:M1553:PATTern:DATA?
The :TRIGger:M1553:PATTern:DATA? query returns the current 11- bit
setting.
Return Format
<string><NL>
<string> ::= "nn...n" where n ::= {0 | 1 | X}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:M1553:TYPE" on page 584
580
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:M1553:RTA
(see page 798)
Command Syntax
:TRIGger:M1553:RTA <value>
<value> ::= 5-bit integer in decimal, <nondecimal>, or
<string> from 0-31
<nondecimal> ::= #Hnn where n ::= {0,..,9|A,..,F}
<string> ::= "0xnn" where n::= {0,..,9|A,..,F}
The :TRIGger:M1553:RTA command sets the Remote Terminal Address
(RTA) to trigger on if the trigger type has been set to RTA using the
:TRIG:M1553:TYPE command.
Query Syntax
:TRIGger:M1553:RTA?
The :TRIGger:M1553:RTA? query returns the current TV trigger line
number setting.
Return Format
See Also
<value><NL> in nondecimal format
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:M1553:TYPE" on page 584
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
581
5
Commands by Subsystem
:TRIGger:M1553:SOURce:LOWer
(see page 798)
Command Syntax
:TRIGger:M1553:SOURce:LOWer <source>
<source> ::= {CHANnel<n>}
<n> ::= {2 | 4}
The :TRIGger:M1553:SOURce:LOWer command controls which signal is used
as the Lower Threshold Channel source by the serial decoder and/or
trigger when in MIL- 1553 mode.
Query Syntax
:TRIGger:M1553:SOURce:LOWer?
The :TRIGger:M1553:SOURce:LOWer? query returns the currently set Lower
Threshold Channel source.
Return Format
<source><NL>
<source> ::= {CHAN<n>}
<n> ::= {2 | 4}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:M1553:SOURce:UPPer" on page 583
582
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:M1553:SOURce:UPPer
(see page 798)
Command Syntax
:TRIGger:M1553:SOURce:UPPer <source>
<source> ::= {CHANnel<n>}
<n> ::= {1 | 3}
The :TRIGger:M1553:SOURce:UPPer command controls which signal is used
as the Upper Threshold Channel source by the serial decoder and/or
trigger when in MIL- 1553 mode.
Query Syntax
:TRIGger:M1553:SOURce:UPPer?
The :TRIGger:M1553:SOURce:UPPer? query returns the currently set Upper
Threshold Channel source.
Return Format
<source><NL>
<source> ::= {CHAN<n>}
<n> ::= {1 | 3}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:M1553:SOURce:LOWer" on page 582
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
583
5
Commands by Subsystem
:TRIGger:M1553:TYPE
(see page 798)
Command Syntax
:TRIGger:M1553:TYPE <type>
<type> ::= {DSTArt | DSTOp | CSTArt | CSTOp | RTA | PERRor | SERRor
| MERRor | RTA11}
The :TRIGger:M1553:TYPE command specifies the type of MIL- STD 1553
trigger to be used:
• DSTArt — (Data Word Start) triggers on the start of a Data word (at the
end of a valid Data Sync pulse).
• DSTOp — (Data Word Stop) triggers on the end of a Data word.
• CSTArt — (Command/Status Word Start) triggers on the start of
Comamnd/Status word (at the end of a valid C/S Sync pulse).
• CSTOp — (Command/Status Word Stop) triggers on the end of a
Command/Status word.
• RTA — (Remote Terminal Address) triggers if the RTA of the
Command/Status word matches the specified value. The value is
specified in hex.
• RTA11 — (RTA + 11 Bits) triggers if the RTA and the remaining 11 bits
match the specified criteria. The RTA can be specifed as a hex value,
and the remaining 11 bits can be specifed as a 1, 0, or X (don't care).
• PERRor — (Parity Error) triggers if the (odd) parity bit is incorrect for
the data in the word.
• MERRor — (Manchester Error) triggers if a Manchester encoding error is
detected.
• SERRor — (Sync Error) triggers if an invalid Sync pulse is found.
Query Syntax
:TRIGger:M1553:TYPE?
The :TRIGger:M1553:TYPE? query returns the currently set MIL- STD 1553
trigger type.
Return Format
<type><NL>
<type> ::= {DSTA | DSTO | CSTA | CSTO | RTA | PERR | SERR
| MERR | RTA11}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:M1553:RTA" on page 581
• ":TRIGger:M1553:PATTern:DATA" on page 580
• ":TRIGger:MODE" on page 485
584
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:SEQuence Commands
Table 88 :TRIGger:SEQuence Commands Summary
Command
Query
Options and Query Returns
:TRIGger:SEQuence:COU
Nt <count> (see
page 586)
:TRIGger:SEQuence:COU
Nt? (see page 586)
<count> ::= integer in NR1 format
:TRIGger:SEQuence:EDG
E{1|2} <source>,
<slope> (see
page 587)
:TRIGger:SEQuence:EDG
E{1|2}? (see
page 587)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<slope> ::= {POSitive | NEGative}
<n> ::= 1-2 or 1-4 in NR1 format
<return_value> ::= query returns
"NONE" if edge source is disabled
:TRIGger:SEQuence:FIN
D <value> (see
page 588)
:TRIGger:SEQuence:FIN
D? (see page 588)
<value> ::= {PATTern1,ENTered |
PATTern1,EXITed | EDGE1 |
PATTern1,AND,EDGE1}
:TRIGger:SEQuence:PAT
Tern{1|2} <value>,
<mask> (see page 589)
:TRIGger:SEQuence:PAT
Tern{1|2}? (see
page 589)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" n ::=
{0,..,9 | A,..,F}
:TRIGger:SEQuence:RES
et <value> (see
page 590)
:TRIGger:SEQuence:RES
et? (see page 590)
<value> ::= {NONE |
PATTern1,ENTered |
PATTern1,EXITed | EDGE1 |
PATTern1,AND,EDGE1 |
PATTern2,ENTered |
PATTern2,EXITed | EDGE2 | TIMer}
Values used in find and trigger
stages not available. EDGE2 not
available if EDGE2,COUNt used in
trigger stage.
:TRIGger:SEQuence:TIM
er <time_value> (see
page 591)
:TRIGger:SEQuence:TIM
er? (see page 591)
<time_value> ::= time from 10 ns
to 10 seconds in NR3 format
:TRIGger:SEQuence:TRI
Gger <value> (see
page 592)
:TRIGger:SEQuence:TRI
Gger? (see page 592)
<value> ::= {PATTern2,ENTered |
PATTern2,EXITed | EDGE2 |
PATTern2,AND,EDGE2 | EDGE2,COUNt
| EDGE2,COUNt,NREFind}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
585
5
Commands by Subsystem
:TRIGger:SEQuence:COUNt
(see page 798)
Command Syntax
:TRIGger:SEQuence:COUNt <count>
<count> ::= integer in NR1 format
The :TRIGger:SEQuence:COUNt command sets the sequencer edge counter
resource. The edge counter is used in the trigger stage to determine the
number of edges that must be found before the sequencer generates a
trigger.
Query Syntax
:TRIGger:SEQuence:COUNt?
The :TRIGger:SEQuence:COUNt? query returns the current sequencer edge
counter setting.
Return Format
<count><NL>
<count> ::= integer in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:SEQuence:EDGE" on page 587
586
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:SEQuence:EDGE
(see page 798)
Command Syntax
:TRIGger:SEQuence:EDGE{1 | 2} <source>, <slope>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<slope> ::= {POSitive | NEGative}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:SEQuence:EDGE<n> command defines the specified sequencer
edge resource according to the specified <source> and <slope>. To disable
an edge resource, set its <source> to NONE. In this case, <slope> has no
meaning.
Query Syntax
:TRIGger:SEQuence:EDGE{1 | 2}?
The :TRIGger:SEQuence:EDGE<n>? query returns the specified sequencer
edge resource setting. If the edge resource is disabled, the returned
<source> value is NONE. In this case, the <slope> is undefined.
Return Format
See Also
<source>, <slope><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:FIND" on page 588
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:SEQuence:RESet" on page 590
• ":TRIGger:SEQuence:COUNt" on page 586
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
587
5
Commands by Subsystem
:TRIGger:SEQuence:FIND
(see page 798)
Command Syntax
:TRIGger:SEQuence:FIND <value>
<value> ::= {PATTern1,ENTered | PATTern1,EXITed | EDGE1
| PATTern1,AND,EDGE1}
The :TRIGger:SEQuence:FIND command specifies the find stage of a
sequence trigger. This command accepts three program data parameters;
you can use NONE to fill out the parameter list (for
example,"EDGE1,NONE,NONE").
PATTern1 is specified with the":TRIGger:SEQuence:PATTern command.
EDGE1 is specified with the :TRIGger:SEQuence:EDGE command.
Query Syntax
:TRIGger:SEQuence:FIND?
The :TRIGger:SEQuence:FIND? query returns the find stage specification
for a sequence trigger. NONE is returned for unused parameters.
Return Format
<find_value><NL>
<find_value> ::= {PATT1,ENT,NONE | PATT1,EXIT,NONE | EDGE1,NONE,NONE
| PATT1,AND,EDGE1}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:PATTern" on page 589
• ":TRIGger:SEQuence:EDGE" on page 587
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:SEQuence:RESet" on page 590
588
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:SEQuence:PATTern
(see page 798)
Command Syntax
:TRIGger:SEQuence:PATTern{1 | 2} <value>,<mask>
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" where n ::= {0,..,9 | A,..,F}
The :TRIGger:SEQuence:PATTern<n> command defines the specified
sequence pattern resource according to the value and the mask. For both
<value> and <mask>, each bit corresponds to a possible trigger channel.
The bit assignments vary by instrument:
Oscilloscope Models
Value and Mask Bit Assignments
4 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 through 19 - analog channels 1
through 4.
2 analog + 16 digital channels (mixed-signal)
Bits 0 through 15 - digital channels 0 through
15. Bits 16 and 17 - analog channels 1 and 2.
4 analog channels only
Bits 0 through 3 - analog channels 1 through 4.
Bit 4 - external trigger.
2 analog channels only
Bits 0 and 1 - analog channels 1 and 2. Bit 4 external trigger.
Set a <value> bit to "0" to set the pattern for the corresponding channel to
low. Set a <value> bit to "1" to set the pattern to high.
Set a <mask> bit to "0" to ignore the data for the corresponding channel.
Only channels with a "1" set on the appropriate mask bit are used.
Query Syntax
:TRIGger:SEQuence:PATTern{1 | 2}?
The :TRIGger:SEQuence:PATTern<n>? query returns the current settings of
the specified pattern resource.
Return Format
See Also
<value>, <mask><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:FIND" on page 588
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:SEQuence:RESet" on page 590
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
589
5
Commands by Subsystem
:TRIGger:SEQuence:RESet
(see page 798)
Command Syntax
:TRIGger:SEQuence:RESet <value>
<value> ::= {NONE | PATTern1,ENTered | PATTern1,EXITed | EDGE1
| PATTern1,AND,EDGE1 | PATTern2,ENTered | PATTern2,EXITed
| EDGE2 | TIMer}
Values used in find and trigger stages are not available.
not available if EDGE2,COUNt is used in trigger stage.
EDGE2 is
The :TRIGger:SEQuence:RESet command specifies the reset stage of a
sequence trigger. In multi- level trigger specifications, you may find a
pattern, then search for another in sequence, but reset the entire search to
the beginning if another condition occurs. This command accepts three
program data parameters; you can use NONE to fill out the parameter list
(for example, "EDGE1,NONE,NONE").
PATTern1 and PATTern2 are specified with the
:TRIGger:SEQuence:PATTern command. EDGE1 and EDGE2 are specified
with the :TRIGger:SEQuence:EDGE command. TIMer is specified with the
:TRIGger:SEQuence:TIMer command.
Query Syntax
:TRIGger:SEQuence:RESet?
The :TRIGger:SEQuence:RESet? query returns the reset stage specification
for a sequence trigger. NONE is returned for unused parameters.
Return Format
<reset_value><NL>
<reset_value> ::= {NONE,NONE,NONE | PATT1,ENT,NONE | PATT1,EXIT,NONE
| EDGE1,NONE,NONE | PATT1,AND,EDGE1 | PATT2,ENT,NONE
| PATT2,EXIT,NONE | EDGE2,NONE,NONE | TIM,NONE,NONE}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:PATTern" on page 589
• ":TRIGger:SEQuence:EDGE" on page 587
• ":TRIGger:SEQuence:TIMer" on page 591
• ":TRIGger:SEQuence:FIND" on page 588
• ":TRIGger:SEQuence:TRIGger" on page 592
590
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SEQuence:TIMer
(see page 798)
Command Syntax
:TRIGger:SEQuence:TIMer <time_value>
<time_value> ::= time in seconds in NR1 format
The :TRIGger:SEQuence:TIMer command sets the sequencer timer resource
in seconds from 10 ns to 10 s. The timer is used in the reset stage to
determine how long to wait for the trigger to occur before restarting.
Query Syntax
:TRIGger:SEQuence:TIMer?
The :TRIGger:SEQuence:TIMer? query returns current sequencer timer
setting.
Return Format
<time value><NL>
<time_value> ::= time in seconds in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:RESet" on page 590
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
591
5
Commands by Subsystem
:TRIGger:SEQuence:TRIGger
(see page 798)
Command Syntax
:TRIGger:SEQuence:TRIGger <value>
<value> ::={PATTern2,ENTered | PATTern2,EXITed | EDGE2
| PATTern2,AND,EDGE2 | EDGE2,COUNt | EDGE2,COUNt,NREFind}
The :TRIGger:SEQuence:TRIGger command specifies the trigger stage of a
sequence trigger. The sequence commands set various search terms. After
all of these are found in sequence, the trigger condition itself is searched
for. This command accepts three program data parameters; you can use
NONE to fill out the parameter list (for example, "EDGE2,NONE,NONE").
PATTern2 is specified with the :TRIGger:SEQuence:PATTern command.
EDGE2 is specified with the :TRIGger:SEQuence:EDGE command. COUNt is
specified with the :TRIGger:SEQuence:COUNt command.
Query Syntax
:TRIGger:SEQuence:TRIGger?
The :TRIGger:SEQuence:TRIGger? query returns the trigger stage
specification for a sequence trigger. NONE is returned for unused
parameters.
Return Format
<trigger_value><NL>
<trigger_value> ::= {PATT2,ENT,NONE | PATT2,EXIT,NONE
| EDGE2,NONE,NONE | PATT2,AND,EDGE2
| EDGE2,COUN,NONE | EDGE2,COUN,NREF}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SEQuence:PATTern" on page 589
• ":TRIGger:SEQuence:EDGE" on page 587
• ":TRIGger:SEQuence:COUNt" on page 586
• ":TRIGger:SEQuence:FIND" on page 588
• ":TRIGger:SEQuence:RESet" on page 590
• ":TRIGger:SEQuence:RESet" on page 590
592
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:SPI Commands
Table 89 :TRIGger:SPI Commands Summary
Command
Query
Options and Query Returns
:TRIGger:SPI:CLOCk:SL
OPe <slope> (see
page 594)
:TRIGger:SPI:CLOCk:SL
OPe? (see page 594)
<slope> ::= {NEGative | POSitive}
:TRIGger:SPI:CLOCk:TI
Meout <time_value>
(see page 595)
:TRIGger:SPI:CLOCk:TI
Meout? (see page 595)
<time_value> ::= time in seconds
in NR1 format
:TRIGger:SPI:FRAMing
<value> (see
page 596)
:TRIGger:SPI:FRAMing?
(see page 596)
<value> ::= {CHIPselect |
NOTChipselect | TIMeout}
:TRIGger:SPI:PATTern:
DATA <value>, <mask>
(see page 597)
:TRIGger:SPI:PATTern:
DATA? (see page 597)
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" where n
::= {0,..,9 | A,..,F}
:TRIGger:SPI:PATTern:
WIDTh <width> (see
page 598)
:TRIGger:SPI:PATTern:
WIDTh? (see page 598)
<width> ::= integer from 4 to 32
in NR1 format
:TRIGger:SPI:SOURce:C
LOCk <source> (see
page 599)
:TRIGger:SPI:SOURce:C
LOCk? (see page 599)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SPI:SOURce:D
ATA <source> (see
page 600)
:TRIGger:SPI:SOURce:D
ATA? (see page 600)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:SPI:SOURce:F
RAMe <source> (see
page 601)
:TRIGger:SPI:SOURce:F
RAMe? (see page 601)
<value> ::= {CHANnel<n> |
EXTernal} for the DSO models
<value> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
593
5
Commands by Subsystem
:TRIGger:SPI:CLOCk:SLOPe
(see page 798)
Command Syntax
:TRIGger:SPI:CLOCk:SLOPe <slope>
<slope> ::= {NEGative | POSitive}
The :TRIGger:SPI:CLOCk:SLOPe command specifies the rising edge
(POSitive) or falling edge (NEGative) of the SPI clock source that will
clock in the data.
Query Syntax
:TRIGger:SPI:CLOCk:SLOPe?
The :TRIGger:SPI:CLOCk:SLOPe? query returns the current SPI clock
source slope.
Return Format
<slope><NL>
<slope> ::= {NEG | POS}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
594
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SPI:CLOCk:TIMeout
(see page 798)
Command Syntax
:TRIGger:SPI:CLOCk:TIMeout <time_value>
<time_value> ::= time in seconds in NR1 format
The :TRIGger:SPI:CLOCk:TIMeout command sets the SPI signal clock
timeout resource in seconds from 500 ns to 10 s when the
:TRIGger:SPI:FRAMing command is set to TIMeout. The timer is used to
frame a signal by a clock timeout.
Query Syntax
:TRIGger:SPI:CLOCk:TIMeout?
The :TRIGger:SPI:CLOCk:TIMeout? query returns current SPI clock timeout
setting.
Return Format
<time value><NL>
<time_value> ::= time in seconds in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:CLOCk:SLOPe" on page 594
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• ":TRIGger:SPI:FRAMing" on page 596
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
595
5
Commands by Subsystem
:TRIGger:SPI:FRAMing
(see page 798)
Command Syntax
:TRIGger:SPI:FRAMing <value>
<value> ::= {CHIPselect | NOTChipselect | TIMeout}
The :TRIGger:SPI:FRAMing command sets the SPI trigger framing value. If
TIMeout is selected, the timeout value is set by the
:TRIGger:SPI:CLOCk:TIMeout command.
Query Syntax
:TRIGger:SPI:FRAMing?
The :TRIGger:SPI:FRAMing? query returns the current SPI framing value.
Return Format
<value><NL>
<value> ::= {CHIPselect | NOTChipselect | TIMeout}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
596
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SPI:PATTern:DATA
(see page 798)
Command Syntax
:TRIGger:SPI:PATTern:DATA <value>,<mask>
<value> ::= integer or <string>
<mask> ::= integer or <string>
<string> ::= "0xnnnnnn" where n ::= {0,..,9 | A,..,F}
The :TRIGger:SPI:PATTern:DATA command defines the SPI data pattern
resource according to the value and the mask. This pattern, along with the
data width, control the data pattern searched for in the data stream.
Set a <value> bit to "0" to set the corresponding bit in the data pattern to
low. Set a <value> bit to "1" to set the bit to high.
Set a <mask> bit to "0" to ignore that bit in the data stream. Only bits
with a "1" set on the mask are used.
Query Syntax
:TRIGger:SPI:PATTern:DATA?
The :TRIGger:SPI:PATTern:DATA? query returns the current settings of the
specified SPI data pattern resource.
Return Format
See Also
<value>, <mask><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:PATTern:WIDTh" on page 598
• ":TRIGger:SPI:SOURce:DATA" on page 600
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
597
5
Commands by Subsystem
:TRIGger:SPI:PATTern:WIDTh
(see page 798)
Command Syntax
:TRIGger:SPI:PATTern:WIDTh <width>
<width> ::= integer from 4 to 32 in NR1 format
The :TRIGger:SPI:PATTern:WIDTh command sets the width of the SPI data
pattern anywhere from 4 bits to 32 bits.
Query Syntax
:TRIGger:SPI:PATTern:WIDTh?
The :TRIGger:SPI:PATTern:WIDTh? query returns the current SPI data
pattern width setting.
Return Format
<width><NL>
<width> ::= integer from 4 to 32 in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:PATTern:DATA" on page 597
• ":TRIGger:SPI:SOURce:DATA" on page 600
598
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SPI:SOURce:CLOCk
(see page 798)
Command Syntax
:TRIGger:SPI:SOURce:CLOCk <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:SPI:SOURce:CLOCk command sets the source for the SPI
serial clock.
Query Syntax
:TRIGger:SPI:SOURce:CLOCk?
The :TRIGger:SPI:SOURce:CLOCk? query returns the current source for the
SPI serial clock.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:CLOCk:SLOPe" on page 594
• ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
• ":TRIGger:SPI:SOURce:DATA" on page 600
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
599
5
Commands by Subsystem
:TRIGger:SPI:SOURce:DATA
(see page 798)
Command Syntax
:TRIGger:SPI:SOURce:DATA <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:SPI:SOURce:DATA command sets the source for the SPI serial
data.
Query Syntax
:TRIGger:SPI:SOURce:DATA?
The :TRIGger:SPI:SOURce:DATA? query returns the current source for the
SPI serial data.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
• ":TRIGger:SPI:PATTern:DATA" on page 597
• ":TRIGger:SPI:PATTern:WIDTh" on page 598
600
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:SPI:SOURce:FRAMe
(see page 798)
Command Syntax
:TRIGger:SPI:SOURce:FRAMe <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:SPI:SOURce:FRAMe command sets the frame source when
:TRIGger:SPI:FRAMing is set to CHIPselect or NOTChipselect.
Query Syntax
:TRIGger:SPI:SOURce:FRAMe?
The :TRIGger:SPI:SOURce:FRAMe? query returns the current frame source
for the SPI serial frame.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• ":TRIGger:SPI:SOURce:DATA" on page 600
• ":TRIGger:SPI:FRAMing" on page 596
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
601
5
Commands by Subsystem
:TRIGger:TV Commands
Table 90 :TRIGger:TV Commands Summary
Command
Query
Options and Query Returns
:TRIGger:TV:LINE
<line number> (see
page 603)
:TRIGger:TV:LINE?
(see page 603)
<line number> ::= integer in NR1
format
:TRIGger:TV:MODE <tv
mode> (see page 604)
:TRIGger:TV:MODE?
(see page 604)
<tv mode> ::= {FIEld1 | FIEld2 |
AFIelds | ALINes | LINE |
VERTical | LFIeld1 | LFIeld2 |
LALTernate | LVERtical}
:TRIGger:TV:POLarity
<polarity> (see
page 605)
:TRIGger:TV:POLarity?
(see page 605)
<polarity> ::= {POSitive |
NEGative}
:TRIGger:TV:SOURce
<source> (see
page 606)
:TRIGger:TV:SOURce?
(see page 606)
<source> ::= {CHANnel<n>}
<n> ::= 1-2 or 1-4 integer in NR1
format
:TRIGger:TV:STANdard
<standard> (see
page 607)
:TRIGger:TV:STANdard?
(see page 607)
<standard> ::= {GENeric | NTSC |
PALM | PAL | SECam | {P480L60HZ |
P480} | {P720L60HZ | P720} |
{P1080L24HZ | P1080} | P1080L25HZ
| P1080L50HZ | P1080L60HZ |
{I1080L50HZ | I1080} |
I1080L60HZ}
602
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:TV:LINE
(see page 798)
Command Syntax
:TRIGger:TV:LINE <line_number>
<line_number> ::= integer in NR1 format
The :TRIGger:TV:LINE command allows triggering on a specific line of
video. The line number limits vary with the standard and mode, as shown
in the following table.
Table 91 TV Trigger Line Number Limits
TV Standard
Mode
LINE
Query Syntax
LFIeld1
LFIeld2
LALTernate
NTSC
1 to 263
1 to 262
1 to 262
PAL
1 to 313
314 to 625
1 to 312
PAL-M
1 to 263
264 to 525
1 to 262
SECAM
1 to 313
314 to 625
1 to 312
GENERIC
1 to 1024
1 to 1024
P480L60HZ
1 to 525
P720L60HZ
1 to 750
P1080L24HZ
1 to 1125
P1080L25HZ
1 to 1125
P1080L50HZ
1 to 1125
P1080L60HZ
1 to 1125
I1080L50HZ
1 to 1125
I1080L60HZ
1 to 1125
VERTical
1 to 1024
:TRIGger:TV:LINE?
The :TRIGger:TV:LINE? query returns the current TV trigger line number
setting.
Return Format
<line_number><NL>
<line_number>::= integer in NR1 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:TV:STANdard" on page 607
• ":TRIGger:TV:MODE" on page 604
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
603
5
Commands by Subsystem
:TRIGger:TV:MODE
(see page 798)
Command Syntax
:TRIGger:TV:MODE <mode>
<mode> ::= {FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical
| LFIeld1 | LFIeld2 | LALTernate | LVERtical}
The :TRIGger:TV:MODE command selects the TV trigger mode and field.
The LVERtical parameter is only available when :TRIGger:TV:STANdard is
GENeric. The LALTernate parameter is not available when
:TRIGger:TV:STANdard is GENeric.
Old forms for <mode> are accepted:
Query Syntax
<mode>
Old Forms Accepted
FIEld1
F1
FIEld2
F2
AFIelds
ALLFields, ALLFLDS
ALINes
ALLLines
LFIeld1
LINEF1, LINEFIELD1
LFIeld2
LINEF2, LINEFIELD2
LALTernate
LINEAlt
LVERtical
LINEVert
:TRIGger:TV:MODE?
The :TRIGger:TV:MODE? query returns the TV trigger mode.
Return Format
<value><NL>
<value> ::= {FIE1 | FIE2 | AFI | ALIN | LINE | VERT | LFI1 | LFI2
| LALT | LVER}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:TV:STANdard" on page 607
• ":TRIGger:MODE" on page 485
604
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:TV:POLarity
(see page 798)
Command Syntax
:TRIGger:TV:POLarity <polarity>
<polarity> ::= {POSitive | NEGative}
The :TRIGger:TV:POLarity command sets the polarity for the TV trigger.
Query Syntax
:TRIGger:TV:POLarity?
The :TRIGger:TV:POLarity? query returns the TV trigger polarity.
Return Format
<polarity><NL>
<polarity> ::= {POS | NEG}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:TV:SOURce" on page 606
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
605
5
Commands by Subsystem
:TRIGger:TV:SOURce
(see page 798)
Command Syntax
:TRIGger:TV:SOURce <source>
<source> ::= {CHANnel<n>}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:TV:SOURce command selects the channel used to produce the
trigger.
Query Syntax
:TRIGger:TV:SOURce?
The :TRIGger:TV:SOURce? query returns the current TV trigger source.
Return Format
<source><NL>
<source> ::= {CHAN<n>}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:TV:POLarity" on page 605
Example Code
606
• "Example Code" on page 516
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:TV:STANdard
(see page 798)
Command Syntax
:TRIGger:TV:STANdard <standard>
<standard> ::= {GENeric | NTSC | PALM | PAL | SECam
| {P480L60HZ | P480} | {P720L60HZ | P720}
| {P1080L24HZ | P1080} | P1080L25HZ
| P1080L50HZ | P1080L60HZ
| {I1080L50HZ | I1080} | I1080L60HZ}
The :TRIGger:TV:STANdard command selects the video standard. GENeric
mode is non- interlaced.
Query Syntax
:TRIGger:TV:STANdard?
The :TRIGger:TV:STANdard? query returns the current TV trigger standard
setting.
Return Format
<standard><NL>
<standard> ::= {GEN | NTSC | PALM | PAL | SEC | P480L60HZ | P760L60HZ
| P1080L24HZ | P1080L25HZ | P1080L50HZ | P1080L60HZ
| I1080L50HZ | I1080L60HZ}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
607
5
Commands by Subsystem
:TRIGger:UART Commands
Table 92 :TRIGger:UART Commands Summary
Command
Query
Options and Query Returns
:TRIGger:UART:BASE
<base> (see page 610)
:TRIGger:UART:BASE?
(see page 610)
<base> ::= {ASCii | HEX}
:TRIGger:UART:BAUDrat
e <baudrate> (see
page 611)
:TRIGger:UART:BAUDrat
e? (see page 611)
<baudrate> ::= integer from 1200
to 3000000 in 100 b/s increments
:TRIGger:UART:BITorde
r <bitorder> (see
page 612)
:TRIGger:UART:BITorde
r? (see page 612)
<bitorder> ::= {LSBFirst |
MSBFirst}
:TRIGger:UART:BURSt
<value> (see
page 613)
:TRIGger:UART:BURSt?
(see page 613)
<value> ::= {OFF | 1 to 4096 in
NR1 format}
:TRIGger:UART:DATA
<value> (see
page 614)
:TRIGger:UART:DATA?
(see page 614)
<value> ::= 8-bit integer from
0-255 (0x00-0xff) in decimal,
<hexadecimal>, <binary>, or
<quoted_string> format
<hexadecimal> ::= #Hnn where n
::= {0,..,9 | A,..,F} for
hexadecimal
<binary> ::= #Bnn...n where n ::=
{0 | 1} for binary
<quoted_string> ::= any of the
128 valid 7-bit ASCII characters
(or standard abbreviations)
:TRIGger:UART:IDLE
<time_value> (see
page 615)
:TRIGger:UART:IDLE?
(see page 615)
<time_value> ::= time from 1 us
to 10 s in NR3 format
:TRIGger:UART:PARity
<parity> (see
page 616)
:TRIGger:UART:PARity?
(see page 616)
<parity> ::= {EVEN | ODD | NONE}
:TRIGger:UART:POLarit
y <polarity> (see
page 617)
:TRIGger:UART:POLarit
y? (see page 617)
<polarity> ::= {HIGH | LOW}
:TRIGger:UART:QUALifi
er <value> (see
page 618)
:TRIGger:UART:QUALifi
er? (see page 618)
<value> ::= {EQUal | NOTequal |
GREaterthan | LESSthan}
608
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 92 :TRIGger:UART Commands Summary (continued)
Command
Query
Options and Query Returns
:TRIGger:UART:SOURce:
RX <source> (see
page 619)
:TRIGger:UART:SOURce:
RX? (see page 619)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:UART:SOURce:
TX <source> (see
page 620)
:TRIGger:UART:SOURce:
TX? (see page 620)
<source> ::= {CHANnel<n> |
EXTernal} for DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for MSO
models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:UART:TYPE
<value> (see
page 621)
:TRIGger:UART:TYPE?
(see page 621)
<value> ::=
RDATa | RD1
PARityerror
TDATa | TD1
:TRIGger:UART:WIDTh
<width> (see
page 622)
:TRIGger:UART:WIDTh?
(see page 622)
<width> ::= {5 | 6 | 7 | 8 | 9}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
{RSTArt | RSTOp |
| RD0 | RDX |
| TSTArt | TSTOp |
| TD0 | TDX}
609
5
Commands by Subsystem
:TRIGger:UART:BASE
(see page 798)
Command Syntax
:TRIGger:UART:BASE <base>
<base> ::= {ASCii | HEX}
The :TRIGger:UART:BASE command sets the front panel UART/RS232
trigger setup data selection option:
• ASCii — front panel data selection is from ASCII values.
• HEX — front panel data selection is from hexadecimal values.
The :TRIGger:UART:BASE setting does not affect the :TRIGger:UART:DATA
command which can always set data values using ASCII or hexadecimal
values.
NOTE
Query Syntax
The :TRIGger:UART:BASE command is independent of the :SBUS:UART:BASE command
which affects decode only.
:TRIGger:UART:BASE?
The :TRIGger:UART:BASE? query returns the current UART base setting.
Return Format
<base><NL>
<base> ::= {ASC | HEX}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:DATA" on page 614
610
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:UART:BAUDrate
(see page 798)
Command Syntax
:TRIGger:UART:BAUDrate <baudrate>
<baudrate> ::= integer from 1200 to 3000000 in 100 b/s increments
The :TRIGger:UART:BAUDrate command selects the bit rate (in bps) for the
serial decoder and/or trigger when in UART mode. The baud rate can be
set from 1200 b/s to 3 Mb/s in 100 b/s increments. If you enter a baud
rate that is not divisible by 100 b/s, the baud rate is set to the nearest
baud rate divisible by 100 b/s.
If the baud rate you select does not match the system baud rate, false
triggers may occur.
Query Syntax
:TRIGger:UART:BAUDrate?
The :TRIGger:UART:BAUDrate? query returns the current UART baud rate
setting.
Return Format
<baudrate><NL>
<baudrate> ::= integer from 1200 to 3000000 in 100 b/s increments
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
611
5
Commands by Subsystem
:TRIGger:UART:BITorder
(see page 798)
Command Syntax
:TRIGger:UART:BITorder <bitorder>
<bitorder> ::= {LSBFirst | MSBFirst}
The :TRIGger:UART:BITorder command specifies the order of transmission
used by the physical Tx and Rx input signals for the serial decoder and/or
trigger when in UART mode. LSBFirst sets the least significant bit of each
message "byte" as transmitted first. MSBFirst sets the most significant bit
as transmitted first.
Query Syntax
:TRIGger:UART:BITorder?
The :TRIGger:UART:BITorder? query returns the current UART bit order
setting.
Return Format
<bitorder><NL>
<bitorder> ::= {LSBF | MSBF}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
• ":TRIGger:UART:SOURce:RX" on page 619
• ":TRIGger:UART:SOURce:TX" on page 620
612
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:UART:BURSt
(see page 798)
Command Syntax
:TRIGger:UART:BURSt <value>
<value> ::= {OFF | 1 to 4096 in NR1 format}
The :TRIGger:UART:BURSt command selects the burst value (Nth frame
after idle period) in the range 1 to 4096 or OFF, for the trigger when in
UART mode.
Query Syntax
:TRIGger:UART:BURSt?
The :TRIGger:UART:BURSt? query returns the current UART trigger burst
value.
Return Format
<value><NL>
<value> ::= {OFF | 1 to 4096 in NR1 format}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:IDLE" on page 615
• ":TRIGger:UART:TYPE" on page 621
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
613
5
Commands by Subsystem
:TRIGger:UART:DATA
(see page 798)
Command Syntax
:TRIGger:UART:DATA <value>
<value> ::= 8-bit integer from 0-255 (0x00-0xff) in decimal,
<hexadecimal>, <binary>, or <quoted_string> format
<hexadecimal> ::= #Hnn where n ::= {0,..,9 | A,..,F} for hexadecimal
<binary> ::= #Bnn...n where n ::= {0 | 1} for binary
<quoted_string> ::= any of the 128 valid 7-bit ASCII characters
(or standard abbreviations)
The :TRIGger:UART:DATA command selects the data byte value (0x00 to
0xFF) for the trigger QUALifier when in UART mode. The data value is
used when one of the RD or TD trigger types is selected.
When entering an ASCII character via the quoted string, it must be one of
the 128 valid characters (case- sensitive): "NUL", "SOH", "STX", "ETX",
"EOT", "ENQ", "ACK", "BEL", "BS", "HT", "LF", "VT", "FF", "CR", "SO","SI",
"DLE", "DC1", "DC2", "DC3", "DC4", "NAK", "SYN", "ETB", "CAN", "EM", "SUB",
"ESC", "FS","GS", "RS", "US", "SP", "!", "\"", "#", "$", "%","&", "\'", "(", ")", "*", "+",
",", "- ", ".", "/","0", "1", "2", "3", "4", "5", "6", "7", "8", "9",":", ";", "<", "=", ">", "?",
"@", "A", "B", "C","D", "E", "F", "G", "H", "I", "J", "K", "L", "M","N", "O", "P", "Q",
"R", "S", "T", "U", "V", "W", "X", "Y", "Z","[", "\\", "]", "^", "_", "`", "a", "b", "c",
"d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v",
"w", "x", "y", "z", "{", "|", "}", "~", or "DEL".
Query Syntax
:TRIGger:UART:DATA?
The :TRIGger:UART:DATA? query returns the current UART trigger data
value.
Return Format
<value><NL>
<value> ::= 8-bit integer in decimal from 0-255
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:BASE" on page 610
• ":TRIGger:UART:TYPE" on page 621
614
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:UART:IDLE
(see page 798)
Command Syntax
:TRIGger:UART:IDLE <time_value>
<time_value> ::= time from 1 us to 10 s in NR3 format
The :TRIGger:UART:IDLE command selects the value of the idle period for
burst trigger in the range from 1 us to 10 s when in UART mode.
Query Syntax
:TRIGger:UART:IDLE?
The :TRIGger:UART:IDLE? query returns the current UART trigger idle
period time.
Return Format
<time_value><NL>
<time_value> ::= time from 1 us to 10 s in NR3 format
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:BURSt" on page 613
• ":TRIGger:UART:TYPE" on page 621
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
615
5
Commands by Subsystem
:TRIGger:UART:PARity
(see page 798)
Command Syntax
:TRIGger:UART:PARity <parity>
<parity> ::= {EVEN | ODD | NONE}
The :TRIGger:UART:PARity command selects the parity to be used with
each message "byte" for the serial decoder and/or trigger when in UART
mode.
Query Syntax
:TRIGger:UART:PARity?
The :TRIGger:UART:PARity? query returns the current UART parity setting.
Return Format
<parity><NL>
<parity> ::= {EVEN | ODD | NONE}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
616
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:UART:POLarity
(see page 798)
Command Syntax
:TRIGger:UART:POLarity <polarity>
<polarity> ::= {HIGH | LOW}
The :TRIGger:UART:POLarity command selects the polarity as idle low or
idle high for the serial decoder and/or trigger when in UART mode.
Query Syntax
:TRIGger:UART:POLarity?
The :TRIGger:UART:POLarity? query returns the current UART polarity
setting.
Return Format
<polarity><NL>
<polarity> ::= {HIGH | LOW}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
617
5
Commands by Subsystem
:TRIGger:UART:QUALifier
(see page 798)
Command Syntax
:TRIGger:UART:QUALifier <value>
<value> ::= {EQUal | NOTequal | GREaterthan | LESSthan}
The :TRIGger:UART:QUALifier command selects the data qualifier when
:TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX for the
trigger when in UART mode.
Query Syntax
:TRIGger:UART:QUALifier?
The :TRIGger:UART:QUALifier? query returns the current UART trigger
qualifier.
Return Format
<value><NL>
<value> ::= {EQU | NOT | GRE | LESS}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
618
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:UART:SOURce:RX
(see page 798)
Command Syntax
:TRIGger:UART:SOURce:RX <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:UART:SOURce:RX command controls which signal is used as
the Rx source by the serial decoder and/or trigger when in UART mode.
Query Syntax
:TRIGger:UART:SOURce:RX?
The :TRIGger:UART:SOURce:RX? query returns the current source for the
UART Rx signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
• ":TRIGger:UART:BITorder" on page 612
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
619
5
Commands by Subsystem
:TRIGger:UART:SOURce:TX
(see page 798)
Command Syntax
:TRIGger:UART:SOURce:TX <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:UART:SOURce:TX command controls which signal is used as
the Tx source by the serial decoder and/or trigger when in UART mode.
Query Syntax
:TRIGger:UART:SOURce:TX?
The :TRIGger:UART:SOURce:TX? query returns the current source for the
UART Tx signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
• ":TRIGger:UART:BITorder" on page 612
620
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:UART:TYPE
(see page 798)
Command Syntax
:TRIGger:UART:TYPE <value>
<value> ::= {RSTArt | RSTOp | RDATa | RD1 | RD0 | RDX | PARityerror
| TSTArt | TSTOp | TDATa | TD1 | TD0 | TDX}
The :TRIGger:UART:TYPE command selects the UART trigger type.
When one of the RD or TD types is selected, the :TRIGger:UART:DATA and
:TRIGger:UART:QUALifier commands are used to specify the data value
and comparison operator.
The RD1, RD0, RDX, TD1, TD0, and TDX types (for triggering on data and
alert bit values) are only valid when a 9- bit width has been selected.
Query Syntax
:TRIGger:UART:TYPE?
The :TRIGger:UART:TYPE? query returns the current UART trigger data
value.
Return Format
<value><NL>
<value> ::= {RSTA | RSTO | RDAT | RD1 | RD0 | RDX | PAR | TSTA |
TSTO | TDAT | TD1 | TD0 | TDX}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:DATA" on page 614
• ":TRIGger:UART:QUALifier" on page 618
• ":TRIGger:UART:WIDTh" on page 622
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
621
5
Commands by Subsystem
:TRIGger:UART:WIDTh
(see page 798)
Command Syntax
:TRIGger:UART:WIDTh <width>
<width> ::= {5 | 6 | 7 | 8 | 9}
The :TRIGger:UART:WIDTh command determines the number of bits (5- 9)
for each message "byte" for the serial decoder and/or trigger when in
UART mode.
Query Syntax
:TRIGger:UART:WIDTh?
The :TRIGger:UART:WIDTh? query returns the current UART width setting.
Return Format
<width><NL>
<width> ::= {5 | 6 | 7 | 8 | 9}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:UART:TYPE" on page 621
622
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:USB Commands
Table 93 :TRIGger:USB Commands Summary
Command
Query
Options and Query Returns
:TRIGger:USB:SOURce:D
MINus <source> (see
page 624)
:TRIGger:USB:SOURce:D
MINus? (see page 624)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:USB:SOURce:D
PLus <source> (see
page 625)
:TRIGger:USB:SOURce:D
PLus? (see page 625)
<source> ::= {CHANnel<n> |
EXTernal} for the DSO models
<source> ::= {CHANnel<n> |
DIGital0,..,DIGital15} for the
MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:TRIGger:USB:SPEed
<value> (see
page 626)
:TRIGger:USB:SPEed?
(see page 626)
<value> ::= {LOW | FULL}
:TRIGger:USB:TRIGger
<value> (see
page 627)
:TRIGger:USB:TRIGger?
(see page 627)
<value> ::= {SOP | EOP |
ENTersuspend | EXITsuspend |
RESet}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
623
5
Commands by Subsystem
:TRIGger:USB:SOURce:DMINus
(see page 798)
Command Syntax
:TRIGger:USB:SOURce:DMINus <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:USB:SOURce:DMINus command sets the source for the USB
D- signal.
Query Syntax
:TRIGger:USB:SOURce:DMINus?
The :TRIGger:USB:SOURce:DMINus? query returns the current source for
the USB D- signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:USB:SOURce:DPLus" on page 625
• ":TRIGger:USB:TRIGger" on page 627
624
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:TRIGger:USB:SOURce:DPLus
(see page 798)
Command Syntax
:TRIGger:USB:SOURce:DPLus <source>
<source> ::= {CHANnel<n> | EXTernal} for the DSO models
<source> ::= {CHANnel<n> | DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :TRIGger:USB:SOURce:DPLus command sets the source for the USB D+
signal.
Query Syntax
:TRIGger:USB:SOURce:DPLus?
The :TRIGger:USB:SOURce:DPLus? query returns the current source for the
USB D+ signal.
Return Format
See Also
<source><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:USB:SOURce:DMINus" on page 624
• ":TRIGger:USB:TRIGger" on page 627
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
625
5
Commands by Subsystem
:TRIGger:USB:SPEed
(see page 798)
Command Syntax
:TRIGger:USB:SPEed <value>
<value> ::= {LOW | FULL}
The :TRIGger:USB:SPEed command sets the expected USB signal speed to
be Low Speed (1.5 Mb/s) or Full Speed (12 Mb/s).
Query Syntax
:TRIGger:USB:SPEed?
The :TRIGger:USB:SPEed? query returns the current speed value for the
USB signal.
Return Format
See Also
<value><NL>
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:USB:SOURce:DMINus" on page 624
• ":TRIGger:USB:SOURce:DPLus" on page 625
• ":TRIGger:USB:TRIGger" on page 627
626
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:TRIGger:USB:TRIGger
(see page 798)
Command Syntax
:TRIGger:USB:TRIGger <value>
<value> ::= {SOP | EOP | ENTersuspend | EXITsuspend | RESet}
The :TRIGger:USB:TRIGger command sets where the USB trigger will occur:
• SOP — Start of packet.
• EOP — End of packet.
• ENTersuspend — Enter suspend state.
• EXITsuspend — Exit suspend state.
• RESet — Reset complete.
Query Syntax
:TRIGger:USB:TRIGger?
The :TRIGger:USB:TRIGger? query returns the current USB trigger value.
Return Format
<value><NL>
<value> ::= {SOP | EOP | ENTersuspend | EXITsuspend | RESet}
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:USB:SPEed" on page 626
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
627
5
Commands by Subsystem
:WAVeform Commands
Provide access to waveform data. See "Introduction to :WAVeform
Commands" on page 630.
Table 94 :WAVeform Commands Summary
Command
Query
Options and Query Returns
:WAVeform:BYTeorder
<value> (see
page 636)
:WAVeform:BYTeorder?
(see page 636)
<value> ::= {LSBFirst | MSBFirst}
n/a
:WAVeform:COUNt? (see
page 637)
<count> ::= an integer from 1 to
65536 in NR1 format
n/a
:WAVeform:DATA? (see
page 638)
<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
:WAVeform:FORMat
<value> (see
page 640)
:WAVeform:FORMat?
(see page 640)
<value> ::= {WORD | BYTE | ASCII}
:WAVeform:POINts
<# points> (see
page 641)
:WAVeform:POINts?
(see page 641)
<# 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}
:WAVeform:POINts:MODE
<points_mode> (see
page 643)
:WAVeform:POINts:MODE
? (see page 644)
<points_mode> ::= {NORMal |
MAXimum | RAW}
628
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Table 94 :WAVeform Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:WAVeform:PREamble?
(see page 645)
<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
1
2
3
for
for
for
for
NORMal type
PEAK detect type
AVERage type
HRESolution type
<count> ::= Average count, or 1
if PEAK detect type or NORMal; an
integer in NR1 format
n/a
:WAVeform:SEGMented:C
OUNt? (see page 648)
<count> ::= an integer from 2 to
2000 in NR1 format (with Option
SGM)
n/a
:WAVeform:SEGMented:T
TAG? (see page 649)
<time_tag> ::= in NR3 format
(with Option SGM)
:WAVeform:SOURce
<source> (see
page 650)
:WAVeform:SOURce?
(see page 650)
<source> ::= {CHANnel<n> |
FUNCtion | MATH | SBUS} for DSO
models
<source> ::= {CHANnel<n> | POD{1
| 2} | BUS{1 | 2} | FUNCtion |
MATH | SBUS} for MSO models
<n> ::= 1-2 or 1-4 in NR1 format
:WAVeform:SOURce:SUBS
ource <subsource>
(see page 654)
:WAVeform:SOURce:SUBS
ource? (see page 654)
<subsource> ::= {{NONE | RX} |
TX}
n/a
:WAVeform:TYPE? (see
page 655)
<return_mode> ::= {NORM | PEAK |
AVER | HRES}
:WAVeform:UNSigned
{{0 | OFF} | {1 |
ON}} (see page 656)
:WAVeform:UNSigned?
(see page 656)
{0 | 1}
:WAVeform:VIEW <view>
(see page 657)
:WAVeform:VIEW? (see
page 657)
<view> ::= {MAIN}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
629
5
Commands by Subsystem
Table 94 :WAVeform Commands Summary (continued)
Command
Query
Options and Query Returns
n/a
:WAVeform:XINCrement?
(see page 658)
<return_value> ::= x-increment
in the current preamble in NR3
format
n/a
:WAVeform:XORigin?
(see page 659)
<return_value> ::= x-origin
value in the current preamble in
NR3 format
n/a
:WAVeform:XREFerence?
(see page 660)
<return_value> ::= 0
(x-reference value in the current
preamble in NR1 format)
n/a
:WAVeform:YINCrement?
(see page 661)
<return_value> ::= y-increment
value in the current preamble in
NR3 format
n/a
:WAVeform:YORigin?
(see page 662)
<return_value> ::= y-origin in
the current preamble in NR3
format
n/a
:WAVeform:YREFerence?
(see page 663)
<return_value> ::= y-reference
value in the current preamble in
NR1 format
Introduction to
:WAVeform
Commands
The WAVeform subsystem is used to transfer data to a controller from the
oscilloscope waveform memories. The queries in this subsystem will only
operate when the channel selected by :WAVeform:SOURce is on.
Waveform Data and Preamble
The waveform record is actually contained in two portions: the preamble
and waveform data. The waveform record must be read from the
oscilloscope by the controller using two separate commands,
:WAVeform:DATA (see page 638) and :WAVeform:PREamble (see page 645).
The waveform data is the actual data acquired for each point in the
specified source. The preamble contains the information for interpreting
the waveform data, which includes the number of points acquired, the
format of acquired data, and the type of acquired data. The preamble also
contains the X and Y increments, origins, and references for the acquired
data, so that word and byte data can be translated to time and voltage
values.
Data Acquisition Types
There are four types of waveform acquisitions that can be selected for
analog channels with the :ACQuire:TYPE command (see page 208):
NORMal, AVERage, PEAK, and HRESolution. Digital channels are always
630
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
acquired using NORMal. When the data is acquired using the :DIGitize
command (see page 162) or :RUN command (see page 186), the data is
placed in the channel buffer of the specified source.
Once you have acquired data with the :DIGitize command, the instrument
is stopped. If the instrument is restarted (via the programming interface
or the front panel), or if any instrument setting is changed, the data
acquired with the :DIGitize command may be overwritten.You should first
acquire the data with the :DIGitize command, then immediately read the
data with the :WAVeform:DATA? query (see page 638) before changing any
instrument setup.
A waveform record consists of either all of the acquired points or a subset
of the acquired points. The number of points acquired may be queried
using :ACQuire:POINts? (see page 200).
Helpful Hints:
The number of points transferred to the computer is controlled using the
:WAVeform:POINts command (see page 641). If :WAVeform:POINts
MAXimum is specified and the instrument is not running (stopped), all of
the points that are displayed are transferred. This can be as many as
4,000,000 in some operating modes or as many as 8,000,000 for a digital
channel on the mixed signal oscilloscope. Fewer points may be specified to
speed data transfers and minimize controller analysis time. The
:WAVeform:POINts may be varied even after data on a channel is acquired.
However, this decimation may result in lost pulses and transitions. The
number of points selected for transfer using :WAVeform:POINts must be an
even divisor of 1,000 or be set to MAXimum. :WAVeform:POINts determines
the increment between time buckets that will be transferred. If POINts =
MAXimum, the data cannot be decimated. For example:
• :WAVeform:POINts 1000 — returns time buckets 0, 1, 2, 3, 4 ,.., 999.
• :WAVeform:POINts 500 — returns time buckets 0, 2, 4, 6, 8 ,.., 998.
• :WAVeform:POINts 250 — returns time buckets 0, 4, 8, 12, 16 ,.., 996.
• :WAVeform:POINts 100 — returns time buckets 0, 10, 20, 30, 40 ,..,
990.
Analog Channel Data
NORMal Data
Normal data consists of the last data point (hit) in each time bucket. This
data is transmitted over the programming interface in a linear fashion
starting with time bucket 0 and going through time bucket n - 1, where n
is the number returned by the :WAVeform:POINts? query (see page 641).
Only the magnitude values of each data point are transmitted. The first
voltage value corresponds to the first time bucket on the left side of the
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
631
5
Commands by Subsystem
screen and the last value corresponds to the next- to- last time bucket on
the right side of the screen. Time buckets without data return 0. The time
values for each data point correspond to the position of the data point in
the data array. These time values are not transmitted.
AVERage Data
AVERage data consists of the average of the first n hits in a time bucket,
where n is the value returned by the :ACQuire:COUNt query (see
page 197). Time buckets that have fewer than n hits return the average of
the data they do have. If a time bucket does not have any data in it, it
returns 0.
This data is transmitted over the interface linearly, starting with time
bucket 0 and proceeding through time bucket n- 1, where n is the number
returned by the :WAVeform:POINts? query (see page 641). The first value
corresponds to a point at the left side of the screen and the last value
corresponds to one point away from the right side of the screen. The
maximum number of points that can be returned in average mode is 1000
unless ACQuire:COUNt has been set to 1.
PEAK Data
Peak detect display mode is used to detect glitches for time base settings
of 500 us/div and slower. In this mode, the oscilloscope can sample more
data than it can store and display. So, when peak detect is turned on, the
oscilloscope scans through the extra data, picks up the minimum and
maximum for each time bucket, then stores the data in an array. Each
time bucket contains two data sample.
The array is transmitted over the interface bus linearly, starting with time
bucket 0 proceeding through time bucket n- 1, where n is the number
returned by the :WAVeform:POINts? query (see page 641). In each time
bucket, two values are transmitted, first the minimum, followed by the
maximum. The first pair of values corresponds to the time bucket at the
leftmost side of the screen. The last pair of values corresponds to the time
bucket at the far right side of the screen. In :ACQuire:TYPE PEAK mode
(see page 208), the value returned by the :WAVeform:XINCrement query
(see page 658) should be doubled to find the time difference between the
min- max pairs.
HRESolution Data
The high resolution (smoothing) mode is used to reduce noise at slower
sweep speeds where the digitizer samples faster than needed to fill
memory for the displayed time range.
Data Conversion
632
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
Word or byte data sent from the oscilloscope must be scaled for useful
interpretation. The values used to interpret the data are the X and Y
references, X and Y origins, and X and Y increments. These values are
read from the waveform preamble. Each channel has its own waveform
preamble.
In converting a data value to a voltage value, the following formula is
used:
voltage = [(data value - yreference) * yincrement] + yorigin
If the :WAVeform:FORMat data format is ASCii (see page 640), the data
values are converted internally and sent as floating point values separated
by commas.
In converting a data value to time, the time value of a data point can be
determined by the position of the data point. For example, the fourth data
point sent with :WAVeform:XORigin = 16 ns, :WAVeform:XREFerence = 0,
and :WAVeform:XINCrement = 2 ns, can be calculated using the following
formula:
time = [(data point number - xreference) * xincrement] + xorigin
This would result in the following calculation for time bucket 3:
time = [(3 - 0) * 2 ns] + 16 ns = 22 ns
In :ACQuire:TYPE PEAK mode (see page 208), because data is acquired in
max- min pairs, modify the previous time formula to the following:
time=[(data pair number - xreference) * xincrement * 2] + xorigin
Data Format for Transfer
There are three formats for transferring waveform data over the interface:
BYTE, WORD and ASCii (see ":WAVeform:FORMat" on page 640). BYTE,
WORD and ASCii formatted waveform records are transmitted using the
arbitrary block program data format specified in IEEE 488.2.
When you use the block data format, the ASCII character string
"#8<DD...D>" is sent prior to sending the actual data. The 8 indicates how
many Ds follow. The Ds are ASCII numbers that indicate how many data
bytes follow.
For example, if 1000 points will be transferred, and the WORD format was
specified, the block header "#800001000" would be sent. The 8 indicates
that eight length bytes follow, and 00001000 indicates that 1000 binary
data bytes follow.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
633
5
Commands by Subsystem
Use the :WAVeform:UNSigned command (see page 656) to control whether
data values are sent as unsigned or signed integers. This command can be
used to match the instrument's internal data type to the data type used by
the programming language. This command has no effect if the data format
is ASCii.
Data Format for Transfer - ASCii format
The ASCii format (see ":WAVeform:FORMat" on page 640) provides
access to the waveform data as real Y- axis values without using Y
origin, Y reference, and Y increment to convert the binary data. Values
are transferred as ASCii digits in floating point format separated by
commas. In ASCii format, holes are represented by the value 9.9e+37.
The setting of :WAVeform:BYTeorder (see page 636) and
:WAVeform:UNSigned (see page 656) have no effect when the format is
ASCii.
Data Format for Transfer - WORD format
WORD format (see ":WAVeform:FORMat" on page 640) provides 16- bit
access to the waveform data. In the WORD format, the number of data
bytes is twice the number of data points. The number of data points is
the value returned by the :WAVeform:POINts? query (see page 641). If
the data intrinsically has less than 16 bits of resolution, the data is
left- shifted to provide 16 bits of resolution and the least significant bits
are set to 0. Currently, the greatest intrinsic resolution of any data is
12 bits, so at least the lowest 4 bits of data will be 0. If there is a hole
in the data, the hole is represented by a 16 bit value equal to 0.
Use :WAVeform:BYTeorder (see page 636) to determine if the least
significant byte or most significant byte is to be transferred first. The
:BYTeorder command can be used to alter the transmit sequence to
match the storage sequence of an integer in the programming language
being used.
Data Format for Transfer - BYTE format
The BYTE format (see ":WAVeform:FORMat" on page 640 ) allows 8- bit
access to the waveform data. If the data intrinsically has more than 8
bits of resolution (averaged data), the data is right- shifted (truncated)
to fit into 8 bits. If there is a hole in the data, the hole is represented
by a value of 0. The BYTE- formatted data transfers over the
programming interface faster than ASCii or WORD- formatted data,
because in ASCii format, as many as 13 bytes per point are transferred,
in BYTE format one byte per point is transferred, and in WORD format
two bytes per point are transferred.
The :WAVeform:BYTeorder command (see page 636) has no effect when
the data format is BYTE.
634
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
Digital Channel Data (MSO models only)
The waveform record for digital channels is similar to that of analog
channels. The main difference is that the data points represent either
DIGital0,..,7 (POD1), DIGital8,..,15 (POD2), or any grouping of digital
channels (BUS1 or BUS2).
For digital channels, :WAVeform:UNSigned (see page 656) must be set to
ON.
Digital Channel POD Data Format
Data for digital channels is only available in groups of 8 bits (Pod1 = D0 D7, Pod2 = D8 - D15). The bytes are organized as:
:WAVeform:SOURce
Bit 7
Bit 6
Bit 5
Bit 4
Bit 3
Bit 2
Bit 1
Bit 0
POD1
D7
D6
D5
D4
D3
D2
D1
D0
POD2
D15
D14
D13
D12
D11
D10
D9
D8
If the :WAVeform:FORMat is WORD (see page 640) is WORD, every other
data byte will be 0. The setting of :WAVeform:BYTeorder (see page 636)
controls which byte is 0.
If a digital channel is not displayed, its bit value in the pod data byte is
not defined.
Digital Channel BUS Data Format
Digital channel BUS definitions can include any or all of the digital
channels. Therefore, data is always returned as 16- bit values. :BUS
commands (see page 210) are used to select the digital channels for a bus.
Reporting the Setup
The following is a sample response from the :WAVeform? query. In this
case, the query was issued following a *RST command.
:WAV:UNS 1;VIEW MAIN;BYT MSBF;FORM BYTE;POIN +1000;SOUR CHAN1;SOUR:SUBS
NONE
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
635
5
Commands by Subsystem
:WAVeform:BYTeorder
(see page 798)
Command Syntax
:WAVeform:BYTeorder <value>
<value> ::= {LSBFirst | MSBFirst}
The :WAVeform:BYTeorder command sets the output sequence of the WORD
data. The parameter MSBFirst sets the most significant byte to be
transmitted first. The parameter LSBFirst sets the least significant byte to
be transmitted first. This command affects the transmitting sequence only
when :WAVeform:FORMat WORD is selected. The default setting is
LSBFirst.
Query Syntax
:WAVeform:BYTeorder?
The :WAVeform:BYTeorder query returns the current output sequence.
Return Format
<value><NL>
<value> ::= {LSBF | MSBF}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:DATA" on page 638
• ":WAVeform:FORMat" on page 640
• ":WAVeform:PREamble" on page 645
Example Code
• "Example Code" on page 651
• "Example Code" on page 646
636
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:WAVeform:COUNt
(see page 798)
Query Syntax
:WAVeform:COUNt?
The :WAVeform:COUNT? query returns the count used to acquire the
current waveform. This may differ from current values if the unit has been
stopped and its configuration modified. For all acquisition types except
average, this value is 1.
Return Format
<count_argument><NL>
<count_argument> ::= an integer from 1 to 65536 in NR1 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":ACQuire:COUNt" on page 197
• ":ACQuire:TYPE" on page 208
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
637
5
Commands by Subsystem
:WAVeform:DATA
(see page 798)
Query Syntax
:WAVeform:DATA?
The :WAVeform:DATA query returns the binary block of sampled data
points transmitted using the IEEE 488.2 arbitrary block data format. The
binary data is formatted according to the settings of the
:WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and
:WAVeform:SOURce commands. The number of points returned is
controlled by the :WAVeform:POINts command.
In BYTE or WORD waveform formats, these data values have special
meaning:
• 0x00 or 0x0000 — Hole. Holes are locations where data has not yet been
acquired. Holes can be reasonably expected in the equivalent time
acquisition mode (especially at slower horizontal sweep speeds when
measuring low frequency signals).
Another situation where there can be zeros in the data, incorrectly, is
when programming over telnet port 5024. Port 5024 provides a
command prompt and is intended for ASCII transfers. Use telnet port
5025 instead.
• 0x01 or 0x0001 — Clipped low. These are locations where the waveform
is clipped at the bottom of the oscilloscope display.
• 0xFF or 0xFFFF — Clipped high. These are locations where the
waveform is clipped at the top of the oscilloscope display.
Return Format
See Also
<binary block data><NL>
• For a more detailed description of the data returned for different
acquisition types, see: "Introduction to :WAVeform Commands" on
page 630
• ":WAVeform:UNSigned" on page 656
• ":WAVeform:BYTeorder" on page 636
• ":WAVeform:FORMat" on page 640
• ":WAVeform:POINts" on page 641
• ":WAVeform:PREamble" on page 645
• ":WAVeform:SOURce" on page 650
• ":WAVeform:TYPE" on page 655
Example Code
' QUERY_WAVE_DATA - Outputs waveform data that is stored in a buffer.
' Query the oscilloscope for the waveform data.
myScope.WriteString ":WAV:DATA?"
' READ_WAVE_DATA - The wave data consists of two parts: the header,
638
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
' and the actual waveform data followed by a new line (NL) character.
' The query data has the following format:
'
'
<header><waveform_data><NL>
'
' Where:
'
<header> = #800001000 (This is an example header)
' The "#8" may be stripped off of the header and the remaining
' numbers are the size, in bytes, of the waveform data block. The
' size can vary depending on the number of points acquired for the
' waveform. You can then read that number of bytes from the
' oscilloscope and the terminating NL character.
'
Dim lngI As Long
Dim lngDataValue As Long
varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1)
' Unsigned integer bytes.
For lngI = 0 To UBound(varQueryResult) _
Step (UBound(varQueryResult) / 20)
' 20 points.
If intBytesPerData = 2 Then
lngDataValue = varQueryResult(lngI) * 256 _
+ varQueryResult(lngI + 1)
' 16-bit value.
Else
lngDataValue = varQueryResult(lngI)
' 8-bit value.
End If
strOutput = strOutput + "Data point " + _
CStr(lngI / intBytesPerData) + ", " + _
FormatNumber((lngDataValue - lngYReference) _
* sngYIncrement + sngYOrigin) + " V, " + _
FormatNumber(((lngI / intBytesPerData - lngXReference) _
* sngXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf
Next lngI
MsgBox "Waveform data:" + vbCrLf + strOutput
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
639
5
Commands by Subsystem
:WAVeform:FORMat
(see page 798)
Command Syntax
:WAVeform:FORMat <value>
<value> ::= {WORD | BYTE | ASCii}
The :WAVeform:FORMat command sets the data transmission mode for
waveform data points. This command controls how the data is formatted
when sent from the oscilloscope.
• ASCii formatted data converts the internal integer data values to real
Y- axis values. Values are transferred as ASCii digits in floating point
notation, separated by commas.
ASCII formatted data is transferred ASCii text.
• WORD formatted data transfers 16- bit data as two bytes. The
:WAVeform:BYTeorder command can be used to specify whether the
upper or lower byte is transmitted first. The default (no command sent)
is that the upper byte transmitted first.
• BYTE formatted data is transferred as 8- bit bytes.
When the :WAVeform:SOURce is the serial decode bus (SBUS), ASCii is the
only waveform format allowed.
When the :WAVeform:SOURce is one of the digital channel buses (BUS1 or
BUS2), ASCii and WORD are the only waveform formats allowed.
Query Syntax
:WAVeform:FORMat?
The :WAVeform:FORMat query returns the current output format for the
transfer of waveform data.
Return Format
<value><NL>
<value> ::= {WORD | BYTE | ASC}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:BYTeorder" on page 636
• ":WAVeform:SOURce" on page 650
• ":WAVeform:DATA" on page 638
• ":WAVeform:PREamble" on page 645
Example Code
640
• "Example Code" on page 651
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:WAVeform:POINts
(see page 798)
Command Syntax
:WAVeform:POINts <# points>
<# points> ::= {100 | 250 | 500 | 1000 | <points mode>}
if waveform points mode is NORMal
<# points> ::= {100 | 250 | 500 | 1000 | 2000 | 5000 | 10000 | 20000
| 50000 | 100000 | 200000 | 500000 | 1000000 | 2000000
| 4000000 | 8000000 | <points mode>}
if waveform points mode is MAXimum or RAW
<points mode> ::= {NORMal | MAXimum | RAW}
NOTE
The <points_mode> option is deprecated. Use the :WAVeform:POINts:MODE command
instead.
The :WAVeform:POINts command sets the number of waveform points to be
transferred with the :WAVeform:DATA? query. This value represents the
points contained in the waveform selected with the :WAVeform:SOURce
command.
For the analog or digital sources, the records that can be transferred
depend on the waveform points mode. The maximum number of points
returned for math (function) waveforms is determined by the NORMal
waveform points mode. See the :WAVeform:POINts:MODE command (see
page 643) for more information.
Only data visible on the display will be returned.
When the :WAVeform:SOURce is the serial decode bus (SBUS), this
command is ignored, and all available serial decode bus data is returned.
Query Syntax
:WAVeform:POINts?
The :WAVeform:POINts query returns the number of waveform points to be
transferred when using the :WAVeform:DATA? query. Setting the points
mode will affect what data is transferred (see the :WAVeform:POINts:MODE
command (see page 643) for more information).
When the :WAVeform:SOURce is the serial decode bus (SBUS), this query
returns the number of messages that were decoded.
Return Format
<# points><NL>
<# points> ::= {100 | 250 | 500 | 1000 | <maximum # points>}
if waveform points mode is NORMal
<# points> ::= {100 | 250 | 500 | 1000 | 2000 | 5000 | 10000 | 20000
| 50000 | 100000 | 200000 | 500000 | 1000000 | 2000000
| 4000000 | 8000000 | <maximum # points>}
if waveform points mode is MAXimum or RAW
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
641
5
Commands by Subsystem
NOTE
See Also
If a full screen of data is not displayed, the number of points returned will not be 1000 or an
even divisor of it.
• "Introduction to :WAVeform Commands" on page 630
• ":ACQuire:POINts" on page 200
• ":WAVeform:DATA" on page 638
• ":WAVeform:SOURce" on page 650
• ":WAVeform:VIEW" on page 657
• ":WAVeform:PREamble" on page 645
• ":WAVeform:POINts:MODE" on page 643
Example Code
' WAVE_POINTS - Specifies the number of points to be transferred
' using the ":WAVEFORM:DATA?" query.
myScope.WriteString ":WAVEFORM:POINTS 1000"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
642
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:WAVeform:POINts:MODE
(see page 798)
Command Syntax
:WAVeform:POINts:MODE <points_mode>
<points_mode> ::= {NORMal | MAXimum | RAW}
The :WAVeform:POINts:MODE command sets the data record to be
transferred with the :WAVeform:DATA? query.
For the analog or digital sources, there are three different records that can
be transferred:
• The first is the raw acquisition record. The maximum number of points
available in this record is returned by the :ACQuire:POINts? query. The
raw acquisition record can only be transferred when the oscilloscope is
not running and can only be retrieved from the analog or digital
sources.
• The second is referred to as the measurement record and is a
1000- point (maximum) representation of the raw acquisition record.
The measurement record can be retrieved when :SYSTem:PRECision is
OFF, from any source.
• The third is referred to as the precision analysis record and is a
10K- point (maximum) representation of the raw acquisition record. The
precision analysis record can be retrieved when :SYSTem:PRECision is
ON, from analog sources.
If the <points_mode> is NORMal and :SYSTem:PRECision is OFF, the
measurement record is retrieved.
If the <points_mode> is NORMal and :SYSTem:PRECision is ON, the
precision analysis record is retrieved.
If the <points_mode> is RAW, the raw acquisition record is used. Under
some conditions, such as when the oscilloscope is running, this data
record is unavailable.
If the <points_mode> is MAXimum, whichever record contains the
maximum amount of points is used. Usually, this is the raw acquisition
record. But, if the raw acquisition record is unavailable (for example,
when the oscilloscope is running), or if the reconstruction filter (Sin(x)/x
interpolation) is in use, the measurement record may have more data. If
data is being retrieved as the oscilloscope is stopped and as the data
displayed is changing, the data being retrieved can switch between the
measurement and raw acquisition records.
Considerations
for MAXimum or
RAW data
retrieval
• The instrument must be stopped (see the :STOP command (see
page 190) or the :DIGitize command (see page 162) in the root
subsystem) in order to return more than the measurement record or
precision analysis record.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
643
5
Commands by Subsystem
• :TIMebase:MODE must be set to MAIN.
• :ACQuire:TYPE must be set to NORMal, AVERage, or HRESolution. If
AVERage, :ACQuire:COUNt must be set to 1 in order to return more
than the measurement record or precision analysis record.
• MAXimum or RAW will allow up to 8,000,000 points to be returned. The
number of points returned will vary as the instrument's configuration is
changed. Use the :WAVeform:POINts? MAXimum query to determine the
maximum number of points that can be retrieved at the current
settings.
Query Syntax
:WAVeform:POINts:MODE?
The :WAVeform:POINts:MODE? query returns the current points mode.
Setting the points mode will affect what data is transferred. See the
discussion above.
Return Format
<points_mode><NL>
<points_mode> ::= {NORMal | MAXimum | RAW}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:DATA" on page 638
• ":ACQuire:POINts" on page 200
• ":SYSTem:PRECision" on page 462
• ":WAVeform:VIEW" on page 657
• ":WAVeform:PREamble" on page 645
• ":WAVeform:POINts" on page 641
• ":TIMebase:MODE" on page 469
• ":ACQuire:TYPE" on page 208
• ":ACQuire:COUNt" on page 197
644
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:WAVeform:PREamble
(see page 798)
Query Syntax
:WAVeform:PREamble?
The :WAVeform:PREamble query requests the preamble information for the
selected waveform source. The preamble data contains information
concerning the vertical and horizontal scaling of the data of the
corresponding channel.
Return Format
<preamble_block><NL>
<preamble_block> ::= <format 16-bit NR1>,
<type 16-bit NR1>,
<points 32-bit NR1>,
<count 32-bit NR1>,
<xincrement 64-bit floating point NR3>,
<xorigin 64-bit floating point NR3>,
<xreference 32-bit NR1>,
<yincrement 32-bit floating point NR3>,
<yorigin 32-bit floating point NR3>,
<yreference 32-bit NR1>
<format> ::= 0 for BYTE format, 1 for WORD format, 4 for ASCii format;
an integer in NR1 format (format set by :WAVeform:FORMat).
<type> ::= 2 for AVERage type, 0 for NORMal type, 1 for PEAK detect
type; an integer in NR1 format (type set by :ACQuire:TYPE).
<count> ::= Average count or 1 if PEAK or NORMal; an integer in NR1
format (count set by :ACQuire:COUNt).
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
645
5
Commands by Subsystem
Delay = (#points / 2) * Xincrement + Xorigin
Y increment =
voltage of 1 Vstep
Offset
Y origin (V)
Y reference = #Vsteps / 2
#Vsteps =
65536 (if format = WORD)
256 (if format = BYTE)
X origin (t)
X reference = 0
X increment (t) = time between successive points
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":ACQuire:COUNt" on page 197
• ":ACQuire:POINts" on page 200
• ":ACQuire:TYPE" on page 208
• ":DIGitize" on page 162
• ":WAVeform:COUNt" on page 637
• ":WAVeform:DATA" on page 638
• ":WAVeform:FORMat" on page 640
• ":WAVeform:POINts" on page 641
• ":WAVeform:TYPE" on page 655
• ":WAVeform:XINCrement" on page 658
• ":WAVeform:XORigin" on page 659
• ":WAVeform:XREFerence" on page 660
• ":WAVeform:YINCrement" on page 661
• ":WAVeform:YORigin" on page 662
• ":WAVeform:YREFerence" on page 663
Example Code
646
' GET_PREAMBLE - The preamble block contains all of the current
' WAVEFORM settings. It is returned in the form <preamble_block><NL>
' where <preamble_block> is:
'
FORMAT
: int16 - 0 = BYTE, 1 = WORD, 4 = ASCII.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
'
'
'
'
'
'
'
'
'
'
'
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
TYPE
POINTS
COUNT
XINCREMENT
XORIGIN
XREFERENCE
YINCREMENT
YORIGIN
YREFERENCE
:
:
:
:
:
:
5
int16 int32 int32 float64
float64
int32 -
0 = NORMAL, 1 = PEAK DETECT, 2 = AVERAGE
number of data points transferred.
1 and is always 1.
- time difference between data points.
- always the first data point in memory.
specifies the data point associated with
x-origin.
: float32 - voltage diff between data points.
: float32 - value is the voltage at center screen.
: int32 - specifies the data point where y-origin
occurs.
Preamble()
intFormat As Integer
intType As Integer
lngPoints As Long
lngCount As Long
dblXIncrement As Double
dblXOrigin As Double
lngXReference As Long
sngYIncrement As Single
sngYOrigin As Single
lngYReference As Long
strOutput As String
myScope.WriteString ":WAVEFORM:PREAMBLE?"
' Query for the preamble.
Preamble() = myScope.ReadList
' Read preamble information.
intFormat = Preamble(0)
intType = Preamble(1)
lngPoints = Preamble(2)
lngCount = Preamble(3)
dblXIncrement = Preamble(4)
dblXOrigin = Preamble(5)
lngXReference = Preamble(6)
sngYIncrement = Preamble(7)
sngYOrigin = Preamble(8)
lngYReference = Preamble(9)
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
647
5
Commands by Subsystem
:WAVeform:SEGMented:COUNt
(see page 798)
Query Syntax
NOTE
:WAVeform:SEGMented:COUNt?
This command is available when the segmented memory option (Option SGM) is enabled.
The :WAVeform:SEGMented:COUNt query returns the number of memory
segments in the acquired data. You can use the
:WAVeform:SEGMented:COUNt? query while segments are being acquired
(although :DIGitize blocks subsequent queries until the full segmented
acquisition is complete).
The segmented memory acquisition mode is enabled with the
:ACQuire:MODE command. The number of segments to acquire is set using
the :ACQuire:SEGMented:COUNt command, and data is acquired using the
:DIGitize, :SINGle, or :RUN commands.
Return Format
See Also
<count> ::= an integer from 2 to 2000 in NR1 format (count set by
:ACQuire:SEGMented:COUNt).
• ":ACQuire:MODE" on page 199
• ":ACQuire:SEGMented:COUNt" on page 203
• ":DIGitize" on page 162
• ":SINGle" on page 188
• ":RUN" on page 186
• "Introduction to :WAVeform Commands" on page 630
Example Code
648
• "Example Code" on page 204
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:WAVeform:SEGMented:TTAG
(see page 798)
Query Syntax
NOTE
:WAVeform:SEGMented:TTAG?
This command is available when the segmented memory option (Option SGM) is enabled.
The :WAVeform:SEGMented:TTAG? query returns the time tag of the
currently selected segmented memory index. The index is selected using
the :ACQuire:SEGMented:INDex command.
Return Format
See Also
<time_tag> ::= in NR3 format
• ":ACQuire:SEGMented:INDex" on page 204
• "Introduction to :WAVeform Commands" on page 630
Example Code
• "Example Code" on page 204
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
649
5
Commands by Subsystem
:WAVeform:SOURce
(see page 798)
Command Syntax
:WAVeform:SOURce <source>
<source> ::= {CHANnel<n> | FUNCtion | MATH | SBUS} for DSO models
<source> ::= {CHANnel<n> | POD{1 | 2} | BUS{1 | 2} | FUNCtion
| MATH | SBUS} for MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :WAVeform:SOURce command selects the analog channel, function,
digital pod, digital bus, or serial decode bus to be used as the source for
the :WAVeform commands.
Function capabilities include add, subtract, multiply; integrate,
differentiate, and FFT (Fast Fourier Transform) operations.
When the :WAVeform:SOURce is the serial decode bus (SBUS), ASCii is the
only waveform format allowed.
With MSO oscilloscope models, you can choose a POD or BUS as the
waveform source. There are some differences between POD and BUS when
formatting and getting data from the oscilloscope:
• When POD1 or POD2 is selected as the waveform source, you can
choose the BYTE, WORD, or ASCii formats (see ":WAVeform:FORMat" on
page 640).
When the WORD format is chosen, every other data byte will be 0. The
setting of :WAVeform:BYTeorder controls which byte is 0.
When the ASCii format is chosen, the :WAVeform:DATA? query returns a
string with unsigned decimal values separated by commas.
• When BUS1 or BUS2 is selected as the waveform source, you can
choose the WORD or ASCii formats (but not BYTE because bus values
are always returned as 16- bit values).
When the ASCii format is chosen, the :WAVeform:DATA? query returns a
string with timestamps and hexadecimal bus values, for example:
- 5.000000000000e- 08,0x1938,- 4.990000000000e- 08,0xff38,...
Query Syntax
:WAVeform:SOURce?
The :WAVeform:SOURce? query returns the currently selected source for
the WAVeform commands.
NOTE
650
MATH is an alias for FUNCtion. The :WAVeform:SOURce? Query returns FUNC if the source
is FUNCtion or MATH.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
Return Format
5
<source><NL>
<source> ::= {CHAN<n> | FUNC | SBUS} for DSO models
<source> ::= {CHAN<n> | POD{1 | 2} | BUS{1 | 2} | FUNC | SBUS}
for MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":DIGitize" on page 162
• ":WAVeform:FORMat" on page 640
• ":WAVeform:BYTeorder" on page 636
• ":WAVeform:DATA" on page 638
• ":WAVeform:PREamble" on page 645
Example Code
' WAVEFORM_DATA - To obtain waveform data, you must specify the
' WAVEFORM parameters for the waveform data prior to sending the
' ":WAVEFORM:DATA?" query. Once these parameters have been sent,
' the waveform data and the preamble can be read.
'
' WAVE_SOURCE - Selects the channel to be used as the source for
' the waveform commands.
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"
' WAVE_POINTS - Specifies the number of points to be transferred
' using the ":WAVEFORM:DATA?" query.
myScope.WriteString ":WAVEFORM:POINTS 1000"
' WAVE_FORMAT - Sets the data transmission mode for the waveform
' data output. This command controls whether data is formatted in
' a word or byte format when sent from the oscilloscope.
Dim lngVSteps As Long
Dim intBytesPerData As Integer
' Data in range 0 to 65535.
myScope.WriteString ":WAVEFORM:FORMAT WORD"
lngVSteps = 65536
intBytesPerData = 2
' Data in range 0 to 255.
'myScope.WriteString ":WAVEFORM:FORMAT BYTE"
'lngVSteps = 256
'intBytesPerData = 1
' GET_PREAMBLE - The preamble block contains all of the current
' WAVEFORM settings. It is returned in the form <preamble_block><NL>
' where <preamble_block> is:
'
FORMAT
: int16 - 0 = BYTE, 1 = WORD, 4 = ASCII.
'
TYPE
: int16 - 0 = NORMAL, 1 = PEAK DETECT, 2 = AVERAGE
'
POINTS
: int32 - number of data points transferred.
'
COUNT
: int32 - 1 and is always 1.
'
XINCREMENT
: float64 - time difference between data points.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
651
5
Commands by Subsystem
'
'
'
'
'
'
'
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
Dim
XORIGIN
XREFERENCE
YINCREMENT
YORIGIN
YREFERENCE
: float64 - always the first data point in memory.
: int32 - specifies the data point associated with
x-origin.
: float32 - voltage diff between data points.
: float32 - value is the voltage at center screen.
: int32 - specifies the data point where y-origin
occurs.
Preamble()
intFormat As Integer
intType As Integer
lngPoints As Long
lngCount As Long
dblXIncrement As Double
dblXOrigin As Double
lngXReference As Long
sngYIncrement As Single
sngYOrigin As Single
lngYReference As Long
strOutput As String
myScope.WriteString ":WAVEFORM:PREAMBLE?"
' Query for the preamble.
Preamble() = myScope.ReadList
' Read preamble information.
intFormat = Preamble(0)
intType = Preamble(1)
lngPoints = Preamble(2)
lngCount = Preamble(3)
dblXIncrement = Preamble(4)
dblXOrigin = Preamble(5)
lngXReference = Preamble(6)
sngYIncrement = Preamble(7)
sngYOrigin = Preamble(8)
lngYReference = Preamble(9)
strOutput = ""
'strOutput = strOutput + "Format = " + CStr(intFormat) + vbCrLf
'strOutput = strOutput + "Type = " + CStr(intType) + vbCrLf
'strOutput = strOutput + "Points = " + CStr(lngPoints) + vbCrLf
'strOutput = strOutput + "Count = " + CStr(lngCount) + vbCrLf
'strOutput = strOutput + "X increment = " + _
'
FormatNumber(dblXIncrement * 1000000) + " us" + vbCrLf
'strOutput = strOutput + "X origin = " + _
'
FormatNumber(dblXOrigin * 1000000) + " us" + vbCrLf
'strOutput = strOutput + "X reference = " + _
'
CStr(lngXReference) + vbCrLf
'strOutput = strOutput + "Y increment = " + _
'
FormatNumber(sngYIncrement * 1000) + " mV" + vbCrLf
'strOutput = strOutput + "Y origin = " + _
'
FormatNumber(sngYOrigin) + " V" + vbCrLf
'strOutput = strOutput + "Y reference = " + _
'
CStr(lngYReference) + vbCrLf
strOutput = strOutput + "Volts/Div = " + _
FormatNumber(lngVSteps * sngYIncrement / 8) + _
" V" + vbCrLf
strOutput = strOutput + "Offset = " + _
FormatNumber((lngVSteps / 2 - lngYReference) * _
sngYIncrement + sngYOrigin) + " V" + vbCrLf
strOutput = strOutput + "Sec/Div = " + _
FormatNumber(lngPoints * dblXIncrement / 10 * _
652
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
1000000) + " us" + vbCrLf
strOutput = strOutput + "Delay = " + _
FormatNumber(((lngPoints / 2 - lngXReference) * _
dblXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf
' QUERY_WAVE_DATA - Outputs waveform data that is stored in a buffer.
' Query the oscilloscope for the waveform data.
myScope.WriteString ":WAV:DATA?"
' READ_WAVE_DATA - The wave data consists of two parts: the header,
' and the actual waveform data followed by a new line (NL) character.
' The query data has the following format:
'
'
<header><waveform_data><NL>
'
' Where:
'
<header> = #800001000 (This is an example header)
' The "#8" may be stripped off of the header and the remaining
' numbers are the size, in bytes, of the waveform data block. The
' size can vary depending on the number of points acquired for the
' waveform. You can then read that number of bytes from the
' oscilloscope and the terminating NL character.
'
Dim lngI As Long
Dim lngDataValue As Long
' Unsigned integer bytes.
varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1)
For lngI = 0 To UBound(varQueryResult) _
Step (UBound(varQueryResult) / 20)
' 20 points.
If intBytesPerData = 2 Then
lngDataValue = varQueryResult(lngI) * 256 _
+ varQueryResult(lngI + 1)
' 16-bit value.
Else
lngDataValue = varQueryResult(lngI)
' 8-bit value.
End If
strOutput = strOutput + "Data point " + _
CStr(lngI / intBytesPerData) + ", " + _
FormatNumber((lngDataValue - lngYReference) _
* sngYIncrement + sngYOrigin) + " V, " + _
FormatNumber(((lngI / intBytesPerData - lngXReference) _
* sngXIncrement + dblXOrigin) * 1000000) + " us" + vbCrLf
Next lngI
MsgBox "Waveform data:" + vbCrLf + strOutput
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
653
5
Commands by Subsystem
:WAVeform:SOURce:SUBSource
(see page 798)
Command Syntax
:WAVeform:SOURce:SUBSource <subsource>
<subsource> ::= {{NONE | RX} | TX}
If the :WAVeform:SOURce is SBUS (serial decode), more than one data set
may be available, and this command lets you choose from the available
data sets.
Currently, only UART serial decode lets you get "TX" data. The default,
NONE, specifies "RX" data. (RX is an alias for NONE.)
If the :WAVeform:SOURce is not SBUS, or the :SBUS:MODE is not UART,
the only valid subsource is NONE.
Query Syntax
:WAVeform:SOURce:SUBSource?
The :WAVeform:SOURce:SUBSource? query returns the current waveform
subsource setting.
Return Format
<subsource><NL>
<subsource> ::= {NONE | TX}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:SOURce" on page 650
654
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:WAVeform:TYPE
(see page 798)
Query Syntax
:WAVeform:TYPE?
The :WAVeform:TYPE? query returns the acquisition mode associated with
the currently selected waveform. The acquisition mode is set by the
:ACQuire:TYPE command.
Return Format
<mode><NL>
<mode> ::= {NORM | PEAK | AVER | HRES}
NOTE
See Also
If the :WAVeform:SOURce is POD1, POD2, or SBUS, the type is always NORM.
• "Introduction to :WAVeform Commands" on page 630
• ":ACQuire:TYPE" on page 208
• ":WAVeform:DATA" on page 638
• ":WAVeform:PREamble" on page 645
• ":WAVeform:SOURce" on page 650
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
655
5
Commands by Subsystem
:WAVeform:UNSigned
(see page 798)
Command Syntax
:WAVeform:UNSigned <unsigned>
<unsigned> ::= {{0 | OFF} | {1 | ON}}
The :WAVeform:UNSigned command turns unsigned mode on or off for the
currently selected waveform. Use the WAVeform:UNSigned command to
control whether data values are sent as unsigned or signed integers. This
command can be used to match the instrument's internal data type to the
data type used by the programming language. This command has no effect
if the data format is ASCii.
If :WAVeform:SOURce is set to POD1, POD2, BUS1, or BUS2,
WAVeform:UNSigned must be set to ON.
Query Syntax
:WAVeform:UNSigned?
The :WAVeform:UNSigned? query returns the status of unsigned mode for
the currently selected waveform.
Return Format
<unsigned><NL>
<unsigned> ::= {0 | 1}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:SOURce" on page 650
656
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
5
Commands by Subsystem
:WAVeform:VIEW
(see page 798)
Command Syntax
:WAVeform:VIEW <view>
<view> ::= {MAIN}
The :WAVeform:VIEW command sets the view setting associated with the
currently selected waveform. Currently, the only legal value for the view
setting is MAIN.
Query Syntax
:WAVeform:VIEW?
The :WAVeform:VIEW? query returns the view setting associated with the
currently selected waveform.
Return Format
<view><NL>
<view> ::= {MAIN}
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:POINts" on page 641
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
657
5
Commands by Subsystem
:WAVeform:XINCrement
(see page 798)
Query Syntax
:WAVeform:XINCrement?
The :WAVeform:XINCrement? query returns the x- increment value for the
currently specified source. This value is the time difference between
consecutive data points in seconds.
Return Format
<value><NL>
<value> ::= x-increment in the current preamble in 64-bit
floating point NR3 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
Example Code
658
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:WAVeform:XORigin
(see page 798)
Query Syntax
:WAVeform:XORigin?
The :WAVeform:XORigin? query returns the x- origin value for the currently
specified source. XORigin is the X- axis value of the data point specified by
the :WAVeform:XREFerence value. In this product, that is always the
X- axis value of the first data point (XREFerence = 0).
Return Format
<value><NL>
<value> ::= x-origin value in the current preamble in 64-bit
floating point NR3 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
• ":WAVeform:XREFerence" on page 660
Example Code
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
659
5
Commands by Subsystem
:WAVeform:XREFerence
(see page 798)
Query Syntax
:WAVeform:XREFerence?
The :WAVeform:XREFerence? query returns the x- reference value for the
currently specified source. This value specifies the index of the data point
associated with the x- origin data value. In this product, the x- reference
point is the first point displayed and XREFerence is always 0.
Return Format
<value><NL>
<value> ::= x-reference value = 0 in 32-bit NR1 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
• ":WAVeform:XORigin" on page 659
Example Code
660
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:WAVeform:YINCrement
(see page 798)
Query Syntax
:WAVeform:YINCrement?
The :WAVeform:YINCrement? query returns the y- increment value in volts
for the currently specified source. This value is the voltage difference
between consecutive data values. The y- increment for digital waveforms is
always "1".
Return Format
<value><NL>
<value> ::= y-increment value in the current preamble in 32-bit
floating point NR3 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
Example Code
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
661
5
Commands by Subsystem
:WAVeform:YORigin
(see page 798)
Query Syntax
:WAVeform:YORigin?
The :WAVeform:YORigin? query returns the y- origin value for the currently
specified source. This value is the Y- axis value of the data value specified
by the :WAVeform:YREFerence value. For this product, this is the Y- axis
value of the center of the screen.
Return Format
<value><NL>
<value> ::= y-origin in the current preamble in 32-bit
floating point NR3 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
• ":WAVeform:YREFerence" on page 663
Example Code
662
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands by Subsystem
5
:WAVeform:YREFerence
(see page 798)
Query Syntax
:WAVeform:YREFerence?
The :WAVeform:YREFerence? query returns the y- reference value for the
currently specified source. This value specifies the data point value where
the y- origin occurs. In this product, this is the data point value of the
center of the screen. It is undefined if the format is ASCii.
Return Format
<value><NL>
<value> ::= y-reference value in the current preamble in 32-bit
NR1 format
See Also
• "Introduction to :WAVeform Commands" on page 630
• ":WAVeform:PREamble" on page 645
• ":WAVeform:YORigin" on page 662
Example Code
• "Example Code" on page 646
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
663
5
664
Commands by Subsystem
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
6
Commands A-Z
A 665
B 667
C 667
D 670
E 672
F 672
G 674
H 674
I 675
L 676
M 677
N 680
O 680
P 681
Q 683
R 683
S 685
T 689
U 695
V 696
W 696
X 697
Y 698
A
• AALias, ":ACQuire:AALias" on page 195
• ACKNowledge, ":TRIGger:CAN:ACKNowledge" on page 750
• ":ACQuire:AALias" on page 195
• ":ACQuire:COMPlete" on page 196
• ":ACQuire:COUNt" on page 197
• ":ACQuire:DAALias" on page 198

665
6
Commands A-Z
• ":ACQuire:MODE" on page 199
• ":ACQuire:POINts" on page 200
• ":ACQuire:RSIGnal" on page 201
• ":ACQuire:SEGMented:ANALyze" on page 202
• ":ACQuire:SEGMented:COUNt" on page 203
• ":ACQuire:SEGMented:INDex" on page 204
• ":ACQuire:SRATe" on page 207
• ":ACQuire:TYPE" on page 208
• ":ACTivity" on page 154
• ADDRess, ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":AER (Arm Event Register)" on page 155
• ALIGnment, ":TRIGger:I2S:ALIGnment" on page 540
• AMASk Commands:
• ":MTESt:AMASk:CREate" on page 375
• ":MTESt:AMASk:{SAVE | STORe}" on page 739
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:YDELta" on page 379
• ANALyze, ":ACQuire:SEGMented:ANALyze" on page 202
• APRinter, ":HARDcopy:APRinter" on page 296
• AREA Commands:
• ":HARDcopy:AREA" on page 295
• ":SAVE:IMAGe:AREA" on page 419
• ASIZe, ":SBUS:IIC:ASIZe" on page 445
• AUDio, ":TRIGger:I2S:AUDio" on page 541
• ":AUToscale" on page 156
• ":AUToscale:AMODE" on page 158
• ":AUToscale:CHANnels" on page 159
• AUTosetup Commands:
• ":TRIGger:FLEXray:AUTosetup" on page 518
• ":TRIGger:M1553:AUTosetup" on page 579
• AVERage Commands:
• ":MTESt:AVERage" on page 740
• ":MTESt:AVERage:COUNt" on page 741
666
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
B
6
• BASE Commands:
• ":SBUS:M1553:BASE" on page 447
• ":SBUS:UART:BASE" on page 451
• ":TRIGger:UART:BASE" on page 610
• BAUDrate Commands:
• ":TRIGger:CAN:SIGNal:BAUDrate" on page 497
• ":TRIGger:FLEXray:BAUDrate" on page 519
• ":TRIGger:LIN:SIGNal:BAUDrate" on page 573
• ":TRIGger:UART:BAUDrate" on page 611
• BIND, ":MTESt:SCALe:BIND" on page 397
• BIT<m>, ":BUS<n>:BIT<m>" on page 212
• BITorder Commands:
• ":SBUS:SPI:BITorder" on page 449
• ":TRIGger:UART:BITorder" on page 612
• BITS, ":BUS<n>:BITS" on page 213
• ":BLANk" on page 160
• BURSt, ":TRIGger:UART:BURSt" on page 613
• ":BUS<n>:BIT<m>" on page 212
• ":BUS<n>:BITS" on page 213
• ":BUS<n>:CLEar" on page 215
• ":BUS<n>:DISPlay" on page 216
• ":BUS<n>:LABel" on page 217
• ":BUS<n>:MASK" on page 218
• BWLimit Commands:
• ":CHANnel<n>:BWLimit" on page 232
• ":EXTernal:BWLimit" on page 268
• BYTeorder, ":WAVeform:BYTeorder" on page 636
C
• ":CALibrate:DATE" on page 221
• ":CALibrate:LABel" on page 222
• ":CALibrate:OUTPut" on page 223
• ":CALibrate:STARt" on page 224
• ":CALibrate:STATus" on page 225
• ":CALibrate:SWITch" on page 226
• ":CALibrate:TEMPerature" on page 227
• ":CALibrate:TIME" on page 228
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
667
6
Commands A-Z
• CAN Commands:
• ":SBUS:CAN:COUNt:ERRor" on page 434
• ":SBUS:CAN:COUNt:OVERload" on page 435
• ":SBUS:CAN:COUNt:RESet" on page 436
• ":SBUS:CAN:COUNt:TOTal" on page 437
• ":SBUS:CAN:COUNt:UTILization" on page 438
• ":TRIGger:CAN Commands" on page 490
• CCBASe, ":TRIGger:FLEXray:FRAMe:CCBase" on page 523
• CCRepetition, ":TRIGger:FLEXray:FRAMe:CCRepetition" on page 524
• ":CDISplay" on page 161
• CENTer, ":FUNCtion:CENTer" on page 279
• CHANnel, ":TRIGger:FLEXray:CHANnel" on page 520
• ":CHANnel:ACTivity" on page 705
• ":CHANnel:LABel" on page 706
• ":CHANnel:THReshold" on page 707
• ":CHANnel2:SKEW" on page 708
• ":CHANnel<n>:BWLimit" on page 232
• ":CHANnel<n>:COUPling" on page 233
• ":CHANnel<n>:DISPlay" on page 234
• ":CHANnel<n>:IMPedance" on page 235
• ":CHANnel<n>:INPut" on page 709
• ":CHANnel<n>:INVert" on page 236
• ":CHANnel<n>:LABel" on page 237
• ":CHANnel<n>:OFFSet" on page 238
• ":CHANnel<n>:PMODe" on page 710
• ":CHANnel<n>:PROBe" on page 239
• ":CHANnel<n>:PROBe:HEAD[:TYPE]" on page 240
• ":CHANnel<n>:PROBe:ID" on page 241
• ":CHANnel<n>:PROBe:SKEW" on page 242
• ":CHANnel<n>:PROBe:STYPe" on page 243
• ":CHANnel<n>:PROTection" on page 244
• ":CHANnel<n>:RANGe" on page 245
• ":CHANnel<n>:SCALe" on page 246
• ":CHANnel<n>:UNITs" on page 247
• ":CHANnel<n>:VERNier" on page 248
668
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• CLEar Commands:
• ":BUS<n>:CLEar" on page 215
• ":DISPlay:CLEar" on page 258
• ":MEASure:CLEar" on page 326
• CLOCk Commands:
• ":TRIGger:IIC[:SOURce]:CLOCk" on page 560
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:SOURce:CLOCk" on page 549
• ":TRIGger:SPI:CLOCk:SLOPe" on page 594
• ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• "*CLS (Clear Status)" on page 129
• COMPlete, ":ACQuire:COMPlete" on page 196
• CONDition, ":HWERegister:CONDition (Hardware Event Condition
Register)" on page 166
• CONNect, ":DISPlay:CONNect" on page 711
• COUNt Commands:
• ":ACQuire:COUNt" on page 197
• ":ACQuire:SEGMented:COUNt" on page 203
• ":MTESt:AVERage:COUNt" on page 741
• ":MTESt:COUNt:FWAVeforms" on page 380
• ":MTESt:COUNt:RESet" on page 381
• ":MTESt:COUNt:TIME" on page 382
• ":MTESt:COUNt:WAVeforms" on page 383
• ":SBUS:CAN:COUNt:ERRor" on page 434
• ":SBUS:CAN:COUNt:OVERload" on page 435
• ":SBUS:CAN:COUNt:RESet" on page 436
• ":SBUS:CAN:COUNt:TOTal" on page 437
• ":SBUS:CAN:COUNt:UTILization" on page 438
• ":SBUS:FLEXray:COUNt:NULL" on page 440
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• ":SBUS:FLEXray:COUNt:SYNC" on page 442
• ":SBUS:FLEXray:COUNt:TOTal" on page 443
• ":SBUS:UART:COUNt:ERRor" on page 452
• ":SBUS:UART:COUNt:RESet" on page 453
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
669
6
Commands A-Z
• ":SBUS:UART:COUNt:RXFRames" on page 454
• ":SBUS:UART:COUNt:TXFRames" on page 455
• ":TRIGger:EBURst:COUNt" on page 508
• ":TRIGger:SEQuence:COUNt" on page 586
• ":WAVeform:COUNt" on page 637
• ":WAVeform:SEGMented:COUNt" on page 648
• COUNter, ":MEASure:COUNter" on page 327
• COUPling Commands:
• ":CHANnel<n>:COUPling" on page 233
• ":TRIGger[:EDGE]:COUPling" on page 512
• CREate, ":MTESt:AMASk:CREate" on page 375
D
• DAALias, ":ACQuire:DAALias" on page 198
• DATA Commands:
• ":DISPlay:DATA" on page 259
• ":LISTer:DATA" on page 305
• ":MTESt:DATA" on page 384
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:I2S:PATTern:DATA" on page 543
• ":TRIGger:I2S:SOURce:DATA" on page 550
• ":TRIGger:IIC:PATTern:DATA" on page 558
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:IIC[:SOURce]:DATA" on page 561
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
• ":TRIGger:M1553:PATTern:DATA" on page 580
• ":TRIGger:SPI:PATTern:DATA" on page 597
• ":TRIGger:SPI:SOURce:DATA" on page 600
• ":TRIGger:UART:DATA" on page 614
• ":WAVeform:DATA" on page 638
• DATE Commands:
• ":CALibrate:DATE" on page 221
• ":SYSTem:DATE" on page 458
• DEFine, ":MEASure:DEFine" on page 328
• DEFinition Commands:
670
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• DELay Commands:
• ":MEASure:DELay" on page 331
• ":TIMebase:DELay" on page 749
• DELete, ":MTESt:DELete" on page 385
• DESTination, ":HARDcopy:DESTination" on page 718
• DEVice, ":HARDcopy:DEVice" on page 719
• ":DIGital<n>:DISPlay" on page 251
• ":DIGital<n>:LABel" on page 252
• ":DIGital<n>:POSition" on page 253
• ":DIGital<n>:SIZE" on page 254
• ":DIGital<n>:THReshold" on page 255
• ":DIGitize" on page 162
• DISPlay Commands:
• ":BUS<n>:DISPlay" on page 216
• ":CHANnel<n>:DISPlay" on page 234
• ":DIGital<n>:DISPlay" on page 251
• ":FUNCtion:DISPlay" on page 280
• ":LISTer:DISPlay" on page 306
• ":POD<n>:DISPlay" on page 405
• ":SBUS:DISPlay" on page 439
• ":DISPlay:CLEar" on page 258
• ":DISPlay:CONNect" on page 711
• ":DISPlay:DATA" on page 259
• ":DISPlay:LABel" on page 261
• ":DISPlay:LABList" on page 262
• ":DISPlay:ORDer" on page 712
• ":DISPlay:PERSistence" on page 263
• ":DISPlay:SOURce" on page 264
• ":DISPlay:VECTors" on page 265
• DMINus, ":TRIGger:USB:SOURce:DMINus" on page 624
• DPLus, ":TRIGger:USB:SOURce:DPLus" on page 625
• DSP, ":SYSTem:DSP" on page 459
• DURation, ":TRIGger:DURation Commands" on page 501
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
671
6
Commands A-Z
• DUTYcycle, ":MEASure:DUTYcycle" on page 333
E
• EBURst, ":TRIGger:EBURst Commands" on page 507
• EDGE Commands:
• ":TRIGger[:EDGE] Commands" on page 511
• ":TRIGger:SEQuence:EDGE" on page 587
• ENABle":MTESt:ENABle" on page 386
• ":ERASe" on page 713
• ERRor Commands:
• ":SBUS:CAN:COUNt:ERRor" on page 434
• ":SBUS:UART:COUNt:ERRor" on page 452
• ":SYSTem:ERRor" on page 460
• ":TRIGger:FLEXray:ERRor:TYPE" on page 521
• "*ESE (Standard Event Status Enable)" on page 130
• "*ESR (Standard Event Status Register)" on page 132
• EVENt Commands:
• ":HWERegister[:EVENt] (Hardware Event Event Register)" on
page 168
• ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 173
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":EXTernal:BWLimit" on page 268
• ":EXTernal:IMPedance" on page 269
• ":EXTernal:INPut" on page 714
• ":EXTernal:PMODe" on page 715
• ":EXTernal:PROBe" on page 270
• ":EXTernal:PROBe:ID" on page 271
• ":EXTernal:PROBe:STYPe" on page 272
• ":EXTernal:PROTection" on page 273
• ":EXTernal:RANGe" on page 274
• ":EXTernal:UNITs" on page 275
F
• FACTion Commands:
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":MTESt:RMODe:FACTion:STOP" on page 393
• FACTors Commands:
672
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":HARDcopy:FACTors" on page 297
• ":SAVE:IMAGe:FACTors" on page 420
• FALLtime, ":MEASure:FALLtime" on page 334
• FFEed, ":HARDcopy:FFEed" on page 298
• FILename Commands:
• ":HARDcopy:FILename" on page 720
• ":RECall:FILename" on page 410
• ":SAVE:FILename" on page 417
• FIND, ":TRIGger:SEQuence:FIND" on page 588
• FLEXray Commands:
• ":SBUS:FLEXray:COUNt:NULL" on page 440
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• ":SBUS:FLEXray:COUNt:SYNC" on page 442
• ":SBUS:FLEXray:COUNt:TOTal" on page 443
• ":TRIGger:FLEXray:AUTosetup" on page 518
• ":TRIGger:FLEXray:BAUDrate" on page 519
• ":TRIGger:FLEXray:CHANnel" on page 520
• ":TRIGger:FLEXray:ERRor:TYPE" on page 521
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":TRIGger:FLEXray:FRAMe:CCBase" on page 523
• ":TRIGger:FLEXray:FRAMe:CCRepetition" on page 524
• ":TRIGger:FLEXray:FRAMe:ID" on page 525
• ":TRIGger:FLEXray:FRAMe:TYPE" on page 526
• ":TRIGger:FLEXray:SOURce" on page 527
• ":TRIGger:FLEXray:TRIGger" on page 528
• FORMat Commands:
• ":HARDcopy:FORMat" on page 721
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:WAVeform:FORMat" on page 429
• ":TRIGger:I2S:PATTern:FORMat" on page 545
• ":TRIGger:LIN:PATTern:FORMat" on page 571
• ":WAVeform:FORMat" on page 640
• FRAMe Commands:
• ":TRIGger:FLEXray:FRAMe:CCBase" on page 523
• ":TRIGger:FLEXray:FRAMe:CCRepetition" on page 524
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
673
6
Commands A-Z
• ":TRIGger:FLEXray:FRAMe:ID" on page 525
• ":TRIGger:FLEXray:FRAMe:TYPE" on page 526
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
• FRAMing Commands:
• ":SBUS:UART:FRAMing" on page 456
• ":TRIGger:SPI:FRAMing" on page 596
• FREQuency, ":MEASure:FREQuency" on page 335
• ":FUNCtion:CENTer" on page 279
• ":FUNCtion:DISPlay" on page 280
• ":FUNCtion:GOFT:OPERation" on page 281
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:GOFT:SOURce2" on page 283
• ":FUNCtion:OFFSet" on page 284
• ":FUNCtion:OPERation" on page 285
• ":FUNCtion:RANGe" on page 286
• ":FUNCtion:REFerence" on page 287
• ":FUNCtion:SCALe" on page 288
• ":FUNCtion:SOURce" on page 716
• ":FUNCtion:SOURce1" on page 289
• ":FUNCtion:SOURce2" on page 290
• ":FUNCtion:SPAN" on page 291
• ":FUNCtion:VIEW" on page 717
• ":FUNCtion:WINDow" on page 292
• FWAVeforms, ":MTESt:COUNt:FWAVeforms" on page 380
G
• GLITch (Pulse Width), ":TRIGger:GLITch Commands" on page 529
• GOFT Commands:
• ":FUNCtion:GOFT:OPERation" on page 281
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:GOFT:SOURce2" on page 283
• GRAYscale, ":HARDcopy:GRAYscale" on page 722
• GREaterthan Commands:
• ":TRIGger:DURation:GREaterthan" on page 502
• ":TRIGger:GLITch:GREaterthan" on page 531
H
674
• ":HARDcopy:AREA" on page 295
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
6
Commands A-Z
• ":HARDcopy:APRinter" on page 296
• ":HARDcopy:DESTination" on page 718
• ":HARDcopy:DEVice" on page 719
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:FFEed" on page 298
• ":HARDcopy:FILename" on page 720
• ":HARDcopy:FORMat" on page 721
• ":HARDcopy:GRAYscale" on page 722
• ":HARDcopy:IGColors" on page 723
• ":HARDcopy:INKSaver" on page 299
• ":HARDcopy:LAYout" on page 300
• ":HARDcopy:PALette" on page 301
• ":HARDcopy:PDRiver" on page 724
• ":HARDcopy:PRINter:LIST" on page 302
• ":HARDcopy:STARt" on page 303
• HEAD, ":CHANnel<n>:PROBe:HEAD[:TYPE]" on page 240
• HFReject, ":TRIGger:HFReject" on page 483
• HOLDoff, ":TRIGger:HOLDoff" on page 484
• ":HWEenable (Hardware Event Enable Register)" on page 164
• ":HWERegister:CONDition (Hardware Event Condition Register)" on
page 166
• ":HWERegister[:EVENt] (Hardware Event Event Register)" on page 168
I
• ID Commands:
• ":TRIGger:CAN:PATTern:ID" on page 494
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:FLEXray:FRAMe:ID" on page 525
• IDLE Commands:
• ":TRIGger:EBURst:IDLE" on page 509
• ":TRIGger:UART:IDLE" on page 615
• "*IDN (Identification Number)" on page 134
• I2S Commands:
• ":SBUS:I2S:BASE" on page 444
• ":TRIGger:I2S Commands" on page 538
• IIC Commands:
• ":SBUS:IIC:ASIZe" on page 445
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
675
6
Commands A-Z
• ":TRIGger:IIC Commands" on page 556
• IGColors Commands:
• ":HARDcopy:IGColors" on page 723
• ":SAVE:IMAGe:INKSaver" on page 422
• IMAGe Commands:
• ":RECall:IMAGe[:STARt]" on page 411
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
• ":SAVE:IMAGe[:STARt]" on page 418
• IMPedance Commands:
• ":CHANnel<n>:IMPedance" on page 235
• ":EXTernal:IMPedance" on page 269
• INCRement, ":MEASure:STATistics:INCRement" on page 352
• INDex, ":ACQuire:SEGMented:INDex" on page 204
• INKSaver, ":HARDcopy:INKSaver" on page 299
• INVert, ":CHANnel<n>:INVert" on page 236
L
• LABel Commands:
• ":BUS<n>:LABel" on page 217
• ":CALibrate:LABel" on page 222
• ":CHANnel:LABel" on page 706
• ":CHANnel<n>:LABel" on page 237
• ":DIGital<n>:LABel" on page 252
• ":DISPlay:LABel" on page 261
• LABList, ":DISPlay:LABList" on page 262
• LAYout, ":HARDcopy:LAYout" on page 300
• LENGth Commands:
• ":SAVE:WAVeform:LENGth" on page 430
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
• LESSthan Commands:
• ":TRIGger:DURation:LESSthan" on page 503
• ":TRIGger:GLITch:LESSthan" on page 532
676
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• LEVel Commands:
• ":TRIGger[:EDGE]:LEVel" on page 513
• ":TRIGger:GLITch:LEVel" on page 533
• LIN Commands:
• ":SBUS:LIN:PARity" on page 446
• ":TRIGger:LIN Commands" on page 565
• LINE, ":TRIGger:TV:LINE" on page 603
• LIST, ":HARDcopy:PRINter:LIST" on page 302
• LISTer Commands:
• ":LISTer:DATA" on page 305
• ":LISTer:DISPlay" on page 306
• ":SAVE:LISTer[:STARt]" on page 424
• LOAD, ":MTESt:LOAD" on page 742
• LOCK Commands:
• ":MTESt:LOCK" on page 387
• ":SYSTem:LOCK" on page 461
• ":SYSTem:PROTection:LOCK" on page 463
• LOWer Commands:
• ":MEASure:LOWer" on page 725
• ":TRIGger:M1553:SOURce:LOWer" on page 582
• "*LRN (Learn Device Setup)" on page 135
M
• M1553 Commands:
• ":SBUS:M1553:BASE" on page 447
• ":TRIGger:M1553 Commands" on page 578
• ":MARKer:MODE" on page 309
• ":MARKer:X1Position" on page 310
• ":MARKer:X1Y1source" on page 311
• ":MARKer:X2Position" on page 312
• ":MARKer:X2Y2source" on page 313
• ":MARKer:XDELta" on page 314
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
• ":MARKer:YDELta" on page 317
• MASK Commands:
• ":BUS<n>:MASK" on page 218
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
677
6
Commands A-Z
• ":RECall:MASK[:STARt]" on page 412
• ":SAVE:MASK[:STARt]" on page 425
• ":MEASure:CLEar" on page 326
• ":MEASure:COUNter" on page 327
• ":MEASure:DEFine" on page 328
• ":MEASure:DELay" on page 331
• ":MEASure:DUTYcycle" on page 333
• ":MEASure:FALLtime" on page 334
• ":MEASure:FREQuency" on page 335
• ":MEASure:LOWer" on page 725
• ":MEASure:NWIDth" on page 336
• ":MEASure:OVERshoot" on page 337
• ":MEASure:PERiod" on page 339
• ":MEASure:PHASe" on page 340
• ":MEASure:PREShoot" on page 341
• ":MEASure:PWIDth" on page 342
• ":MEASure:RESults" on page 343
• ":MEASure:RISetime" on page 346
• ":MEASure:SCRatch" on page 726
• ":MEASure:SDEViation" on page 347
• ":MEASure:SHOW" on page 348
• ":MEASure:SOURce" on page 349
• ":MEASure:STATistics" on page 351
• ":MEASure:STATistics:INCRement" on page 352
• ":MEASure:STATistics:RESet" on page 353
• ":MEASure:TDELta" on page 727
• ":MEASure:TEDGe" on page 354
• ":MEASure:THResholds" on page 728
• ":MEASure:TMAX" on page 729
• ":MEASure:TMIN" on page 730
• ":MEASure:TSTArt" on page 731
• ":MEASure:TSTOp" on page 732
• ":MEASure:TVALue" on page 356
• ":MEASure:TVOLt" on page 733
• ":MEASure:UPPer" on page 735
678
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
6
Commands A-Z
• ":MEASure:VAMPlitude" on page 358
• ":MEASure:VAVerage" on page 359
• ":MEASure:VBASe" on page 360
• ":MEASure:VDELta" on page 736
• ":MEASure:VMAX" on page 361
• ":MEASure:VMIN" on page 362
• ":MEASure:VPP" on page 363
• ":MEASure:VRATio" on page 364
• ":MEASure:VRMS" on page 365
• ":MEASure:VSTArt" on page 737
• ":MEASure:VSTOp" on page 738
• ":MEASure:VTIMe" on page 366
• ":MEASure:VTOP" on page 367
• ":MEASure:XMAX" on page 368
• ":MEASure:XMIN" on page 369
• MEASure, ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MERGe" on page 170
• MODE Commands:
• ":ACQuire:MODE" on page 199
• ":MARKer:MODE" on page 309
• ":SBUS:MODE" on page 448
• ":TIMebase:MODE" on page 469
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:MODE" on page 485
• ":TRIGger:TV:MODE" on page 604
• ":WAVeform:POINts:MODE" on page 643
• ":MTEenable (Mask Test Event Enable Register)" on page 171
• ":MTERegister[:EVENt] (Mask Test Event Event Register)" on page 173
• ":MTESt:AMASk:CREate" on page 375
• ":MTESt:AMASk:{SAVE | STORe}" on page 739
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:AMASk:UNITs" on page 377
• ":MTESt:AMASk:XDELta" on page 378
• ":MTESt:AMASk:YDELta" on page 379
• ":MTESt:AVERage" on page 740
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
679
6
Commands A-Z
• ":MTESt:AVERage:COUNt" on page 741
• ":MTESt:COUNt:FWAVeforms" on page 380
• ":MTESt:COUNt:RESet" on page 381
• ":MTESt:COUNt:TIME" on page 382
• ":MTESt:COUNt:WAVeforms" on page 383
• ":MTESt:DATA" on page 384
• ":MTESt:DELete" on page 385
• ":MTESt:ENABle" on page 386
• ":MTESt:LOAD" on page 742
• ":MTESt:LOCK" on page 387
• ":MTESt:OUTPut" on page 388
• ":MTESt:RMODe" on page 389
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":MTESt:RMODe:FACTion:STOP" on page 393
• ":MTESt:RMODe:SIGMa" on page 394
• ":MTESt:RMODe:TIME" on page 395
• ":MTESt:RMODe:WAVeforms" on page 396
• ":MTESt:RUMode" on page 743
• ":MTESt:RUMode:SOFailure" on page 744
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y1" on page 400
• ":MTESt:SCALe:Y2" on page 401
• ":MTESt:SOURce" on page 402
• ":MTESt:{STARt | STOP}" on page 745
• ":MTESt:TITLe" on page 403
• ":MTESt:TRIGger:SOURce" on page 746
N
• NREJect, ":TRIGger:NREJect" on page 486
• NULL, ":SBUS:FLEXray:COUNt:NULL" on page 440
• NWIDth, ":MEASure:NWIDth" on page 336
O
680
• OFFSet Commands:
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
6
Commands A-Z
• ":CHANnel<n>:OFFSet" on page 238
• ":FUNCtion:OFFSet" on page 284
• "*OPC (Operation Complete)" on page 136
• ":OPEE (Operation Status Enable Register)" on page 175
• OPERation Commands:
• ":FUNCtion:GOFT:OPERation" on page 281
• ":FUNCtion:OPERation" on page 285
• ":OPERegister:CONDition (Operation Status Condition Register)" on
page 177
• ":OPERegister[:EVENt] (Operation Status Event Register)" on page 179
• "*OPT (Option Identification)" on page 137
• ORDer, ":DISPlay:ORDer" on page 712
• OUTPut Commands:
• ":CALibrate:OUTPut" on page 223
• ":MTESt:OUTPut" on page 388
• OVERload, ":SBUS:CAN:COUNt:OVERload" on page 435
• OVERshoot, ":MEASure:OVERshoot" on page 337
• ":OVLenable (Overload Event Enable Register)" on page 181
• ":OVLRegister (Overload Event Register)" on page 183
P
• PALette Commands:
• ":HARDcopy:PALette" on page 301
• ":SAVE:IMAGe:PALette" on page 423
• PARity Commands:
• ":SBUS:LIN:PARity" on page 446
• ":TRIGger:UART:PARity" on page 616
• PATTern Commands:
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:CAN:PATTern:ID" on page 494
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:DURation:PATTern" on page 504
• ":TRIGger:I2S:PATTern:DATA" on page 543
• ":TRIGger:I2S:PATTern:FORMat" on page 545
• ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":TRIGger:IIC:PATTern:DATA" on page 558
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
681
6
Commands A-Z
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
• ":TRIGger:LIN:PATTern:FORMat" on page 571
• ":TRIGger:M1553:PATTern:DATA" on page 580
• ":TRIGger:PATTern" on page 487
• ":TRIGger:SEQuence:PATTern" on page 589
• ":TRIGger:SPI:PATTern:DATA" on page 597
• ":TRIGger:SPI:PATTern:WIDTh" on page 598
• PDRiver, ":HARDcopy:PDRiver" on page 724
• PERiod, ":MEASure:PERiod" on page 339
• PERSistence, ":DISPlay:PERSistence" on page 263
• PHASe, ":MEASure:PHASe" on page 340
• PMODe, ":CHANnel<n>:PMODe" on page 710
• ":POD<n>:DISPlay" on page 405
• ":POD<n>:SIZE" on page 406
• ":POD<n>:THReshold" on page 407
• POINts Commands:
• ":ACQuire:POINts" on page 200
• ":WAVeform:POINts" on page 641
• ":WAVeform:POINts:MODE" on page 643
• POLarity Commands:
• ":TRIGger:GLITch:POLarity" on page 534
• ":TRIGger:TV:POLarity" on page 605
• ":TRIGger:UART:POLarity" on page 617
• POSition Commands:
• ":DIGital<n>:POSition" on page 253
• ":TIMebase:POSition" on page 470
• ":TIMebase:WINDow:POSition" on page 476
• PREamble, ":WAVeform:PREamble" on page 645
• PRECision, ":SYSTem:PRECision" on page 462
• PREShoot, ":MEASure:PREShoot" on page 341
• PRINt, ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":PRINt" on page 185
• ":PRINt?" on page 747
682
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• PRINter, ":HARDcopy:PRINter:LIST" on page 302
• PROBe Commands:
• ":CHANnel<n>:PROBe" on page 239
• ":CHANnel<n>:PROBe:HEAD[:TYPE]" on page 240
• ":CHANnel<n>:PROBe:ID" on page 241
• ":CHANnel<n>:PROBe:SKEW" on page 242
• ":CHANnel<n>:PROBe:STYPe" on page 243
• ":EXTernal:PROBe" on page 270
• PROTection Commands:
• ":CHANnel<n>:PROTection" on page 244
• ":EXTernal:PROTection" on page 273
• ":SYSTem:PROTection:LOCK" on page 463
• Pulse Width (GLITch), ":TRIGger:GLITch Commands" on page 529
• PWD Commands:
• ":RECall:PWD" on page 413
• ":SAVE:PWD" on page 426
• PWIDth, ":MEASure:PWIDth" on page 342
Q
• QUALifier Commands:
• ":TRIGger:DURation:QUALifier" on page 505
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:IIC:TRIGger:QUALifier" on page 562
• ":TRIGger:UART:QUALifier" on page 618
R
• RANGe Commands:
• ":CHANnel<n>:RANGe" on page 245
• ":EXTernal:RANGe" on page 274
• ":FUNCtion:RANGe" on page 286
• ":TIMebase:RANGe" on page 471
• ":TIMebase:WINDow:RANGe" on page 477
• ":TRIGger:DURation:RANGe" on page 506
• ":TRIGger:GLITch:RANGe" on page 536
• ":TRIGger:I2S:RANGe" on page 546
• "*RCL (Recall)" on page 139
• ":RECall:FILename" on page 410
• ":RECall:IMAGe[:STARt]" on page 411
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
683
6
Commands A-Z
• ":RECall:MASK[:STARt]" on page 412
• ":RECall:PWD" on page 413
• ":RECall:SETup[:STARt]" on page 414
• REFClock, ":TIMebase:REFClock" on page 472
• REFerence Commands:
• ":FUNCtion:REFerence" on page 287
• ":TIMebase:REFerence" on page 473
• REJect, ":TRIGger[:EDGE]:REJect" on page 514
• RESet Commands:
• ":MEASure:STATistics:RESet" on page 353
• ":MTESt:COUNt:RESet" on page 381
• ":SBUS:CAN:COUNt:RESet" on page 436
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• ":SBUS:UART:COUNt:RESet" on page 453
• ":TRIGger:SEQuence:RESet" on page 590
• RESults, ":MEASure:RESults" on page 343
• RISetime, ":MEASure:RISetime" on page 346
• RMODe Commands:
• ":MTESt:RMODe" on page 389
• ":MTESt:RMODe:FACTion:MEASure" on page 390
• ":MTESt:RMODe:FACTion:PRINt" on page 391
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":MTESt:RMODe:FACTion:STOP" on page 393
• ":MTESt:RMODe:SIGMa" on page 394
• ":MTESt:RMODe:TIME" on page 395
• ":MTESt:RMODe:WAVeforms" on page 396
• "Root (:) Commands" on page 151
• RSIGnal, ":ACQuire:RSIGnal" on page 201
• "*RST (Reset)" on page 140
• RTA, ":TRIGger:M1553:RTA" on page 581
• RUMode Commands:
• ":MTESt:RUMode" on page 743
• ":MTESt:RUMode:SOFailure" on page 744
• ":RUN" on page 186
• RWIDth, ":TRIGger:I2S:RWIDth" on page 548
684
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• RX, ":TRIGger:UART:SOURce:RX" on page 619
• RXFRames, ":SBUS:UART:COUNt:RXFRames" on page 454
S
• SAMPlepoint Commands:
• ":TRIGger:CAN:SAMPlepoint" on page 496
• ":TRIGger:LIN:SAMPlepoint" on page 572
• "*SAV (Save)" on page 143
• SAVE Commands:
• ":MTESt:AMASk:{SAVE | STORe}" on page 739
• ":MTESt:RMODe:FACTion:SAVE" on page 392
• ":SAVE:FILename" on page 417
• ":SAVE:IMAGe:AREA" on page 419
• ":SAVE:IMAGe:FACTors" on page 420
• ":SAVE:IMAGe:FORMat" on page 421
• ":SAVE:IMAGe:INKSaver" on page 422
• ":SAVE:IMAGe:PALette" on page 423
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:LISTer[:STARt]" on page 424
• ":SAVE:MASK[:STARt]" on page 425
• ":SAVE:PWD" on page 426
• ":SAVE:SETup[:STARt]" on page 427
• ":SAVE:WAVeform:FORMat" on page 429
• ":SAVE:WAVeform:LENGth" on page 430
• ":SAVE:WAVeform:SEGMented" on page 431
• ":SAVE:WAVeform[:STARt]" on page 428
• ":SBUS:CAN:COUNt:ERRor" on page 434
• ":SBUS:CAN:COUNt:OVERload" on page 435
• ":SBUS:CAN:COUNt:RESet" on page 436
• ":SBUS:CAN:COUNt:TOTal" on page 437
• ":SBUS:CAN:COUNt:UTILization" on page 438
• ":SBUS:DISPlay" on page 439
• ":SBUS:FLEXray:COUNt:NULL" on page 440
• ":SBUS:FLEXray:COUNt:RESet" on page 441
• ":SBUS:FLEXray:COUNt:SYNC" on page 442
• ":SBUS:FLEXray:COUNt:TOTal" on page 443
• ":SBUS:I2S:BASE" on page 444
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
685
6
Commands A-Z
• ":SBUS:IIC:ASIZe" on page 445
• ":SBUS:LIN:PARity" on page 446
• ":SBUS:M1553:BASE" on page 447
• ":SBUS:MODE" on page 448
• ":SBUS:SPI:BITorder" on page 449
• ":SBUS:SPI:WIDTh" on page 450
• ":SBUS:UART:BASE" on page 451
• ":SBUS:UART:COUNt:ERRor" on page 452
• ":SBUS:UART:COUNt:RESet" on page 453
• ":SBUS:UART:COUNt:RXFRames" on page 454
• ":SBUS:UART:COUNt:TXFRames" on page 455
• ":SBUS:UART:FRAMing" on page 456
• SCALe Commands:
• ":CHANnel<n>:SCALe" on page 246
• ":FUNCtion:SCALe" on page 288
• ":MTESt:SCALe:BIND" on page 397
• ":MTESt:SCALe:X1" on page 398
• ":MTESt:SCALe:XDELta" on page 399
• ":MTESt:SCALe:Y1" on page 400
• ":MTESt:SCALe:Y2" on page 401
• ":TIMebase:SCALe" on page 474
• ":TIMebase:WINDow:SCALe" on page 478
• SCRatch, ":MEASure:SCRatch" on page 726
• SDEViation, ":MEASure:SDEViation" on page 347
• ":SERial" on page 187
• SEGMented Commands:
• ":ACQuire:SEGMented:ANALyze" on page 202
• ":ACQuire:SEGMented:COUNt" on page 203
• ":ACQuire:SEGMented:INDex" on page 204
• ":SAVE:WAVeform:SEGMented" on page 431
• ":WAVeform:SEGMented:COUNt" on page 648
• ":WAVeform:SEGMented:TTAG" on page 649
• SETup Commands:
• ":RECall:SETup[:STARt]" on page 414
• ":SAVE:SETup[:STARt]" on page 427
686
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":SYSTem:SETup" on page 464
• SEQuence, ":TRIGger:SEQuence Commands" on page 585
• SHOW, ":MEASure:SHOW" on page 348
• SIGMa, ":MTESt:RMODe:SIGMa" on page 394
• SIGNal Commands:
• ":TRIGger:CAN:SIGNal:BAUDrate" on page 497
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
• ":TRIGger:LIN:SIGNal:BAUDrate" on page 573
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":SINGle" on page 188
• SIZE Commands:
• ":DIGital<n>:SIZE" on page 254
• ":POD<n>:SIZE" on page 406
• SKEW, ":CHANnel<n>:PROBe:SKEW" on page 242
• SLOPe Commands:
• ":TRIGger:EBURst:SLOPe" on page 510
• ":TRIGger[:EDGE]:SLOPe" on page 515
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:SPI:CLOCk:SLOPe" on page 594
• SOFailure, ":MTESt:RUMode:SOFailure" on page 744
• SOURce Commands:
• ":DISPlay:SOURce" on page 264
• ":FUNCtion:SOURce" on page 716
• ":MEASure:SOURce" on page 349
• ":MTESt:AMASk:SOURce" on page 376
• ":MTESt:SOURce" on page 402
• ":MTESt:TRIGger:SOURce" on page 746
• ":TRIGger:CAN:SOURce" on page 498
• ":TRIGger:FLEXray:SOURce" on page 527
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:I2S:SOURce:CLOCk" on page 549
• ":TRIGger:I2S:SOURce:DATA" on page 550
• ":TRIGger:I2S:SOURce:WSELect" on page 551
• ":TRIGger:IIC[:SOURce]:CLOCk" on page 560
• ":TRIGger:IIC[:SOURce]:DATA" on page 561
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
687
6
Commands A-Z
• ":TRIGger:LIN:SOURce" on page 574
• ":TRIGger:M1553:SOURce:LOWer" on page 582
• ":TRIGger:M1553:SOURce:UPPer" on page 583
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• ":TRIGger:SPI:SOURce:DATA" on page 600
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
• ":TRIGger:TV:SOURce" on page 606
• ":TRIGger:UART:SOURce:RX" on page 619
• ":TRIGger:UART:SOURce:TX" on page 620
• ":TRIGger:USB:SOURce:DMINus" on page 624
• ":TRIGger:USB:SOURce:DPLus" on page 625
• ":WAVeform:SOURce" on page 650
• ":WAVeform:SOURce:SUBSource" on page 654
• SOURce1 Commands:
• ":FUNCtion:GOFT:SOURce1" on page 282
• ":FUNCtion:SOURce1" on page 289
• SOURce2 Commands:
• ":FUNCtion:GOFT:SOURce2" on page 283
• ":FUNCtion:SOURce2" on page 290
• SPAN, ":FUNCtion:SPAN" on page 291
• SPEed, ":TRIGger:USB:SPEed" on page 626
• SPI Commands:
• ":SBUS:SPI:BITorder" on page 449
• ":SBUS:SPI:WIDTh" on page 450
• ":TRIGger:SPI Commands" on page 593
• SRATe, ":ACQuire:SRATe" on page 207
• "*SRE (Service Request Enable)" on page 144
• STANdard Commands:
• ":TRIGger:LIN:STANdard" on page 575
• ":TRIGger:TV:STANdard" on page 607
• STARt Commands:
• ":CALibrate:STARt" on page 224
• ":HARDcopy:STARt" on page 303
• ":MTESt:{STARt | STOP}" on page 745
• ":RECall:IMAGe[:STARt]" on page 411
688
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":RECall:MASK[:STARt]" on page 412
• ":RECall:SETup[:STARt]" on page 414
• ":SAVE:IMAGe[:STARt]" on page 418
• ":SAVE:LISTer[:STARt]" on page 424
• ":SAVE:MASK[:STARt]" on page 425
• ":SAVE:SETup[:STARt]" on page 427
• ":SAVE:WAVeform[:STARt]" on page 428
• STATistics Commands:
• ":MEASure:STATistics" on page 351
• ":MEASure:STATistics:INCRement" on page 352
• ":MEASure:STATistics:RESet" on page 353
• STATus Commands:
• ":CALibrate:STATus" on page 225
• ":STATus" on page 189
• "*STB (Read Status Byte)" on page 146
• STOP Commands:
• ":MTESt:RMODe:FACTion:STOP" on page 393
• ":MTESt:{STARt | STOP}" on page 745
• ":STOP" on page 190
• STORe, ":MTESt:AMASk:{SAVE | STORe}" on page 739
• SUBSource, ":WAVeform:SOURce:SUBSource" on page 654
• SWEep, ":TRIGger:SWEep" on page 489
• SWITch, ":CALibrate:SWITch" on page 226
• SYNC, ":SBUS:FLEXray:COUNt:SYNC" on page 442
• SYNCbreak, ":TRIGger:LIN:SYNCbreak" on page 576
• ":SYSTem:DATE" on page 458
• ":SYSTem:DSP" on page 459
• ":SYSTem:ERRor" on page 460
• ":SYSTem:LOCK" on page 461
• ":SYSTem:PRECision" on page 462
• ":SYSTem:SETup" on page 464
• ":SYSTem:TIME" on page 466
T
• TDELta, ":MEASure:TDELta" on page 727
• TEDGe, ":MEASure:TEDGe" on page 354
• TEMPerature, ":CALibrate:TEMPerature" on page 227
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
689
6
Commands A-Z
• ":TER (Trigger Event Register)" on page 191
• THReshold Commands:
• ":CHANnel:THReshold" on page 707
• ":DIGital<n>:THReshold" on page 255
• ":MEASure:THResholds" on page 728
• ":POD<n>:THReshold" on page 407
• ":TRIGger:THReshold" on page 753
• THResholds, ":MEASure:THResholds" on page 728
• TIME Commands:
• ":CALibrate:TIME" on page 228
• ":MTESt:COUNt:TIME" on page 382
• ":MTESt:RMODe:TIME" on page 395
• ":SYSTem:TIME" on page 466
• ":TIMebase:DELay" on page 749
• ":TIMebase:MODE" on page 469
• ":TIMebase:POSition" on page 470
• ":TIMebase:RANGe" on page 471
• ":TIMebase:REFClock" on page 472
• ":TIMebase:REFerence" on page 473
• ":TIMebase:SCALe" on page 474
• ":TIMebase:VERNier" on page 475
• ":TIMebase:WINDow:POSition" on page 476
• ":TIMebase:WINDow:RANGe" on page 477
• ":TIMebase:WINDow:SCALe" on page 478
• TIMeout, ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• TIMer, ":TRIGger:SEQuence:TIMer" on page 591
• TITLe, ":MTESt:TITLe" on page 403
• TMAX, ":MEASure:TMAX" on page 729
• TMIN, ":MEASure:TMIN" on page 730
• TOTal Commands:
• ":SBUS:CAN:COUNt:TOTal" on page 437
• ":SBUS:FLEXray:COUNt:TOTal" on page 443
• "*TRG (Trigger)" on page 148
• TRIGger Commands:
• ":MTESt:TRIGger:SOURce" on page 746
690
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":TRIGger:CAN:TRIGger" on page 499
• ":TRIGger:FLEXray:TRIGger" on page 528
• ":TRIGger:I2S:TRIGger" on page 552
• ":TRIGger:IIC:TRIGger:QUALifier" on page 562
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:USB:TRIGger" on page 627
• ":TRIGger:HFReject" on page 483
• ":TRIGger:HOLDoff" on page 484
• ":TRIGger:MODE" on page 485
• ":TRIGger:NREJect" on page 486
• ":TRIGger:PATTern" on page 487
• ":TRIGger:SWEep" on page 489
• ":TRIGger:THReshold" on page 753
• ":TRIGger:CAN:ACKNowledge" on page 750
• ":TRIGger:CAN:PATTern:DATA" on page 492
• ":TRIGger:CAN:PATTern:DATA:LENGth" on page 493
• ":TRIGger:CAN:PATTern:ID" on page 494
• ":TRIGger:CAN:PATTern:ID:MODE" on page 495
• ":TRIGger:CAN:SAMPlepoint" on page 496
• ":TRIGger:CAN:SIGNal:BAUDrate" on page 497
• ":TRIGger:CAN:SIGNal:DEFinition" on page 751
• ":TRIGger:CAN:SOURce" on page 498
• ":TRIGger:CAN:TRIGger" on page 499
• ":TRIGger:DURation:GREaterthan" on page 502
• ":TRIGger:DURation:LESSthan" on page 503
• ":TRIGger:DURation:PATTern" on page 504
• ":TRIGger:DURation:QUALifier" on page 505
• ":TRIGger:DURation:RANGe" on page 506
• ":TRIGger[:EDGE]:COUPling" on page 512
• ":TRIGger[:EDGE]:LEVel" on page 513
• ":TRIGger[:EDGE]:REJect" on page 514
• ":TRIGger[:EDGE]:SLOPe" on page 515
• ":TRIGger[:EDGE]:SOURce" on page 516
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
691
6
Commands A-Z
• ":TRIGger:FLEXray:AUTosetup" on page 518
• ":TRIGger:FLEXray:BAUDrate" on page 519
• ":TRIGger:FLEXray:CHANnel" on page 520
• ":TRIGger:FLEXray:ERRor:TYPE" on page 521
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":TRIGger:FLEXray:FRAMe:CCBase" on page 523
• ":TRIGger:FLEXray:FRAMe:CCRepetition" on page 524
• ":TRIGger:FLEXray:FRAMe:ID" on page 525
• ":TRIGger:FLEXray:FRAMe:TYPE" on page 526
• ":TRIGger:FLEXray:SOURce" on page 527
• ":TRIGger:FLEXray:TRIGger" on page 528
• ":TRIGger:GLITch:GREaterthan" on page 531
• ":TRIGger:GLITch:LESSthan" on page 532
• ":TRIGger:GLITch:LEVel" on page 533
• ":TRIGger:GLITch:POLarity" on page 534
• ":TRIGger:GLITch:QUALifier" on page 535
• ":TRIGger:GLITch:RANGe" on page 536
• ":TRIGger:GLITch:SOURce" on page 537
• ":TRIGger:HFReject" on page 483
• ":TRIGger:HOLDoff" on page 484
• ":TRIGger:I2S:ALIGnment" on page 540
• ":TRIGger:I2S:AUDio" on page 541
• ":TRIGger:I2S:CLOCk:SLOPe" on page 542
• ":TRIGger:I2S:PATTern:DATA" on page 543
• ":TRIGger:I2S:PATTern:FORMat" on page 545
• ":TRIGger:I2S:RANGe" on page 546
• ":TRIGger:I2S:RWIDth" on page 548
• ":TRIGger:I2S:SOURce:CLOCk" on page 549
• ":TRIGger:I2S:SOURce:DATA" on page 550
• ":TRIGger:I2S:SOURce:WSELect" on page 551
• ":TRIGger:I2S:TRIGger" on page 552
• ":TRIGger:I2S:TWIDth" on page 554
• ":TRIGger:I2S:WSLow" on page 555
• ":TRIGger:IIC:PATTern:ADDRess" on page 557
• ":TRIGger:IIC:PATTern:DATA" on page 558
692
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":TRIGger:IIC:PATTern:DATa2" on page 559
• ":TRIGger:IIC[:SOURce]:CLOCk" on page 560
• ":TRIGger:IIC[:SOURce]:DATA" on page 561
• ":TRIGger:IIC:TRIGger:QUALifier" on page 562
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
• ":TRIGger:LIN:ID" on page 567
• ":TRIGger:LIN:PATTern:DATA" on page 568
• ":TRIGger:LIN:PATTern:DATA:LENGth" on page 570
• ":TRIGger:LIN:PATTern:FORMat" on page 571
• ":TRIGger:LIN:SAMPlepoint" on page 572
• ":TRIGger:LIN:SIGNal:BAUDrate" on page 573
• ":TRIGger:LIN:SIGNal:DEFinition" on page 752
• ":TRIGger:LIN:SOURce" on page 574
• ":TRIGger:LIN:STANdard" on page 575
• ":TRIGger:LIN:SYNCbreak" on page 576
• ":TRIGger:LIN:TRIGger" on page 577
• ":TRIGger:M1553:AUTosetup" on page 579
• ":TRIGger:M1553:PATTern:DATA" on page 580
• ":TRIGger:M1553:RTA" on page 581
• ":TRIGger:M1553:SOURce:LOWer" on page 582
• ":TRIGger:M1553:SOURce:UPPer" on page 583
• ":TRIGger:M1553:TYPE" on page 584
• ":TRIGger:MODE" on page 485
• ":TRIGger:NREJect" on page 486
• ":TRIGger:PATTern" on page 487
• ":TRIGger:SEQuence:COUNt" on page 586
• ":TRIGger:SEQuence:EDGE" on page 587
• ":TRIGger:SEQuence:FIND" on page 588
• ":TRIGger:SEQuence:PATTern" on page 589
• ":TRIGger:SEQuence:RESet" on page 590
• ":TRIGger:SEQuence:TIMer" on page 591
• ":TRIGger:SEQuence:TRIGger" on page 592
• ":TRIGger:SPI:CLOCk:SLOPe" on page 594
• ":TRIGger:SPI:CLOCk:TIMeout" on page 595
• ":TRIGger:SPI:FRAMing" on page 596
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
693
6
Commands A-Z
• ":TRIGger:SPI:PATTern:DATA" on page 597
• ":TRIGger:SPI:PATTern:WIDTh" on page 598
• ":TRIGger:SPI:SOURce:CLOCk" on page 599
• ":TRIGger:SPI:SOURce:DATA" on page 600
• ":TRIGger:SPI:SOURce:FRAMe" on page 601
• ":TRIGger:SWEep" on page 489
• ":TRIGger:THReshold" on page 753
• ":TRIGger:TV:LINE" on page 603
• ":TRIGger:TV:MODE" on page 604
• ":TRIGger:TV:POLarity" on page 605
• ":TRIGger:TV:SOURce" on page 606
• ":TRIGger:TV:STANdard" on page 607
• ":TRIGger:TV:TVMode" on page 754
• ":TRIGger:UART:BASE" on page 610
• ":TRIGger:UART:BAUDrate" on page 611
• ":TRIGger:UART:BITorder" on page 612
• ":TRIGger:UART:BURSt" on page 613
• ":TRIGger:UART:DATA" on page 614
• ":TRIGger:UART:IDLE" on page 615
• ":TRIGger:UART:PARity" on page 616
• ":TRIGger:UART:POLarity" on page 617
• ":TRIGger:UART:QUALifier" on page 618
• ":TRIGger:UART:SOURce:RX" on page 619
• ":TRIGger:UART:SOURce:TX" on page 620
• ":TRIGger:UART:TYPE" on page 621
• ":TRIGger:UART:WIDTh" on page 622
• ":TRIGger:USB:SOURce:DMINus" on page 624
• ":TRIGger:USB:SOURce:DPLus" on page 625
• ":TRIGger:USB:SPEed" on page 626
• ":TRIGger:USB:TRIGger" on page 627
• "*TST (Self Test)" on page 149
• TSTArt, ":MEASure:TSTArt" on page 731
• TSTOp, ":MEASure:TSTOp" on page 732
• TTAG, ":WAVeform:SEGMented:TTAG" on page 649
• TV, ":TRIGger:TV Commands" on page 602
694
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• TVALue, ":MEASure:TVALue" on page 356
• TVOLt, ":MEASure:TVOLt" on page 733
• TWIDth, ":TRIGger:I2S:TWIDth" on page 554
• TX, ":TRIGger:UART:SOURce:TX" on page 620
• TXFRames, ":SBUS:UART:COUNt:TXFRames" on page 455
• TYPE Commands:
• ":ACQuire:TYPE" on page 208
• ":CHANnel<n>:PROBe:HEAD[:TYPE]" on page 240
• ":WAVeform:TYPE" on page 655
• ":TRIGger:FLEXray:ERRor:TYPE" on page 521
• ":TRIGger:FLEXray:EVENt:TYPE" on page 522
• ":TRIGger:FLEXray:FRAMe:TYPE" on page 526
• ":TRIGger:IIC:TRIGger[:TYPE]" on page 563
• ":TRIGger:M1553:TYPE" on page 584
• ":TRIGger:UART:TYPE" on page 621
U
• UART Commands:
• ":SBUS:UART:BASE" on page 451
• ":SBUS:UART:COUNt:ERRor" on page 452
• ":SBUS:UART:COUNt:RESet" on page 453
• ":SBUS:UART:COUNt:RXFRames" on page 454
• ":SBUS:UART:COUNt:TXFRames" on page 455
• ":SBUS:UART:FRAMing" on page 456
• ":TRIGger:UART:BASE" on page 610
• ":TRIGger:UART:BAUDrate" on page 611
• ":TRIGger:UART:BITorder" on page 612
• ":TRIGger:UART:BURSt" on page 613
• ":TRIGger:UART:DATA" on page 614
• ":TRIGger:UART:IDLE" on page 615
• ":TRIGger:UART:PARity" on page 616
• ":TRIGger:UART:POLarity" on page 617
• ":TRIGger:UART:QUALifier" on page 618
• ":TRIGger:UART:SOURce:RX" on page 619
• ":TRIGger:UART:SOURce:TX" on page 620
• ":TRIGger:UART:TYPE" on page 621
• ":TRIGger:UART:WIDTh" on page 622
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
695
6
Commands A-Z
• UNITs Commands:
• ":CHANnel<n>:UNITs" on page 247
• ":EXTernal:UNITs" on page 275
• ":MTESt:AMASk:UNITs" on page 377
• UNSigned, ":WAVeform:UNSigned" on page 656
• UPPer Commands:
• ":MEASure:UPPer" on page 735
• ":TRIGger:M1553:SOURce:UPPer" on page 583
• USB, ":TRIGger:USB Commands" on page 623
• UTILization, ":SBUS:CAN:COUNt:UTILization" on page 438
V
• VAMPlitude, ":MEASure:VAMPlitude" on page 358
• VAVerage, ":MEASure:VAVerage" on page 359
• VBASe, ":MEASure:VBASe" on page 360
• VDELta, ":MEASure:VDELta" on page 736
• VECTors, ":DISPlay:VECTors" on page 265
• VERNier, ":CHANnel<n>:VERNier" on page 248
• ":VIEW" on page 192
• VMAX, ":MEASure:VMAX" on page 361
• VMIN, ":MEASure:VMIN" on page 362
• VPP, ":MEASure:VPP" on page 363
• VRATio, ":MEASure:VRATio" on page 364
• VRMS, ":MEASure:VRMS" on page 365
• VSTArt, ":MEASure:VSTArt" on page 737
• VSTOp, ":MEASure:VSTOp" on page 738
• VTIMe, ":MEASure:VTIMe" on page 366
• VTOP, ":MEASure:VTOP" on page 367
W
• "*WAI (Wait To Continue)" on page 150
• WAVeform Commands:
• ":SAVE:WAVeform:FORMat" on page 429
• ":SAVE:WAVeform:LENGth" on page 430
• ":SAVE:WAVeform[:STARt]" on page 428
• ":WAVeform:BYTeorder" on page 636
• ":WAVeform:COUNt" on page 637
• ":WAVeform:DATA" on page 638
696
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Commands A-Z
6
• ":WAVeform:FORMat" on page 640
• ":WAVeform:POINts" on page 641
• ":WAVeform:POINts:MODE" on page 643
• ":WAVeform:PREamble" on page 645
• ":WAVeform:SEGMented:COUNt" on page 648
• ":WAVeform:SEGMented:TTAG" on page 649
• ":WAVeform:SOURce" on page 650
• ":WAVeform:SOURce:SUBSource" on page 654
• ":WAVeform:TYPE" on page 655
• ":WAVeform:UNSigned" on page 656
• ":WAVeform:VIEW" on page 657
• ":WAVeform:XINCrement" on page 658
• ":WAVeform:XORigin" on page 659
• ":WAVeform:XREFerence" on page 660
• ":WAVeform:YINCrement" on page 661
• ":WAVeform:YORigin" on page 662
• ":WAVeform:YREFerence" on page 663
• WAVeforms Commands:
• ":MTESt:COUNt:WAVeforms" on page 383
• ":MTESt:RMODe:WAVeforms" on page 396
• WIDTh Commands:
• ":SBUS:SPI:WIDTh" on page 450
• ":TRIGger:SPI:PATTern:WIDTh" on page 598
• ":TRIGger:UART:WIDTh" on page 622
• WINDow, ":FUNCtion:WINDow" on page 292
• WSELect, ":TRIGger:I2S:SOURce:WSELect" on page 551
• WSLow, ":TRIGger:I2S:WSLow" on page 555
X
• X1, ":MTESt:SCALe:X1" on page 398
• X1Position, ":MARKer:X1Position" on page 310
• X1Y1source, ":MARKer:X1Y1source" on page 311
• X2Position, ":MARKer:X2Position" on page 312
• X2Y2source, ":MARKer:X2Y2source" on page 313
• XDELta Commands:
• ":MARKer:XDELta" on page 314
• ":MTESt:AMASk:XDELta" on page 378
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
697
6
Commands A-Z
• ":MTESt:SCALe:XDELta" on page 399
• XINCrement, ":WAVeform:XINCrement" on page 658
• XMAX, ":MEASure:XMAX" on page 368
• XMIN, ":MEASure:XMIN" on page 369
• XORigin, ":WAVeform:XORigin" on page 659
• XREFerence, ":WAVeform:XREFerence" on page 660
Y
• Y1, ":MTESt:SCALe:Y1" on page 400
• Y1Position, ":MARKer:Y1Position" on page 315
• Y2, ":MTESt:SCALe:Y2" on page 401
• Y2Position, ":MARKer:Y2Position" on page 316
• YDELta Commands:
• ":MARKer:YDELta" on page 317
• ":MTESt:AMASk:YDELta" on page 379
• YINCrement, ":WAVeform:YINCrement" on page 661
• YORigin, ":WAVeform:YORigin" on page 662
• YREFerence, ":WAVeform:YREFerence" on page 663
698
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
7
Obsolete and Discontinued Commands
Obsolete commands are older forms of commands that are provided to
reduce customer rework for existing systems and programs (see"Obsolete
Commands" on page 798).
Obsolete Command
Current Command Equivalent
ANALog<n>:BWLimit
:CHANnel<n>:BWLimit (see
page 232)
ANALog<n>:COUPling
:CHANnel<n>:COUPling (see
page 233)
ANALog<n>:INVert
:CHANnel<n>:INVert (see
page 236)
ANALog<n>:LABel
:CHANnel<n>:LABel (see
page 237)
ANALog<n>:OFFSet
:CHANnel<n>:OFFSet (see
page 238)
ANALog<n>:PROBe
:CHANnel<n>:PROBe (see
page 239)
ANALog<n>:PMODe
none
ANALog<n>:RANGe
:CHANnel<n>:RANGe (see
page 245)
:CHANnel:ACTivity (see
page 705)
:ACTivity (see page 154)
:CHANnel:LABel (see
page 706)
:CHANnel<n>:LABel (see
page 237) or
:DIGital<n>:LABel (see
page 252)
:CHANnel:THReshold (see
page 707)
:POD<n>:THReshold (see
page 407) or
:DIGital<n>:THReshold (see
page 255)
:CHANnel2:SKEW (see
page 708)
:CHANnel<n>:PROBe:SKEW
(see page 242)
Behavior Differences
use CHANnel<n>:LABel for
analog channels and use
DIGital<n>:LABel for digital
channels

699
7
700
Obsolete and Discontinued Commands
Obsolete Command
Current Command Equivalent
Behavior Differences
:CHANnel<n>:INPut (see
page 709)
:CHANnel<n>:IMPedance
(see page 235)
:CHANnel<n>:PMODe (see
page 710)
none
:DISPlay:CONNect (see
page 711)
:DISPlay:VECTors (see
page 265)
:DISPlay:ORDer (see page 712)
none
:ERASe (see page 713)
:CDISplay (see page 161)
:EXTernal:INPut (see
page 714)
:EXTernal:IMPedance (see
page 269)
:EXTernal:PMODe (see
page 715)
none
FUNCtion1, FUNCtion2
:FUNCtion Commands (see
page 276)
ADD not included
:FUNCtion:SOURce (see
page 716)
:FUNCtion:SOURce1 (see
page 289)
Obsolete command has ADD,
SUBTract, and MULTiply
parameters; current command
has GOFT parameter.
:FUNCtion:VIEW (see
page 717)
:FUNCtion:DISPlay (see
page 280)
:HARDcopy:DESTination (see
page 718)
:HARDcopy:FILename (see
page 720)
:HARDcopy:DEVice (see
page 719)
:HARDcopy:FORMat (see
page 721)
:HARDcopy:FILename (see
page 720)
:RECall:FILename (see
page 410)
:SAVE:FILename (see
page 410)
:HARDcopy:FORMat (see
page 721)
:HARDcopy:APRinter (see
page 296)
:SAVE:IMAGe:FORMat (see
page 421)
:SAVE:WAVeform:FORMat
(see page 429)
:HARDcopy:GRAYscale (see
page 722)
:HARDcopy:PALette (see
page 301)
:HARDcopy:IGColors (see
page 723)
:HARDcopy:INKSaver (see
page 299)
PLOTter, THINkjet not
supported; TIF, BMP, CSV,
SEIko added
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
Obsolete Command
Current Command Equivalent
:HARDcopy:PDRiver (see
page 724)
:HARDcopy:APRinter (see
page 296)
:MEASure:LOWer (see
page 725)
:MEASure:DEFine:THResholds
(see page 328)
:MEASure:SCRatch (see
page 726)
:MEASure:CLEar (see
page 326)
:MEASure:TDELta (see
page 727)
:MARKer:XDELta (see
page 314)
:MEASure:THResholds (see
page 728)
:MEASure:DEFine:THResholds
(see page 328)
:MEASure:TMAX (see
page 729)
:MEASure:XMAX (see
page 368)
:MEASure:TMIN (see
page 730)
:MEASure:XMIN (see
page 369)
:MEASure:TSTArt (see
page 731)
:MARKer:X1Position (see
page 310)
:MEASure:TSTOp (see
page 732)
:MARKer:X2Position (see
page 312)
:MEASure:TVOLt (see
page 733)
:MEASure:TVALue (see
page 356)
TVALue measures additional
values such as db, Vs, etc.
:MEASure:UPPer (see
page 735)
:MEASure:DEFine:THResholds
(see page 328)
MEASure:DEFine:THResholds
can define absolute values or
percentage
:MEASure:VDELta (see
page 736)
:MARKer:YDELta (see
page 317)
:MEASure:VSTArt (see
page 737)
:MARKer:Y1Position (see
page 315)
:MEASure:VSTOp (see
page 738)
:MARKer:Y2Position (see
page 316)
:MTESt:AMASk:{SAVE |
STORe} (see page 739)
:SAVE:MASK[:STARt] (see
page 425)
:MTESt:AVERage (see
page 740)
:ACQuire:TYPE AVERage (see
page 208)
:MTESt:AVERage:COUNt (see
page 741)
:ACQuire:COUNt (see
page 197)
:MTESt:LOAD (see page 742)
:RECall:MASK[:STARt] (see
page 412)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Behavior Differences
MEASure:DEFine:THResholds
can define absolute values or
percentage
MEASure:DEFine:THResholds
can define absolute values or
percentage
701
7
Obsolete and Discontinued Commands
Discontinued
Commands
702
Obsolete Command
Current Command Equivalent
:MTESt:RUMode (see
page 743)
:MTESt:RMODe (see
page 389)
:MTESt:RUMode:SOFailure
(see page 744)
:MTESt:RMODe:FACTion:STO
P (see page 393)
:MTESt:{STARt | STOP} (see
page 745)
:RUN (see page 186) or :STOP
(see page 190)
:MTESt:TRIGger:SOURce (see
page 746)
:TRIGger Commands (see
page 479)
:PRINt? (see page 747)
:DISPlay:DATA? (see
page 259)
:TIMebase:DELay (see
page 749)
:TIMebase:POSition (see
page 470) or
:TIMebase:WINDow:POSition
(see page 476)
:TRIGger:CAN:ACKNowledge
(see page 750)
none
:TRIGger:CAN:SIGNal:DEFiniti
on (see page 751)
none
:TRIGger:LIN:SIGNal:DEFinitio
n (see page 752)
none
:TRIGger:THReshold (see
page 753)
:POD<n>:THReshold (see
page 407) or
:DIGital<n>:THReshold (see
page 255)
:TRIGger:TV:TVMode (see
page 754)
:TRIGger:TV:MODE (see
page 604)
Behavior Differences
There are various commands
for setting the source with
different types of triggers.
TIMebase:POSition is position
value of main time base;
TIMebase:WINDow:POSition
is position value of zoomed
(delayed) time base window.
Discontinued commands are commands that were used by previous
oscilloscopes, but are not supported by the InfiniiVision 6000 Series
oscilloscopes. Listed below are the Discontinued commands and the
nearest equivalent command available (if any).
Discontinued Command
Current Command Equivalent
ASTore
:DISPlay:PERSistence INFinite
(see page 263)
CHANnel:MATH
:FUNCtion:OPERation (see
page 285)
Comments
ADD not included
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
Discontinued Command
Current Command Equivalent
Comments
CHANnel<n>:PROTect
:CHANnel<n>:PROTection
(see page 244)
Previous form of this
command was used to
enable/disable 50Ω
protection. The new command
resets a tripped protect and
the query returns the status of
TRIPed or NORMal.
DISPlay:INVerse
none
DISPlay:COLumn
none
DISPlay:FREeze
none
DISPlay:GRID
none
DISPLay:LINE
none
DISPlay:PIXel
none
DISPlay:POSition
none
DISPlay:ROW
none
DISPlay:TEXT
none
FUNCtion:MOVE
none
FUNCtion:PEAKs
none
HARDcopy:ADDRess
none
Only parallel printer port is
supported. GPIB printing not
supported
MASK
none
All commands discontinued,
feature not available
SYSTem:KEY
none
TEST:ALL
*TST (Self Test) (see page 149)
TRACE subsystem
none
TRIGger:ADVanced subsystem
TRIGger:TV:FIELd
All commands discontinued,
feature not available
Use new GLITch, PATTern, or
TV trigger modes
:TRIGger:TV:MODE (see
page 604)
TRIGger:TV:TVHFrej
TRIGger:TV:VIR
none
VAUToscale
none
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
703
7
Obsolete and Discontinued Commands
Discontinued
Parameters
704
Some previous oscilloscope queries returned control setting values of OFF
and ON. The InfiniiVision 6000 Series oscilloscopes only return the
enumerated values 0 (for off) and 1 (for on).
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:CHANnel:ACTivity
(see page 798)
Command Syntax
:CHANnel:ACTivity
The :CHANnel:ACTivity command clears the cumulative edge variables for
the next activity query.
NOTE
Query Syntax
The :CHANnel:ACTivity command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :ACTivity command (see page 154) instead.
:CHANnel:ACTivity?
The :CHANnel:ACTivity? query returns the active edges since the last clear,
and returns the current logic levels.
Return Format
<edges>,<levels><NL>
<edges> ::= presence of edges (32-bit integer in NR1 format).
<levels> ::= logical highs or lows (32-bit integer in NR1 format).
NOTE
A bit equal to zero indicates that no edges were detected at the specified threshold since
the last clear on that channel. Edges may have occurred that were not detected because of
the threshold setting.
A bit equal to one indicates that edges have been detected at the specified
threshold since the last clear on that channel.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
705
7
Obsolete and Discontinued Commands
:CHANnel:LABel
(see page 798)
Command Syntax
:CHANnel:LABel <source_text><string>
<source_text> ::= {CHANnel1 | CHANnel2 | DIGital0,..,DIGital15}
<string> ::= quoted ASCII string
The :CHANnel:LABel command sets the source text to the string that
follows. Setting a channel will also result in the name being added to the
label list.
NOTE
Query Syntax
The :CHANnel:LABel command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :CHANnel<n>:LABel command (see page 237) or
:DIGital<n>:LABel command (see page 252) for the InfiniiVision 6000 Series oscilloscopes.
:CHANnel:LABel?
The :CHANnel:LABel? query returns the label associated with a particular
analog channel.
Return Format
<string><NL>
<string> ::= quoted ASCII string
706
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:CHANnel:THReshold
(see page 798)
Command Syntax
:CHANnel:THReshold <channel group>, <threshold type> [, <value>]
<channel group> ::= {POD1 | POD2}
<threshold type> ::= {CMOS | ECL | TTL | USERdef}
<value> ::= voltage for USERdef in NR3 format [volt_type]
[volt_type] ::= {V | mV (-3) | uV (-6)}
The :CHANnel:THReshold command sets the threshold for a group of
channels. The threshold is either set to a predefined value or to a
user- defined value. For the predefined value, the voltage parameter is
ignored.
NOTE
Query Syntax
The :CHANnel:THReshold command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :POD<n>:THReshold command (see page 407) or
:DIGital<n>:THReshold command (see page 255) for the InfiniiVision 6000 Series
oscilloscopes.
:CHANnel:THReshold? <channel group>
The :CHANnel:THReshold? query returns the voltage and threshold text for
a specific group of channels.
Return Format
<threshold type> [, <value>]<NL>
<threshold type> ::= {CMOS | ECL | TTL | USERdef}
<value> ::= voltage for USERdef (float 32 NR3)
NOTE
• CMOS = 2.5V
• TTL = 1.5V
• ECL = - 1.3V
• USERdef ::= - 6.0V to 6.0V
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
707
7
Obsolete and Discontinued Commands
:CHANnel2:SKEW
(see page 798)
Command Syntax
:CHANnel2:SKEW <skew value>
<skew value> ::= skew time in NR3 format
<skew value> ::= -100 ns to +100 ns
The :CHANnel2:SKEW command sets the skew between channels 1 and 2.
The maximum skew is +/- 100 ns. You can use the oscilloscope's analog
probe skew control to remove cable delay errors between channel 1 and
channel 2.
NOTE
The :CHANnel2:SKEW command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :CHANnel<n>:PROBe:SKEW command (see page 242)
instead.
NOTE
This command is only valid for the two channel oscilloscope models.
Query Syntax
:CHANnel2:SKEW?
The :CHANnel2:SKEW? query returns the current probe skew setting for
the selected channel.
Return Format
<skew value><NL>
<skew value> ::= skew value in NR3 format
See Also
708
• "Introduction to :CHANnel<n> Commands" on page 230
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:CHANnel<n>:INPut
(see page 798)
Command Syntax
:CHANnel<n>:INPut <impedance>
<impedance> ::= {ONEMeg | FIFTy}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :CHANnel<n>:INPut command selects the input impedance setting for
the specified channel. The legal values for this command are ONEMeg (1
MΩ) and FIFTy (50Ω).
NOTE
Query Syntax
The :CHANnel<n>:INPut command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :CHANnel<n>:IMPedance command (see page 235)
instead.
:CHANnel<n>:INPut?
The :CHANnel<n>:INPut? query returns the current input impedance
setting for the specified channel.
Return Format
<impedance value><NL>
<impedance value> ::= {ONEM | FIFT}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
709
7
Obsolete and Discontinued Commands
:CHANnel<n>:PMODe
(see page 798)
Command Syntax
:CHANnel<n>:PMODe <pmode value>
<pmode value> ::= {AUTo | MANual}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The probe sense mode is controlled internally and cannot be set. If a
probe with sense is connected to the specified channel, auto sensing is
enabled; otherwise, the mode is manual.
If the PMODe sent matches the oscilloscope's setting, the command will be
accepted. Otherwise, a setting conflict error is generated.
NOTE
Query Syntax
The :CHANnel<n>:PMODe command is an obsolete command provided for compatibility to
previous oscilloscopes.
:CHANnel<n>:PMODe?
The :CHANnel<n>:PMODe? query returns AUT if an autosense probe is
attached and MAN otherwise.
Return Format
<pmode value><NL>
<pmode value> ::= {AUT | MAN}
710
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:DISPlay:CONNect
(see page 798)
Command Syntax
:DISPlay:CONNect <connect>
<connect> ::= {{ 1 | ON} | {0 | OFF}}
The :DISPlay:CONNect command turns vectors on and off. When vectors
are turned on, the oscilloscope displays lines connecting sampled data
points. When vectors are turned off, only the sampled data is displayed.
NOTE
Query Syntax
The :DISPlay:CONNEct command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :DISPlay:VECTors command (see page 265) instead.
:DISPlay:CONNect?
The :DISPlay:CONNect? query returns the current state of the vectors
setting.
Return Format
<connect><NL>
<connect> ::= {1 | 0}
See Also
• ":DISPlay:VECTors" on page 265
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
711
7
Obsolete and Discontinued Commands
:DISPlay:ORDer
(see page 798)
Query Syntax
:DISPlay:ORDer?
The :DISPlay:ORDer? query returns a list of digital channel numbers in
screen order, from top to bottom, separated by commas. Busing is
displayed as digital channels with no separator. For example, in the
following list, the bus consists of digital channels 4 and 5: DIG1, DIG4
DIG5, DIG7.
NOTE
Return Format
The :DISPlay:ORDer command is an obsolete command provided for compatibility to
previous oscilloscopes. This command is only available on the MSO models.
<order><NL>
<order> ::= Unquoted ASCII string
NOTE
See Also
Example Code
A return value is included for each digital channel. A return value of NONE indicates that a
channel is turned off.
• ":DIGital<n>:POSition" on page 253
' DISP_ORDER - Set the order the channels are displayed on the
' analyzer. You can enter between 1 and 32 channels at one time.
' If you leave out channels, they will not be displayed.
' Display ONLY channel 0 and channel 10 in that order.
myScope.WriteString ":DISPLAY:ORDER 0,10"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
712
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:ERASe
(see page 798)
Command Syntax
:ERASe
The :ERASe command erases the screen.
NOTE
The :ERASe command is an obsolete command provided for compatibility to previous
oscilloscopes. Use the :CDISplay command (see page 161) instead.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
713
7
Obsolete and Discontinued Commands
:EXTernal:INPut
(see page 798)
Command Syntax
:EXTernal:INPut <impedance>
<impedance> ::= {ONEMeg | FIFTy}
The :EXTernal:IMPedance command selects the input impedance setting for
the external trigger. The legal values for this command are ONEMeg (1
MΩ) and FIFTy (50Ω).
NOTE
Query Syntax
The :EXTernal:INPut command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :EXTernal:IMPedance command (see page 269) instead.
:EXTernal:INPut?
The :EXTernal:INPut? query returns the current input impedance setting
for the external trigger.
Return Format
<impedance value><NL>
<impedance value> ::= {ONEM | FIFT}
See Also
• "Introduction to :EXTernal Trigger Commands" on page 266
• "Introduction to :TRIGger Commands" on page 479
• ":CHANnel<n>:IMPedance" on page 235
714
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:EXTernal:PMODe
(see page 798)
Command Syntax
:EXTernal:PMODe <pmode value>
<pmode value> ::= {AUTo | MANual}
The probe sense mode is controlled internally and cannot be set. If a
probe with sense is connected to the specified channel, auto sensing is
enabled; otherwise, the mode is manual.
If the pmode sent matches the oscilloscope's setting, the command will be
accepted. Otherwise, a setting conflict error is generated.
NOTE
Query Syntax
The :EXTernal:PMODe command is an obsolete command provided for compatibility to
previous oscilloscopes.
:EXTernal:PMODe?
The :EXTernal:PMODe? query returns AUT if an autosense probe is
attached and MAN otherwise.
Return Format
<pmode value><NL>
<pmode value> ::= {AUT | MAN}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
715
7
Obsolete and Discontinued Commands
:FUNCtion:SOURce
(see page 798)
Command Syntax
:FUNCtion:SOURce <value>
<value> ::= {CHANnel<n> | ADD | SUBTract | MULTiply}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :FUNCtion:SOURce command is only used when an FFT (Fast Fourier
Transform), DIFF, or INT operation is selected (see
the:FUNCtion:OPERation command for more information about selecting an
operation). The :FUNCtion:SOURce command selects the source for
function operations. Choose CHANnel<n>, or ADD, SUBT, or MULT to
specify the desired source for function DIFFerentiate, INTegrate, and FFT
operations specified by the :FUNCtion:OPERation command.
NOTE
Query Syntax
The :FUNCtion:SOURce command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :FUNCtion:SOURce1 command (see page 289) instead.
:FUNCtion:SOURce?
The :FUNCtion:SOURce? query returns the current source for function
operations.
Return Format
<value><NL>
<value> ::= {CHAN<n> | ADD | SUBT | MULT}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
See Also
• "Introduction to :FUNCtion Commands" on page 278
• ":FUNCtion:OPERation" on page 285
716
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:FUNCtion:VIEW
(see page 798)
Command Syntax
:FUNCtion:VIEW <view>
<view> ::= {{1 | ON} | (0 | OFF}}
The :FUNCtion:VIEW command turns the selected function on or off. When
ON is selected, the function performs as specified using the other
FUNCtion commands. When OFF is selected, function is neither calculated
nor displayed.
NOTE
Query Syntax
The :FUNCtion:VIEW command is provided for backward compatibility to previous
oscilloscopes. Use the :FUNCtion:DISPlay command (see page 280) instead.
:FUNCtion:VIEW?
The :FUNCtion:VIEW? query returns the current state of the selected
function.
Return Format
<view><NL>
<view> ::= {1 | 0}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
717
7
Obsolete and Discontinued Commands
:HARDcopy:DESTination
(see page 798)
Command Syntax
:HARDcopy:DESTination <destination>
<destination> ::= {CENTronics | FLOPpy}
The :HARDcopy:DESTination command sets the hardcopy destination.
NOTE
Query Syntax
The :HARDcopy:DESTination command is an obsolete command provided for compatibility
to previous oscilloscopes. Use the :HARDcopy:FILename command (see page 720) instead.
:HARDcopy:DESTination?
The :HARDcopy:DESTination? query returns the selected hardcopy
destination.
Return Format
<destination><NL>
<destination> ::= {CENT | FLOP}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:FORMat" on page 721
718
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:HARDcopy:DEVice
(see page 798)
Command Syntax
:HARDcopy:DEVice <device>
<device> ::= {TIFF | GIF | BMP | LASerjet | EPSon | DESKjet
| BWDeskjet | SEIKo}
The HARDcopy:DEVice command sets the hardcopy device type.
NOTE
BWDeskjet option refers to the monochrome Deskjet printer.
NOTE
The :HARDcopy:DEVice command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :HARDcopy:FORMat command (see page 721) instead.
Query Syntax
:HARDcopy:DEVice?
The :HARDcopy:DEVice? query returns the selected hardcopy device type.
Return Format
<device><NL>
<device> ::= {TIFF | GIF | BMP | LAS | EPS | DESK | BWD | SEIK}
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
719
7
Obsolete and Discontinued Commands
:HARDcopy:FILename
(see page 798)
Command Syntax
:HARDcopy:FILename <string>
<string> ::= quoted ASCII string
The HARDcopy:FILename command sets the output filename for those
print formats whose output is a file.
NOTE
Query Syntax
The :HARDcopy:FILename command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :SAVE:FILename command (see page 417) and
:RECall:FILename command (see page 410) instead.
:HARDcopy:FILename?
The :HARDcopy:FILename? query returns the current hardcopy output
filename.
Return Format
<string><NL>
<string> ::= quoted ASCII string
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:FORMat" on page 721
720
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:HARDcopy:FORMat
(see page 798)
Command Syntax
:HARDcopy:FORMat <format>
<format> ::= {BMP[24bit] | BMP8bit | PNG | CSV | ASCiixy | BINary
| PRINter0 | PRINter1}
The HARDcopy:FORMat command sets the hardcopy format type.
PRINter0 and PRINter1 are only valid when printers are connected to the
oscilloscope's USB ports. (The first printer connected/identified is
PRINter0 and the second is PRINter1.)
NOTE
Query Syntax
The :HARDcopy:FORMat command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :SAVE:IMAGe:FORMat (see page 421),
:SAVE:WAVeform:FORMat (see page 429), and :HARDcopy:APRinter (see page 296)
commands instead.
:HARDcopy:FORMat?
The :HARDcopy:FORMat? query returns the selected hardcopy format type.
Return Format
<format><NL>
<format> ::= {BMP | BMP8 | PNG | CSV | ASC | BIN | PRIN0 | PRIN1}
See Also
• "Introduction to :HARDcopy Commands" on page 294
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
721
7
Obsolete and Discontinued Commands
:HARDcopy:GRAYscale
(see page 798)
Command Syntax
:HARDcopy:GRAYscale <gray>
<gray> ::= {{OFF | 0} | {ON | 1}}
The :HARDcopy:GRAYscale command controls whether grayscaling is
performed in the hardcopy dump.
NOTE
Query Syntax
The :HARDcopy:GRAYscale command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :HARDcopy:PALette command (see page 301) instead.
(":HARDcopy:GRAYscale ON" is the same as ":HARDcopy:PALette GRAYscale" and
":HARDcopy:GRAYscale OFF" is the same as ":HARDcopy:PALette COLor".)
:HARDcopy:GRAYscale?
The :HARDcopy:GRAYscale? query returns a flag indicating whether
grayscaling is performed in the hardcopy dump.
Return Format
<gray><NL>
<gray> ::= {0 | 1}
See Also
722
• "Introduction to :HARDcopy Commands" on page 294
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:HARDcopy:IGColors
(see page 798)
Command Syntax
:HARDcopy:IGColors <value>
<value> ::= {{OFF | 0} | {ON | 1}}
The HARDcopy:IGColors command controls whether the graticule colors
are inverted or not.
NOTE
Query Syntax
The :HARDcopy:IGColors command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :HARDcopy:INKSaver (see page 299) command instead.
:HARDcopy:IGColors?
The :HARDcopy:IGColors? query returns a flag indicating whether graticule
colors are inverted or not.
Return Format
<value><NL>
<value> ::= {0 | 1}
See Also
• "Introduction to :HARDcopy Commands" on page 294
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
723
7
Obsolete and Discontinued Commands
:HARDcopy:PDRiver
(see page 798)
Command Syntax
:HARDcopy:PDRiver <driver>
<driver> ::= {AP2Xxx | AP21xx | {AP2560 | AP25} | {DJ350 | DJ35} |
DJ6xx | {DJ630 | DJ63} | DJ6Special | DJ6Photo |
DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP |
DJ55xx | {PS470 | PS47} {PS100 | PS10} | CLASer |
MLASer | LJFastraster | POSTscript}
The HARDcopy:PDRiver command sets the hardcopy printer driver used
for the selected printer.
If the correct driver for the selected printer can be identified, it will be
selected and cannot be changed.
NOTE
Query Syntax
The :HARDcopy:PDRiver command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :HARDcopy:APRinter (see page 296) command instead.
:HARDcopy:PDRiver?
The :HARDcopy:PDRiver? query returns the selected hardcopy printer
driver.
Return Format
<driver><NL>
<driver> ::= {AP2X | AP21 | AP25 | DJ35 | DJ6 | DJ63 | DJ6S | DJ6P |
DJ8S | DJ8 | DJ9V | OJPR | DJ9 | GVIP | DJ55 | PS10 |
PS47 | CLAS | MLAS | LJF | POST}
See Also
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:FORMat" on page 721
724
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MEASure:LOWer
(see page 798)
Command Syntax
:MEASure:LOWer <voltage>
The :MEASure:LOWer command sets the lower measurement threshold
value. This value and the UPPer value represent absolute values when the
thresholds are ABSolute and percentage when the thresholds are PERCent
as defined by the :MEASure:DEFine THResholds command.
NOTE
Query Syntax
The :MEASure:LOWer command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:DEFine THResholds command (see page 328)
instead.
:MEASure:LOWer?
The :MEASure:LOWer? query returns the current lower threshold level.
Return Format
<voltage><NL>
<voltage> ::= the user-defined lower threshold in volts in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:THResholds" on page 728
• ":MEASure:UPPer" on page 735
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
725
7
Obsolete and Discontinued Commands
:MEASure:SCRatch
(see page 798)
Command Syntax
:MEASure:SCRatch
The :MEASure:SCRatch command clears all selected measurements and
markers from the screen.
NOTE
726
The :MEASure:SCRatch command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:CLEar command (see page 326) instead.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:MEASure:TDELta
(see page 798)
Query Syntax
:MEASure:TDELta?
The :MEASure:TDELta? query returns the time difference between the
Tstop marker (X2 cursor) and the Tstart marker (X1 cursor).
Tdelta = Tstop - Tstart
Tstart is the time at the start marker (X1 cursor) and Tstop is the time at
the stop marker (X2 cursor). No measurement is made when the
:MEASure:TDELta? query is received by the oscilloscope. The delta time
value that is output is the current value. This is the same value as the
front- panel cursors delta X value.
NOTE
Return Format
The :MEASure:TDELta command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:XDELta command (see page 314) instead.
<value><NL>
<value> ::= time difference between start and stop markers in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Position" on page 312
• ":MARKer:XDELta" on page 314
• ":MEASure:TSTArt" on page 731
• ":MEASure:TSTOp" on page 732
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
727
7
Obsolete and Discontinued Commands
:MEASure:THResholds
(see page 798)
Command Syntax
:MEASure:THResholds {T1090 | T2080 | VOLTage}
The :MEASure:THResholds command selects the thresholds used when
making time measurements.
NOTE
Query Syntax
The :MEASure:THResholds command is obsolete and is provided for backward
compatibility to previous oscilloscopes. Use the :MEASure:DEFine THResholds command
(see page 328) instead.
:MEASure:THResholds?
The :MEASure:THResholds? query returns the current thresholds selected
when making time measurements.
Return Format
{T1090 | T2080 | VOLTage}<NL>
{T1090} uses the 10% and 90% levels of the selected waveform.
{T2080} uses the 20% and 80% levels of the selected waveform.
{VOLTage} uses the upper and lower voltage thresholds set by the
UPPer and LOWer commands on the selected waveform.
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:LOWer" on page 725
• ":MEASure:UPPer" on page 735
728
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MEASure:TMAX
(see page 798)
Command Syntax
:MEASure:TMAX [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:TMAX command installs a screen measurement and starts
an X- at- Max- Y measurement on the selected waveform. If the optional
source is specified, the current source is modified.
NOTE
Query Syntax
The :MEASure:TMAX command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:XMAX command (see page 368) instead.
:MEASure:TMAX? [<source>]
The :MEASure:TMAX? query returns the horizontal axis value at which the
maximum vertical value occurs on the current source. If the optional
source is specified, the current source is modified. If all channels are off,
the query returns 9.9E+37.
Return Format
<value><NL>
<value> ::= time at maximum in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:TMIN" on page 730
• ":MEASure:XMAX" on page 368
• ":MEASure:XMIN" on page 369
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
729
7
Obsolete and Discontinued Commands
:MEASure:TMIN
(see page 798)
Command Syntax
:MEASure:TMIN [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH}
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MEASure:TMIN command installs a screen measurement and starts an
X- at- Min- Y measurement on the selected waveform. If the optional source
is specified, the current source is modified.
NOTE
Query Syntax
The :MEASure:TMIN command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:XMIN command (see page 369) instead.
:MEASure:TMIN? [<source>]
The :MEASure:TMIN? query returns the horizontal axis value at which the
minimum vertical value occurs on the current source. If the optional
source is specified, the current source is modified. If all channels are off,
the query returns 9.9E+37.
Return Format
<value><NL>
<value> ::= time at minimum in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:TMAX" on page 729
• ":MEASure:XMAX" on page 368
• ":MEASure:XMIN" on page 369
730
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:MEASure:TSTArt
(see page 798)
Command Syntax
:MEASure:TSTArt <value> [suffix]
<value> ::= time at the start marker in seconds
[suffix] ::= {s | ms | us | ns | ps}
The :MEASure:TSTArt command moves the start marker (X1 cursor) to the
specified time with respect to the trigger time.
NOTE
The short form of this command, TSTA, does not follow the defined Long Form to Short
Form Truncation Rules (see page 800). The normal short form "TST" would be the same for
both TSTArt and TSTOp, so sending TST for the TSTArt command produces an error.
NOTE
The :MEASure:TSTArt command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:X1Position command (see page 310) instead.
Query Syntax
:MEASure:TSTArt?
The :MEASure:TSTArt? query returns the time at the start marker (X1
cursor).
Return Format
<value><NL>
<value> ::= time at the start marker in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Position" on page 312
• ":MARKer:XDELta" on page 314
• ":MEASure:TDELta" on page 727
• ":MEASure:TSTOp" on page 732
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
731
7
Obsolete and Discontinued Commands
:MEASure:TSTOp
(see page 798)
Command Syntax
:MEASure:TSTOp <value> [suffix]
<value> ::= time at the stop marker in seconds
[suffix] ::= {s | ms | us | ns | ps}
The :MEASure:TSTOp command moves the stop marker (X2 cursor) to the
specified time with respect to the trigger time.
NOTE
The short form of this command, TSTO, does not follow the defined Long Form to Short
Form Truncation Rules (see page 800). The normal short form "TST" would be the same for
both TSTArt and TSTOp, so sending TST for the TSTOp command produces an error.
NOTE
The :MEASure:TSTOp command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:X2Position command (see page 312) instead.
Query Syntax
:MEASure:TSTOp?
The :MEASure:TSTOp? query returns the time at the stop marker (X2
cursor).
Return Format
<value><NL>
<value> ::= time at the stop marker in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:X1Position" on page 310
• ":MARKer:X2Position" on page 312
• ":MARKer:XDELta" on page 314
• ":MEASure:TDELta" on page 727
• ":MEASure:TSTArt" on page 731
732
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MEASure:TVOLt
(see page 798)
Query Syntax
:MEASure:TVOLt? <value>, [<slope>]<occurrence>[,<source>]
<value> ::= the voltage level that the waveform must cross.
<slope> ::= direction of the waveform. A rising slope is indicated by
a plus sign (+). A falling edge is indicated by a minus
sign (-).
<occurrence> ::= the transition to be reported. If the occurrence
number is one, the first crossing is reported. If
the number is two, the second crossing is reported,
etc.
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH}
<digital channels> ::= {DIGital0,..,DIGital15} for the MSO models
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
When the :MEASure:TVOLt? query is sent, the displayed signal is searched
for the specified voltage level and transition. The time interval between the
trigger event and this defined occurrence is returned as the response to
the query.
The specified voltage can be negative or positive. To specify a negative
voltage, use a minus sign (- ). The sign of the slope selects a rising (+) or
falling (- ) edge. If no sign is specified for the slope, it is assumed to be
the rising edge.
The magnitude of the occurrence defines the occurrence to be reported.
For example, +3 returns the time for the third time the waveform crosses
the specified voltage level in the positive direction. Once this voltage
crossing is found, the oscilloscope reports the time at that crossing in
seconds, with the trigger point (time zero) as the reference.
If the specified crossing cannot be found, the oscilloscope reports
+9.9E+37. This value is returned if the waveform does not cross the
specified voltage, or if the waveform does not cross the specified voltage
for the specified number of times in the direction specified.
If the optional source parameter is specified, the current source is
modified.
NOTE
Return Format
The :MEASure:TVOLt command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:TVALue command (see page 356) for the
InfiniiVision 6000 Series oscilloscopes.
<value><NL>
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
733
7
Obsolete and Discontinued Commands
<value> ::= time in seconds of the specified voltage crossing
in NR3 format
734
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MEASure:UPPer
(see page 798)
Command Syntax
:MEASure:UPPer <value>
The :MEASure:UPPer command sets the upper measurement threshold
value. This value and the LOWer value represent absolute values when the
thresholds are ABSolute and percentage when the thresholds are PERCent
as defined by the :MEASure:DEFine THResholds command.
NOTE
Query Syntax
The :MEASure:UPPer command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MEASure:DEFine THResholds command (see page 328)
instead.
:MEASure:UPPer?
The :MEASure:UPPer? query returns the current upper threshold level.
Return Format
<value><NL>
<value> ::= the user-defined upper threshold in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 324
• ":MEASure:LOWer" on page 725
• ":MEASure:THResholds" on page 728
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
735
7
Obsolete and Discontinued Commands
:MEASure:VDELta
(see page 798)
Query Syntax
:MEASure:VDELta?
The :MEASure:VDELta? query returns the voltage difference between
vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). No
measurement is made when the :MEASure:VDELta? query is received by
the oscilloscope. The delta value that is returned is the current value. This
is the same value as the front- panel cursors delta Y value.
VDELta = value at marker 2 - value at marker 1
NOTE
Return Format
The :MEASure:VDELta command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:YDELta command (see page 317) instead.
<value><NL>
<value> ::= delta V value in NR1 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
• ":MARKer:YDELta" on page 317
• ":MEASure:TDELta" on page 727
• ":MEASure:TSTArt" on page 731
736
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MEASure:VSTArt
(see page 798)
Command Syntax
:MEASure:VSTArt <vstart_argument>
<vstart_argument> ::= value for vertical marker 1
The :MEASure:VSTArt command moves the vertical marker (Y1 cursor) to
the specified value corresponding to the selected source. The source can
be selected by the MARKer:X1Y1source command.
NOTE
The short form of this command, VSTA, does not follow the defined Long Form to Short
Form Truncation Rules (see page 800). The normal short form, VST, would be the same for
both VSTArt and VSTOp, so sending VST for the VSTArt command produces an error.
NOTE
The :MEASure:VSTArt command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:Y1Position command (see page 315) instead.
Query Syntax
:MEASure:VSTArt?
The :MEASure:VSTArt? query returns the current value of the Y1 cursor.
Return Format
<value><NL>
<value> ::= voltage at voltage marker 1 in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
• ":MARKer:YDELta" on page 317
• ":MARKer:X1Y1source" on page 311
• ":MEASure:SOURce" on page 349
• ":MEASure:TDELta" on page 727
• ":MEASure:TSTArt" on page 731
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
737
7
Obsolete and Discontinued Commands
:MEASure:VSTOp
(see page 798)
Command Syntax
:MEASure:VSTOp <vstop_argument>
<vstop_argument> ::= value for Y2 cursor
The :MEASure:VSTOp command moves the vertical marker 2 (Y2 cursor) to
the specified value corresponding to the selected source. The source can
be selected by the MARKer:X2Y2source command.
NOTE
The short form of this command, VSTO, does not follow the defined Long Form to Short
Form Truncation Rules (see page 800). The normal short form, VST, would be the same for
both VSTArt and VSTOp, so sending VST for the VSTOp command produces an error.
NOTE
The :MEASure:VSTOp command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :MARKer:Y2Position command (see page 316) instead.
Query Syntax
:MEASure:VSTOp?
The :MEASure:VSTOp? query returns the current value of the Y2 cursor.
Return Format
<value><NL>
<value> ::= value of the Y2 cursor in NR3 format
See Also
• "Introduction to :MARKer Commands" on page 308
• "Introduction to :MEASure Commands" on page 324
• ":MARKer:Y1Position" on page 315
• ":MARKer:Y2Position" on page 316
• ":MARKer:YDELta" on page 317
• ":MARKer:X2Y2source" on page 313
• ":MEASure:SOURce" on page 349
• ":MEASure:TDELta" on page 727
• ":MEASure:TSTArt" on page 731
738
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MTESt:AMASk:{SAVE | STORe}
(see page 798)
Command Syntax
:MTESt:AMASk:{SAVE | STORe} "<filename>"
The :MTESt:AMASk:SAVE command saves the automask generated mask to
a file. If an automask has not been generated, an error occurs.
The <filename> parameter is an MS- DOS compatible name of the file, a
maximum of 254 characters long (including the path name, if used). The
filename assumes the present working directory if a path does not precede
the file name.
NOTE
See Also
The :MTESt:AMASk:{SAVE | STORe} command is obsolete and is provided for backward
compatibility to previous oscilloscopes. Use the :SAVE:MASK[:STARt] command (see
page 425) instead.
• "Introduction to :MTESt Commands" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
739
7
Obsolete and Discontinued Commands
:MTESt:AVERage
(see page 798)
Command Syntax
:MTESt:AVERage <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:AVERage command enables or disables averaging. When ON,
the oscilloscope acquires multiple data values for each time bucket, and
averages them. When OFF, averaging is disabled. To set the number of
averages, use the :MTESt:AVERage:COUNt command described next.
NOTE
Query Syntax
The :MTESt:AVERage command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :ACQuire:TYPE AVERage command (see page 208) instead.
:MTESt:AVERage?
The :MTESt:AVERage? query returns the current setting for averaging.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AVERage:COUNt" on page 741
740
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MTESt:AVERage:COUNt
(see page 798)
Command Syntax
:MTESt:AVERage:COUNt <count>
<count> ::= an integer from 2 to 65536 in NR1 format
The :MTESt:AVERage:COUNt command sets the number of averages for the
waveforms. With the AVERage acquisition type, the :MTESt:AVERage:COUNt
command specifies the number of data values to be averaged for each time
bucket before the acquisition is considered complete for that time bucket.
NOTE
Query Syntax
The :MTESt:AVERage:COUNt command is obsolete and is provided for backward
compatibility to previous oscilloscopes. Use the :ACQuire:COUNt command (see page 197)
instead.
:MTESt:AVERage:COUNt?
The :MTESt:AVERage:COUNt? query returns the currently selected count
value.
Return Format
<count><NL>
<count> ::= an integer from 2 to 65536 in NR1 format
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AVERage" on page 740
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
741
7
Obsolete and Discontinued Commands
:MTESt:LOAD
(see page 798)
Command Syntax
:MTESt:LOAD "<filename>"
The :MTESt:LOAD command loads the specified mask file.
The <filename> parameter is an MS- DOS compatible name of the file, a
maximum of 254 characters long (including the path name, if used).
NOTE
See Also
The :MTESt:LOAD command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :RECall:MASK[:STARt] command (see page 412) instead.
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:AMASk:{SAVE | STORe}" on page 739
742
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MTESt:RUMode
(see page 798)
Command Syntax
:MTESt:RUMode {FORever | TIME,<seconds> | {WAVeforms,<wfm_count>}}
<seconds> ::= from 1 to 86400 in NR3 format
<wfm_count> ::= number of waveforms in NR1 format
from 1 to 1,000,000,000
The :MTESt:RUMode command determines the termination conditions for
the mask test. The choices are FORever, TIME, or WAVeforms.
• FORever — runs the Mask Test until the test is turned off.
• TIME — sets the amount of time in seconds that a mask test will run
before it terminates. The <seconds> parameter is a real number from 1
to 86400 seconds.
• WAVeforms — sets the maximum number of waveforms that are required
before the mask test terminates. The <wfm_count> parameter indicates
the number of waveforms that are to be acquired; it is an integer from
1 to 1,000,000,000.
NOTE
Query Syntax
The :MTESt:RUMode command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :MTESt:RMODe command (see page 389) instead.
:MTESt:RUMode?
The :MTESt:RUMode? query returns the currently selected termination
condition and value.
Return Format
{FOR | TIME,<seconds> | {WAV,<wfm_count>}}<NL>
<seconds> ::= from 1 to 86400 in NR3 format
<wfm_count> ::= number of waveforms in NR1 format
from 1 to 1,000,000,000
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RUMode:SOFailure" on page 744
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
743
7
Obsolete and Discontinued Commands
:MTESt:RUMode:SOFailure
(see page 798)
Command Syntax
:MTESt:RUMode:SOFailure <on_off>
<on_off> ::= {{1 | ON} | {0 | OFF}}
The :MTESt:RUMode:SOFailure command enables or disables the Stop On
Failure run until criteria. When a mask test is run and a mask violation is
detected, the mask test is stopped and the acquisition system is stopped.
NOTE
Query Syntax
The :MTESt:RUMode:SOFailure command is obsolete and is provided for backward
compatibility to previous oscilloscopes. Use the :MTESt:RMODe:FACTion:STOP command
(see page 393) instead.
:MTESt:RUMode:SOFailure?
The :MTESt:RUMode:SOFailure? query returns the current state of the Stop
on Failure control.
Return Format
<on_off><NL>
<on_off> ::= {1 | 0}
See Also
• "Introduction to :MTESt Commands" on page 372
• ":MTESt:RUMode" on page 743
744
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:MTESt:{STARt | STOP}
(see page 798)
Command Syntax
:MTESt:{STARt | STOP}
The :MTESt:{STARt | STOP} command starts or stops the acquisition
system.
NOTE
See Also
The :MTESt:STARt and :MTESt:STOP commands are obsolete and are provided for
backward compatibility to previous oscilloscopes. Use the :RUN command (see page 186)
and :STOP command (see page 190) instead.
• "Introduction to :MTESt Commands" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
745
7
Obsolete and Discontinued Commands
:MTESt:TRIGger:SOURce
(see page 798)
Command Syntax
:MTESt:TRIGger:SOURce <source>
<source> ::= CHANnel<n>
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
The :MTESt:TRIGger:SOURce command sets the channel to use as the
trigger.
NOTE
Query Syntax
The :MTESt:TRIGger:SOURce command is obsolete and is provided for backward
compatibility to previous oscilloscopes. Use the trigger source commands (see page 479)
instead.
:MTESt:TRIGger:SOURce?
The :MTESt:TRIGger:SOURce? query returns the currently selected trigger
source.
Return Format
<source> ::= CHAN<n>
<n> ::= {1 | 2 | 3 | 4} for the four channel oscilloscope models
<n> ::= {1 | 2} for the two channel oscilloscope models
See Also
746
• "Introduction to :MTESt Commands" on page 372
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:PRINt?
(see page 798)
Query Syntax
:PRINt? [<options>]
<options> ::= [<print option>][,..,<print option>]
<print option> ::= {COLor | GRAYscale | BMP8bit | BMP}
The :PRINt? query pulls image data back over the bus for storage.
NOTE
The :PRINT command is an obsolete command provided for compatibility to previous
oscilloscopes. Use the :DISPlay:DATA command (see page 259) instead.
Print Option
:PRINt command
:PRINt? query
COLor
Sets palette=COLor
GRAYscale
Sets
palette=GRAYscale
PRINter0,1
Causes the USB
printer #0,1 to be
selected as
destination (if
connected)
Not used
N/A
BMP8bit
Sets print format to
8-bit BMP
Selects 8-bit BMP
formatting for query
N/A
BMP
Sets print format to
BMP
Selects BMP
formatting for query
N/A
FACTors
Selects outputting of
additional settings
information for
:PRINT
Not used
N/A
NOFactors
Deselects outputting
of additional settings
information for
:PRINT
Not used
N/A
palette=COLor
Old Print Option:
Is Now:
HIRes
COLor
LORes
GRAYscale
PARallel
PRINter0
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Query Default
747
7
Obsolete and Discontinued Commands
NOTE
See Also
Old Print Option:
Is Now:
DISK
invalid
PCL
invalid
The PRINt? query is not a core command.
• "Introduction to Root (:) Commands" on page 153
• "Introduction to :HARDcopy Commands" on page 294
• ":HARDcopy:FORMat" on page 721
• ":HARDcopy:FACTors" on page 297
• ":HARDcopy:GRAYscale" on page 722
• ":DISPlay:DATA" on page 259
748
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:TIMebase:DELay
(see page 798)
Command Syntax
:TIMebase:DELay <delay_value>
<delay_value> ::= time in seconds from trigger to the delay reference
point on the screen.
The valid range for delay settings depends on the time/division
setting for the main time base.
The :TIMebase:DELay command sets the main time base delay. This delay
is the time between the trigger event and the delay reference point on the
screen. The delay reference point is set with the :TIMebase:REFerence
command (see page 473).
NOTE
Query Syntax
The :TIMebase:DELay command is obsolete and is provided for backward compatibility to
previous oscilloscopes. Use the :TIMebase:POSition command (see page 470) instead.
:TIMebase:DELay?
The :TIMebase:DELay query returns the current delay value.
Return Format
<delay_value><NL>
<delay_value> ::= time from trigger to display reference in seconds
in NR3 format.
Example Code
' TIMEBASE_DELAY - Sets the time base delay. This delay
' is the internal time between the trigger event and the
' onscreen delay reference point.
' Set time base delay to 0.0.
myScope.WriteString ":TIMEBASE:DELAY 0.0"
Example program from the start: "VISA COM Example in Visual Basic" on
page 824
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
749
7
Obsolete and Discontinued Commands
:TRIGger:CAN:ACKNowledge
(see page 798)
Command Syntax
:TRIGger:CAN:ACKNowledge <value>
<value> ::= {0 | OFF}
This command was used with the N2758A CAN trigger module for
54620/54640 Series mixed- signal oscilloscopes. The InfiniiVision
6000 Series oscilloscopes do not support the N2758A CAN trigger module.
Query Syntax
:TRIGger:CAN:ACKNowledge?
The :TRIGger:CAN:ACKNowledge? query returns the current CAN
acknowledge setting.
Return Format
<value><NL>
<value> ::= 0
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:TRIGger" on page 499
750
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
7
Obsolete and Discontinued Commands
:TRIGger:CAN:SIGNal:DEFinition
(see page 798)
Command Syntax
:TRIGger:CAN:SIGNal:DEFinition <value>
<value> ::= {CANH | CANL | RX | TX | DIFFerential}
The :TRIGger:CAN:SIGNal:DEFinition command sets the CAN signal type
when :TRIGger:CAN:TRIGger is set to SOF (start of frame). These signals
can be set to:
Dominant high signal:
• CANH — the actual CAN_H differential bus signal.
Dominant low signals:
• CANL — the actual CAN_L differential bus signal.
• RX — the Receive signal from the CAN bus transceiver.
• TX — the Transmit signal to the CAN bus transceiver.
• DIFFerential — the CAN differential bus signal connected to an analog
source channel using a differential probe.
NOTE
Query Syntax
With InfiniiVision 6000 Series oscilloscope software version 3.50 or greater, this command
is available, but the only legal value is DIFF.
:TRIGger:CAN:SIGNal:DEFinition?
The :TRIGger:CAN:SIGNal:DEFinition? query returns the current CAN
signal type.
Return Format
<value><NL>
<value> ::= DIFF
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:CAN:SIGNal:BAUDrate" on page 497
• ":TRIGger:CAN:SOURce" on page 498
• ":TRIGger:CAN:TRIGger" on page 499
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
751
7
Obsolete and Discontinued Commands
:TRIGger:LIN:SIGNal:DEFinition
(see page 798)
Command Syntax
:TRIGger:LIN:SIGNal:DEFinition <value>
<value> ::= {LIN | RX | TX}
The :TRIGger:LIN:SIGNal:DEFinition command sets the LIN signal type.
These signals can be set to:
Dominant low signals:
• LIN — the actual LIN single- end bus signal line.
• RX — the Receive signal from the LIN bus transceiver.
• TX — the Transmit signal to the LIN bus transceiver.
NOTE
Query Syntax
With InfiniiVision 6000 Series oscilloscope software version 3.50 or greater, this command
is available, but the only legal value is LIN.
:TRIGger:LIN:SIGNal:DEFinition?
The :TRIGger:LIN:SIGNal:DEFinition? query returns the current LIN signal
type.
Return Format
<value><NL>
<value> ::= LIN
See Also
• "Introduction to :TRIGger Commands" on page 479
• ":TRIGger:MODE" on page 485
• ":TRIGger:LIN:SIGNal:BAUDrate" on page 573
• ":TRIGger:LIN:SOURce" on page 574
752
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Obsolete and Discontinued Commands
7
:TRIGger:THReshold
(see page 798)
Command Syntax
:TRIGger:THReshold <channel group>, <threshold type> [, <value>]
<channel group> ::= {POD1 | POD2}
<threshold type> ::= {CMOS | ECL | TTL | USERdef}
<value>::= voltage for USERdef (floating-point number) [Volt type]
[Volt type] ::= {V | mV | uV}
The :TRIGger:THReshold command sets the threshold (trigger level) for a
pod of 8 digital channels (either digital channels 0 through 7 or 8 through
15). The threshold can be set to a predefined value or to a user- defined
value. For the predefined value, the voltage parameter is not required.
NOTE
This command is only available on the MSO models.
NOTE
The :TRIGger:THReshold command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :POD<n>:THReshold command (see page 407),
:DIGital<n>:THReshold command (see page 255), or :TRIGger[:EDGE]:LEVel command (see
page 513) for the InfiniiVision 6000 Series oscilloscopes.
Query Syntax
:TRIGger:THReshold? <channel group>
The :TRIGger:THReshold? query returns the voltage and threshold text for
analog channel 1 or 2, or POD1 or POD2.
Return Format
<threshold type>[, <value>]<NL>
<threshold type> ::= {CMOS | ECL | TTL | USER}
CMOS ::= 2.5V
TTL ::= 1.5V
ECL ::= -1.3V
USERdef ::= range from -8.0V to +8.0V.
<value> ::= voltage for USERdef (a floating-point number in NR1.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
753
7
Obsolete and Discontinued Commands
:TRIGger:TV:TVMode
(see page 798)
Command Syntax
:TRIGger:TV:TVMode <mode>
<mode> ::= {FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical
| LFIeld1 | LFIeld2 | LALTernate | LVERtical}
The :TRIGger:TV:MODE command selects the TV trigger mode and field.
The LVERtical parameter is only available when :TRIGger:TV:STANdard is
GENeric. The LALTernate parameter is not available when
:TRIGger:TV:STANdard is GENeric (see page 607).
Old forms for <mode> are accepted:
NOTE
Query Syntax
<mode>
Old Forms Accepted
FIEld1
F1
FIEld2
F2
AFIeld
ALLFields, ALLFLDS
ALINes
ALLLines
LFIeld1
LINEF1, LINEFIELD1
LFIeld2
LINEF2, LINEFIELD2
LALTernate
LINEAlt
LVERtical
LINEVert
The :TRIGger:TV:TVMode command is an obsolete command provided for compatibility to
previous oscilloscopes. Use the :TRIGger:TV:MODE command (see page 604) instead.
:TRIGger:TV:TVMode?
The :TRIGger:TV:TVMode? query returns the TV trigger mode.
Return Format
<value><NL>
<value> ::= {FIE1 | FIE2 | AFI | ALIN | LINE | VERT | LFI1 | LFI2
| LALT | LVER}
754
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
8
Error Messages
-440, Query UNTERMINATED after indefinite response
-430, Query DEADLOCKED
-420, Query UNTERMINATED
-410, Query INTERRUPTED
-400, Query error
-340, Calibration failed
-330, Self-test failed
-321, Out of memory
-320, Storage fault
-315, Configuration memory lost

755
8
Error Messages
-314, Save/recall memory lost
-313, Calibration memory lost
-311, Memory error
-310, System error
-300, Device specific error
-278, Macro header not found
-277, Macro redefinition not allowed
-276, Macro recursion error
-273, Illegal macro label
-272, Macro execution error
-258, Media protected
-257, File name error
-256, File name not found
756
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Error Messages
8
-255, Directory full
-254, Media full
-253, Corrupt media
-252, Missing media
-251, Missing mass storage
-250, Mass storage error
-241, Hardware missing
This message can occur when a feature is unavailable or unlicensed.
For example, serial bus decode commands (which require a four- channel
oscilloscope) are unavailable on two- channel oscilloscopes, and some serial
bus decode commands are only available on four- channel oscilloscopes
when the AMS (automotive serial decode) or LSS (low- speed serial
decode) options are licensed.
-240, Hardware error
-231, Data questionable
-230, Data corrupt or stale
-224, Illegal parameter value
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
757
8
Error Messages
-223, Too much data
-222, Data out of range
-221, Settings conflict
-220, Parameter error
-200, Execution error
-183, Invalid inside macro definition
-181, Invalid outside macro definition
-178, Expression data not allowed
-171, Invalid expression
-170, Expression error
-168, Block data not allowed
-161, Invalid block data
-158, String data not allowed
758
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Error Messages
8
-151, Invalid string data
-150, String data error
-148, Character data not allowed
-138, Suffix not allowed
-134, Suffix too long
-131, Invalid suffix
-128, Numeric data not allowed
-124, Too many digits
-123, Exponent too large
-121, Invalid character in number
-120, Numeric data error
-114, Header suffix out of range
-113, Undefined header
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
759
8
Error Messages
-112, Program mnemonic too long
-109, Missing parameter
-108, Parameter not allowed
-105, GET not allowed
-104, Data type error
-103, Invalid separator
-102, Syntax error
-101, Invalid character
-100, Command error
+10, Software Fault Occurred
+100, File Exists
+101, End-Of-File Found
+102, Read Error
760
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
8
Error Messages
+103, Write Error
+104, Illegal Operation
+105, Print Canceled
+106, Print Initialization Failed
+107, Invalid Trace File
+108, Compression Error
+109, No Data For Operation
A remote operation wants some information, but there is no information
available. For example, you may request a stored TIFF image using the
:DISPlay:DATA? query, but there may be no image stored.
+112, Unknown File Type
+113, Directory Not Supported
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
761
8
762
Error Messages
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
9
Status Reporting
Status Reporting Data Structures 766
Status Byte Register (STB) 769
Service Request Enable Register (SRE) 771
Trigger Event Register (TER) 772
Output Queue 773
Message Queue 774
(Standard) Event Status Register (ESR) 775
(Standard) Event Status Enable Register (ESE) 776
Error Queue 777
Operation Status Event Register (:OPERegister[:EVENt]) 778
Operation Status Condition Register (:OPERegister:CONDition) 779
Arm Event Register (AER) 780
Overload Event Register (:OVLRegister) 781
Hardware Event Event Register (:HWERegister[:EVENt]) 782
Hardware Event Condition Register (:HWERegister:CONDition) 783
Mask Test Event Event Register (:MTERegister[:EVENt]) 784
Clearing Registers and Queues 785
Status Reporting Decision Chart 786
IEEE 488.2 defines data structures, commands, and common bit
definitions for status reporting (for example, the Status Byte Register and
the Standard Event Status Register). There are also instrument- defined
structures and bits (for example, the Operation Status Event Register and
the Overload Event Register).
An overview of the oscilloscope's status reporting structure is shown in
the following block diagram. The status reporting structure allows
monitoring specified events in the oscilloscope. The ability to monitor and
report these events allows determination of such things as the status of an
operation, the availability and reliability of the measured data, and more.

763
9
Status Reporting
Trigger Event
Register
Error
Queue
Message
Queue
RUN
Bit
Output
Queue
(Mask)
Arm Event
Register
Overload
Event
Register
Overload
Event
Enable
Register
(Mask)
Standard
Event
Status
Register
Standard
Event
Status
Enable
Register
(Mask)
Hardware
Event
Condition/
Event
Registers
Hardware
Event
Enable
Register
Mask Test
Event
Register
Mask Test
Event
Enable
Register
Operation
Status
Condition/
Event
Registers
Operation
Status
Enable
Register
Status
Byte
Register
Service
Request
Enable
Register
Service
Request
Generation
Service
Request (SRQ)
Interrupt
to Computer
• To monitor an event, first clear the event; then, enable the event. All of
the events are cleared when you initialize the instrument.
• To allow a service request (SRQ) interrupt to an external controller,
enable at least one bit in the Status Byte Register (by setting, or
unmasking, the bit in the Service Request Enable register).
The Status Byte Register, the Standard Event Status Register group, and
the Output Queue are defined as the Standard Status Data Structure
Model in IEEE 488.2- 1987.
764
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
The bits in the status byte act as summary bits for the data structures
residing behind them. In the case of queues, the summary bit is set if the
queue is not empty. For registers, the summary bit is set if any enabled
bit in the event register is set. The events are enabled with the
corresponding event enable register. Events captured by an event register
remain set until the register is read or cleared. Registers are read with
their associated commands. The *CLS command clears all event registers
and all queues except the output queue. If you send *CLS immediately
after a program message terminator, the output queue is also cleared.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
765
9
Status Reporting
Status Reporting Data Structures
The following figure shows how the status register bits are masked and
logically OR'ed to generate service requests (SRQ) on particular events.
PLL
Locked
Bat
ON
:HWERegister:CONDition?
Hardware Event Condition Register
0
Bat
ON
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
:HWERegister[:EVENt]?
Hardware Event Event Register
0
:HWEenable
:HWEenable?
Hardware Event Enable (MASK) Register
Ext Trig Chan4 Chan3 Chan2 Chan1
Fault Fault Fault Fault Fault
15
14
13
12
11
10
9
8
7
6
Ext Trig Chan4 Chan3 Chan2 Chan1
OVL OVL OVL OVL OVL
5
4
3
2
1
:OVLR?
Overload Event Register
0
:OVL
:OVL?
Overload Event Enable (Mask) Register
OR
+
Auto
Mask
15
14
13
12
11
10
Started
9
8
7
6
5
4
3
2
Fail
Complete
1
0
:MTERegister[:EVENt]?
Mask Test Event Event Register
:MTEenable
:MTEenable?
Mask Test Event Enable (MASK) Register
OR
OR
+
+
To bits in Operation Status Condition Register:
HWE OVLR
MTE
766
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
9
Status Reporting
From Hardware
Event Registers
From Overload
Event Registers
From Mask Test
Event Registers
Arm
Reg
HWE OVLR
12
HWE OVLR
15
14
13
12
11
10
Run bit set if oscilloscope not stopped
Wait
Trig
Run
9
5
3
MTE
Wait
Trig
Run
MTE
11
AER ?
9
8
7
6
5
4
3
:OPERation:CONDition?
Operation Status Condition Register
:OPERation[:EVENt]?
Operation Status Event Register
2
1
0
:OPEE
:OPEE?
Operation Status Enable (Mask) Register
OR
+
PON
URQ
CME
EXE
DDE
QYE
RQL
OPC
7
6
5
4
3
2
1
0
*ESR?
(Standard) Event Status Register
*ESE
*ESE?
(Standard) Event Status Enable (Mask) Register
OR
+
RQS/
OPER MSS ESB
7
6
5
Output
Queue
MAV
4
3
TRG
Reg
TER?
Trigger Event Register
*STB?
Status Byte Register
MSG
USR
TRG
2
1
0
*SRE
*SRE?
Service Request Enable (Mask) Register
OR
+
SRQ
Service Request
The status register bits are described in more detail in the following
tables:
• Table 44
• Table 42
• Table 52
• Table 53
• Table 55
• Table 47
• Table 48
• Table 50
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
767
9
Status Reporting
The status registers picture above shows how the different status reporting
data structures work together. To make it possible for any of the Standard
Event Status Register bits to generate a summary bit, the bits must be
enabled. These bits are enabled by using the *ESE common command to
set the corresponding bit in the Standard Event Status Enable Register.
To generate a service request (SRQ) interrupt to an external controller, at
least one bit in the Status Byte Register must be enabled. These bits are
enabled by using the *SRE common command to set the corresponding bit
in the Service Request Enable Register. These enabled bits can then set
RQS and MSS (bit 6) in the Status Byte Register.
768
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
9
Status Reporting
Status Byte Register (STB)
The Status Byte Register is the summary- level register in the status
reporting structure. It contains summary bits that monitor activity in the
other status registers and queues. The Status Byte Register is a live
register. That is, its summary bits are set and cleared by the presence and
absence of a summary bit from other event registers or queues.
If the Status Byte Register is to be used with the Service Request Enable
Register to set bit 6 (RQS/MSS) and to generate an SRQ, at least one of
the summary bits must be enabled, then set. Also, event bits in all other
status registers must be specifically enabled to generate the summary bit
that sets the associated summary bit in the Status Byte Register.
The Status Byte Register can be read using either the *STB? Common
Command or the programming interface serial poll command. Both
commands return the decimal- weighted sum of all set bits in the register.
The difference between the two methods is that the serial poll command
reads bit 6 as the Request Service (RQS) bit and clears the bit which
clears the SRQ interrupt. The *STB? command reads bit 6 as the Master
Summary Status (MSS) and does not clear the bit or have any affect on
the SRQ interrupt. The value returned is the total bit weights of all of the
bits that are set at the present time.
The use of bit 6 can be confusing. This bit was defined to cover all
possible computer interfaces, including a computer that could not do a
serial poll. The important point to remember is that, if you are using an
SRQ interrupt to an external computer, the serial poll command clears bit
6. Clearing bit 6 allows the oscilloscope to generate another SRQ interrupt
when another enabled event occurs.
No other bits in the Status Byte Register are cleared by either the *STB?
query or the serial poll, except the Message Available bit (bit 4). If there
are no other messages in the Output Queue, bit 4 (MAV) can be cleared as
a result of reading the response to the *STB? command.
If bit 4 (weight = 16) and bit 5 (weight = 32) are set, the program prints
the sum of the two weights. Since these bits were not enabled to generate
an SRQ, bit 6 (weight = 64) is not set.
The following example uses the *STB? query to read the contents of the
oscilloscope's Status Byte Register.
myScope.WriteString "*STB?"
varQueryResult = myScope.ReadNumber
MsgBox "Status Byte Register, Read: 0x" + Hex(varQueryResult)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
769
9
Status Reporting
The next program prints 0xD1 and clears bit 6 (RQS) and bit 4 (MAV) of
the Status Byte Register. The difference in the output value between this
example and the previous one is the value of bit 6 (weight = 64). Bit 6 is
set when the first enabled summary bit is set and is cleared when the
Status Byte Register is read by the serial poll command.
Example
The following example uses the resource session object's ReadSTB method
to read the contents of the oscilloscope's Status Byte Register.
varQueryResult = myScope.IO.ReadSTB
MsgBox "Status Byte Register, Serial Poll: 0x" + Hex(varQueryResult)
NOTE
770
Use Serial Polling to Read Status Byte Register. Serial polling is the preferred method to
read the contents of the Status Byte Register because it resets bit 6 and allows the next
enabled event that occurs to generate a new SRQ interrupt.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Service Request Enable Register (SRE)
Setting the Service Request Enable Register bits enable corresponding bits
in the Status Byte Register. These enabled bits can then set RQS and MSS
(bit 6) in the Status Byte Register.
Bits are set in the Service Request Enable Register using the *SRE
command and the bits that are set are read with the *SRE? query.
Example
The following example sets bit 4 (MAV) and bit 5 (ESB) in the Service
Request Enable Register.
myScope.WriteString "*SRE " + CStr(CInt("&H30"))
This example uses the decimal parameter value of 48, the string returned
by CStr(CInt("&H30")), to enable the oscilloscope to generate an SRQ
interrupt under the following conditions:
• When one or more bytes in the Output Queue set bit 4 (MAV).
• When an enabled event in the Standard Event Status Register generates
a summary bit that sets bit 5 (ESB).
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
771
9
Status Reporting
Trigger Event Register (TER)
This register sets the TRG bit in the status byte when a trigger event
occurs.
The TER event register stays set until it is cleared by reading the register
or using the *CLS command. If your application needs to detect multiple
triggers, the TER event register must be cleared after each one.
If you are using the Service Request to interrupt a program or controller
operation, you must clear the event register each time the trigger bit is
set.
772
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Output Queue
The output queue stores the oscilloscope- to- controller responses that are
generated by certain instrument commands and queries. The output queue
generates the Message Available summary bit when the output queue
contains one or more bytes. This summary bit sets the MAV bit (bit 4) in
the Status Byte Register.
When using the Agilent VISA COM library, the output queue may be read
with the FormattedIO488 object's ReadString, ReadNumber, ReadList, or
ReadIEEEBlock methods.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
773
9
Status Reporting
Message Queue
The message queue contains the text of the last message written to the
advisory line on the screen of the oscilloscope. The length of the
oscilloscope's message queue is 1. Note that messages sent with the
:SYSTem:DSP command do not set the MSG status bit in the Status Byte
Register.
774
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
9
Status Reporting
(Standard) Event Status Register (ESR)
The (Standard) Event Status Register (ESR) monitors the following
oscilloscope status events:
• PON - Power On
• URQ - User Request
• CME - Command Error
• EXE - Execution Error
• DDE - Device Dependent Error
• QYE - Query Error
• RQC - Request Control
• OPC - Operation Complete
When one of these events occur, the event sets the corresponding bit in
the register. If the bits are enabled in the Standard Event Status Enable
Register, the bits set in this register generate a summary bit to set bit 5
(ESB) in the Status Byte Register.
You can read the contents of the Standard Event Status Register and clear
the register by sending the *ESR? query. The value returned is the total
bit weights of all of the bits that are set at the present time.
Example
The following example uses the *ESR query to read the contents of the
Standard Event Status Register.
myScope.WriteString "*ESR?"
varQueryResult = myScope.ReadNumber
MsgBox "Standard Event Status Register: 0x" + Hex(varQueryResult)
If bit 4 (weight = 16) and bit 5 (weight = 32) are set, the program prints
the sum of the two weights.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
775
9
Status Reporting
(Standard) Event Status Enable Register (ESE)
To allow any of the (Standard) Event Status Register (ESR) bits to
generate a summary bit, you must first enable that bit. Enable the bit by
using the *ESE (Event Status Enable) common command to set the
corresponding bit in the (Standard) Event Status Enable Register (ESE).
Set bits are read with the *ESE? query.
Example
Suppose your application requires an interrupt whenever any type of error
occurs. The error related bits in the (Standard) Event Status Register are
bits 2 through 5 (hexadecimal value 0x3C). Therefore, you can enable any
of these bits to generate the summary bit by sending:
myScope.WriteString "*ESE " + CStr(CInt("&H3C"))
Whenever an error occurs, it sets one of these bits in the (Standard) Event
Status Register. Because all the error related bits are enabled, a summary
bit is generated to set bit 5 (ESB) in the Status Byte Register.
If bit 5 (ESB) in the Status Byte Register is enabled (via the *SRE
command), an SRQ service request interrupt is sent to the controller PC.
NOTE
776
Disabled (Standard) Event Status Register bits respond but do not generate a summary
bit. (Standard) Event Status Register bits that are not enabled still respond to their
corresponding conditions (that is, they are set if the corresponding event occurs). However,
because they are not enabled, they do not generate a summary bit to the Status Byte
Register.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Error Queue
As errors are detected, they are placed in an error queue. This queue is
first in, first out. If the error queue overflows, the last error in the queue
is replaced with error 350, Queue overflow. Any time the queue overflows,
the least recent errors remain in the queue, and the most recent error is
discarded. The length of the oscilloscope's error queue is 30 (29 positions
for the error messages, and 1 position for the Queue overflow message).
The error queue is read with the :SYSTem:ERRor? query. Executing this
query reads and removes the oldest error from the head of the queue,
which opens a position at the tail of the queue for a new error. When all
the errors have been read from the queue, subsequent error queries return
"0, No error".
The error queue is cleared when:
• the instrument is powered up,
• the instrument receives the *CLS common command, or
• the last item is read from the error queue.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
777
9
Status Reporting
Operation Status Event Register (:OPERegister[:EVENt])
The Operation Status Event Register register hosts these bits:
Name
Location
Description
RUN bit
bit 3
Is set whenever the instrument goes from a stop
state to a single or running state.
WAIT TRIG bit
bit 5
Is set by the Trigger Armed Event Register and
indicates that the trigger is armed.
MTE bit
bit 9
Comes from the Mask Test Event Registers.
OVLR bit
bit 11
Is set whenever a 50Ω input overload occurs.
HWE bit
bit 12
Comes from the Hardware Event Registers.
If any of these bits are set, the OPER bit (bit 7) of the Status Byte
Register is set. The Operation Status Event Register is read and cleared
with the :OPERegister[:EVENt]? query. The register output is enabled or
disabled using the mask value supplied with the OPEE command.
778
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Operation Status Condition Register (:OPERegister:CONDition)
The Operation Status Condition Register register hosts these bits:
Name
Location
Description
RUN bit
bit 3
Is set whenever the instrument is not stopped.
WAIT TRIG bit
bit 5
Is set by the Trigger Armed Event Register and
indicates that the trigger is armed.
MTE bit
bit 9
Comes from the Mask Test Event Registers.
OVLR bit
bit 11
Is set whenever a 50Ω input overload occurs.
HWE bit
bit 12
Comes from the Hardware Event Registers.
The :OPERegister:CONDition? query returns the value of the Operation
Status Condition Register.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
779
9
Status Reporting
Arm Event Register (AER)
This register sets bit 5 (Wait Trig bit) in the Operation Status Register and
the OPER bit (bit 7) in the Status Byte Register when the instrument
becomes armed.
The ARM event register stays set until it is cleared by reading the register
with the AER? query or using the *CLS command. If your application
needs to detect multiple triggers, the ARM event register must be cleared
after each one.
If you are using the Service Request to interrupt a program or controller
operation when the trigger bit is set, then you must clear the event
register after each time it has been set.
780
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Overload Event Register (:OVLRegister)
The Overload Event Register register hosts these bits:
Name
Location
Description
Channel 1 OVL
bit 0
Overload has occurred on Channel 1 input.
Channel 2 OVL
bit 1
Overload has occurred on Channel 2 input.
Channel 3 OVL
bit 2
Overload has occurred on Channel 3 input.
Channel 4 OVL
bit 3
Overload has occurred on Channel 4 input.
External Trigger
OVL
bit 4
Overload has occurred on External Trigger input.
Channel 1 Fault
bit 6
Fault has occurred on Channel 1 input.
Channel 2 Fault
bit 7
Fault has occurred on Channel 2 input.
Channel 3 Fault
bit 8
Fault has occurred on Channel 3 input.
Channel 4 Fault
bit 9
Fault has occurred on Channel 4 input.
External Trigger
Fault
bit 10
Fault has occurred on External Trigger input.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
781
9
Status Reporting
Hardware Event Event Register (:HWERegister[:EVENt])
This register hosts the Bat On bit (bit 0).
• The Bat On bit is set whenever the instrument is operating on battery
power.
782
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Hardware Event Condition Register (:HWERegister:CONDition)
This register hosts the Bat On bit (bit 0) and the PLL LOCKED bit (bit
12).
• The :HWERegister:CONDition? query returns the value of the Hardware
Event Condition Register.
• The PLL LOCKED bit (bit 12) is for internal use and is not intended for
general use.
• The Bat On bit is set whenever the instrument is operating on battery
power.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
783
9
Status Reporting
Mask Test Event Event Register (:MTERegister[:EVENt])
The Mask Test Event Event Register register hosts these bits:
Name
Location
Description
Complete
bit 0
Is set when the mask test is complete.
Fail
bit 1
Is set when there is a mask test failure.
Started
bit 8
Is set when mask testing is started.
Auto Mask
bit 10
Is set when auto mask creation is completed.
The :MTERegister[:EVENt]? query returns the value of, and clears, the
Mask Test Event Event Register.
784
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Status Reporting
9
Clearing Registers and Queues
The *CLS common command clears all event registers and all queues
except the output queue. If *CLS is sent immediately after a program
message terminator, the output queue is also cleared.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
785
9
Status Reporting
Status Reporting Decision Chart
no
Do you want
to do status
reporting?
yes
Reset the instrument and
clear the status registers:
myScope.WriteString "*RST"
myScope.WriteString "*CLS"
Do you want to
send a Service Request
(SRQ) interrupt to the
controller?
no (Your programs can read the status registers instead.)
yes
Use the following to read the
Standard Event Status Register:
Do you want to
report events monitored by
the Standard Event Status
Register?
yes
Use the *ESE common command
to enable the bits you want to
use to generate the ESB summary
bit in the Status Byte Register.
Use the *SRE common command
to enable the bits you want to
generate the RQS/MSS bit to set
bit 6 in the Status Byte Register
and send an SRQ to the computer.
If events are monitored by the
Standard Event Status Register,
also enable ESB with the *SRE
command.
MN
Activate the instrument function
that you want to monitor.
myScope.WriteString "*ESR?"
varR = myScope.ReadNumber
MsgBox "ESR: 0x" + Hex(varR)
When an interrupt occurs, interrupt
handler should serial poll STB with:
varR = myScope.IO.ReadSTB
Use the following to see if an
operation is complete:
To read the Status Byte Register,
use the following:
myScope.WriteString "*OPC?"
varR = myScope.ReadNumber
MsgBox "OPC: 0x" + Hex(varR)
myScope.WriteString "*STB?"
varR = myScope.ReadNumber
MsgBox "STB: 0x" + Hex(varR)
This displays the hexadecmal value
of the Status Byte Register.
Determine which bits in the
Status Byte Register are set.
Use the following to read the
contents of the status byte:
myScope.WriteString "*STB?"
varR = myScope.ReadNumber
MsgBox "STB: 0x" + Hex(varR)
END
786
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
10
Synchronizing Acquisitions
Synchronization in the Programming Flow 788
Blocking Synchronization 789
Polling Synchronization With Timeout 790
Synchronizing with a Single-Shot Device Under Test (DUT) 792
Synchronization with an Averaging Acquisition 794
When remotely controlling an oscilloscope with programming commands, it
is often necessary to know when the oscilloscope has finished the previous
operation and is ready for the next command. The most common example
is when an acquisition is started using the :DIGitize, :RUN, or :SINGle
commands. Before a measurement result can be queried, the acquisition
must complete. Too often fixed delays are used to accomplish this wait,
but fixed delays often use excessive time or the time may not be long
enough. A better solution is to use synchronous commands and status to
know when the oscilloscope is ready for the next request.

787
10 Synchronizing Acquisitions
Synchronization in the Programming Flow
Most remote programming follows these three general steps:
1 Set up the oscilloscope and device under test (see page 788).
2 Acquire a waveform (see page 788).
3 Retrieve results (see page 788).
Set Up the Oscilloscope
Before making changes to the oscilloscope setup, it is best to make sure it
is stopped using the :STOP command followed by the *OPC? query.
NOTE
It is not necessary to use *OPC?, hard coded waits, or status checking when setting up the
oscilloscope. After the oscilloscope is configured, it is ready for an acquisition.
Acquire a Waveform
When acquiring a waveform there are two possible methods used to wait
for the acquisition to complete. These methods are blocking and polling.
The table below details when each method should be chosen and why.
Blocking Wait
Polling Wait
Use When
You know the oscilloscope will
trigger based on the oscilloscope
setup and device under test.
You know the oscilloscope may or
may not trigger on the oscilloscope
setup and device under test.
Advantages
No need for polling.
Fastest method.
Remote interface will not timeout
No need for device clear if no trigger.
Disadvantages
Remote interface may timeout.
Device clear only way to get control
of oscilloscope if there is no trigger.
Slower method.
Requires polling loop.
Requires known maximum wait time.
Implementation
Details
See "Blocking Synchronization" on
page 789.
See "Polling Synchronization With
Timeout" on page 790.
Retrieve Results
Once the acquisition is complete, it is safe to retrieve measurements and
statistics.
788
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Synchronizing Acquisitions
10
Blocking Synchronization
Use the :DIGitize command to start the acquisition. This blocks subsequent
queries until the acquisition and processing is complete. For example:
'
' Synchronizing acquisition using blocking.
' ===================================================================
Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.69.12::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
' Set up.
' ----------------------------------------------------------------myScope.WriteString ":TRIGger:MODE EDGE"
myScope.WriteString ":TRIGger:EDGE:LEVel 2"
myScope.WriteString ":TIMebase:SCALe 5e-8"
' Acquire.
' ----------------------------------------------------------------myScope.WriteString ":DIGitize"
' Get results.
' ----------------------------------------------------------------myScope.WriteString ":MEASure:RISetime"
myScope.WriteString ":MEASure:RISetime?"
varQueryResult = myScope.ReadNumber
' Read risetime.
Debug.Print "Risetime: " + _
FormatNumber(varQueryResult * 1000000000, 1) + " ns"
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
789
10 Synchronizing Acquisitions
Polling Synchronization With Timeout
This example requires a timeout value so the operation can abort if an
acquisition does not occur within the timeout period:
'
' Synchronizing acquisition using polling.
' ===================================================================
Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.69.12::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
' Set up.
' ----------------------------------------------------------------' Set up the trigger and horizontal scale.
myScope.WriteString ":TRIGger:MODE EDGE"
myScope.WriteString ":TRIGger:EDGE:LEVel 2"
myScope.WriteString ":TIMebase:SCALe 5e-8"
' Stop acquisitions and wait for the operation to complete.
myScope.WriteString ":STOP"
myScope.WriteString "*OPC?"
strQueryResult = myScope.ReadString
' Acquire.
' ----------------------------------------------------------------' Start a single acquisition.
myScope.WriteString ":SINGle"
' Oscilloscope is armed and ready, enable DUT here.
Debug.Print "Oscilloscope is armed and ready, enable DUT."
' Look for RUN bit = stopped (acquisition complete).
Dim lngTimeout As Long
' Max millisecs to wait for single-shot.
Dim lngElapsed As Long
lngTimeout = 10000
' 10 seconds.
lngElapsed = 0
Do While lngElapsed <= lngTimeout
790
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Synchronizing Acquisitions
10
myScope.WriteString ":OPERegister:CONDition?"
varQueryResult = myScope.ReadNumber
' Mask RUN bit (bit 3, &H8).
If (varQueryResult And &H8) = 0 Then
Exit Do
Else
Sleep 100
' Small wait to prevent excessive queries.
lngElapsed = lngElapsed + 100
End If
Loop
' Get results.
' ----------------------------------------------------------------If lngElapsed < lngTimeout Then
myScope.WriteString ":MEASure:RISetime"
myScope.WriteString ":MEASure:RISetime?"
varQueryResult = myScope.ReadNumber
' Read risetime.
Debug.Print "Risetime: " + _
FormatNumber(varQueryResult * 1000000000, 1) + " ns"
Else
Debug.Print "Timeout waiting for single-shot trigger."
End If
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
791
10 Synchronizing Acquisitions
Synchronizing with a Single-Shot Device Under Test (DUT)
The examples in "Blocking Synchronization" on page 789 and "Polling
Synchronization With Timeout" on page 790 assume the DUT is continually
running and therefore the oscilloscope will have more than one
opportunity to trigger. With a single shot DUT, there is only one
opportunity for the oscilloscope to trigger, so it is necessary for the
oscilloscope to be armed and ready before the DUT is enabled.
NOTE
The blocking :DIGitize command cannot be used for a single shot DUT because once the
:DIGitize command is issued, the oscilloscope is blocked from any further commands until
the acquisition is complete.
This example is the same "Polling Synchronization With Timeout" on
page 790 with the addition of checking for the armed event status.
'
' Synchronizing single-shot acquisition using polling.
' ===================================================================
Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.69.12::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
' Set up.
' ----------------------------------------------------------------' Set up the trigger and horizontal scale.
myScope.WriteString ":TRIGger:MODE EDGE"
myScope.WriteString ":TRIGger:EDGE:LEVel 2"
myScope.WriteString ":TIMebase:SCALe 5e-8"
' Stop acquisitions and wait for the operation to complete.
myScope.WriteString ":STOP"
myScope.WriteString "*OPC?"
strQueryResult = myScope.ReadString
' Acquire.
792
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Synchronizing Acquisitions
10
' ----------------------------------------------------------------' Start a single acquisition.
myScope.WriteString ":SINGle"
' Wait until the trigger system is armed.
Do
Sleep 100
' Small wait to prevent excessive queries.
myScope.WriteString ":AER?"
varQueryResult = myScope.ReadNumber
Loop Until varQueryResult = 1
' Oscilloscope is armed and ready, enable DUT here.
Debug.Print "Oscilloscope is armed and ready, enable DUT."
' Now, look for RUN bit = stopped (acquisition complete).
Dim lngTimeout As Long
' Max millisecs to wait for single-shot.
Dim lngElapsed As Long
lngTimeout = 10000
' 10 seconds.
lngElapsed = 0
Do While lngElapsed <= lngTimeout
myScope.WriteString ":OPERegister:CONDition?"
varQueryResult = myScope.ReadNumber
' Mask RUN bit (bit 3, &H8).
If (varQueryResult And &H8) = 0 Then
Exit Do
Else
Sleep 100
' Small wait to prevent excessive queries.
lngElapsed = lngElapsed + 100
End If
Loop
' Get results.
' ----------------------------------------------------------------If lngElapsed < lngTimeout Then
myScope.WriteString ":MEASure:RISetime"
myScope.WriteString ":MEASure:RISetime?"
varQueryResult = myScope.ReadNumber
' Read risetime.
Debug.Print "Risetime: " + _
FormatNumber(varQueryResult * 1000000000, 1) + " ns"
Else
Debug.Print "Timeout waiting for single-shot trigger."
End If
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
793
10 Synchronizing Acquisitions
Synchronization with an Averaging Acquisition
When averaging, it is necessary to know when the average count has been
reached. The :SINGle command does not average.
If it is known that a trigger will occur, a :DIGitize will acquire the
complete number of averages, but if the number of averages is large, a
timeout on the connection can occur.
The example below polls during the :DIGitize to prevent a timeout on the
connection.
'
' Synchronizing in averaging acquisition mode.
' ===================================================================
Option Explicit
Public
Public
Public
Public
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
Set myScope.IO = myMgr.Open("TCPIP0::130.29.69.12::inst0::INSTR")
myScope.IO.Clear
' Clear the interface.
myScope.IO.Timeout = 5000
' Set up.
' ----------------------------------------------------------------' Set up the trigger and horizontal scale.
myScope.WriteString ":TRIGger:SWEep NORMal"
myScope.WriteString ":TRIGger:MODE EDGE"
myScope.WriteString ":TRIGger:EDGE:LEVel 2"
myScope.WriteString ":TIMebase:SCALe 5e-8"
' Stop acquisitions and wait for the operation to complete.
myScope.WriteString ":STOP"
myScope.WriteString "*OPC?"
strQueryResult = myScope.ReadString
' Set up average acquisition mode.
Dim lngAverages As Long
lngAverages = 256
myScope.WriteString ":ACQuire:COUNt " + CStr(lngAverages)
myScope.WriteString ":ACQuire:TYPE AVERage"
794
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Synchronizing Acquisitions
10
' Save *ESE (Standard Event Status Enable register) mask
' (so it can be restored later).
Dim varInitialESE As Variant
myScope.WriteString "*ESE?"
varInitialESE = myScope.ReadNumber
' Set *ESE mask to allow only OPC (Operation Complete) bit.
myScope.WriteString "*ESE " + CStr(CInt("&H01"))
' Acquire using :DIGitize. Set up OPC bit to be set when the
' operation is complete.
' ----------------------------------------------------------------myScope.WriteString ":DIGitize"
myScope.WriteString "*OPC"
' Assume the oscilloscope will trigger, if not put a check here.
' Wait until OPC becomes true (bit 5 of Status Byte register, STB,
' from Standard Event Status register, ESR, is set). STB can be
' read during :DIGitize without generating a timeout.
Do
Sleep 4000
' Poll more often than the timeout setting.
varQueryResult = myScope.IO.ReadSTB
Loop While (varQueryResult And &H20) = 0
' Clear ESR and restore previously saved *ESE mask.
myScope.WriteString "*ESR?"
' Clear ESR by reading it.
varQueryResult = myScope.ReadNumber
myScope.WriteString "*ESE " + CStr(varInitialESE)
' Get results.
' ----------------------------------------------------------------myScope.WriteString ":WAVeform:COUNt?"
varQueryResult = myScope.ReadNumber
Debug.Print "Averaged waveforms: " + CStr(varQueryResult)
myScope.WriteString ":MEASure:RISetime"
myScope.WriteString ":MEASure:RISetime?"
varQueryResult = myScope.ReadNumber
' Read risetime.
Debug.Print "Risetime: " + _
FormatNumber(varQueryResult * 1000000000, 1) + " ns"
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
795
10 Synchronizing Acquisitions
796
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
11
More About Oscilloscope Commands
Command Classifications 798
Valid Command/Query Strings 799
Query Return Values 820
All Oscilloscope Commands Are Sequential 821

797
11 More About Oscilloscope Commands
Command Classifications
To help you use existing programs with your oscilloscope, or use current
programs with the next generation of Agilent InfiniiVision oscilloscopes,
commands are classified by the following categories:
• "Core Commands" on page 798
• "Non- Core Commands" on page 798
• "Obsolete Commands" on page 798
Core Commands
Core commands are a common set of commands that provide basic
oscilloscope functionality on this oscilloscope and future Agilent
InfiniiVision oscilloscopes. Core commands are unlikely to be modified in
the future. If you restrict your programs to core commands, the programs
should work across product offerings in the future, assuming appropriate
programming methods are employed.
Non-Core Commands
Non- core commands are commands that provide specific features, but are
not universal across all Agilent InfiniiVision oscilloscope models. Non- core
commands may be modified or deleted in the future. With a command
structure as complex as the one for your oscilloscope, some evolution over
time is inevitable. Agilent's intent is to continue to expand command
subsystems, such as the rich and evolving trigger feature set.
Obsolete Commands
Obsolete commands are older forms of commands that are provided to
reduce customer rework for existing systems and programs. Generally,
these commands are mapped onto some of the Core and Non- core
commands, but may not strictly have the same behavior as the new
command. None of the obsolete commands are guaranteed to remain
functional in future products. New systems and programs should use the
Core (and Non- core) commands. Obsolete commands are listed in:
• Chapter 7, “Obsolete and Discontinued Commands,” starting on page
699
• As well as: Chapter 6, “Commands A- Z,” starting on page 665
798
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
Valid Command/Query Strings
• "Program Message Syntax" on page 799
• "Command Tree" on page 803
• "Duplicate Mnemonics" on page 817
• "Tree Traversal Rules and Multiple Commands" on page 818
Program Message Syntax
To program the instrument remotely, you must understand the command
format and structure expected by the instrument. The IEEE 488.2 syntax
rules govern how individual elements such as headers, separators, program
data, and terminators may be grouped together to form complete
instructions. Syntax definitions are also given to show how query
responses are formatted. The following figure shows the main syntactical
parts of a typical program statement.
Program Message
":DISPLAY:LABEL ON"
Instruction Header
Separator
Program Data
Instructions (both commands and queries) normally appear as a string
embedded in a statement of your host language, such as Visual Basic or
C/C++. The only time a parameter is not meant to be expressed as a string
is when the instruction's syntax definition specifies <block data>, such as
<learn string>. There are only a few instructions that use block data.
Program messages can have long or short form commands (and data in
some cases — see "Long Form to Short Form Truncation Rules" on
page 800), and upper and/or lower case ASCII characters may be used.
(Query responses, however, are always returned in upper case.)
Instructions are composed of two main parts:
• The header, which specifies the command or query to be sent.
• The program data, which provide additional information needed to
clarify the meaning of the instruction.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
799
11 More About Oscilloscope Commands
Instruction
Header
The instruction header is one or more mnemonics separated by colons (:)
that represent the operation to be performed by the instrument. The
"Command Tree" on page 803 illustrates how all the mnemonics can be
joined together to form a complete header.
":DISPlay:LABel ON" is a command. Queries are indicated by adding a
question mark (?) to the end of the header, for example, ":DISPlay:LABel?".
Many instructions can be used as either commands or queries, depending
on whether or not you have included the question mark. The command
and query forms of an instruction usually have different program data.
Many queries do not use any program data.
There are three types of headers:
• "Simple Command Headers" on page 801
• "Compound Command Headers" on page 801
• "Common Command Headers" on page 802
White Space
(Separator)
White space is used to separate the instruction header from the program
data. If the instruction does not require any program data parameters, you
do not need to include any white space. White space is defined as one or
more space characters. ASCII defines a space to be character 32 (in
decimal).
Program Data
Program data are used to clarify the meaning of the command or query.
They provide necessary information, such as whether a function should be
on or off, or which waveform is to be displayed. Each instruction's syntax
definition shows the program data, as well as the values they accept.
"Program Data Syntax Rules" on page 802 describes all of the general rules
about acceptable values.
When there is more than one data parameter, they are separated by
commas(,). Spaces can be added around the commas to improve
readability.
Program
Message
Terminator
NOTE
The program instructions within a data message are executed after the
program message terminator is received. The terminator may be either an
NL (New Line) character, an EOI (End- Or- Identify) asserted in the
programming interface, or a combination of the two. Asserting the EOI
sets the EOI control line low on the last byte of the data message. The NL
character is an ASCII linefeed (decimal 10).
New Line Terminator Functions. The NL (New Line) terminator has the same function as
an EOS (End Of String) and EOT (End Of Text) terminator.
Long Form to Short Form Truncation Rules
To get the short form of a command/keyword:
800
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
11
More About Oscilloscope Commands
• When the command/keyword is longer than four characters, use the
first four characters of the command/keyword unless the fourth
character is a vowel; when the fourth character is a vowel, use the first
three characters of the command/keyword.
• When the command/keyword is four or fewer characters, use all of the
characters.
Long Form
Short form
RANGe
RANG
PATTern
PATT
TIMebase
TIM
DELay
DEL
TYPE
TYPE
In the oscilloscope programmer's documentation, the short form of a
command is indicated by uppercase characters.
Programs written in long form are easily read and are almost
self- documenting. The short form syntax conserves the amount of
controller memory needed for program storage and reduces I/O activity.
Simple Command Headers
Simple command headers contain a single mnemonic. :AUToscale and
:DIGitize are examples of simple command headers typically used in the
oscilloscope. The syntax is:
<program mnemonic><terminator>
Simple command headers must occur at the beginning of a program
message; if not, they must be preceded by a colon.
When program data must be included with the simple command header
(for example, :DIGitize CHANnel1), white space is added to separate the
data from the header. The syntax is:
<program mnemonic><separator><program data><terminator>
Compound Command Headers
Compound command headers are a combination of two or more program
mnemonics. The first mnemonic selects the subsystem, and the second
mnemonic selects the function within that subsystem. The mnemonics
within the compound message are separated by colons. For example, to
execute a single function within a subsystem:
:<subsystem>:<function><separator><program data><terminator>
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
801
11 More About Oscilloscope Commands
For example, :CHANnel1:BWLimit ON
Common Command Headers
Common command headers control IEEE 488.2 functions within the
instrument (such as clear status). Their syntax is:
*<command header><terminator>
No space or separator is allowed between the asterisk (*) and the
command header. *CLS is an example of a common command header.
Program Data Syntax Rules
Program data is used to convey a parameter information related to the
command header. At least one space must separate the command header
or query header from the program data.
<program mnemonic><separator><data><terminator>
When a program mnemonic or query has multiple program data, a comma
separates sequential program data.
<program mnemonic><separator><data>,<data><terminator>
For example, :MEASure:DELay CHANnel1,CHANnel2 has two program data:
CHANnel1 and CHANnel2.
Two main types of program data are used in commands: character and
numeric.
Character
Program Data
Character program data is used to convey parameter information as alpha
or alphanumeric strings. For example, the :TIMebase:MODE command can
be set to normal, zoomed (delayed), XY, or ROLL. The character program
data in this case may be MAIN, WINDow, XY, or ROLL. The command
:TIMebase:MODE WINDow sets the time base mode to zoomed.
The available mnemonics for character program data are always included
with the command's syntax definition.
When sending commands, you may either the long form or short form (if
one exists). Uppercase and lowercase letters may be mixed freely.
When receiving query responses, uppercase letters are used exclusively.
Numeric Program
Data
Some command headers require program data to be expressed numerically.
For example, :TIMebase:RANGe requires the desired full scale range to be
expressed numerically.
For numeric program data, you have the option of using exponential
notation or using suffix multipliers to indicate the numeric value. The
following numbers are all equal:
28 = 0.28E2 = 280e-1 = 28000m = 0.028K = 28e-3K.
802
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
When a syntax definition specifies that a number is an integer, that means
that the number should be whole. Any fractional part will be ignored,
truncating the number. Numeric data parameters accept fractional values
are called real numbers.
All numbers must be strings of ASCII characters. Thus, when sending the
number 9, you would send a byte representing the ASCII code for the
character 9 (which is 57). A three- digit number like 102 would take up
three bytes (ASCII codes 49, 48, and 50). This is handled automatically
when you include the entire instruction in a string.
Command Tree
The command tree shows all of the commands and the relationships of the
commands to each other. The IEEE 488.2 common commands are not
listed as part of the command tree because they do not affect the position
of the parser within the tree. When a program message terminator (<NL>,
linefeed- ASCII decimal 10) or a leading colon (:) is sent to the instrument,
the parser is set to the root of the command tree.
: (root)
• :ACQuire (see page 193)
• :AALias (see page 195)
• :COMPlete (see page 196)
• :COUNt (see page 197)
• :DAALias (see page 198)
• :MODE (see page 199)
• :POINts (see page 200)
• :RSIGnal (see page 201)
• :SEGMented
• :ANALyze (see page 202)
• :COUNt (see page 203)
• :INDex (see page 204)
• :SRATe (see page 207)
• :TYPE (see page 208)
• :ACTivity (see page 154)
• :AER (Arm Event Register) (see page 155)
• :AUToscale (see page 156)
• :AMODE (see page 158)
• :CHANnels (see page 159)
• :BLANk (see page 160)
• :BUS<n> (see page 210)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
803
11 More About Oscilloscope Commands
• :BIT<m> (see page 212)
• :BITS (see page 213)
• :CLEar (see page 215)
• :DISPlay (see page 216)
• :LABel (see page 217)
• :MASK (see page 218)
• :CALibrate (see page 219)
• :DATE (see page 221)
• :LABel (see page 222)
• :OUTPut (see page 223)
• :STARt (see page 224)
• :STATus (see page 225)
• :SWITch (see page 226)
• :TEMPerature (see page 227)
• :TIME (see page 228)
• :CDISplay (see page 161)
• :CHANnel<n> (see page 229)
• :BWLimit (see page 232)
• :COUPling (see page 233)
• :DISPlay (see page 234)
• :IMPedance (see page 235)
• :INVert (see page 236)
• :LABel (see page 237)
• :OFFSet (see page 238)
• :PROBe (see page 239)
• :HEAD[:TYPE] (see page 240)
• :ID (see page 241)
• :SKEW (see page 242)
• :STYPe (see page 243)
• :PROTection (see page 244)
• :RANGe (see page 245)
• :SCALe (see page 246)
• :UNITs (see page 247)
• :VERNier (see page 248)
• :DIGital<n> (see page 249)
804
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :DISPlay (see page 251)
• :LABel (see page 252)
• :POSition (see page 253)
• :SIZE (see page 254)
• :THReshold (see page 255)
• :DIGitize (see page 162)
• :DISPlay (see page 256)
• :CLEar (see page 258)
• :DATA (see page 259)
• :LABel (see page 261)
• :LABList (see page 262)
• :PERSistence (see page 263)
• :SOURce (see page 264)
• :VECTors (see page 265)
• :EXTernal (see page 266)
• :BWLimit (see page 268)
• :IMPedance (see page 269)
• :PROBe (see page 270)
• :ID (see page 271)
• :STYPe (see page 272)
• :PROTection (see page 273)
• :RANGe (see page 274)
• :UNITs (see page 275)
• :FUNCtion (see page 276)
• :CENTer (see page 279)
• :DISPlay (see page 280)
• :GOFT
• :OPERation (see page 281)
• :SOURce1 (see page 282)
• :SOURce2 (see page 283)
• :OFFSet (see page 284)
• :OPERation (see page 285)
• :RANGe (see page 286)
• :REFerence (see page 287)
• :SCALe (see page 288)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
805
11 More About Oscilloscope Commands
• :SOURce1 (see page 289)
• :SOURce2 (see page 290)
• :SPAN (see page 291)
• :WINDow (see page 292)
• :HARDcopy (see page 293)
• :AREA (see page 295)
• :APRinter (see page 296)
• :FACTors (see page 297)
• :FFEed (see page 298)
• :INKSaver (see page 299)
• :LAYout (see page 300)
• :PALette (see page 301)
• [:PRINter]
• :LIST (see page 302)
• [:STARt] (see page 303)
• :HWEenable (Hardware Event Enable Register) (see page 164)
• :HWERegister
• :CONDition (Hardware Event Condition Register) (see page 166)
• [:EVENt] (Hardware Event Event Register) (see page 168)
• :LISTer (see page 304)
• :DATA (see page 305)
• :DISPlay (see page 306)
• :MARKer (see page 307)
• :MODE (see page 309)
• :X1Position (see page 310)
• :X1Y1source (see page 311)
• :X2Position (see page 312)
• :X2Y2source (see page 313)
• :XDELta (see page 314)
• :Y1Position (see page 315)
• :Y2Position (see page 316)
• :YDELta (see page 317)
• :MEASure (see page 318)
• :CLEar (see page 326)
• :COUNter (see page 327)
806
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :DEFine (see page 328)
• :DELay (see page 331)
• :DUTYcycle (see page 333)
• :FALLtime (see page 334)
• :FREQuency (see page 335)
• :NWIDth (see page 336)
• :OVERshoot (see page 337)
• :PERiod (see page 339)
• :PHASe (see page 340)
• :PREShoot (see page 341)
• :PWIDth (see page 342)
• :RISetime (see page 346)
• :RESults (see page 343)
• :SDEViation (see page 347)
• :SHOW (see page 348)
• :SOURce (see page 349)
• :STATistics (see page 351)
• :INCRement (see page 352)
• :RESet (see page 353)
• :TEDGe (see page 354)
• :TVALue (see page 356)
• :VAMPlitude (see page 358)
• :VAVerage (see page 359)
• :VBASe (see page 360)
• :VMAX (see page 361)
• :VMIN (see page 362)
• :VPP (see page 363)
• :VRATio (see page 364)
• :VRMS (see page 365)
• :VTIMe (see page 366)
• :VTOP (see page 367)
• :XMAX (see page 368)
• :XMIN (see page 369)
• :MERGe (see page 170)
• :MTEenable (Mask Test Event Enable Register) (see page 171)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
807
11 More About Oscilloscope Commands
• :MTERegister[:EVENt] (Mask Test Event Event Register) (see page 173)
• :MTESt (see page 370)
• :AMASk
• :CREate (see page 375)
• :SOURCe (see page 376)
• :UNITs (see page 377)
• :XDELta (see page 378)
• :YDELta (see page 379)
• :COUNt
• :FWAVeforms (see page 380)
• :RESet (see page 381)
• :TIME (see page 382)
• :WAVeforms (see page 383)
• :DATA (see page 384)
• :DELete (see page 385)
• :ENABle (see page 386)
• :LOCK (see page 387)
• :OUTPut (see page 388)
• :RMODe (see page 389)
• :FACTion
• :MEASure (see page 390)
• :PRINt (see page 391)
• :SAVE (see page 392)
• :STOP (see page 393)
• :SIGMa (see page 394)
• :TIME (see page 395)
• :WAVeforms (see page 396)
• :SCALe
• :BIND (see page 397)
• :X1 (see page 398)
• :XDELta (see page 399)
• :Y1 (see page 400)
• :Y2 (see page 401)
• :SOURce (see page 402)
• :TITLe (see page 403)
808
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :OPEE (Operation Status Enable Register) (see page 175)
• :OPERegister
• :CONDition (Operation Status Condition Register) (see page 177)
• [:EVENt] (Operation Status Event Register) (see page 179)
• :OVLenable (Overload Event Enable Register) (see page 181)
• :OVLRegister (Overload Event Register) (see page 183)
• :POD<n> (see page 404)
• :DISPlay (see page 405)
• :SIZE (see page 406)
• :THReshold (see page 407)
• :RECall
• :FILename (see page 410)
• :IMAGe (see page 411)
• [:STARt] (see page 411)
• :MASK (see page 412)
• [:STARt] (see page 412)
• :PWD (see page 413)
• :SETup (see page 414)
• [:STARt] (see page 414)
• :RUN (see page 186)
• :SAVE
• :FILename (see page 417)
• :IMAGe (see page 418)
• [:STARt] (see page 418)
• :AREA (see page 419)
• :FACTors (see page 420)
• :FORMat (see page 421)
• :IGColors (see page 422)
• :PALette (see page 423)
• :LISTer (see page 424)
• [:STARt] (see page 424)
• :MASK (see page 425)
• [:STARt] (see page 425)
• :PWD (see page 426)
• :SETup (see page 427)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
809
11 More About Oscilloscope Commands
• [:STARt] (see page 427)
• :WAVeform (see page 428)
• [:STARt] (see page 428)
• :FORMat (see page 429)
• :LENGth (see page 430)
• :SEGMented (see page 431)
• :SBUS (see page 432)
• :CAN
• :COUNt
• :ERRor (see page 434)
• :OVERload (see page 435)
• :RESet (see page 436)
• :TOTal (see page 437)
• :UTILization (see page 438)
• :DISPlay (see page 439)
• :FLEXray
• :COUNt
• :NULL? (see page 440)
• :RESet (see page 441)
• :SYNC? (see page 442)
• :TOTal? (see page 443)
• :I2S
• :BASE (see page 444)
• :IIC
• :ASIZe (see page 445)
• :LIN
• :PARity (see page 446)
• :M1553
• :BASE (see page 447)
• :MODE (see page 448)
• :SPI
• :BITorder (see page 449)
• :WIDTh (see page 450)
• :UART
• :BASE (see page 451)
810
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :COUNt
• :ERRor (see page 452)
• :RESet (see page 453)
• :RXFRames (see page 454)
• :TXFRames (see page 455)
• :FRAMing (see page 456)
• :SERial (see page 187)
• :SINGle (see page 188)
• :STATus (see page 189)
• :STOP (see page 190)
• :SYSTem (see page 457)
• :DATE (see page 458)
• :DSP (see page 459)
• :ERRor (see page 460)
• :LOCK (see page 461)
• :PRECision (see page 462)
• :PROTection
• :LOCK (see page 445)
• :SETup (see page 464)
• :TIME (see page 466)
• :TER (Trigger Event Register) (see page 191)
• :TIMebase (see page 467)
• :MODE (see page 469)
• :POSition (see page 470)
• :RANGe (see page 471)
• :REFClock (see page 472)
• :REFerence (see page 473)
• :SCALe (see page 474)
• :VERNier (see page 475)
• :WINDow
• :POSition (see page 476)
• :RANGe (see page 477)
• :SCALe (see page 478)
• :TRIGger (see page 479)
• :HFReject (see page 483)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
811
11 More About Oscilloscope Commands
• :HOLDoff (see page 484)
• :MODE (see page 485)
• :NREJect (see page 486)
• :PATTern (see page 487)
• :SWEep (see page 489)
• :CAN (see page 490)
• :ACKNowledge (see page 750)
• :PATTern
• :DATA (see page 492)
• :LENGth (see page 493)
• :ID (see page 494)
• :MODE (see page 495)
• :SAMPlepoint (see page 496)
• :SIGNal
• :BAUDrate (see page 497)
• :DEFinition (see page 751)
• :SOURce (see page 498)
• :TRIGger (see page 499)
• :DURation (see page 501)
• :GREaterthan (see page 502)
• :LESSthan (see page 503)
• :PATTern (see page 504)
• :QUALifier (see page 505)
• :RANGe (see page 506)
• :EBURst (see page 507)
• :COUNt (see page 508)
• :IDLE (see page 509)
• :SLOPe (see page 510)
• [:EDGE] (see page 511)
• :COUPling (see page 512)
• :LEVel (see page 513)
• :REJect (see page 514)
• :SLOPe (see page 515)
• :SOURce (see page 516)
• :FLEXray (see page 517)
812
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :AUToset (see page 518)
• :BAUDrate (see page 519)
• :CHANnel (see page 520)
• :ERRor
• :TYPE (see page 521)
• :EVENt
• :TYPE (see page 522)
• :FRAMe
• :CCBase (see page 523)
• :CCRepetition (see page 524)
• :ID (see page 525)
• :TYPE (see page 526)
• :SOURce (see page 527)
• :TRIGger (see page 528)
• :GLITch (see page 529)
• :GREaterthan (see page 531)
• :LESSthan (see page 532)
• :LEVel (see page 533)
• :POLarity (see page 534)
• :QUALifier (see page 535)
• :RANGe (see page 536)
• :SOURce (see page 537)
• :HFReject (see page 483)
• :HOLDoff (see page 484)
• :I2S (see page 538)
• :ALIGnment (see page 540)
• :AUDio (see page 541)
• :CLOCk
• :SLOPe (see page 542)
• :PATTern
• :DATA (see page 543)
• :FORMat (see page 545)
• :RANGe (see page 546)
• :RWIDth (see page 548)
• :SOURce
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
813
11 More About Oscilloscope Commands
• :CLOCk (see page 549)
• :DATA (see page 550)
• :WSELect (see page 551)
• :TRIGger (see page 552)
• :TWIDth (see page 554)
• :WSLow (see page 555)
• :IIC (see page 556)
• :PATTern
• :ADDRess (see page 557)
• :DATA (see page 558)
• :DATa2 (see page 559)
• :SOURce
• :CLOCk (see page 560)
• :DATA (see page 561)
• :TRIGger
• :QUALifier (see page 562)
• [:TYPE] (see page 563)
• :LIN (see page 565)
• :ID (see page 567)
• :PATTern
• :DATA (see page 568)
• :LENGth (see page 570)
• :FORMat (see page 571)
• :SAMPlepoint (see page 572)
• :SIGNal
• :BAUDrate (see page 573)
• :DEFinition (see page 752)
• :SOURce (see page 574)
• :STANdard (see page 575)
• :SYNCbreak (see page 576)
• :TRIGger (see page 577)
• :M1553 (see page 578)
• :AUTosetup (see page 579)
• :PATTern
• :DATA (see page 580)
814
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
• :RTA (see page 581)
• :SOURce
• :LOWer (see page 582)
• :UPPer (see page 583)
• :TYPE (see page 584)
• :MODE (see page 485)
• :NREJect (see page 486)
• :PATTern (see page 487)
• :SEQuence (see page 585)
• :COUNt (see page 586)
• :EDGE (see page 587)
• :FIND (see page 588)
• :PATTern (see page 589)
• :RESet (see page 590)
• :TIMer (see page 591)
• :TRIGger (see page 592)
• :SPI (see page 593)
• :CLOCk
• :SLOPe (see page 594)
• :TIMeout (see page 595)
• :FRAMing (see page 596)
• :PATTern
• :DATA (see page 597)
• :WIDTh (see page 598)
• :SOURce
• :CLOCk (see page 599)
• :DATA (see page 600)
• :FRAMe (see page 601)
• :SWEep (see page 489)
• :TV (see page 602)
• :LINE (see page 603)
• :MODE (see page 604)
• :POLarity (see page 605)
• :SOURce (see page 606)
• :STANdard (see page 607)
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
815
11 More About Oscilloscope Commands
• :TVMode (see page 754)
• :UART (see page 608)
• :BASE (see page 610)
• :BAUDrate (see page 611)
• :BITorder (see page 612)
• :BURSt (see page 613)
• :DATA (see page 614)
• :IDLE (see page 615)
• :PARity (see page 616)
• :QUALifier (see page 618)
• :POLarity (see page 617)
• :SOURce
• :RX (see page 619)
• :TX (see page 620)
• :TYPE (see page 621)
• :WIDTh (see page 622)
• :USB (see page 623)
• :SOURce
• :DMINus (see page 624)
• :DPLus (see page 625)
• :SPEed (see page 626)
• :TRIGger (see page 627)
• :VIEW (see page 192)
• :WAVeform (see page 628)
• :BYTeorder (see page 636)
• :COUNt (see page 637)
• :DATA (see page 638)
• :FORMat (see page 640)
• :POINts (see page 641)
• :MODE (see page 643)
• :PREamble (see page 645)
• :SEGMented
• :COUNt (see page 648)
• :TTAG (see page 649)
• :SOURce (see page 650)
816
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
11
More About Oscilloscope Commands
• :SUBSource (see page 654)
• :TYPE (see page 655)
• :UNSigned (see page 656)
• :VIEW (see page 657)
• :XINCrement (see page 658)
• :XORigin (see page 659)
• :XREFerence (see page 660)
• :YINCrement (see page 661)
• :YORigin (see page 662)
• :YREFerence (see page 663)
Common
Commands (IEEE
488.2)
• *CLS (see page 129)
• *ESE (see page 130)
• *ESR (see page 132)
• *IDN (see page 134)
• *LRN (see page 135)
• *OPC (see page 136)
• *OPT (see page 137)
• *RCL (see page 139)
• *RST (see page 140)
• *SAV (see page 143)
• *SRE (see page 144)
• *STB (see page 146)
• *TRG (see page 148)
• *TST (see page 149)
• *WAI (see page 150)
Duplicate Mnemonics
Identical function mnemonics can be used in more than one subsystem.
For example, the function mnemonic RANGe may be used to change the
vertical range or to change the horizontal range:
:CHANnel1:RANGe .4
Sets the vertical range of channel 1 to 0.4 volts full scale.
:TIMebase:RANGe 1
Sets the horizontal time base to 1 second full scale.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
817
11 More About Oscilloscope Commands
:CHANnel1 and :TIMebase are subsystem selectors and determine which
range is being modified.
Tree Traversal Rules and Multiple Commands
Command headers are created by traversing down the Command Tree (see
page 803). A legal command header would be :TIMebase:RANGe. This is
referred to as a compound header. A compound header is a header made
of two or more mnemonics separated by colons. The mnemonic created
contains no spaces.
The following rules apply to traversing the tree:
• A leading colon (<NL> or EOI true on the last byte) places the parser at
the root of the command tree. A leading colon is a colon that is the
first character of a program header. Executing a subsystem command
lets you access that subsystem until a leading colon or a program
message terminator (<NL>) or EOI true is found.
• In the command tree, use the last mnemonic in the compound header
as the reference point (for example, RANGe). Then find the last colon
above that mnemonic (TIMebase:). That is the point where the parser
resides. Any command below that point can be sent within the current
program message without sending the mnemonics which appear above
them (for example, POSition).
The output statements in the examples are written using the Agilent VISA
COM library in Visual Basic. The quoted string is placed on the bus,
followed by a carriage return and linefeed (CRLF).
To execute more than one function within the same subsystem, separate
the functions with a semicolon (;):
:<subsystem>:<function><separator><data>;<function><separator><data><ter
minator>
For example:
myScope.WriteString ":TIMebase:RANGe 0.5;POSition 0"
NOTE
818
The colon between TIMebase and RANGe is necessary because TIMebase:RANGe is a
compound command. The semicolon between the RANGe command and the POSition
command is the required program message unit separator. The POSition command does not
need TIMebase preceding it because the TIMebase:RANGe command sets the parser to the
TIMebase node in the tree.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
Example 2:
Program
Message
Terminator Sets
Parser Back to
Root
NOTE
11
myScope.WriteString ":TIMebase:REFerence CENTer;POSition 0.00001"
or
myScope.WriteString ":TIMebase:REFerence CENTer"
myScope.WriteString ":TIMebase:POSition 0.00001"
In the first line of example 2, the subsystem selector is implied for the POSition command in
the compound command. The POSition command must be in the same program message as
the REFerence command because the program message terminator places the parser back
at the root of the command tree.
A second way to send these commands is by placing TIMebase: before the
POSition command as shown in the second part of example 2. The space
after POSition is required.
Example 3:
Selecting
Multiple
Subsystems
You can send multiple program commands and program queries for
different subsystems on the same line by separating each command with a
semicolon. The colon following the semicolon enables you to enter a new
subsystem. For example:
<program mnemonic><data>;:<program mnemonic><data><terminator>
For example:
myScope.WriteString ":TIMebase:REFerence CENTer;:DISPlay:VECTors ON"
NOTE
The leading colon before DISPlay:VECTors ON tells the parser to go back to the root of the
command tree. The parser can then see the DISPlay:VECTors ON command. The space
between REFerence and CENter is required; so is the space between VECTors and ON.
Multiple commands may be any combination of compound and simple
commands.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
819
11 More About Oscilloscope Commands
Query Return Values
Command headers immediately followed by a question mark (?) are
queries. Queries are used to get results of measurements made by the
instrument or to find out how the instrument is currently configured.
After receiving a query, the instrument interrogates the requested function
and places the answer in its output queue. The answer remains in the
output queue until it is read or another command is issued.
When read, the answer is transmitted across the bus to the designated
listener (typically a controller). For example, the query :TIMebase:RANGe?
places the current time base setting in the output queue. When using the
Agilent VISA COM library in Visual Basic, the controller statements:
Dim strQueryResult As String
myScope.WriteString ":TIMebase:RANGe?"
strQueryResult = myScope.ReadString
pass the value across the bus to the controller and place it in the variable
strQueryResult.
NOTE
Infinity
Representation
820
Read Query Results Before Sending Another Command. Sending another command or
query before reading the result of a query clears the output buffer (the current response)
and places a Query INTERRUPTED error in the error queue.
The representation of infinity is +9.9E+37. This is also the value returned
when a measurement cannot be made.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
More About Oscilloscope Commands
11
All Oscilloscope Commands Are Sequential
IEEE 488.2 makes the distinction between sequential and overlapped
commands:
• Sequential commands finish their task before the execution of the next
command starts.
• Overlapped commands run concurrently. Commands following an
overlapped command may be started before the overlapped command is
completed.
All of the oscilloscope commands are sequential.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
821
11 More About Oscilloscope Commands
822
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Agilent InfiniiVision 6000 Series Oscilloscopes
Programmer's Guide
12
Programming Examples
VISA COM Examples 824
VISA Examples 857
SICL Examples 903
Example programs are ASCII text files that can be cut from the help file
and pasted into your favorite text editor.

823
12 Programming Examples
VISA COM Examples
• "VISA COM Example in Visual Basic" on page 824
• "VISA COM Example in C#" on page 834
• "VISA COM Example in Visual Basic .NET" on page 846
VISA COM Example in Visual Basic
To run this example in Visual Basic for Applications (VBA):
1 Start the application that provides Visual Basic for Applications (for
example, Microsoft Excel).
2 Press ALT+F11 to launch the Visual Basic editor.
3 Reference the Agilent VISA COM library:
a Choose Tools>References... from the main menu.
b In the References dialog, check the "VISA COM 3.0 Type Library".
c Click OK.
4 Choose Insert>Module.
5 Cut- and- paste the code that follows into the editor.
6 Edit the program to use the VISA address of your oscilloscope, and save
the changes.
7 Run the program.
'
'
'
'
'
'
Agilent VISA COM Example in Visual Basic
------------------------------------------------------------------This program illustrates most of the commonly used programming
features of your Agilent oscilloscopes.
-------------------------------------------------------------------
Option Explicit
Public
Public
Public
Public
'
'
'
'
'
'
'
'
'
'
'
824
myMgr As VisaComLib.ResourceManager
myScope As VisaComLib.FormattedIO488
varQueryResult As Variant
strQueryResult As String
MAIN PROGRAM
------------------------------------------------------------------This example shows the fundamental parts of a program (initialize,
capture, analyze).
The commands sent to the oscilloscope are written in both long and
short form. Both forms are acceptable.
The input signal is the probe compensation signal from the front
panel of the oscilloscope connected to channel 1.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
12
Programming Examples
'
' If you are using a different signal or different channels, these
' commands may not work as explained in the comments.
' ------------------------------------------------------------------Sub Main()
On Error GoTo VisaComError
' Create the VISA COM I/O resource.
Set myMgr = New VisaComLib.ResourceManager
Set myScope = New VisaComLib.FormattedIO488
' GPIB.
'Set myScope.IO = myMgr.Open("GPIB0::7::INSTR")
' LAN.
'Set myScope.IO = myMgr.Open("TCPIP0::a-mso6102-90541::inst0::INSTR")
' USB.
Set myScope.IO = myMgr.Open("USB0::2391::5970::30D3090541::0::INSTR")
' Initialize - Initialization will start the program with the
' oscilloscope in a known state.
Initialize
' Capture - After initialization, you must make waveform data
' available to analyze. To do this, capture the data using the
' DIGITIZE command.
Capture
' Analyze - Once the waveform has been captured, it can be analyzed.
' There are many parts of a waveform to analyze. This example shows
' some of the possible ways to analyze various parts of a waveform.
Analyze
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
'
'
'
'
'
'
'
'
'
'
'
'
'
'
Initialize
------------------------------------------------------------------Initialize will start the program with the oscilloscope in a known
state. This is required because some uninitialized conditions could
cause the program to fail or not perform as expected.
In
-
this example, we initialize the following:
Oscilloscope
Channel 1 range
Display Grid
Timebase reference, range, and delay
Trigger mode and type
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
825
12 Programming Examples
' There are also some additional initialization commands, which are
' not used, but shown for reference.
' ------------------------------------------------------------------Private Sub Initialize()
On Error GoTo VisaComError
' Clear the interface.
myScope.IO.Clear
' 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.
' AUTOSCALE - This command evaluates all the input signals and sets
' the correct conditions to display all of the active signals.
' Same as pressing the Autoscale key.
myScope.WriteString ":AUTOSCALE"
' CHANNEL_PROBE - Sets the probe attenuation factor for the selected
' channel. The probe attenuation factor may be set from 0.1 to 1000.
myScope.WriteString ":CHAN1:PROBE 10"
' Set Probe to 10:1.
' CHANNEL_RANGE - Sets the full scale vertical range in volts.
' range value is 8 times the volts per division.
The
' Set the vertical range to 8 volts.
myScope.WriteString ":CHANNEL1:RANGE 8"
' TIME_RANGE - Sets the full scale horizontal time in seconds.
' range value is 10 times the time per division.
The
' Set the time range to 0.002 seconds.
myScope.WriteString ":TIM:RANG 2e-3"
' TIME_REFERENCE - Possible values are LEFT and CENTER.
' - LEFT sets the display reference on time division from the left.
' - CENTER sets the display reference to the center of the screen.
' Set reference to center.
myScope.WriteString ":TIMEBASE:REFERENCE CENTER"
' TRIGGER_TV_SOURCE - Selects the channel that actually produces the
' TV trigger. Any channel can be selected.
myScope.WriteString ":TRIGGER:TV:SOURCE CHANNEL1"
' TRIGGER_MODE - Set the trigger mode to EDGE, GLITch, PATTern, CAN,
' DURation, IIC, LIN, SEQuence, SPI, TV, or USB.
' Set the trigger mode to EDGE.
myScope.WriteString ":TRIGGER:MODE EDGE"
826
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
Programming Examples
12
' TRIGGER_EDGE_SLOPE - Sets the slope of the edge for the trigger.
' Set the slope to positive.
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"
' The following commands are not executed and are shown for reference
' purposes only. To execute these commands, uncomment them.
' RUN_STOP - (not executed in this example)
' - RUN starts the acquisition of data for the active waveform
'
display.
' - STOP stops the data acquisition and turns off AUTOSTORE.
' myScope.WriteString ":RUN"
' Start data acquisition.
' myScope.WriteString ":STOP"
' Stop the data acquisition.
' VIEW_BLANK - (not executed in this example)
' - VIEW turns on (starts displaying) a channel or pixel memory.
' - BLANK turns off (stops displaying) a channel or pixel memory.
' myScope.WriteString ":BLANK CHANNEL1"
' Turn channel 1 off.
' myScope.WriteString ":VIEW CHANNEL1"
' Turn channel 1 on.
' TIMEBASE_MODE - (not executed in this example)
' Set the time base mode to MAIN, DELAYED, XY, or ROLL.
' Set time base mode to main.
' myScope.WriteString ":TIMEBASE:MODE MAIN"
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
'
'
'
'
'
Capture
------------------------------------------------------------------We will capture the waveform using the digitize command.
-------------------------------------------------------------------
Private Sub Capture()
On Error GoTo VisaComError
' AQUIRE_TYPE - Sets the acquisition mode, which can be NORMAL,
' PEAK, or AVERAGE.
myScope.WriteString ":ACQUIRE:TYPE NORMAL"
' AQUIRE_COMPLETE - Specifies the minimum completion criteria for
' an acquisition. The parameter determines the percentage of time
' buckets needed to be "full" before an acquisition is considered
' to be complete.
myScope.WriteString ":ACQUIRE:COMPLETE 100"
' 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.
Agilent InfiniiVision 6000 Series Oscilloscopes Programmer's Guide
827
12 Programming Examples
'
' 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;
' 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"
Exit Sub
VisaComError:
MsgBox "VISA COM Error:" + vbCrLf + Err.Description
End Sub
'
'
'
'
'
'
'
'
'
'
Analyze
------------------------------------------------------------------In analyze, we will do the following:
- Save the system setup to a file and restore it.
- Save the waveform data to a file on the computer.
- Make single channel measurements.
- Save the oscilloscope display to a file that can be sent to a
printer.
-------------------------------------------------------------------
Private Sub Analyze()
On Error GoTo VisaComError
' SAVE_SYS