Agilent DSOX3034A Programmer Guide

Download

Agilent InfiniiVision 3000 X-Series Oscilloscopes

Programmer's Guide

Notices

CAUTION

WARNING

No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws.

Trademarks

Microsoft®, MS-DOS®, Windows®, Windows 2000®, and Windows XP® are U.S. registered trademarks of Microsoft Corporation.

Adobe®, Acrobat®, and the Acrobat Logo® are trademarks of Adobe Systems Incorporated.

Manual Part Number

Version 02.10.0001

Edition

March 2, 2012

Available in electronic format only

Agilent Technologies, Inc. 1900 Garden of the Gods Road Colorado Springs, CO 80907 USA

Warranty

The material contained in this document is provided “as is,” and is subject to being changed, without notice, in future editions. Further, to the maximum extent permitted by applicable law, Agilent disclaims all warranties, either express or implied, with regard to this manual and any information contained herein, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Agilent shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein. Should Agilent and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these terms, the warranty terms in the separate agreement shall control.

Technology Licenses

The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license.

Restricted Rights Legend

agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Agilent Technologies’ standard commercial license terms, and non-DOD Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as defined in FAR

52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than Limited Rights as defined in FAR 52.227-14 (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any technical data.

Safety Notices

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.

A WARNING notice denotes a hazard. It calls attention to an operating procedure, practice, or the like that, if not correctly performed or adhered to, could result in personal injury or death. Do not proceed beyond a WARNING notice until the indicated conditions are fully understood and met.

If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as “Commercial computer software” as defined in DFAR 252.227-7014 (June 1995), or as a “commercial item” as defined in FAR 2.101(a) or as “Restricted computer software” as defined in FAR

52.227-19 (June 1987) or any equivalent

In This Book

This book is your guide to programming the 3000 X-Series oscilloscopes:

Table 1 InfiniiVision 3000 X-Series Oscilloscope Models, Bandwidths, Sample Rates

Bandwidth 100 MHz 200 MHz 350 MHz 500 MHz 1 GHz

Sample Rate (interleaved, non-interleaved)

4 analog + 16 digital (mixed signal) channels

2 analog + 16 digital (mixed signal) channels

4 analog channels DSO-X 3014A DSO-X 3024A DSO-X 3034A DSO-X 3054A DSO-X 3104A

2 analog channels DSO-X 3012A DSO-X 3032A DSO-X 3052A DSO-X 3102A

4GSa/s, 2GSa/s

MSO-X 3014A MSO-X 3024A MSO-X 3034A MSO-X 3054A MSO-X 3104A

MSO-X 3012A MSO-X 3032A MSO-X 3052A MSO-X 3102A

4GSa/s, 2GSa/s

5GSa/s,

2.5 GSa/s

The first few chapters describe how to set up and get started:

• Chapter 1, “What's New,” starting on page 31, describes programming

command changes in the latest version of oscilloscope software.

• Chapter 2, “Setting Up,” starting on page 45, describes the steps you

must take before you can program the oscilloscope.

• Chapter 3, “Getting Started,” starting on page 55, gives a general

overview of oscilloscope program structure and shows how to program the oscilloscope using a few simple examples.

• Chapter 4, “Commands Quick Reference,” starting on page 69, is a brief

listing of the 3000 X-Series oscilloscope commands and syntax.

The next chapters provide reference information on common commands, root level commands, other subsystem commands, and error messages:

• Chapter 5, “Common (*) Commands,” starting on page 153, describes

commands defined by the IEEE 488.2 standard that are common to all instruments.

• Chapter 6, “Root (:) Commands,” starting on page 179, describes

commands that reside at the root level of the command tree and control many of the basic functions of the oscilloscope.

• Chapter 7, “:ACQuire Commands,” starting on page 219, describes

commands for setting the parameters used when acquiring and storing data.

• Chapter 8, “:BUS<n> Commands,” starting on page 233, describes

commands that control all oscilloscope functions associated with the digital channels bus display.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 3

• Chapter 9, “:CALibrate Commands,” starting on page 243, describes

utility commands for determining the state of the calibration factor protection button.

• Chapter 10, “:CHANnel<n> Commands,” starting on page 253, describes

commands that control all oscilloscope functions associated with individual analog channels or groups of channels.

• Chapter 11, “:DEMO Commands,” starting on page 273, describes

commands that control the education kit (Option EDU) demonstration signals that can be output on the oscilloscope's Demo 1 and Demo 2 terminals.

• Chapter 12, “:DIGital<d> Commands,” starting on page 281, describes

commands that control all oscilloscope functions associated with individual digital channels.

• Chapter 13, “:DISPlay Commands,” starting on page 289, describes

commands that control how waveforms, graticule, and text are displayed and written on the screen.

• Chapter 14, “:EXTernal Trigger Commands,” starting on page 301,

describes commands that control the input characteristics of the external trigger input.

• Chapter 15, “:FUNCtion Commands,” starting on page 307, describes

commands that control math waveforms.

• Chapter 16, “:HARDcopy Commands,” starting on page 341, describes

commands that set and query the selection of hardcopy device and formatting options.

• Chapter 17, “:LISTer Commands,” starting on page 359, describes

commands that turn on/off the Lister display for decoded serial data and get the Lister data.

• Chapter 18, “:MARKer Commands,” starting on page 363, describes

commands that set and query the settings of X- axis markers (X1 and X2 cursors) and the Y-axis markers (Y1 and Y2 cursors).

• Chapter 19, “:MEASure Commands,” starting on page 379, describes

commands that select automatic measurements (and control markers).

• Chapter 20, “:MEASure Power Commands,” starting on page 447,

describes measurement commands that are available when the DSOX3PWR power measurements and analysis application is licensed and enabled.

• Chapter 21, “:MTESt Commands,” starting on page 467, describes

commands that control the mask test features provided with Option LMT.

• Chapter 22, “:POD Commands,” starting on page 501, describes

commands that control all oscilloscope functions associated with groups of digital channels.

• Chapter 23, “:POWer Commands,” starting on page 507, describes

commands that control the DSOX3PWR power measurement application.

4 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

• Chapter 24, “:RECall Commands,” starting on page 565, describes

commands that recall previously saved oscilloscope setups, reference waveforms, or masks.

• Chapter 25, “:SAVE Commands,” starting on page 573, describes

commands that save oscilloscope setups, screen images, and data.

• Chapter 26, “:SBUS<n> Commands,” starting on page 595, describes

commands that control oscilloscope functions associated with the serial decode bus and serial triggering.

• Chapter 27, “:SEARch Commands,” starting on page 743, describes

commands that control oscilloscope functions associated with searching for waveform events.

• Chapter 28, “:SYSTem Commands,” starting on page 817, describes

commands that control basic system functions of the oscilloscope.

• Chapter 29, “:TIMebase Commands,” starting on page 831, describes

commands that control all horizontal sweep functions.

• Chapter 30, “:TRIGger Commands,” starting on page 843, describes

commands that control the trigger modes and parameters for each trigger type.

• Chapter 31, “:WAVeform Commands,” starting on page 923, describes

commands that provide access to waveform data.

• Chapter 32, “:WGEN Commands,” starting on page 959, describes

commands that control waveform generator (Option WGN) functions and parameters.

• Chapter 33, “:WMEMory<r> Commands,” starting on page 985, describes

commands that control reference waveforms.

• Chapter 34, “Obsolete and Discontinued Commands,” starting on page

995, describes obsolete commands which still work but have been replaced by newer commands and discontinued commands which are no longer supported.

• Chapter 35, “Error Messages,” starting on page 1047, 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 36, “Status Reporting,” starting on page 1055, describes the

oscilloscope's status registers and how to check the status of the instrument.

• Chapter 37, “Synchronizing Acquisitions,” starting on page 1077,

describes how to wait for acquisitions to complete before querying

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 5

measurement results or performing other operations with the captured data.

• Chapter 38, “More About Oscilloscope Commands,” starting on page

1087, contains additional information about oscilloscope programming commands.

Finally, there is a chapter that contains programming examples:

• Chapter 39, “Programming Examples,” starting on page 1097.

Mixed-Signal

Oscilloscope

Channel

Differences

See Also • For more information on using the SICL, VISA, and VISA COM libraries

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.

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 82350B 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/3000X- Series- manual"

6 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

1 What's New

2 Setting Up

In This Book 3

What's New in Version 2.10 32

What's New in Version 2.00 33

What's New in Version 1.20 37

What's New in Version 1.10 39

Version 1.00 at Introduction 40

Command Differences From 7000B Series Oscilloscopes 41

Step 1. Install Agilent IO Libraries Suite software 46

Step 2. Connect and set up the oscilloscope 47

Using the USB (Device) Interface 47 Using the LAN Interface 47 Using the GPIB Interface 48

Step 3. Verify the oscilloscope connection 49

3 Getting Started

Basic Oscilloscope Program Structure 56

Initializing 56 Capturing Data 56 Analyzing Captured Data 57

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 7

Programming the Oscilloscope 58

Referencing the IO Library 58 Opening the Oscilloscope Connection via the IO Library 59 Initializing the Interface and the Oscilloscope 59 Using :AUToscale to Automate Oscilloscope Setup 60 Using Other Oscilloscope Setup Commands 60 Capturing Data with the :DIGitize Command 61 Reading Query Responses from the Oscilloscope 63 Reading Query Results into String Variables 64 Reading Query Results into Numeric Variables 64 Reading Definite-Length Block Query Response Data 64 Sending Multiple Queries and Reading Results 65 Checking Instrument Status 66

Other Ways of Sending Commands 67

Tel ne t Soc ke ts 67 Sending SCPI Commands Using Browser Web Control 67

4 Commands Quick Reference

Command Summary 70

Syntax Elements 149

Number Format 149 <NL> (Line Terminator) 149 [ ] (Optional Syntax Terms) 149 { } (Braces) 149 ::= (Defined As) 149 < > (Angle Brackets) 150 ... (Ellipsis) 150 n,..,p (Value Ranges) 150 d (Digits) 150 Quoted ASCII String 150 Definite-Length Block Response Data 150

5 Common (*) Commands

*CLS (Clear Status) 157 *ESE (Standard Event Status Enable) 158 *ESR (Standard Event Status Register) 160 *IDN (Identification Number) 162 *LRN (Learn Device Setup) 163 *OPC (Operation Complete) 164 *OPT (Option Identification) 165

8 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

*RCL (Recall) 167 *RST (Reset) 168 *SAV (Save) 171 *SRE (Service Request Enable) 172 *STB (Read Status Byte) 174 *TRG (Trigger) 176 *TST (Self Test) 177 *WAI (Wait To Continue) 178

6 Root (:) Commands

:ACTivity 183 :AER (Arm Event Register) 184 :AUToscale 185 :AUToscale:AMODE 187 :AUToscale:CHANnels 188 :AUToscale:FDEBug 189 :BLANk 190 :DIGitize 191 :MTEenable (Mask Test Event Enable Register) 193 :MTERegister[:EVENt] (Mask Test Event Event Register) 195 :OPEE (Operation Status Enable Register) 197 :OPERegister:CONDition (Operation Status Condition Register) 199 :OPERegister[:EVENt] (Operation Status Event Register) 201 :OVLenable (Overload Event Enable Register) 203 :OVLRegister (Overload Event Register) 205 :PRINt 207 :PWRenable (Power Event Enable Register) 208 :PWRRegister[:EVENt] (Power Event Event Register) 210 :RUN 211 :SERial 212 :SINGle 213 :STATus 214 :STOP 215 :TER (Trigger Event Register) 216 :VIEW 217

7 :ACQuire Commands

:ACQuire:COMPlete 221 :ACQuire:COUNt 222 :ACQuire:MODE 223 :ACQuire:POINts 224

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 9

:ACQuire:SEGMented:ANALyze 225 :ACQuire:SEGMented:COUNt 226 :ACQuire:SEGMented:INDex 227 :ACQuire:SRATe 230 :ACQuire:TYPE 231

8 :BUS<n> Commands

:BUS<n>:BIT<m> 235 :BUS<n>:BITS 236 :BUS<n>:CLEar 238 :BUS<n>:DISPlay 239 :BUS<n>:LABel 240 :BUS<n>:MASK 241

9 :CALibrate Commands

:CALibrate:DATE 245 :CALibrate:LABel 246 :CALibrate:OUTPut 247 :CALibrate:PROTected 248 :CALibrate:STARt 249 :CALibrate:STATus 250 :CALibrate:TEMPerature 251 :CALibrate:TIME 252

10 :CHANnel<n> Commands

:CHANnel<n>:BWLimit 256 :CHANnel<n>:COUPling 257 :CHANnel<n>:DISPlay 258 :CHANnel<n>:IMPedance 259 :CHANnel<n>:INVert 260 :CHANnel<n>:LABel 261 :CHANnel<n>:OFFSet 262 :CHANnel<n>:PROBe 263 :CHANnel<n>:PROBe:HEAD[:TYPE] 264 :CHANnel<n>:PROBe:ID 265 :CHANnel<n>:PROBe:SKEW 266 :CHANnel<n>:PROBe:STYPe 267 :CHANnel<n>:PROTection 268 :CHANnel<n>:RANGe 269 :CHANnel<n>:SCALe 270 :CHANnel<n>:UNITs 271

10 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:CHANnel<n>:VERNier 272

11 :DEMO Commands

:DEMO:FUNCtion 274 :DEMO:FUNCtion:PHASe:PHASe 278 :DEMO:OUTPut 279

12 :DIGital<d> Commands

:DIGital<d>:DISPlay 283 :DIGital<d>:LABel 284 :DIGital<d>:POSition 285 :DIGital<d>:SIZE 286 :DIGital<d>:THReshold 287

13 :DISPlay Commands

:DISPlay:ANNotation 291 :DISPlay:ANNotation:BACKground 292 :DISPlay:ANNotation:COLor 293 :DISPlay:ANNotation:TEXT 294 :DISPlay:CLEar 295 :DISPlay:DATA 296 :DISPlay:LABel 297 :DISPlay:LABList 298 :DISPlay:PERSistence 299 :DISPlay:VECTors 300

14 :EXTernal Trigger Commands

:EXTernal:BWLimit 302 :EXTernal:PROBe 303 :EXTernal:RANGe 304 :EXTernal:UNITs 305

15 :FUNCtion Commands

:FUNCtion:BUS:CLOCk 312 :FUNCtion:BUS:SLOPe 313 :FUNCtion:BUS:YINCrement 314 :FUNCtion:BUS:YORigin 315 :FUNCtion:BUS:YUNits 316 :FUNCtion:DISPlay 317 :FUNCtion[:FFT]:CENTer 318 :FUNCtion[:FFT]:SPAN 319

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 11

:FUNCtion[:FFT]:VTYPe 320 :FUNCtion[:FFT]:WINDow 321 :FUNCtion:FREQuency:HIGHpass 322 :FUNCtion:FREQuency:LOWPass 323 :FUNCtion:GOFT:OPERation 324 :FUNCtion:GOFT:SOURce1 325 :FUNCtion:GOFT:SOURce2 326 :FUNCtion:INTegrate:IOFFset 327 :FUNCtion:LINear:GAIN 328 :FUNCtion:LINear:OFFSet 329 :FUNCtion:OFFSet 330 :FUNCtion:OPERation 331 :FUNCtion:RANGe 333 :FUNCtion:REFerence 334 :FUNCtion:SCALe 335 :FUNCtion:SOURce1 336 :FUNCtion:SOURce2 338 :FUNCtion:TRENd:MEASurement 339

16 :HARDcopy Commands

:HARDcopy:AREA 343 :HARDcopy:APRinter 344 :HARDcopy:FACTors 345 :HARDcopy:FFEed 346 :HARDcopy:INKSaver 347 :HARDcopy:LAYout 348 :HARDcopy:NETWork:ADDRess 349 :HARDcopy:NETWork:APPLy 350 :HARDcopy:NETWork:DOMain 351 :HARDcopy:NETWork:PASSword 352 :HARDcopy:NETWork:SLOT 353 :HARDcopy:NETWork:USERname 354 :HARDcopy:PALette 355 :HARDcopy:PRINter:LIST 356 :HARDcopy:STARt 357

17 :LISTer Commands

:LISTer:DATA 360 :LISTer:DISPlay 361 :LISTer:REFerence 362

12 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

18 :MARKer Commands

:MARKer:MODE 365 :MARKer:X1Position 366 :MARKer:X1Y1source 367 :MARKer:X2Position 368 :MARKer:X2Y2source 369 :MARKer:XDELta 370 :MARKer:XUNits 371 :MARKer:XUNits:USE 372 :MARKer:Y1Position 373 :MARKer:Y2Position 374 :MARKer:YDELta 375 :MARKer:YUNits 376 :MARKer:YUNits:USE 377

19 :MEASure Commands

:MEASure:ALL 391 :MEASure:AREa 392 :MEASure:BWIDth 393 :MEASure:CLEar 394 :MEASure:COUNter 395 :MEASure:DEFine 396 :MEASure:DELay 399 :MEASure:DUTYcycle 401 :MEASure:FALLtime 402 :MEASure:FREQuency 403 :MEASure:NEDGes 404 :MEASure:NPULses 405 :MEASure:NWIDth 406 :MEASure:OVERshoot 407 :MEASure:PEDGes 409 :MEASure:PERiod 410 :MEASure:PHASe 411 :MEASure:PPULses 412 :MEASure:PREShoot 413 :MEASure:PWIDth 414 :MEASure:RESults 415 :MEASure:RISetime 418 :MEASure:SDEViation 419 :MEASure:SHOW 420 :MEASure:SOURce 421

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 13

:MEASure:STATistics 423 :MEASure:STATistics:DISPlay 424 :MEASure:STATistics:INCRement 425 :MEASure:STATistics:MCOunt 426 :MEASure:STATistics:RESet 427 :MEASure:STATistics:RSDeviation 428 :MEASure:TEDGe 429 :MEASure:TVALue 431 :MEASure:VAMPlitude 433 :MEASure:VAVerage 434 :MEASure:VBASe 435 :MEASure:VMAX 436 :MEASure:VMIN 437 :MEASure:VPP 438 :MEASure:VRATio 439 :MEASure:VRMS 440 :MEASure:VTIMe 441 :MEASure:VTOP 442 :MEASure:WINDow 443 :MEASure:XMAX 444 :MEASure:XMIN 445

20 :MEASure Power Commands

:MEASure:ANGLe 450 :MEASure:APParent 451 :MEASure:CRESt 452 :MEASure:EFFiciency 453 :MEASure:ELOSs 454 :MEASure:FACTor 455 :MEASure:IPOWer 456 :MEASure:OFFTime 457 :MEASure:ONTime 458 :MEASure:OPOWer 459 :MEASure:PCURrent 460 :MEASure:PLOSs 461 :MEASure:REACtive 462 :MEASure:REAL 463 :MEASure:RIPPle 464 :MEASure:TRESponse 465

14 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

21 :MTESt Commands

:MTESt:ALL 472 :MTESt:AMASk:CREate 473 :MTESt:AMASk:SOURce 474 :MTESt:AMASk:UNITs 475 :MTESt:AMASk:XDELta 476 :MTESt:AMASk:YDELta 477 :MTESt:COUNt:FWAVeforms 478 :MTESt:COUNt:RESet 479 :MTESt:COUNt:TIME 480 :MTESt:COUNt:WAVeforms 481 :MTESt:DATA 482 :MTESt:DELete 483 :MTESt:ENABle 484 :MTESt:LOCK 485 :MTESt:RMODe 486 :MTESt:RMODe:FACTion:MEASure 487 :MTESt:RMODe:FACTion:PRINt 488 :MTESt:RMODe:FACTion:SAVE 489 :MTESt:RMODe:FACTion:STOP 490 :MTESt:RMODe:SIGMa 491 :MTESt:RMODe:TIME 492 :MTESt:RMODe:WAVeforms 493 :MTESt:SCALe:BIND 494 :MTESt:SCALe:X1 495 :MTESt:SCALe:XDELta 496 :MTESt:SCALe:Y1 497 :MTESt:SCALe:Y2 498 :MTESt:SOURce 499 :MTESt:TITLe 500

22 :POD Commands

:POD<n>:DISPlay 503 :POD<n>:SIZE 504 :POD<n>:THReshold 505

23 :POWer Commands

:POWer:DESKew 511 :POWer:EFFiciency:APPLy 512 :POWer:ENABle 513 :POWer:HARMonics:APPLy 514

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 15

:POWer:HARMonics:DATA 515 :POWer:HARMonics:DISPlay 516 :POWer:HARMonics:FAILcount 517 :POWer:HARMonics:LINE 518 :POWer:HARMonics:POWerfactor 519 :POWer:HARMonics:RUNCount 520 :POWer:HARMonics:STANdard 521 :POWer:HARMonics:STATus 522 :POWer:HARMonics:THD 523 :POWer:INRush:APPLy 524 :POWer:INRush:EXIT 525 :POWer:INRush:NEXT 526 :POWer:MODulation:APPLy 527 :POWer:MODulation:SOURce 528 :POWer:MODulation:TYPE 529 :POWer:ONOFf:APPLy 530 :POWer:ONOFf:EXIT 531 :POWer:ONOFf:NEXT 532 :POWer:ONOFf:TEST 533 :POWer:PSRR:APPLy 534 :POWer:PSRR:FREQuency:MAXimum 535 :POWer:PSRR:FREQuency:MINimum 536 :POWer:PSRR:RMAXimum 537 :POWer:QUALity:APPLy 538 :POWer:QUALity:TYPE 539 :POWer:RIPPle:APPLy 540 :POWer:SIGNals:AUTosetup 541 :POWer:SIGNals:CYCLes 542 :POWer:SIGNals:DURation 543 :POWer:SIGNals:IEXPected 544 :POWer:SIGNals:OVERshoot 545 :POWer:SIGNals:VMAXimum 546 :POWer:SIGNals:VSTeady 547 :POWer:SIGNals:SOURce:CURRent<i> 548 :POWer:SIGNals:SOURce:VOLTage<i> 549 :POWer:SLEW:APPLy 550 :POWer:SLEW:SOURce 551 :POWer:SLEW:VALue 552 :POWer:SWITch:APPLy 553 :POWer:SWITch:CONDuction 554 :POWer:SWITch:IREFerence 555 :POWer:SWITch:RDS 556

16 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:POWer:SWITch:VCE 557 :POWer:SWITch:VREFerence 558 :POWer:TRANsient:APPLy 559 :POWer:TRANsient:EXIT 560 :POWer:TRANsient:IINitial 561 :POWer:TRANsient:INEW 562 :POWer:TRANsient:NEXT 563

24 :RECall Commands

:RECall:ARBitrary[:STARt] 567 :RECall:FILename 568 :RECall:MASK[:STARt] 569 :RECall:PWD 570 :RECall:SETup[:STARt] 571 :RECall:WMEMory<r>[:STARt] 572

25 :SAVE Commands

:SAVE:ARBitrary[:STARt] 576 :SAVE:FILename 577 :SAVE:IMAGe[:STARt] 578 :SAVE:IMAGe:FACTors 579 :SAVE:IMAGe:FORMat 580 :SAVE:IMAGe:INKSaver 581 :SAVE:IMAGe:PALette 582 :SAVE:LISTer[:STARt] 583 :SAVE:MASK[:STARt] 584 :SAVE:POWer[:STARt] 585 :SAVE:PWD 586 :SAVE:SETup[:STARt] 587 :SAVE:WAVeform[:STARt] 588 :SAVE:WAVeform:FORMat 589 :SAVE:WAVeform:LENGth 590 :SAVE:WAVeform:LENGth:MAX 591 :SAVE:WAVeform:SEGMented 592 :SAVE:WMEMory:SOURce 593 :SAVE:WMEMory[:STARt] 594

26 :SBUS<n> Commands

General :SBUS<n> Commands 597

:SBUS<n>:DISPlay 598 :SBUS<n>:MODE 599

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 17

:SBUS<n>:A429 Commands 600

:SBUS<n>:A429:AUTosetup 602 :SBUS<n>:A429:BASE 603 :SBUS<n>:A429:COUNt:ERRor 604 :SBUS<n>:A429:COUNt:RESet 605 :SBUS<n>:A429:COUNt:WORD 606 :SBUS<n>:A429:FORMat 607 :SBUS<n>:A429:SIGNal 608 :SBUS<n>:A429:SOURce 609 :SBUS<n>:A429:SPEed 610 :SBUS<n>:A429:TRIGger:LABel 611 :SBUS<n>:A429:TRIGger:PATTern:DATA 612 :SBUS<n>:A429:TRIGger:PATTern:SDI 613 :SBUS<n>:A429:TRIGger:PATTern:SSM 614 :SBUS<n>:A429:TRIGger:RANGe 615 :SBUS<n>:A429:TRIGger:TYPE 616

:SBUS<n>:CAN Commands 618

:SBUS<n>:CAN:COUNt:ERRor 620 :SBUS<n>:CAN:COUNt:OVERload 621 :SBUS<n>:CAN:COUNt:RESet 622 :SBUS<n>:CAN:COUNt:TOTal 623 :SBUS<n>:CAN:COUNt:UTILization 624 :SBUS<n>:CAN:SAMPlepoint 625 :SBUS<n>:CAN:SIGNal:BAUDrate 626 :SBUS<n>:CAN:SIGNal:DEFinition 627 :SBUS<n>:CAN:SOURce 628 :SBUS<n>:CAN:TRIGger 629 :SBUS<n>:CAN:TRIGger:PATTern:DATA 631 :SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth 632 :SBUS<n>:CAN:TRIGger:PATTern:ID 633 :SBUS<n>:CAN:TRIGger:PATTern:ID:MODE 634

:SBUS<n>:FLEXray Commands 635

:SBUS<n>:FLEXray:AUTosetup 637 :SBUS<n>:FLEXray:BAUDrate 638 :SBUS<n>:FLEXray:CHANnel 639 :SBUS<n>:FLEXray:COUNt:NULL 640 :SBUS<n>:FLEXray:COUNt:RESet 641 :SBUS<n>:FLEXray:COUNt:SYNC 642 :SBUS<n>:FLEXray:COUNt:TOTal 643 :SBUS<n>:FLEXray:SOURce 644 :SBUS<n>:FLEXray:TRIGger 645

18 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:SBUS<n>:FLEXray:TRIGger:ERRor:TYPE 646 :SBUS<n>:FLEXray:TRIGger:EVENt:AUToset 647 :SBUS<n>:FLEXray:TRIGger:EVENt:BSS:ID 648 :SBUS<n>:FLEXray:TRIGger:EVENt:TYPE 649 :SBUS<n>:FLEXray:TRIGger:FRAMe:CCBase 650 :SBUS<n>:FLEXray:TRIGger:FRAMe:CCRepetition 651 :SBUS<n>:FLEXray:TRIGger:FRAMe:ID 652 :SBUS<n>:FLEXray:TRIGger:FRAMe:TYPE 653

:SBUS<n>:I2S Commands 654

:SBUS<n>:I2S:ALIGnment 656 :SBUS<n>:I2S:BASE 657 :SBUS<n>:I2S:CLOCk:SLOPe 658 :SBUS<n>:I2S:RWIDth 659 :SBUS<n>:I2S:SOURce:CLOCk 660 :SBUS<n>:I2S:SOURce:DATA 661 :SBUS<n>:I2S:SOURce:WSELect 662 :SBUS<n>:I2S:TRIGger 663 :SBUS<n>:I2S:TRIGger:AUDio 665 :SBUS<n>:I2S:TRIGger:PATTern:DATA 666 :SBUS<n>:I2S:TRIGger:PATTern:FORMat 668 :SBUS<n>:I2S:TRIGger:RANGe 669 :SBUS<n>:I2S:TWIDth 671 :SBUS<n>:I2S:WSLow 672

:SBUS<n>:IIC Commands 673

:SBUS<n>:IIC:ASIZe 674 :SBUS<n>:IIC[:SOURce]:CLOCk 675 :SBUS<n>:IIC[:SOURce]:DATA 676 :SBUS<n>:IIC:TRIGger:PATTern:ADDRess 677 :SBUS<n>:IIC:TRIGger:PATTern:DATA 678 :SBUS<n>:IIC:TRIGger:PATTern:DATa2 679 :SBUS<n>:IIC:TRIGger:QUALifier 680 :SBUS<n>:IIC:TRIGger[:TYPE] 681

:SBUS<n>:LIN Commands 683

:SBUS<n>:LIN:PARity 685 :SBUS<n>:LIN:SAMPlepoint 686 :SBUS<n>:LIN:SIGNal:BAUDrate 687 :SBUS<n>:LIN:SOURce 688 :SBUS<n>:LIN:STANdard 689 :SBUS<n>:LIN:SYNCbreak 690 :SBUS<n>:LIN:TRIGger 691

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 19

:SBUS<n>:LIN:TRIGger:ID 692 :SBUS<n>:LIN:TRIGger:PATTern:DATA 693 :SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth 695 :SBUS<n>:LIN:TRIGger:PATTern:FORMat 696

:SBUS<n>:M1553 Commands 697

:SBUS<n>:M1553:AUTosetup 698 :SBUS<n>:M1553:BASE 699 :SBUS<n>:M1553:SOURce 700 :SBUS<n>:M1553:TRIGger:PATTern:DATA 701 :SBUS<n>:M1553:TRIGger:RTA 702 :SBUS<n>:M1553:TRIGger:TYPE 703

:SBUS<n>:SPI Commands 704

:SBUS<n>:SPI:BITorder 706 :SBUS<n>:SPI:CLOCk:SLOPe 707 :SBUS<n>:SPI:CLOCk:TIMeout 708 :SBUS<n>:SPI:FRAMing 709 :SBUS<n>:SPI:SOURce:CLOCk 710 :SBUS<n>:SPI:SOURce:DATA 711 :SBUS<n>:SPI:SOURce:FRAMe 712 :SBUS<n>:SPI:SOURce:MISO 713 :SBUS<n>:SPI:SOURce:MOSI 714 :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA 715 :SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh 716 :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA 717 :SBUS<n>:SPI:TRIGger:PATTern:MOSI:WIDTh 718 :SBUS<n>:SPI:TRIGger:TYPE 719 :SBUS<n>:SPI:WIDTh 720

:SBUS<n>:UART Commands 721

:SBUS<n>:UART:BASE 724 :SBUS<n>:UART:BAUDrate 725 :SBUS<n>:UART:BITorder 726 :SBUS<n>:UART:COUNt:ERRor 727 :SBUS<n>:UART:COUNt:RESet 728 :SBUS<n>:UART:COUNt:RXFRames 729 :SBUS<n>:UART:COUNt:TXFRames 730 :SBUS<n>:UART:FRAMing 731 :SBUS<n>:UART:PARity 732 :SBUS<n>:UART:POLarity 733 :SBUS<n>:UART:SOURce:RX 734 :SBUS<n>:UART:SOURce:TX 735

20 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:SBUS<n>:UART:TRIGger:BASE 736 :SBUS<n>:UART:TRIGger:BURSt 737 :SBUS<n>:UART:TRIGger:DATA 738 :SBUS<n>:UART:TRIGger:IDLE 739 :SBUS<n>:UART:TRIGger:QUALifier 740 :SBUS<n>:UART:TRIGger:TYPE 741 :SBUS<n>:UART:WIDTh 742

27 :SEARch Commands

General :SEARch Commands 744

:SEARch:COUNt 745 :SEARch:MODE 746 :SEARch:STATe 747

:SEARch:EDGE Commands 748

:SEARch:EDGE:SLOPe 749 :SEARch:EDGE:SOURce 750

:SEARch:GLITch Commands 751

:SEARch:GLITch:GREaterthan 752 :SEARch:GLITch:LESSthan 753 :SEARch:GLITch:POLarity 754 :SEARch:GLITch:QUALifier 755 :SEARch:GLITch:RANGe 756 :SEARch:GLITch:SOURce 757

:SEARch:RUNT Commands 758

:SEARch:RUNT:POLarity 759 :SEARch:RUNT:QUALifier 760 :SEARch:RUNT:SOURce 761 :SEARch:RUNT:TIME 762

:SEARch:TRANsition Commands 763

:SEARch:TRANsition:QUALifier 764 :SEARch:TRANsition:SLOPe 765 :SEARch:TRANsition:SOURce 766 :SEARch:TRANsition:TIME 767

:SEARch:SERial:A429 Commands 768

:SEARch:SERial:A429:LABel 769 :SEARch:SERial:A429:MODE 770 :SEARch:SERial:A429:PATTern:DATA 771 :SEARch:SERial:A429:PATTern:SDI 772 :SEARch:SERial:A429:PATTern:SSM 773

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 21

:SEARch:SERial:CAN Commands 774

:SEARch:SERial:CAN:MODE 775 :SEARch:SERial:CAN:PATTern:DATA 776 :SEARch:SERial:CAN:PATTern:DATA:LENGth 777 :SEARch:SERial:CAN:PATTern:ID 778 :SEARch:SERial:CAN:PATTern:ID:MODE 779

:SEARch:SERial:FLEXray Commands 780

:SEARch:SERial:FLEXray:CYCLe 781 :SEARch:SERial:FLEXray:DATA 782 :SEARch:SERial:FLEXray:DATA:LENGth 783 :SEARch:SERial:FLEXray:FRAMe 784 :SEARch:SERial:FLEXray:MODE 785

:SEARch:SERial:I2S Commands 786

:SEARch:SERial:I2S:AUDio 787 :SEARch:SERial:I2S:MODE 788 :SEARch:SERial:I2S:PATTern:DATA 789 :SEARch:SERial:I2S:PATTern:FORMat 790 :SEARch:SERial:I2S:RANGe 791

:SEARch:SERial:IIC Commands 792

:SEARch:SERial:IIC:MODE 793 :SEARch:SERial:IIC:PATTern:ADDRess 795 :SEARch:SERial:IIC:PATTern:DATA 796 :SEARch:SERial:IIC:PATTern:DATA2 797 :SEARch:SERial:IIC:QUALifier 798

:SEARch:SERial:LIN Commands 799

:SEARch:SERial:LIN:ID 800 :SEARch:SERial:LIN:MODE 801 :SEARch:SERial:LIN:PATTern:DATA 802 :SEARch:SERial:LIN:PATTern:DATA:LENGth 803 :SEARch:SERial:LIN:PATTern:FORMat 804

:SEARch:SERial:M1553 Commands 805

:SEARch:SERial:M1553:MODE 806 :SEARch:SERial:M1553:PATTern:DATA 807 :SEARch:SERial:M1553:RTA 808

:SEARch:SERial:SPI Commands 809

:SEARch:SERial:SPI:MODE 810 :SEARch:SERial:SPI:PATTern:DATA 811 :SEARch:SERial:SPI:PATTern:WIDTh 812

:SEARch:SERial:UART Commands 813

22 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:SEARch:SERial:UART:DATA 814 :SEARch:SERial:UART:MODE 815 :SEARch:SERial:UART:QUALifier 816

28 :SYSTem Commands

:SYSTem:DATE 819 :SYSTem:DSP 820 :SYSTem:ERRor 821 :SYSTem:LOCK 822 :SYSTem:MENU 823 :SYSTem:PRESet 824 :SYSTem:PROTection:LOCK 827 :SYSTem:SETup 828 :SYSTem:TIME 830

29 :TIMebase Commands

:TIMebase:MODE 833 :TIMebase:POSition 834 :TIMebase:RANGe 835 :TIMebase:REFerence 836 :TIMebase:SCALe 837 :TIMebase:VERNier 838 :TIMebase:WINDow:POSition 839 :TIMebase:WINDow:RANGe 840 :TIMebase:WINDow:SCALe 841

30 :TRIGger Commands

General :TRIGger Commands 845

:TRIGger:FORCe 846 :TRIGger:HFReject 847 :TRIGger:HOLDoff 848 :TRIGger:LEVel:HIGH 849 :TRIGger:LEVel:LOW 850 :TRIGger:MODE 851 :TRIGger:NREJect 852 :TRIGger:SWEep 853

:TRIGger:DELay Commands 854

:TRIGger:DELay:ARM:SLOPe 855 :TRIGger:DELay:ARM:SOURce 856 :TRIGger:DELay:TDELay:TIME 857 :TRIGger:DELay:TRIGger:COUNt 858

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 23

:TRIGger:DELay:TRIGger:SLOPe 859 :TRIGger:DELay:TRIGger:SOURce 860

:TRIGger:EBURst Commands 861

:TRIGger:EBURst:COUNt 862 :TRIGger:EBURst:IDLE 863 :TRIGger:EBURst:SLOPe 864 :TRIGger:EBURst:SOURce 865

:TRIGger[:EDGE] Commands 866

:TRIGger[:EDGE]:COUPling 867 :TRIGger[:EDGE]:LEVel 868 :TRIGger[:EDGE]:REJect 869 :TRIGger[:EDGE]:SLOPe 870 :TRIGger[:EDGE]:SOURce 871

:TRIGger:GLITch Commands 872

:TRIGger:GLITch:GREaterthan 874 :TRIGger:GLITch:LESSthan 875 :TRIGger:GLITch:LEVel 876 :TRIGger:GLITch:POLarity 877 :TRIGger:GLITch:QUALifier 878 :TRIGger:GLITch:RANGe 879 :TRIGger:GLITch:SOURce 880

:TRIGger:OR Commands 881

:TRIGger:OR 882

:TRIGger:PATTern Commands 883

:TRIGger:PATTern 884 :TRIGger:PATTern:FORMat 886 :TRIGger:PATTern:GREaterthan 887 :TRIGger:PATTern:LESSthan 888 :TRIGger:PATTern:QUALifier 889 :TRIGger:PATTern:RANGe 891

:TRIGger:RUNT Commands 892

:TRIGger:RUNT:POLarity 893 :TRIGger:RUNT:QUALifier 894 :TRIGger:RUNT:SOURce 895 :TRIGger:RUNT:TIME 896

:TRIGger:SHOLd Commands 897

:TRIGger:SHOLd:SLOPe 898 :TRIGger:SHOLd:SOURce:CLOCk 899 :TRIGger:SHOLd:SOURce:DATA 900

24 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:TRIGger:SHOLd:TIME:HOLD 901 :TRIGger:SHOLd:TIME:SETup 902

:TRIGger:TRANsition Commands 903

:TRIGger:TRANsition:QUALifier 904 :TRIGger:TRANsition:SLOPe 905 :TRIGger:TRANsition:SOURce 906 :TRIGger:TRANsition:TIME 907

:TRIGger:TV Commands 908

:TRIGger:TV:LINE 909 :TRIGger:TV:MODE 910 :TRIGger:TV:POLarity 911 :TRIGger:TV:SOURce 912 :TRIGger:TV:STANdard 913 :TRIGger:TV:UDTV:ENUMber 914 :TRIGger:TV:UDTV:HSYNc 915 :TRIGger:TV:UDTV:HTIMe 916 :TRIGger:TV:UDTV:PGTHan 917

:TRIGger:USB Commands 918

:TRIGger:USB:SOURce:DMINus 919 :TRIGger:USB:SOURce:DPLus 920 :TRIGger:USB:SPEed 921 :TRIGger:USB:TRIGger 922

31 :WAVeform Commands

:WAVeform:BYTeorder 931 :WAVeform:COUNt 932 :WAVeform:DATA 933 :WAVeform:FORMat 935 :WAVeform:POINts 936 :WAVeform:POINts:MODE 938 :WAVeform:PREamble 940 :WAVeform:SEGMented:COUNt 943 :WAVeform:SEGMented:TTAG 944 :WAVeform:SOURce 945 :WAVeform:SOURce:SUBSource 949 :WAVeform:TYPE 950 :WAVeform:UNSigned 951 :WAVeform:VIEW 952 :WAVeform:XINCrement 953 :WAVeform:XORigin 954

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 25

:WAVeform:XREFerence 955 :WAVeform:YINCrement 956 :WAVeform:YORigin 957 :WAVeform:YREFerence 958

32 :WGEN Commands

:WGEN:ARBitrary:BYTeorder 962 :WGEN:ARBitrary:DATA 963 :WGEN:ARBitrary:DATA:ATTRibute:POINts 964 :WGEN:ARBitrary:DATA:CLEar 965 :WGEN:ARBitrary:DATA:DAC 966 :WGEN:ARBitrary:INTerpolate 967 :WGEN:ARBitrary:STORe 968 :WGEN:FREQuency 969 :WGEN:FUNCtion 970 :WGEN:FUNCtion:PULSe:WIDTh 973 :WGEN:FUNCtion:RAMP:SYMMetry 974 :WGEN:FUNCtion:SQUare:DCYCle 975 :WGEN:MODulation:NOISe 976 :WGEN:OUTPut 977 :WGEN:OUTPut:LOAD 978 :WGEN:PERiod 979 :WGEN:RST 980 :WGEN:VOLTage 981 :WGEN:VOLTage:HIGH 982 :WGEN:VOLTage:LOW 983 :WGEN:VOLTage:OFFSet 984

33 :WMEMory<r> Commands

:WMEMory<r>:CLEar 987 :WMEMory<r>:DISPlay 988 :WMEMory<r>:LABel 989 :WMEMory<r>:SAVE 990 :WMEMory<r>:SKEW 991 :WMEMory<r>:YOFFset 992 :WMEMory<r>:YRANge 993 :WMEMory<r>:YSCale 994

34 Obsolete and Discontinued Commands

:CHANnel:ACTivity 1000 :CHANnel:LABel 1001

26 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:CHANnel:THReshold 1002 :CHANnel2:SKEW 1003 :CHANnel<n>:INPut 1004 :CHANnel<n>:PMODe 1005 :DISPlay:CONNect 1006 :DISPlay:ORDer 1007 :ERASe 1008 :EXTernal:PMODe 1009 :FUNCtion:SOURce 1010 :FUNCtion:VIEW 1011 :HARDcopy:DESTination 1012 :HARDcopy:FILename 1013 :HARDcopy:GRAYscale 1014 :HARDcopy:IGColors 1015 :HARDcopy:PDRiver 1016 :MEASure:LOWer 1017 :MEASure:SCRatch 1018 :MEASure:TDELta 1019 :MEASure:THResholds 1020 :MEASure:TMAX 1021 :MEASure:TMIN 1022 :MEASure:TSTArt 1023 :MEASure:TSTOp 1024 :MEASure:TVOLt 1025 :MEASure:UPPer 1027 :MEASure:VDELta 1028 :MEASure:VSTArt 1029 :MEASure:VSTOp 1030 :MTESt:AMASk:{SAVE | STORe} 1031 :MTESt:AVERage 1032 :MTESt:AVERage:COUNt 1033 :MTESt:LOAD 1034 :MTESt:RUMode 1035 :MTESt:RUMode:SOFailure 1036 :MTESt:{STARt | STOP} 1037 :MTESt:TRIGger:SOURce 1038 :PRINt? 1039 :SAVE:IMAGe:AREA 1041 :SBUS<n>:LIN:SIGNal:DEFinition 1042 :TIMebase:DELay 1043 :TRIGger:THReshold 1044 :TRIGger:TV:TVMode 1045

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 27

35 Error Messages

36 Status Reporting

Status Reporting Data Structures 1057

Status Byte Register (STB) 1059

Service Request Enable Register (SRE) 1061

Trigger Event Register (TER) 1062

Output Queue 1063

Message Queue 1064

(Standard) Event Status Register (ESR) 1065

(Standard) Event Status Enable Register (ESE) 1066

Error Queue 1067

Operation Status Event Register (:OPERegister[:EVENt]) 1068

Operation Status Condition Register (:OPERegister:CONDition) 1069

Arm Event Register (AER) 1070

Overload Event Register (:OVLRegister) 1071

Mask Test Event Event Register (:MTERegister[:EVENt]) 1072

Power Event Event Register (:PWRRegister[:EVENt]) 1073

Clearing Registers and Queues 1074

Status Reporting Decision Chart 1075

37 Synchronizing Acquisitions

Synchronization in the Programming Flow 1078

Set Up the Oscilloscope 1078 Acquire a Waveform 1078 Retrieve Results 1078

Blocking Synchronization 1079

Polling Synchronization With Timeout 1080

Synchronizing with a Single-Shot Device Under Test (DUT) 1082

Synchronization with an Averaging Acquisition 1084

28 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

38 More About Oscilloscope Commands

Command Classifications 1088

Core Commands 1088 Non-Core Commands 1088 Obsolete Commands 1088

Valid Command/Query Strings 1089

Program Message Syntax 1089 Duplicate Mnemonics 1093 Tree Traversal Rules and Multiple Commands 1093

Query Return Values 1095

All Oscilloscope Commands Are Sequential 1096

39 Programming Examples

VISA COM Examples 1098

VISA COM Example in Visual Basic 1098 VISA COM Example in C# 1107 VISA COM Example in Visual Basic .NET 1116 VISA COM Example in Python for .NET or IronPython 1124

Index

VISA Examples 1131

VISA Example in C 1131 VISA Example in Visual Basic 1140 VISA Example in C# 1150 VISA Example in Visual Basic .NET 1161 VISA Example in Python 1171

SICL Examples 1178

SICL Example in C 1178 SICL Example in Visual Basic 1187

SCPI.NET Examples 1198

SCPI.NET Example in C# 1198 SCPI.NET Example in Visual Basic .NET 1204 SCPI.NET Example in IronPython 1210

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 29

30 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

1 What's New

What's New in Version 2.10 32 What's New in Version 2.00 33 What's New in Version 1.20 37 What's New in Version 1.10 39 Version 1.00 at Introduction 40 Command Differences From 7000B Series Oscilloscopes 41

1 What's New

What's New in Version 2.10

New features in version 2.10 of the InfiniiVision 3000 X-Series oscilloscope software are:

• Support for adding an annotation to the display.

More detailed descriptions of the new and changed commands appear below.

New Commands

Command Description

:DISPlay:ANNotation (see page 291) Turns screen annotation on or off.

:DISPlay:ANNotation:BACKground (see

page 292)

:DISPlay:ANNotation:COLor (see page 293) Specifies the color of the annotation.

:DISPlay:ANNotation:TEXT (see page 294) Specifies the annotation string, up to 254

Specifies the background of the annotation to be either opaque, inverted, or transparent.

characters.

32 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

What's New in Version 2.00

New features in version 2.00 of the InfiniiVision 3000 X-Series oscilloscope software are:

• Support for the DSOX3WAVEGEN waveform generator's new arbitrary

waveform type.

• Support for the new DSOX3VID extended Video triggering license.

• Support for the new DSOX3AERO MIL- STD- 1553 and ARINC 429

triggering and serial decode license.

• Support for the new DSOX3FLEX FlexRay triggering and serial decode

license.

• Support for the new DSOX3PWR power measurements and analysis

license.

• Support for the new DSOX3ADVMATH advanced math measurements

license.

What's New 1

New Commands

More detailed descriptions of the new and changed commands appear below.

Command Description

:FUNCtion:BUS:CLOCk (see page 312) Selects the clock signal source for the Chart

Logic Bus State operation. Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:BUS:SLOPe (see page 313) Specifies the clock signal edge for the Chart

Logic Bus State operation. Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:BUS:YINCrement (see page 314) Specifies the value associated with each

increment in Chart Logic Bus data. Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:BUS:YORigin (see page 315) Specifies the value associated with Chart Logic

Bus data equal to zero. Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:BUS:YUNits (see page 316) Specifies the vertical units for the Chart Logic

Bus operations. Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:FREQuency:HIGHpass (see

page 322)

:FUNCtion:FREQuency:LOWPass (see

page 323)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 33

Sets the high-pass filter's -3 dB cutoff frequency. Available with the DSOX3ADVMATH advanced math license.

Sets the low-pass filter's -3 dB cutoff frequency. Available with the DSOX3ADVMATH advanced math license.

1 What's New

Command Description

:FUNCtion:LINear:GAIN (see page 328) Specifies the 'A' value in the Ax + B operation.

Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:LINear:OFFSet (see page 329) Specifies the 'B' value in the Ax + B operation.

Available with the DSOX3ADVMATH advanced math license.

:FUNCtion:TRENd:MEASurement (see

page 339)

:MEASure Power Commands (see page 447) :MEASure commands available when the

:MEASure:STATistics:DISPlay (see page 424) Specifies whether the display of measurement

:POWer Commands (see page 507) Commands for the DSOX3PWR power

:PWRenable (Power Event Enable Register) (see page 208)

:PWRRegister[:EVENt] (Power Event Event Register) (see page 208)

:RECall:ARBitrary[:STARt] (see page 567) Recalls waveform generator arbitrary

Selects the measurement whose trend is shown in the math waveform. Available with the DSOX3ADVMATH advanced math license.

DSOX3PWR power measurements and analysis application is licensed and enabled.

statistics is on or off.

measurements and analysis application.

For enabling bits in the Power Event Enable Register. This status register control is available when the DSOX3PWR power measurements and analysis application is licensed.

For reading power application status bits in the Power Event Event Register. This query is available when the DSOX3PWR power measurements and analysis application is licensed.

waveforms from a file.

:SAVE:ARBitrary[:STARt] (see page 576) Saves waveform generator arbitrary waveforms

to a file.

:SAVE:POWer[:STARt] (see page 585) Saves the power measurement application's

current harmonics analysis results to a file.

:SBUS<n>:A429 Commands (see page 600) Commands for ARINC 429 triggering and serial

decode.

:SBUS<n>:FLEXray Commands (see page 635) Commands for FlexRay triggering and serial

decode.

:SBUS<n>:M1553 Commands (see page 697) Commands for MIL-STD 1553 triggering and

serial decode.

:SEARch:SERial:A429 Commands (see

page 768)

34 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands for finding ARINC 429 events in the captured data.

Command Description

What's New 1

:SEARch:SERial:FLEXray Commands (see

page 780)

:SEARch:SERial:M1553 Commands (see

page 805)

:TRIGger:TV:UDTV:ENUMber (see page 914) Specifies the Nth edge to trigger on with the

:TRIGger:TV:UDTV:HSYNc (see page 915) Enables or disables the horizontal sync control

:TRIGger:TV:UDTV:HTIMe (see page 916) When the Generic video trigger's horizontal

:TRIGger:TV:UDTV:PGTHan (see page 917) Specifies the "greater than the sync pulse

:WGEN:ARBitrary:BYTeorder (see page 962) Selects the byte order for arbitrary waveform

:WGEN:ARBitrary:DATA (see page 963) Downloads an arbitrary waveform in

Commands for finding FlexRay events in the captured data.

Commands for finding MIL-STD 1553 events in the captured data.

Generic video trigger. Available with the DSOX3VID extended Video triggering license.

in the Generic video trigger. Available with the DSOX3VID extended Video triggering license.

sync control is enabled, this command specifies the sync time. Available with the DSOX3VID extended Video triggering license.

width" time in the Generic video trigger. Available with the DSOX3VID extended Video triggering license.

binary transfers.

floating-point values format.

:WGEN:ARBitrary:DATA:ATTRibute:POINts? (see page 964)

:WGEN:ARBitrary:DATA:CLEar (see page 965) Clears the arbitrary waveform memory and

:WGEN:ARBitrary:DATA:DAC (see page 966) Downloads an arbitrary waveform in integer

:WGEN:ARBitrary:INTerpolate (see page 967) Enable or disables interpolated values between

:WGEN:ARBitrary:STORe (see page 968) Captures a waveform and stores it into

:WGEN:MODulation:NOISe (see page 976) Adds noise to the waveform generator's output

Returns the number of points used by the current arbitrary waveform.

restores the default waveform.

(DAC) values.

points in the arbitrary waveform.

arbitrary waveform memory.

signal.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 35

1 What's New

Changed

Commands

Command Differences

:DEMO:FUNCtion (see page 274) The FMBurst, ARINc, FLEXray, MIL, and MIL2

functions are now available with the DSOXEDK educator's kit license.

:FUNCtion:OPERation (see page 331)The MAGNify, ABSolute, SQUare, LN, LOG,

EXP, TEN, LOWPass, HIGHpass, DIVide, LINear, TRENd, BTIMing, and BSTate operations are now available with the DSOX3ADVMATH advanced math measurements license.

:FUNCtion:SOURce1 (see page 336) The BUS<m> source is now available for the

bus charting operations available with the DSOX3ADVMATH advanced math measurements license.

:SBUS<n>:MODE (see page 599) The A429, M1553, and FLEXray modes are now

available with the DSOX3AERO (MIL-STD-1553 and ARINC 429) and DSOX3FLEX (FlexRay) serial decode and triggering licenses.

:TRIGger:TV:MODE (see page 910) The LINE mode is added for the video

standards available with the extended Video triggering license.

:TRIGger:TV:STANdard (see page 913) Lets you select additional video standards

:WGEN:FUNCtion (see page 970) The ARBitrary waveform type can now be

available with the extended Video triggering license.

selected.

36 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

What's New in Version 1.20

New features in version 1.20 of the InfiniiVision 3000 X-Series oscilloscope software are:

• Edge Then Edge trigger.

• OR'ed edge trigger.

• Sine Cardinal, Exponential Rise, Exponential Fall, Cardiac, and

Gaussian Pulse waveform generator waveforms.

• X cursor units that let you measure time (seconds), frequency (Hertz),

phase (degrees), and ratio (percent), and Y cursor units that let you measure the channel units (base) or ratio (percent).

• Option for specifying FFT vertical units as V RMS as well as decibels.

• Option for entering a DC offset correction factor for the integrate math

waveform input signal.

• Option for saving the maximum number of waveform data points.

What's New 1

New Commands

More detailed descriptions of the new and changed commands appear below.

Command Description

:FUNCtion:INTegrate:IOFFset (see page 327) Lets you enter a DC offset correction factor for

the integrate math waveform input signal to level a "ramp"ed waveform.

:FUNCtion[:FFT]:VTYPe (see page 320) Specifies FFT vertical units as DECibel or

VRMS.

:MARKer:XUNIts (see page 371) Specifies the units for X cursors.

:MARKer:XUNIts:USE (see page 372) Sets the current X1 and X2 cursor locations as

0 and 360 degrees if XUNIts is DEGRees or as 0 and 100 percent if XUNIts is PERCent.

:MARKer:YUNIts (see page 376) Specifies the units for Y cursors.

:MARKer:YUNIts:USE (see page 377) Sets the current Y1 and Y2 cursor locations as

0 and 100 percent if YUNIts is PERCent.

:MEASure:STATistics:MCOunt (see page 426) Specifies the maximum number of values used

when calculating measurement statistics.

:MEASure:STATistics:RSDeviation (see

page 428)

Disables or enables relative standard deviations, that is, standard deviation/mean, in the measurement statistics.

:SAVE:WAVeform:LENGth:MAX (see page 591) Enable or disables saving the maximum

number of waveform data points.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 37

1 What's New

Command Description

:TRIGger:DELay:ARM:SLOPe (see page 855) Specifies the arming edge slope for the Edge

Then Edge trigger.

:TRIGger:DELay:ARM:SOURce (see page 856) Specifies the arming edge source for the Edge

Then Edge trigger.

:TRIGger:DELay:TDELay:TIME (see page 857) Specifies the delay time for the Edge Then Edge

trigger.

:TRIGger:DELay:TRIGger:COUNt (see page 858) Specifies the trigger edge count for the Edge

Then Edge trigger.

:TRIGger:DELay:TRIGger:SLOPe (see page 859) Specifies the trigger edge slope for the Edge

Then Edge trigger.

:TRIGger:DELay:TRIGger:SOURce (see

page 860)

:TRIGger:FORCe (see page 846) Now documented, this command is equivalent

:TRIGger:OR (see page 882) Specifies edges for the OR'ed edge trigger.

Specifies the trigger edge source for the Edge Then Edge trigger.

to the front panel [Force Trigger] key which causes an acquisition to be captured even though the trigger condition has not been met.

Changed

Commands

Command Differences

:DEMO:FUNCtion (see page 274) The ETE (Edge then Edge) function has been

added.

:TRIGger:MODE (see page 851) The OR and DELay modes are added for the

OR'ed edge trigger and the Edge Then Edge trigger.

:WGEN:FUNCtion (see page 970) The SINC, EXPRise, EXPFall, CARDiac, and

GAUSsian waveform types can now be selected.

38 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

What's New in Version 1.10

New command descriptions for Version 1.10 of the InfiniiVision 3000 X-Series oscilloscope software appear below.

New Commands

Command Description

:SYSTem:PRESet (see page 824) Now documented, this command is equivalent

What's New 1

to the front panel [Default Setup] key which leaves some user settings, like preferences, unchanged. The *RST command is equivalent to a factory default setup where no user settings are left unchanged.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 39

1 What's New

Version 1.00 at Introduction

The Agilent InfiniiVision 3000 X- Series oscilloscopes were introduced with version 1.00 of oscilloscope operating software.

The command set is most closely related to the InfiniiVision 7000B Series oscilloscopes (and the 7000A Series, 6000 Series, and 54620/54640 Series oscilloscopes before them). For more information, see “Command

Differences From 7000B Series Oscilloscopes" on page 41.

40 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Command Differences From 7000B Series Oscilloscopes

The Agilent InfiniiVision 3000 X- Series oscilloscopes command set is most closely related to the InfiniiVision 7000B Series oscilloscopes (and the 7000A Series, 6000 Series, and 54620/54640 Series oscilloscopes before them).

The main differences between the version 1.00 programming command set for the InfiniiVision 3000 X-Series oscilloscopes and the 6.10 programming command set for the InfiniiVision 7000B Series oscilloscopes are related to:

• Built- in waveform generator (with Option WGN license).

• Built- in demo signals (with Option EDU license that comes with the

N6455A Education Kit).

• Reference waveforms (in place of trace memory).

• Multiple serial decode waveforms.

• Serial decode now available on 2- channel oscilloscopes.

What's New 1

New Commands

• Enhanced set of trigger types.

• Additional measurements.

• Different path name format for internal and USB storage device

locations.

More detailed descriptions of the new, changed, obsolete, and discontinued commands appear below.

Command Description

:DEMO Commands (see

page 273)

:HARDcopy:NETWork Commands (see page 341)

:MEASure:AREA (see

page 392)

:MEASure:BWIDth (see

page 393)

:MEASure:NEDGes (see

page 404)

Commands for using built-in demo signals (with the Option EDU license that comes with the N6455A Education Kit).

For accessing network printers.

Measures the area between the waveform and the ground level.

Measures the burst width from the first edge on screen to the last.

Counts the number of falling edges.

:MEASure:NPULses (see

page 405)

:MEASure:PEDGes (see

page 409)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 41

Counts the number of negative pulses.

Counts the number of rising edges.

1 What's New

Command Description

:MEASure:PPULses (see

page 412)

:MEASure:WINDow (see

page 443)

:MTESt:ALL (see page 472) Specifies whether all channels are included in the mask test.

:RECall:WMEMory<r>[:STARt] (see page 572)

:SAVE:WMEMory:SOURce (see page 593)

:SAVE:WMEMory[:STARt] (see page 594)

:SBUS<n>:CAN Commands (see page 618)

:SBUS<n>:I2S Commands (see page 654)

:SBUS<n>:IIC Commands (see

page 673)

:SBUS<n>:LIN Commands (see page 683)

Counts the number of positive pulses.

When the zoomed time base in on, specifies whether the measurement window is the zoomed time base or the main time base.

Recalls reference waveforms.

Selects the source for saving a reference waveform.

Saves reference waveforms.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:CAN subsystem.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:I2S subsystem.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:IIC subsystem.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:LIN subsystem.

:SBUS<n>:SPI Commands (see page 618)

:SBUS<n>:UART Commands (see page 721)

:SEARch:EDGE Commands (see page 748)

:SEARch:GLITch Commands (see page 751)

:SEARch:RUNT Commands (see page 758)

:SEARch:TRANsition Commands (see page 748)

:TRIGger:LEVel:HIGH (see

page 849)

:TRIGger:LEVel:LOW (see

page 850)

:TRIGger:PATTern Commands (see

page 883)

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:SPI subsystem.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:UART subsystem.

Commands for searching edge events.

Commands for searching glitch events.

Commands for searching runt events.

Commands for searching edge transition events.

Sets runt and transition (rise/fall time) trigger high level.

Sets runt and transition (rise/fall time) trigger low level.

This subsystem contains commands/functions that are in the 7000B Series oscilloscope's :TRIGger:DURation subsystem.

42 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Command Description

What's New 1

Changed

Commands

:TRIGger:RUNT Commands (see page 892)

:TRIGger:SHOLd Commands (see page 897)

:TRIGger:TRANsition Commands (see page 903)

:WGEN Commands (see

page 959)

:WMEMory<r> Commands (see page 985)

Command Differences From InfiniiVision 7000B Series Oscilloscopes

:ACQuire:MODE (see

page 223)

:CALibrate:OUTPut (see

page 247)

:DISPlay:DATA (see page 296) Monochrome TIFF images of the graticule cannot be saved or

:DISPlay:LABList (see

page 298)

Commands for triggering on runt pulses.

Commands for triggering on setup and hold time violations.

Commands for triggering on edge transitions.

Commands for controlling the built-in waveform generator (with Option WGN license).

Commands for reference waveforms.

There is no ETIMe parameter with the 3000 X-Series oscilloscopes.

The TRIG OUT signal can be a trigger output, mask test failure, or waveform generator sync pulse.

restored.

The label list contains up to 77, 10-character labels (instead of

75).

:DISPlay:VECTors (see

page 300)

:MARKer Commands (see

page 363)

:MEASure Commands (see

page 379)

General :SBUS<n> Commands (see page 597)

:SAVE:IMAGe[:STARt] (see

page 578)

:SEARch:MODE (see

page 746)

:SEARch:SERial:IIC:MODE (see page 793)

:TRIGger:PATTern (see

page 884)

Always ON with 3000 X-Series oscilloscopes.

Can select reference waveforms as marker source.

Can select reference waveforms as the source for many measurements.

With multiple serial decode waveforms, "SBUS" is now "SBUS1" or "SBUS2".

Cannot save images to internal locations.

Can select EDGE, GLITch, RUNT, and TRANsition modes. Also, SERial is now SERial{1 | 2}.

ANACknowledge parameter is now ANACk.

Takes <string> parameter instead of <value>,<mask> parameters.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 43

1 What's New

Command Differences From InfiniiVision 7000B Series Oscilloscopes

:WAVeform:SOURce (see

page 945)

:VIEW (see page 217) PMEMory (pixel memory) locations are not present.

Can select reference waveforms as the source.

Obsolete

Commands

Obsolete Command Current Command Equivalent Behavior Differences

Discontinued

Commands

Command Description

:ACQuire:RSIGnal The 3000 X-Series oscilloscope does not have a 10 MHz REF

BNC connector.

:CALibrate:SWITch? Replaced by :CALibrate:PROTected? (see page 248). The

oscilloscope has a protection button instead of a switch.

:DISPlay:SOURce PMEMory (pixel memory) locations are not present.

:EXTernal:IMPedance External TRIG IN connector is now fixed at 1 MOhm.

:EXTernal:PROBe:ID Not supported on external TRIG IN connector.

:EXTernal:PROBe:STYPe Not supported on external TRIG IN connector.

:EXTernal:PROTection Not supported on external TRIG IN connector.

:HARDcopy:DEVice, :HARDcopy:FORMat

:MERGe Waveform traces have been replaced by reference waveforms.

:RECall:IMAGe[:STARt] Waveform traces have been replaced by reference waveforms.

:SYSTem:PRECision The 3000 X-Series oscilloscopes' measurement record is 62,500

:TIMebase:REFClock The 3000 X-Series oscilloscope does not have a 10 MHz REF

Use the :SAVE:IMAGe:FORMat, :SAVE:WAVeform:FORMat, and :HARDcopy:APRinter commands instead.

points, and there is no need for a special precision mode.

BNC connector.

44 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

2 Setting Up

Step 1. Install Agilent IO Libraries Suite software 46 Step 2. Connect and set up the oscilloscope 47 Step 3. Verify the oscilloscope connection 49

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.

2 Setting Up

Step 1. Install Agilent IO Libraries Suite software

1 Download the Agilent IO Libraries Suite software from the Agilent web

site at:

• "http://www.agilent.com/find/iolib"

2 Run the setup file, and follow its installation instructions.

46 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Step 2. Connect and set up the oscilloscope

USB Device Port

LAN/VGA

Option Module

GPIB

Option Module

The 3000 X-Series oscilloscope has three different interfaces you can use for programming:

• USB (device port).

• LAN, when the LAN/VGA option module is installed. To configure the

LAN interface, press the [Utility] key on the front panel, then press the I/O softkey, then press the Configure softkey.

• GPIB, when the GPIB option module is installed.

When installed, these interfaces are always active.

Setting Up 2

Figure 1 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.

Using the LAN Interface

1 If the controller PC is not already connected to the local area network

(LAN), do that first.

2 Contact your network administrator about adding the oscilloscope to

the network.

Find out if automatic configuration via DHCP or AutoIP can be used. Also, find out whether your network supports Dynamic DNS or Multicast DNS.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 47

2 Setting Up

If automatic configuration is not supported, get the oscilloscope's network parameters (hostname, domain, IP address, subnet mask, gateway IP, DNS IP, etc.).

3 Connect the oscilloscope to the local area network (LAN) by inserting

LAN cable into the "LAN" port on the LAN/VGA option module.

4 Configure the oscilloscope's LAN interface:

a Press the Configure softkey until "LAN" is selected. b Press the LAN Settings softkey. c Press the Config softkey, and enable all the configuration options

supported by your network.

d If automatic configuration is not supported, press the Addresses

softkey.

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 [Back up] key.

e Press the Host name softkey. Use the softkeys and the Entry knob to

enter the Host name.

When you are done, press the [Back up] key.

Using the GPIB Interface

1 Connect a GPIB cable from the controller PC's GPIB interface to the

"GPIB" port on the GPIB option module.

2 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.

48 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

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.)

Setting Up 2

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 49

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.

50 Agilent InfiniiVision 3000 X-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 Te st Con ne cti on .

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 51

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.

52 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

3 Test some commands on the instrument:

a Right- click on the instrument and choose Send Commands To This

Instrument from the popup menu.

Setting Up 2

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 3000 X-Series Oscilloscopes Programmer's Guide 53

2 Setting Up

54 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Agilent InfiniiVision 3000 X-Series Oscilloscopes

NOTE

Programmer's Guide

3 Getting Started

Basic Oscilloscope Program Structure 56 Programming the Oscilloscope 58 Other Ways of Sending Commands 67

This chapter gives you an overview of programming the 3000 X-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.

Language for Program Examples

The programming examples in this guide are written in Visual Basic using the Agilent VISA COM library.

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.

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

56 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

acquisition 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.

Getting Started 3

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 3000 X-Series Oscilloscopes Programmer's Guide 57

3 Getting Started

Programming the Oscilloscope

• "Referencing the IO Library" on page 58

• "Opening the Oscilloscope Connection via the IO Library" on page 59

• "Using :AUToscale to Automate Oscilloscope Setup" on page 60

• "Using Other Oscilloscope Setup Commands" on page 60

• "Capturing Data with the :DIGitize Command" on page 61

• "Reading Query Responses from the Oscilloscope" on page 63

• "Reading Query Results into String Variables" on page 64

• "Reading Query Results into Numeric Variables" on page 64

• "Reading Definite- Length Block Query Response Data" on page 64

• "Sending Multiple Queries and Reading Results" on page 65

• "Checking Instrument Status" on page 66

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".

58 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

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.

Getting Started 3

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 1089.

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 3000 X-Series Oscilloscopes Programmer's Guide 59

3 Getting Started

NOTE

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 and set the interface timeout to 10 seconds . myScope.IO.Clear myScope.IO.Timeout = 10000

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"

Information for Initializing the Instrument

The actual commands and syntax for initializing the instrument are discussed in Chapter 5, “Common (*) Commands,” starting on page 153.

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 ":CHANnel1:PROBe 10" myScope.WriteString ":CHANnel1:RANGe 16" myScope.WriteString ":CHANnel1:OFFSet 1.00" myScope.WriteString ":TIMebase:MODE MAIN" myScope.WriteString ":TIMebase:RANGe 1E-3" myScope.WriteString ":TIMebase:DELay 100E-6"

60 Agilent InfiniiVision 3000 X-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 myScope.IO.Timeout = 10000 ' Set interface timeout to 10 seconds.

' 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

myScope.WriteString ":CHANnel1:RANGe 1.6" ' Vertical range

myScope.WriteString ":CHANnel1:OFFSet -0.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 -0.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.

' to 10:1.

' 1.6 V full scale.

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 61

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.

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 ":ACQuire:TYPE AVERage" myScope.WriteString ":ACQuire:COMPlete 100" myScope.WriteString ":ACQuire:COUNt 8" myScope.WriteString ":DIGitize CHANnel1" myScope.WriteString ":WAVeform:SOURce CHANnel1" myScope.WriteString ":WAVeform:FORMat BYTE" myScope.WriteString ":WAVeform:POINts 500" myScope.WriteString ":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.

62 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

The easiest method of transferring a digitized waveform depends on data

NOTE

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 Chapter 31, “:WAVeform Commands,” starting on page 923.

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).

Getting Started 3

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 3000 X-Series Oscilloscopes Programmer's Guide 63

3 Getting Started

NOTE

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 for the formats and types of data returned from queries.

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 varQueryResult = 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:

64 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Getting Started 3

AXSDRNEC@S@SDQLHM@SNQ

"BST@K%@S@

/TLADQNE#XSDR SNAD5Q@MRLHSSDC

/TLADQNE%HFHSR

5G@S'NKKNV

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:

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 65

myScope.WriteString ":TIMebase:RANGe?;DELay?" Dim strResults() As String strResults() = myScope.ReadList(ASCIIType_BSTR) MsgBox "Timebase range: " + strResults(0) + ", delay: " + strResults(1)

3 Getting Started

Checking Instrument Status

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"

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 36, “Status Reporting,” starting on page 1055 which explains how to check the status of the instrument.

66 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Other Ways of Sending Commands

Standard Commands for Programmable Instrumentation (SCPI) can also be sent via a Telnet socket or through the Browser Web Control:

• "Telnet Sockets" on page 67

• "Sending SCPI Commands Using Browser Web Control" on page 67

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.

Getting Started 3

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 InfiniiVision 3000 X- 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 3000 X-Series Oscilloscopes Programmer's Guide 67

3 Getting Started

68 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

4 Commands Quick Reference

Command Summary 70 Syntax Elements 149

4 Commands Quick Reference

Command Summary

• Common (*) Commands Summary (see page 72)

• Root (:) Commands Summary (see page 75)

• :ACQuire Commands Summary (see page 78)

• :BUS<n> Commands Summary (see page 78)

• :CALibrate Commands Summary (see page 79)

• :CHANnel<n> Commands Summary (see page 80)

• :DEMO Commands Summary (see page 82)

• :DIGital<n> Commands Summary (see page 82)

• :DISPlay Commands Summary (see page 83)

• :EXTernal Trigger Commands Summary (see page 84)

• :FUNCtion Commands Summary (see page 84)

• :HARDcopy Commands Summary (see page 87)

• :LISTer Commands Summary (see page 88)

• :MARKer Commands Summary (see page 89)

• :MEASure Commands Summary (see page 90)

• :MTESt Commands Summary (see page 100)

• :POD<n> Commands Summary (see page 102)

• :POWer Commands Summary (see page 103)

• :RECall Commands Summary (see page 107)

• :SAVE Commands Summary (see page 108)

• General :SBUS<n> Commands Summary (see page 110)

• :SBUS<n>:A429 Commands Summary (see page 110)

• :SBUS<n>:CAN Commands Summary (see page 112)

• :SBUS<n>:FLEXray Commands Summary (see page 113)

• :SBUS<n>:I2S Commands Summary (see

• :SBUS<n>:IIC Commands Summary (see page 117)

• :SBUS<n>:LIN Commands Summary (see page 118)

• :SBUS<n>:M1553 Commands Summary (see page 119)

• :SBUS<n>:SPI Commands Summary (see page 120)

page 114)

• :SBUS<n>:UART Commands Summary (see page 122)

• General :SEARch Commands Summary (see page 124)

• :SEARch:EDGE Commands Summary (see page 124)

• :SEARch:GLITch Commands Summary (see page 124)

70 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

• :SEARch:RUNT Commands Summary (see page 125)

• :SEARch:TRANsition Commands Summary (see page 125)

• :SEARch:SERial:A429 Commands Summary (see page 126)

• :SEARch:SERial:CAN Commands Summary (see page 127)

• :SEARch:SERial:FLEXray Commands Summary (see page 127)

• :SEARch:SERial:I2S Commands Summary (see page 128)

• :SEARch:SERial:IIC Commands Summary (see page 128)

• :SEARch:SERial:LIN Commands Summary (see page 129)

• :SEARch:SERial:M1553 Commands Summary (see page 130)

• :SEARch:SERial:SPI Commands Summary (see page 130)

• :SEARch:SERial:UART Commands Summary (see page 131)

• :SYSTem Commands Summary (see page 131)

• :TIMebase Commands Summary (see page 132)

• General :TRIGger Commands Summary (see page 133)

• :TRIGger:DELay Commands Summary (see page 134)

• :TRIGger:EBURst Commands Summary (see page 135)

• :TRIGger[:EDGE] Commands Summary (see page 135)

• :TRIGger:GLITch Commands Summary (see page 136)

• :TRIGger:OR Commands Summary (see page 138)

• :TRIGger:PATTern Commands Summary (see page 138)

• :TRIGger:RUNT Commands Summary (see page 139)

• :TRIGger:SHOLd Commands Summary (see page 139)

• :TRIGger:TRANsition Commands Summary (see page 140)

• :TRIGger:TV Commands Summary (see page 140

• :TRIGger:USB Commands Summary (see page 142)

• :WAVeform Commands Summary (see page 142)

• :WGEN Commands Summary (see page 145)

• :WMEMory<r> Commands Summary (see page 147)

)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 71

4 Commands Quick Reference

Table 2 Common (*) Commands Summary

Command Query Options and Query Returns

*CLS (see page 157) n/a n/a

*ESE <mask> (see

page 158)

n/a *ESR? (see page 160) <status> ::= 0 to 255; an integer

n/a *IDN? (see page 160) AGILENT

*ESE? (see page 158) <mask> ::= 0 to 255; an integer

in NR1 format:

Bit Weight Name Enables

--- ------ ---- ---------7 128 PON Power On 6 64 URQ User Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev. Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operation Complete

in NR1 format

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 163) <learn_string> ::= current

instrument setup as a block of data in IEEE 488.2 # format

*OPC (see page 164) *OPC? (see page 164) ASCII "1" is placed in the output

queue when all pending device operations have completed.

72 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 2 Common (*) Commands Summary (continued)

Command Query Options and Query Returns

n/a *OPT? (see page 165) <return_value> ::= 0,0,<license

info> <license info> ::= <All field>, <reserved>, <MSO>, <reserved>, <Memory>, <Low Speed Serial>, <Automotive Serial>, <reserved>, <reserved>, <Power Measurements>, <RS-232/UART Serial>, <Segmented Memory>, <Mask Test>, <reserved>, <Bandwidth>, <reserved>, <reserved>, <reserved>, <I2S Serial>, <reserved>, <reserved>, <Waveform Generator>, <reserved>, <reserved> <All field> ::= {0 | All} <reserved> ::= 0 <MSO> ::= {0 | MSO} <Memory> ::= {0 | MEMUP} <Low Speed Serial> ::= {0 | EMBD} <Automotive Serial> ::= {0 | AUTO} <Power Measurements> ::= {0 | PWR} <RS-232/UART Serial> ::= {0 | COMP} <Segmented Memory> ::= {0 | SGM} <Mask Test> ::= {0 | MASK} <Bandwidth> ::= {0 | BW20 | BW50} <I2S Serial> ::= {0 | AUDIO} <Waveform Generator> ::= {0 | WAVEGEN}

*RCL <value> (see

page 167)

*RST (see page 168) n/a See *RST (Reset) (see page 168)

*SAV <value> (see

page 171)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 73

n/a <value> ::= {0 | 1 | 4 | 5 | 6 |

7 | 8 | 9}

n/a <value> ::= {0 | 1 | 4 | 5 | 6 |

7 | 8 | 9}

4 Commands Quick Reference

Table 2 Common (*) Commands Summary (continued)

Command Query Options and Query Returns

*SRE <mask> (see

page 172)

*SRE? (see page 173) <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 174) <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

5 32 ESB Enabled event status

4 16 MAV Message available. 3 8 ---- (Not used.) 2 4 MSG Message displayed. 1 2 USR User event

0 1 TRG A trigger occurred.

MSS requesting service.

condition occurred.

*TRG (see page 176) n/a n/a

n/a *TST? (see page 177) <result> ::= 0 or non-zero value;

an integer in NR1 format

*WAI (see page 178) n/a n/a

74 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 3 Root (:) Commands Summary

Command Query Options and Query Returns

:ACTivity (see

page 183)

n/a :AER? (see page 184) {0 | 1}; an integer in NR1 format

:AUToscale [<source>[,..,<source >]] (see page 185)

:AUToscale:AMODE <value> (see

page 187)

:ACTivity? (see

page 183)

n/a <source> ::= CHANnel<n> for DSO

:AUToscale:AMODE? (see page 187)

<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)

models <source> ::= {CHANnel<n> |

DIGital<d> | POD1 | POD2} for MSO models

<source> can be repeated up to 5 times <n> ::= 1 to (# analog channels) in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<value> ::= {NORMal | CURRent}}

:AUToscale:CHANnels <value> (see

page 188)

:AUToscale:FDEBug {{0 | OFF} | {1 | ON}} (see page 189)

:BLANk [<source>] (see page 190)

:AUToscale:CHANnels? (see page 188)

:AUToscale:FDEBug? (see page 189)

n/a <source> ::= {CHANnel<n>} |

<value> ::= {ALL | DISPlayed}}

{0 | 1}

FUNCtion | MATH | SBUS{1 | 2}} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion | MATH | SBUS{1 | 2}} for MSO models <n> ::= 1 to (# analog channels) in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 75

4 Commands Quick Reference

Table 3 Root (:) Commands Summary (continued)

Command Query Options and Query Returns

:DIGitize [<source>[,..,<source >]] (see page 191)

:MTEenable <n> (see

page 193)

n/a :MTERegister[:EVENt]?

:OPEE <n> (see

page 197)

n/a :OPERregister:CONDiti

n/a <source> ::= {CHANnel<n> |

:MTEenable? (see

page 193)

(see page 195)

:OPEE? (see page 198) <n> ::= 15-bit integer in NR1

on? (see page 199)

FUNCtion | MATH | SBUS{1 | 2}} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion | MATH | SBUS{1 | 2}} for MSO models

<source> can be repeated up to 5 times

<n> ::= 1 to (# analog channels) in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<n> ::= 16-bit integer in NR1 format

format

<n> ::= 15-bit integer in NR1 format

n/a :OPERegister[:EVENt]?

(see page 201)

:OVLenable <mask> (see page 203)

n/a :OVLRegister? (see

:OVLenable? (see

page 204)

page 205)

<n> ::= 15-bit integer in NR1 format

<mask> ::= 16-bit integer in NR1 format as shown:

Bit Weight Input

--- ------ ----------

10 1024 Ext Trigger Fault

9 512 Channel 4 Fault 8 256 Channel 3 Fault 7 128 Channel 2 Fault 6 64 Channel 1 Fault 4 16 Ext Trigger OVL 3 8 Channel 4 OVL 2 4 Channel 3 OVL 1 2 Channel 2 OVL 0 1 Channel 1 OVL

<value> ::= integer in NR1 format. See OVLenable for <value>

76 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 3 Root (:) Commands Summary (continued)

Command Query Options and Query Returns

:PRINt [<options>] (see page 207)

:PWRenable <n> (see

page 208)

n/a :PWRRegister[:EVENt]?

:RUN (see page 211) n/a n/a

n/a :SERial (see

:SINGle (see

page 213)

n/a :STATus? <display>

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.

:PWRenable? (see

page 208)

(see page 210)

page 212)

n/a n/a

(see page 214)

<n> ::= 16-bit integer in NR1 format

<return value> ::= unquoted string containing serial number

{0 | 1} <display> ::= {CHANnel<n> |

DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion | MATH | SBUS{1 | 2}} <n> ::= 1 to (# analog channels) in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

:STOP (see page 215) n/a n/a

n/a :TER? (see page 216) {0 | 1}

:VIEW <source> (see

page 217)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 77

n/a <source> ::= {CHANnel<n> |

FUNCtion | MATH | SBUS{1 | 2}} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion | MATH | SBUS{1 | 2}} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

4 Commands Quick Reference

Table 4 :ACQuire Commands Summary

Command Query Options and Query Returns

:ACQuire:COMPlete <complete> (see

page 221)

:ACQuire:COUNt <count> (see

page 222)

:ACQuire:MODE <mode> (see page 223)

n/a :ACQuire:POINts? (see

:ACQuire:SEGMented:AN ALyze (see page 225)

:ACQuire:SEGMented:CO UNt <count> (see

page 226)

:ACQuire:SEGMented:IN Dex <index> (see

page 227)

n/a :ACQuire:SRATe? (see

:ACQuire:COMPlete? (see page 221)

:ACQuire:COUNt? (see

page 222)

:ACQuire:MODE? (see

page 223)

page 224)

n/a n/a (with Option SGM)

:ACQuire:SEGMented:CO UNt? (see page 226)

:ACQuire:SEGMented:IN Dex? (see page 227)

page 230)

<complete> ::= 100; an integer in NR1 format

<count> ::= an integer from 2 to 65536 in NR1 format

<mode> ::= {RTIMe | SEGMented}

<# points> ::= an integer in NR1 format

<count> ::= an integer from 2 to 1000 in NR1 format (with Option SGM)

<index> ::= an integer from 1 to 1000 in NR1 format (with Option SGM)

<sample_rate> ::= sample rate (samples/s) in NR3 format

:ACQuire:TYPE <type> (see page 231)

:ACQuire:TYPE? (see

page 231)

<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 235)

:BUS<n>:BITS <channel_list>, {{0 | OFF} | {1 | ON}} (see

page 236)

:BUS<n>:BIT<m>? (see

page 235)

:BUS<n>:BITS? (see

page 236)

{0 | 1} <n> ::= 1 or 2; an integer in NR1 format <m> ::= 0-15; an integer in NR1 format

<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

78 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 5 :BUS<n> Commands Summary (continued)

Command Query Options and Query Returns

:BUS<n>:CLEar (see

page 238)

:BUS<n>:DISPlay {{0 | OFF} | {1 | ON}} (see

page 239)

:BUS<n>:LABel <string> (see

page 240)

:BUS<n>:MASK <mask> (see page 241)

n/a <n> ::= 1 or 2; an integer in NR1

format

:BUS<n>:DISPlay? (see

page 239)

:BUS<n>:LABel? (see

page 240)

:BUS<n>:MASK? (see

page 241)

{0 | 1} <n> ::= 1 or 2; an integer in NR1

format

<string> ::= quoted ASCII string up to 10 characters <n> ::= 1 or 2; an integer in NR1 format

<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 :CALibrate Commands Summary

Command Query Options and Query Returns

n/a :CALibrate:DATE? (see

page 245)

:CALibrate:LABel <string> (see

page 246)

:CALibrate:OUTPut <signal> (see

page 247)

n/a :CALibrate:PROTected?

:CALibrate:STARt (see

page 249)

:CALibrate:LABel? (see page 246)

:CALibrate:OUTPut? (see page 247)

(see page 248)

n/a n/a

<return value> ::= <year>,<month>,<day>; all in NR1 format

<string> ::= quoted ASCII string up to 32 characters

<signal> ::= {TRIGgers | MASK | WAVEgen}

{PROTected | UNPRotected}

Agilent InfiniiVision 3000 X-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:STATus?

(see page 250)

n/a :CALibrate:TEMPeratur

e? (see page 251)

n/a :CALibrate:TIME? (see

page 252)

<return value> ::= <status_code>,<status_string> <status_code> ::= an integer status code

<status_string> ::= an ASCII status string

<return value> ::= degrees C delta since last cal in NR3 format

<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 256)

:CHANnel<n>:COUPling <coupling> (see

page 257)

:CHANnel<n>:BWLimit? (see page 256)

:CHANnel<n>:COUPling? (see page 257)

{0 | 1} <n> ::= 1 to (# analog channels) in NR1 format

<coupling> ::= {AC | DC} <n> ::= 1 to (# analog channels)

in NR1 format

:CHANnel<n>:DISPlay {{0 | OFF} | {1 | ON}} (see page 258)

:CHANnel<n>:IMPedance <impedance> (see

page 259)

:CHANnel<n>:INVert {{0 | OFF} | {1 | ON}} (see page 260)

:CHANnel<n>:LABel <string> (see

page 261)

:CHANnel<n>:OFFSet <offset>[suffix] (see

page 262)

:CHANnel<n>:DISPlay? (see page 258)

:CHANnel<n>:IMPedance ? (see page 259)

:CHANnel<n>:INVert? (see page 260)

:CHANnel<n>:LABel? (see page 261)

:CHANnel<n>:OFFSet? (see page 262)

{0 | 1} <n> ::= 1 to (# analog channels)

in NR1 format

<impedance> ::= {ONEMeg | FIFTy} <n> ::= 1 to (# analog channels)

in NR1 format

{0 | 1} <n> ::= 1 to (# analog channels)

in NR1 format

<string> ::= any series of 10 or less ASCII characters enclosed in quotation marks <n> ::= 1 to (# analog channels) in NR1 format

<offset> ::= Vertical offset value in NR3 format

[suffix] ::= {V | mV} <n> ::= 1-2 or 1-4; in NR1 format

80 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 7 :CHANnel<n> Commands Summary (continued)

Command Query Options and Query Returns

:CHANnel<n>:PROBe <attenuation> (see

page 263)

:CHANnel<n>:PROBe:HEA D[:TYPE] <head_param> (see page 264)

n/a :CHANnel<n>:PROBe:ID?

:CHANnel<n>:PROBe:SKE W <skew_value> (see

page 266)

:CHANnel<n>:PROBe:STY Pe <signal type> (see

page 267)

:CHANnel<n>:PROTectio n (see page 268)

:CHANnel<n>:PROBe? (see page 263)

:CHANnel<n>:PROBe:HEA D[:TYPE]? (see

page 264)

(see page 265)

:CHANnel<n>:PROBe:SKE W? (see page 266)

:CHANnel<n>:PROBe:STY Pe? (see page 267)

:CHANnel<n>:PROTectio n? (see page 268)

<attenuation> ::= Probe attenuation ratio in NR3 format <n> ::= 1-2 or 1-4r in NR1 format

<head_param> ::= {SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | NONE}

<n> ::= 1 to (# analog channels) in NR1 format

<probe id> ::= unquoted ASCII string up to 11 characters

<n> ::= 1 to (# analog channels) in NR1 format

<skew_value> ::= -100 ns to +100 ns in NR3 format <n> ::= 1 to (# analog channels) in NR1 format

<signal type> ::= {DIFFerential | SINGle}

<n> ::= 1 to (# analog channels) in NR1 format

{NORM | TRIP} <n> ::= 1 to (# analog channels)

in NR1 format

:CHANnel<n>:RANGe <range>[suffix] (see

page 269)

:CHANnel<n>:SCALe <scale>[suffix] (see

page 270)

:CHANnel<n>:UNITs <units> (see

page 271)

:CHANnel<n>:VERNier {{0 | OFF} | {1 | ON}} (see page 272

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 81

:CHANnel<n>:RANGe? (see page 269)

:CHANnel<n>:SCALe? (see page 270)

:CHANnel<n>:UNITs? (see page 271)

:CHANnel<n>:VERNier? (see page 272)

)

<range> ::= Vertical full-scale range value in NR3 format

[suffix] ::= {V | mV} <n> ::= 1 to (# analog channels) in NR1 format

<scale> ::= Vertical units per division value in NR3 format

[suffix] ::= {V | mV} <n> ::= 1 to (# analog channels) in NR1 format

<units> ::= {VOLT | AMPere} <n> ::= 1 to (# analog channels)

in NR1 format

{0 | 1} <n> ::= 1 to (# analog channels)

in NR1 format

4 Commands Quick Reference

Table 8 :DEMO Commands Summary

Command Query Options and Query Returns

:DEMO:FUNCtion <signal> (see

page 274)

:DEMO:FUNCtion:PHASe: PHASe <angle> (see

page 278)

:DEMO:OUTPut {{0 | OFF} | {1 | ON}} (see

page 279)

:DEMO:FUNCtion? (see

page 276)

:DEMO:FUNCtion:PHASe: PHASe? (see page 278)

:DEMO:OUTPut? (see

page 279)

<signal> ::= {SINusoid | NOISy | PHASe | RINGing | SINGle | AM | CLK | GLITch | BURSt | MSO | RUNT | TRANsition | RFBurst | SHOLd | LFSine | FMBurst | ETE | CAN | LIN | UART | I2C | SPI | I2S | CANLin | ARINc | FLEXray | MIL | MIL2}

<angle> ::= angle in degrees from 0 to 360 in NR3 format

{0 | 1}

Table 9 :DIGital<d> Commands Summary

Command Query Options and Query Returns

:DIGital<d>:DISPlay {{0 | OFF} | {1 | ON}} (see page 283)

:DIGital<d>:DISPlay? (see page 283)

<d> ::= 0 to (# digital channels

- 1) in NR1 format

{0 | 1}

:DIGital<d>:LABel <string> (see

page 284)

:DIGital<d>:POSition <position> (see

page 285)

:DIGital<d>:LABel? (see page 284)

:DIGital<d>:POSition? (see page 285)

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<string> ::= any series of 10 or less ASCII characters enclosed in quotation marks

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<position> ::= 0-7 if display size = large, 0-15 if size = medium, 0-31 if size = small

Returns -1 when there is no space to display the digital waveform.

82 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 9 :DIGital<d> Commands Summary (continued)

Command Query Options and Query Returns

:DIGital<d>:SIZE <value> (see

page 286)

:DIGital<d>:THReshold <value>[suffix] (see

page 287)

:DIGital<d>:SIZE? (see page 286)

:DIGital<d>:THReshold ? (see page 287)

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<value> ::= {SMALl | MEDium | LARGe}

<d> ::= 0 to (# digital channels

- 1) 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 10 :DISPlay Commands Summary

Command Query Options and Query Returns

:DISPlay:ANNotation {{0 | OFF} | {1 | ON}} (see page 291)

:DISPlay:ANNotation:B ACKground <mode> (see

page 292)

:DISPlay:ANNotation? (see page 291)

:DISPlay:ANNotation:B ACKground? (see

page 292)

{0 | 1}

<mode> ::= {OPAQue | INVerted | TRANsparent}

:DISPlay:ANNotation:C OLor <color> (see

page 293)

:DISPlay:ANNotation:T EXT <string> (see

page 294)

:DISPlay:CLEar (see

page 295)

n/a :DISPlay:DATA?

:DISPlay:LABel {{0 | OFF} | {1 | ON}} (see

page 297)

:DISPlay:LABList <binary block> (see

page 298)

:DISPlay:ANNotation:C OLor? (see page 293)

:DISPlay:ANNotation:T EXT? (see page 294)

n/a n/a

[<format>][,][<palett e>] (see page 296)

:DISPlay:LABel? (see

page 297)

:DISPlay:LABList? (see page 298)

<color> ::= {CH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARKer | WHITe | RED}

<string> ::= quoted ASCII string (up to 254 characters)

<format> ::= {BMP | BMP8bit | PNG}

<palette> ::= {COLor | GRAYscale} <display data> ::= data in IEEE

488.2 # format

{0 | 1}

<binary block> ::= an ordered list of up to 75 labels, each 10 characters maximum, separated by newline characters

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 83

4 Commands Quick Reference

Table 10 :DISPlay Commands Summary (continued)

Command Query Options and Query Returns

:DISPlay:PERSistence <value> (see

page 299)

:DISPlay:VECTors {1 | ON} (see page 300)

:DISPlay:PERSistence? (see page 299)

:DISPlay:VECTors? (see page 300)

<value> ::= {MINimum | INFinite | <time>} <time> ::= seconds in in NR3 format from 100E-3 to 60E0

Table 11 :EXTernal Trigger Commands Summary

Command Query Options and Query Returns

:EXTernal:BWLimit <bwlimit> (see

page 302)

:EXTernal:PROBe <attenuation> (see

page 303)

:EXTernal:RANGe <range>[<suffix>] (see page 304)

:EXTernal:UNITs <units> (see

page 305)

:EXTernal:BWLimit? (see page 302)

:EXTernal:PROBe? (see

page 303)

:EXTernal:RANGe? (see

page 304)

:EXTernal:UNITs? (see

page 305)

<bwlimit> ::= {0 | OFF}

<attenuation> ::= probe attenuation ratio in NR3 format

<range> ::= vertical full-scale range value in NR3 format <suffix> ::= {V | mV}

<units> ::= {VOLT | AMPere}

Table 12 :FUNCtion Commands Summary

Command Query Options and Query Returns

:FUNCtion:BUS:CLOCk <source> (see

page 312)

:FUNCtion:BUS:SLOPe <slope> (see

page 313)

:FUNCtion:BUS:YINCrem ent <value> (see

page 314)

84 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:FUNCtion:BUS:CLOCk? (see page 312)

:FUNCtion:BUS:SLOPe? (see page 313)

:FUNCtion:BUS:YINCrem ent? (see page 314)

<source> ::= {CHANnel<n> | DIGital<d>} <n> ::= 1 to (# analog channels) in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<slope> ::= {NEGative | POSitive | EITHer}

<value> ::= value per bus code, in NR3 format

Commands Quick Reference 4

Table 12 :FUNCtion Commands Summary (continued)

Command Query Options and Query Returns

:FUNCtion:BUS:YORigin <value> (see

page 315)

:FUNCtion:BUS:YUNits <units> (see

page 316)

:FUNCtion:DISPlay {{0 | OFF} | {1 | ON}} (see page 317)

:FUNCtion[:FFT]:CENTe r <frequency> (see

page 318)

:FUNCtion[:FFT]:SPAN <span> (see page 319)

:FUNCtion[:FFT]:VTYPe <units> (see

page 320)

:FUNCtion[:FFT]:WINDo w <window> (see

page 321)

:FUNCtion:BUS:YORigin ? (see page 315)

:FUNCtion:BUS:YUNits? (see page 316)

:FUNCtion:DISPlay? (see page 317)

:FUNCtion[:FFT]:CENTe r? (see page 318)

:FUNCtion[:FFT]:SPAN? (see page 319)

:FUNCtion[:FFT]:VTYPe ? (see page 320)

:FUNCtion[:FFT]:WINDo w? (see page 321)

<value> ::= value at bus code = 0, in NR3 format

<units> ::= {VOLT | AMPere | NONE}

{0 | 1}

<frequency> ::= the current center frequency in NR3 format. The range of legal values is from 0 Hz to 25 GHz.

<span> ::= the current frequency span in NR3 format.

Legal values are 1 Hz to 100 GHz.

<units> ::= {DECibel | VRMS}

<window> ::= {RECTangular | HANNing | FLATtop | BHARris}

:FUNCtion:FREQuency:H IGHpass <3dB_freq> (see page 322)

:FUNCtion:FREQuency:L OWPass <3dB_freq> (see page 323)

:FUNCtion:GOFT:OPERat ion <operation> (see

page 324)

:FUNCtion:GOFT:SOURce 1 <source> (see

page 325)

:FUNCtion:GOFT:SOURce 2 <source> (see

page 326)

:FUNCtion:FREQuency:H IGHpass? (see

page 322)

:FUNCtion:FREQuency:L OWPass? (see

page 323)

:FUNCtion:GOFT:OPERat ion? (see page 324)

:FUNCtion:GOFT:SOURce 1? (see page 325)

:FUNCtion:GOFT:SOURce 2? (see page 326)

<3dB_freq> ::= 3dB cutoff frequency value in NR3 format

<operation> ::= {ADD | SUBTract | MULTiply}

<source> ::= CHANnel<n> <n> ::= {1 | 2 | 3 | 4} for 4ch

models <n> ::= {1 | 2} for 2ch models

<source> ::= CHANnel<n> <n> ::= {1 | 2 | 3 | 4} for 4ch

models <n> ::= {1 | 2} for 2ch models

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 85

4 Commands Quick Reference

Table 12 :FUNCtion Commands Summary (continued)

Command Query Options and Query Returns

:FUNCtion:INTegrate:I OFFset <input_offset> (see page 327)

:FUNCtion:LINear:GAIN <value> (see

page 328)

:FUNCtion:LINear:OFFS et <value> (see

page 329)

:FUNCtion:OFFSet <offset> (see

page 330)

:FUNCtion:OPERation <operation> (see

page 331)

:FUNCtion:INTegrate:I OFFset? (see

page 3?7)

:FUNCtion:LINear:GAIN ? (see page 328)

:FUNCtion:LINear:OFFS et? (see page 329)

:FUNCtion:OFFSet? (see page 330)

:FUNCtion:OPERation? (see page 332)

<input_offset> ::= DC offset correction in NR3 format.

<value> ::= 'A' in Ax + B, value in NR3 format

<value> ::= 'B' in Ax + B, value in NR3 format

<offset> ::= the value at center screen in NR3 format. The range of legal values is +/-10 times the current sensitivity of the selected function.

<operation> ::= {ADD | SUBTract | MULTiply | INTegrate | DIFF | FFT | SQRT | MAGNify | ABSolute | SQUare | LN | LOG | EXP | TEN | LOWPass | HIGHpass | DIVide | LINear | TRENd | BTIMing | BSTate}

:FUNCtion:RANGe <range> (see

page 333)

:FUNCtion:REFerence <level> (see

page 334)

:FUNCtion:SCALe <scale value>[<suffix>] (see

page 335)

:FUNCtion:RANGe? (see

page 333)

:FUNCtion:REFerence? (see page 334)

:FUNCtion:SCALe? (see

page 335)

<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 DIFF function is 80E-3 to 8.0E12 (depends on current sweep speed).

The range for the FFT function is 8 to 800 dBV.

<level> ::= the value at center screen in NR3 format. The range of legal values is +/-10 times the current sensitivity of the selected function.

<scale value> ::= integer in NR1 format

<suffix> ::= {V | dB}

86 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 12 :FUNCtion Commands Summary (continued)

Command Query Options and Query Returns

:FUNCtion:SOURce1 <source> (see

page 336)

:FUNCtion:SOURce2 <source> (see

page 338)

:FUNCtion:TRENd:MEASu rement <type> (see

page 339)

:FUNCtion:SOURce1? (see page 336)

:FUNCtion:SOURce2? (see page 338)

:FUNCtion:TRENd:MEASu rement? (see

page 339)

<source> ::= {CHANnel<n> | GOFT | BUS<m>} <n> ::= {1 | 2 | 3 | 4} for 4ch models

<n> ::= {1 | 2} for 2ch models <m> ::= {1 | 2} GOFT is only for FFT, INTegrate,

DIFF, and SQRT operations.

<source> ::= {CHANnel<n> | NONE} <n> ::= {{1 | 2} | {3 | 4}} for

4ch models, depending on SOURce1 selection <n> ::= {1 | 2} for 2ch models

<type> ::= {VAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDth | NWIDth | DUTYcycle | RISetime | FALLtime}

Table 13 :HARDcopy Commands Summary

Command Query Options and Query Returns

:HARDcopy:AREA <area> (see page 343)

:HARDcopy:APRinter <active_printer> (see

page 344)

:HARDcopy:FACTors {{0 | OFF} | {1 | ON}} (see page 345)

:HARDcopy:FFEed {{0 | OFF} | {1 | ON}} (see

page 346)

:HARDcopy:INKSaver {{0 | OFF} | {1 | ON}} (see page 347)

:HARDcopy:LAYout <layout> (see

page 348)

:HARDcopy:AREA? (see

page 343)

:HARDcopy:APRinter? (see page 344)

:HARDcopy:FACTors? (see page 345)

:HARDcopy:FFEed? (see

page 346)

:HARDcopy:INKSaver? (see page 347)

:HARDcopy:LAYout? (see page 348)

<area> ::= SCReen

<active_printer> ::= {<index> | <name>}

<index> ::= integer index of printer in list

<name> ::= name of printer in list

{0 | 1}

<layout> ::= {LANDscape | PORTrait}

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 87

4 Commands Quick Reference

Table 13 :HARDcopy Commands Summary (continued)

Command Query Options and Query Returns

:HARDcopy:NETWork:ADD Ress <address> (see

page 349)

:HARDcopy:NETWork:APP Ly (see page 350)

:HARDcopy:NETWork:DOM ain <domain> (see

page 351)

:HARDcopy:NETWork:PAS Sword <password> (see

page 352)

:HARDcopy:NETWork:SLO T <slot> (see

page 353)

:HARDcopy:NETWork:USE Rname <username> (see

page 354)

:HARDcopy:PALette <palette> (see

page 355)

n/a :HARDcopy:PRINter:LIS

:HARDcopy:NETWork:ADD Ress? (see page 349)

n/a n/a

:HARDcopy:NETWork:DOM ain? (see page 351)

n/a <password> ::= quoted ASCII

:HARDcopy:NETWork:SLO T? (see page 353)

:HARDcopy:NETWork:USE Rname? (see page 354)

:HARDcopy:PALette? (see page 355)

T? (see page 356)

<address> ::= quoted ASCII string

<domain> ::= quoted ASCII string

string

<slot> ::= {NET0 | NET1}

<username> ::= quoted ASCII string

<palette> ::= {COLor | GRAYscale | NONE}

<list> ::= [<printer_spec>] ... [printer_spec>]

<printer_spec> ::= "<index>,<active>,<name>;"

<index> ::= integer index of printer

<active> ::= {Y | N} <name> ::= name of printer

:HARDcopy:STARt (see

page 357)

n/a n/a

Table 14 :LISTer Commands Summary

Command Query Options and Query Returns

n/a :LISTer:DATA? (see

page 360)

88 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

<binary_block> ::= comma-separated data with newlines at the end of each row

Commands Quick Reference 4

Table 14 :LISTer Commands Summary (continued)

Command Query Options and Query Returns

:LISTer:DISPlay {{OFF | 0} | {SBUS1 | ON | 1} | {SBUS2 | 2} | ALL} (see page 361)

:LISTer:REFerence <time_ref> (see

page 362)

:LISTer:DISPlay? (see

page 361)

:LISTer:REFerence? (see page 362)

{OFF | SBUS1 | SBUS2 | ALL}

<time_ref> ::= {TRIGger | PREVious}

Table 15 :MARKer Commands Summary

Command Query Options and Query Returns

:MARKer:MODE <mode> (see page 365)

:MARKer:X1Position <position>[suffix] (see page 366)

:MARKer:X1Y1source <source> (see

page 367)

:MARKer:MODE? (see

page 365)

:MARKer:X1Position? (see page 366)

:MARKer:X1Y1source? (see page 367)

<mode> ::= {OFF | MEASurement | MANual | WAVeform}

<position> ::= X1 cursor position value in NR3 format

[suffix] ::= {s | ms | us | ns | ps | Hz | kHz | MHz}

<return_value> ::= X1 cursor position value in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= <source>

:MARKer:X2Position <position>[suffix] (see page 368)

:MARKer:X2Y2source <source> (see

page 369)

n/a :MARKer:XDELta? (see

:MARKer:XUNits <mode> (see page 371)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 89

:MARKer:X2Position? (see page 368)

:MARKer:X2Y2source? (see page 369)

page 370)

:MARKer:XUNits? (see

page 371)

<position> ::= X2 cursor position value in NR3 format

[suffix] ::= {s | ms | us | ns | ps | Hz | kHz | MHz}

<return_value> ::= X2 cursor position value in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= <source>

<return_value> ::= X cursors delta value in NR3 format

<units> ::= {SEConds | HERTz | DEGRees | PERCent}

4 Commands Quick Reference

Table 15 :MARKer Commands Summary (continued)

Command Query Options and Query Returns

:MARKer:XUNits:USE (see page 372)

:MARKer:Y1Position <position>[suffix] (see page 373)

:MARKer:Y2Position <position>[suffix] (see page 374)

n/a :MARKer:YDELta? (see

:MARKer:YUNits <mode> (see page 376)

:MARKer:YUNits:USE (see page 377)

n/a n/a

:MARKer:Y1Position? (see page 373)

:MARKer:Y2Position? (see page 374)

page 375)

:MARKer:YUNits? (see

page 376)

n/a n/a

Table 16 :MEASure Commands Summary

<position> ::= Y1 cursor position value in NR3 format

[suffix] ::= {V | mV | dB} <return_value> ::= Y1 cursor

position value in NR3 format

<position> ::= Y2 cursor position value in NR3 format

[suffix] ::= {V | mV | dB} <return_value> ::= Y2 cursor

position value in NR3 format

<return_value> ::= Y cursors delta value in NR3 format

<units> ::= {BASE | PERCent}

Command Query Options and Query Returns

:MEASure:ALL (see

page 391)

:MEASure:AREa [<interval>][,][<sour ce>] (see page 392)

:MEASure:BWIDth [<source>] (see

page 393)

:MEASure:CLEar (see

page 394)

n/a n/a

:MEASure:AREa? [<interval>][,][<sour ce>] (see page 392)

:MEASure:BWIDth? [<source>] (see

page 393)

n/a n/a

<interval> ::= {CYCLe | DISPlay} <source> ::= {CHANnel<n> |

FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= area in volt-seconds, NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= burst width in seconds, NR3 format

90 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:COUNter [<source>] (see

page 395)

:MEASure:DEFine DELay, <delay spec> (see page 396)

:MEASure:DEFine THResholds, <threshold spec> (see

page 396)

:MEASure:COUNter? [<source>] (see

page 395)

:MEASure:DEFine? DELay (see page 397)

:MEASure:DEFine? THResholds (see

page 397)

<source> ::= {CHANnel<n> | EXTernal} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | EXTernal} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= counter frequency in Hertz in NR3 format

edge_spec1 ::= [<slope>]<occurrence> edge_spec2 ::= [<slope>]<occurrence>

<slope> ::= {+ | -} <occurrence> ::= integer

<threshold spec> ::= {STANdard} | {<threshold mode>,<upper>, <middle>,<lower>}

<threshold mode> ::= {PERCent | ABSolute}

:MEASure:DELay [<source1>] [,<source2>] (see

page 399)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 91

:MEASure:DELay? [<source1>] [,<source2>] (see

page 399)

<source1,2> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format

<return_value> ::= floating-point number delay time in seconds in NR3 format

4 Commands Quick Reference

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:DUTYcycle [<source>] (see

page 401)

:MEASure:FALLtime [<source>] (see

page 402)

:MEASure:DUTYcycle? [<source>] (see

page 401)

:MEASure:FALLtime? [<source>] (see

page 402)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= ratio of positive pulse width to period in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= time in seconds between the lower and upper thresholds in NR3 format

:MEASure:FREQuency [<source>] (see

page 403)

92 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:MEASure:FREQuency? [<source>] (see

page 403)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= frequency in Hertz in NR3 format

Commands Quick Reference 4

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:NEDGes [<source>] (see

page 404)

:MEASure:NPULses [<source>] (see

page 405)

:MEASure:NWIDth [<source>] (see

page 406)

:MEASure:NEDGes? [<source>] (see

page 404)

:MEASure:NPULses? [<source>] (see

page 405)

:MEASure:NWIDth? [<source>] (see

page 406)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the falling

edge count in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the falling pulse count in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= negative pulse width in seconds-NR3 format

:MEASure:OVERshoot [<source>] (see

page 407)

:MEASure:PEDGes [<source>] (see

page 409)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 93

:MEASure:OVERshoot? [<source>] (see

page 407)

:MEASure:PEDGes? [<source>] (see

page 409)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the percent of the overshoot of the selected waveform in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format

<return_value> ::= the rising edge count in NR3 format

4 Commands Quick Reference

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:PERiod [<source>] (see

page 410)

:MEASure:PHASe [<source1>] [,<source2>] (see

page 411)

:MEASure:PPULses [<source>] (see

page 412)

:MEASure:PERiod? [<source>] (see

page 410)

:MEASure:PHASe? [<source1>] [,<source2>] (see

page 411)

:MEASure:PPULses? [<source>] (see

page 412)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= waveform period in seconds in NR3 format

<source1,2> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the phase

angle value in degrees in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the rising

pulse count in NR3 format

:MEASure:PREShoot [<source>] (see

page 413)

94 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:MEASure:PREShoot? [<source>] (see

page 413)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the percent of preshoot of the selected waveform in NR3 format

Commands Quick Reference 4

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:PWIDth [<source>] (see

page 414)

n/a :MEASure:RESults?

:MEASure:RISetime [<source>] (see

page 418)

:MEASure:PWIDth? [<source>] (see

page 414)

<result_list> (see

page 415)

:MEASure:RISetime? [<source>] (see

page 418)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= width of positive pulse in seconds in NR3 format

<result_list> ::= comma-separated list of measurement results

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= rise time in seconds in NR3 format

:MEASure:SDEViation [<source>] (see

page 419)

:MEASure:SHOW {1 | ON} (see page 420)

:MEASure:SDEViation? [<source>] (see

page 419)

:MEASure:SHOW? (see

page 420)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= calculated std deviation in NR3 format

{1}

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 95

4 Commands Quick Reference

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:SOURce <source1> [,<source2>] (see

page 421)

:MEASure:STATistics <type> (see page 423)

:MEASure:STATistics:D ISPlay {{0 | OFF} | {1 | ON}} (see

page 424)

:MEASure:SOURce? (see

page 421)

:MEASure:STATistics? (see page 423)

:MEASure:STATistics:D ISPlay? (see

page 424)

<source1,2> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal} for DSO models <source1,2> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r> | EXTernal} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= {<source> | NONE}

<type> ::= {{ON | 1} | CURRent | MEAN | MINimum | MAXimum | STDDev | COUNt} ON ::= all statistics returned

{0 | 1}

:MEASure:STATistics:I NCRement (see

page 425)

:MEASure:STATistics:M COunt <setting> (see

page 426)

:MEASure:STATistics:R ESet (see page 427)

:MEASure:STATistics:R SDeviation {{0 | OFF} | {1 | ON}} (see

page 428)

n/a n/a

:MEASure:STATistics:M COunt? (see page 426)

n/a n/a

:MEASure:STATistics:R SDeviation? (see

page 428)

<setting> ::= {INFinite | <count>} <count> ::= 2 to 2000 in NR1 format

{0 | 1}

96 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

Commands Quick Reference 4

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

n/a :MEASure:TEDGe?

<slope><occurrence>[, <source>] (see

page 429)

n/a :MEASure:TVALue?

<value>, [<slope>]<occurrence> [,<source>] (see

page 431)

<slope> ::= direction of the waveform <occurrence> ::= the transition to be reported

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= time in seconds of the specified transition

<value> ::= voltage level that the waveform must cross.

<slope> ::= direction of the waveform when <value> is crossed. <occurrence> ::= transitions reported.

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models

<source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format

<d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= time in seconds of specified voltage crossing in NR3 format

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 97

4 Commands Quick Reference

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:VAMPlitude [<source>] (see

page 433)

:MEASure:VAVerage [<interval>][,][<sour ce>] (see page 434)

:MEASure:VBASe [<source>] (see

page 435)

:MEASure:VAMPlitude? [<source>] (see

page 433)

:MEASure:VAVerage? [<interval>][,][<sour ce>] (see page 434)

:MEASure:VBASe? [<source>] (see

page 435)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= the amplitude

of the selected waveform in volts in NR3 format

<interval> ::= {CYCLe | DISPlay} <source> ::= {CHANnel<n> |

FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels)

in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= calculated average voltage in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <base_voltage> ::= voltage at the

base of the selected waveform in NR3 format

:MEASure:VMAX [<source>] (see

page 436)

:MEASure:VMIN [<source>] (see

page 437)

98 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:MEASure:VMAX? [<source>] (see

page 436)

:MEASure:VMIN? [<source>] (see

page 437)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= maximum voltage of the selected waveform in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= minimum voltage of the selected waveform in NR3 format

Commands Quick Reference 4

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:VPP [<source>] (see

page 438)

:MEASure:VRATio [<interval>][,][<sour ce1>] [,<source2>] (see page 439)

:MEASure:VRMS [<interval>][,] [<type>][,] [<source>] (see

page 440)

:MEASure:VPP? [<source>] (see

page 438)

:MEASure:VRATio? [<interval>][,][<sour ce1>] [,<source2>] (see page 439)

:MEASure:VRMS? [<interval>][,] [<type>][,] [<source>] (see

page 440)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= voltage

peak-to-peak of the selected waveform in NR3 format

<interval> ::= {CYCLe | DISPlay} <source1,2> ::= {CHANnel<n> |

FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels)

in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= the ratio value in dB in NR3 format

<interval> ::= {CYCLe | DISPlay} <type> ::= {AC | DC} <source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format <return_value> ::= calculated dc RMS voltage in NR3 format

n/a :MEASure:VTIMe?

<vtime>[,<source>] (see page 441)

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 99

<vtime> ::= displayed time from trigger in seconds in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} for DSO models <source> ::= {CHANnel<n> | DIGital<d> | FUNCtion | MATH | WMEMory<r>} for MSO models

<n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <d> ::= 0 to (# digital channels

- 1) in NR1 format

<return_value> ::= voltage at the specified time in NR3 format

4 Commands Quick Reference

Table 16 :MEASure Commands Summary (continued)

Command Query Options and Query Returns

:MEASure:VTOP [<source>] (see

page 442)

:MEASure:WINDow <type> (see page 443)

:MEASure:XMAX [<source>] (see

page 444)

:MEASure:XMIN [<source>] (see

page 445)

:MEASure:VTOP? [<source>] (see

page 442)

:MEASure:WINDow? (see

page 443)

:MEASure:XMAX? [<source>] (see

page 444)

:MEASure:XMIN? [<source>] (see

page 445)

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= voltage at the

top of the waveform in NR3 format

<type> ::= {MAIN | ZOOM | AUTO}

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}

<n> ::= 1 to (# analog channels) in NR1 format <r> ::= 1-2 in NR1 format

<return_value> ::= horizontal value of the maximum in NR3 format

<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>} <n> ::= 1 to (# analog channels) in NR1 format

<r> ::= 1-2 in NR1 format <return_value> ::= horizontal

value of the maximum in NR3 format

Table 17 :MTESt Commands Summary

Command Query Options and Query Returns

:MTESt:ALL {{0 | OFF} | {1 | ON}} (see

page 472)

:MTESt:AMASk:CREate (see page 473)

:MTESt:AMASk:SOURce <source> (see

page 474)

:MTESt:AMASk:UNITs <units> (see

page 475)

100 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

:MTESt:ALL? (see

page 472)

n/a n/a

:MTESt:AMASk:SOURce? (see page 474)

:MTESt:AMASk:UNITs? (see page 475)

{0 | 1}

<source> ::= CHANnel<n> <n> ::= {1 | 2 | 3 | 4} for 4ch models <n> ::= {1 | 2} for 2ch models

<units> ::= {CURRent | DIVisions}

Agilent DSOX3034A Programmer Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

In This Book

Contents

What's New in Version 2.10

What's New in Version 2.00

What's New in Version 1.20

What's New in Version 1.10

Version 1.00 at Introduction

Command Differences From 7000B Series Oscilloscopes

Step 1. Install Agilent IO Libraries Suite software

Step 2. Connect and set up the oscilloscope

Figure 1 Control Connectors on Rear Panel

Using the USB (Device) Interface

Using the LAN Interface

Using the GPIB Interface

Step 3. Verify the oscilloscope connection

Basic Oscilloscope Program Structure

Initializing

Capturing Data

Analyzing Captured Data

Programming the Oscilloscope

Referencing the IO Library

Opening the Oscilloscope Connection via the IO Library

Initializing the Interface and the Oscilloscope

Using :AUToscale to Automate Oscilloscope Setup

Using Other Oscilloscope Setup Commands

Capturing Data with the :DIGitize Command

Reading Query Responses from the Oscilloscope

Reading Query Results into String Variables

Reading Query Results into Numeric Variables

Reading Definite-Length Block Query Response Data

Figure 2 Definite-length block response data

Sending Multiple Queries and Reading Results

Checking Instrument Status

Other Ways of Sending Commands

Telnet Sockets

Sending SCPI Commands Using Browser Web Control

Command Summary