manualshive.com logo in svg

Agilent Technologies InfiniiVision 2000 X-Series, Programmer'S Manual, Page: 247 / 930

Share
Download
Agilent Technologies InfiniiVision 2000 X-Series Programmer'S Manual Download Page 247

:DIGital<d> Commands

12

Agilent InfiniiVision 2000 X-Series Oscilloscopes Programmer's Guide

247

 

:DIGital<d>:POSition

 (see 

page 790

)

Command Syntax

:DIGital<d>:POSition <position>

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

<position> ::= integer in NR1 format.

The :DIGital<d>:POSition command sets the position of the specified 
channel. Note that bottom positions might not be valid depending on 
whether digital buses, serial decode waveforms, or the zoomed time base 
are displayed.

Query Syntax

:DIGital<d>:POSition?

The :DIGital<d>:POSition? query returns the position of the specified 
channel.

If the returned value is "- 1", this indicates there is no space to display the 
digital waveform (for example, when all serial lanes, digital buses, and the 
zoomed time base are displayed).

Return Format

<position><NL>

<position> ::= integer in NR1 format.

See Also

•

"Introduction to :DIGital<d> Commands" 

on page 243

Channel Size

Position

Top

Bottom

Large

0-7

7

0

Medium

0-15

15

0

Small

0-31

31

0

N O T E

This command is only valid for the MSO models.

Summary of Contents for InfiniiVision 2000 X-Series

Page 1: ...s1 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide...

Page 2: ...terms of such license Restricted Rights Legend If software is for use in the performance of a U S Government prime contract or sub contract Software is delivered and licensed as Commercial computer s...

Page 3: ...messages Chapter 5 Common Commands starting on page 121 describes commands defined by the IEEE 488 2 standard that are common to all instruments Chapter 6 Root Commands starting on page 147 describes...

Page 4: ...t Chapter 16 FUNCtion Commands starting on page 277 describes commands that control math waveforms Chapter 17 HARDcopy Commands starting on page 295 describes commands that set and query the selection...

Page 5: ...3 describes commands that control reference waveforms Chapter 33 Obsolete and Discontinued Commands starting on page 703 describes obsolete commands which still work but have been replaced by newer co...

Page 6: ...nformation on using the SICL VISA and VISA COM libraries in general see the documentation that comes with the Agilent IO Libraries Suite For information on controller PC interface configuration see th...

Page 7: ...n Version 1 10 33 Version 1 00 at Introduction 34 Command Differences From 7000B Series Oscilloscopes 35 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 40 Step 2 Connect and set up th...

Page 8: ...te Length Block Query Response Data 58 Sending Multiple Queries and Reading Results 59 Checking Instrument Status 60 Other Ways of Sending Commands 61 Telnet Sockets 61 Sending SCPI Commands Using Bro...

Page 9: ...nable Mask Test Event Enable Register 161 MTERegister EVENt Mask Test Event Event Register 163 OPEE Operation Status Enable Register 165 OPERegister CONDition Operation Status Condition Register 167 O...

Page 10: ...ut 211 CALibrate PROTected 212 CALibrate STARt 213 CALibrate STATus 214 CALibrate TEMPerature 215 CALibrate TIME 216 10 CHANnel n Commands CHANnel n BWLimit 220 CHANnel n COUPling 221 CHANnel n DISPla...

Page 11: ...lay ANNotation 253 DISPlay ANNotation BACKground 254 DISPlay ANNotation COLor 255 DISPlay ANNotation TEXT 256 DISPlay CLEar 257 DISPlay DATA 258 DISPlay LABel 259 DISPlay LABList 260 DISPlay PERSisten...

Page 12: ...2 294 17 HARDcopy Commands HARDcopy AREA 297 HARDcopy APRinter 298 HARDcopy FACTors 299 HARDcopy FFEed 300 HARDcopy INKSaver 301 HARDcopy LAYout 302 HARDcopy NETWork ADDRess 303 HARDcopy NETWork APPLy...

Page 13: ...r 343 MEASure DEFine 344 MEASure DELay 347 MEASure DUTYcycle 349 MEASure FALLtime 350 MEASure FREQuency 351 MEASure NWIDth 352 MEASure OVERshoot 353 MEASure PERiod 355 MEASure PHASe 356 MEASure PRESho...

Page 14: ...393 MTESt ENABle 394 MTESt LOCK 395 MTESt RMODe 396 MTESt RMODe FACTion MEASure 397 MTESt RMODe FACTion PRINt 398 MTESt RMODe FACTion SAVE 399 MTESt RMODe FACTion STOP 400 MTESt RMODe SIGMa 401 MTESt...

Page 15: ...m LENGth MAX 442 SAVE WAVeform SEGMented 443 SAVE WMEMory SOURce 444 SAVE WMEMory STARt 445 25 SBUS n Commands General SBUS n Commands 449 SBUS n DISPlay 450 SBUS n MODE 451 SBUS n CAN Commands 452 SB...

Page 16: ...86 SBUS n LIN TRIGger 487 SBUS n LIN TRIGger ID 488 SBUS n LIN TRIGger PATTern DATA 489 SBUS n LIN TRIGger PATTern DATA LENGth 491 SBUS n LIN TRIGger PATTern FORMat 492 SBUS n SPI Commands 493 SBUS n...

Page 17: ...IDTh 530 26 SEARch Commands General SEARch Commands 532 SEARch COUNt 533 SEARch MODE 534 SEARch STATe 535 SEARch SERial CAN Commands 536 SEARch SERial CAN MODE 537 SEARch SERial CAN PATTern DATA 538 S...

Page 18: ...66 SYSTem ERRor 567 SYSTem LOCK 568 SYSTem MENU 569 SYSTem PRESet 570 SYSTem PROTection LOCK 573 SYSTem SETup 574 SYSTem TIME 576 28 TIMebase Commands TIMebase MODE 579 TIMebase POSition 580 TIMebase...

Page 19: ...TRIGger GLITch RANGe 614 TRIGger GLITch SOURce 615 TRIGger PATTern Commands 616 TRIGger PATTern 617 TRIGger PATTern FORMat 619 TRIGger PATTern QUALifier 620 TRIGger TV Commands 621 TRIGger TV LINE 622...

Page 20: ...EN MODulation AM FREQuency 673 WGEN MODulation FM DEViation 674 WGEN MODulation FM FREQuency 675 WGEN MODulation FSKey FREQuency 676 WGEN MODulation FSKey RATE 677 WGEN MODulation FUNCtion 678 WGEN MO...

Page 21: ...Ction SOURce 718 FUNCtion VIEW 719 HARDcopy DESTination 720 HARDcopy FILename 721 HARDcopy GRAYscale 722 HARDcopy IGColors 723 HARDcopy PDRiver 724 MEASure LOWer 725 MEASure SCRatch 726 MEASure TDELta...

Page 22: ...0 Error Queue 771 Operation Status Event Register OPERegister EVENt 772 Operation Status Condition Register OPERegister CONDition 773 Arm Event Register AER 774 Overload Event Register OVLRegister 775...

Page 23: ...ommands Are Sequential 798 38 Programming Examples VISA COM Examples 800 VISA COM Example in Visual Basic 800 VISA COM Example in C 809 VISA COM Example in Visual Basic NET 818 VISA COM Example in Pyt...

Page 24: ...24 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide...

Page 25: ...What s New What s New in Version 2 30 26 What s New in Version 2 20 28 What s New in Version 2 10 30 What s New in Version 2 00 31 What s New in Version 1 20 32 What s New in Version 1 10 33 Version 1...

Page 26: ...to a file SAVE MULTi STARt see page 436 Lets you save Multi Channel Waveform data h5 format files that can be opened by the N8900A InfiniiView oscilloscope analysis software SBUS n CAN Commands see p...

Page 27: ...channels to their waveforms 50 values Command Differences Command Differences BLANk see page 158 You can now use the SBUS1 source parameter to turn off the serial decode display DIGitize see page 159...

Page 28: ...tude modulation WGEN MODulation AM FREQuency see page 673 Specifies the frequency of the modulating signal WGEN MODulation FM DEViation see page 674 Specifies the frequency deviation from the original...

Page 29: ...an now use the WMEMory r source parameter to turn off the display of a reference waveform location STATus see page 179 You can now use the WMEMory r source parameter to view the display status of a re...

Page 30: ...ailed descriptions of the new and changed commands appear below New Commands Command Description DISPlay ANNotation see page 253 Turns screen annotation on or off DISPlay ANNotation BACKground see pag...

Page 31: ...ersion 2 00 of the InfiniiVision 2000 X Series oscilloscope software are Ability to add noise to the waveform generator s output signal More detailed descriptions of the new and changed commands appea...

Page 32: ...d Description FUNCtion FFT VTYPe see page 283 Specifies FFT vertical units as DECibel or VRMS MARKer XUNIts see page 325 Specifies the units for X cursors MARKer XUNIts USE see page 326 Sets the curre...

Page 33: ...Support for the new extended Video triggering license More detailed descriptions of the new and changed commands appear below New Commands Command Description SYSTem PRESet see page 570 Now documente...

Page 34: ...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 6...

Page 35: ...Serial decode is not supported Waveform event search is not supported Smaller set of trigger types Fewer measurements Different path name format for internal and USB storage device locations More deta...

Page 36: ...ter with the 2000 X Series oscilloscopes CALibrate OUTPut see page 211 The TRIG OUT signal can be a trigger output mask test failure or waveform generator sync pulse DISPlay DATA see page 258 Monochro...

Page 37: ...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...

Page 38: ...38 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 1 What s New...

Page 39: ...t IO Libraries Suite software 40 Step 2 Connect and set up the oscilloscope 41 Step 3 Verify the oscilloscope connection 43 This chapter explains how to install the Agilent IO Libraries Suite software...

Page 40: ...ogrammer s Guide 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 t...

Page 41: ...hen installed these interfaces are always active 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...

Page 42: ...nd 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...

Page 43: ...roller 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 contr...

Page 44: ...scilloscopes Programmer s Guide 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 o...

Page 45: ...es Oscilloscopes Programmer s Guide 45 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 ho...

Page 46: ...ies Oscilloscopes Programmer s Guide 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 conn...

Page 47: ...Send Commands To This Instrument from the popup menu b In the Agilent Interactive IO application enter commands in the Command field and press Send Command Read Response or Send Read c Choose Connect...

Page 48: ...48 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 2 Setting Up...

Page 49: ...programming the 2000 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 ho...

Page 50: ...ontroller 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 thresho...

Page 51: ...ail 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 changi...

Page 52: ...umeric Variables on page 58 Reading Definite Length Block Query Response Data on page 58 Sending Multiple Queries and Reading Results on page 59 Checking Instrument Status on page 60 Referencing the I...

Page 53: ...eList or WriteIEEEBlock methods are used for sending commands and queries After a query is sent the response is read using the ReadString ReadNumber ReadList or ReadIEEEBlock methods The following Vis...

Page 54: ...ope 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 comm...

Page 55: ...vertical range to 1 6 volts full scale with center screen at 0 4 volts with 10 1 probe attenuation and DC coupling myScope WriteString CHANnel1 PROBe 10 Probe attenuation to 10 1 myScope WriteString C...

Page 56: ...teString 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 com...

Page 57: ...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 f...

Page 58: ...im varQueryResult As Variant varQueryResult myScope ReadNumber MsgBox Range variant CStr varQueryResult After running this program the controller displays Range variant 40 Reading Definite Length Bloc...

Page 59: ...hem 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...

Page 60: ...m varResults As Variant varResults myScope ReadList MsgBox Timebase range FormatNumber varResults 0 1000 4 _ ms delay FormatNumber varResults 1 1000000 4 us Checking Instrument Status Status registers...

Page 61: ...ect to the oscilloscope via a telnet socket issue the following command telnet hostname 5024 where hostname is the hostname of the oscilloscope This will give you a command line with prompt For a comm...

Page 62: ...62 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 3 Getting Started...

Page 63: ...s1 63 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference Command Summary 64 Syntax Elements 117...

Page 64: ...mmands Summary see page 81 MARKer Commands Summary see page 81 MEASure Commands Summary see page 82 MTESt Commands Summary see page 89 POD n Commands Summary see page 91 RECall Commands Summary see pa...

Page 65: ...sk see page 126 ESE see page 126 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 Dep...

Page 66: ...Measurements 0 PWR Segmented Memory 0 SGM Mask Test 0 MASK Bandwidth 0 BW10 BW20 Waveform Generator 0 WAVEGEN RCL value see page 135 n a value 0 1 4 5 6 7 8 9 RST see page 136 n a See RST Reset see pa...

Page 67: ...2 4 MSG Message displayed 1 2 USR User event condition occurred 0 1 TRG A trigger occurred TRG see page 144 n a n a n a TST see page 145 result 0 or non zero value an integer in NR1 format WAI see pag...

Page 68: ...le AMODE see page 155 value NORMal CURRent AUToscale CHANnels value see page 156 AUToscale CHANnels see page 156 value ALL DISPlayed AUToscale FDEBug 0 OFF 1 ON see page 157 AUToscale FDEBug see page...

Page 69: ...r in NR1 format OPEE n see page 165 OPEE see page 165 n 15 bit integer in NR1 format n a OPERregister CONDiti on see page 167 n 15 bit integer in NR1 format n a OPERegister EVENt see page 169 n 15 bit...

Page 70: ...isplay see page 179 0 1 display CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH SBUS1 WMEMory r n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format r 1 to ref waveforms in N...

Page 71: ...page 190 ACQuire SEGMented CO UNt see page 190 count an integer from 2 to 25 in NR1 format with Option SGM ACQuire SEGMented IN Dex index see page 191 ACQuire SEGMented IN Dex see page 191 index an in...

Page 72: ...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 5 BUS n Commands Summary...

Page 73: ...0 0 1 n 1 to analog channels in NR1 format CHANnel n COUPling coupling see page 221 CHANnel n COUPling see page 221 coupling AC DC n 1 to analog channels in NR1 format CHANnel n DISPlay 0 OFF 1 ON see...

Page 74: ...HANnel n PROBe STY Pe signal type see page 231 CHANnel n PROBe STY Pe see page 231 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 232 CHANnel n PRO...

Page 75: ...lay see page 245 d 0 to digital channels 1 in NR1 format 0 1 DIGital d LABel string see page 246 DIGital d LABel see page 246 d 0 to digital channels 1 in NR1 format string any series of 10 or less AS...

Page 76: ...T string see page 256 DISPlay ANNotation T EXT see page 256 string quoted ASCII string up to 254 characters DISPlay CLEar see page 257 n a n a n a DISPlay DATA format palett e see page 258 format BMP...

Page 77: ...ee page 268 DVM MODE see page 268 dvm_mode ACRMs DC DCRMs FREQuency DVM SOURce source see page 269 DVM SOURce see page 269 source CHANnel n n 1 2 or 1 4 in NR1 format Table 12 EXTernal Trigger Command...

Page 78: ...its DECibel VRMS FUNCtion FFT WINDo w window see page 284 FUNCtion FFT WINDo w see page 284 window RECTangular HANNing FLATtop BHARris FUNCtion GOFT OPERat ion operation see page 285 FUNCtion GOFT OPE...

Page 79: ...suffix V dB FUNCtion SOURce1 source see page 293 FUNCtion SOURce1 see page 293 source CHANnel n GOFT n 1 2 3 4 for 4ch models n 1 2 for 2ch models GOFT is only for FFT operation FUNCtion SOURce2 sour...

Page 80: ...HARDcopy NETWork DOM ain see page 305 domain quoted ASCII string HARDcopy NETWork PAS Sword password see page 306 n a password quoted ASCII string HARDcopy NETWork SLO T slot see page 307 HARDcopy NE...

Page 81: ...ANual WAVeform MARKer X1Position position suffix see page 320 MARKer X1Position see page 320 position X1 cursor position value in NR3 format suffix s ms us ns ps Hz kHz MHz return_value X1 cursor posi...

Page 82: ...er Y2Position see page 328 position Y2 cursor position value in NR3 format suffix V mV dB return_value Y2 cursor position value in NR3 format n a MARKer YDELta see page 329 return_value Y cursors delt...

Page 83: ...ASure DUTYcycle source see page 349 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...

Page 84: ...see page 352 MEASure NWIDth source see page 352 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...

Page 85: ...channels in NR1 format r 1 2 in NR1 format return_value the phase angle value in degrees in NR3 format MEASure PREShoot source see page 357 MEASure PREShoot source see page 357 source CHANnel n FUNCti...

Page 86: ...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_val...

Page 87: ...ee page 367 MEASure VAMPlitude source see page 367 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...

Page 88: ...in NR1 format return_value minimum voltage of the selected waveform in NR3 format MEASure VPP source see page 372 MEASure VPP source see page 372 source CHANnel n FUNCtion MATH WMEMory r n 1 to analo...

Page 89: ...page 375 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 MEASure WINDow type see page 3...

Page 90: ...MTESt DATA mask see page 392 MTESt DATA see page 392 mask data in IEEE 488 2 format MTESt DELete see page 393 n a n a MTESt ENABle 0 OFF 1 ON see page 394 MTESt ENABle see page 394 0 1 MTESt LOCK 0 O...

Page 91: ...X1 value in NR3 format MTESt SCALe XDELta xdelta_value see page 406 MTESt SCALe XDELta see page 406 xdelta_value X delta value in NR3 format MTESt SCALe Y1 y1_value see page 407 MTESt SCALe Y1 see pag...

Page 92: ...mmand Query Options and Query Returns RECall FILename base_name see page 419 RECall FILename see page 419 base_name quoted ASCII string RECall MASK STARt file_spec see page 420 n a file_spec internal_...

Page 93: ...e page 432 SAVE IMAGe INKSaver see page 432 0 1 SAVE IMAGe PALette palette see page 433 SAVE IMAGe PALette see page 433 palette COLor GRAYscale MONochrome SAVE LISTer STARt file_name see page 434 n a...

Page 94: ...CURRent SAVE WMEMory SOURce source see page 444 SAVE WMEMory SOURce see page 444 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format NOTE Only ADD or SUBt...

Page 95: ...al B AUDrate see page 460 baudrate integer from 10000 to 4000000 in 100 b s increments or 5000000 SBUS n CAN SIGNal D EFinition value see page 461 SBUS n CAN SIGNal D EFinition see page 461 value CANH...

Page 96: ...S n IIC SOURce CLOCk see page 471 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SBUS n...

Page 97: ...PARity see page 481 0 1 SBUS n LIN SAMPlepo int value see page 482 SBUS n LIN SAMPlepo int see page 482 value 60 62 5 68 70 75 80 87 5 in NR3 format SBUS n LIN SIGNal B AUDrate baudrate see page 483...

Page 98: ...Tern DATA LENGth length see page 491 SBUS n LIN TRIGger PATTern DATA LENGth see page 491 length integer from 1 to 8 in NR1 format SBUS n LIN TRIGger PATTern FORMat base see page 492 SBUS n LIN TRIGger...

Page 99: ...n SPI SOURce M ISO see page 501 value CHANnel n EXTernal for the DSO models value CHANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SB...

Page 100: ...width integer 4 16 in NR1 format Table 26 SBUS n SPI Commands Summary continued Command Query Options and Query Returns Table 27 SBUS n UART Commands Summary Command Query Options and Query Returns SB...

Page 101: ...see page 522 SBUS n UART SOURce RX see page 522 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR...

Page 102: ...in NR3 format SBUS n UART TRIGger QUALifier value see page 528 SBUS n UART TRIGger QUALifier see page 528 value EQUal NOTequal GREaterthan LESSthan SBUS n UART TRIGger TYPE value see page 529 SBUS n U...

Page 103: ...X for hexadecimal SEARch SERial CAN PA TTern ID MODE value see page 541 SEARch SERial CAN PA TTern ID MODE see page 541 value STANdard EXTended Table 30 SEARch SERial IIC Commands Summary Command Quer...

Page 104: ...D DATA ERRor SEARch SERial LIN PA TTern DATA string see page 552 SEARch SERial LIN PA TTern DATA see page 552 When SEARch SERial LIN PATTern FORMa t DECimal string n where n 32 bit integer in unsigned...

Page 105: ...al hexadecimal binary or quoted_string format hexadecimal Hnn where n 0 9 A F for hexadecimal binary Bnn n where n 0 1 for binary quoted_string any of the 128 valid 7 bit ASCII characters or standard...

Page 106: ...Tem TIME time see page 576 SYSTem TIME see page 576 time hours minutes seconds in NR1 format Table 34 SYSTem Commands Summary continued Command Query Options and Query Returns Table 35 TIMebase Comman...

Page 107: ...d window Table 35 TIMebase Commands Summary continued Command Query Options and Query Returns Table 36 General TRIGger Commands Summary Command Query Options and Query Returns TRIGger FORCe see page 5...

Page 108: ...er EDGE Commands Summary Command Query Options and Query Returns TRIGger EDGE COUPl ing AC DC LFReject see page 602 TRIGger EDGE COUPl ing see page 602 AC DC LFReject TRIGger EDGE LEVel level source s...

Page 109: ...uery Options and Query Returns TRIGger GLITch GREat erthan greater_than_time s uffix see page 609 TRIGger GLITch GREat erthan see page 609 greater_than_time floating point number in NR3 format suffix...

Page 110: ...615 source CHANnel n DIGital d n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format Table 38 TRIGger GLITch Commands Summary continued Command Query Options and Query Returns...

Page 111: ...source CHANnel n n 1 to analog channels in NR1 format TRIGger TV STANdard standard see page 626 TRIGger TV STANdard see page 626 standard NTSC PAL PALM SECam Table 41 WAVeform Commands Summary Command...

Page 112: ...e see page 644 preamble_block format NR1 type NR1 points NR1 count NR1 xincrement NR3 xorigin NR3 xreference NR1 yincrement NR3 yorigin NR3 yreference NR1 format an integer in NR1 format 0 for BYTE fo...

Page 113: ...e 655 0 1 WAVeform VIEW view see page 656 WAVeform VIEW see page 656 view MAIN n a WAVeform XINCrement see page 657 return_value x increment in the current preamble in NR3 format n a WAVeform XORigin...

Page 114: ...page 672 percent AM depth percentage from 0 to 100 in NR1 format WGEN MODulation AM F REQuency frequency see page 673 WGEN MODulation AM F REQuency see page 673 frequency modulating waveform frequenc...

Page 115: ...in seconds in NR3 format WGEN RST see page 687 n a n a WGEN VOLTage amplitude see page 688 WGEN VOLTage see page 688 amplitude amplitude in volts in NR3 format WGEN VOLTage HIGH high see page 689 WGE...

Page 116: ...MEMory r SKEW skew see page 699 WMEMory r SKEW see page 699 r 1 2 in NR1 format skew time in seconds in NR3 format WMEMory r YOFFset offset suffix see page 700 WMEMory r YOFFset see page 700 r 1 2 in...

Page 117: ...th Block Response Data on page 118 Number Format NR1 specifies integer data NR3 specifies exponential data in floating point format for example 1 0E 3 NL Line Terminator NL new line or linefeed ASCII...

Page 118: ...example when using the Agilent VISA COM library in Visual Basic the command myScope WriteString CHANNEL1 LABEL One has a quoted ASCII string of One In order to read quoted ASCII strings from query ret...

Page 119: ...ilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 119 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 byte...

Page 120: ...120 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference...

Page 121: ...r Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operation Complete n a ESR see page 128 status 0 to 255 an int...

Page 122: ...urements 0 PWR Segmented Memory 0 SGM Mask Test 0 MASK Bandwidth 0 BW10 BW20 Waveform Generator 0 WAVEGEN RCL value see page 135 n a value 0 1 4 5 6 7 8 9 RST see page 136 n a See RST Reset see page 1...

Page 123: ...ars the status information and sets the average count In contrast if a root level command or some other subsystem command is within the program message you must re enter the original subsystem after t...

Page 124: ...2000 X Series Oscilloscopes Programmer s Guide 5 Common Commands NOTE Each of the status registers has an enable mask register By setting the bits in the enable register you can select the status inf...

Page 125: ...rror queue and the Request for OPC flag See Also Introduction to Common Commands on page 123 STB Read Status Byte on page 142 ESE Standard Event Status Enable on page 126 ESR Standard Event Status Reg...

Page 126: ...Standard Event Status Enable ESE Bit Name Description When Set 1 High True Enables 7 PON Power On Event when an OFF to ON transition occurs 6 URQ User Request Event when a front panel key is pressed...

Page 127: ...rns the current contents of the Standard Event Status Enable Register Return Format mask_argument NL mask_argument 0 255 an integer in NR1 format See Also Introduction to Common Commands on page 123 E...

Page 128: ...R1 format Table 46 Standard Event Status Register ESR Bit Name Description When Set 1 High True Indicates 7 PON Power On An OFF to ON transition has occurred 6 URQ User Request A front panel key has b...

Page 129: ...129 See Also Introduction to Common Commands on page 123 ESE Standard Event Status Enable on page 126 OPC Operation Complete on page 132 CLS Clear Status on page 125 SYSTem ERRor on page 567 NOTE Rea...

Page 130: ...query identifies the instrument type and software version Return Format AGILENT TECHNOLOGIES model serial number X XX XX NL model the model number of the instrument serial number the serial number of...

Page 131: ...instrument settings at a later time Return Format learn_string NL learn_string SYST SET setup_data setup_data binary block data in IEEE 488 2 format learn string specifies the current instrument setu...

Page 132: ...ter when all pending device operations have finished Query Syntax OPC The OPC query places an ASCII 1 in the output queue when all pending device operations have completed The interface hangs until th...

Page 133: ...Memory Mask Test reserved Bandwidth reserved reserved reserved reserved reserved Educator s Kit Waveform Generator reserved reserved reserved reserved reserved reserved Digital Voltmeter reserved All...

Page 134: ...134 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 5 Common Commands See Also Introduction to Common Commands on page 123 IDN Identification Number on page 130...

Page 135: ...s Programmer s Guide 135 RCL Recall see page 790 Command Syntax RCL value value 0 1 2 3 4 5 6 7 8 9 The RCL command restores the state of the instrument from the specified save recall register See Als...

Page 136: ...etup there are no user settings that remain unchanged To perform the equivalent of the front panel s Default Setup key where some user settings like preferences remain unchanged use the SYSTem PRESet...

Page 137: ...d TTL 1 4 V Display Menu Persistence Off Grid 20 Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time division 100 us Main time base delay 0 00 s Delay time division...

Page 138: ...rk as expected Most of the following initialization commands are initialized by RST It is not necessary to reinitialize them unless the default setting is not suitable for your application myScope Wri...

Page 139: ...Save see page 790 Command Syntax SAV value value 0 1 2 3 4 5 6 7 8 9 The SAV command stores the current state of the instrument in a save register The data parameter specifies the register where the...

Page 140: ...ster The Service Request Enable Register contains a mask value for the bits to be enabled in the Status Byte Register A one in the Service Request Enable Register enables the corresponding bit in the...

Page 141: ...Service Request Enable Register SRE Bit Name Description When Set 1 High True Enables 7 OPER Operation Status Register Interrupts when enabled conditions in the Operation Status Register OPER occur 6...

Page 142: ...bit is reported on bit 6 instead of the RQS request service bit The MSS indicates whether or not the device has at least one reason for requesting service Return Format value NL value 0 255 an integer...

Page 143: ...e When polled that the device is requesting service MSS Master Summary Status When read by STB whether the device has a reason for requesting service 5 ESB Event Status Bit An enabled condition in the...

Page 144: ...mmer s Guide 5 Common Commands TRG Trigger see page 790 Command Syntax TRG The TRG command has the same effect as the DIGitize command with no parameters See Also Introduction to Common Commands on pa...

Page 145: ...self test on the instrument The result of the test is placed in the output queue A zero indicates the test passed and a non zero indicates the test failed If the test fails refer to the troubleshootin...

Page 146: ...s Programmer s Guide 5 Common Commands WAI Wait To Continue see page 790 Command Syntax WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instruments S...

Page 147: ...teger in NR1 format levels logical highs or lows 32 bit integer in NR1 format n a AER see page 152 0 1 an integer in NR1 format AUToscale source source see page 153 n a source CHANnel n for DSO models...

Page 148: ...ion MATH for DSO models source CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH 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 N...

Page 149: ...VLenable for value PRINt options see page 175 n a options print option print option print option COLor GRAYscale PRINter0 PRINter1 BMP8bit BMP PNG NOFactors FACTors print option can be repeated up to...

Page 150: ...d tree position After executing a root level command the parser is positioned at the root of the command tree n a TER see page 181 0 1 VIEW source see page 182 n a source CHANnel n FUNCtion MATH SBUS1...

Page 151: ...er in NR1 format bit 0 DIGital 0 bit 15 DIGital 15 See Also Introduction to Root Commands on page 150 POD n THReshold on page 414 DIGital d THReshold on page 249 NOTE Because the ACTivity query return...

Page 152: ...n Status Event Register A Service Request can be generated when the Wait Trig bit transitions and the appropriate enable bits have been set in the Operation Status Enable Register OPEE and the Service...

Page 153: ...ecified those specified sources will be enabled and all others blanked The autoscale channels mode see AUToscale CHANnels on page 156 is set to DISPlayed channels Then the autoscale is performed When...

Page 154: ...Root Commands on page 150 AUToscale CHANnels on page 156 AUToscale AMODE on page 155 Example Code AUTOSCALE This command evaluates all the input signals and sets the correct conditions to display all...

Page 155: ...l acquisition type and the RTIMe real time acquisition mode When CURRent is selected the current acquisition type and mode are kept on subsequent AUToscales Use the ACQuire TYPE and ACQuire MODE comma...

Page 156: ...lected all channels that meet the requirements of AUToscale will be displayed When DISPlayed is selected only the channels that are turned on are autoscaled Use the VIEW or BLANk root commands to turn...

Page 157: ...option changes the behavior of AUToscale to let you make quick visual comparisons to determine whether the signal being probed is a DC voltage ground or an active AC signal Channel coupling is mainta...

Page 158: ...tal pod math function or serial decode bus The BLANk command with no parameter turns off all sources See Also Introduction to Root Commands on page 150 DISPlay CLEar on page 257 CHANnel n DISPlay on p...

Page 159: ...ment to acquire waveforms according to the settings of the ACQuire commands subsystem When the acquisition is complete the instrument is stopped If no argument is given DIGitize acquires the channels...

Page 160: ...Series Oscilloscopes Programmer s Guide 6 Root Commands Example Code Capture an acquisition using DIGitize myScope WriteString DIGitize CHANnel1 See complete example programs at Chapter 38 Programmin...

Page 161: ...the Mask Test Event Enable register as an integer number Return Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 150 AER Arm Event Register on page 152 Table...

Page 162: ...t Commands CHANnel n PROTection on page 232 OPERegister EVENt Operation Status Event Register on page 169 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on pa...

Page 163: ...OPERegister CONDition Operation Status Condition Register on page 167 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 Table 51 Mask Test Event Eve...

Page 164: ...164 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 6 Root Commands STB Read Status Byte on page 142 SRE Service Request Enable on page 140...

Page 165: ...Name Description When Set 1 High True Enables 14 12 Not used 11 OVLR Overload Event when 50 input overload occurs 10 Not used 9 MTE Mask Test Event Event when mask test event occurs 8 6 Not used 5 Wa...

Page 166: ...turn Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 150 AER Arm Event Register on page 152 CHANnel n PROTection on page 232 OPERegister EVENt Operation Stat...

Page 167: ...us Condition Register Bit Name Description When Set 1 High True Indicates 14 12 Not used 11 OVLR Overload A 50 input overload has occurred 10 Not used 9 MTE Mask Test Event A mask test event has occur...

Page 168: ...atus Event Register on page 169 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 STB Read Status Byte on page 142 SRE Service Request Enable on page...

Page 169: ...High True Indicates 14 12 Not used 11 OVLR Overload A 50 input overload has occurred 10 Not used 9 MTE Mask Test Event A mask test event has occurred 8 6 Not used 5 Wait Trig Wait Trig The trigger is...

Page 170: ...er CONDition Operation Status Condition Register on page 167 OVLenable Overload Event Enable Register on page 171 OVLRegister Overload Event Register on page 173 STB Read Status Byte on page 142 SRE S...

Page 171: ...1 GHz bandwidth oscilloscope models On these same bandwidth models if there are only two analog channels you can also set external trigger input impedance to 50 Table 55 Overload Event Enable Registe...

Page 172: ...Tection on page 232 OPEE Operation Status Enable Register on page 165 OPERegister CONDition Operation Status Condition Register on page 167 OPERegister EVENt Operation Status Event Register on page 16...

Page 173: ...l trigger input impedance to 50 Table 56 Overload Event Register OVLR Bit Description When Set 1 High True Indicates 15 10 Not used 9 Channel 4 Fault Fault has occurred on Channel 4 input 8 Channel 3...

Page 174: ...value integer in NR1 format See Also Introduction to Root Commands on page 150 CHANnel n PROTection on page 232 OPEE Operation Status Enable Register on page 165 OVLenable Overload Event Enable Regis...

Page 175: ...PNG NOFactors FACTors The print option parameter may be repeated up to 5 times The PRINt command formats the output according to the currently selected format device If an option is not specified the...

Page 176: ...lso Introduction to Root Commands on page 150 SINGle on page 178 STOP on page 180 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform display STO...

Page 177: ...2000 X Series Oscilloscopes Programmer s Guide 177 SERial see page 790 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also Intro...

Page 178: ...ot Commands SINGle see page 790 Command Syntax SINGle The SINGle command causes the instrument to acquire a single trigger of data This is the same as pressing the Single key on the front panel See Al...

Page 179: ...g channels in NR1 format d 0 to digital channels 1 in NR1 format r 1 to ref waveforms in NR1 format The STATus query reports whether the channel function or serial decode bus specified by source is di...

Page 180: ...Root Commands STOP see page 790 Command Syntax STOP The STOP command stops the acquisition This is the same as pressing the Stop key on the front panel See Also Introduction to Root Commands on page 1...

Page 181: ...red The Trigger Event Register is summarized in the TRG bit of the Status Byte Register STB A Service Request SRQ can be generated when the TRG bit of the Status Byte transitions and the TRG bit is se...

Page 182: ...channel function or serial decode bus See Also Introduction to Root Commands on page 150 BLANk on page 158 CHANnel n DISPlay on page 222 DIGital d DISPlay on page 245 FUNCtion DISPlay on page 280 POD...

Page 183: ...t ACQuire COUNt count see page 186 ACQuire COUNt see page 186 count an integer from 2 to 65536 in NR1 format ACQuire MODE mode see page 187 ACQuire MODE see page 187 mode RTIMe SEGMented n a ACQuire P...

Page 184: ...ution command sets the oscilloscope in the high resolution mode also known as smoothing This mode is used to reduce noise at slower sweep speeds where the digitizer samples faster than needed to fill...

Page 185: ...for the COMPlete command is 100 All time buckets must contain data for the acquisition to be considered complete Query Syntax ACQuire COMPlete The ACQuire COMPlete query returns the completion criter...

Page 186: ...y value from 2 to 65536 Query Syntax ACQuire COUNT The ACQuire COUNT query returns the currently selected count value for averaging mode Return Format count_argument NL count_argument an integer from...

Page 187: ...d sets the oscilloscope in real time mode The ACQuire MODE SEGMented command sets the oscilloscope in segmented memory mode Query Syntax ACQuire MODE The ACQuire MODE query returns the acquisition mod...

Page 188: ...signal The number of points acquired is not directly controllable To set the number of points to be transferred from the oscilloscope use the command WAVeform POINts The WAVeform POINts query will re...

Page 189: ...It corresponds to the front panel Analyze Segments softkey which appears in both the Measurement Statistics and Segmented Memory Menus In order to use this command the oscilloscope must be stopped and...

Page 190: ...d by the WAVeform SEGMented COUNt query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscilloscope with 100K memory allows a maximum of 25 segme...

Page 191: ...g of the currently indexed memory segment is returned by the WAVeform SEGMented TTAG query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscillo...

Page 192: ...de strQueryResult Set the number of segments to 25 myScope WriteString ACQuire SEGMented COUNt 25 myScope WriteString ACQuire SEGMented COUNt strQueryResult myScope ReadString Debug Print Acquisition...

Page 193: ...Str lngI myScope WriteString ACQuire SEGMented INDex strQueryResult myScope ReadString Debug Print Acquisition memory segment index strQueryResult Display the segment time tag myScope WriteString WAVe...

Page 194: ...page 790 Query Syntax ACQuire SRATe The ACQuire SRATe query returns the current oscilloscope acquisition sample rate The sample rate is not directly controllable Return Format sample_rate NL sample_ra...

Page 195: ...than needed to fill memory for the displayed time range For example if the digitizer samples at 200 MSa s but the effective sample rate is 1 MSa s because of a slower sweep speed only 1 out of every 2...

Page 196: ...83 ACQuire COUNt on page 186 ACQuire MODE on page 187 DIGitize on page 159 WAVeform FORMat on page 639 WAVeform TYPE on page 654 WAVeform PREamble on page 644 Example Code AQUIRE_TYPE Sets the acquisi...

Page 197: ...S n BIT m 0 OFF 1 ON see page 199 BUS n BIT m see page 199 0 1 n 1 or 2 an integer in NR1 format m 0 7 an integer in NR1 format BUS n BITS channel_list 0 OFF 1 ON see page 200 BUS n BITS see page 200...

Page 198: ...ssued following a RST command BUS1 DISP 0 LAB BUS1 MASK 255 BUS n LABel string see page 204 BUS n LABel see page 204 string quoted ASCII string up to 10 characters n 1 or 2 an integer in NR1 format BU...

Page 199: ...elected bus If the parameter is a 1 ON the bit is included in the definition If the parameter is a 0 OFF the bit is excluded from the definition Note BIT0 7 correspond to DIGital0 7 Query Syntax BUS n...

Page 200: ...d bus definition If the parameter is a 0 OFF then the bits in the channel list are excluded from the definition of the selected bus Query Syntax BUS n BITS The BUS n BITS query returns the definition...

Page 201: ...BUS n Commands 8 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 201 Include digital channels 1 through 3 5 and 7 in bus 1 myScope WriteString BUS1 BITS 1 3 5 7 ON...

Page 202: ...ffix to BUS and defines the bus that is affected by the command The BUS n CLEar command excludes all of the digital channels from the selected bus definition See Also Introduction to BUS n Commands on...

Page 203: ...affected by the command The BUS n DISPlay command enables or disables the view of the selected bus Query Syntax BUS n DISPlay The BUS n DISPlay query returns the display value of the selected bus Retu...

Page 204: ...e BUS n LABel query returns the name of the specified bus Return Format quoted_string NL quoted_string any series of 10 or less characters as a quoted ASCII string See Also Introduction to BUS n Comma...

Page 205: ...e bus that is affected by the command The BUS n MASK command defines the bits included and excluded in the selected bus according to the mask Set a mask bit to a 1 to include that bit in the selected...

Page 206: ...206 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 8 BUS n Commands...

Page 207: ...month day all in NR1 format CALibrate LABel string see page 210 CALibrate LABel see page 210 string quoted ASCII string up to 32 characters CALibrate OUTPut signal see page 211 CALibrate OUTPut see pa...

Page 208: ...te Commands Determining the state of the calibration factor protection switch CAL PROTECT Saving and querying the calibration label string Reporting the calibration time and date Reporting changes in...

Page 209: ...copes Programmer s Guide 209 CALibrate DATE see page 790 Query Syntax CALibrate DATE The CALibrate DATE query returns the date of the last calibration Return Format date NL date year month day in NR1...

Page 210: ...CALibrate LABel command saves a string that is up to 32 characters in length into the instrument s non volatile memory The string may be used to record calibration dates or other information as needed...

Page 211: ...t indicating a failure WAVEgen waveform generator sync output signal This signal depends on the WGEN FUNCtion setting Query Syntax CALibrate OUTPut The CALibrate OUTPut query returns the current sourc...

Page 212: ...ery Syntax CALibrate PROTected The CALibrate PROTected query returns the rear panel calibration protect CAL PROTECT button state The value PROTected indicates calibration is disabled and UNPRotected i...

Page 213: ...Rt command starts the user calibration procedure See Also Introduction to CALibrate Commands on page 207 CALibrate PROTected on page 212 NOTE Before starting the user calibration procedure you must se...

Page 214: ...0 Query Syntax CALibrate STATus The CALibrate STATus query returns the summary results of the last user calibration procedure Return Format return value NL return value status_code status_string statu...

Page 215: ...Perature see page 790 Query Syntax CALibrate TEMPerature The CALibrate TEMPerature query returns the change in temperature since the last user calibration procedure Return Format return value NL retur...

Page 216: ...Guide 9 CALibrate Commands CALibrate TIME see page 790 Query Syntax CALibrate TIME The CALibrate TIME query returns the time of the last calibration Return Format date NL date hour minutes seconds in...

Page 217: ...222 CHANnel n DISPlay see page 222 0 1 n 1 to analog channels in NR1 format CHANnel n IMPedance impedance see page 223 CHANnel n IMPedance see page 223 impedance ONEMeg n 1 to analog channels in NR1...

Page 218: ...ge 231 CHANnel n PROBe STY Pe see page 231 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 232 CHANnel n PROTectio n see page 232 NORM n 1 to analog...

Page 219: ...A label command provides identifying annotations of up to 10 characters You can toggle the channel displays on and off with the CHANnel n DISPlay command as well as with the root level commands VIEW a...

Page 220: ...nalog channels in NR1 format The CHANnel n BWLimit command controls an internal low pass filter When the filter is on the bandwidth of the specified channel is limited to approximately 25 MHz Query Sy...

Page 221: ...log channels in NR1 format The CHANnel n COUPling command selects the input coupling for the specified channel The coupling for each analog channel can be set to AC or DC Query Syntax CHANnel n COUPli...

Page 222: ...format The CHANnel n DISPlay command turns the display of the specified channel on or off Query Syntax CHANnel n DISPlay The CHANnel n DISPlay query returns the current display setting for the specif...

Page 223: ...s in NR1 format The CHANnel n IMPedance command selects the input impedance setting for the specified analog channel The only legal value for this command is ONEMeg 1 M Query Syntax CHANnel n IMPedanc...

Page 224: ...nalog channels in NR1 format The CHANnel n INVert command selects whether or not to invert the input signal for the specified channel The inversion may be 1 ON inverted or 0 OFF not inverted Query Syn...

Page 225: ...g NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 218 DISPlay LABel on page 259 DIGital d LABel on page 246 DISPlay LABList on page 260 BUS n LABel on page 204 Exampl...

Page 226: ...alues varies with the value set by the CHANnel n RANGe and CHANnel n SCALe commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest leg...

Page 227: ...the reference constants for scaling the display factors for making automatic measurements and for setting trigger levels Query Syntax CHANnel n PROBe The CHANnel n PROBe query returns the current prob...

Page 228: ...12 Single ended 12dB SEND20 Single ended 20dB DIFF0 Differential 0dB DIFF6 Differential 6dB DIFF12 Differential 12dB DIFF20 Differential 20dB Query Syntax CHANnel n PROBe HEAD TYPE The CHANnel n PROBe...

Page 229: ...n PROBe ID query returns the type of probe attached to the specified oscilloscope channel Return Format probe id NL probe id unquoted ASCII string up to 11 characters Some of the possible returned val...

Page 230: ...sets the channel to channel skew factor for the specified channel Each analog channel can be adjusted or 100 ns for a total of 200 ns difference between channels You can use the oscilloscope s probe...

Page 231: ...s and determines how offset is applied When single ended is selected the CHANnel n OFFset command changes the offset value of the probe amplifier When differential is selected the CHANnel n OFFset com...

Page 232: ...annel input impedance is always 1 M so automatic overvoltage protection is not necessary as it is for channels with 50 input impedance There are no protection settings to clear so the CHANnel n PROTec...

Page 233: ...ed the range value is multiplied by the probe attenuation factor Query Syntax CHANnel n RANGe The CHANnel n RANGe query returns the current full scale range setting for the specified channel Return Fo...

Page 234: ...ommand sets the vertical scale or units per division of the selected channel If the probe attenuation is changed the scale value is multiplied by the probe s attenuation factor Query Syntax CHANnel n...

Page 235: ...onnected probe Select VOLT for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Synta...

Page 236: ...ON 0 OFF n 1 to analog channels in NR1 format The CHANnel n VERNier command specifies whether the channel s vernier fine vertical adjustment setting is ON 1 or OFF 0 Query Syntax CHANnel n VERNier The...

Page 237: ...etup Use DEMO to query setup information for the DEMO subsystem Return Format The following is a sample response from the DEMO query In this case the query was issued following the RST command DEMO FU...

Page 238: ...offset phase shifted by the amount entered using the DEMO FUNCtion PHASe PHASe on page 240 command RINGing 500 kHz digital pulse 3 Vpp 1 5 V offset and 500 ns pulse width with ringing Off SINGle 500 n...

Page 239: ...kHz stair step sine wave output of DAC 1 5 Vpp 0 75 V offset DAC input signals are internally routed to digital channels D0 through D7 3 1 kHz sine wave filtered from DAC output 600 mVpp 300 mV offse...

Page 240: ...0 in NR3 format For the phase shifted sine demo signals the DEMO FUNCtion PHASe PHASe command specifies the phase shift in the second sine waveform Query Syntax DEMO FUNCtion PHASe PHASe The DEMO FUNC...

Page 241: ...O OUTPut on_off on_off 1 ON 0 OFF The DEMO OUTPut command specifies whether the demo signal output is ON 1 or OFF 0 Query Syntax DEMO OUTPut The DEMO OUTPut query returns the current state of the demo...

Page 242: ...242 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 11 DEMO Commands...

Page 243: ...ABel see page 246 d 0 to digital channels 1 in NR1 format string any series of 10 or less ASCII characters enclosed in quotation marks DIGital d POSition position see page 247 DIGital d POSition see p...

Page 244: ...ls They also control threshold settings for groups of digital channels or pods Reporting the Setup Use DIGital d to query setup information for the DIGital subsystem Return Format The following is a s...

Page 245: ...command turns digital display on or off for the specified channel Query Syntax DIGital d DISPlay The DIGital d DISPlay query returns the current digital display setting for the specified channel Retur...

Page 246: ...in non volatile memory replacing the oldest label in the list Query Syntax DIGital d LABel The DIGital d LABel query returns the name of the specified channel Return Format label string NL label strin...

Page 247: ...es serial decode waveforms or the zoomed time base are displayed Query Syntax DIGital d POSition The DIGital d POSition query returns the position of the specified channel If the returned value is 1 t...

Page 248: ...s on the display Sizes are set for all digital channels Therefore if you set the size on digital channel 0 for example the same size is set on all other as well Query Syntax DIGital d SIZE The DIGital...

Page 249: ...and sets the logic threshold value for all channels in the same pod as the specified channel The threshold is used for triggering purposes and for displaying the digital data as high above the thresho...

Page 250: ...250 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 12 DIGital d Commands...

Page 251: ...TRANsparent DISPlay ANNotation C OLor color see page 255 DISPlay ANNotation C OLor see page 255 color CH1 CH2 CH3 CH4 DIG MATH REF MARKer WHITe RED DISPlay ANNotation T EXT string see page 256 DISPlay...

Page 252: ...ls Save and Recall display data Reporting the Setup Use DISPlay to query the setup information for the DISPlay subsystem Return Format The following is a sample response from the DISPlay query In this...

Page 253: ...e annotation appears in the upper left corner of the oscilloscope s display The annotation is useful for documentation purposes to add notes before capturing screens Query Syntax DISPlay ANNotation Th...

Page 254: ...OPAQue the annotation has a solid background INVerted the annotation s foreground and background colors are switched TRANsparent the annotation has a transparent background Query Syntax DISPlay ANNota...

Page 255: ...tation color You can choose white red or colors that match analog channels digital channels math waveforms reference waveforms or markers Query Syntax DISPlay ANNotation COLor The DISPlay ANNotation C...

Page 256: ...ine character but the actual backslash and n characters in the string Carriage returns lessen the number of characters available for the annotation string Use DISPlay ANNotation TEXT to remotely clear...

Page 257: ...he DISPlay CLEar command clears the display and resets all associated measurements If the oscilloscope is stopped all currently displayed data is erased If the oscilloscope is running all of the data...

Page 258: ...on to DISPlay Commands on page 252 HARDcopy INKSaver on page 301 PRINt on page 175 RCL Recall on page 135 SAV Save on page 139 VIEW on page 182 Example Code IMAGE_TRANSFER In this example we will quer...

Page 259: ...and off Query Syntax DISPlay LABel The DISPlay LABel query returns the display mode of the analog and digital labels Return Format value NL value 0 1 See Also Introduction to DISPlay Commands on page...

Page 260: ...LABList query returns the label list Return Format binary block NL binary block an ordered list of up to 75 labels a maximum of 10 characters each separated by newline characters See Also Introduction...

Page 261: ...the persistence setting MINimum indicates zero persistence INFinite indicates infinite persistence time for variable persistence that is you can specify how long acquisitions remain on the screen Use...

Page 262: ...VECTors vectors vectors 1 ON The only legal value for the DISPlay VECTors command is ON or 1 This specifies that lines are drawn between acquired data points on the screen Query Syntax DISPlay VECTor...

Page 263: ...d Query Returns DVM ARANge 0 OFF 1 ON see page 264 DVM ARANge see page 264 0 1 n a DVM CURRent see page 265 dvm_value floating point number in NR3 format DVM ENABle 0 OFF 1 ON see page 266 DVM ENABle...

Page 264: ...al scale vertical ground level position and trigger threshold voltage level used for the counter frequency measurement are automatically adjusted The Auto Range capability overrides attempted adjustme...

Page 265: ...see page 790 Query Syntax DVM CURRent The DVM CURRent query returns the displayed 3 digit DVM value based on the current mode Return Format dvm_value NL dvm_value floating point number in NR3 format...

Page 266: ...etting OFF 0 ON 1 The DVM ENABle command turns the digital voltmeter DVM analysis feature on or off Query Syntax DVM ENABle The DVM ENABle query returns a flag indicating whether the digital voltmeter...

Page 267: ...Query Syntax DVM FREQuency The DVM FREQuency query returns the displayed 5 digit frequency value that is displayed below the main DVM value Return Format freq_value NL freq_value floating point numbe...

Page 268: ...value of the acquired data with the DC component removed DC displays the DC value of the acquired data DCRMs displays the root mean square value of the acquired data FREQuency displays the frequency...

Page 269: ...channel on which digital voltmeter DVM measurements are made The selected channel does not have to be on displaying a waveform in order for DVM measurements to be made Query Syntax DVM SOURce The DVM...

Page 270: ...270 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 14 DVM Commands...

Page 271: ...orting the Setup Use EXTernal to query setup information for the EXTernal subsystem Return Format The following is a sample response from the EXTernal query In this case the query was issued following...

Page 272: ...or product compatibility The only legal value is 0 or OFF Use the TRIGger HFReject command to limit bandwidth on the external trigger input Query Syntax EXTernal BWLimit The EXTernal BWLimit query ret...

Page 273: ...ce constants for scaling the display factors and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempt...

Page 274: ...sing 1 1 probe attenuation the range can only be set to 8 0 V If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Query Syntax EXTernal RANGe The EXTernal...

Page 275: ...for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Syntax EXTernal UNITs The CHANn...

Page 276: ...276 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 15 EXTernal Trigger Commands...

Page 277: ...SPAN span see page 282 FUNCtion FFT SPAN see page 282 span the current frequency span in NR3 format Legal values are 1 Hz to 100 GHz FUNCtion FFT VTYPe units see page 283 FUNCtion FFT VTYPe see page 2...

Page 278: ...ge see page 290 FUNCtion RANGe see page 290 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 FFT function is 8 to 800 dBV FUNCtion...

Page 279: ...e from time to frequency Hz and the vertical cursors change from volts to decibel dB Reporting the Setup Use FUNCtion to query setup information for the FUNCtion subsystem Return Format The following...

Page 280: ...the function on or off When ON is selected the function performs as specified using the other FUNCtion commands When OFF is selected function is neither calculated nor displayed Query Syntax FUNCtion...

Page 281: ...UNCtion FFT CENTer query returns the current center frequency in Hertz Return Format frequency NL frequency the current center frequency in NR3 format The range of legal values is from 0 Hz to 25 GHz...

Page 282: ...cule when FFT Fast Fourier Transform is selected Query Syntax FUNCtion FFT SPAN The FUNCtion FFT SPAN query returns the current frequency span in Hertz Return Format span NL span the current frequency...

Page 283: ...NCtion FFT VTYPe units units DECibel VRMS The FUNCtion FFT VTYPe command specifies FFT vertical units as DECibel or VRMS Query Syntax FUNCtion FFT VTYPe The FUNCtion FFT VTYPe query returns the curren...

Page 284: ...othly at the start and end of the record are employed as filters to the FFTs Each window is useful for certain classes of input signals RECTangular useful for transient signals and signals where there...

Page 285: ...nput to the FFT function ADD Source1 source2 SUBTract Source1 source2 MULTiply Source1 source2 The FUNCtion GOFT SOURce1 and FUNCtion GOFT SOURce2 commands are used to select source1 and source2 Query...

Page 286: ...and selects the first input channel for the g t source that can be used as the input to the FFT function Query Syntax FUNCtion GOFT SOURce1 The FUNCtion GOFT SOURce1 query returns the current selectio...

Page 287: ...command selects the second input channel for the g t source that can be used as the input to the FFT function Query Syntax FUNCtion GOFT SOURce2 The FUNCtion GOFT SOURce2 query returns the current sel...

Page 288: ...cale of the selected function but will vary by function If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Query Syntax FUNCti...

Page 289: ...2 FFT Fast Fourier Transform on the selected waveform source When the operation is ADD SUBTract or MULTiply the FUNCtion SOURce1 and FUNCtion SOURce2 commands are used to select source1 and source2 Fo...

Page 290: ...value in NR3 format The FUNCtion RANGe command defines the full scale vertical axis for the selected function Query Syntax FUNCtion RANGe The FUNCtion RANGe query returns the current full scale range...

Page 291: ...le of the selected function but will vary by function If you set the reference level to a value outside of the legal range the level is automatically set to the nearest legal value Query Syntax FUNCti...

Page 292: ...B The FUNCtion SCALe command sets the vertical scale or units per division of the selected function Legal values for the scale depend on the selected function Query Syntax FUNCtion SCALe The FUNCtion...

Page 293: ...r the FFT function It lets you specify as the function input source the addition subtraction or multiplication of two channels When GOFT is used the g t source is specified by the FUNCtion GOFT OPERat...

Page 294: ...ource If CHANnel1 or CHANnel2 is selected for FUNCtion SOURce1 the SOURce2 selection can be CHANnel1 or CHANnel2 Likewise if CHANnel3 or CHANnel4 is selected for FUNCtion SOURce1 the SOURce2 selection...

Page 295: ...ex name index integer index of printer in list name name of printer in list HARDcopy FACTors 0 OFF 1 ON see page 299 HARDcopy FACTors see page 299 0 1 HARDcopy FFEed 0 OFF 1 ON see page 300 HARDcopy F...

Page 296: ...ued following the RST command HARD APR AREA SCR FACT 0 FFE 0 INKS 1 PAL NONE LAY PORT HARDcopy NETWork PAS Sword password see page 306 n a password quoted ASCII string HARDcopy NETWork SLO T slot see...

Page 297: ...urrently the only legal choice is SCReen Query Syntax HARDcopy AREA The HARDcopy AREA query returns the selected display area Return Format area NL area SCR See Also Introduction to HARDcopy Commands...

Page 298: ...name index integer index of printer in list name name of printer in list The HARDcopy APRinter command sets the active printer Query Syntax HARDcopy APRinter The HARDcopy APRinter query returns the n...

Page 299: ...e scale factors are output on the hardcopy dump Query Syntax HARDcopy FACTors The HARDcopy FACTors query returns a flag indicating whether oscilloscope instrument settings are output on the hardcopy R...

Page 300: ...output between the screen image and factors of a hardcopy dump Query Syntax HARDcopy FFEed The HARDcopy FFEed query returns a flag indicating whether a formfeed is output at the end of the hardcopy du...

Page 301: ...ntrols whether the graticule colors are inverted or not Query Syntax HARDcopy INKSaver The HARDcopy INKSaver query returns a flag indicating whether graticule colors are inverted or not Return Format...

Page 302: ...HARDcopy LAYout command sets the hardcopy layout mode Query Syntax HARDcopy LAYout The HARDcopy LAYout query returns the selected hardcopy layout mode Return Format layout NL layout LAND PORT See Als...

Page 303: ...t The network printer slot is selected by the HARDcopy NETWork SLOT command To apply the entered address use the HARDcopy NETWork APPLy command Query Syntax HARDcopy NETWork ADDRess The HARDcopy NETWo...

Page 304: ...ETWork APPLy The HARDcopy NETWork APPLy command applies the network printer settings and makes the printer connection See Also Introduction to HARDcopy Commands on page 296 HARDcopy NETWork SLOT on pa...

Page 305: ...e domain name setting is a common setting for both network printer slots Query Syntax HARDcopy NETWork DOMain The HARDcopy NETWork DOMain query returns the current Windows network domain name Return F...

Page 306: ...HARDcopy NETWork PASSword command sets the password for the specified Windows network domain and user name The password setting is a common setting for both network printer slots See Also Introductio...

Page 307: ...ress and apply commands There are two network printer slots to choose from Query Syntax HARDcopy NETWork SLOT The HARDcopy NETWork SLOT query returns the currently selected network printer slot Return...

Page 308: ...Windows network domain The user name setting is a common setting for both network printer slots Query Syntax HARDcopy NETWork USERname The HARDcopy NETWork USERname query returns the currently set us...

Page 309: ...rint driver cannot print color images to color laser printers so the COLor option is not available when connected to laser printers Query Syntax HARDcopy PALette The HARDcopy PALette query returns the...

Page 310: ...ARDcopy PRINter LIST query returns a list of available printers The list can be empty Return Format list NL list printer_spec printer_spec printer_spec index active name index integer index of printer...

Page 311: ...Syntax HARDcopy STARt The HARDcopy STARt command starts a print job See Also Introduction to HARDcopy Commands on page 296 HARDcopy APRinter on page 298 HARDcopy PRINter LIST on page 310 HARDcopy FAC...

Page 312: ...312 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 17 HARDcopy Commands...

Page 313: ...ay and return data from the Lister display Table 68 LISTer Commands Summary Command Query Options and Query Returns n a LISTer DATA see page 314 binary_block comma separated data with newlines at the...

Page 314: ...page 790 Query Syntax LISTer DATA The LISTer DATA query returns the lister data Return Format binary block NL binary_block comma separated data with newlines at the end of each row See Also Introducti...

Page 315: ...in the Lister or whether the Lister is off ON or 1 is the same as SBUS1 When set to ALL the decode information for different buses is interleaved in time Serial bus decode must be on before it can be...

Page 316: ...EFerence command selects whether the time value for a Lister row is relative to the trigger ot the previous Lister row Query Syntax LISTer REFerence The LISTer REFerence query returns the Lister time...

Page 317: ...x s ms us ns ps Hz kHz MHz return_value X1 cursor position value in NR3 format MARKer X1Y1source source see page 321 MARKer X1Y1source see page 321 source CHANnel n FUNCtion MATH WMEMory r n 1 to anal...

Page 318: ...Y1 CHAN1 X2Y2 CHAN1 MODE MAN MARKer XUNits mode see page 325 MARKer XUNits see page 325 units SEConds HERTz DEGRees PERCent MARKer XUNits USE see page 326 n a n a MARKer Y1Position position suffix see...

Page 319: ...g the mode to MEASurement sets the marker sources MARKer X1Y1source and MARKer X2Y2source to the measurement source MEASure SOURce Setting the measurement source remotely always sets the marker source...

Page 320: ...Query Syntax MARKer X1Position The MARKer X1Position query returns the current X1 cursor position This is functionally equivalent to the obsolete MEASure TSTArt command query Return Format position NL...

Page 321: ...e pair of markers for example X1Y1 sets the source for the other for example X2Y2 If the marker mode is currently WAVeform the X1Y1 source can be set separate from the X2Y2 source If MARKer MODE is se...

Page 322: ...er XUNits command Query Syntax MARKer X2Position The MARKer X2Position query returns current X2 cursor position This is functionally equivalent to the obsolete MEASure TSTOp command query Return Forma...

Page 323: ...e pair of markers for example X2Y2 sets the source for the other for example X1Y1 If the marker mode is currently WAVeform the X2Y2 source can be set separate from the X1Y1 source If MARKer MODE is se...

Page 324: ...are set by the MARKer XUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 318 MARKer MODE on page 319 MARKer X1Position on page...

Page 325: ...360 degrees PERCent for making ratio measurements Use the MARKer XUNits USE command to set the current X1 location as 0 percent and the current X2 location as 100 percent Changing X units affects the...

Page 326: ...ARKer XUNits USE command sets the current X1 location as 0 percent and the current X2 location as 100 percent Once the 0 and 360 degree or 0 and 100 percent locations are set inputs to and outputs fro...

Page 327: ...ns cannot be set Query Syntax MARKer Y1Position The MARKer Y1Position query returns current Y1 cursor position This is functionally equivalent to the obsolete MEASure VSTArt command query Return Forma...

Page 328: ...ons cannot be set Query Syntax MARKer Y2Position The MARKer Y2Position query returns current Y2 cursor position This is functionally equivalent to the obsolete MEASure VSTOp command query Return Forma...

Page 329: ...MARKer YUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 318 MARKer MODE on page 319 MARKer X1Y1source on page 321 MARKer X2Y2...

Page 330: ...rrent Y1 location as 0 percent and the current Y2 location as 100 percent Changing Y units affects the input and output values of the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands que...

Page 331: ...d the current Y2 location as 100 percent Once the 0 and 100 percent locations are set inputs to and outputs from the MARKer Y1Position MARKer Y2Position and MARKer YDELta commands queries are relative...

Page 332: ...332 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 19 MARKer Commands...

Page 333: ...344 MEASure DEFine DELay see page 345 delay spec edge_spec1 edge_spec2 edge_spec1 slope occurrence edge_spec2 slope occurrence slope occurrence integer MEASure DEFine THResholds threshold spec see pa...

Page 334: ...0 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 chan...

Page 335: ...1 format r 1 2 in NR1 format return_value the percent of the overshoot of the selected waveform in NR3 format MEASure PERiod source see page 355 MEASure PERiod source see page 355 source CHANnel n FUN...

Page 336: ...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 form...

Page 337: ...format d 0 to digital channels 1 in NR1 format return_value source NONE n a MEASure TEDGe slope occurrence source see page 363 slope direction of the waveform occurrence the transition to be reported...

Page 338: ...page 367 MEASure VAMPlitude source see page 367 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...

Page 339: ...NR1 format return_value minimum voltage of the selected waveform in NR3 format MEASure VPP source see page 372 MEASure VPP source see page 372 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog c...

Page 340: ...or 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 MEASure VTOP source see page 375...

Page 341: ...not three edges the oscilloscope will revert to the mode of making the measurement at the start of the main sweep When the command form is used the measurement result is displayed on the instrument Wh...

Page 342: ...X Series Oscilloscopes Programmer s Guide 20 MEASure Commands MEASure ALL see page 790 Command Syntax MEASure ALL This command installs a Snapshot All measurement on the screen See Also Introduction t...

Page 343: ...ion 2000 X Series Oscilloscopes Programmer s Guide 343 MEASure CLEar see page 790 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Introd...

Page 344: ...entifies which measurement results that can be affected by redefining the DELay specification or the THResholds values For example changing the THResholds definition from the default 10 50 and 90 valu...

Page 345: ...middle and upper measurement thresholds to 10 50 and 90 values between Vbase and Vtop Threshold mode PERCent sets the measurement thresholds to any user defined percentages between 5 and 95 of values...

Page 346: ...er threshold percentage values between Vbase and Vtop in NR3 format for meas_spec THResholds and threshold mode ABSolute THR ABS upper middle lower NL upper middle lower A number specifying the upper...

Page 347: ...Also in the MEASure DEFine command you can set upper middle and lower threshold values It is the middle threshold value that is used when performing the delay query The standard upper middle and lower...

Page 348: ...delay measurement point nearer to Vtop or Vbase you must change the threshold values with the MEASure DEFine THResholds command Return Format value NL value floating point number delay time in seconds...

Page 349: ...re DUTYcycle source The MEASure DUTYcycle query measures and outputs the duty cycle of the signal specified by the MEASure SOURce command The value returned for the duty cycle is the ratio of the posi...

Page 350: ...modified Query Syntax MEASure FALLtime source The MEASure FALLtime query measures and outputs the fall time of the displayed falling negative going edge closest to the trigger reference The fall time...

Page 351: ...fied the current source is modified IF the edge on the screen closest to the trigger reference is rising THEN frequency 1 time at trailing rising edge time at leading rising edge ELSE frequency 1 time...

Page 352: ...rce parameter is not specified the current source is modified Query Syntax MEASure NWIDth source The MEASure NWIDth query measures and outputs the width of the negative pulse on the screen closest to...

Page 353: ...ax or Vmin depending on whether the edge is rising or falling For a rising edge overshoot Vmax Vtop Vtop Vbase x 100 For a falling edge overshoot Vbase Vmin Vtop Vbase x 100 Vtop and Vbase are taken f...

Page 354: ...354 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 20 MEASure Commands MEASure VTOP on page 375 MEASure VBASe on page 369 MEASure VMIN on page 371...

Page 355: ...od source The MEASure PERiod query measures and outputs the period of the cycle closest to the trigger reference on the screen The period is measured at the midpoint of the upper and lower thresholds...

Page 356: ...een the specified sources A phase measurement is a combination of the period and delay measurements First the period is measured on source1 Then the delay is measured between source1 and source2 The e...

Page 357: ...d either Vmin or Vmax depending on whether the edge is rising or falling For a rising edge preshoot Vmin Vbase Vtop Vbase x 100 For a falling edge preshoot Vmax Vtop Vtop Vbase x 100 Vtop and Vbase ar...

Page 358: ...is modified Query Syntax MEASure PWIDth source The MEASure PWIDth query measures and outputs the width of the displayed positive pulse closest to the trigger reference Pulse width is measured at the...

Page 359: ...e of the displayed rising positive going edge closest to the trigger reference For maximum measurement accuracy set the sweep speed as fast as possible while leaving the leading edge of the waveform o...

Page 360: ...mmand Syntax MEASure SHOW show show 1 ON The MEASure SHOW command enables markers for tracking measurements on the display This feature is always on Query Syntax MEASure SHOW The MEASure SHOW query re...

Page 361: ...new value If MARKer MODE is set to OFF or MANual setting MEASure SOURce to CHANnel n FUNCtion or MATH will also set MARKer X1Y1source to source1 and MARKer X2Y2source to source2 EXTernal is only a val...

Page 362: ...y for duty cycle varQueryResult myScope ReadNumber Read duty cycle MsgBox Duty cycle vbCrLf _ FormatNumber varQueryResult 3 myScope WriteString MEASURE RISETIME Query for risetime varQueryResult mySco...

Page 363: ...ope selects a rising or falling edge If no sign is specified for the slope it is assumed to be the rising edge The magnitude of occurrence defines the occurrence to be reported For example 3 returns t...

Page 364: ...1 on ch 2 dblChan2Edge1 myScope ReadNumber Calculate delay time between ch1 and ch2 dblDelay dblChan2Edge1 dblChan1Edge1 Write calculated delay time to screen MsgBox Delay vbCrLf CStr dblDelay Make a...

Page 365: ...d occurrence is returned as the response to the query The specified value can be negative or positive To specify a negative value use a minus sign The sign of the slope selects a rising or falling edg...

Page 366: ...Series Oscilloscopes Programmer s Guide 20 MEASure Commands value time in seconds of the specified value crossing in NR3 format See Also Introduction to MEASure Commands on page 340 MEASure TEDGe on p...

Page 367: ...e optional source parameter is specified the current source is modified Query Syntax MEASure VAMPlitude source The MEASure VAMPlitude query measures and returns the vertical amplitude of the waveform...

Page 368: ...tional source parameter is specified the current source is modified The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is...

Page 369: ...parameter is specified the current source is modified Query Syntax MEASure VBASe source The MEASure VBASe query returns the vertical value at the base of the waveform The base value of a pulse is norm...

Page 370: ...ent and starts a maximum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMAX source The MEASure VMAX query measures and ou...

Page 371: ...and starts a minimum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMIN source The MEASure VMIN query measures and output...

Page 372: ...e is modified Query Syntax MEASure VPP source The MEASure VPP query measures the maximum and minimum vertical value for the selected source then calculates the vertical peak to peak value and returns...

Page 373: ...ber of cycles or the full screen If interval is not specified DISPlay is implied The type option lets you choose between a DC RMS measurement and an AC RMS measurement If type is not specified DC is i...

Page 374: ...to digital channels 1 in NR1 format The MEASure VTIMe query returns the value at a specified time on the source specified with MEASure SOURce The specified time must be on the screen and is referenced...

Page 375: ...top value measurement Query Syntax MEASure VTOP source The MEASure VTOP query returns the vertical value at the top of the waveform The top value of the pulse is normally not the same as the maximum v...

Page 376: ...measurement window MAIN the measurement window is the upper Main window ZOOM the measurement window is the lower Zoom window AUTO the measurement is attempted in the lower Zoom window if it cannot be...

Page 377: ...els n 1 2 for 2ch models MTESt AMASk UNITs units see page 385 MTESt AMASk UNITs see page 385 units CURRent DIVisions MTESt AMASk XDELta value see page 386 MTESt AMASk XDELta see page 386 value X delta...

Page 378: ...CTion SAVE 0 OFF 1 ON see page 399 MTESt RMODe FACTion SAVE see page 399 0 1 MTESt RMODe FACTion STOP 0 OFF 1 ON see page 400 MTESt RMODe FACTion STOP see page 400 0 1 MTESt RMODe SIGMa level see page...

Page 379: ...0 Y2 3 00000E 00 BIND 0 MTES RMOD FOR RMOD TIME 1E 00 WAV 1000 SIGM 6 0E 00 MTES RMOD FACT STOP 0 PRIN 0 SAVE 0 Example Code Mask testing commands example Option Explicit Public myMgr As VisaComLib Re...

Page 380: ...Scope ReadNumber Debug Print Mask test termination test sigma _ FormatNumber varQueryResult Use auto mask to create mask myScope WriteString MTESt AMASk SOURce CHANnel1 myScope WriteString MTESt AMASk...

Page 381: ...or RUN bit stopped mask test termination lngElapsed 0 Do While lngElapsed lngTimeout myScope WriteString OPERegister CONDition varQueryResult myScope ReadNumber Operation Status Condition Register RUN...

Page 382: ...e MTESt ALL command specifies the channel s that are included in the mask test ON All displayed analog channels are included in the mask test OFF Just the selected source channel is included in the te...

Page 383: ...and MTESt AMASk UNITs commands The mask only encompasses the portion of the waveform visible on the display so you must ensure that the waveform is acquired and displayed consistently to obtain repea...

Page 384: ...hannel units as set by the CHANnel n UNITs command of the selected source Suppose that UNITs are CURRent and that you set SOURce to CHANNEL1 which is using units of volts Then you can define AMASk XDE...

Page 385: ...ubsystem uses the graticule as the measurement system so tolerance settings are specified as parts of a screen division The mask test subsystem maintains separate XDELta and YDELta settings for CURRen...

Page 386: ...ting for MTESt AMASk UNITs is CURRent and the current setting specifies time in the horizontal direction the tolerance will be 250 ms If the setting for MTESt AMASk UNITs is DIVisions the same X delta...

Page 387: ...r MTESt AMASk UNITs is CURRent and the current setting specifies voltage in the vertical direction the tolerance will be 250 mV If the setting for MTESt AMASk UNITs is DIVisions the same Y delta value...

Page 388: ...ent mask test run This count is for all regions and all waveforms collected on the channel specified by the optional parameter or collected on the currently specified source channel MTESt SOURce if th...

Page 389: ...Guide 389 MTESt COUNt RESet see page 790 Command Syntax MTESt COUNt RESet The MTESt COUNt RESet command resets the mask statistics See Also Introduction to MTESt Commands on page 379 MTESt COUNt WAVe...

Page 390: ...COUNt TIME The MTESt COUNt TIME query returns the elapsed time in the current mask test run Return Format time NL time elapsed seconds in NR3 format See Also Introduction to MTESt Commands on page 37...

Page 391: ...rms The MTESt COUNt WAVeforms query returns the total number of waveforms acquired in the current mask test run Return Format count NL count number of waveforms in NR1 format See Also Introduction to...

Page 392: ...d loads a mask from binary block data These are the data bytes found in a msk file Query Syntax MTESt DATA The MTESt DATA query returns a mask in binary block data format The format for the data trans...

Page 393: ...00 X Series Oscilloscopes Programmer s Guide 393 MTESt DELete see page 790 Command Syntax MTESt DELete The MTESt DELete command clears the currently loaded mask See Also Introduction to MTESt Commands...

Page 394: ...n_off on_off 1 ON 0 OFF The MTESt ENABle command enables or disables the mask test features ON Enables the mask test features OFF Disables the mask test features Query Syntax MTESt ENABle The MTESt EN...

Page 395: ...disables the mask lock feature ON Locks a mask to the SOURce As the vertical or horizontal scaling or position of the SOURce changes the mask is redrawn accordingly OFF The mask is static and does not...

Page 396: ...age 401 command TIME the mask test runs for a fixed amount of time The amount of time is set by the MTESt RMODe TIME on page 402 command WAVeforms the mask test runs until a fixed number of waveforms...

Page 397: ...tics run only on waveforms that contain a mask violation passing waveforms do not affect measurements and measurement statistics This mode is not available when the acquisition mode is set to Averagin...

Page 398: ...starting on page 295 for more information on setting the hardcopy device and formatting options Query Syntax MTESt RMODe FACTion PRINt The MTESt RMODe FACTion PRINt query returns the current mask fail...

Page 399: ...4 SAVE Commands starting on page 425 for more information on save options Query Syntax MTESt RMODe FACTion SAVE The MTESt RMODe FACTion SAVE query returns the current mask failure save setting Return...

Page 400: ...ilure on or off When this setting is ON and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RMODe FACTion STOP The MTESt RMODe FACTion ST...

Page 401: ...est sigma is the best achievable process sigma assuming no failures Process sigma is calculated using the number of failures per test The test sigma level indirectly specifies the number of waveforms...

Page 402: ...400 in NR3 format When the MTESt RMODe command is set to TIME the MTESt RMODe TIME command sets the number of seconds for a mask test to run Query Syntax MTESt RMODe TIME The MTESt RMODe TIME query re...

Page 403: ...00 000 When the MTESt RMODe command is set to WAVeforms the MTESt RMODe WAVeforms command sets the number of waveform acquisitions that are mask tested Query Syntax MTESt RMODe WAVeforms The MTESt RMO...

Page 404: ...nd the 0 Level controls track each other Adjusting either the 1 Level or the 0 Level control shifts the position of the mask up or down without changing its size OFF If the Bind 1 0 Levels control is...

Page 405: ...ms an X value of 0 100 is a vertex at 110 ms The oscilloscope uses this equation to normalize vertices This simplifies reprogramming to handle different data rates For example if you halve the period...

Page 406: ...it is best if you define XDELta as a pulse width or bit period Then a change in data rate without corresponding changes in the waveform can easily be handled by changing X The X coordinate of polygon...

Page 407: ...he boundaries set by SCALe Y1 and SCALe Y2 according to the equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y1 value is a voltage value...

Page 408: ...ries defined by SCALe Y1 and SCALe Y2 according to the following equation Y Y Y2 Y1 Y1 Thus if you set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV The Y2 value is a voltage...

Page 409: ...SOURce command selects the channel which is configured by the commands contained in a mask file when it is loaded Query Syntax MTESt SOURce The MTESt SOURce query returns the channel which is configur...

Page 410: ...Syntax MTESt TITLe The MTESt TITLe query returns the mask title which is a string of up to 128 characters The title is displayed in the mask test dialog box and mask test tab when a mask file is loade...

Page 411: ...stem Return Format The following is a sample response from the POD1 query In this case the query was issued following a RST command POD1 DISP 0 THR 1 40E 00 Table 72 POD n Commands Summary Command Que...

Page 412: ...command POD1 D0 D7 The POD n DISPlay command turns displaying of the specified group of channels on or off Query Syntax POD n DISPlay The POD n DISPlay query returns the current display setting of th...

Page 413: ...re affected by the command POD1 D0 D7 value SMALl MEDium LARGe The POD n SIZE command specifies the size of digital channels on the display Query Syntax POD n SIZE The POD n SIZE query returns the dig...

Page 414: ...Query Syntax POD n THReshold The POD n THReshold query returns the threshold value for the specified group of channels Return Format threshold NL threshold Floating point number in NR3 format See Als...

Page 415: ...iVision 2000 X Series Oscilloscopes Programmer s Guide 415 Set external channel to TTL threshold short form myScope WriteString TRIG LEV TTL EXT See complete example programs at Chapter 38 Programming...

Page 416: ...416 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 22 POD Commands...

Page 417: ...and Query Returns RECall FILename base_name see page 419 RECall FILename see page 419 base_name quoted ASCII string RECall MASK STARt file_spec see page 420 n a file_spec internal_loc file_name intern...

Page 418: ...Vision 2000 X Series Oscilloscopes Programmer s Guide 23 RECall Commands Return Format The following is a sample response from the RECall query In this case the query was issued following the RST comm...

Page 419: ...ame command specifies the source for any RECall operations Query Syntax RECall FILename The RECall FILename query returns the current RECall filename Return Format base_name NL base_name quoted ASCII...

Page 420: ...file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The RECall MASK STARt command recalls a mask See Also Introduction to RECall Commands on page 4...

Page 421: ...path_name quoted ASCII string The RECall PWD command sets the present working directory for recall operations Query Syntax RECall PWD The RECall PWD query returns the currently set working directory...

Page 422: ...pec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The RECall SETup STARt command recalls an oscilloscope setup See Also Introduction to RECal...

Page 423: ...RECall WMEMory r STARt file_name r 1 2 in NR1 format file_name quoted ASCII string The RECall WMEMory r STARt command recalls a reference waveform See Also Introduction to RECall Commands on page 417...

Page 424: ...424 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 23 RECall Commands...

Page 425: ...1 ON see page 430 SAVE IMAGe FACTors see page 430 0 1 SAVE IMAGe FORMat format see page 431 SAVE IMAGe FORMat see page 431 format TIFF BMP BMP24bit BMP8bit PNG NONE SAVE IMAGe INKSaver 0 OFF 1 ON see...

Page 426: ...440 format ASCiixy CSV BINary NONE SAVE WAVeform LENGth length see page 441 SAVE WAVeform LENGth see page 441 length 100 to max length an integer in NR1 format SAVE WAVeform LENGth MAX 0 OFF 1 ON see...

Page 427: ...up Use SAVE to query setup information for the SAVE subsystem Return Format The following is a sample response from the SAVE query In this case the query was issued following the RST command SAVE FIL...

Page 428: ...SAVE operations Query Syntax SAVE FILename The SAVE FILename query returns the current SAVE filename Return Format base_name NL base_name quoted ASCII string See Also Introduction to SAVE Commands on...

Page 429: ...NKSaver on page 432 SAVE IMAGe PALette on page 433 SAVE FILename on page 428 NOTE Be sure to set the SAVE IMAGe FORMat before saving an image If the format is NONE the save image command will not succ...

Page 430: ...th the image Query Syntax SAVE IMAGe FACTors The SAVE IMAGe FACTors query returns a flag indicating whether oscilloscope factors are output along with the image Return Format factors NL factors 0 1 Se...

Page 431: ...ype Query Syntax SAVE IMAGe FORMat The SAVE IMAGe FORMat query returns the selected image format type Return Format format NL format BMP BMP8 PNG NONE When NONE is returned it indicates that a wavefor...

Page 432: ...command controls whether the graticule colors are inverted or not Query Syntax SAVE IMAGe INKSaver The SAVE IMAGe INKSaver query returns a flag indicating whether graticule colors are inverted or not...

Page 433: ...scale The SAVE IMAGe PALette command sets the image palette color Query Syntax SAVE IMAGe PALette The SAVE IMAGe PALette query returns the selected image palette color Return Format palette NL palette...

Page 434: ...AVE LISTer STARt file_name file_name quoted ASCII string The SAVE LISTer STARt command saves the Lister display data to a file See Also Introduction to SAVE Commands on page 426 SAVE FILename on page...

Page 435: ...file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The SAVE MASK STARt command saves a mask See Also Introduction to SAVE Commands on page 426 SAV...

Page 436: ...le_name quoted ASCII string The SAVE MULTi STARt command saves multi channel waveform data to a file This file can be opened by the N8900A InfiniiView oscilloscope analysis software See Also Introduct...

Page 437: ...quoted ASCII string The SAVE PWD command sets the present working directory for save operations Query Syntax SAVE PWD The SAVE PWD query returns the currently set working directory for save operations...

Page 438: ...pec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The SAVE SETup STARt command saves an oscilloscope setup See Also Introduction to SAVE Comm...

Page 439: ...n page 426 SAVE WAVeform FORMat on page 440 SAVE WAVeform LENGth on page 441 SAVE FILename on page 428 RECall SETup STARt on page 422 NOTE Be sure to set the SAVE WAVeform FORMat before saving wavefor...

Page 440: ...information for all analog channels that are displayed turned on The proper file extension for this format is csv BINary creates an oscilloscope binary data format file See the User s Guide for a des...

Page 441: ...orm data length that is the number of points saved When the SAVE WAVeform LENGth MAX setting is ON the SAVE WAVeform LENGth setting has no effect Query Syntax SAVE WAVeform LENGth The SAVE WAVeform LE...

Page 442: ...X command specifies whether maximum number of waveform data points is saved When OFF the SAVE WAVeform LENGth command specifies the number of waveform data points saved Query Syntax SAVE WAVeform LENG...

Page 443: ...d specifies which segments are included when the waveform is saved ALL all acquired segments are saved CURRent only the currently selected segment is saved Query Syntax SAVE WAVeform SEGMented The SAV...

Page 444: ...saved as a reference waveform file Query Syntax SAVE WMEMory SOURce The SAVE WMEMory SOURce query returns the source to be saved as a reference waveform file Return Format source NL source CHAN n FUN...

Page 445: ...Mory STARt file_name file_name quoted ASCII string The SAVE WMEMory STARt command saves oscilloscope waveform data to a reference waveform file See Also Introduction to SAVE Commands on page 426 SAVE...

Page 446: ...446 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 24 SAVE Commands...

Page 447: ...triggering will trigger on CAN version 2 0A and 2 0B signals Setup consists of connecting the oscilloscope to a CAN signal Baud rate signal source and signal polarity and type of data to trigger on c...

Page 448: ...64 bits long UART RS 232 triggering with Option 232 lets you trigger on RS 232 serial data Reporting the Setup Use SBUS n to query setup information for the SBUS n subsystem Return Format The followin...

Page 449: ...ammer s Guide 449 General SBUS n Commands Table 75 General SBUS n Commands Summary Command Query Options and Query Returns SBUS n DISPlay 0 OFF 1 ON see page 450 SBUS n DISPlay see page 450 0 1 SBUS n...

Page 450: ...ry returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 753 See Also Introduction to SBUS n Commands on page 447 CHANne...

Page 451: ...n MODE The SBUS n MODE query returns the current serial bus decode mode setting Return Format mode NL mode CAN IIC LIN SPI UART NONE Errors 241 Hardware missing on page 753 See Also Introduction to SB...

Page 452: ...ating point in NR3 format SBUS n CAN SAMPlepo int value see page 459 SBUS n CAN SAMPlepo int see page 459 value 60 62 5 68 70 75 80 87 5 in NR3 format SBUS n CAN SIGNal B AUDrate baudrate see page 460...

Page 453: ...NGth length see page 466 SBUS n CAN TRIGger PATTern DATA LENGth see page 466 length integer from 1 to 8 in NR1 format SBUS n CAN TRIGger PATTern ID string see page 467 SBUS n CAN TRIGger PATTern ID se...

Page 454: ...age 790 Query Syntax SBUS n CAN COUNt ERRor Returns the error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CAN COU...

Page 455: ...ge 790 Query Syntax SBUS n CAN COUNt OVERload Returns the overload frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CA...

Page 456: ...US n CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 753 See Also SBUS n CAN COUNt ERRor on page 454 SBUS n CAN COUNt OVERload on page 455 SBUS n CAN COUNt TOTal on page...

Page 457: ...age 790 Query Syntax SBUS n CAN COUNt TOTal Returns the total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n CAN COU...

Page 458: ...ge 790 Query Syntax SBUS n CAN COUNt UTILization Returns the percent utilization Return Format percent NL percent floating point in NR3 format Errors 241 Hardware missing on page 753 See Also SBUS n C...

Page 459: ...me where the bit level is sampled to determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit t...

Page 460: ...set to the nearest baud rate divisible by 100 b s You can also set the baud rate of the CAN signal to 5 Mb s Fractional baud rates between 4 Mb s and 5 Mb s are not allowed If the baud rate you selec...

Page 461: ...nant low signals CANL the actual CAN_L differential bus signal RX the Receive signal from the CAN bus transceiver TX the Transmit signal to the CAN bus transceiver DIFL the CAN differential L H bus si...

Page 462: ...r the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n CAN SOURce command sets the source for the CAN signal Query Syntax SBUS n CAN SOURce The SBUS n...

Page 463: ...l trigger on the specified Id regardless if it is a Remote frame or a Data frame IDRemote will trigger on CAN frames matching the specified Id of a Remote frame ALLerrors will trigger on CAN active er...

Page 464: ...mmand Query Syntax SBUS n CAN TRIGger The SBUS n CAN TRIGger query returns the current CAN trigger on condition Return Format condition NL condition SOF DATA ERR IDD IDE IDR ALL OVER ACK Errors 241 Ha...

Page 465: ...X don t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern DATA The SBUS n CAN TRIGger PATTern DATA query returns the cu...

Page 466: ...ng The number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n CAN TRIGger PATTern DATA command Query Syntax SBUS n CAN TRIGger PAT...

Page 467: ...made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care characters Query Syntax SBUS n CAN TRIGger PATTern ID The SBUS n CAN TRIGger PATTern...

Page 468: ...selects the extended 29 bit identifier The CAN identifier is set by the SBUS n CAN TRIGger PATTern ID command Query Syntax SBUS n CAN TRIGger PATTern ID MODE The SBUS n CAN TRIGger PATTern ID MODE qu...

Page 469: ...e 472 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format SBUS n IIC TRIGger PATTern ADDRess...

Page 470: ...e command determines whether the Read Write bit is included as the LSB in the display of the IIC address field of the decode bus Query Syntax SBUS n IIC ASIZe The SBUS n IIC ASIZe query returns the cu...

Page 471: ...ANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n IIC SOURce CLOCk command sets the source for the IIC serial clock SCL Query...

Page 472: ...e CHANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n IIC SOURce DATA command sets the source for IIC serial data SDA Query S...

Page 473: ...ss for IIC data The address can range from 0x00 to 0x7F 7 bit or 0x3FF 10 bit hexadecimal Use the don t care address 1 or 0xFFFFFFFF to ignore the address value Query Syntax SBUS n IIC TRIGger PATTern...

Page 474: ...mand sets IIC data The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATA The SBU...

Page 475: ...mand sets IIC data 2 The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax SBUS n IIC TRIGger PATTern DATa2 The...

Page 476: ...The SBUS n IIC TRIGger QUALifier command sets the IIC data qualifier when TRIGger IIC TRIGger TYPE is set to READEprom Query Syntax SBUS n IIC TRIGger QUALifier The SBUS n IIC TRIGger QUALifier query...

Page 477: ...g Start Address7 Write Ack Data The value WRITe is also accepted for WRITe7 W7Data2 7 bit address frame containing Start Address7 Write Ack Data Ack Data2 WRITe10 10 bit address frame containing Start...

Page 478: ...mer s Guide 25 SBUS n Commands SBUS n IIC TRIGger PATTern ADDRess on page 473 SBUS n IIC TRIGger PATTern DATA on page 474 SBUS n IIC TRIGger PATTern DATa2 on page 475 SBUS n IIC TRIGger QUALifier on p...

Page 479: ...25000 in 100 b s increments SBUS n LIN SOURce source see page 484 SBUS n LIN SOURce see page 484 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channe...

Page 480: ...mal string nn n where n 0 1 X when base BINary string 0xnn n where n 0 9 A F X when base HEX SBUS n LIN TRIGger PATTern DATA LENGth length see page 491 SBUS n LIN TRIGger PATTern DATA LENGth see page...

Page 481: ...hether the parity bits are included as the most significant bits MSB in the display of the Frame Id field in the LIN decode bus Query Syntax SBUS n LIN PARity The SBUS n LIN PARity query returns the c...

Page 482: ...d to determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time Query Syntax SBUS n LIN SAMP...

Page 483: ...ignal from 2400 b s to 625 kb s in 100 b s increments If you enter a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s Query Syntax SBUS n L...

Page 484: ...ANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n LIN SOURce command sets the source for the LIN signal Query Syntax SBUS n L...

Page 485: ...3 LIN20 The SBUS n LIN STANdard command sets the LIN standard in effect for triggering and decoding to be LIN1 3 or LIN2 0 Query Syntax SBUS n LIN STANdard The SBUS n LIN STANdard query returns the cu...

Page 486: ...to be greater than or equal to 11 12 or 13 clock lengths The sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previo...

Page 487: ...IGger ID command to specify the frame ID Use the SBUS n LIN TRIGger PATTern DATA LENGth and SBUS n LIN TRIGger PATTern DATA commands to specify the data string length and value Query Syntax SBUS n LIN...

Page 488: ...exadecimal The SBUS n LIN TRIGger ID command defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID Setting the ID to a value of 1 results in 0xXX whi...

Page 489: ...lue is used When base DECimal the X and characters cannot be entered When queried the character is returned when any bits in the pattern have the value of X and base DECimal When any bits in a given n...

Page 490: ...es Oscilloscopes Programmer s Guide 25 SBUS n Commands See Also Introduction to TRIGger Commands on page 589 SBUS n LIN TRIGger PATTern FORMat on page 492 SBUS n LIN TRIGger on page 487 SBUS n LIN TRI...

Page 491: ...ng The number of bytes in the string can be anywhere from 1 bytes to 8 bytes 64 bits The value for these bytes is set by the SBUS n LIN TRIGger PATTern DATA command Query Syntax SBUS n LIN TRIGger PAT...

Page 492: ...mand sets the entry and query number base used by the SBUS n LIN TRIGger PATTern DATA command The default base is BINary Query Syntax SBUS n LIN TRIGger PATTern FORMat The SBUS n LIN TRIGger PATTern F...

Page 493: ...FRAMing value see page 498 SBUS n SPI FRAMing see page 498 value CHIPselect NCHipselect NOTC TIMeout SBUS n SPI SOURce C LOCk source see page 499 SBUS n SPI SOURce C LOCk see page 499 value CHANnel n...

Page 494: ...n MISO WIDTh width see page 504 SBUS n SPI TRIGger PATTern MISO WIDTh see page 504 width integer from 4 to 64 in NR1 format SBUS n SPI TRIGger PATTern MOSI DATA string see page 505 SBUS n SPI TRIGger...

Page 495: ...order most significant bit first MSB or least significant bit first LSB used when displaying data in the serial decode waveform and in the Lister Query Syntax SBUS n SPI BITorder The SBUS n SPI BITor...

Page 496: ...I CLOCk SLOPe command specifies the rising edge POSitive or falling edge NEGative of the SPI clock source that will clock in the data Query Syntax SBUS n SPI CLOCk SLOPe The SBUS n SPI CLOCk SLOPe que...

Page 497: ...ut resource in seconds from 100 ns to 10 s when the SBUS n SPI FRAMing command is set to TIMeout The timer is used to frame a signal by a clock timeout Query Syntax SBUS n SPI CLOCk TIMeout The SBUS n...

Page 498: ...framing value If TIMeout is selected the timeout value is set by the SBUS n SPI CLOCk TIMeout command Query Syntax SBUS n SPI FRAMing The SBUS n SPI FRAMing query returns the current SPI framing value...

Page 499: ...mat d 0 to digital channels 1 in NR1 format The SBUS n SPI SOURce CLOCk command sets the source for the SPI serial clock Query Syntax SBUS n SPI SOURce CLOCk The SBUS n SPI SOURce CLOCk query returns...

Page 500: ...d 0 to digital channels 1 in NR1 format The SBUS n SPI SOURce FRAMe command sets the frame source when SBUS n SPI FRAMing is set to CHIPselect or NOTChipselect Query Syntax SBUS n SPI SOURce FRAMe The...

Page 501: ...ISO command sets the source for the SPI serial MISO data Query Syntax SBUS n SPI SOURce MISO The SBUS n SPI SOURce MISO query returns the current source for the SPI serial MISO data Return Format sour...

Page 502: ...MOSI data You can also use the equivalent SBUS n SPI SOURce DATA command to set the MOSI data source Query Syntax SBUS n SPI SOURce MOSI The SBUS n SPI SOURce MOSI query returns the current source fo...

Page 503: ...ta stream If the string parameter starts with 0x it is a hexadecimal string made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care character...

Page 504: ...the SPI data pattern anywhere from 4 bits to 64 bits Query Syntax SBUS n SPI TRIGger PATTern MISO WIDTh The SBUS n SPI TRIGger PATTern MISO WIDTh query returns the current SPI data pattern width sett...

Page 505: ...ta stream If the string parameter starts with 0x it is a hexadecimal string made up of hexadecimal and X don t care characters otherwise it is a binary string made up of 0 1 and X don t care character...

Page 506: ...the SPI data pattern anywhere from 4 bits to 64 bits Query Syntax SBUS n SPI TRIGger PATTern MOSI WIDTh The SBUS n SPI TRIGger PATTern MOSI WIDTh query returns the current SPI data pattern width sett...

Page 507: ...When triggering on MISO data the data value is specified by the SBUS n SPI TRIGger PATTern MISO DATA and SBUS n SPI TRIGger PATTern MISO WIDTh commands Query Syntax SBUS n SPI TRIGger TYPE The SBUS n...

Page 508: ...t The SBUS n SPI WIDTh command determines the number of bits in a word of data for SPI Query Syntax SBUS n SPI WIDTh The SBUS n SPI WIDTh query returns the current SPI decode word width Return Format...

Page 509: ...BUS n UART BITorde r see page 514 bitorder LSBFirst MSBFirst n a SBUS n UART COUNt E RRor see page 515 frame_count integer in NR1 format SBUS n UART COUNt R ESet see page 516 n a n a n a SBUS n UART C...

Page 510: ...e 524 base ASCii HEX SBUS n UART TRIGger BURSt value see page 525 SBUS n UART TRIGger BURSt see page 525 value OFF 1 to 4096 in NR1 format SBUS n UART TRIGger DATA value see page 526 SBUS n UART TRIGg...

Page 511: ...TYPE value see page 529 SBUS n UART TRIGger TYPE see page 529 value RSTArt RSTOp RDATa RD1 RD0 RDX PARityerror TSTArt TSTOp TDATa TD1 TD0 TDX SBUS n UART WIDTh width see page 530 SBUS n UART WIDTh see...

Page 512: ...X The SBUS n UART BASE command determines the base to use for the UART decode and Lister display Query Syntax SBUS n UART BASE The SBUS n UART BASE query returns the current UART decode and Lister bas...

Page 513: ...he serial decoder and or trigger when in UART mode The baud rate can be set from 100 b s to 8 Mb s If the baud rate you select does not match the system baud rate false triggers may occur Query Syntax...

Page 514: ...ial decoder and or trigger when in UART mode LSBFirst sets the least significant bit of each message byte as transmitted first MSBFirst sets the most significant bit as transmitted first Query Syntax...

Page 515: ...790 Query Syntax SBUS n UART COUNt ERRor Returns the UART error frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UART...

Page 516: ...mmand Syntax SBUS n UART COUNt RESet Resets the UART frame counters Errors 241 Hardware missing on page 753 See Also SBUS n UART COUNt ERRor on page 515 SBUS n UART COUNt RXFRames on page 517 SBUS n U...

Page 517: ...e 790 Query Syntax SBUS n UART COUNt RXFRames Returns the UART Rx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UAR...

Page 518: ...e 790 Query Syntax SBUS n UART COUNt TXFRames Returns the UART Tx frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 753 See Also SBUS n UAR...

Page 519: ...mal nondecimal Bnn n where n 0 1 for binary The SBUS n UART FRAMing command determines the byte value to use for framing end of packet or to turn off framing for UART decode Query Syntax SBUS n UART F...

Page 520: ...n UART PARity command selects the parity to be used with each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART PARity The SBUS n UART PARity query returns...

Page 521: ...US n UART POLarity command selects the polarity as idle low or idle high for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART POLarity The SBUS n UART POLarity query return...

Page 522: ...ls in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n UART SOURce RX command controls which signal is used as the Rx source by the serial decoder and or trigger when in UART mode Query S...

Page 523: ...ls in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n UART SOURce TX command controls which signal is used as the Tx source by the serial decoder and or trigger when in UART mode Query S...

Page 524: ...ion is from hexadecimal values The SBUS n UART TRIGger BASE setting does not affect the SBUS n UART TRIGger DATA command which can always set data values using ASCII or hexadecimal values Query Syntax...

Page 525: ...nd selects the burst value Nth frame after idle period in the range 1 to 4096 or OFF for the trigger when in UART mode Query Syntax SBUS n UART TRIGger BURSt The SBUS n UART TRIGger BURSt query return...

Page 526: ...ta value is used when one of the RD or TD trigger types is selected When entering an ASCII character via the quoted string it must be one of the 128 valid characters case sensitive NUL SOH STX ETX EOT...

Page 527: ...mand selects the value of the idle period for burst trigger in the range from 1 us to 10 s when in UART mode Query Syntax SBUS n UART TRIGger IDLE The SBUS n UART TRIGger IDLE query returns the curren...

Page 528: ...UART TRIGger QUALifier command selects the data qualifier when TYPE is set to RDATa RD1 RD0 RDX TDATa TD1 TD0 or TDX for the trigger when in UART mode Query Syntax SBUS n UART TRIGger QUALifier The SB...

Page 529: ...TRIGger QUALifier commands are used to specify the data value and comparison operator The RD1 RD0 RDX TD1 TD0 and TDX types for triggering on data and alert bit values are only valid when a 9 bit widt...

Page 530: ...n UART WIDTh command determines the number of bits 5 9 for each message byte for the serial decoder and or trigger when in UART mode Query Syntax SBUS n UART WIDTh The SBUS n UART WIDTh query returns...

Page 531: ...rol the event search modes and parameters for each search type See General SEARch Commands on page 532 SEARch SERial CAN Commands on page 536 SEARch SERial IIC Commands on page 542 SEARch SERial LIN C...

Page 532: ...SEARch Commands Table 81 General SEARch Commands Summary Command Query Options and Query Returns n a SEARch COUNt see page 533 count an integer count value SEARch MODE value see page 534 SEARch MODE s...

Page 533: ...illoscopes Programmer s Guide 533 SEARch COUNt see page 790 Query Syntax SEARch COUNt The SEARch COUNt query returns the number of search events found Return Format count NL count an integer count val...

Page 534: ...alue SERial1 The SEARch MODE command selects the search mode The command is only valid when the SEARch STATe is ON Query Syntax SEARch MODE The SEARch MODE query returns the currently selected mode or...

Page 535: ...90 Command Syntax SEARch STATe value value 0 OFF 1 ON The SEARch STATe command enables or disables the search feature Query Syntax SEARch STATe The SEARch STATe query returns returns the current setti...

Page 536: ...ial CAN PA TTern DATA string see page 538 SEARch SERial CAN PA TTern DATA see page 538 string 0xnn n where n 0 9 A F X for hexadecimal SEARch SERial CAN PA TTern DATA LENGth length see page 539 SEARch...

Page 537: ...tching the specified ID of a Data frame IDEither searches for the specified ID regardless if it is a Remote frame or a Data frame IDRemote searches for CAN frames matching the specified ID of a Remote...

Page 538: ...he data value when searching for Data Frame ID and Data The length of the data value is specified using the SEARch SERial CAN PATTern DATA LENGth command Query Syntax SEARch SERial CAN PATTern DATA Th...

Page 539: ...pecifies the length of the data value when searching for Data Frame ID and Data The data value is specified using the SEARch SERial CAN PATTern DATA command Query Syntax SEARch SERial CAN PATTern DATA...

Page 540: ...ID value when searching for a CAN event The value can be a standard ID or an extended ID depending on the SEARch SERial CAN PATTern ID MODE command s setting Query Syntax SEARch SERial CAN PATTern ID...

Page 541: ...specifies whether a standard ID value or an extended ID value is used when searching for a CAN event The ID value is specified using the SEARch SERial CAN PATTern ID command Query Syntax SEARch SERia...

Page 542: ...h SERial IIC PA TTern ADDRess value see page 545 SEARch SERial IIC PA TTern ADDRess see page 545 value integer or string string 0xnn n 0 9 A F SEARch SERial IIC PA TTern DATA value see page 546 SEARch...

Page 543: ...frames containing Start Address7 Read Ack Data Ack Data2 W7Data2 searches for 7 bit address frames containing Start Address7 Write Ack Data Ack Data2 RESTart searches for another start condition occu...

Page 544: ...Series Oscilloscopes Programmer s Guide 26 SEARch Commands SEARch SERial IIC PATTern ADDRess on page 545 SEARch SERial IIC PATTern DATA on page 546 SEARch SERial IIC PATTern DATA2 on page 547 SEARch...

Page 545: ...ng 0xnn n 0 9 A F The SEARch SERial IIC PATTern ADDRess command specifies address values when searching for IIC events To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern...

Page 546: ...IC events To set don t care values use the integer 1 When searching for IIC EEPROM data read events you specify the data value qualifier using the SEARch SERial IIC QUALifier command Query Syntax SEAR...

Page 547: ...IC PATTern DATA2 command specifies the second data value when searching for IIC events with two data values To set don t care values use the integer 1 Query Syntax SEARch SERial IIC PATTern DATA2 The...

Page 548: ...ARch SERial IIC QUALifier command specifies the data value qualifier used when searching for IIC EEPROM data read events Query Syntax SEARch SERial IIC QUALifier The SEARch SERial IIC QUALifier query...

Page 549: ...hexadecimal SEARch SERial LIN MO DE value see page 551 SEARch SERial LIN MO DE see page 551 value ID DATA ERRor SEARch SERial LIN PA TTern DATA string see page 552 SEARch SERial LIN PA TTern DATA see...

Page 550: ...where n 0 9 A F for hexadecimal nondecimal Bnn n where n 0 1 for binary string 0xnn where n 0 9 A F for hexadecimal The SEARch SERial LIN ID command specifies the frame ID value when searching for LI...

Page 551: ...ches for a frame ID DATA searches for a frame ID and data ERRor searches for errors Frame IDs are specified using the SEARch SERial LIN ID command Data values are specified using the SEARch SERial LIN...

Page 552: ...Rial LIN PATTern FORMat command To set don t care values with the DATA command the FORMat must be HEX The length of the data value entered is specified using the SEARch SERial LIN PATTern DATA LENGth...

Page 553: ...TA LENGth command specifies the the length of the data value when searching for LIN events The data value is specified using the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN P...

Page 554: ...X DECimal The SEARch SERial LIN PATTern FORMat command specifies the number base used with the SEARch SERial LIN PATTern DATA command Query Syntax SEARch SERial LIN PATTern FORMat The SEARch SERial LI...

Page 555: ...Options and Query Returns SEARch SERial SPI MO DE value see page 556 SEARch SERial SPI MO DE see page 556 value MOSI MISO SEARch SERial SPI PA TTern DATA string see page 557 SEARch SERial SPI PA TTer...

Page 556: ...DE command specifies whether the SPI search will be on the MOSI data or the MISO data Data values are specified using the SEARch SERial SPI PATTern DATA command Query Syntax SEARch SERial SPI MODE The...

Page 557: ...TTern DATA command specifies the data value when searching for SPI events The width of the data value is specified using the SEARch SERial SPI PATTern WIDTh command Query Syntax SEARch SERial SPI PATT...

Page 558: ...n WIDTh command specifies the width of the data value in bytes when searching for SPI events The data value is specified using the SEARch SERial SPI PATTern DATA command Query Syntax SEARch SERial SPI...

Page 559: ...255 0x00 0xff in decimal hexadecimal binary or quoted_string format hexadecimal Hnn where n 0 9 A F for hexadecimal binary Bnn n where n 0 1 for binary quoted_string any of the 128 valid 7 bit ASCII...

Page 560: ...f the 128 valid 7 bit ASCII characters or standard abbreviations The SEARch SERial UART DATA command specifies a data value when searching for UART RS232 events The data value qualifier is specified u...

Page 561: ...is a don t care X TDATa searches for a transmit data value when data words are from 5 to 8 bits long TD1 searches for a transmit data value when data words are 9 bits long and the 9th alert bit is 1 T...

Page 562: ...GREaterthan LESSthan The SEARch SERial UART QUALifier command specifies the data value qualifier when searching for UART RS232 events Query Syntax SEARch SERial UART QUALifier The SEARch SERial UART...

Page 563: ...ring see page 566 n a string up to 75 characters as a quoted ASCII string n a SYSTem ERRor see page 567 error an integer error code error string quoted ASCII string See Error Messages see page 751 SYS...

Page 564: ...lloscopes Programmer s Guide 27 SYSTem Commands Introduction to SYSTem Commands SYSTem subsystem commands enable writing messages to the display setting and reading both the time and the date querying...

Page 565: ...NR1 format month 1 12 JANuary FEBruary MARch APRil MAY JUNe JULy AUGust SEPtember OCTober NOVember DECember day 1 31 The SYSTem DATE command sets the date Validity checking is performed to ensure that...

Page 566: ...characters The SYSTem DSP command writes the quoted string excluding quotation marks to a text box in the center of the display Use SYStem DSP to remotely remove the message from the display Two sets...

Page 567: ...edly sending the SYSTem ERRor query returns the errors in the order that they occurred until the queue is empty Any further queries then return zero until another error occurs Return Format error numb...

Page 568: ...K value value 1 ON 0 OFF The SYSTem LOCK command disables the front panel LOCK ON is the equivalent of sending a local lockout message over the programming interface Query Syntax SYSTem LOCK The SYSTe...

Page 569: ...lent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 569 SYSTem MENU see page 790 Command Syntax SYSTem MENU menu menu MASK MEASure SEGMented LISTer The SYSTem MENU command changes the fr...

Page 570: ...ault Setup on the front panel When you perform a default setup some user settings like preferences remain unchanged To reset all user settings to their factory defaults use the RST command Reset condi...

Page 571: ...ld TTL 1 4 V Display Menu Persistence Off Grid 20 Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time division 100 us Main time base delay 0 00 s Delay time division...

Page 572: ...mer s Guide 27 SYSTem Commands See Also Introduction to Common Commands on page 123 RST Reset on page 136 HF Reject and noise reject Off Holdoff 40 ns External probe attenuation 10 1 External Units Vo...

Page 573: ...Tem PROTection LOCK value value 1 ON 0 OFF The SYSTem PROTection LOCK command disables the fifty ohm impedance setting for all analog channels Query Syntax SYSTem PROTection LOCK The SYSTem PROTection...

Page 574: ...2 format See Also Introduction to SYSTem Commands on page 564 LRN Learn Device Setup on page 131 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the curr...

Page 575: ...loscopes Programmer s Guide 575 Write setup string back to oscilloscope using SYSTEM SETUP command myScope WriteIEEEBlock SYSTEM SETUP varSetupString CheckForInstrumentErrors See complete example prog...

Page 576: ...t The SYSTem TIME command sets the system time using a 24 hour format Commas are used as separators Validity checking is performed to ensure that the time is valid Query Syntax SYSTem TIME time The SY...

Page 577: ...nds in NR3 format TIMebase REFerence LEFT CENTer RIGHt see page 582 TIMebase REFerence see page 582 return_value LEFT CENTer RIGHt TIMebase SCALe scale_value see page 583 TIMebase SCALe see page 583 s...

Page 578: ...el 1 becomes the X input and channel 2 becomes the Y input The time per division delay vernier control and reference can be controlled for the main and window zoomed time bases Reporting the Setup Use...

Page 579: ...Ference commands are not available No measurements are available in this mode ROLL In the ROLL mode data moves continuously across the display from left to right The oscilloscope runs continuously and...

Page 580: ...enter and is set with the TIMebase REFerence command The maximum position value depends on the time division settings Query Syntax TIMebase POSition The TIMebase POSition query returns the current tim...

Page 581: ...RANGe The TIMebase RANGe query returns the current full scale range value for the main window Return Format range_value NL range_value time for 10 div in seconds in NR3 format See Also Introduction to...

Page 582: ...ry Syntax TIMebase REFerence The TIMebase REFerence query returns the current display reference for the main window Return Format reference NL reference LEFT CENT RIGH See Also Introduction to TIMebas...

Page 583: ...d sets the horizontal scale or units per division for the main window Query Syntax TIMebase SCALe The TIMebase SCALe query returns the current horizontal scale setting in seconds per division for the...

Page 584: ...value 1 ON 0 OFF The TIMebase VERNier command specifies whether the time base control s vernier fine horizontal adjustment setting is ON 1 or OFF 0 Query Syntax TIMebase VERNier The TIMebase VERNier q...

Page 585: ...range and the main sweep horizontal position determine the range for this command The value for this command must keep the zoomed view window within the main sweep range Query Syntax TIMebase WINDow P...

Page 586: ...delayed window The range is 10 times the current zoomed view window seconds per division setting The main sweep range determines the range for this command The maximum value is one half of the TIMeba...

Page 587: ...conds division The main sweep scale determines the range for this command The maximum value is one half of the TIMebase SCALe value Query Syntax TIMebase WINDow SCALe The TIMebase WINDow SCALe query r...

Page 588: ...588 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 28 TIMebase Commands...

Page 589: ...ger SWEep on page 600 can be AUTO or NORMal NORMal mode displays a waveform only if a trigger signal is present and the trigger conditions are met Otherwise the oscilloscope does not trigger and the d...

Page 590: ...horizontal interval of the waveform and produces triggers based on the TV trigger settings you selected TV triggering requires greater than division of sync amplitude with any analog channel as the tr...

Page 591: ...ource see page 596 TRIGger LEVel HIGH source see page 596 level 75 x full scale voltage from center screen in NR3 format source CHANnel n n 1 to analog channels in NR1 format TRIGger LEVel LOW level s...

Page 592: ...ds TRIGger FORCe see page 790 Command Syntax TRIGger FORCe The TRIGger FORCe command causes an acquisition to be captured even though the trigger condition has not been met This command is equivalent...

Page 593: ...equency reject filter adds a 50 kHz low pass filter in the trigger path to remove high frequency components from the trigger waveform Use this filter to remove high frequency noise such as AM or FM br...

Page 594: ...le when a waveform crosses the trigger level multiple times during one period of the waveform Without holdoff the oscilloscope could trigger on each of the crossings producing a confusing waveform Wit...

Page 595: ...Tup The TRIGger LEVel ASETup command automatically sets the trigger levels of all displayed analog channels to their waveforms 50 values If AC coupling is used the trigger levels are set to 0 V When H...

Page 596: ...nternal triggers source CHANnel n n 1 to analog channels in NR1 format The TRIGger LEVel HIGH command sets the high trigger voltage level voltage for the specified source Query Syntax TRIGger LEVel HI...

Page 597: ...internal triggers source CHANnel n n 1 to analog channels in NR1 format The TRIGger LEVel LOW command sets the low trigger voltage level voltage for the specified source Query Syntax TRIGger LEVel LO...

Page 598: ...TRIGger MODE The TRIGger MODE query returns the current trigger mode If the TIMebase MODE is ROLL or XY the query returns NONE Return Format mode NL mode EDGE GLIT PATT TV See Also Introduction to TRI...

Page 599: ...ise reject filter off and on When the noise reject filter is on the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger the oscilloscope This command i...

Page 600: ...resent but the oscilloscope is not triggered the unsynchronized signal is displayed instead of a baseline When NORMal sweep mode is selected and no trigger is present the instrument does not sweep and...

Page 601: ...R3 format For digital channels MSO models level 8 V 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 chan...

Page 602: ...et voltage from the trigger waveform Use AC coupling to get a stable edge trigger when your waveform has a large dc offset LFReject coupling places a 50 KHz high pass filter in the trigger path DC cou...

Page 603: ...or the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger EDGE LEVel command sets the trigger level voltage for the active trigger source Query Syntax...

Page 604: ...cy noise such as AM or FM broadcast stations from the trigger path The low frequency reject filter adds a 50 kHz high pass filter in series with the trigger waveform to remove any unwanted low frequen...

Page 605: ...TRIGger TV POLarity to set the polarity in TV trigger mode Query Syntax TRIGger EDGE SLOPe The TRIGger EDGE SLOPe query returns the current trigger slope Return Format slope NL slope NEG POS EITH ALT...

Page 606: ...ignal WGEN triggers at the 50 level of the rising edge of the waveform generator output signal This option is not available when the DC or NOISe waveforms are selected Query Syntax TRIGger EDGE SOURce...

Page 607: ...in NR3 format suffix s ms us ns ps TRIGger GLITch LEVel level source see page 611 TRIGger GLITch LEVel see page 611 For internal triggers level 75 x full scale voltage from center screen in NR3 forma...

Page 608: ...e 614 less_than_time 15 ns to 10 seconds in NR3 format greater_than_time 10 ns to 9 99 seconds in NR3 format suffix s ms us ns ps TRIGger GLITch SOURc e source see page 615 TRIGger GLITch SOURc e see...

Page 609: ...ITch GREaterthan command sets the minimum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch GREaterthan The TRIGger GLITch GREaterthan query returns the minimum p...

Page 610: ...er GLITch LESSthan command sets the maximum pulse width duration for the selected TRIGger GLITch SOURce Query Syntax TRIGger GLITch LESSthan The TRIGger GLITch LESSthan query returns the pulse width d...

Page 611: ...source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger GLITch LEVel command sets t...

Page 612: ...ty POSitive NEGative The TRIGger GLITch POLarity command sets the polarity for the glitch pulse width trigger Query Syntax TRIGger GLITch POLarity The TRIGger GLITch POLarity query returns the glitch...

Page 613: ...ation of the glitch pulse width trigger The oscilloscope can trigger on a pulse width that is greater than a time value less than a time value or within a range of time values Query Syntax TRIGger GLI...

Page 614: ...ANGe command sets the pulse width duration for the selected TRIGger GLITch SOURce You can enter the parameters in any order the smaller value becomes the greater_than_time and the larger value becomes...

Page 615: ...e command selects the channel that produces the pulse width trigger Query Syntax TRIGger GLITch SOURce The TRIGger GLITch SOURce query returns the current pulse width source If all channels are off th...

Page 616: ...ring nn n where n 0 1 X R F when base ASCii string 0xnn n where n 0 9 A F X when base HEX edge_source CHANnel n NONE for DSO models edge_source CHANnel n DIGital d NONE for MSO models n 1 to analog ch...

Page 617: ...s on the TRIGger PATTern FORMat command setting When the format is ASCii the string looks just like the string you see on the oscilloscope s front panel made up of 0 1 X don t care R rising edge and F...

Page 618: ...uery returns the pattern string edge source and edge Return Format string edge_source edge NL See Also Introduction to TRIGger Commands on page 589 TRIGger PATTern FORMat on page 619 TRIGger PATTern Q...

Page 619: ...The TRIGger PATTern FORMat command sets the entry and query number base used by the TRIGger PATTern command The default base is ASCii Query Syntax TRIGger PATTern FORMat The TRIGger PATTern FORMat qu...

Page 620: ...alifier ENTered The TRIGger PATTern QUALifier command qualifies when the trigger occurs In the InfiniiVision 2000 X Series oscilloscopes the trigger always occurs when the pattern is entered Query Syn...

Page 621: ...ger in NR1 format TRIGger TV MODE tv mode see page 623 TRIGger TV MODE see page 623 tv mode FIEld1 FIEld2 AFIelds ALINes LFIeld1 LFIeld2 LALTernate TRIGger TV POLarity polarity see page 624 TRIGger TV...

Page 622: ...shown in the following table Query Syntax TRIGger TV LINE The TRIGger TV LINE query returns the current TV trigger line number setting Return Format line_number NL line_number integer in NR1 format S...

Page 623: ...gger mode and field Old forms for mode are accepted Query Syntax TRIGger TV MODE The TRIGger TV MODE query returns the TV trigger mode Return Format value NL value FIE1 FIE2 AFI ALIN LFI1 LFI2 LALT Se...

Page 624: ...rity polarity polarity POSitive NEGative The TRIGger TV POLarity command sets the polarity for the TV trigger Query Syntax TRIGger TV POLarity The TRIGger TV POLarity query returns the TV trigger pola...

Page 625: ...nalog channels in NR1 format The TRIGger TV SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TV SOURce The TRIGger TV SOURce query returns the current TV trigger sou...

Page 626: ...790 Command Syntax TRIGger TV STANdard standard standard NTSC PALM PAL SECam The TRIGger TV STANdard command selects the video standard NTSC PAL PAL M SECAM Query Syntax TRIGger TV STANdard The TRIGg...

Page 627: ...DATA see page 637 binary block length bytes binary data For example to transmit 1000 bytes of data the syntax would be 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 i...

Page 628: ...ion type count Average count or 1 if PEAK detect type or NORMal an integer in NR1 format n a WAVeform SEGMented C OUNt see page 647 count an integer from 2 to 1000 in NR1 format with Option SGM n a WA...

Page 629: ...and the type of acquired data The preamble also contains the X and Y increments origins and references for the acquired data so that word and byte data can be translated to time and voltage values WAV...

Page 630: ...number of points acquired may be queried using ACQuire POINts see page 188 Helpful Hints The number of points transferred to the computer is controlled using the WAVeform POINts command see page 640...

Page 631: ...ucket n 1 where n is the number returned by the WAVeform POINts query see page 640 The first value corresponds to a point at the left side of the screen and the last value corresponds to one point awa...

Page 632: ...point sent with WAVeform XORigin 16 ns WAVeform XREFerence 0 and WAVeform XINCrement 2 ns can be calculated using the following formula time data point number xreference xincrement xorigin This would...

Page 633: ...uery see page 640 If the data intrinsically has less than 16 bits of resolution the data is left shifted to provide 16 bits of resolution and the least significant bits are set to 0 Currently the grea...

Page 634: ...WORD see page 639 is WORD every other data byte will be 0 The setting of WAVeform BYTeorder see page 635 controls which byte is 0 If a digital channel is not displayed its bit value in the pod data by...

Page 635: ...t LSBFirst sets the least significant byte to be transmitted first This command affects the transmitting sequence only when WAVeform FORMat WORD is selected The default setting is MSBFirst Query Synta...

Page 636: ...ount used to acquire the current waveform This may differ from current values if the unit has been stopped and its configuration modified For all acquisition types except average this value is 1 Retur...

Page 637: ...d is intended for ASCII transfers Use telnet port 5025 instead 0x01 or 0x0001 Clipped low These are locations where the waveform is clipped at the bottom of the oscilloscope display 0xFF or 0xFFFF Cli...

Page 638: ...Value As Long varQueryResult myScope ReadIEEEBlock BinaryType_UI1 Unsigned integer bytes For lngI 0 To UBound varQueryResult _ Step UBound varQueryResult 20 20 points If intBytesPerData 2 Then lngData...

Page 639: ...e WAVeform BYTeorder command can be used to specify whether the upper or lower byte is transmitted first The default no command sent is that the upper byte transmitted first BYTE formatted data is tra...

Page 640: ...NORMal waveform points mode See the WAVeform POINts MODE command see page 642 for more information Only data visible on the display will be returned When the WAVeform SOURce is the serial decode bus...

Page 641: ...form VIEW on page 656 WAVeform PREamble on page 644 WAVeform POINts MODE on page 642 Example Code WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope Wri...

Page 642: ...ord is used Under some conditions such as when the oscilloscope is running this data record is unavailable If the points_mode is MAXimum whichever record contains the maximum amount of points is used...

Page 643: ...affect what data is transferred See the discussion above Return Format points_mode NL points_mode NORMal MAXimum RAW See Also Introduction to WAVeform Commands on page 629 WAVeform DATA on page 637 A...

Page 644: ...int NR3 xreference 32 bit NR1 yincrement 32 bit floating point NR3 yorigin 32 bit floating point NR3 yreference 32 bit NR1 format 0 for BYTE format 1 for WORD format 4 for ASCii format an integer in N...

Page 645: ...UNT int32 1 and is always 1 XINCREMENT float64 time difference between data points XORIGIN float64 always the first data point in memory XREFERENCE int32 specifies the data point associated with x ori...

Page 646: ...2000 X Series Oscilloscopes Programmer s Guide 30 WAVeform Commands sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 See complete example programs at Chapter 38 Programming Exam...

Page 647: ...s complete The segmented memory acquisition mode is enabled with the ACQuire MODE command The number of segments to acquire is set using the ACQuire SEGMented COUNt command and data is acquired using...

Page 648: ...G query returns the time tag of the currently selected segmented memory index The index is selected using the ACQuire SEGMented INDex command Return Format time_tag in NR3 format See Also ACQuire SEGM...

Page 649: ...d bus decode information With MSO oscilloscope models you can choose a POD or BUS as the waveform source There are some differences between POD and BUS when formatting and getting data from the oscill...

Page 650: ...URCE Selects the channel to be used as the source for the waveform commands myScope WriteString WAVEFORM SOURCE CHAN1 WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DA...

Page 651: ...Reference As Long Dim strOutput As String myScope WriteString WAVEFORM PREAMBLE Query for the preamble Preamble myScope ReadList Read preamble information intFormat Preamble 0 intType Preamble 1 lngPo...

Page 652: ...may be stripped off of the header and the remaining numbers are the size in bytes of the waveform data block The size can vary depending on the number of points acquired for the waveform You can then...

Page 653: ...ets you get TX data TX is an alias for SUB1 The default SUB0 specifies RX data RX is an alias for SUB0 When using SPI serial decode this option lets you get MISO data MISO is an alias for SUB1 The def...

Page 654: ...ion mode associated with the currently selected waveform The acquisition mode is set by the ACQuire TYPE command Return Format mode NL mode NORM PEAK AVER HRES See Also Introduction to WAVeform Comman...

Page 655: ...sent as unsigned or signed integers This command can be used to match the instrument s internal data type to the data type used by the programming language This command has no effect if the data form...

Page 656: ...EW command sets the view setting associated with the currently selected waveform Currently the only legal value for the view setting is MAIN Query Syntax WAVeform VIEW The WAVeform VIEW query returns...

Page 657: ...rement query returns the x increment value for the currently specified source This value is the time difference between consecutive data points in seconds Return Format value NL value x increment in t...

Page 658: ...urce XORigin is the X axis value of the data point specified by the WAVeform XREFerence value In this product that is always the X axis value of the first data point XREFerence 0 Return Format value N...

Page 659: ...urrently specified source This value specifies the index of the data point associated with the x origin data value In this product the x reference point is the first point displayed and XREFerence is...

Page 660: ...crement value in volts for the currently specified source This value is the voltage difference between consecutive data values The y increment for digital waveforms is always 1 Return Format value NL...

Page 661: ...ecified source This value is the Y axis value of the data value specified by the WAVeform YREFerence value For this product this is the Y axis value of the center of the screen Return Format value NL...

Page 662: ...pecified source This value specifies the data point value where the y origin occurs In this product this is the data point value of the center of the screen It is undefined if the format is ASCii Retu...

Page 663: ...th in seconds in NR3 format WGEN FUNCtion RAMP S YMMetry percent see page 670 WGEN FUNCtion RAMP S YMMetry see page 670 percent symmetry percentage from 0 to 100 in NR1 format WGEN FUNCtion SQUare DCY...

Page 664: ...MODulation NOIS e percent see page 680 WGEN MODulation NOIS e see page 680 percent 0 to 100 WGEN MODulation STAT e 0 OFF 1 ON see page 681 WGEN MODulation STAT e see page 681 0 1 WGEN MODulation TYPE...

Page 665: ...t The following is a sample response from the WGEN query In this case the query was issued following the RST command WGEN FUNC SIN OUTP 0 FREQ 1 0000E 03 VOLT 500 0E 03 VOLT OFFS 0 0E 00 WGEN OUTP LOA...

Page 666: ...e and DC the WGEN FREQuency command specifies the frequency of the waveform You can also specify the frequency indirectly using the WGEN PERiod command Query Syntax WGEN FREQuency The WGEN FREQuency q...

Page 667: ...ands to set the square wave signal parameters WGEN FREQuency on page 666 WGEN PERiod on page 686 WGEN VOLTage on page 688 WGEN VOLTage OFFSet on page 691 WGEN VOLTage HIGH on page 689 WGEN VOLTage LOW...

Page 668: ...e commands to set the pulse signal parameters WGEN FREQuency on page 666 WGEN PERiod on page 686 WGEN VOLTage on page 688 WGEN VOLTage OFFSet on page 691 WGEN VOLTage HIGH on page 689 WGEN VOLTage LOW...

Page 669: ...t For Pulse waveforms the WGEN FUNCtion PULSe WIDTh command specifies the width of the pulse The pulse width can be adjusted from 20 ns to the period minus 20 ns Query Syntax WGEN FUNCtion PULSe WIDTh...

Page 670: ...waveforms the WGEN FUNCtion RAMP SYMMetry command specifies the symmetry of the waveform Symmetry represents the amount of time per cycle that the ramp waveform is rising Query Syntax WGEN FUNCtion RA...

Page 671: ...are waveforms the WGEN FUNCtion SQUare DCYCle command specifies the square wave duty cycle Duty cycle is the percentage of the period that the waveform is high Query Syntax WGEN FUNCtion SQUare DCYCle...

Page 672: ...m 10 to 90 90 10 80 of the original amplitude as the modulating signal goes from its minimum to maximum amplitude Query Syntax WGEN MODulation AM DEPTh The WGEN MODulation AM DEPTh query returns the A...

Page 673: ...lation AM FREQuency The WGEN MODulation AM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Als...

Page 674: ...quency deviation cannot be greater than the original carrier signal frequency Also the sum of the original carrier signal frequency and the frequency deviation must be less than or equal to the maximu...

Page 675: ...lation FM FREQuency The WGEN MODulation FM FREQuency query returns the frequency of the modulating signal Return Format frequency NL frequency modulating waveform frequency in Hz in NR3 format See Als...

Page 676: ...nd this hop frequency Query Syntax WGEN MODulation FSKey FREQuency The WGEN MODulation FSKey FREQuency query returns the hop frequency setting Return Format frequency NL frequency hop frequency in Hz...

Page 677: ...e modulating signal Query Syntax WGEN MODulation FSKey RATE The WGEN MODulation FSKey RATE query returns the FSK rate setting Return Format rate NL rate FSK modulation rate in Hz in NR3 format See Als...

Page 678: ...try command This command applies to AM and FM modulation The FSK modulation signal is a square wave shape Query Syntax WGEN MODulation FUNCtion The WGEN MODulation FUNCtion query returns the specified...

Page 679: ...ified with the WGEN MODulation FUNCtion command Query Syntax WGEN MODulation FUNCtion RAMP SYMMetry The WGEN MODulation FUNCtion RAMP SYMMetry query returns ramp symmetry percentage setting Return For...

Page 680: ...ed to the regular amplitude limit for example 5 Vpp in 1 MOhm so the range for percent varies according to current amplitude Note that adding noise affects edge triggering on the waveform generator so...

Page 681: ...nd noise Query Syntax WGEN MODulation STATe The WGEN MODulation STATe query returns whether the modulated waveform generator output is enabled of disabled Return Format setting NL setting 0 1 See Also...

Page 682: ...modulating signal frequency Use the WGEN MODulation FM DEViation command to specify the frequency deviation from the original carrier signal frequency FSK frequency shift keying modulation the output...

Page 683: ...Commands 31 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 683 WGEN MODulation FUNCtion on page 678 WGEN MODulation FUNCtion RAMP SYMMetry on page 679 WGEN MODulation STATe on pa...

Page 684: ...GEN OUTPut on_off on_off 1 ON 0 OFF The WGEN OUTPut command specifies whether the waveform generator signal output is ON 1 or OFF 0 Query Syntax WGEN OUTPut The WGEN OUTPut query returns the current s...

Page 685: ...BNC is fixed at 50 ohms However the output load selection lets the waveform generator display the correct amplitude and offset levels for the expected output load If the actual load impedance is diffe...

Page 686: ...oise and DC the WGEN PERiod command specifies the period of the waveform You can also specify the period indirectly using the WGEN FREQuency command Query Syntax WGEN PERiod The WGEN PERiod query retu...

Page 687: ...r s Guide 687 WGEN RST see page 790 Command Syntax WGEN RST The WGEN RST command restores the waveform generator factory default settings 1 kHz sine wave 500 mVpp 0 V offset See Also Introduction to W...

Page 688: ...also specify the amplitude and offset indirectly using the WGEN VOLTage HIGH and WGEN VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4...

Page 689: ...pecify the high level and low level voltages indirectly using the WGEN VOLTage and WGEN VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an...

Page 690: ...pecify the high level and low level voltages indirectly using the WGEN VOLTage and WGEN VOLTage OFFSet commands For example a high level voltage of 4 V and a low level voltage of 1 V is the same as an...

Page 691: ...y the amplitude and offset indirectly using the WGEN VOLTage HIGH and WGEN VOLTage LOW commands For example an amplitude of 5 V and an offset of 1 V is the same as a high level voltage of 4 V and a lo...

Page 692: ...692 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 31 WGEN Commands...

Page 693: ...ry r LABel see page 697 r 1 2 in NR1 format string any series of 10 or less ASCII characters enclosed in quotation marks WMEMory r SAVE source see page 698 n a r 1 2 in NR1 format source CHANnel n FUN...

Page 694: ...YRANge see page 701 r 1 2 in NR1 format range vertical full scale range value in NR3 format suffix V mV WMEMory r YSCale scale suffix see page 702 WMEMory r YSCale see page 702 r 1 2 in NR1 format sca...

Page 695: ...Guide 695 WMEMory r CLEar see page 790 Command Syntax WMEMory r CLEar r 1 2 in NR1 format The WMEMory r CLEar command clears the specified reference waveform location See Also Chapter 32 WMEMory r Co...

Page 696: ...There are two reference waveform locations but only one reference waveform can be displayed at a time That means if WMEMory1 DISPlay is ON sending the WMEMory2 DISPlay ON command will automatically s...

Page 697: ...e to the label list in non volatile memory replacing the oldest label in the list Query Syntax WMEMory r LABel The WMEMory r LABel query returns the label associated with a particular reference wavefo...

Page 698: ...R1 format source CHANnel n FUNCtion MATH n 1 to analog channels in NR1 format The WMEMory r SAVE command copies the analog channel or math function waveform to the specified reference waveform locatio...

Page 699: ...SKEW command sets the skew factor for the specified reference waveform Query Syntax WMEMory r SKEW The WMEMory r SKEW query returns the current skew setting for the selected reference waveform Return...

Page 700: ...e set by the WMEMory r YRANge or WMEMory r YSCale commands If you set the offset to a value outside of the legal range the offset value is automatically set to the nearest legal value Legal values are...

Page 701: ...l values for the range are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMory r YRANge...

Page 702: ...form Legal values for the scale are copied from the original source waveform that is the analog channel or math function waveform that was originally saved as a reference waveform Query Syntax WMEMory...

Page 703: ...221 ANALog n INVert CHANnel n INVert see page 224 ANALog n LABel CHANnel n LABel see page 225 ANALog n OFFSet CHANnel n OFFSet see page 226 ANALog n PROBe CHANnel n PROBe see page 227 ANALog n PMODe...

Page 704: ...719 FUNCtion DISPlay see page 280 HARDcopy DESTination see page 720 HARDcopy FILename see page 721 HARDcopy FILename see page 721 RECall FILename see page 419 SAVE FILename see page 419 HARDcopy GRAY...

Page 705: ...EASure VSTOp see page 736 MARKer Y2Position see page 328 MTESt AMASk SAVE STORe see page 737 SAVE MASK STARt see page 435 MTESt AVERage see page 738 ACQuire TYPE AVERage see page 195 MTESt AVERage COU...

Page 706: ...ndow TRIGger THReshold see page 749 POD n THReshold see page 414 or DIGital d THReshold see page 249 TRIGger TV TVMode see page 750 TRIGger TV MODE see page 623 Obsolete Command Current Command Equiva...

Page 707: ...FUNCtion PEAKs none HARDcopy ADDRess none Only parallel printer port is supported GPIB printing not supported MASK none All commands discontinued feature not available SYSTem KEY none TEST ALL TST Se...

Page 708: ...mat edges levels NL edges presence of edges 32 bit integer in NR1 format levels logical highs or lows 32 bit integer in NR1 format A bit equal to one indicates that edges have been detected at the spe...

Page 709: ...Nnel LABel command sets the source text to the string that follows Setting a channel will also result in the name being added to the label list Query Syntax CHANnel LABel The CHANnel LABel query retur...

Page 710: ...either set to a predefined value or to a user defined value For the predefined value the voltage parameter is ignored Query Syntax CHANnel THReshold channel group The CHANnel THReshold query returns...

Page 711: ...s analog probe skew control to remove cable delay errors between channel 1 and channel 2 Query Syntax CHANnel2 SKEW The CHANnel2 SKEW query returns the current probe skew setting for the selected cha...

Page 712: ...lects the input impedance setting for the specified channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n INPut The CHANnel n INPut query returns the current inp...

Page 713: ...robe with sense is connected to the specified channel auto sensing is enabled otherwise the mode is manual If the PMODe sent matches the oscilloscope s setting the command will be accepted Otherwise a...

Page 714: ...ed on the oscilloscope displays lines connecting sampled data points When vectors are turned off only the sampled data is displayed Query Syntax DISPlay CONNect The DISPlay CONNect query returns the c...

Page 715: ...string See Also DIGital d POSition on page 247 Example Code DISP_ORDER Set the order the channels are displayed on the analyzer You can enter between 1 and 32 channels at one time If you leave out ch...

Page 716: ...uide 33 Obsolete and Discontinued Commands ERASe see page 790 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to previ...

Page 717: ...connected to the specified channel auto sensing is enabled otherwise the mode is manual If the pmode sent matches the oscilloscope s setting the command will be accepted Otherwise a setting conflict...

Page 718: ...FUNCtion SOURce command selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for FFT operations specified by the FUNCtion OPERation command Que...

Page 719: ...or off When ON is selected the function performs as specified using the other FUNCtion commands When OFF is selected function is neither calculated nor displayed Query Syntax FUNCtion VIEW The FUNCtio...

Page 720: ...y DESTination command sets the hardcopy destination Query Syntax HARDcopy DESTination The HARDcopy DESTination query returns the selected hardcopy destination Return Format destination NL destination...

Page 721: ...e for those print formats whose output is a file Query Syntax HARDcopy FILename The HARDcopy FILename query returns the current hardcopy output filename Return Format string NL string quoted ASCII str...

Page 722: ...RDcopy GRAYscale The HARDcopy GRAYscale query returns a flag indicating whether grayscaling is performed in the hardcopy dump Return Format gray NL gray 0 1 See Also Introduction to HARDcopy Commands...

Page 723: ...s whether the graticule colors are inverted or not Query Syntax HARDcopy IGColors The HARDcopy IGColors query returns a flag indicating whether graticule colors are inverted or not Return Format value...

Page 724: ...rdcopy printer driver used for the selected printer If the correct driver for the selected printer can be identified it will be selected and cannot be changed Query Syntax HARDcopy PDRiver The HARDcop...

Page 725: ...hen the thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure LOWer The MEASure LOWer query returns the current lower threshold level Return Format voltage NL...

Page 726: ...EASure SCRatch see page 790 Command Syntax MEASure SCRatch The MEASure SCRatch command clears all selected measurements and markers from the screen NOTE The MEASure SCRatch command is obsolete and is...

Page 727: ...ELta query is received by the oscilloscope The delta time value that is output is the current value This is the same value as the front panel cursors delta X value Return Format value NL value time di...

Page 728: ...ted when making time measurements Return Format T1090 T2080 VOLTage NL T1090 uses the 10 and 90 levels of the selected waveform T2080 uses the 20 and 80 levels of the selected waveform VOLTage uses th...

Page 729: ...time at the start marker in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer X1Position on page 320 MARKer X2Position on page 322 MA...

Page 730: ...me at the stop marker in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer X1Position on page 320 MARKer X2Position on page 322 MARKer...

Page 731: ...onse to the query The specified voltage can be negative or positive To specify a negative voltage use a minus sign The sign of the slope selects a rising or falling edge If no sign is specified for th...

Page 732: ...732 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 33 Obsolete and Discontinued Commands value time in seconds of the specified voltage crossing in NR3 format...

Page 733: ...age when the thresholds are PERCent as defined by the MEASure DEFine THResholds command Query Syntax MEASure UPPer The MEASure UPPer query returns the current upper threshold level Return Format value...

Page 734: ...t is returned is the current value This is the same value as the front panel cursors delta Y value VDELta value at marker 2 value at marker 1 Return Format value NL value delta V value in NR1 format S...

Page 735: ...e at voltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer Y1Position on page 327 MARKer Y2Position on page 328 MARKer...

Page 736: ...the Y2 cursor in NR3 format See Also Introduction to MARKer Commands on page 318 Introduction to MEASure Commands on page 340 MARKer Y1Position on page 327 MARKer Y2Position on page 328 MARKer YDELta...

Page 737: ...s not been generated an error occurs The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used The filename assumes the present w...

Page 738: ...ucket and averages them When OFF averaging is disabled To set the number of averages use the MTESt AVERage COUNt command described next Query Syntax MTESt AVERage The MTESt AVERage query returns the c...

Page 739: ...ommand specifies the number of data values to be averaged for each time bucket before the acquisition is considered complete for that time bucket Query Syntax MTESt AVERage COUNt The MTESt AVERage COU...

Page 740: ...e specified mask file The filename parameter is an MS DOS compatible name of the file a maximum of 254 characters long including the path name if used See Also Introduction to MTESt Commands on page 3...

Page 741: ...ds parameter is a real number from 1 to 86400 seconds WAVeforms sets the maximum number of waveforms that are required before the mask test terminates The wfm_count parameter indicates the number of w...

Page 742: ...s run and a mask violation is detected the mask test is stopped and the acquisition system is stopped Query Syntax MTESt RUMode SOFailure The MTESt RUMode SOFailure query returns the current state of...

Page 743: ...nd Syntax MTESt STARt STOP The MTESt STARt STOP command starts or stops the acquisition system See Also Introduction to MTESt Commands on page 379 NOTE The MTESt STARt and MTESt STOP commands are obso...

Page 744: ...er SOURce command sets the channel to use as the trigger Query Syntax MTESt TRIGger SOURce The MTESt TRIGger SOURce query returns the currently selected trigger source Return Format source CHAN n n 1...

Page 745: ...page 258 instead Print Option PRINt command PRINt query Query Default COLor Sets palette COLor GRAYscale Sets palette GRAYscale palette COLor PRINter0 1 Causes the USB printer 0 1 to be selected as de...

Page 746: ...continued Commands See Also Introduction to Root Commands on page 150 Introduction to HARDcopy Commands on page 296 HARDcopy FACTors on page 299 HARDcopy GRAYscale on page 722 DISPlay DATA on page 258...

Page 747: ...d image area When saving images this query returns SCR screen When saving setups or waveform data this query returns GRAT graticule even though graticule images are not saved Return Format area NL are...

Page 748: ...nce point is set with the TIMebase REFerence command see page 582 Query Syntax TIMebase DELay The TIMebase DELay query returns the current delay value Return Format delay_value NL delay_value time fro...

Page 749: ...value or to a user defined value For the predefined value the voltage parameter is not required Query Syntax TRIGger THReshold channel group The TRIGger THReshold query returns the voltage and thresh...

Page 750: ...rnate parameter is not available when TRIGger TV STANdard is GENeric see page 626 Old forms for mode are accepted Query Syntax TRIGger TV TVMode The TRIGger TV TVMode query returns the TV trigger mode...

Page 751: ...s Guide 34 Error Messages 440 Query UNTERMINATED after indefinite response 430 Query DEADLOCKED 420 Query UNTERMINATED 410 Query INTERRUPTED 400 Query error 340 Calibration failed 330 Self test faile...

Page 752: ...ll memory lost 313 Calibration memory lost 311 Memory error 310 System error 300 Device specific error 278 Macro header not found 277 Macro redefinition not allowed 276 Macro recursion error 273 Illeg...

Page 753: ...ia 251 Missing mass storage 250 Mass storage error 241 Hardware missing This message can occur when a feature is unavailable or unlicensed For example some serial bus decode commands are only availabl...

Page 754: ...221 Settings conflict 220 Parameter error 200 Execution error 183 Invalid inside macro definition 181 Invalid outside macro definition 178 Expression data not allowed 171 Invalid expression 170 Expres...

Page 755: ...error 148 Character data not allowed 138 Suffix not allowed 134 Suffix too long 131 Invalid suffix 128 Numeric data not allowed 124 Too many digits 123 Exponent too large 121 Invalid character in numb...

Page 756: ...rror Messages 109 Missing parameter 108 Parameter not allowed 105 GET not allowed 104 Data type error 103 Invalid separator 102 Syntax error 101 Invalid character 100 Command error 10 Software Fault O...

Page 757: ...rint Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation A remote operation wants some information but there is no information available For example you may re...

Page 758: ...758 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 34 Error Messages...

Page 759: ...ent Register MTERegister EVENt 776 Clearing Registers and Queues 777 Status Reporting Decision Chart 778 IEEE 488 2 defines data structures commands and common bit definitions for status reporting for...

Page 760: ...gisters the summary bit is set if any enabled bit in the event register is set The events are enabled with the corresponding event enable register Events captured by an event register remain set until...

Page 761: ...ter 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14 15 MTERegister EVENt Mask Test Event Event Register RP SOHWH Fail MTE To bits in Operation Status Condition Register OVLR Auto Mask Started Wait Trig Run Arm Reg...

Page 762: ...a summary bit the bits must be enabled These bits are enabled by using the ESE common command to set the corresponding bit in the Standard Event Status Enable Register To generate a service request SR...

Page 763: ...bit and clears the bit which clears the SRQ interrupt The STB command reads bit 6 as the Master Summary Status MSS and does not clear the bit or have any affect on the SRQ interrupt The value returne...

Page 764: ...cleared when the Status Byte Register is read by the serial poll command Example The following example uses the resource session object s ReadSTB method to read the contents of the oscilloscope s Stat...

Page 765: ...gister using the SRE command and the bits that are set are read with the SRE query Example The following example sets bit 4 MAV and bit 5 ESB in the Service Request Enable Register myScope WriteString...

Page 766: ...igger event occurs The TER event register stays set until it is cleared by reading the register or using the CLS command If your application needs to detect multiple triggers the TER event register mu...

Page 767: ...rated by certain instrument commands and queries The output queue generates the Message Available summary bit when the output queue contains one or more bytes This summary bit sets the MAV bit bit 4 i...

Page 768: ...essage Queue The message queue contains the text of the last message written to the advisory line on the screen of the oscilloscope The length of the oscilloscope s message queue is 1 Note that messag...

Page 769: ...bled in the Standard Event Status Enable Register the bits set in this register generate a summary bit to set bit 5 ESB in the Status Byte Register You can read the contents of the Standard Event Stat...

Page 770: ...e 0x3C Therefore you can enable any of these bits to generate the summary bit by sending myScope WriteString ESE CStr CInt H3C Whenever an error occurs it sets one of these bits in the Standard Event...

Page 771: ...is discarded The length of the oscilloscope s error queue is 30 29 positions for the error messages and 1 position for the Queue overflow message The error queue is read with the SYSTem ERRor query E...

Page 772: ...us Event Register is read and cleared with the OPERegister EVENt query The register output is enabled or disabled using the mask value supplied with the OPEE command Name Location Description RUN bit...

Page 773: ...these bits The OPERegister CONDition query returns the value of the Operation Status Condition Register Name Location Description RUN bit bit 3 Is set whenever the instrument is not stopped WAIT TRIG...

Page 774: ...n the instrument becomes armed The ARM event register stays set until it is cleared by reading the register with the AER query or using the CLS command If your application needs to detect multiple tri...

Page 775: ...ter hosts these bits Name Location Description Channel 1 Fault bit 6 Fault has occurred on Channel 1 input Channel 2 Fault bit 7 Fault has occurred on Channel 2 input Channel 3 Fault bit 8 Fault has o...

Page 776: ...gister register hosts these bits The MTERegister EVENt query returns the value of and clears the Mask Test Event Event Register Name Location Description Complete bit 0 Is set when the mask test is co...

Page 777: ...es Oscilloscopes Programmer s Guide 777 Clearing Registers and Queues The CLS common command clears all event registers and all queues except the output queue If CLS is sent immediately after a progra...

Page 778: ...6WDWXV WH 5HJLVWHU DQG VHQG DQ 654 WR WKH FRPSXWHU I HYHQWV DUH PRQLWRUHG E WKH 6WDQGDUG YHQW 6WDWXV 5HJLVWHU DOVR HQDEOH 6 ZLWK WKH 65 FRPPDQG FWLYDWH WKH LQVWUXPHQW IXQFWLRQ WKDW RX ZDQW WR PRQLWRU...

Page 779: ...ith programming commands it is often necessary to know when the oscilloscope has finished the previous operation and is ready for the next command The most common example is when an acquisition is sta...

Page 780: ...eve Results Once the acquisition is complete it is safe to retrieve measurements and statistics NOTE It is not necessary to use OPC hard coded waits or status checking when setting up the oscilloscope...

Page 781: ...Main On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaComLib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0...

Page 782: ...Lib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0 INSTR myScope IO Clear Clear the interface Set up Set up the trigger and horizontal sc...

Page 783: ...100 Small wait to prevent excessive queries lngElapsed lngElapsed 100 End If Loop Get results If lngElapsed lngTimeout Then myScope WriteString MEASure RISetime myScope WriteString MEASure RISetime va...

Page 784: ...VisaComLib ResourceManager Public myScope As VisaComLib FormattedIO488 Public varQueryResult As Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As L...

Page 785: ...cs to wait for single shot Dim lngElapsed As Long lngTimeout 10000 10 seconds lngElapsed 0 Do While lngElapsed lngTimeout myScope WriteString OPERegister CONDition varQueryResult myScope ReadNumber Ma...

Page 786: ...s Variant Public strQueryResult As String Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long Sub Main On Error GoTo VisaComError Create the VISA COM I O resource Set myMgr New VisaCom...

Page 787: ...er STB from Standard Event Status register ESR is set STB can be read during DIGitize without generating a timeout Do Sleep 4000 Poll more often than the timeout setting varQueryResult myScope IO Read...

Page 788: ...788 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 36 Synchronizing Acquisitions...

Page 789: ...iiVision 2000 X Series Oscilloscopes Programmer s Guide 37 More About Oscilloscope Commands Command Classifications 790 Valid Command Query Strings 791 Query Return Values 797 All Oscilloscope Command...

Page 790: ...ethods are employed Non Core Commands Non core commands are commands that provide specific features but are not universal across all Agilent InfiniiVision oscilloscope models Non core commands may be...

Page 791: ...y time a parameter is not meant to be expressed as a string is when the instruction s syntax definition specifies block data such as learn string There are only a few instructions that use block data...

Page 792: ...s the values they accept Program Data Syntax Rules on page 794 describes all of the general rules about acceptable values When there is more than one data parameter they are separated by commas Spaces...

Page 793: ...ey must be preceded by a colon When program data must be included with the simple command header for example DIGitize CHANnel1 white space is added to separate the data from the header The syntax is p...

Page 794: ...DE command can be set to normal zoomed delayed XY or ROLL The character program data in this case may be MAIN WINDow XY or ROLL The command TIMebase MODE WINDow sets the time base mode to zoomed The a...

Page 795: ...header would be TIMebase RANGe This is referred to as a compound header A compound header is a header made of two or more mnemonics separated by colons The mnemonic created contains no spaces The fol...

Page 796: ...m mnemonic data program mnemonic data terminator For example myScope WriteString TIMebase REFerence CENTer DISPlay VECTors ON Multiple commands may be any combination of compound and simple commands N...

Page 797: ...s to the designated listener typically a controller For example the query TIMebase RANGe places the current time base setting in the output queue When using the Agilent VISA COM library in Visual Basi...

Page 798: ...l IEEE 488 2 makes the distinction between sequential and overlapped commands Sequential commands finish their task before the execution of the next command starts Overlapped commands run concurrently...

Page 799: ...lloscopes Programmer s Guide 38 Programming Examples VISA COM Examples 800 VISA Examples 833 SICL Examples 880 SCPI NET Examples 900 Example programs are ASCII text files that can be cut from the help...

Page 800: ...ilent VISA COM library a Choose Tools References from the main menu b In the References dialog check the VISA COM 3 0 Type Library c Click OK 4 Choose Insert Module 5 Cut and paste the code that follo...

Page 801: ...out Initialize start from a known state Initialize Capture data Capture Analyze the captured waveform Analyze Exit Sub VisaComError MsgBox VISA COM Error vbCrLf Err Description End End Sub Initialize...

Page 802: ...String TRIGger EDGE SLOPe Save oscilloscope configuration varQueryResult DoQueryIEEEBlock_UI1 SYSTem SETup Output setup string to a file Dim strPath As String strPath c scope config setup dat Dim hFil...

Page 803: ...command DoCommandIEEEBlock SYSTem SETup varSetupString Debug Print Setup bytes restored CStr LenB varSetupString Capture an acquisition using DIGitize DoCommand DIGitize CHANnel1 Exit Sub VisaComErro...

Page 804: ...Set the waveform points mode DoCommand WAVeform POINts MODE RAW Debug Print Waveform points mode _ DoQueryString WAVeform POINts MODE Get the number of waveform points available Debug Print Waveform...

Page 805: ...isition type NORMal ElseIf intType 1 Then Debug Print Acquisition type PEAK ElseIf intType 2 Then Debug Print Acquisition type AVERage ElseIf intType 3 Then Debug Print Acquisition type HRESolution En...

Page 806: ...ge value Print hFile _ FormatNumber dblXOrigin lngI dblXIncrement 9 _ _ FormatNumber lngDataValue lngYReference _ sngYIncrement sngYOrigin Next lngI Close output file Close hFile Close file MsgBox Wav...

Page 807: ...yScope WriteString query DoQueryString myScope ReadString CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VIS...

Page 808: ...naryType_UI1 CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End End Function Private Sub Chec...

Page 809: ...e project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add Reference c In the Add Reference dialog select the COM tab d Selec...

Page 810: ...tion err Console WriteLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message finally myScope Clo...

Page 811: ...ned from instrument string strPath Query and read setup string ResultsArray myScope DoQueryIEEEBlock SYSTem SETup nLength ResultsArray Length Write setup string to file strPath c scope config setup st...

Page 812: ...CHANnel1 Analyze the captured waveform private static void Analyze byte ResultsArray Results array int nLength Number of bytes returned from instrument string strPath Make a couple of measurements myS...

Page 813: ...ng WAVeform POINts Set the waveform source myScope DoCommand WAVeform SOURce CHANnel1 Console WriteLine Waveform source 0 myScope DoQueryString WAVeform SOURce Choose the format of the data returned W...

Page 814: ...ement fResultsArray 7 Console WriteLine Waveform Y increment 0 e fYincrement double fYorigin fResultsArray 8 Console WriteLine Waveform Y origin 0 e fYorigin double fYreference fResultsArray 9 Console...

Page 815: ...c void DoCommand string strCommand Send the command m_IoObject WriteString strCommand true Check for inst errors CheckInstrumentErrors strCommand public void DoCommandIEEEBlock string strCommand byte...

Page 816: ...ResultsArray double m_IoObject ReadList IEEEASCIIType ASCIIType_R8 Check for inst errors CheckInstrumentErrors strQuery Return result numbers return fResultsArray public byte DoQueryIEEEBlock string s...

Page 817: ...trInstrumentError ToString StartsWith 0 private void OpenIo m_ResourceManager new ResourceManagerClass m_IoObject new FormattedIO488Class Open the default VISA COM IO object try m_IoObject IO IMessage...

Page 818: ...Add Reference dialog select the COM tab d Select VISA COM 3 0 Type Library then click OK e Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft...

Page 819: ...e WriteLine Unexpected Error err Message Finally myScope Close End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub Initialize Dim strResults As String Get and display the d...

Page 820: ...File Open strPath FileMode Create fStream Write ResultsArray 0 nLength fStream Close Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offs...

Page 821: ...couple of measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNu...

Page 822: ...ings Dim fResultsArray As Double fResultsArray myScope DoQueryNumbers WAVeform PREamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf fFormat 1...

Page 823: ...output file strPath c scope data waveform_data csv If File Exists strPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data i...

Page 824: ...Check for inst errors CheckInstrumentErrors strCommand End Sub Public Function DoQueryString ByVal strQuery As String As String Send the query m_IoObject WriteString strQuery True Get the result strin...

Page 825: ...y System Threading Thread Sleep 2000 Delay before reading data Dim ResultsArray As Byte ResultsArray _ m_IoObject ReadIEEEBlock IEEEBinaryType BinaryType_UI1 _ False True Check for inst errors CheckIn...

Page 826: ...ry Marshal ReleaseComObject m_IoObject Catch End Try Try Marshal ReleaseComObject m_ResourceManager Catch End Try End Sub End Class End Namespace VISA COM Example in Python You can use the Python prog...

Page 827: ...ate comtypes gen VisaComLib if not hasattr sys frozen GetModule C Program Files x86 IVI Foundation VISA VisaCom GlobMgr dll import comtypes gen VisaComLib as VisaComLib Global variables booleans 0 Fal...

Page 828: ...ividual commands Set vertical scale and offset do_command CHANnel1 SCALe 0 05 qresult do_query_number CHANnel1 SCALe print Channel 1 vertical scale f qresult do_command CHANnel1 OFFSet 1 5 qresult do_...

Page 829: ...ngth len image_bytes f open c scope data screen bmp wb f write bytearray image_bytes f close print Screen image written to c scope data screen bmp Download waveform data Set the waveform points mode d...

Page 830: ...veform Y increment f y_increment print Waveform Y origin f y_origin print Waveform Y reference d y_reference Always 125 Get numeric values for later calculations x_increment do_query_number WAVeform X...

Page 831: ...pe WriteString s query True result myScope ReadString check_instrument_errors query return result Send a query check for errors return string def do_query_ieee_block query myScope WriteString s query...

Page 832: ...eak else SYSTem ERRor should always return string print ERROR SYSTem ERRor returned nothing command s command print Exited because of error sys exit 1 Main program rm CreateObject VISA GlobalRM interf...

Page 833: ...xample c file and click Add 6 Edit the program to use the VISA address of your oscilloscope 7 Choose Project Properties In the Property Pages dialog update these project settings a Under Configuration...

Page 834: ..._query_numbers char query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors void error_handler VISA error handler Global varia...

Page 835: ...mmand RST Capture the waveform void capture void int num_bytes FILE fp Use auto scale to automatically configure oscilloscope do_command AUToscale Set trigger mode EDGE PULSe PATTern etc and input sou...

Page 836: ...t horizontal scale and offset do_command TIMebase SCALe 0 0002 do_query_string TIMebase SCALe printf Timebase scale s n str_result do_command TIMebase POSition 0 0 do_query_string TIMebase POSition pr...

Page 837: ...4f kHz n num_result 1000 do_command MEASure VAMPlitude do_query_number MEASure VAMPlitude printf Vertical amplitude 2f V n num_result Download the screen image do_command HARDcopy INKSaver OFF Read s...

Page 838: ...do_query_numbers WAVeform PREamble wav_format dbl_results 0 if wav_format 0 0 printf Waveform format BYTE n else if wav_format 1 0 printf Waveform format WORD n else if wav_format 2 0 printf Waveform...

Page 839: ...n num_bytes Open file for output fp fopen c scope data waveform_data csv wb Output waveform data in CSV format for i 0 i num_bytes 1 i Write time value voltage value fprintf fp 9f 6f n x_origin float...

Page 840: ...n data_length Query for a string result void do_query_string query char query char message 80 strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler err viScanf...

Page 841: ...ar query char message 80 int data_length strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler data_length IEEEBLOCK_SPACE err viScanf vi b n data_length ieeebl...

Page 842: ...CCESS exit 1 VISA Example in Visual Basic To run this example in Visual Basic for Applications 1 Start the application that provides Visual Basic for Applications for example Microsoft Excel 2 Press A...

Page 843: ...ay DblArraySize As Double Declare fixed length string variable to hold string value returned by viVScanf viVQueryf Public strQueryResult As String 200 For Sleep subroutine Private Declare Sub Sleep Li...

Page 844: ...uto scale to automatically configure oscilloscope DoCommand AUToscale Set trigger mode EDGE PULSe PATTern etc and input source DoCommand TRIGger MODE EDGE Debug Print Trigger mode _ DoQueryString TRIG...

Page 845: ...Channel 1 vertical offset _ DoQueryString CHANnel1 OFFSet Set horizontal scale and position DoCommand TIMebase SCALe 0 0002 Debug Print Timebase scale _ DoQueryString TIMebase SCALe DoCommand TIMebase...

Page 846: ...DoQueryNumber MEASure VAMPlitude MsgBox Vertial amplitude vbCrLf _ FormatNumber dblQueryResult 4 V Download the screen image DoCommand HARDcopy INKSaver OFF Get screen image Dim lngBlockSize As Long...

Page 847: ...m FORMat Display the waveform settings Dim intFormat As Integer Dim intType As Integer Dim lngPoints As Long Dim lngCount As Long Dim dblXIncrement As Double Dim dblXOrigin As Double Dim lngXReference...

Page 848: ...rence _ FormatNumber lngXReference 0 Debug Print Waveform Y increment _ Format sngYIncrement Scientific Debug Print Waveform Y origin _ FormatNumber lngYOrigin 0 Debug Print Waveform Y reference _ For...

Page 849: ...nt lngBlockSize Dim strCommandAndLength As String strCommandAndLength command _ Format lngBlockSize b err viVPrintf vi strCommandAndLength vbLf paramsArray 1 If err VI_SUCCESS Then HandleVISAError vi...

Page 850: ...umber of elements array can hold retCount DblArraySize Read numbers err viVScanf vi lf vbLf paramsArray 0 If err VI_SUCCESS Then HandleVISAError vi retCount is now actual number of values returned by...

Page 851: ...anf vi t strErrVal Read Errnum Error String If err VI_SUCCESS Then HandleVISAError vi While Val strErrVal 0 End if find 0 No Error strOut strOut INST Error strErrVal err viVPrintf vi SYSTem ERRor vbLf...

Page 852: ...y not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Click Add and then click Add Existing Item c Navigate to the header file visa32 cs installed with Agilen...

Page 853: ...data Capture Analyze the captured waveform Analyze catch System ApplicationException err Console WriteLine VISA Error Message err Message catch System SystemException err Console WriteLine System Err...

Page 854: ...gger edge level 0 myScope DoQueryString TRIGger EDGE LEVel myScope DoCommand TRIGger EDGE SLOPe POSitive Console WriteLine Trigger edge slope 0 myScope DoQueryString TRIGger EDGE SLOPe Save oscillosco...

Page 855: ...Read setup string from file strPath c scope config setup stp DataArray File ReadAllBytes strPath Restore setup string nBytesWritten myScope DoCommandIEEEBlock SYSTem SETup DataArray Console WriteLine...

Page 856: ...e Waveform points mode 0 myScope DoQueryString WAVeform POINts MODE Get the number of waveform points available myScope DoCommand WAVeform POINts 10240 Console WriteLine Waveform points available 0 my...

Page 857: ...0 e fXincrement double fXorigin fResultsArray 5 Console WriteLine Waveform X origin 0 e fXorigin double fXreference fResultsArray 6 Console WriteLine Waveform X reference 0 e fXreference double fYincr...

Page 858: ...Address Save VISA addres in member variable m_strVisaAddress strVisaAddress Open the default VISA resource manager OpenResourceManager Open a VISA resource session OpenSession Clear the interface int...

Page 859: ...query VisaSendCommandOrQuery strQuery Get the result string StringBuilder strResults new StringBuilder 1000 strResults VisaGetResultString Check for inst errors CheckInstrumentErrors strQuery Return...

Page 860: ...e void VisaSendCommandOrQuery string strCommandOrQuery Send command or query to the device string strWithNewline strWithNewline String Format 0 n strCommandOrQuery int nViStatus nViStatus visa32 viPri...

Page 861: ...tsArray to 300 000 300kB length 300000 Read return value string from the device int nViStatus nViStatus visa32 viScanf m_nSession b ref length ResultsArray CheckVisaStatus nViStatus Write and read buf...

Page 862: ...ourceManager this m_strVisaAddress visa32 VI_NO_LOCK visa32 VI_TMO_IMMEDIATE out this m_nSession CheckVisaStatus nViStatus public void SetTimeoutSeconds int nSeconds int nViStatus nViStatus visa32 viS...

Page 863: ...gram Files IVI Foundation VISA WinNT include directory select it but do not click the Open button d Click the down arrow to the right of the Add button and choose Add as Link You should now see the fi...

Page 864: ...err Message End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub Initialize Dim strResults As StringBuilder Get and display the device s IDN string strResults myScope DoQuer...

Page 865: ...ate fStream Write ResultsArray 0 nLength fStream Close Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offset myScope DoCommand CHANnel1 S...

Page 866: ...measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNumber MEASu...

Page 867: ...form settings Dim fResultsArray As Double fResultsArray myScope DoQueryNumbers WAVeform PREamble Dim fFormat As Double fResultsArray 0 If fFormat 0 Then Console WriteLine Waveform format BYTE ElseIf f...

Page 868: ...file strPath c scope data waveform_data csv If File Exists strPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV f...

Page 869: ...nLength As Integer Dim nBytesWritten As Integer nLength DataArray Length strCommandAndLength String Format 0 8 1 D8 _ strCommand nLength Write first part of command to formatted I O write buffer nViSt...

Page 870: ...result string Dim fResultsArray As Double fResultsArray VisaGetResultNumbers Check for instrument errors another command and result CheckInstrumentErrors strQuery Return string results Return fResult...

Page 871: ...device Dim nViStatus As Integer nViStatus visa32 viScanf m_nSession lf fResults CheckVisaStatus nViStatus Return fResults End Function Private Function VisaGetResultNumbers As Double Dim fResultsArra...

Page 872: ...Then Console WriteLine ERROR s for command 0 _ strCommand bFirstError False End If Console Write strInstrumentError End If Loop While Not strInstrumentError ToString StartsWith 0 End Sub Private Sub O...

Page 873: ...ISA package to control Agilent oscilloscopes The Python language and PyVISA package can be downloaded from the web at http www python org and http pyvisa sourceforge net respectively To run this examp...

Page 874: ...ommand TRIGger EDGE SOURCe CHANnel1 qresult do_query_string TRIGger EDGE SOURce print Trigger edge source s qresult do_command TRIGger EDGE LEVel 1 5 qresult do_query_string TRIGger EDGE LEVel print T...

Page 875: ...up f open setup stp rb sSetup f read f close do_command SYSTem SETup 8 08d s len sSetup sSetup hide_param s True print Setup bytes restored d len sSetup Capture an acquisition using DIGitize do_comman...

Page 876: ...Choose the format of the data returned do_command WAVeform FORMat BYTE print Waveform format s do_query_string WAVeform FORMat Display the waveform settings from preamble wav_form_dict 0 BYTE 1 WORD 4...

Page 877: ...d len values Save waveform data values to CSV file f open waveform_data csv w for i in xrange 0 len values 1 time_val x_origin i x_increment voltage values i y_reference y_increment y_origin f write E...

Page 878: ...find 0 0 3 1 Not No error print ERROR s command s error_string command print Exited because of error sys exit 1 else No error break else SYSTem ERRor should always return string print ERROR SYSTem ERR...

Page 879: ...rammer s Guide 879 return sData Main program InfiniiVision visa instrument TCPIP0 130 29 70 139 inst0 INSTR InfiniiVision timeout 15 InfiniiVision term_chars InfiniiVision clear Initialize the oscillo...

Page 880: ...Project Properties In the Property Pages dialog update these project settings a Under Configuration Properties Linker Input add sicl32 lib to the Additional Dependencies field b Under Configuration Pr...

Page 881: ...mber void do_query_numbers char query Query for numbers int do_query_ieeeblock char query Query for IEEE block void check_instrument_errors Check for inst errors Global variables INST id Device sessio...

Page 882: ...t value for this session to 5 seconds itimeout id TIMEOUT Clear the interface iclear id Get and display the device s IDN string do_query_string IDN printf Oscilloscope IDN string s n str_result Clear...

Page 883: ...etup stp n Change settings with individual commands Set vertical scale and offset do_command CHANnel1 SCALe 0 05 do_query_string CHANnel1 SCALe printf Channel 1 vertical scale s n str_result do_comman...

Page 884: ...y_increment double y_origin double y_reference FILE fp int num_bytes Number of bytes returned from instrument int i Make a couple of measurements do_command MEASure SOURce CHANnel1 do_query_string MEA...

Page 885: ..._result Set the waveform source do_command WAVeform SOURce CHANnel1 do_query_string WAVeform SOURce printf Waveform source s n str_result Choose the format of the data returned WORD BYTE ASCII do_comm...

Page 886: ...f Waveform Y increment e n y_increment y_origin dbl_results 8 printf Waveform Y origin e n y_origin y_reference dbl_results 9 printf Waveform Y reference e n y_reference Read waveform data num_bytes d...

Page 887: ...data_length strcpy message command strcat message 8 08d iprintf id message num_bytes ifwrite id ieeeblock_data num_bytes 1 data_length check_instrument_errors return data_length Query for a string re...

Page 888: ...lock result int do_query_ieeeblock query char query char message 80 int data_length strcpy message query strcat message n iprintf id message data_length IEEEBLOCK_SPACE iscanf id b data_length ieeeblo...

Page 889: ...nt IO Libraries Suite and found in the Program Files Agilent IO Libraries Suite include directory select it and click Open 4 Choose Insert Module 5 Cut and paste the code that follows into the editor...

Page 890: ...m a known state Initialize Capture data Capture Analyze the captured waveform Analyze Close the vi session and the resource manager session Call iclose id Exit Sub ErrorHandler MsgBox Error Error vbEx...

Page 891: ...rce _ DoQueryString TRIGger EDGE SOURce DoCommand TRIGger EDGE LEVel 1 5 Debug Print Trigger edge level _ DoQueryString TRIGger EDGE LEVel DoCommand TRIGger EDGE SLOPe POSitive Debug Print Trigger edg...

Page 892: ...Timebase position _ DoQueryString TIMebase POSition Set the acquisition type NORMal PEAK AVERage or HRESolution DoCommand ACQuire TYPE NORMal Debug Print Acquire type _ DoQueryString ACQuire TYPE Or...

Page 893: ...the screen image DoCommand HARDcopy INKSaver OFF Get screen image Dim lngBlockSize As Long lngBlockSize DoQueryIEEEBlock_Bytes DISPlay DATA PNG COLor Debug Print Screen image bytes CStr lngBlockSize S...

Page 894: ...s As Long Dim lngCount As Long Dim dblXIncrement As Double Dim dblXOrigin As Double Dim lngXReference As Long Dim sngYIncrement As Single Dim sngYOrigin As Single Dim lngYReference As Long Preamble Do...

Page 895: ...mber sngYOrigin 0 Debug Print Waveform Y reference _ FormatNumber lngYReference 0 Get the waveform data Dim lngNumBytes As Long lngNumBytes DoQueryIEEEBlock_Bytes WAVeform DATA Debug Print Number of d...

Page 896: ...ors Exit Sub ErrorHandler MsgBox Error Error vbExclamation End End Sub Private Function DoCommandIEEEBlock command As String _ lngBlockSize As Long On Error GoTo ErrorHandler Send command part Call iv...

Page 897: ...e Function DoQueryNumber query As String As Double On Error GoTo ErrorHandler Dim dblResult As Double Call ivprintf id query vbLf Call ivscanf id lf vbLf dblResult DoQueryNumber dblResult CheckInstrum...

Page 898: ...ckLength As String strBlockLength Dim i As Integer For i 2 To intLengthDigits 1 strBlockLength strBlockLength Chr byteArray i Next Return number of bytes in block plus header DoQueryIEEEBlock_Bytes CL...

Page 899: ...Vision 2000 X Series Oscilloscopes Programmer s Guide 899 If Not strOut Then MsgBox strOut vbExclamation INST Error Messages Call iflush id I_BUF_READ Or I_BUF_WRITE End If Exit Sub ErrorHandler MsgBo...

Page 900: ...abVIEW Microsoft Excel Agilent VEE and Agilent SystemVue For more information on Agilent Command Expert and to download the software see http www agilent com find commandexpert SCPI NET Example in C o...

Page 901: ...gramming features of your Agilent oscilloscope using System using System IO using System Text using Agilent CommandExpert ScpiNet AgInfiniiVision2000X_01_20 namespace InfiniiVision class ScpiNetInstru...

Page 902: ...c void Initialize string strResults Get and display the device s IDN string myScope SCPI IDN Query out strResults Console WriteLine IDN result is 0 strResults Clear status and load the default setup m...

Page 903: ...sArray Console WriteLine Setup bytes saved 0 nLength Change settings with individual commands Set vertical scale and offset myScope SCPI CHANnel SCALe Command 1 0 05 myScope SCPI CHANnel SCALe Query 1...

Page 904: ...Quency Query CHANnel1 out fResult Console WriteLine Frequency 0 F4 kHz fResult 1000 Use direct command query when commands not in command set myScope Transport Command Invoke MEASure VAMPlitude CHANne...

Page 905: ...e WriteLine Waveform source 0 strResults Choose the format of the data returned WORD BYTE ASCII myScope SCPI WAVeform FORMat Command BYTE myScope SCPI WAVeform FORMat Query out strResults Console Writ...

Page 906: ...Scope SCPI WAVeform DATA QueryBYTE out byteResultsArray nLength byteResultsArray Length Console WriteLine Number of data values 0 nLength Set up output file strPath c scope data waveform_data csv if F...

Page 907: ...20 dll then click OK e Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment and choose Properties then select InfiniiV...

Page 908: ...System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message myScope Dispose Finally End Try End Sub Initialize the oscilloscope to a known state Private Shared Sub In...

Page 909: ...PI SYSTem SETup Query strResultsArray nLength strResultsArray Length Write setup string to file strPath c scope config setup stp File WriteAllLines strPath strResultsArray Console WriteLine Setup byte...

Page 910: ...I MEASure SOURce Query source1 source2 Console WriteLine Measure source 0 source1 myScope SCPI MEASure FREQuency Command CHANnel1 myScope SCPI MEASure FREQuency Query CHANnel1 fResult Console WriteLin...

Page 911: ...m FORMat Command BYTE myScope SCPI WAVeform FORMat Query strResults Console WriteLine Waveform format 0 strResults Display the waveform settings Dim nFormat As Integer nType As Integer nPoints As Inte...

Page 912: ...ut Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV format For i As Integer 0 To nLength 2 writer WriteLine 0 f9 1 f6 _ dblXorigin CSng i dblXincrement _ CSng byteResults...

Page 913: ...mand Expert ScpiNetDrivers import string Import NET modules from System import from System IO import from System Text import from System Runtime InteropServices import import clr clr AddReference AgIn...

Page 914: ...ommands Set vertical scale and offset scope SCPI CHANnel SCALe Command 1 0 05 qresult scope SCPI CHANnel SCALe Query 1 print Channel 1 vertical scale f qresult scope SCPI CHANnel OFFSet Command 1 1 5...

Page 915: ...I DISPlay DATA Query PNG COLor nLength len image_bytes fStream File Open screen_image png FileMode Create fStream Write image_bytes 0 nLength fStream Close print Screen image written to screen_image p...

Page 916: ...rence Get numeric values for later calculations x_increment scope SCPI WAVeform XINCrement Query x_origin scope SCPI WAVeform XORigin Query y_increment scope SCPI WAVeform YINCrement Query y_origin sc...

Page 917: ...cilloscopes Programmer s Guide 917 scope Transport DefaultTimeout Set 10000 Initialize the oscilloscope capture data and analyze initialize capture analyze print End of program Wait for a key press be...

Page 918: ...918 Agilent InfiniiVision 2000 X Series Oscilloscopes Programmer s Guide 38 Programming Examples...

Page 919: ...nalyzing captured data 51 angle brackets 118 annotate channels 225 annotation background display 254 annotation color display 255 annotation text display 256 annotation display 253 apply network print...

Page 920: ...ode AUToscale 154 code CHANnel n LABel 225 code CHANnel n PROBe 227 code CHANnel n RANGe 233 code DIGitize 160 code DISPlay DATA 258 code DISPlay LABel 259 code DISPlay ORDer 715 code MEASure PERiod 3...

Page 921: ...glitch trigger 615 digital channels 6 digital channels activity and logic levels on 151 digital channels groups of 411 412 414 digital pod stop displaying 158 digital reset conditions 137 571 DIGital...

Page 922: ...at 639 644 format for block data 131 format for hardcopy 720 format for image 431 format for waveform data 440 FormattedIO488 object 53 formfeed for hardcopy 296 300 formulas for data conversion 632 f...

Page 923: ...150 invert graticule colors for hardcopy 301 723 invert graticule colors for image 432 inverted masks bind levels 404 inverting input for channels 224 IO library referencing 52 IP address 42 IronPyth...

Page 924: ...rements show 360 measurements snapshot all 342 measurements source channel 361 measurements start marker time 729 measurements stop marker time 730 measurements thresholds 728 measurements time betwee...

Page 925: ...mation recall 421 path information save 437 pattern 473 474 475 pattern data LIN 489 pattern duration 609 610 pattern for pattern trigger 617 pattern format LIN 492 pattern length 466 491 PATTern trig...

Page 926: ...on 319 remove labels 259 remove message from display 566 reorder channels 153 repetitive acquisitions 176 report errors 567 report transition 363 365 reporting status 759 reporting the setup 590 reque...

Page 927: ...7 SPI decode bit order 495 SPI decode word width 508 SPI MISO data 653 SPI SEARch commands 555 SPI serial search data 557 SPI serial search data width 558 SPI serial search mode 556 SPI trigger 498 50...

Page 928: ...N pattern ID mode 468 trigger CAN sample point 459 trigger CAN signal baudrate 460 trigger CAN signal definition 461 trigger CAN source 462 trigger edge coupling 602 trigger edge level 603 trigger edg...

Page 929: ...T VISA example 863 Visual Basic 6 0 53 Visual Basic for Applications 52 800 Visual Basic SICL library example 889 Visual Basic VISA COM example 800 Visual Basic VISA example 842 voltage crossing repor...

Page 930: ...unctions 578 X increment 657 X origin 658 X reference 659 X Y mode 578 579 Y Y axis markers 318 Y cursor units 330 331 Y offset reference waveform 700 Y range reference waveform 701 Y scale reference...

Reviews:

No comments