manualshive.com logo in svg

Agilent Technologies InfiniiVision 3000 X-Series, Programmer'S Manual

Share
Download
Agilent Technologies InfiniiVision 3000 X-Series Programmer'S Manual Download Page 422

422

Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide

19

:MEASure Commands

 

•

":MEASure:PHASe" 

on page 411

Example Code

' MEASURE - The commands in the MEASURE subsystem are used to make

' measurements on displayed waveforms.

myScope.WriteString ":MEASURE:SOURCE CHANNEL1"

' Source to measure.

myScope.WriteString ":MEASURE:FREQUENCY?"

' Query for frequency.

varQueryResult = myScope.ReadNumber

' Read frequency.

MsgBox "Frequency:" + vbCrLf _

+ FormatNumber(varQueryResult / 1000, 4) + " kHz"

myScope.WriteString ":MEASURE:DUTYCYCLE?"

' Query for duty cycle.

varQueryResult = myScope.ReadNumber

' Read duty cycle.

MsgBox "Duty cycle:" + vbCrLf _

+ FormatNumber(varQueryResult, 3) + "%"

myScope.WriteString ":MEASURE:RISETIME?"

' Query for risetime.

varQueryResult = myScope.ReadNumber

' Read risetime.

MsgBox "Risetime:" + vbCrLf _

+ FormatNumber(varQueryResult * 1000000, 4) + " us"

myScope.WriteString ":MEASURE:VPP?"

' Query for Pk to Pk voltage.

varQueryResult = myScope.ReadNumber

' Read VPP.

MsgBox "Peak to peak voltage:" + vbCrLf _

+ FormatNumber(varQueryResult, 4) + " V"

myScope.WriteString ":MEASURE:VMAX?"

' Query for Vmax.

varQueryResult = myScope.ReadNumber

' Read Vmax.

MsgBox "Maximum voltage:" + vbCrLf _

+ FormatNumber(varQueryResult, 4) + " V"

See complete example programs at: 

Chapter 39

, “Programming Examples,” 

starting on page 1097

Summary of Contents for InfiniiVision 3000 X-Series

Page 1: ...s1 Agilent InfiniiVision 3000 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: ...53 describes commands defined by the IEEE 488 2 standard that are common to all instruments Chapter 6 Root Commands starting on page 179 describes commands that reside at the root level of the command...

Page 4: ...ion Commands starting on page 307 describes commands that control math waveforms Chapter 16 HARDcopy Commands starting on page 341 describes commands that set and query the selection of hardcopy devic...

Page 5: ...mmands starting on page 923 describes commands that provide access to waveform data Chapter 32 WGEN Commands starting on page 959 describes commands that control waveform generator Option WGN function...

Page 6: ...els Whenever a topic describes digital channels that information applies only to the mixed signal oscilloscope models See Also For more information on using the SICL VISA and VISA COM libraries in gen...

Page 7: ...at Introduction 40 Command Differences From 7000B Series Oscilloscopes 41 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 46 Step 2 Connect and set up the oscilloscope 47 Using the US...

Page 8: ...te Length Block Query Response Data 64 Sending Multiple Queries and Reading Results 65 Checking Instrument Status 66 Other Ways of Sending Commands 67 Telnet Sockets 67 Sending SCPI Commands Using Bro...

Page 9: ...vent Enable Register 193 MTERegister EVENt Mask Test Event Event Register 195 OPEE Operation Status Enable Register 197 OPERegister CONDition Operation Status Condition Register 199 OPERegister EVENt...

Page 10: ...E 245 CALibrate LABel 246 CALibrate OUTPut 247 CALibrate PROTected 248 CALibrate STARt 249 CALibrate STATus 250 CALibrate TEMPerature 251 CALibrate TIME 252 10 CHANnel n Commands CHANnel n BWLimit 256...

Page 11: ...tation 291 DISPlay ANNotation BACKground 292 DISPlay ANNotation COLor 293 DISPlay ANNotation TEXT 294 DISPlay CLEar 295 DISPlay DATA 296 DISPlay LABel 297 DISPlay LABList 298 DISPlay PERSistence 299 D...

Page 12: ...FUNCtion RANGe 333 FUNCtion REFerence 334 FUNCtion SCALe 335 FUNCtion SOURce1 336 FUNCtion SOURce2 338 FUNCtion TRENd MEASurement 339 16 HARDcopy Commands HARDcopy AREA 343 HARDcopy APRinter 344 HARDc...

Page 13: ...6 MARKer YUNits USE 377 19 MEASure Commands MEASure ALL 391 MEASure AREa 392 MEASure BWIDth 393 MEASure CLEar 394 MEASure COUNter 395 MEASure DEFine 396 MEASure DELay 399 MEASure DUTYcycle 401 MEASure...

Page 14: ...4 MEASure VBASe 435 MEASure VMAX 436 MEASure VMIN 437 MEASure VPP 438 MEASure VRATio 439 MEASure VRMS 440 MEASure VTIMe 441 MEASure VTOP 442 MEASure WINDow 443 MEASure XMAX 444 MEASure XMIN 445 20 MEA...

Page 15: ...MTESt ENABle 484 MTESt LOCK 485 MTESt RMODe 486 MTESt RMODe FACTion MEASure 487 MTESt RMODe FACTion PRINt 488 MTESt RMODe FACTion SAVE 489 MTESt RMODe FACTion STOP 490 MTESt RMODe SIGMa 491 MTESt RMO...

Page 16: ...f APPLy 530 POWer ONOFf EXIT 531 POWer ONOFf NEXT 532 POWer ONOFf TEST 533 POWer PSRR APPLy 534 POWer PSRR FREQuency MAXimum 535 POWer PSRR FREQuency MINimum 536 POWer PSRR RMAXimum 537 POWer QUALity...

Page 17: ...STARt 571 RECall WMEMory r STARt 572 25 SAVE Commands SAVE ARBitrary STARt 576 SAVE FILename 577 SAVE IMAGe STARt 578 SAVE IMAGe FACTors 579 SAVE IMAGe FORMat 580 SAVE IMAGe INKSaver 581 SAVE IMAGe PA...

Page 18: ...mmands 618 SBUS n CAN COUNt ERRor 620 SBUS n CAN COUNt OVERload 621 SBUS n CAN COUNt RESet 622 SBUS n CAN COUNt TOTal 623 SBUS n CAN COUNt UTILization 624 SBUS n CAN SAMPlepoint 625 SBUS n CAN SIGNal...

Page 19: ...660 SBUS n I2S SOURce DATA 661 SBUS n I2S SOURce WSELect 662 SBUS n I2S TRIGger 663 SBUS n I2S TRIGger AUDio 665 SBUS n I2S TRIGger PATTern DATA 666 SBUS n I2S TRIGger PATTern FORMat 668 SBUS n I2S T...

Page 20: ...SBUS n SPI FRAMing 709 SBUS n SPI SOURce CLOCk 710 SBUS n SPI SOURce DATA 711 SBUS n SPI SOURce FRAMe 712 SBUS n SPI SOURce MISO 713 SBUS n SPI SOURce MOSI 714 SBUS n SPI TRIGger PATTern MISO DATA 71...

Page 21: ...ch GLITch Commands 751 SEARch GLITch GREaterthan 752 SEARch GLITch LESSthan 753 SEARch GLITch POLarity 754 SEARch GLITch QUALifier 755 SEARch GLITch RANGe 756 SEARch GLITch SOURce 757 SEARch RUNT Comm...

Page 22: ...ial I2S PATTern DATA 789 SEARch SERial I2S PATTern FORMat 790 SEARch SERial I2S RANGe 791 SEARch SERial IIC Commands 792 SEARch SERial IIC MODE 793 SEARch SERial IIC PATTern ADDRess 795 SEARch SERial...

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

Page 24: ...Tch GREaterthan 874 TRIGger GLITch LESSthan 875 TRIGger GLITch LEVel 876 TRIGger GLITch POLarity 877 TRIGger GLITch QUALifier 878 TRIGger GLITch RANGe 879 TRIGger GLITch SOURce 880 TRIGger OR Commands...

Page 25: ...TRIGger TV UDTV ENUMber 914 TRIGger TV UDTV HSYNc 915 TRIGger TV UDTV HTIMe 916 TRIGger TV UDTV PGTHan 917 TRIGger USB Commands 918 TRIGger USB SOURce DMINus 919 TRIGger USB SOURce DPLus 920 TRIGger U...

Page 26: ...TORe 968 WGEN FREQuency 969 WGEN FUNCtion 970 WGEN FUNCtion PULSe WIDTh 973 WGEN FUNCtion RAMP SYMMetry 974 WGEN FUNCtion SQUare DCYCle 975 WGEN MODulation NOISe 976 WGEN OUTPut 977 WGEN OUTPut LOAD 9...

Page 27: ...er 1016 MEASure LOWer 1017 MEASure SCRatch 1018 MEASure TDELta 1019 MEASure THResholds 1020 MEASure TMAX 1021 MEASure TMIN 1022 MEASure TSTArt 1023 MEASure TSTOp 1024 MEASure TVOLt 1025 MEASure UPPer...

Page 28: ...68 Operation Status Condition Register OPERegister CONDition 1069 Arm Event Register AER 1070 Overload Event Register OVLRegister 1071 Mask Test Event Event Register MTERegister EVENt 1072 Power Event...

Page 29: ...ential 1096 39 Programming Examples VISA COM Examples 1098 VISA COM Example in Visual Basic 1098 VISA COM Example in C 1107 VISA COM Example in Visual Basic NET 1116 VISA COM Example in Python for NET...

Page 30: ...30 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide...

Page 31: ...loscopes Programmer s Guide 1 What s New What s New in Version 2 10 32 What s New in Version 2 00 33 What s New in Version 1 20 37 What s New in Version 1 10 39 Version 1 00 at Introduction 40 Command...

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

Page 33: ...for the Chart Logic Bus State operation Available with the DSOX3ADVMATH advanced math license FUNCtion BUS SLOPe see page 313 Specifies the clock signal edge for the Chart Logic Bus State operation A...

Page 34: ...ter see page 208 For enabling bits in the Power Event Enable Register This status register control is available when the DSOX3PWR power measurements and analysis application is licensed PWRRegister EV...

Page 35: ...ense TRIGger TV UDTV PGTHan see page 917 Specifies the greater than the sync pulse width time in the Generic video trigger Available with the DSOX3VID extended Video triggering license WGEN ARBitrary...

Page 36: ...NCtion SOURce1 see page 336 The BUS m source is now available for the bus charting operations available with the DSOX3ADVMATH advanced math measurements license SBUS n MODE see page 599 The A429 M1553...

Page 37: ...and Description FUNCtion INTegrate IOFFset see page 327 Lets you enter a DC offset correction factor for the integrate math waveform input signal to level a ramp ed waveform FUNCtion FFT VTYPe see pag...

Page 38: ...igger edge slope for the Edge Then Edge trigger TRIGger DELay TRIGger SOURce see page 860 Specifies the trigger edge source for the Edge Then Edge trigger TRIGger FORCe see page 846 Now documented thi...

Page 39: ...InfiniiVision 3000 X Series oscilloscope software appear below New Commands Command Description SYSTem PRESet see page 824 Now documented this command is equivalent to the front panel Default Setup k...

Page 40: ...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 41: ...lace of trace memory Multiple serial decode waveforms Serial decode now available on 2 channel oscilloscopes Enhanced set of trigger types Additional measurements Different path name format for intern...

Page 42: ...ns that are in the 7000B Series oscilloscope s TRIGger IIC subsystem SBUS n LIN Commands see page 683 This subsystem contains commands functions that are in the 7000B Series oscilloscope s TRIGger LIN...

Page 43: ...gnal can be a trigger output mask test failure or waveform generator sync pulse DISPlay DATA see page 296 Monochrome TIFF images of the graticule cannot be saved or restored DISPlay LABList see page 2...

Page 44: ...a switch DISPlay SOURce PMEMory pixel memory locations are not present EXTernal IMPedance External TRIG IN connector is now fixed at 1 MOhm EXTernal PROBe ID Not supported on external TRIG IN connect...

Page 45: ...t IO Libraries Suite software 46 Step 2 Connect and set up the oscilloscope 47 Step 3 Verify the oscilloscope connection 49 This chapter explains how to install the Agilent IO Libraries Suite software...

Page 46: ...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 47: ...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 48: ...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 49: ...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 50: ...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 51: ...es Oscilloscopes Programmer s Guide 51 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 52: ...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 53: ...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 54: ...54 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 2 Setting Up...

Page 55: ...programming the 3000 X Series oscilloscopes It describes basic oscilloscope program structure and shows how to program the oscilloscope using a few simple examples The getting started examples show ho...

Page 56: ...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 57: ...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 58: ...umeric Variables on page 64 Reading Definite Length Block Query Response Data on page 64 Sending Multiple Queries and Reading Results on page 65 Checking Instrument Status on page 66 Referencing the I...

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

Page 60: ...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 61: ...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 62: ...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 63: ...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 64: ...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 65: ...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 66: ...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 67: ...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 68: ...68 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 3 Getting Started...

Page 69: ...s1 69 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference Command Summary 70 Syntax Elements 149...

Page 70: ...ARKer Commands Summary see page 89 MEASure Commands Summary see page 90 MTESt Commands Summary see page 100 POD n Commands Summary see page 102 POWer Commands Summary see page 103 RECall Commands Summ...

Page 71: ...e 130 SEARch SERial UART Commands Summary see page 131 SYSTem Commands Summary see page 131 TIMebase Commands Summary see page 132 General TRIGger Commands Summary see page 133 TRIGger DELay Commands...

Page 72: ...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 160 status 0 to 255 an integer in NR1 format n a IDN see page 160 AGILENT TECHNOLOGIES...

Page 73: ...rved I2S Serial reserved reserved Waveform Generator reserved reserved All field 0 All reserved 0 MSO 0 MSO Memory 0 MEMUP Low Speed Serial 0 EMBD Automotive Serial 0 AUTO Power Measurements 0 PWR RS...

Page 74: ...Trigger n a STB see page 174 value 0 to 255 an integer in NR1 format as shown in the following Bit Weight Name 1 Indicates 7 128 OPER Operation status condition occurred 6 64 RQS Instrument is MSS req...

Page 75: ...models source CHANnel n DIGital d POD1 POD2 for MSO models source can be repeated up to 5 times n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format AUToscale AMODE value see p...

Page 76: ...it integer in NR1 format OPEE n see page 197 OPEE see page 198 n 15 bit integer in NR1 format n a OPERregister CONDiti on see page 199 n 15 bit integer in NR1 format n a OPERegister EVENt see page 201...

Page 77: ...ERial see page 212 return value unquoted string containing serial number SINGle see page 213 n a n a n a STATus display see page 214 0 1 display CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH SBUS...

Page 78: ...e 226 ACQuire SEGMented CO UNt see page 226 count an integer from 2 to 1000 in NR1 format with Option SGM ACQuire SEGMented IN Dex index see page 227 ACQuire SEGMented IN Dex see page 227 index an int...

Page 79: ...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 80: ...1 n 1 to analog channels in NR1 format CHANnel n COUPling coupling see page 257 CHANnel n COUPling see page 257 coupling AC DC n 1 to analog channels in NR1 format CHANnel n DISPlay 0 OFF 1 ON see pa...

Page 81: ...Nnel n PROBe STY Pe signal type see page 267 CHANnel n PROBe STY Pe see page 267 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 268 CHANnel n PROTe...

Page 82: ...0 to 360 in NR3 format DEMO OUTPut 0 OFF 1 ON see page 279 DEMO OUTPut see page 279 0 1 Table 9 DIGital d Commands Summary Command Query Options and Query Returns DIGital d DISPlay 0 OFF 1 ON see page...

Page 83: ...ge 291 DISPlay ANNotation see page 291 0 1 DISPlay ANNotation B ACKground mode see page 292 DISPlay ANNotation B ACKground see page 292 mode OPAQue INVerted TRANsparent DISPlay ANNotation C OLor color...

Page 84: ...uation see page 303 EXTernal PROBe see page 303 attenuation probe attenuation ratio in NR3 format EXTernal RANGe range suffix see page 304 EXTernal RANGe see page 304 range vertical full scale range v...

Page 85: ...320 FUNCtion FFT VTYPe see page 320 units DECibel VRMS FUNCtion FFT WINDo w window see page 321 FUNCtion FFT WINDo w see page 321 window RECTangular HANNing FLATtop BHARris FUNCtion FREQuency H IGHpas...

Page 86: ...ation see page 332 operation ADD SUBTract MULTiply INTegrate DIFF FFT SQRT MAGNify ABSolute SQUare LN LOG EXP TEN LOWPass HIGHpass DIVide LINear TRENd BTIMing BSTate FUNCtion RANGe range see page 333...

Page 87: ...Tio PERiod FREQuency PWIDth NWIDth DUTYcycle RISetime FALLtime Table 12 FUNCtion Commands Summary continued Command Query Options and Query Returns Table 13 HARDcopy Commands Summary Command Query Opt...

Page 88: ...SLO T see page 353 slot NET0 NET1 HARDcopy NETWork USE Rname username see page 354 HARDcopy NETWork USE Rname see page 354 username quoted ASCII string HARDcopy PALette palette see page 355 HARDcopy P...

Page 89: ...in NR3 format suffix s ms us ns ps Hz kHz MHz return_value X1 cursor position value in NR3 format MARKer X1Y1source source see page 367 MARKer X1Y1source see page 367 source CHANnel n FUNCtion MATH W...

Page 90: ...RKer YUNits mode see page 376 MARKer YUNits see page 376 units BASE PERCent MARKer YUNits USE see page 377 n a n a Table 15 MARKer Commands Summary continued Command Query Options and Query Returns Ta...

Page 91: ...Lay see page 397 delay spec edge_spec1 edge_spec2 edge_spec1 slope occurrence edge_spec2 slope occurrence slope occurrence integer MEASure DEFine THResholds threshold spec see page 396 MEASure DEFine...

Page 92: ...402 source CHANnel n FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital c...

Page 93: ...nel n FUNCtion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital channels 1 in NR1...

Page 94: ...age 411 source1 2 CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value the phase angle value in degrees in NR3 format MEASure PPULses source see page...

Page 95: ...esult_list see page 415 result_list comma separated list of measurement results MEASure RISetime source see page 418 MEASure RISetime source see page 418 source CHANnel n FUNCtion MATH WMEMory r n 1 t...

Page 96: ...s type see page 423 MEASure STATistics see page 423 type ON 1 CURRent MEAN MINimum MAXimum STDDev COUNt ON all statistics returned MEASure STATistics D ISPlay 0 OFF 1 ON see page 424 MEASure STATistic...

Page 97: ...format return_value time in seconds of the specified transition n a MEASure TVALue value slope occurrence source see page 431 value voltage level that the waveform must cross slope direction of the w...

Page 98: ...ge in NR3 format MEASure VBASe source see page 435 MEASure VBASe source see page 435 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format base_voltage volt...

Page 99: ...the ratio value in dB in NR3 format MEASure VRMS interval type source see page 440 MEASure VRMS interval type source see page 440 interval CYCLe DISPlay type AC DC source CHANnel n FUNCtion MATH WMEM...

Page 100: ...at return_value horizontal value of the maximum in NR3 format MEASure XMIN source see page 445 MEASure XMIN source see page 445 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 f...

Page 101: ...MTESt DATA mask see page 482 MTESt DATA see page 482 mask data in IEEE 488 2 format MTESt DELete see page 483 n a n a MTESt ENABle 0 OFF 1 ON see page 484 MTESt ENABle see page 484 0 1 MTESt LOCK 0 O...

Page 102: ...1 value in NR3 format MTESt SCALe XDELta xdelta_value see page 496 MTESt SCALe XDELta see page 496 xdelta_value X delta value in NR3 format MTESt SCALe Y1 y1_value see page 497 MTESt SCALe Y1 see page...

Page 103: ...e page 512 n a n a POWer ENABle 0 OFF 1 ON see page 513 POWer ENABle see page 513 0 1 POWer HARMonics APPL y see page 514 n a n a n a POWer HARMonics DATA see page 515 binary_block comma separated dat...

Page 104: ...lation TYP E see page 529 modulation VAVerage ACRMs VRATio PERiod FREQuency PWIDith NWIDth DUTYcycle RISetime FALLtime POWer ONOFf APPLy see page 530 n a n a POWer ONOFf EXIT see page 531 n a n a POWe...

Page 105: ...IEXPec ted value suffix see page 544 POWer SIGNals IEXPec ted see page 544 value Expected current value in NR3 format suffix A mA POWer SIGNals OVERsh oot percent see page 545 POWer SIGNals OVERsh oo...

Page 106: ...Wer SWITch RDS see page 556 value Rds on value in NR3 format suffix OHM mOHM POWer SWITch VCE value suffix see page 557 POWer SWITch VCE see page 557 value Vce sat value in NR3 format suffix V mV POWe...

Page 107: ...e_name see page 568 RECall FILename see page 568 base_name quoted ASCII string RECall MASK STARt file_spec see page 569 n a file_spec internal_loc file_name internal_loc 0 3 an integer in NR1 format f...

Page 108: ...1 ON see page 579 SAVE IMAGe FACTors see page 579 0 1 SAVE IMAGe FORMat format see page 580 SAVE IMAGe FORMat see page 580 format BMP BMP24bit BMP8bit PNG NONE SAVE IMAGe INKSaver 0 OFF 1 ON see page...

Page 109: ...gth 100 to max length an integer in NR1 format SAVE WAVeform LENGth MAX 0 OFF 1 ON see page 591 SAVE WAVeform LENGth MAX see page 591 0 1 SAVE WAVeform SEGMen ted option see page 592 SAVE WAVeform SEG...

Page 110: ...SBUS n A429 BASE base see page 603 SBUS n A429 BASE see page 603 base BINary HEX n a SBUS n A429 COUNt E RRor see page 604 error_count integer in NR1 format SBUS n A429 COUNt R ESet see page 605 n a...

Page 111: ...Tern SDI see page 613 string nn where n 0 1 X length always 2 bits SBUS n A429 TRIGger PATTern SSM string see page 614 SBUS n A429 TRIGger PATTern SSM see page 614 string nn where n 0 1 X length alway...

Page 112: ...Nal B AUDrate see page 626 baudrate integer from 10000 to 4000000 in 100 b s increments or 5000000 SBUS n CAN SIGNal D EFinition value see page 627 SBUS n CAN SIGNal D EFinition see page 627 value CAN...

Page 113: ...To setup see page 637 n a n a SBUS n FLEXray BAUD rate baudrate see page 638 SBUS n FLEXray BAUD rate see page 638 baudrate 2500000 5000000 10000000 SBUS n FLEXray CHAN nel channel see page 639 SBUS n...

Page 114: ...le_count_base integer from 0 63 SBUS n FLEXray TRIG ger FRAMe CCRepetitio n cycle_count_repetiti on see page 651 SBUS n FLEXray TRIG ger FRAMe CCRepetitio n see page 651 cycle_count_repetition ALL rep...

Page 115: ...n I2S SOURce D ATA see page 661 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 I...

Page 116: ...e 668 base BINary HEX DECimal SBUS n I2S TRIGger RANGe lower upper see page 669 SBUS n I2S TRIGger RANGe see page 669 lower 32 bit integer in signed decimal nondecimal or string upper 32 bit integer i...

Page 117: ...IGital 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 value see page 677 SBUS n IIC TRIGger PATTern ADDRess see page 6...

Page 118: ...688 SBUS n LIN SOURce see page 688 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...

Page 119: ...y continued Command Query Options and Query Returns Table 29 SBUS n M1553 Commands Summary Command Query Options and Query Returns SBUS n M1553 AUTose tup see page 698 n a n a SBUS n M1553 BASE base s...

Page 120: ...CHIPselect NCHipselect NOTC TIMeout SBUS n SPI SOURce C LOCk source see page 710 SBUS n SPI SOURce C LOCk see page 710 value CHANnel n EXTernal for the DSO models value CHANnel n DIGital d for the MS...

Page 121: ...SPI TRIGger PATTern MISO DATA see page 715 string nn n where n 0 1 X string 0xnn n where n 0 9 A F X SBUS n SPI TRIGger PATTern MISO WIDTh width see page 716 SBUS n SPI TRIGger PATTern MISO WIDTh see...

Page 122: ...SBUS n UART COUNt R XFRames see page 729 frame_count integer in NR1 format n a SBUS n UART COUNt T XFRames see page 730 frame_count integer in NR1 format SBUS n UART FRAMing value see page 731 SBUS n...

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

Page 124: ...er SEARch EDGE SOURce source see page 750 SEARch EDGE SOURce see page 750 source CHANnel n n 1 to analog channels in NR1 format Table 34 SEARch GLITch Commands Summary Command Query Options and Query...

Page 125: ...nd Query Returns SEARch RUNT POLarity polarity see page 759 SEARch RUNT POLarity see page 759 polarity POSitive NEGative EITHer SEARch RUNT QUALifie r qualifier see page 760 SEARch RUNT QUALifie r see...

Page 126: ...429 L ABel value see page 769 SEARch SERial A429 L ABel see page 769 value 8 bit integer in decimal hex octal or string from 0 255 hex Hnn where n 0 9 A F octal Qnnn where n 0 7 string 0xnn where n 0...

Page 127: ...0xnn n where n 0 9 A F X for hexadecimal SEARch SERial CAN PA TTern ID MODE value see page 779 SEARch SERial CAN PA TTern ID MODE see page 779 value STANdard EXTended Table 39 SEARch SERial FLEXray C...

Page 128: ...A F X when base HEX SEARch SERial I2S PA TTern FORMat base see page 790 SEARch SERial I2S PA TTern FORMat see page 790 base BINary HEX DECimal SEARch SERial I2S RA NGe lower upper see page 791 SEARch...

Page 129: ...uery Returns Table 42 SEARch SERial LIN Commands Summary Command Query Options and Query Returns SEARch SERial LIN ID value see page 800 SEARch SERial LIN ID see page 800 value 7 bit integer in decima...

Page 130: ...CSTArt RTA RTA11 PERRor SERRor MERRor SEARch SERial M1553 PATTern DATA string see page 807 SEARch SERial M1553 PATTern DATA see page 807 string nn n where n 0 1 SEARch SERial M1553 RTA value see page...

Page 131: ...1 RD0 RDX TDATa TD1 TD0 TDX PARityerror AERRor SEARch SERial UART Q UALifier value see page 816 SEARch SERial UART Q UALifier see page 816 value EQUal NOTequal GREaterthan LESSthan Table 46 SYSTem Com...

Page 132: ...IMebase MODE value see page 833 TIMebase MODE see page 833 value MAIN WINDow XY ROLL TIMebase POSition pos see page 834 TIMebase POSition see page 834 pos time from the trigger event to the display re...

Page 133: ...n a TRIGger HFReject 0 OFF 1 ON see page 847 TRIGger HFReject see page 847 0 1 TRIGger HOLDoff holdoff_time see page 848 TRIGger HOLDoff see page 848 holdoff_time 60 ns to 10 s in NR3 format TRIGger L...

Page 134: ...ELay ARM SO URce source see page 856 TRIGger DELay ARM SO URce see page 856 source CHANnel n DIGital d n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format TRIGger DELay TDELay...

Page 135: ...st SOURc e see page 865 source CHANnel n DIGital d n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format Table 51 TRIGger EDGE Commands Summary Command Query Options and Query R...

Page 136: ...rce CHANnel n DIGital d EXTernal LINE WGEN for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format Table 51 TRIGger EDGE Commands Summary continued Command Quer...

Page 137: ...ger GLITch POLar ity polarity see page 877 TRIGger GLITch POLar ity see page 877 polarity POSitive NEGative TRIGger GLITch QUALi fier qualifier see page 878 TRIGger GLITch QUALi fier see page 878 qual...

Page 138: ...PATTern see page 885 string 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...

Page 139: ...ns TRIGger RUNT POLarit y polarity see page 893 TRIGger RUNT POLarit y see page 893 polarity POSitive NEGative EITHer TRIGger RUNT QUALifi er qualifier see page 894 TRIGger RUNT QUALifi er see page 89...

Page 140: ...tion Commands Summary Command Query Options and Query Returns TRIGger TRANsition Q UALifier qualifier see page 904 TRIGger TRANsition Q UALifier see page 904 qualifier GREaterthan LESSthan TRIGger TRA...

Page 141: ...0L60HZ P480 P720L60HZ P720 P1080L24HZ P1080 P1080L25HZ P1080L50HZ P1080L60HZ I1080L50HZ I1080 I1080L60HZ with extended video triggering license TRIGger TV UDTV ENUM ber count see page 914 TRIGger TV U...

Page 142: ...ee page 920 TRIGger USB SOURce D PLus see page 920 source CHANnel n EXTernal for the DSO models source CHANnel n DIGital d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channe...

Page 143: ...the actual data WAVeform FORMat value see page 935 WAVeform FORMat see page 935 value WORD BYTE ASCII WAVeform POINts points see page 936 WAVeform POINts see page 936 points 100 250 500 1000 points_m...

Page 144: ...age 943 count an integer from 2 to 1000 in NR1 format with Option SGM n a WAVeform SEGMented T TAG see page 944 time_tag in NR3 format with Option SGM WAVeform SOURce source see page 945 WAVeform SOUR...

Page 145: ...rigin in the current preamble in NR3 format n a WAVeform YREFerence see page 958 return_value y reference value in the current preamble in NR1 format Table 60 WAVeform Commands Summary continued Comma...

Page 146: ...al see page 970 WGEN FUNCtion see page 972 signal SINusoid SQUare RAMP PULSe NOISe DC SINC EXPRise EXPFall CARDiac GAUSsian ARBitrary WGEN FUNCtion PULSe WIDTh width see page 973 WGEN FUNCtion PULSe W...

Page 147: ...offset offset in volts in NR3 format Table 61 WGEN Commands Summary continued Command Query Options and Query Returns Table 62 WMEMory r Commands Summary Command Query Options and Query Returns WMEMor...

Page 148: ...n NR3 format suffix V mV WMEMory r YRANge range suffix see page 993 WMEMory r YRANge see page 993 r 1 2 in NR1 format range vertical full scale range value in NR3 format suffix V mV WMEMory r YSCale s...

Page 149: ...th Block Response Data on page 150 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 150: ...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 151: ...ilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 151 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 152: ...152 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference...

Page 153: ...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 160 status 0 to 255 an int...

Page 154: ...I2S Serial reserved reserved Waveform Generator reserved reserved All field 0 All reserved 0 MSO 0 MSO Memory 0 MEMUP Low Speed Serial 0 EMBD Automotive Serial 0 AUTO Power Measurements 0 PWR RS 232...

Page 155: ...e 173 mask sum of all bits that are set 0 to 255 an integer in NR1 format mask following values Bit Weight Name Enables 7 128 OPER Operation Status Reg 6 64 Not used 5 32 ESB Event Status Bit 4 16 MAV...

Page 156: ...contrast if a root level command or some other subsystem command is within the program message you must re enter the original subsystem after the command For example the program message ACQuire TYPE...

Page 157: ...rror queue and the Request for OPC flag See Also Introduction to Common Commands on page 155 STB Read Status Byte on page 174 ESE Standard Event Status Enable on page 158 ESR Standard Event Status Reg...

Page 158: ...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 159: ...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 155 E...

Page 160: ...NR1 format Table 65 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...

Page 161: ...161 See Also Introduction to Common Commands on page 155 ESE Standard Event Status Enable on page 158 OPC Operation Complete on page 164 CLS Clear Status on page 157 SYSTem ERRor on page 821 NOTE Rea...

Page 162: ...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 163: ...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 164: ...ster 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 t...

Page 165: ...232 UART Serial Segmented Memory Mask Test reserved Bandwidth reserved reserved reserved I2S Serial reserved Educator s Kit Waveform Generator MIL 1553 ARINC 429 Serial Extended Video Advanced Math r...

Page 166: ...SO field indicates whether the unit is a mixed signal oscilloscope The OPT query returns the following See Also Introduction to Common Commands on page 155 IDN Identification Number on page 162 Module...

Page 167: ...Programmer s Guide 167 RCL Recall see page 1088 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 168: ...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 command Reset...

Page 169: ...ld TTL 1 4V Display Menu Persistence Off Grid 33 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 170: ...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 171: ...Save see page 1088 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 172: ...uest Enable Register contains a mask value for the bits to be enabled in the Status Byte Register A one in the Service Request Enable Register enables the corresponding bit in the Status Byte Register...

Page 173: ...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 174: ...it 6 instead of the RQS request service bit The MSS indicates whether or not the device has at least one reason for requesting service Return Format value NL value 0 255 an integer in NR1 format From...

Page 175: ...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 176: ...mer s Guide 5 Common Commands TRG Trigger see page 1088 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 177: ...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 troubleshooti...

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

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

Page 180: ...source CHANnel n DIGital d POD 1 2 BUS 1 2 FUNCtion MATH SBUS 1 2 for MSO models source can be repeated up to 5 times n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format MTEen...

Page 181: ...a options print option print option print option COLor GRAYscale PRINter0 BMP8bit BMP PNG NOFactors FACTors print option can be repeated up to 5 times PWRenable n see page 208 PWRenable see page 208...

Page 182: ...ardless of current command tree position After executing a root level command the parser is positioned at the root of the command tree n a TER see page 216 0 1 VIEW source see page 217 n a source CHAN...

Page 183: ...er in NR1 format bit 0 DIGital 0 bit 15 DIGital 15 See Also Introduction to Root Commands on page 182 POD n THReshold on page 505 DIGital d THReshold on page 287 NOTE Because the ACTivity query return...

Page 184: ...on 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 Servic...

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

Page 186: ...Root Commands on page 182 AUToscale CHANnels on page 188 AUToscale AMODE on page 187 Example Code AUTOSCALE This command evaluates all the input signals and sets the correct conditions to display all...

Page 187: ...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 188: ...elected 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 tur...

Page 189: ...g 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 maint...

Page 190: ...el digital 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 182 DISPlay CLEar on page 295 CHANnel n DISPl...

Page 191: ...trument 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 channe...

Page 192: ...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 39 Programmin...

Page 193: ...e register as an integer number Return Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 182 AER Arm Event Register on page 184 Table 69 Mask Test Event Enable...

Page 194: ...t Commands CHANnel n PROTection on page 268 OPERegister EVENt Operation Status Event Register on page 201 OVLenable Overload Event Enable Register on page 203 OVLRegister Overload Event Register on pa...

Page 195: ...peration Status Condition Register on page 199 OVLenable Overload Event Enable Register on page 203 OVLRegister Overload Event Register on page 205 Table 70 Mask Test Event Event Register Bit Name Des...

Page 196: ...196 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 6 Root Commands STB Read Status Byte on page 174 SRE Service Request Enable on page 172...

Page 197: ...overload occurs 10 Not used 9 MTE Mask Test Event Event when mask test event occurs 8 Not used 7 PWR Power Event A power measurements application event has occurred 6 Not used 5 Wait Trig Wait Trig E...

Page 198: ...number Return Format value NL value integer in NR1 format See Also Introduction to Root Commands on page 182 AER Arm Event Register on page 184 CHANnel n PROTection on page 268 OPERegister EVENt Opera...

Page 199: ...Mask Test Event A mask test event has occurred 8 Not used 7 PWR Power Event A power measurements application event has occurred 6 Not used 5 Wait Trig Wait Trig The trigger is armed set by the Trigge...

Page 200: ...n Status Enable Register on page 197 OPERegister EVENt Operation Status Event Register on page 201 OVLenable Overload Event Enable Register on page 203 OVLRegister Overload Event Register on page 205...

Page 201: ...rred 8 Not used 7 PWR Power Event A power measurements application event has occurred 6 Not used 5 Wait Trig Wait Trig The trigger is armed set by the Trigger Armed Event Register TER 4 Not used 3 Run...

Page 202: ...E Operation Status Enable Register on page 197 OPERegister CONDition Operation Status Condition Register on page 199 OVLenable Overload Event Enable Register on page 203 OVLRegister Overload Event Reg...

Page 203: ...d 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 74 Overload Event Enable Regist...

Page 204: ...Tection on page 268 OPEE Operation Status Enable Register on page 197 OPERegister CONDition Operation Status Condition Register on page 199 OPERegister EVENt Operation Status Event Register on page 20...

Page 205: ...l trigger input impedance to 50 Table 75 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 206: ...value integer in NR1 format See Also Introduction to Root Commands on page 182 CHANnel n PROTection on page 268 OPEE Operation Status Enable Register on page 197 OVLenable Overload Event Enable Regis...

Page 207: ...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 valu...

Page 208: ...1 format See Also Introduction to Root Commands on page 182 AER Arm Event Register on page 184 CHANnel n PROTection on page 268 OPERegister EVENt Operation Status Event Register on page 201 OVLenable...

Page 209: ...Root Commands 6 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 209 STB Read Status Byte on page 174 SRE Service Request Enable on page 172...

Page 210: ...on Status Condition Register on page 199 OVLenable Overload Event Enable Register on page 203 OVLRegister Overload Event Register on page 205 STB Read Status Byte on page 174 SRE Service Request Enabl...

Page 211: ...lso Introduction to Root Commands on page 182 SINGle on page 213 STOP on page 215 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform display STO...

Page 212: ...es Oscilloscopes Programmer s Guide 6 Root Commands SERial see page 1088 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also Intr...

Page 213: ...Guide 213 SINGle see page 1088 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 214: ...he MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The STATus query reports whether the channel function or serial decode bus specified by source is displayed R...

Page 215: ...s Guide 215 STOP see page 1088 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 216: ...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 217: ...unction or serial decode bus See Also Introduction to Root Commands on page 182 BLANk on page 190 CHANnel n DISPlay on page 258 DIGital d DISPlay on page 283 FUNCtion DISPlay on page 317 POD n DISPlay...

Page 218: ...218 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 6 Root Commands...

Page 219: ...ACQuire COUNt count see page 222 ACQuire COUNt see page 222 count an integer from 2 to 65536 in NR1 format ACQuire MODE mode see page 223 ACQuire MODE see page 223 mode RTIMe SEGMented n a ACQuire POI...

Page 220: ...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 221: ...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 222: ...ny 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 223: ...nd 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 mo...

Page 224: ...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 225: ...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 an...

Page 226: ...ed by the WAVeform SEGMented COUNt query The maximum number of segments may be limited by the memory depth of your oscilloscope For example an oscilloscope with 1M memory allows a maximum of 250 segme...

Page 227: ...ag 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 oscill...

Page 228: ...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 229: ...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 230: ...page 1088 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_r...

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

Page 232: ...19 ACQuire COUNt on page 222 ACQuire MODE on page 223 DIGitize on page 191 WAVeform FORMat on page 935 WAVeform TYPE on page 950 WAVeform PREamble on page 940 Example Code AQUIRE_TYPE Sets the acquisi...

Page 233: ...n BIT m 0 OFF 1 ON see page 235 BUS n BIT m see page 235 0 1 n 1 or 2 an integer in NR1 format m 0 15 an integer in NR1 format BUS n BITS channel_list 0 OFF 1 ON see page 236 BUS n BITS see page 236...

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

Page 235: ...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 15 correspond to DIGital0 15 Query Syntax BUS...

Page 236: ...s 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 for...

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

Page 238: ...uffix 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 o...

Page 239: ...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 240: ...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 241: ...he 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 242: ...242 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 8 BUS n Commands...

Page 243: ...month day all in NR1 format CALibrate LABel string see page 246 CALibrate LABel see page 246 string quoted ASCII string up to 32 characters CALibrate OUTPut signal see page 247 CALibrate OUTPut see pa...

Page 244: ...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 245: ...copes Programmer s Guide 245 CALibrate DATE see page 1088 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 246: ...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 247: ...lure 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 source of the TRIG OUT...

Page 248: ...uery 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...

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

Page 250: ...8 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 251: ...erature see page 1088 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 252: ...Guide 9 CALibrate Commands CALibrate TIME see page 1088 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 253: ...8 CHANnel n DISPlay see page 258 0 1 n 1 to analog channels in NR1 format CHANnel n IMPedance impedance see page 259 CHANnel n IMPedance see page 259 impedance ONEMeg FIFTy n 1 to analog channels in N...

Page 254: ...267 CHANnel n PROBe STY Pe see page 267 signal type DIFFerential SINGle n 1 to analog channels in NR1 format CHANnel n PROTectio n see page 268 CHANnel n PROTectio n see page 268 NORM TRIP n 1 to anal...

Page 255: ...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 256: ...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 257: ...alog 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 COUPl...

Page 258: ...1 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 speci...

Page 259: ...NR1 format The CHANnel n IMPedance command selects the input impedance setting for the specified analog channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n IM...

Page 260: ...analog 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 Sy...

Page 261: ...g NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 254 DISPlay LABel on page 297 DIGital d LABel on page 284 DISPlay LABList on page 298 BUS n LABel on page 240 Exampl...

Page 262: ...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 263: ...er levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting to set the oscilloscope to an attenuation value other than the...

Page 264: ...D12 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 PROB...

Page 265: ...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 va...

Page 266: ...d 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 267: ...es 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 co...

Page 268: ...the overload protection It allows the channel to be used again in 50 mode after the signal that caused the overload has been removed from the channel input Reset the analog channel input impedance to...

Page 269: ...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 270: ...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 271: ...connected probe Select VOLT for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measurement units you select Query Synt...

Page 272: ...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 Th...

Page 273: ...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 FUNC SIN OUTP 0 Table 82 DEMO Commands Summ...

Page 274: ...V offset 1 kHz sine wave 2 4 Vpp 0 0 V offset phase shifted by the amount entered using the DEMO FUNCtion PHASe PHASe on page 278 command RINGing 500 kHz digital pulse 3 Vpp 1 5 V offset and 500 ns p...

Page 275: ...set Data signal 3 5 Vpp 1 75 V offset LFSine 30 Hz sine wave 2 7 Vpp 0 V offset with very narrow glitch near each positive peak Off FMBurst FM burst modulated from 100 kHz to 1 MHz 5 0 Vpp 600 mV offs...

Page 276: ...ernally routed to digital channels D7 through D9 D9 SDATA TTL level with standard alignment internally routed to digital input D8 SCLK TTL level internally routed to digital input D7 WS TTL level low...

Page 277: ...on 3000 X Series Oscilloscopes Programmer s Guide 277 signal SIN NOIS PHAS RING SINGl AM CLK GLIT BURS MSO RUNT TRAN RFB SHOL LFS FMB ETE CAN LIN UART I2C SPI I2S CANL ARIN FLEX MIL MIL2 See Also Intr...

Page 278: ...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 279: ...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 280: ...280 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 11 DEMO Commands...

Page 281: ...ABel see page 284 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 285 DIGital d POSition see p...

Page 282: ...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 283: ...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 Retu...

Page 284: ...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 stri...

Page 285: ...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 286: ...ls 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 DIGita...

Page 287: ...mand 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 thresh...

Page 288: ...288 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 12 DIGital d Commands...

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

Page 290: ...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 291: ...he 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 T...

Page 292: ...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 ANNot...

Page 293: ...otation 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...

Page 294: ...tation string Use DISPlay ANNotation TEXT to remotely clear the annotation text Two sets of quote marks without a space between them creates a NULL string Query Syntax DISPlay ANNotation TEXT The DISP...

Page 295: ...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 296: ...on to DISPlay Commands on page 290 HARDcopy INKSaver on page 347 PRINt on page 207 RCL Recall on page 167 SAV Save on page 171 VIEW on page 217 Example Code IMAGE_TRANSFER In this example we will quer...

Page 297: ...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 298: ...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 299: ...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 300: ...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 301: ...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 302: ...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 303: ...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 304: ...using 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 EXTerna...

Page 305: ...T 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 CHAN...

Page 306: ...306 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 14 EXTernal Trigger Commands...

Page 307: ...ve EITHer FUNCtion BUS YINCrem ent value see page 314 FUNCtion BUS YINCrem ent see page 314 value value per bus code in NR3 format FUNCtion BUS YORigin value see page 315 FUNCtion BUS YORigin see page...

Page 308: ...Rce 1 source see page 325 FUNCtion GOFT SOURce 1 see page 325 source CHANnel n n 1 2 3 4 for 4ch models n 1 2 for 2ch models FUNCtion GOFT SOURce 2 source see page 326 FUNCtion GOFT SOURce 2 see page...

Page 309: ...range for the DIFF function is 80E 3 to 8 0E12 depends on current sweep speed The range for the FFT function is 8 to 800 dBV FUNCtion REFerence level see page 334 FUNCtion REFerence see page 334 level...

Page 310: ...from volts to decibel dB SQRT Square root Transforms operate on a single analog channel source or on a g t function that is the addition subtraction or multiplication of analog channel sources specif...

Page 311: ...T commands TRENd Measurement trend Operates on a single analog channel source The TRENd MEASurement command selects the measurement whose trend you want to measure BTIMing Chart logic bus timing Opera...

Page 312: ...NR1 format The FUNCtion BUS CLOCk command selects the clock signal source for the Chart Logic Bus State operation This command is available with the DSOX3ADVMATH advanced math license Query Syntax FUN...

Page 313: ...ive POSitive EITHer The FUNCtion BUS SLOPe command specifies the clock signal edge for the Chart Logic Bus State operation This command is available with the DSOX3ADVMATH advanced math license Query S...

Page 314: ...UNCtion BUS YINCrement command specifies the value associated with each increment in Chart Logic Bus data This command is available with the DSOX3ADVMATH advanced math license Query Syntax FUNCtion BU...

Page 315: ...format The FUNCtion BUS YORigin command specifies the value associated with Chart Logic Bus data equal to zero This command is available with the DSOX3ADVMATH advanced math license Query Syntax FUNCti...

Page 316: ...s VOLT AMPere NONE The FUNCtion BUS YUNits command specifies the vertical units for the Chart Logic Bus operations This command is available with the DSOX3ADVMATH advanced math license Query Syntax FU...

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

Page 318: ...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 319: ...icule 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 frequenc...

Page 320: ...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 321: ...oothly 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 ther...

Page 322: ...on FREQuency HIGHpass command sets the high pass filter s 3 dB cutoff frequency The high pass filter is a single pole high pass filter This command is available with the DSOX3ADVMATH advanced math lic...

Page 323: ...ion FREQuency LOWPass command sets the low pass filter s 3 dB cutoff frequency The low pass filter is a 4th order Bessel Thompson filter This command is available with the DSOX3ADVMATH advanced math l...

Page 324: ...form or filter functions if available ADD Source1 source2 SUBTract Source1 source2 MULTiply Source1 source2 The FUNCtion GOFT SOURce1 and FUNCtion GOFT SOURce2 commands are used to select source1 and...

Page 325: ...the first input channel for the g t source that can be used as the input to transform or filter functions if available Query Syntax FUNCtion GOFT SOURce1 The FUNCtion GOFT SOURce1 query returns the cu...

Page 326: ...ts the second input channel for the g t source that can be used as the input to transform or filter functions if available Query Syntax FUNCtion GOFT SOURce2 The FUNCtion GOFT SOURce2 query returns th...

Page 327: ...Tegrate IOFFset command lets you enter a DC offset correction factor for the integrate math waveform input signal This DC offset correction lets you level a ramp ed waveform Query Syntax FUNCtion INTe...

Page 328: ...value A in Ax B value in NR3 format The FUNCtion LINear GAIN command specifies the A value in the Ax B operation This command is available with the DSOX3ADVMATH advanced math license Query Syntax FUN...

Page 329: ...alue B in Ax B value in NR3 format The FUNCtion LINear OFFSet command specifies the B value in the Ax B operation This command is available with the DSOX3ADVMATH advanced math license Query Syntax FUN...

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

Page 331: ...ute Absolute value of the selected waveform source SQUare Square of the selected waveform source LN Natural logarithm on the selected waveform source LOG Common logarithm on the selected waveform sour...

Page 332: ...The FUNCtion OPERation query returns the current operation for the selected function Return Format operation NL operation ADD SUBT MULT INT DIFF FFT SQRT MAGN ABS SQU LN LOG EXP TEN LOWP HIGH DIV LIN...

Page 333: ...s 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 rang...

Page 334: ...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 335: ...dB The FUNCtion SCALe command sets the vertical scale or units per division of the selected function Legal values for the scale depend on the selected function Query Syntax FUNCtion SCALe The FUNCtion...

Page 336: ...310 The GOFT parameter 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 OPERa...

Page 337: ...FUNCtion Commands 15 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 337 FUNCtion GOFT SOURce2 on page 326...

Page 338: ...command specifies the first source The FUNCtion SOURce2 setting is not used for the transform functions filter functions or visualization functions except when the measurement trend visualization s m...

Page 339: ...NWIDth DUTYcycle RISetime FALLtime The FUNCtion TRENd MEASurement command selects the measurement whose trend is shown in the math waveform This command is available with the DSOX3ADVMATH advanced mat...

Page 340: ...340 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 15 FUNCtion Commands...

Page 341: ...ex name index integer index of printer in list name name of printer in list HARDcopy FACTors 0 OFF 1 ON see page 345 HARDcopy FACTors see page 345 0 1 HARDcopy FFEed 0 OFF 1 ON see page 346 HARDcopy F...

Page 342: ...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 352 n a password quoted ASCII string HARDcopy NETWork SLO T slot see...

Page 343: ...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 344: ...x 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...

Page 345: ...he 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...

Page 346: ...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 347: ...ontrols 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 348: ...e 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 Al...

Page 349: ...at 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 NETW...

Page 350: ...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 342 HARDcopy NETWork SLOT on pa...

Page 351: ...he 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...

Page 352: ...e 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 Introducti...

Page 353: ...dress 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 Retur...

Page 354: ...e 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 u...

Page 355: ...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 356: ...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 357: ...Syntax HARDcopy STARt The HARDcopy STARt command starts a print job See Also Introduction to HARDcopy Commands on page 342 HARDcopy APRinter on page 344 HARDcopy PRINter LIST on page 356 HARDcopy FAC...

Page 358: ...358 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 16 HARDcopy Commands...

Page 359: ...return data from the Lister display Table 88 LISTer Commands Summary Command Query Options and Query Returns n a LISTer DATA see page 360 binary_block comma separated data with newlines at the end of...

Page 360: ...age 1088 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 361: ...y 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 b...

Page 362: ...REFerence 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 363: ...x s ms us ns ps Hz kHz MHz return_value X1 cursor position value in NR3 format MARKer X1Y1source source see page 367 MARKer X1Y1source see page 367 source CHANnel n FUNCtion MATH WMEMory r n 1 to anal...

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

Page 365: ...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 366: ...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 367: ...ne 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 s...

Page 368: ...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 369: ...ne 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 s...

Page 370: ...s 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 364 MARKer MODE on page 365 MARKer X1Position on pag...

Page 371: ...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 372: ...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 373: ...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 374: ...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 375: ...MARKer YUNits command Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 364 MARKer MODE on page 365 MARKer X1Y1source on page 367 MARKer X2Y...

Page 376: ...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 377: ...nd 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 relativ...

Page 378: ...378 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 18 MARKer Commands...

Page 379: ...WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value area in volt seconds NR3 format MEASure BWIDth source see page 393 MEASure BWIDth source see page 393 source CHANnel n...

Page 380: ...rce1 source2 see page 399 MEASure DELay source1 source2 see page 399 source1 2 CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value floating point nu...

Page 381: ...tion MATH WMEMory r for DSO models source CHANnel n DIGital d FUNCtion MATH WMEMory r for MSO models n 1 to analog channels in NR1 format r 1 2 in NR1 format d 0 to digital channels 1 in NR1 format re...

Page 382: ...channels in NR1 format r 1 2 in NR1 format return_value the percent of the overshoot of the selected waveform in NR3 format MEASure PEDGes source see page 409 MEASure PEDGes source see page 409 sourc...

Page 383: ...Shoot source see page 413 MEASure PREShoot source see page 413 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value the percent of preshoot of...

Page 384: ...ee page 420 MEASure SHOW see page 420 1 MEASure SOURce source1 source2 see page 421 MEASure SOURce see page 421 source1 2 CHANnel n FUNCtion MATH WMEMory r EXTernal for DSO models source1 2 CHANnel n...

Page 385: ...MEASure STATistics R SDeviation see page 428 0 1 n a MEASure TEDGe slope occurrence source see page 429 slope direction of the waveform occurrence the transition to be reported source CHANnel n FUNCt...

Page 386: ...page 433 MEASure VAMPlitude source see page 433 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 387: ...438 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value voltage peak to peak of the selected waveform in NR3 format MEASure VRATio interval s...

Page 388: ...urce see page 442 MEASure VTOP source see page 442 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...

Page 389: ...ment is an average and there are not three edges the oscilloscope will revert to the mode of making the measurement at the start of the main sweep When the command form is used the measurement result...

Page 390: ...Vision 3000 X Series Oscilloscopes Programmer s Guide 19 MEASure Commands The following is a sample response from the MEASure query In this case the query was issued following a RST command MEAS SOUR...

Page 391: ...iniiVision 3000 X Series Oscilloscopes Programmer s Guide 391 MEASure ALL see page 1088 Command Syntax MEASure ALL This command installs a Snapshot All measurement on the screen See Also Introduction...

Page 392: ...ments show the area between the waveform and the ground level The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is not sp...

Page 393: ...n If the optional source parameter is not specified the current measurement source is used Query Syntax MEASure BWIDth source The MEASure BWIDth query measures and returns the width of the burst on th...

Page 394: ...Oscilloscopes Programmer s Guide 19 MEASure Commands MEASure CLEar see page 1088 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Introd...

Page 395: ...ly adjusted to be 100 ms or twice the current time window whichever is longer up to 1 second The counter measurement can measure frequencies up to 125 MHz The minimum frequency supported is 1 2 X gate...

Page 396: ...dentifies 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 val...

Page 397: ...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 398: ...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 399: ...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 lowe...

Page 400: ...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 401: ...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 402: ...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 403: ...ified 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 tim...

Page 404: ...mmand installs a falling edge count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure NEDGes source The MEASure NEDGes query m...

Page 405: ...mand installs a falling pulse count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure NPULses source The MEASure NPULses query...

Page 406: ...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 407: ...max 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...

Page 408: ...408 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 19 MEASure Commands MEASure VTOP on page 442 MEASure VBASe on page 435 MEASure VMIN on page 437...

Page 409: ...command installs a rising edge count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure PEDGes source The MEASure NEDGes query...

Page 410: ...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 411: ...ween 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...

Page 412: ...mmand installs a rising pulse count measurement on screen If the optional source parameter is not specified the current source is measured Query Syntax MEASure PPULses source The MEASure PPULses query...

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

Page 414: ...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 415: ...e count for any of the measurements is 0 the value of infinity 9 9E 37 is returned for the min max mean and standard deviation Return Format result_list NL result_list comma separated list of measurem...

Page 416: ...ncy MeasurementArray 1 DUTYcycle MeasurementArray 2 VAMPlitude MeasurementArray 3 VPP Dim Measurement As Variant For Each Measurement In MeasurementArray myScope WriteString MEASure Measurement myScop...

Page 417: ...All statistics For Each ValueColumn In ValueColumnArray If VarType ResultsList intCounter vbString Then Debug Print Measure statistics result CH1 _ Measurement ValueColumn _ FormatNumber ResultsList i...

Page 418: ...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 419: ...ecified the current source is modified Query Syntax MEASure SDEViation source The MEASure SDEViation query measures and outputs the std deviation of the selected waveform The oscilloscope computes the...

Page 420: ...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 421: ...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 422: ...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 423: ...formation returned by the MEASure RESults query ON means all the statistics are on Query Syntax MEASure STATistics The MEASure STATistics query returns the current statistics mode Return Format type N...

Page 424: ...of the measurement statistics Query Syntax MEASure STATistics DISPlay The MEASure STATistics DISPlay query returns the state of the measurement statistics display Return Format 0 1 NL See Also Introd...

Page 425: ...nd lets you for example gather statistics over multiple pulses captured in a single acquisition To do this change the horizontal position and enter the command for each new pulse that is measured This...

Page 426: ...used when calculating measurement statistics Query Syntax MEASure STATistics MCOunt The MEASure STATistics MCOunt query returns the current measurement statistics max count setting Return Format setti...

Page 427: ...ESet This command resets the measurement statistics zeroing the counts Note that the measurement statistics configuration is not deleted See Also Introduction to MEASure Commands on page 388 MEASure S...

Page 428: ...at is standard deviation mean in the measurement statistics Query Syntax MEASure STATistics RSDeviation The MEASure STATistics RSDeviation query returns the current relative standard deviation setting...

Page 429: ...lope 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...

Page 430: ...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 431: ...ed 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 ed...

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

Page 433: ...he 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 434: ...he optional 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 interva...

Page 435: ...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 436: ...ment 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 o...

Page 437: ...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 438: ...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 439: ...source1 to that of source2 expressed in dB The interval option lets you specify the measurement interval either an integral number of cycles or the full screen If interval is not specified DISPlay is...

Page 440: ...ral number 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...

Page 441: ...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 reference...

Page 442: ...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 443: ...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 444: ...ndow If the optional source parameter is specified the current source is modified Query Syntax MEASure XMAX source The MEASure XMAX query measures and returns the horizontal axis value at which the ma...

Page 445: ...indow If the optional source parameter is specified the current source is modified Query Syntax MEASure XMIN source The MEASure XMIN query measures and returns the horizontal axis value at which the m...

Page 446: ...446 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 19 MEASure Commands...

Page 447: ...MEASure APParent source1 source2 see page 451 MEASure APParent source1 source2 see page 451 source1 source2 CHANnel n n 1 to analog channels in NR1 format return_value the apparent power value in NR3...

Page 448: ...1 to analog channels in NR1 format return_value the time in seconds in NR3 format MEASure OPOWer see page 459 MEASure OPOWer see page 459 return_value the output power value in NR3 format MEASure PCUR...

Page 449: ...PPle source see page 464 source CHANnel n FUNCtion MATH WMEMory r n 1 to analog channels in NR1 format r 1 2 in NR1 format return_value the output ripple value in NR3 format MEASure TRESponse source s...

Page 450: ...o be specified by the MEASure SOURce command Phase angle is a measure of power quality In the power triangle the right triangle where apparent_power2 real_power2 reactive_power2 phase angle is the ang...

Page 451: ...and the source2 parameter is the channel probing current These sources can also be specified by the MEASure SOURce command Apparent power is a measure of power quality It is the portion of AC line po...

Page 452: ...t or voltage This source can also be specified by the MEASure SOURce command Crest factor is a measure of power quality It is the ratio between the instantaneous peak AC line current or voltage requir...

Page 453: ...nt output voltage and output current using the POWer SIGNals SOURce VOLTage i and POWer SIGNals SOURce CURRent i commands and you must perform the automated signals setup using the POWer SIGNals AUTos...

Page 454: ...y loss measurement on screen The source parameter is typically a math multiply waveform or other waveform that represents power voltage current This source can also be specified by the MEASure SOURce...

Page 455: ...ing voltage and the source2 parameter is the channel probing current These sources can also be specified by the MEASure SOURce command Power factor is a measure of power quality It is the ratio of the...

Page 456: ...voltage and output current using the POWer SIGNals SOURce VOLTage i and POWer SIGNals SOURce CURRent i commands and you must perform the automated signals setup using the POWer SIGNals AUTosetup EFFic...

Page 457: ...he input AC Voltage last falls to 10 of its maximum amplitude to the time when the output DC Voltage last falls to 10 of its maximum amplitude The source1 parameter is the AC Voltage and the source2 p...

Page 458: ...he input AC Voltage first rises to 10 of its maximum amplitude to the time when the output DC Voltage rises to 90 of its maximum amplitude The source1 parameter is the AC Voltage and the source2 param...

Page 459: ...voltage and output current using the POWer SIGNals SOURce VOLTage i and POWer SIGNals SOURce CURRent i commands and you must perform the automated signals setup using the POWer SIGNals AUTosetup EFFic...

Page 460: ...and installs a peak current measurement on screen The source parameter is the channel probing the current This source can also be specified by the MEASure SOURce command This command measures the peak...

Page 461: ...power loss measurement on screen The source parameter is typically a math multiply waveform or other waveform that represents power voltage current This source can also be specified by the MEASure SOU...

Page 462: ...t These sources can also be specified by the MEASure SOURce command Reactive power is a measure of power quality It is the difference between apparent power and real power due to reactance Using the p...

Page 463: ...other waveform that represents power voltage current This source can also be specified by the MEASure SOURce command Real power is a measure of power quality It is the portion of power flow that avera...

Page 464: ...MEASure RIPPle command installs an output ripple measurement on screen The source parameter is the channel probing the output voltage This source can also be specified by the MEASure SOURce command Ou...

Page 465: ...obing the output voltage This source can also be specified by the MEASure SOURce command Transient response time t2 t1 where t1 The first time a voltage waveform exits the settling band t2 The last ti...

Page 466: ...466 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 20 MEASure Power Commands...

Page 467: ...els n 1 2 for 2ch models MTESt AMASk UNITs units see page 475 MTESt AMASk UNITs see page 475 units CURRent DIVisions MTESt AMASk XDELta value see page 476 MTESt AMASk XDELta see page 476 value X delta...

Page 468: ...CTion SAVE 0 OFF 1 ON see page 489 MTESt RMODe FACTion SAVE see page 489 0 1 MTESt RMODe FACTion STOP 0 OFF 1 ON see page 490 MTESt RMODe FACTion STOP see page 490 0 1 MTESt RMODe SIGMa level see page...

Page 469: ...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 470: ...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 471: ...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 472: ...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 473: ...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 474: ...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 475: ...subsystem uses the graticule as the measurement system so tolerance settings are specified as parts of a screen division The mask test subsystem maintains separate XDELta and YDELta settings for CURRe...

Page 476: ...tting 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 delt...

Page 477: ...or 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 valu...

Page 478: ...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 479: ...Guide 479 MTESt COUNt RESet see page 1088 Command Syntax MTESt COUNt RESet The MTESt COUNt RESet command resets the mask statistics See Also Introduction to MTESt Commands on page 469 MTESt COUNt WAVe...

Page 480: ...t 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 4...

Page 481: ...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 482: ...2 format The MTESt DATA command loads a mask from binary block data Query Syntax MTESt DATA The MTESt DATA query returns a mask in binary block data format The format for the data transmission is the...

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

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

Page 485: ...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 no...

Page 486: ...page 491 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 492 command WAVeforms the mask test runs until a fixed number of waveforms...

Page 487: ...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 488: ...starting on page 341 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 489: ...5 SAVE Commands starting on page 573 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 490: ...ailure 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 S...

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

Page 492: ...6400 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 r...

Page 493: ...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 494: ...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 495: ...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 496: ...s 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 polygo...

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

Page 498: ...aries 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 499: ...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 configu...

Page 500: ...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 load...

Page 501: ...ion for the POD subsystem Return Format The following is a sample response from the POD1 query In this case the query was issued following a RST command Table 93 POD n Commands Summary Command Query O...

Page 502: ...502 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 22 POD Commands POD1 DISP 0 THR 1 40E 00...

Page 503: ...ommand POD1 D0 D7 POD2 D8 D15 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 set...

Page 504: ...MEDium LARGe The POD n SIZE command specifies the size of digital channels on the display Sizes are set for all pods Therefore if you set the size on pod 1 for example the same size is set on pod 2 as...

Page 505: ...ow below the threshold 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...

Page 506: ...7 to CMOS threshold myScope WriteString POD1 THRESHOLD CMOS Set channels 8 15 to 2 0 volts myScope WriteString POD2 THRESHOLD 2 0 Set external channel to TTL threshold short form myScope WriteString...

Page 507: ...page 514 n a n a n a POWer HARMonics DATA see page 515 binary_block comma separated data with newlines at the end of each row POWer HARMonics DISP lay display see page 516 POWer HARMonics DISP lay see...

Page 508: ...n TYP E see page 529 modulation VAVerage ACRMs VRATio PERiod FREQuency PWIDith NWIDth DUTYcycle RISetime FALLtime POWer ONOFf APPLy see page 530 n a n a POWer ONOFf EXIT see page 531 n a n a POWer ONO...

Page 509: ...Pec ted value suffix see page 544 POWer SIGNals IEXPec ted see page 544 value Expected current value in NR3 format suffix A mA POWer SIGNals OVERsh oot percent see page 545 POWer SIGNals OVERsh oot se...

Page 510: ...SWITch RDS see page 556 value Rds on value in NR3 format suffix OHM mOHM POWer SWITch VCE value suffix see page 557 POWer SWITch VCE see page 557 value Vce sat value in NR3 format suffix V mV POWer SW...

Page 511: ...VOLTage1 and POWer SIGNals SOURce CURRent1 commands The deskew values are saved in the oscilloscope until a factory default or secure erase is performed The next time you run the Power Application yo...

Page 512: ...nd applies the effieciency power analysis Efficiency analysis tests the overall efficiency of the power supply by measuring the output power over the input power See Also MEASure EFFiciency on page 45...

Page 513: ...8 Command Syntax POWer ENABle 0 OFF 1 ON The POWer ENABle command enables or disables power analysis Query Syntax POWer ENABle The POWer ENABle query returns a 1 or a 0 showing whether power analysis...

Page 514: ...to the supply grid and cause problems with other devices on the grid Use the Current Harmonics analysis to test a switching power supply s current harmonics to pre compliance standard of IEC61000 3 2...

Page 515: ...table data Return Format binary_block comma separated data with newlines at the end of each row See Also POWer HARMonics APPLy on page 514 POWer HARMonics DISPlay on page 516 POWer HARMonics FAILcoun...

Page 516: ...Harmonics measurement results are not displayed Query Syntax POWer HARMonics DISPlay The POWer HARMonics DISPlay query returns the display setting Return Format display NL display TABL BAR OFF See Al...

Page 517: ...rmonics values not specified by the selected standard are not counted Return Format count NL count integer in NR1 format See Also POWer HARMonics RUNCount on page 520 POWer HARMonics APPLy on page 514...

Page 518: ...Hz F60 60 Hz F400 400 Hz Query Syntax POWer HARMonics LINE The POWer HARMonics LINE query returns the line frequency setting Return Format frequency NL frequency F50 F60 F400 See Also POWer HARMonics...

Page 519: ...or for IEC 61000 3 2 Standard Class C power factor value Return Format value Class C power factor in NR3 format See Also POWer HARMonics APPLy on page 514 POWer HARMonics DATA on page 515 POWer HARMon...

Page 520: ...harmonics values not specified by the selected standard are not counted Return Format count NL count integer in NR1 format See Also POWer HARMonics FAILcount on page 517 POWer HARMonics APPLy on page...

Page 521: ...e tools C IEC 61000 3 2 Class C for lighting equipment D IEC 61000 3 2 Class D for equipment having a specified power according less than or equal to 600 W of the following types personal computers an...

Page 522: ...ass fail status of the current harmonics analysis Return Format status PASS FAIL UNTested See Also POWer HARMonics RUNCount on page 520 POWer HARMonics FAILcount on page 517 POWer HARMonics APPLy on p...

Page 523: ...esults of the current harmonics analysis Return Format value Total Harmonics Distortion in NR3 format See Also POWer HARMonics APPLy on page 514 POWer HARMonics DATA on page 515 POWer HARMonics DISPla...

Page 524: ...8 Command Syntax POWer INRush APPLy The POWer INRush APPLy command applies the inrush current analysis The Inrush current analysis measures the peak inrush current of the power supply when the power s...

Page 525: ...EXIT see page 1088 Command Syntax POWer INRush EXIT The POWer INRush EXIT command exits stops the inrush current power analysis This command is equivalent to pressing the Exit softkey on the oscillosc...

Page 526: ...ge 1088 Command Syntax POWer INRush NEXT The POWer INRush NEXT command goes to the next step of the inrush current analysis This command is equivalent to pressing the Next softkey on the oscilloscope...

Page 527: ...trol pulse signal to a switching device MOSFET and observes the trending of the pulse width duty cycle period frequency etc of the control pulse signal See Also POWer MODulation SOURce on page 528 POW...

Page 528: ...e V I The POWer MODulation SOURce command selects either the voltage source or the current source as the source for the modulation analysis Query Syntax POWer MODulation SOURce The POWer MODulation SO...

Page 529: ...ive pulse width NWIDth negative pulse width DUTYcycle RISetime FALLtime Query Syntax POWer MODulation TYPE The POWer MODulation TYPE query returns the modulation type setting Return Format modulation...

Page 530: ...1088 Command Syntax POWer ONOFf APPLy The POWer ONOFf APPLy command applies the selected turn on off analysis test POWer ONOFf TEST See Also POWer SIGNals VSTeady on page 547 MEASure ONTime on page 4...

Page 531: ...88 Command Syntax POWer ONOFf EXIT The POWer ONOFf EXIT command exits stops the turn on time turn off time analysis This command is equivalent to pressing the Exit softkey on the oscilloscope front pa...

Page 532: ...d Syntax POWer ONOFf NEXT The POWer ONOFf NEXT command goes to the next step of the turn on turn off analysis This command is equivalent to pressing the Next softkey on the oscilloscope front panel wh...

Page 533: ...med ON Turn On measures the time taken to get the output voltage of the power supply after the input voltage is applied OFF Turn Off measures the time taken for the output voltage of the power supply...

Page 534: ...ne how well a voltage regulator rejects ripple noise over different frequency range This analysis provides a signal from the oscilloscope s waveform generator that sweeps its frequency This signal is...

Page 535: ...mum command sets the end sweep frequency value The PSRR measurement is displayed on a log scale so you can select from decade values in addition to the maximum frequency of 20 MHz Query Syntax POWer P...

Page 536: ...POWer PSRR FREQuency MINimum command sets the start sweep frequency value The measurement is displayed on a log scale so you can select from decade values Query Syntax POWer PSRR FREQuency MINimum The...

Page 537: ...1 format The POWer PSRR RMAXimum command specifies the vertical scale of the PSRR math waveform Query Syntax POWer PSRR RMAXimum The POWer PSRR RMAXimum query returns the currently specified maximum r...

Page 538: ...into and back out of the load without delivering energy This current called reactive or harmonic current gives rise to an apparent power which is larger than the actual power consumed Power quality is...

Page 539: ...ower The difference between apparent power and real power due to reactance CRESt Crest Factor Crest factor is the ratio between the instantaneous peak current voltage required by the load and the RMS...

Page 540: ...X Series Oscilloscopes Programmer s Guide 23 POWer Commands POWer RIPPle APPLy see page 1088 Command Syntax POWer RIPPle APPLy The POWer RIPPle APPLy command applies the output ripple analysis See Al...

Page 541: ...ype of power analysis See Also POWer HARMonics DISPlay on page 516 POWer EFFiciency APPLy on page 512 POWer RIPPle APPLy on page 540 POWer MODulation APPLy on page 527 POWer QUALity APPLy on page 538...

Page 542: ...Nals CYCLes The POWer SIGNals CYCLes query returns the number of cycles currently set Return Format count NL count integer in NR1 format See Also POWer HARMonics DISPlay on page 516 POWer QUALity APPL...

Page 543: ...nd Output Ripple Query Syntax POWer SIGNals DURation The POWer SIGNals DURation query returns the set duration time value Return Format value NL value value in NR3 format See Also POWer EFFiciency APP...

Page 544: ...al scale of the channel probing current Query Syntax POWer SIGNals IEXPected The POWer SIGNals IEXPected query returns the expected inrush current setting Return Format value NL value Expected current...

Page 545: ...ient response and to adjust the vertical scale of the oscilloscope Query Syntax POWer SIGNals OVERshoot The POWer SIGNals OVERshoot query returns the overshoot percent setting Return Format percent NL...

Page 546: ...r the Inrush Current and Turn On Off Time types of power analysis Query Syntax POWer SIGNals VMAXimum The POWer SIGNals VMAXimum query returns the expected maximum input voltage setting Return Format...

Page 547: ...the transient response and to adjust the vertical scale of the oscilloscope Query Syntax POWer SIGNals VSTeady The POWer SIGNals VSTeady query returns the expected steady state voltage setting Return...

Page 548: ...source channel to be used in the power analysis Query Syntax POWer SIGNals SOURce CURRent i The POWer SIGNals SOURce CURRent i query returns the current source channel setting Return Format source NL...

Page 549: ...e source channel to be used in the power analysis Query Syntax POWer SIGNals SOURce VOLTage i The POWer SIGNals SOURce VOLTage i query returns the voltage source channel setting Return Format source N...

Page 550: ...scilloscopes Programmer s Guide 23 POWer Commands POWer SLEW APPLy see page 1088 Command Syntax POWer SLEW APPLy The POWer SLEW APPLy command applies the slew rate analysis See Also POWer SLEW SOURce...

Page 551: ...urce source V I The POWer SLEW SOURce command selects either the voltage source or the current source as the source for the slew rate analysis Query Syntax POWer SLEW SOURce The POWer SLEW SOURce quer...

Page 552: ...ands POWer SLEW VALue see page 1088 Query Syntax POWer SLEW VALue The POWer SLEW VALue query returns the slew rate dV dt or dI dt value depending on the selected slew source Return Format value slew r...

Page 553: ...Wer SWITch APPLy command applies the switching loss analysis using the conduction calculation method V reference and I reference settings See Also POWer SWITch CONDuction on page 554 POWer SWITch IREF...

Page 554: ...using the POWer SWITch RDS command In the Off Zone where the current level is below I Ref the Power calculation is P 0 Watt VCE Vce sat The Power waveform includes error correction In the On Zone whe...

Page 555: ...switch current You can adjust this value to ignore noise floors or null offset that is difficult to eliminate in current probes This value specifies the threshold that is used to determine the switch...

Page 556: ...RDS command specifies the Rds on value when the RDS conduction calculation method is chosen by POWer SWITch CONDuction Query Syntax POWer SWITch RDS The POWer SWITch RDS query returns the Rds on value...

Page 557: ...command specifies the Vce sat value when the VCE conduction calculation method is chosen by POWer SWITch CONDuction Query Syntax POWer SWITch VCE The POWer SWITch VCE query returns the Vce sat value...

Page 558: ...n percentage of the maximum switch voltage You can adjust this value to ignore noise floors This value specifies the threshold that is used to determine the switching edges Query Syntax POWer SWITch V...

Page 559: ...Command Syntax POWer TRANsient APPLy The POWer TRANsient APPLy command applies the transient analysis using the initial current and new current settings See Also POWer TRANsient EXIT on page 560 POWer...

Page 560: ...OWer TRANsient EXIT The POWer TRANsient EXIT command exits stops the transient analysis This command is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis See...

Page 561: ...specify the initial load current value The initial load current will be used as a reference and to trigger the oscilloscope Query Syntax POWer TRANsient IINitial The POWer TRANsient IINitial query re...

Page 562: ...nt INEW command to specify the new load current value The new load current will be used as a reference and to trigger the oscilloscope Query Syntax POWer TRANsient INEW The POWer TRANsient INEW query...

Page 563: ...t NEXT The POWer TRANsient NEXT command goes to the next step of the transient analysis This command is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the...

Page 564: ...564 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 23 POWer Commands...

Page 565: ...ile_spec internal_loc file_name column Column in CSV file to load Column number starts from 1 internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string RECall FILename base_name see page...

Page 566: ...rn Format The following is a sample response from the RECall query In this case the query was issued following the RST command REC FIL scope_0 RECall SETup STARt file_spec see page 571 n a file_spec i...

Page 567: ...eter is optional If no column parameter is entered and it is a 2 column file the 2nd column assumed to be voltage is automatically be selected If the column parameter is entered and that column does n...

Page 568: ...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 569: ...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...

Page 570: ...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 571: ...spec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The RECall SETup STARt command recalls an oscilloscope setup See Also Introduction to RECa...

Page 572: ...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 566...

Page 573: ...ing SAVE FILename base_name see page 577 SAVE FILename see page 577 base_name quoted ASCII string SAVE IMAGe STARt file_name see page 578 n a file_name quoted ASCII string SAVE IMAGe FACTors 0 OFF 1 O...

Page 574: ...le_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string SAVE WAVeform STARt file_name see page 588 n a file_name quoted ASCII string SAVE WAVeform FORMat format see page 589 SA...

Page 575: ...issued following the RST command SAVE FIL SAVE IMAG AREA GRAT FACT 0 FORM TIFF INKS 0 PAL MON SAVE PWD C setups SAVE WAV FORM NONE LENG 1000 SEGM CURR SAVE WMEMory SOURce source see page 593 SAVE WMEM...

Page 576: ...ame internal_loc 0 3 an integer in NR1 format file_name quoted ASCII string The SAVE ARBitrary STARt command saves the current arbitrary waveform to an internal location or a file on a USB storage dev...

Page 577: ...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 578: ...NKSaver on page 581 SAVE IMAGe PALette on page 582 SAVE FILename on page 577 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 579: ...ith 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 S...

Page 580: ...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 581: ...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 582: ...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 583: ...SAVE 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 575 SAVE FILename on page...

Page 584: ...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 575 SAV...

Page 585: ...name file_name quoted ASCII string The SAVE POWer STARt command saves the power measurement application s current harmonics analysis results to a file See Also Introduction to SAVE Commands on page 57...

Page 586: ...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 587: ...spec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The SAVE SETup STARt command saves an oscilloscope setup See Also Introduction to SAVE Com...

Page 588: ...n page 575 SAVE WAVeform FORMat on page 589 SAVE WAVeform LENGth on page 590 SAVE FILename on page 577 RECall SETup STARt on page 571 NOTE Be sure to set the SAVE WAVeform FORMat before saving wavefor...

Page 589: ...ile extension for this format is csv CSV creates one comma separated value file that contains information for all analog channels that are displayed turned on The proper file extension for this format...

Page 590: ...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 591: ...AX 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 LEN...

Page 592: ...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 593: ...e 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 FU...

Page 594: ...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 575 SAVE...

Page 595: ...system commands control the serial decode bus viewing mode and other options The following serial bus decode trigger types are available see TRIGger MODE on page 851 CAN Controller Area Network trigge...

Page 596: ...ring consists of connecting the oscilloscope to a clock data MOSI or MISO and framing signal You can then trigger on a data pattern during a specific framing period The serial data string can be speci...

Page 597: ...de 597 General SBUS n Commands Table 97 General SBUS n Commands Summary Command Query Options and Query Returns SBUS n DISPlay 0 OFF 1 ON see page 598 SBUS n DISPlay see page 598 0 1 SBUS n MODE mode...

Page 598: ...ry returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 1049 See Also Introduction to SBUS n Commands on page 595 CHANn...

Page 599: ...mode setting Return Format mode NL mode A429 FLEX CAN I2S IIC LIN M1553 SPI UART NONE Errors 241 Hardware missing on page 1049 See Also Introduction to SBUS n Commands on page 595 SBUS n A429 Command...

Page 600: ...COUNt R ESet see page 605 n a n a n a SBUS n A429 COUNt W ORD see page 606 word_count integer in NR1 format SBUS n A429 FORMat format see page 607 SBUS n A429 FORMat see page 607 format LDSDi LDSSm LD...

Page 601: ...n A429 TRIGger PATTern SSM see page 614 string nn where n 0 1 X length always 2 bits SBUS n A429 TRIGger RANGe min max see page 615 SBUS n A429 TRIGger RANGe see page 615 min 8 bit integer in decimal...

Page 602: ...er Threshold 3 0 V Noise Reject Off Probe Attenuation 10 0 Vertical Scale 4 V div Serial Decode On Base SBUS n A429 BASE HEX Word Format SBUS n A429 FORMat LDSDi Label SDI Data SSM Trigger the specifi...

Page 603: ...of the decoded data The BASE command has no effect on the SDI and SSM fields which are always displayed in binary nor the Label field which is always displayed in octal Query Syntax SBUS n A429 BASE T...

Page 604: ...ntax SBUS n A429 COUNt ERRor Returns the error count Return Format error_count NL error_count integer in NR1 format Errors 241 Hardware missing on page 1049 See Also SBUS n A429 COUNt RESet on page 60...

Page 605: ...Set see page 1088 Command Syntax SBUS n A429 COUNt RESet Resets the word and error counters Errors 241 Hardware missing on page 1049 See Also SBUS n A429 COUNt WORD on page 606 SBUS n A429 COUNt ERRor...

Page 606: ...yntax SBUS n A429 COUNt WORD Returns the word count Return Format word_count NL word_count integer in NR1 format Errors 241 Hardware missing on page 1049 See Also SBUS n A429 COUNt RESet on page 605 S...

Page 607: ...bits Query Syntax SBUS n A429 FORMat The SBUS n A429 FORMat query returns the current ARINC 429 word decode format setting Return Format format NL format LDSD LDSS LDAT Errors 241 Hardware missing on...

Page 608: ...al type A Line A non inverted B Line B inverted DIFFerential Differential A B Query Syntax SBUS n A429 SIGNal The SBUS n A429 SIGNal query returns the current ARINC 429 signal type setting Return Form...

Page 609: ...OURce The SBUS n A429 SOURce query returns the currently set source of the ARINC 429 signal Use the TRIGger LEVel HIGH and TRIGger LEVel LOW commands to set the thresold levels for the selected source...

Page 610: ...cifies the signal speed LOW 12 5 kb s HIGH 100 kb s Query Syntax SBUS n A429 SPEed The SBUS n A429 SPEed query returns the current ARINC 429 signal speed setting Return Format speed NL speed LOW HIGH...

Page 611: ...tring 0xnn where n 0 9 A F The SBUS n A429 TRIGger LABel command defines the ARINC 429 label value when labels are used in the selected trigger type To set the label value to don t cares 0xXX set the...

Page 612: ...or in each ARINC 429 word Query Syntax SBUS n A429 TRIGger PATTern DATA The SBUS n A429 TRIGger PATTern DATA query returns the current settings of the specified ARINC 429 data pattern resource in the...

Page 613: ...ched for in each ARINC 429 word The specified SDI is only used if the SBUS n A429 FORMat includes the SDI field Query Syntax SBUS n A429 TRIGger PATTern SDI The SBUS n A429 TRIGger PATTern SDI query r...

Page 614: ...ched for in each ARINC 429 word The specified SSM is only used if the SBUS n A429 FORMat includes the SSM field Query Syntax SBUS n A429 TRIGger PATTern SSM The SBUS n A429 TRIGger PATTern SSM query r...

Page 615: ...where n 0 9 A F octal Qnnn where n 0 7 string 0xnn where n 0 9 A F The SBUS n A429 TRIGger RANGe command defines a range of ARINC 429 label values This range is used when the LRANge trigger type is s...

Page 616: ...ord coding error GERRor triggers on an inter word gap error WGERrors triggers on either a Word or Gap Error ALLerrors triggers on any of the above errors ABITs triggers on any bit which will therefore...

Page 617: ...SBUS n Commands 26 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 617 SBUS n A429 SOURce on page 609...

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

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

Page 620: ...ge 1088 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 1049 See Also SBUS n CAN CO...

Page 621: ...e 1088 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 1049 See Also SBUS n C...

Page 622: ...US n CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 1049 See Also SBUS n CAN COUNt ERRor on page 620 SBUS n CAN COUNt OVERload on page 621 SBUS n CAN COUNt TOTal on page...

Page 623: ...ge 1088 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 1049 See Also SBUS n CAN CO...

Page 624: ...e 1088 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 1049 See Also SBUS n...

Page 625: ...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 626: ...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 627: ...inant 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 s...

Page 628: ...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 629: ...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 630: ...mand 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 Har...

Page 631: ...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 632: ...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 633: ...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 634: ...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 635: ...CHAN nel see page 639 channel A B n a SBUS n FLEXray COUN t NULL see page 640 frame_count integer in NR1 format SBUS n FLEXray COUN t RESet see page 641 n a n a n a SBUS n FLEXray COUN t SYNC see page...

Page 636: ...AMe CCBase see page 650 cycle_count_base integer from 0 63 SBUS n FLEXray TRIG ger FRAMe CCRepetitio n cycle_count_repetiti on see page 651 SBUS n FLEXray TRIG ger FRAMe CCRepetitio n see page 651 cyc...

Page 637: ...erial decode Sets the selected source channel s impedance to 50 Ohms Sets the selected source channel s probe attenuation to 10 1 Sets the trigger level on the selected source channel to 300 mV Turns...

Page 638: ...udrate 2500000 5000000 10000000 The SBUS n FLEXray BAUDrate command specifies the baud rate as 2 5 Mb s 5 Mb s or 10 Mb s Query Syntax SBUS n FLEXray BAUDrate The SBUS n FLEXray BAUDrate query returns...

Page 639: ...ay CHANnel channel channel A B The SBUS n FLEXray CHANnel command specifies the bus channel A or B of the FlexRay signal Query Syntax SBUS n FLEXray CHANnel The SBUS n FLEXray CHANnel query returns th...

Page 640: ...Returns the FlexRay null frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1049 See Also SBUS n FLEXray COUNt RESet on page 641 SBUS n FLE...

Page 641: ...nd Syntax SBUS n FLEXray COUNt RESet Resets the FlexRay frame counters Errors 241 Hardware missing on page 1049 See Also SBUS n FLEXray COUNt NULL on page 640 SBUS n FLEXray COUNt TOTal on page 643 SB...

Page 642: ...Returns the FlexRay sync frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1049 See Also SBUS n FLEXray COUNt RESet on page 641 SBUS n FLE...

Page 643: ...ay total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 1049 See Also SBUS n FLEXray COUNt RESet on page 641 SBUS n FLEXray COUNt TOTal...

Page 644: ...The SBUS n FLEXray SOURce command specifies the input source for the FlexRay signal Query Syntax SBUS n FLEXray SOURce The SBUS n FLEXray SOURce query returns the current source for the FlexRay signa...

Page 645: ...ay event symbol Query Syntax SBUS n FLEXray TRIGger The SBUS n FLEXray TRIGger query returns the current FLEXray trigger on condition Return Format condition NL condition FRAM ERR EVEN See Also Introd...

Page 646: ...he error type setting is only valid when the FlexRay trigger mode is set to ERRor ALL triggers on ALL errors HCRC triggers on only Header CRC errors FCRC triggers on only Frame CRC errors Query Syntax...

Page 647: ...TRIGger EVENt AUToset command automatically configures oscilloscope settings as shown on the display for the selected event trigger See Also Introduction to TRIGger Commands on page 843 SBUS n FLEXray...

Page 648: ...trigger This setting is only valid if the trigger mode is EVENt and the EVENt TYPE is BSS Query Syntax SBUS n FLEXray TRIGger EVENt BSS ID The SBUS n FLEXray TRIGger EVENt BSS ID query returns the cu...

Page 649: ...nt FES triggers on either Frame End or Dynamic Trailing Sequence event DTS triggers on either Frame End or Dynamic Trailing Sequence event BSS triggers on Byte Start Sequence event Query Syntax SBUS n...

Page 650: ...ts the base of the FlexRay cycle count in the frame header to trigger on The cycle count base setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax SBUS n FLEXray TRIGger FR...

Page 651: ...petition number of the FlexRay cycle count in the frame header to trigger on The cycle count repetition setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax SBUS n FLEXray...

Page 652: ...command sets the FlexRay frame ID to trigger on The frame ID setting is only valid when the FlexRay trigger mode is set to FRAMe Query Syntax SBUS n FLEXray TRIGger FRAMe ID The SBUS n FLEXray TRIGge...

Page 653: ...rames STARtup will trigger on only startup frames NULL will trigger on only null frames SYNC will trigger on only sync frames NSTArtup will trigger on frames other than startup frames NNULl will trigg...

Page 654: ...page 659 SBUS n I2S RWIDth see page 659 receiver 4 32 in NR1 format SBUS n I2S SOURce C LOCk source see page 660 SBUS n I2S SOURce C LOCk see page 660 source CHANnel n EXTernal for DSO models source C...

Page 655: ...nn n where n 0 9 A F X when base HEX SBUS n I2S TRIGger PATTern FORMat base see page 668 SBUS n I2S TRIGger PATTern FORMat see page 668 base BINary HEX DECimal SBUS n I2S TRIGger RANGe lower upper see...

Page 656: ...r when in I2S mode I2S standard LJ left justified RJ right justified Note that the word select WS polarity is specified separately with the SBUS n I2S WSLow command Query Syntax SBUS n I2S ALIGnment T...

Page 657: ...se DECimal HEX The SBUS n I2S BASE command determines the base to use for the I2S decode display Query Syntax SBUS n I2S BASE The SBUS n I2S BASE query returns the current I2S display decode base Retu...

Page 658: ...ecifies which edge of the I2S serial clock signal clocks in data NEGative Falling edge POSitive Rising edge Query Syntax SBUS n I2S CLOCk SLOPe The SBUS n I2S CLOCk SLOPe query returns the current I2S...

Page 659: ...he width of the receiver decoded data word in I2S anywhere from 4 bits to 32 bits Query Syntax SBUS n I2S RWIDth The SBUS n I2S RWIDth query returns the currently set I2S receiver data word width Retu...

Page 660: ...annels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n I2S SOURce CLOCk controls which signal is used as the serial clock SCLK source by the serial decoder and or trigger when in I2S...

Page 661: ...ls in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n I2S SOURce DATA command controls which signal is used as the serial data SDATA source by the serial decoder and or trigger when in I...

Page 662: ...hannels in NR1 format d 0 to digital channels 1 in NR1 format The SBUS n I2S SOURce WSELect command controls which signal is used as the word select WS source by the serial decoder and or trigger when...

Page 663: ...he range in which to trigger OUTRange enter upper and lower values to specify range in which trigger will not occur INCReasing triggers when the data value makes a certain increase over time and the s...

Page 664: ...Series Oscilloscopes Programmer s Guide 26 SBUS n Commands See Also Introduction to TRIGger Commands on page 843 SBUS n I2S TRIGger AUDio on page 665 SBUS n I2S TRIGger RANGe on page 669 SBUS n I2S TR...

Page 665: ...The SBUS n I2S TRIGger AUDio command specifies the audio channel to trigger on RIGHt right channel LEFT left channel EITHer right or left channel Query Syntax SBUS n I2S TRIGger AUDio The SBUS n I2S T...

Page 666: ...racters cannot be entered When queried the character is returned when any bits in the pattern have the value of X and base DECimal When any bits in a given nibble have the value of X and base HEX the...

Page 667: ...ction to TRIGger Commands on page 843 SBUS n I2S TRIGger PATTern FORMat on page 668 SBUS n I2S TRIGger on page 663 SBUS n I2S RWIDth on page 659 SBUS n I2S TWIDth on page 671 SBUS n I2S TRIGger AUDio...

Page 668: ...rn FORMat command sets the entry and query number base used by the SBUS n I2S TRIGger PATTern DATA command The default base is DECimal Query Syntax SBUS n I2S TRIGger PATTern FORMat The SBUS n I2S TRI...

Page 669: ...for INCReasing and DECReasing the lower and upper values correspond to the Armed and Trigger softkeys Query Syntax SBUS n I2S TRIGger RANGe The SBUS n I2S TRIGger RANGe query returns the currently set...

Page 670: ...ilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 26 SBUS n Commands SBUS n I2S TRIGger on page 663 SBUS n I2S RWIDth on page 659 SBUS n I2S TWIDth on page 671 SBUS n I2S WSLow on pag...

Page 671: ...the width of the transmitted data word in I2S anywhere from 4 bits to 32 bits Query Syntax SBUS n I2S TWIDth The SBUS n I2S TWIDth query returns the currently set I2S transmitted data word width Retur...

Page 672: ...of high indicates right channel data is active on the bus RIGHt a word select WS state of low indicates right channel data is active on the I2S bus and a WS state of high indicates left channel data...

Page 673: ...e 676 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 674: ...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 675: ...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 676: ...ce 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...

Page 677: ...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 678: ...mmand 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 SB...

Page 679: ...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 680: ...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 681: ...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 682: ...mer s Guide 26 SBUS n Commands SBUS n IIC TRIGger PATTern ADDRess on page 677 SBUS n IIC TRIGger PATTern DATA on page 678 SBUS n IIC TRIGger PATTern DATa2 on page 679 SBUS n IIC TRIGger QUALifier on p...

Page 683: ...625000 in 100 b s increments SBUS n LIN SOURce source see page 688 SBUS n LIN SOURce see page 688 source CHANnel n EXTernal for DSO models source CHANnel n DIGital d for MSO models n 1 to analog chann...

Page 684: ...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 695 SBUS n LIN TRIGger PATTern DATA LENGth see page...

Page 685: ...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 686: ...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 687: ...o 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 LIN SIGNal BAUDrate Th...

Page 688: ...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 LIN SOURce The SBUS n...

Page 689: ...IN 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 current LIN standard s...

Page 690: ...r equal to 11 12 or 13 clock lengths The sync break is the idle period in the bus activity at the beginning of each packet that distinguishes one information packet from the previous one Query Syntax...

Page 691: ...pecify 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 TRIGger The SBUS n L...

Page 692: ...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 which is equivalent to a...

Page 693: ...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 694: ...es Oscilloscopes Programmer s Guide 26 SBUS n Commands See Also Introduction to TRIGger Commands on page 843 SBUS n LIN TRIGger PATTern FORMat on page 696 SBUS n LIN TRIGger on page 691 SBUS n LIN TRI...

Page 695: ...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 696: ...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 697: ...see page 699 base BINary HEX SBUS n M1553 SOURce source see page 700 SBUS n M1553 SOURce see page 700 source CHANnel n n 1 to analog channels in NR1 format SBUS n M1553 TRIGge r PATTern DATA string se...

Page 698: ...matically sets these options for decoding and triggering on MIL STD 1553 signals High Low Trigger Thresholds to a voltage value equal to 1 3 division based on the source channel s current V div settin...

Page 699: ...y HEX The SBUS n M1553 BASE command determines the base to use for the MIL STD 1553 decode display Query Syntax SBUS n M1553 BASE The SBUS n M1553 BASE query returns the current MIL STD 1553 display d...

Page 700: ...MIL STD 1553 signal Use the TRIGger LEVel HIGH and TRIGger LEVel LOW commands to set the thresold levels for the selected source Query Syntax SBUS n M1553 TRIGger SOURce The SBUS n M1553 SOURce query...

Page 701: ...Tern DATA command sets the 11 bits to trigger on if the trigger type has been set to RTA11 RTA 11 Bits using the SBUS n M1553 TRIGger TYPE command Query Syntax SBUS n M1553 TRIGger PATTern DATA The SB...

Page 702: ...ere n 0 9 A F The SBUS n M1553 TRIGger RTA command sets the Remote Terminal Address RTA to trigger on when the trigger type has been set to RTA or RTA11 using the SBUS n M1553 TRIGger TYPE command To...

Page 703: ...Address triggers if the RTA of the Command Status word matches the specified value The value is specified in hex RTA11 RTA 11 Bits triggers if the RTA and the remaining 11 bits match the specified cri...

Page 704: ...FRAMing value see page 709 SBUS n SPI FRAMing see page 709 value CHIPselect NCHipselect NOTC TIMeout SBUS n SPI SOURce C LOCk source see page 710 SBUS n SPI SOURce C LOCk see page 710 value CHANnel n...

Page 705: ...TRIGger PATTern MISO DATA see page 715 string nn n where n 0 1 X string 0xnn n where n 0 9 A F X SBUS n SPI TRIGger PATTern MISO WIDTh width see page 716 SBUS n SPI TRIGger PATTern MISO WIDTh see pag...

Page 706: ...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 BITord...

Page 707: ...PI 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 qu...

Page 708: ...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 709: ...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 valu...

Page 710: ...l 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 the current sourc...

Page 711: ...OSI data This command is the same as the SBUS n SPI SOURce MOSI command Query Syntax SBUS n SPI SOURce DATA The SBUS n SPI SOURce DATA query returns the current source for the SPI serial MOSI data Ret...

Page 712: ...annels 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 SBUS n SPI SOURc...

Page 713: ...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 source NL See Also In...

Page 714: ...n 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 for the SPI serial...

Page 715: ...ata 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 characte...

Page 716: ...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 717: ...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 characters Query Syntax SB...

Page 718: ...tern 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 setting Return Format...

Page 719: ...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 SPI TRIGger TYPE...

Page 720: ...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 721: ...SBUS n UART BITorde r see page 726 bitorder LSBFirst MSBFirst n a SBUS n UART COUNt E RRor see page 727 frame_count integer in NR1 format SBUS n UART COUNt R ESet see page 728 n a n a n a SBUS n UART...

Page 722: ...e 736 base ASCii HEX SBUS n UART TRIGger BURSt value see page 737 SBUS n UART TRIGger BURSt see page 737 value OFF 1 to 4096 in NR1 format SBUS n UART TRIGger DATA value see page 738 SBUS n UART TRIGg...

Page 723: ...YPE value see page 741 SBUS n UART TRIGger TYPE see page 741 value RSTArt RSTOp RDATa RD1 RD0 RDX PARityerror TSTArt TSTOp TDATa TD1 TD0 TDX SBUS n UART WIDTh width see page 742 SBUS n UART WIDTh see...

Page 724: ...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 725: ...the 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 Synta...

Page 726: ...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 727: ...1088 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 1049 See Also SBUS n UAR...

Page 728: ...mmand Syntax SBUS n UART COUNt RESet Resets the UART frame counters Errors 241 Hardware missing on page 1049 See Also SBUS n UART COUNt ERRor on page 727 SBUS n UART COUNt RXFRames on page 729 SBUS n...

Page 729: ...1088 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 1049 See Also SBUS n UA...

Page 730: ...1088 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 1049 See Also SBUS n UA...

Page 731: ...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 732: ...S 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 return...

Page 733: ...BUS 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 retur...

Page 734: ...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 735: ...els 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...

Page 736: ...tion 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 Synta...

Page 737: ...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 738: ...ata 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 EO...

Page 739: ...mmand 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 curre...

Page 740: ...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 S...

Page 741: ...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 wid...

Page 742: ...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 743: ...page 751 Pulse Width search SEARch RUNT Commands on page 758 SEARch TRANsition Commands on page 763 SEARch SERial A429 Commands on page 768 SEARch SERial CAN Commands on page 774 SEARch SERial FLEXra...

Page 744: ...Table 107 General SEARch Commands Summary Command Query Options and Query Returns n a SEARch COUNt see page 745 count an integer count value SEARch MODE value see page 746 SEARch MODE see page 746 val...

Page 745: ...lloscopes Programmer s Guide 745 SEARch COUNt see page 1088 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 746: ...ition SERial 1 2 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 mod...

Page 747: ...88 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 748: ...ands Table 108 SEARch EDGE Commands Summary Command Query Options and Query Returns SEARch EDGE SLOPe slope see page 749 SEARch EDGE SLOPe see page 749 slope POSitive NEGative EITHer SEARch EDGE SOURc...

Page 749: ...Syntax SEARch EDGE SLOPe slope slope NEGative POSitive EITHer The SEARch EDGE SLOPe command specifies the slope of the edge for the search Query Syntax SEARch EDGE SLOPe The SEARch EDGE SLOPe query r...

Page 750: ...EARch EDGE SOURce source source CHANnel n n 1 to analog channels in NR1 format The SEARch EDGE SOURce command selects the channel on which to search for edges Query Syntax SEARch EDGE SOURce The SEARc...

Page 751: ...less_than_time floating point number in NR3 format suffix s ms us ns ps SEARch GLITch POLari ty polarity see page 754 SEARch GLITch POLari ty see page 754 polarity POSitive NEGative SEARch GLITch QUA...

Page 752: ...ITch GREaterthan command sets the minimum pulse width duration for the selected SEARch GLITch SOURce Query Syntax SEARch GLITch GREaterthan The SEARch GLITch GREaterthan query returns the minimum puls...

Page 753: ...Rch GLITch LESSthan command sets the maximum pulse width duration for the selected SEARch GLITch SOURce Query Syntax SEARch GLITch LESSthan The SEARch GLITch LESSthan query returns the pulse width dur...

Page 754: ...NEGative The SEARch GLITch POLarity command sets the polarity for the glitch pulse width search Query Syntax SEARch GLITch POLarity The SEARch GLITch POLarity query returns the current polarity setti...

Page 755: ...ation of the glitch pulse width search The oscilloscope can search for a pulse width that is greater than a time value less than a time value or within a range of time values Query Syntax SEARch GLITc...

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

Page 757: ...the channel on which to search for glitches pulse widths Query Syntax SEARch GLITch SOURce The SEARch GLITch SOURce query returns the current pulse width source If all channels are off the query retu...

Page 758: ...h RUNT POLarity see page 759 polarity POSitive NEGative EITHer SEARch RUNT QUALifie r qualifier see page 760 SEARch RUNT QUALifie r see page 760 qualifier GREaterthan LESSthan NONE SEARch RUNT SOURce...

Page 759: ...e polarity POSitive NEGative EITHer The SEARch RUNT POLarity command sets the polarity for the runt search Query Syntax SEARch RUNT POLarity The SEARch RUNT POLarity query returns the currently set ru...

Page 760: ...Sthan NONE The SEARch RUNT QUALifier command specifies whether to search for a runt that is greater than a time value less than a time value or any time value Query Syntax SEARch RUNT QUALifier The SE...

Page 761: ...urce CHANnel n n 1 to analog channels in NR1 format The SEARch RUNT SOURce command selects the channel on which to search for the runt pulse Query Syntax SEARch RUNT SOURce The SEARch RUNT SOURce quer...

Page 762: ...s ps When searching for runt pulses whose widths are greater than or less than a time see SEARch RUNT QUALifier the SEARch RUNT TIME command specifies the time value Query Syntax SEARch RUNT TIME The...

Page 763: ...ch TRANsition QU ALifier see page 764 qualifier GREaterthan LESSthan SEARch TRANsition SL OPe slope see page 765 SEARch TRANsition SL OPe see page 765 slope NEGative POSitive SEARch TRANsition SO URce...

Page 764: ...han The SEARch TRANsition QUALifier command specifies whether to search for edge transitions greater than or less than a time Query Syntax SEARch TRANsition QUALifier The SEARch TRANsition QUALifier q...

Page 765: ...mmand selects whether to search for rising edge POSitive slope transitions or falling edge NEGative slope transitions Query Syntax SEARch TRANsition SLOPe The SEARch TRANsition SLOPe query returns the...

Page 766: ...analog channels in NR1 format The SEARch TRANsition SOURce command selects the channel on which to search for edge transitions Query Syntax SEARch TRANsition SOURce The SEARch TRANsition SOURce query...

Page 767: ...ms us ns ps The SEARch TRANsition TIME command sets the time of the transition to search for You can search for transitions greater than or less than this time Query Syntax SEARch TRANsition TIME The...

Page 768: ...ring 0xnn where n 0 9 A F SEARch SERial A429 M ODE condition see page 770 SEARch SERial A429 M ODE see page 770 condition LABel LBITs PERRor WERRor GERRor WGERrors ALLerrors SEARch SERial A429 P ATTer...

Page 769: ...ctal Qnnn where n 0 7 string 0xnn where n 0 9 A F The SEARch SERial A429 LABel command defines the ARINC 429 label value when labels are used in the selected search mode Query Syntax SEARch SERial A42...

Page 770: ...ity error WERRor finds an intra word coding error GERRor finds an inter word gap error WGERrors finds either a Word or Gap Error ALLerrors finds any of the above errors Query Syntax SEARch SERial A429...

Page 771: ...searched for in each ARINC 429 word Query Syntax SEARch SERial A429 PATTern DATA The SEARch SERial A429 PATTern DATA query returns the current settings of the specified ARINC 429 data pattern resourc...

Page 772: ...ttern searched for in each ARINC 429 word The specified SDI is only used if the SBUS n A429 FORMat includes the SDI field Query Syntax SEARch SERial A429 PATTern SDI The SEARch SERial A429 PATTern SDI...

Page 773: ...attern searched for in each ARINC 429 word The specified SSM is only used if the SBUS n A429 FORMat includes the SSM field Query Syntax SEARch SERial A429 PATTern SSM The SEARch SERial A429 PATTern SS...

Page 774: ...Rial CAN PA TTern DATA string see page 776 SEARch SERial CAN PA TTern DATA see page 776 string 0xnn n where n 0 9 A F X for hexadecimal SEARch SERial CAN PA TTern DATA LENGth length see page 777 SEARc...

Page 775: ...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 776: ...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 777: ...specifies 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 DAT...

Page 778: ...e 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 I...

Page 779: ...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 780: ...63 SEARch SERial FLEXra y DATA string see page 782 SEARch SERial FLEXra y DATA see page 782 string 0xnn n where n 0 9 A F X SEARch SERial FLEXra y DATA LENGth length see page 783 SEARch SERial FLEXra...

Page 781: ...The SEARch SERial FLEXray CYCLe command specifies the cycle value to find when searching for FlexRay frames A cycle value of 1 is the same as ALL Query Syntax SEARch SERial FLEXray CYCLe The SEARch SE...

Page 782: ...the data value to find when searching for FlexRay frames The length of the data value is specified by the SEARch SERial FLEXray DATA LENGth command Query Syntax SEARch SERial FLEXray DATA The SEARch...

Page 783: ...mand specifies the length of data values when searching for FlexRay frames The data value is specified using the SEARch SERial FLEXray DATA command Query Syntax SEARch SERial FLEXray DATA LENGth The S...

Page 784: ...nteger from 1 2047 The SEARch SERial FLEXray FRAMe command specifies the frame ID value to find when searching for FlexRay frames Query Syntax SEARch SERial FLEXray FRAMe The SEARch SERial FLEXray FRA...

Page 785: ...rches for FlexRay frames with the specified cycle number and frame ID DATA searches for FlexRay frames with the specified data cycle number and frame ID HERRor searches for header CRC errors FERRor se...

Page 786: ...string see page 789 SEARch SERial I2S PA TTern DATA see page 789 string n where n 32 bit integer in signed decimal when base DECimal string nn n where n 0 1 X when base BINary string 0xnn n where n 0...

Page 787: ...RIGHt LEFT EITHer The SEARch SERial I2S AUDio command specifies the channel on which to search for I2S events right left or either channel Query Syntax SEARch SERial I2S AUDio The SEARch SERial I2S AU...

Page 788: ...el data words less than the specified value GREaterthan searches for channel data words greater than the specified value INRange searches for channel data words in the range OUTRange searches for chan...

Page 789: ...data word value when searching for I2S events The base of the value entered with this command is specified using the SEARch SERial I2S PATTern FORMat command Query Syntax SEARch SERial I2S PATTern DAT...

Page 790: ...HEX DECimal The SEARch SERial I2S PATTern FORMat command specifies the number base used with the SEARch SERial I2S PATTern DATA command Query Syntax SEARch SERial I2S PATTern FORMat The SEARch SERial...

Page 791: ...hexadecimal The SEARch SERial I2S RANGe command specifies the data value range when searching for I2S events in the INRange and OUTRange search modes set by the SEARch SERial I2S MODE command You can...

Page 792: ...h SERial IIC PA TTern ADDRess value see page 795 SEARch SERial IIC PA TTern ADDRess see page 795 value integer or string string 0xnn n 0 9 A F SEARch SERial IIC PA TTern DATA value see page 796 SEARch...

Page 793: ...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 794: ...Series Oscilloscopes Programmer s Guide 27 SEARch Commands SEARch SERial IIC PATTern ADDRess on page 795 SEARch SERial IIC PATTern DATA on page 796 SEARch SERial IIC PATTern DATA2 on page 797 SEARch...

Page 795: ...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 796: ...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 797: ...IIC 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 798: ...EARch 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 799: ...hexadecimal SEARch SERial LIN MO DE value see page 801 SEARch SERial LIN MO DE see page 801 value ID DATA ERRor SEARch SERial LIN PA TTern DATA string see page 802 SEARch SERial LIN PA TTern DATA see...

Page 800: ...n 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 L...

Page 801: ...rches 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 LI...

Page 802: ...ERial 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 803: ...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 804: ...EX 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 L...

Page 805: ...ARch SERial M1553 MODE see page 806 value DSTArt CSTArt RTA RTA11 PERRor SERRor MERRor SEARch SERial M1553 PATTern DATA string see page 807 SEARch SERial M1553 PATTern DATA see page 807 string nn n wh...

Page 806: ...word RTA11 searches for the Remote Terminal Address RTA and the additional 11 bits of a Command Status word PERRor searches for odd parity errors for the data in the word SERRor searches for invalid S...

Page 807: ...h SERial M1553 PATTern DATA command specifies the additional 11 bits when searching for the MIL STD 1553 Remote Terminal Address 11 Bits Query Syntax SEARch SERial M1553 PATTern DATA The SEARch SERial...

Page 808: ...Hnn where n 0 9 A F binary Bnn n where n 0 1 for binary string 0xnn where n 0 9 A F The SEARch SERial M1553 RTA command specifies the Remote Terminal Address RTA value when searching for MIL STD 1553...

Page 809: ...y Options and Query Returns SEARch SERial SPI MO DE value see page 810 SEARch SERial SPI MO DE see page 810 value MOSI MISO SEARch SERial SPI PA TTern DATA string see page 811 SEARch SERial SPI PA TTe...

Page 810: ...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 811: ...ATTern 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 PAT...

Page 812: ...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 813: ...0 255 0x00 0xff in decimal hexadecimal binary or quoted_string format hexadecimal Hnn where n 0 9 A F for hexadecimal binary Bnn n where n 0 1 for binary quoted_string any of the 128 valid 7 bit ASCII...

Page 814: ...of 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...

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

Page 816: ...l 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 817: ...g see page 820 n a string up to 75 characters as a quoted ASCII string n a SYSTem ERRor see page 821 error an integer error code error string quoted ASCII string See Error Messages see page 1047 SYSTe...

Page 818: ...lloscopes Programmer s Guide 28 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 819: ...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 820: ...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 821: ...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 822: ...CK 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 SYST...

Page 823: ...t InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 823 SYSTem MENU see page 1088 Command Syntax SYSTem MENU menu menu MASK MEASure SEGMented LISTer POWer The SYSTem MENU command changes th...

Page 824: ...fault 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 cond...

Page 825: ...ld TTL 1 4V Display Menu Persistence Off Grid 33 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 826: ...mer s Guide 28 SYSTem Commands See Also Introduction to Common Commands on page 155 RST Reset on page 168 HF Reject and noise reject Off Holdoff 60 ns External probe attenuation 10 1 External Units Vo...

Page 827: ...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 828: ...8 2 format See Also Introduction to SYSTem Commands on page 818 LRN Learn Device Setup on page 163 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the cur...

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

Page 830: ...at 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 S...

Page 831: ...onds in NR3 format TIMebase REFerence LEFT CENTer RIGHt see page 836 TIMebase REFerence see page 836 return_value LEFT CENTer RIGHt TIMebase SCALe scale_value see page 837 TIMebase SCALe see page 837...

Page 832: ...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 833: ...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 834: ...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 835: ...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 836: ...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 837: ...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 838: ...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...

Page 839: ...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 840: ...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 841: ...econds 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...

Page 842: ...842 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 29 TIMebase Commands...

Page 843: ...ommands in the TRIGger subsystem define the conditions for an internal trigger Many of these commands are valid in multiple trigger modes The default trigger mode is EDGE The trigger subsystem control...

Page 844: ...plicated waveforms of television equipment The trigger circuitry detects the vertical and horizontal interval of the waveform and produces triggers based on the TV trigger settings you selected TV tri...

Page 845: ...ee page 849 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 source see page 850 TRIGger LEVel LOW source se...

Page 846: ...s TRIGger FORCe see page 1088 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 847: ...requency 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 b...

Page 848: ...ble 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 Wi...

Page 849: ...LEVel HIGH command sets the high trigger voltage level voltage for the specified source High and low trigger levels are used with runt triggers and rise fall time transition triggers Query Syntax TRIG...

Page 850: ...LEVel LOW command sets the low trigger voltage level voltage for the specified source High and low trigger levels are used with runt triggers and rise fall time transition triggers Query Syntax TRIGge...

Page 851: ...yntax 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 DEL EBUR OR RUNT SHOL...

Page 852: ...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 853: ...present but the oscilloscope is not triggered the unsynchronized signal is displayed instead of a baseline When NORMal sweep mode is selected and no trigger is present the instrument does not sweep an...

Page 854: ...SL OPe slope see page 855 TRIGger DELay ARM SL OPe see page 855 slope NEGative POSitive TRIGger DELay ARM SO URce source see page 856 TRIGger DELay ARM SO URce see page 856 source CHANnel n DIGital d...

Page 855: ...Gger DELay ARM SLOPe command specifies rising POSitive or falling NEGative for the arming edge in the Edge Then Edge triggger Query Syntax TRIGger DELay ARM SLOPe The TRIGger DELay ARM SLOPe query ret...

Page 856: ...igital channels 1 in NR1 format The TRIGger DELay ARM SOURce command selects the input used for the arming edge in the Edge Then Edge trigger Query Syntax TRIGger DELay ARM SOURce The TRIGger DELay AR...

Page 857: ...d sets the delay time between the arming edge and the trigger edge in the Edge Then Edge trigger The time is in seconds and must be from 4 ns to 10 s Query Syntax TRIGger DELay TDELay TIME The TRIGger...

Page 858: ...ay TRIGger COUNt command sets the Nth edge of the trigger source to trigger on Query Syntax TRIGger DELay TRIGger COUNt The TRIGger DELay TRIGger COUNt query returns the current Nth trigger edge setti...

Page 859: ...command specifies rising POSitive or falling NEGative for the trigger edge in the Edge Then Edge triggger Query Syntax TRIGger DELay TRIGger SLOPe The TRIGger DELay TRIGger SLOPe query returns the cur...

Page 860: ...format The TRIGger DELay TRIGger SOURce command selects the input used for the trigger edge in the Edge Then Edge trigger Query Syntax TRIGger DELay TRIGger SOURce The TRIGger DELay TRIGger SOURce que...

Page 861: ...ommand is used to set the Nth Edge Burst trigger level Table 125 TRIGger EBURst Commands Summary Command Query Options and Query Returns TRIGger EBURst COUNt count see page 862 TRIGger EBURst COUNt se...

Page 862: ...he Nth edge at burst counter resource The edge counter is used in the trigger stage to determine which edge in a burst will generate a trigger Query Syntax TRIGger EBURst COUNt The TRIGger EBURst COUN...

Page 863: ...mand sets the Nth edge in a burst idle resource in seconds from 10 ns to 10 s The timer is used to set the minimum time before the next burst Query Syntax TRIGger EBURst IDLE The TRIGger EBURst IDLE q...

Page 864: ...EBURst SLOPe command specifies whether the rising edge POSitive or falling edge NEGative of the Nth edge in a burst will generate a trigger Query Syntax TRIGger EBURst SLOPe The TRIGger EBURst SLOPe q...

Page 865: ...1 format d 0 to digital channels 1 in NR1 format The TRIGger EBURst SOURce command selects the input that produces the Nth edge burst trigger Query Syntax TRIGger EBURst SOURce The TRIGger EBURst SOUR...

Page 866: ...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 867: ...set 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 co...

Page 868: ...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 869: ...ncy 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 freque...

Page 870: ...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 871: ...al WGEN triggers at the 50 level of the rising edge of the waveform generator output signal This option is not available when the DC NOISe or CARDiac waveforms are selected Query Syntax TRIGger EDGE S...

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

Page 873: ...e 879 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 880 TRIGger GLITch SOURc e see...

Page 874: ...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 875: ...ger 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...

Page 876: ...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 877: ...ity 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 878: ...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 879: ...RANGe command sets the pulse width duration for the selected TRIGger GLITch SOURce You can enter the parameters in any order the smaller value becomes the greater_than_time and the larger value become...

Page 880: ...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 881: ...ble 128 TRIGger OR Commands Summary Command Query Options and Query Returns TRIGger OR string see page 882 TRIGger OR see page 882 string nn n where n R F E X R rising edge F falling edge E either edg...

Page 882: ...IGger OR The TRIGger OR query returns the current OR ed edge trigger string Return Format string NL See Also Introduction to TRIGger Commands on page 843 TRIGger MODE on page 851 Oscilloscope Models V...

Page 883: ...6 TRIGger PATTern FORM at see page 886 base ASCii HEX TRIGger PATTern GREa terthan greater_than_time s uffix see page 887 TRIGger PATTern GREa terthan see page 887 greater_than_time floating point num...

Page 884: ...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 fal...

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

Page 886: ...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 887: ...n command sets the minimum duration for the defined pattern when TRIGger PATTern QUALifier is set to GREaterthan The command also sets the timeout value when the TRIGger PATTern QUALifier is set to TI...

Page 888: ...suffix s ms us ns ps The TRIGger PATTern LESSthan command sets the maximum duration for the defined pattern when TRIGger PATTern QUALifier is set to LESSthan Query Syntax TRIGger PATTern LESSthan The...

Page 889: ...pattern is present for a time within a range of values OUTRange when the pattern is present for a time outside of range of values Pattern durations are evaluated using a timer The timer starts on the...

Page 890: ...890 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 30 TRIGger Commands TRIGger PATTern LESSthan on page 888 TRIGger PATTern RANGe on page 891...

Page 891: ...and sets the duration for the defined pattern when the TRIGger PATTern QUALifier command is set to INRange or OUTRange You can enter the parameters in any order the smaller value becomes the greater_t...

Page 892: ...r RUNT POLarit y see page 893 polarity POSitive NEGative EITHer TRIGger RUNT QUALifi er qualifier see page 894 TRIGger RUNT QUALifi er see page 894 qualifier GREaterthan LESSthan NONE TRIGger RUNT SOU...

Page 893: ...larity for the runt trigger POSitive positive runt pulses NEGative negative runt pulses EITHer either positive or negative runt pulses Query Syntax TRIGger RUNT POLarity The TRIGger RUNT POLarity quer...

Page 894: ...t pulse widths GREaterthan triggers on runt pulses whose width is greater than the TRIGger RUNT TIME LESSthan triggers on runt pulses whose width is less than the TRIGger RUNT TIME NONE triggers on ru...

Page 895: ...rce source CHANnel n n 1 to analog channels in NR1 format The TRIGger RUNT SOURce command selects the channel used to produce the trigger Query Syntax TRIGger RUNT SOURce The TRIGger RUNT SOURce query...

Page 896: ...ering on runt pulses whose width is greater than or less than a certain value see TRIGger RUNT QUALifier the TRIGger RUNT TIME command specifies the time used with the qualifer Query Syntax TRIGger RU...

Page 897: ...CHANnel n DIGital d n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format TRIGger SHOLd SOURce DATA source see page 900 TRIGger SHOLd SOURce DATA see page 900 source CHANnel n D...

Page 898: ...OLd SLOPe command specifies whether the rising edge or the falling edge of the clock signal is used Query Syntax TRIGger SHOLd SLOPe The TRIGger SHOLd SLOPe query returns the current rising or falling...

Page 899: ...nnels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger SHOLd SOURce CLOCk command selects the input channel probing the clock signal Query Syntax TRIGger SHOLd SOURce CLOCk The TRIGge...

Page 900: ...annels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger SHOLd SOURce DATA command selects the input channel probing the data signal Query Syntax TRIGger SHOLd SOURce DATA The TRIGger...

Page 901: ...HOLD time suffix time floating point number in NR3 format suffix s ms us ns ps The TRIGger SHOLd TIME HOLD command sets the hold time Query Syntax TRIGger SHOLd TIME HOLD The TRIGger SHOLd TIME HOLD...

Page 902: ...Tup time suffix time floating point number in NR3 format suffix s ms us ns ps The TRIGger SHOLd TIME SETup command sets the setup time Query Syntax TRIGger SHOLd TIME SETup The TRIGger SHOLd TIME SETu...

Page 903: ...Lifier qualifier see page 904 TRIGger TRANsition Q UALifier see page 904 qualifier GREaterthan LESSthan TRIGger TRANsition S LOPe slope see page 905 TRIGger TRANsition S LOPe see page 905 slope NEGati...

Page 904: ...cifies whether you are looking for rise fall times greater than or less than a certain time value The time value is set using the TRIGger TRANsition TIME command Query Syntax TRIGger TRANsition QUALif...

Page 905: ...e POSitive The TRIGger TRANsition SLOPe command specifies a POSitive rising edge or a NEGative falling edge Query Syntax TRIGger TRANsition SLOPe The TRIGger TRANsition SLOPe query returns the current...

Page 906: ...n 1 to analog channels in NR1 format The TRIGger TRANsition SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TRANsition SOURce The TRIGger TRANsition SOURce query re...

Page 907: ...and sets the time value for rise fall time triggers You also use the TRIGger TRANsition QUALifier command to specify whether you are triggering on times greater than or less than this time value Query...

Page 908: ...RIGger TV SOURce see page 912 source CHANnel n n 1 to analog channels in NR1 format TRIGger TV STANdard standard see page 913 TRIGger TV STANdard see page 913 standard NTSC PAL PALM SECam standard GEN...

Page 909: ...trigger line number setting Return Format line_number NL line_number integer in NR1 format See Also Introduction to TRIGger Commands on page 843 TRIGger TV STANdard on page 913 TRIGger TV MODE on page...

Page 910: ...meter is not available when TRIGger TV STANdard is GENeric 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 val...

Page 911: ...arity 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 pol...

Page 912: ...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 913: ...ANdard command selects the video standard NTSC PAL PAL M SECAM With an extended Video triggering license the oscilloscope additionally supports these standards Generic GENeric mode is non interlaced E...

Page 914: ...ecifies the Generic video trigger s Nth edge to trigger on after synchronizing with the vertical sync This command is available with the DSOX3VID extended Video triggering license Query Syntax TRIGger...

Page 915: ...ion Additionally the Field Holdoff can be adjusted so that the oscilloscope triggers once per frame Similarly for progressive video with a tri level sync enabling the HSYNc control and setting the HTI...

Page 916: ...ontrol is enabled the TRIGger TV UDTV HTIMe command sets the minimum time the horizontal sync pulse must be present to be considered valid This command is available with the DSOX3VID extended Video tr...

Page 917: ...width time in the Generic video trigger This setting allows oscilloscope synchronization to the vertical sync This command is available with the DSOX3VID extended Video triggering license Query Synta...

Page 918: ...d for the MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format TRIGger USB SOURce D PLus source see page 920 TRIGger USB SOURce D PLus see page 920 source CHANnel n...

Page 919: ...e MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger USB SOURce DMINus command sets the source for the USB D signal Query Syntax TRIGger USB SOURce DMI...

Page 920: ...e MSO models n 1 to analog channels in NR1 format d 0 to digital channels 1 in NR1 format The TRIGger USB SOURce DPLus command sets the source for the USB D signal Query Syntax TRIGger USB SOURce DPLu...

Page 921: ...mand sets the expected USB signal speed to be Low Speed 1 5 Mb s or Full Speed 12 Mb s Query Syntax TRIGger USB SPEed The TRIGger USB SPEed query returns the current speed value for the USB signal Ret...

Page 922: ...nd sets where the USB trigger will occur SOP Start of packet EOP End of packet ENTersuspend Enter suspend state EXITsuspend Exit suspend state RESet Reset complete Query Syntax TRIGger USB TRIGger The...

Page 923: ...m DATA see page 933 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...

Page 924: ...tion 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 943 count an integer from 2 to 1000 in NR1 format with Option SGM n a W...

Page 925: ...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 926: ...number of points acquired may be queried using ACQuire POINts see page 224 Helpful Hints The number of points transferred to the computer is controlled using the WAVeform POINts command see page 936...

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

Page 928: ...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 929: ...uery see page 936 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 930: ...WORD see page 935 is WORD every other data byte will be 0 The setting of WAVeform BYTeorder see page 931 controls which byte is 0 If a digital channel is not displayed its bit value in the pod data by...

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

Page 932: ...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 933: ...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 934: ...alue 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 lngDataV...

Page 935: ...Veform 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 transfe...

Page 936: ...veforms is determined by the NORMal waveform points mode See the WAVeform POINts MODE command see page 938 for more information Only data visible on the display will be returned When the WAVeform SOUR...

Page 937: ...933 WAVeform SOURce on page 945 WAVeform VIEW on page 952 WAVeform PREamble on page 940 WAVeform POINts MODE on page 938 Example Code WAVE_POINTS Specifies the number of points to be transferred using...

Page 938: ...scilloscope is running this data record is unavailable If the points_mode is MAXimum whichever record contains the maximum amount of points is used Usually this is the raw acquisition record But if th...

Page 939: ...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 925 WAVeform DATA on page 933 A...

Page 940: ...bit NR1 yincrement 32 bit floating point NR3 yorigin 32 bit floating point NR3 yreference 32 bit NR1 format 0 for BYTE format 1 for WORD format 4 for ASCii format an integer in NR1 format format set b...

Page 941: ...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 942: ...3000 X Series Oscilloscopes Programmer s Guide 31 WAVeform Commands sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 See complete example programs at Chapter 39 Programming Exam...

Page 943: ...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 944: ...AG 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 SEG...

Page 945: ...stamps and associated 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...

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

Page 947: ...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 948: ...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 949: ...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 950: ...ode 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 Commands on...

Page 951: ...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 952: ...IEW 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 953: ...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 954: ...ource 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...

Page 955: ...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 956: ...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 957: ...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 958: ...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 959: ...N ARBitrary BYTeo rder see page 962 order MSBFirst LSBFirst WGEN ARBitrary DATA binary value value see page 963 n a binary floating point values between 1 0 to 1 0 in IEEE 488 2 binary block format va...

Page 960: ...ee page 974 percent symmetry percentage from 0 to 100 in NR3 format WGEN FUNCtion SQUare DCYCle percent see page 975 WGEN FUNCtion SQUare DCYCle see page 975 percent duty cycle percentage from 20 to 8...

Page 961: ...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 LOAD...

Page 962: ...BYTeorder order order MSBFirst LSBFirst The WGEN ARBitrary BYTeorder command selects the byte order for binary transfers Query Syntax WGEN ARBitrary BYTeorder The WGEN ARBitrary BYTeorder query return...

Page 963: ...e value binary floating point values between 1 0 to 1 0 in IEEE 488 2 binary block format value floating point values between 1 0 to 1 0 in comma separated format The WGEN ARBitrary DATA command downl...

Page 964: ...ax WGEN ARBitrary DATA ATTRibute POINts The WGEN ARBitrary DATA ATTRibute POINts query returns the number of points used by the current arbitrary waveform Return Format points number of points in NR1...

Page 965: ...r see page 1088 Command Syntax WGEN ARBitrary DATA CLEar The WGEN ARBitrary DATA CLEar command clears the arbitrary waveform memory and loads it with the default waveform See Also WGEN ARBitrary DATA...

Page 966: ...alue binary decimal 16 bit integer values between 512 to 511 in IEEE 488 2 binary block format value decimal integer values between 512 to 511 in comma separated NR1 format The WGEN ARBitrary DATA DAC...

Page 967: ...oints When ON lines are drawn between points in the arbitrary waveform Voltage levels change linearly between one point and the next When OFF all line segments in the arbitrary waveform are horizontal...

Page 968: ...STORe source source CHANnel n WMEMory r FUNCtion MATH n 1 to analog channels in NR1 format r 1 2 in NR1 format The WGEN ARBitrary STORe command stores the source s waveform into the arbitrary wavefor...

Page 969: ...se 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...

Page 970: ...z to 20 MHz 20 mVpp to 5 Vpp 2 50 V SQUare Use these commands to set the square wave signal parameters WGEN FREQuency on page 969 WGEN PERiod on page 979 WGEN VOLTage on page 981 WGEN VOLTage OFFSet o...

Page 971: ...age LOW on page 983 n a 20 mVpp to 5 Vpp 2 50 V SINC Use these commands to set the sine cardinal signal parameters WGEN FREQuency on page 969 WGEN PERiod on page 979 WGEN VOLTage on page 981 WGEN VOLT...

Page 972: ...Tage OFFSet on page 984 100 mHz to 200 kHz 20 mVpp to 5 Vpp 1 25 V GAUSsian Use these commands to set the gaussian pulse signal parameters WGEN FREQuency on page 969 WGEN PERiod on page 979 WGEN VOLTa...

Page 973: ...at 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 WIDT...

Page 974: ...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 975: ...uare 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 DCYCl...

Page 976: ...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 977: ...WGEN 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...

Page 978: ...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 979: ...Noise 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 ret...

Page 980: ...GEN Commands WGEN RST see page 1088 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 981: ...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...

Page 982: ...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 983: ...specify 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 a...

Page 984: ...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 985: ...ory r LABel see page 989 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 990 n a r 1 2 in NR1 format source CHANnel n FU...

Page 986: ...RANge see page 993 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 994 WMEMory r YSCale see page 994 r 1 2 in NR1 format scal...

Page 987: ...Guide 987 WMEMory r CLEar see page 1088 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 33 WMEMory r C...

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

Page 989: ...me 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 wavef...

Page 990: ...NR1 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 locati...

Page 991: ...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 992: ...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 993: ...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 994: ...eform 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 WMEMor...

Page 995: ...57 ANALog n INVert CHANnel n INVert see page 260 ANALog n LABel CHANnel n LABel see page 261 ANALog n OFFSet CHANnel n OFFSet see page 262 ANALog n PROBe CHANnel n PROBe see page 263 ANALog n PMODe no...

Page 996: ...arameters current command has GOFT parameter FUNCtion VIEW see page 1011 FUNCtion DISPlay see page 317 HARDcopy DESTination see page 1012 HARDcopy FILename see page 1013 HARDcopy FILename see page 101...

Page 997: ...ds can define absolute values or percentage MEASure VDELta see page 1028 MARKer YDELta see page 375 MEASure VSTArt see page 1029 MARKer Y1Position see page 373 MEASure VSTOp see page 1030 MARKer Y2Pos...

Page 998: ...INDow POSition is position value of zoomed delayed time base window SBUS n LIN SIGNal DEFiniti on see page 1042 none TRIGger THReshold see page 1044 POD n THReshold see page 505 or DIGital d THReshold...

Page 999: ...ay ROW none DISPlay TEXT none FUNCtion MOVE none FUNCtion PEAKs none HARDcopy ADDRess none Only parallel printer port is supported GPIB printing not supported MASK none All commands discontinued featu...

Page 1000: ...rmat 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 sp...

Page 1001: ...ANnel 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 retu...

Page 1002: ...s 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 1003: ...e 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 ch...

Page 1004: ...elects 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 in...

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

Page 1006: ...ned 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...

Page 1007: ...I string See Also DIGital d POSition on page 285 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 c...

Page 1008: ...uide 34 Obsolete and Discontinued Commands ERASe see page 1088 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to prev...

Page 1009: ...s 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 1010: ...e command selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for function DIFF differentiate INTegrate and FFT operations specified by the FU...

Page 1011: ...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 FUNCti...

Page 1012: ...py 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 1013: ...me 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 st...

Page 1014: ...ARDcopy 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 1015: ...ls 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 valu...

Page 1016: ...ardcopy 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 HARDco...

Page 1017: ...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 1018: ...EASure SCRatch see page 1088 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 1019: ...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 1020: ...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 1021: ...d Query Syntax MEASure TMAX source The MEASure TMAX query returns the horizontal axis value at which the maximum vertical value occurs on the current source If the optional source is specified the cur...

Page 1022: ...d Query Syntax MEASure TMIN source The MEASure TMIN query returns the horizontal axis value at which the minimum vertical value occurs on the current source If the optional source is specified the cur...

Page 1023: ...time at the start marker in NR3 format See Also Introduction to MARKer Commands on page 364 Introduction to MEASure Commands on page 388 MARKer X1Position on page 366 MARKer X2Position on page 368 MAR...

Page 1024: ...e at the stop marker in NR3 format See Also Introduction to MARKer Commands on page 364 Introduction to MEASure Commands on page 388 MARKer X1Position on page 366 MARKer X2Position on page 368 MARKer...

Page 1025: ...ponse 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 t...

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

Page 1027: ...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 1028: ...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 1029: ...e at voltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 364 Introduction to MEASure Commands on page 388 MARKer Y1Position on page 373 MARKer Y2Position on page 374 MARKer...

Page 1030: ...the Y2 cursor in NR3 format See Also Introduction to MARKer Commands on page 364 Introduction to MEASure Commands on page 388 MARKer Y1Position on page 373 MARKer Y2Position on page 374 MARKer YDELta...

Page 1031: ...as 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...

Page 1032: ...bucket 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...

Page 1033: ...command 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 CO...

Page 1034: ...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 4...

Page 1035: ...nds 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...

Page 1036: ...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 1037: ...and Syntax MTESt STARt STOP The MTESt STARt STOP command starts or stops the acquisition system See Also Introduction to MTESt Commands on page 469 NOTE The MTESt STARt and MTESt STOP commands are obs...

Page 1038: ...ger 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 1039: ...page 296 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 d...

Page 1040: ...continued Commands See Also Introduction to Root Commands on page 182 Introduction to HARDcopy Commands on page 342 HARDcopy FACTors on page 345 HARDcopy GRAYscale on page 1014 DISPlay DATA on page 29...

Page 1041: ...ed 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 ar...

Page 1042: ...t low signals LIN the actual LIN single end bus signal line RX the Receive signal from the LIN bus transceiver TX the Transmit signal to the LIN bus transceiver Query Syntax SBUS n LIN SIGNal DEFiniti...

Page 1043: ...ence point is set with the TIMebase REFerence command see page 836 Query Syntax TIMebase DELay The TIMebase DELay query returns the current delay value Return Format delay_value NL delay_value time fr...

Page 1044: ...d 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 thres...

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

Page 1046: ...1046 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 34 Obsolete and Discontinued Commands...

Page 1047: ...s Guide 35 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 1048: ...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 1049: ...occur when a feature is unavailable or unlicensed For example serial bus decode commands which require a four channel oscilloscope are unavailable on two channel oscilloscopes and some serial bus dec...

Page 1050: ...222 Data out of range 221 Settings conflict 220 Parameter error 200 Execution error 183 Invalid inside macro definition 181 Invalid outside macro definition 178 Expression data not allowed 171 Invalid...

Page 1051: ...tring data 150 String data error 148 Character data not allowed 138 Suffix not allowed 134 Suffix too long 131 Invalid suffix 128 Numeric data not allowed 124 Too many digits 123 Exponent too large 12...

Page 1052: ...essages 112 Program mnemonic too long 109 Missing parameter 108 Parameter not allowed 105 GET not allowed 104 Data type error 103 Invalid separator 102 Syntax error 101 Invalid character 100 Command e...

Page 1053: ...ed 106 Print Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation A remote operation wants some information but there is no information available For example yo...

Page 1054: ...1054 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 35 Error Messages...

Page 1055: ...ister EVENt 1072 Power Event Event Register PWRRegister EVENt 1073 Clearing Registers and Queues 1074 Status Reporting Decision Chart 1075 IEEE 488 2 defines data structures commands and common bit de...

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

Page 1057: ...ig OVL Chan2 Fault Chan1 Fault Chan3 Fault Chan4 Fault Ext Trig Fault PWR PWRenable PWRenable Power Event Enable MASK Register 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14 15 PWRRegister EVENt Power Event Event...

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

Page 1059: ...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 1060: ...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 Sta...

Page 1061: ...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 1062: ...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 1063: ...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 1064: ...Message Queue The message queue contains the text of the last message written to the advisory line on the screen of the oscilloscope The length of the oscilloscope s message queue is 1 Note that messa...

Page 1065: ...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 1066: ...ue 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 1067: ...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 1068: ...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 bit 3 Is set whenever the...

Page 1069: ...r 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 bit bit 5 Is set by the T...

Page 1070: ...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 1071: ...l 2 input Channel 3 OVL bit 2 Overload has occurred on Channel 3 input Channel 4 OVL bit 3 Overload has occurred on Channel 4 input External Trigger OVL bit 4 Overload has occurred on External Trigger...

Page 1072: ...egister 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 c...

Page 1073: ...ister hosts these bits The PWRRegister EVENt query returns the value of and clears the Power Event Event Register Name Location Description Setup Complete bit 0 Is set when the power analysis auto set...

Page 1074: ...Programmer s Guide 36 Status Reporting 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 1075: ...ister and send an SRQ to the computer If events are monitored by the Standard Event Status Register also enable ESB with the SRE command Activate the instrument function that you want to monitor When...

Page 1076: ...1076 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 36 Status Reporting...

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

Page 1078: ...ieve 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 oscilloscop...

Page 1079: ...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 1080: ...mLib 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 s...

Page 1081: ...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 v...

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

Page 1083: ...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 1084: ...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 1085: ...ter 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 Rea...

Page 1086: ...1086 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 37 Synchronizing Acquisitions...

Page 1087: ...Vision 3000 X Series Oscilloscopes Programmer s Guide 38 More About Oscilloscope Commands Command Classifications 1088 Valid Command Query Strings 1089 Query Return Values 1095 All Oscilloscope Comman...

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

Page 1089: ...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 1090: ...as the values they accept Program Data Syntax Rules on page 1092 describes all of the general rules about acceptable values When there is more than one data parameter they are separated by commas Spa...

Page 1091: ...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 1092: ...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 1093: ...d 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 fo...

Page 1094: ...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 1095: ...us 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 Bas...

Page 1096: ...al 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 concurrentl...

Page 1097: ...oscopes Programmer s Guide 39 Programming Examples VISA COM Examples 1098 VISA Examples 1131 SICL Examples 1178 SCPI NET Examples 1198 Example programs are ASCII text files that can be cut from the he...

Page 1098: ...erence the Agilent VISA COM library a Choose Tools References from the main menu b In the References dialog check the VISA COM 3 0 Type Library c Click OK 4 Choose Insert Module 5 Cut and paste the co...

Page 1099: ...eout 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 1100: ...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 1101: ...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 1102: ...a 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 1103: ...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 1104: ...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 1105: ...myScope WriteString query DoQueryString myScope ReadString CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VI...

Page 1106: ...inaryType_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 Che...

Page 1107: ...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 1108: ...ption 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 Cl...

Page 1109: ...rned 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 s...

Page 1110: ...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 my...

Page 1111: ...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 1112: ...rement 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 Consol...

Page 1113: ...ic 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 1114: ...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 1115: ...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 1116: ...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 1117: ...le 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...

Page 1118: ...m 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 off...

Page 1119: ...couple of measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryN...

Page 1120: ...tings 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 1121: ...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 1122: ...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 stri...

Page 1123: ...ay 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 CheckI...

Page 1124: ...Catch End Try Try 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 for NET or I...

Page 1125: ...NET or IronPython This program illustrates a few commonly used programming features of your Agilent oscilloscope Import Python modules import sys sys path append C Python26 Lib Python Standard Librar...

Page 1126: ...UI1 SYSTem SETup nLength len setup_bytes fStream File Open setup stp FileMode Create fStream Write setup_bytes 0 nLength fStream Close print Setup bytes saved d nLength Change oscilloscope settings wi...

Page 1127: ...litude on channel 1 s qresult Download the screen image do_command HARDcopy INKSaver OFF image_bytes do_query_ieee_block_UI1 DISPlay DATA PNG COLor nLength len image_bytes fStream File Open screen_ima...

Page 1128: ...rement print Waveform X origin s x_origin print Waveform X reference s x_reference Always 0 print Waveform Y increment s y_increment print Waveform Y origin s y_origin print Waveform Y reference s y_r...

Page 1129: ...tring def do_query_string query InfiniiVision WriteString s query True result InfiniiVision ReadString check_instrument_errors query return result Send a query check for errors return string def do_qu...

Page 1130: ...ak 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 ResourceManagerClass InfiniiVision...

Page 1131: ...e example 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 Configurat...

Page 1132: ..._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 1133: ...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 1134: ...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 1135: ...y 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...

Page 1136: ...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 1137: ...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 1138: ...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 1139: ...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 1140: ...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 1141: ...ray 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 L...

Page 1142: ...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 1143: ...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 1144: ...t 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 1145: ...rm 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 lngXReferenc...

Page 1146: ...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 1147: ...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 1148: ...number 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 1149: ...canf 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 vbL...

Page 1150: ...fy 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 Agile...

Page 1151: ...e 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 Er...

Page 1152: ...igger 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 oscillosc...

Page 1153: ...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 1154: ...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 1155: ...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 fYinc...

Page 1156: ...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 1157: ...query VisaSendCommandOrQuery strQuery Get the result string StringBuilder strResults new StringBuilder 1000 strResults VisaGetResultString Check for inst errors CheckInstrumentErrors strQuery Return...

Page 1158: ...te void VisaSendCommandOrQuery string strCommandOrQuery Send command or query to the device string strWithNewline strWithNewline String Format 0 n strCommandOrQuery int nViStatus nViStatus visa32 viPr...

Page 1159: ...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 1160: ...sourceManager 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 vi...

Page 1161: ...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 1162: ...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 1163: ...eate 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...

Page 1164: ...measurements myScope DoCommand MEASure SOURce CHANnel1 Console WriteLine Measure source 0 _ myScope DoQueryString MEASure SOURce myScope DoCommand MEASure FREQuency fResult myScope DoQueryNumber MEAS...

Page 1165: ...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 1166: ...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 1167: ...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 1168: ...result string Dim fResultsArray As Double fResultsArray VisaGetResultNumbers Check for instrument errors another command and result CheckInstrumentErrors strQuery Return string results Return fResult...

Page 1169: ...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 1170: ...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...

Page 1171: ...VISA 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 exam...

Page 1172: ...command 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...

Page 1173: ...tup 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_comma...

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

Page 1175: ...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 1176: ...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 1177: ...ammer s Guide 1177 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 1178: ...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 P...

Page 1179: ...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 1180: ...ut 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 1181: ...setup 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_comma...

Page 1182: ...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 1183: ...r_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_com...

Page 1184: ...tf 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...

Page 1185: ...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 1186: ...block 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 ieeebl...

Page 1187: ...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 1188: ...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 1189: ...urce _ 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 ed...

Page 1190: ...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 1191: ...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 1192: ...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 1193: ...umber 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...

Page 1194: ...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 1195: ...te 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 CheckInstru...

Page 1196: ...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 1197: ...ision 3000 X Series Oscilloscopes Programmer s Guide 1197 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 1198: ...bVIEW 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 on...

Page 1199: ...gramming features of your Agilent oscilloscope using System using System IO using System Text using Agilent CommandExpert ScpiNet AgInfiniiVision3000X_01_20 namespace InfiniiVision class ScpiNetInstru...

Page 1200: ...ic 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...

Page 1201: ...tsArray 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...

Page 1202: ...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 1203: ...le 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 Wri...

Page 1204: ...yScope 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...

Page 1205: ..._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 Infinii...

Page 1206: ...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 1207: ...CPI 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 byt...

Page 1208: ...PI 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 WriteLi...

Page 1209: ...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 1210: ...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 1211: ...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 1212: ...commands 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 1213: ...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 1214: ...erence 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 s...

Page 1215: ...cilloscopes Programmer s Guide 1215 scope Transport DefaultTimeout Set 10000 Initialize the oscilloscope capture data and analyze initialize capture analyze print End of program Wait for a key press b...

Page 1216: ...1216 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 39 Programming Examples...

Page 1217: ...tation color display 293 annotation text display 294 annotation display 291 apparent power 451 539 apply network printer connection settings 350 arbitrary waveform generator output 972 arbitrary wavef...

Page 1218: ...nnel coupling 257 channel display 258 channel input impedance 259 channel inversion 260 channel label 261 1001 channel labels 297 298 channel numbers 1007 channel overload 268 channel protection 268 c...

Page 1219: ...r reset conditions 168 824 cursor source 367 369 cursor time 1019 1023 1024 cursor units X 371 372 cursor units Y 376 377 cursors track measurements 420 cursors how autoscale affects 185 cursors X1 X2...

Page 1220: ...nd of text terminator 1090 erase data 295 erase measurements 1018 erase screen 1008 error counter ARINC 429 604 error counter ARINC 429 reset 605 error frame count CAN 620 error frame count UART 727 e...

Page 1221: ...math operation 324 g t source second input channel 326 gain for Ax B math operation 328 gateway IP 48 gaussian pulse waveform generator output 972 general SBUS n commands 597 general SEARch commands 7...

Page 1222: ...ds 364 introduction to MEASure commands 388 introduction to POD n commands 501 introduction to RECall commands 566 introduction to SAVE commands 575 introduction to SBUS commands 595 introduction to S...

Page 1223: ...ure preshoot 413 measure start voltage 1029 measure stop voltage 1030 measure value at a specified time 441 measure value at top of waveform 442 measurement error 388 measurement record 938 measuremen...

Page 1224: ...1025 offset 311 offset for Ax B math operation 329 offset value for channel voltage 262 offset value for selected function 330 334 offset waveform generator 984 one values in waveform data 933 OPC Op...

Page 1225: ...ry save operations 586 preset conditions 824 preshoot measured on waveform 413 previously stored configuration 167 print command 207 print job start 357 print mask test failures 488 print query 1039 p...

Page 1226: ...sis 529 RMS value measurement 440 roll time base mode 833 root commands 179 182 root level commands 3 RQL Request Control status bit 158 160 RQS Request Service 175 RS 232 UART triggering 596 RST Rese...

Page 1227: ...sion 162 source 421 609 628 688 source voltage or current for slew rate analysis 551 source channel M1553 700 source for function 1010 source for glitch search 757 source for Nth edge burst trigger 86...

Page 1228: ...838 TIMebase MODE 62 time ordered label list 298 timeout SPI clock 708 timing measurement 388 title channels 261 title mask test 500 tolerance automask 476 477 top of waveform value measured 442 tota...

Page 1229: ...ital pod 190 turn off math function 190 turn off time 457 533 turn on channel labels 297 turn on channel number display 1007 turn on time 458 533 turn on turn off time analysis 530 531 532 533 turning...

Page 1230: ...nerator square wave duty cycle 975 waveform introduction 925 waveform maximum vertical value measured 436 waveform minimum vertical value measured 437 waveform must cross voltage level to be an occurr...

Page 1231: ...Index Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide 1231 zoomed window horizontal scale 841...

Page 1232: ...1232 Agilent InfiniiVision 3000 X Series Oscilloscopes Programmer s Guide Index...

Reviews:

No comments

Brands by name

Popular brands

Load more brands