background image

210

Agilent InfiniiVision 7000A Series Oscilloscopes Programmer's Guide

5

Commands by Subsystem

 

:CALibrate:LABel

 (see 

page 786

)

Command Syntax

:CALibrate:LABel <string>

<string> ::= quoted ASCII string of up to 32 characters in length,

not including the quotes

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

Query Syntax

:CALibrate:LABel?

The :CALibrate:LABel? query returns the contents of the calibration label 
string.

Return Format

<string><NL>

<string>::= unquoted ASCII string of up to 32 characters in length

See Also

"Introduction to :CALibrate Commands" 

on page 207

Summary of Contents for InfiniiVision 7000A Series

Page 1: ...Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide...

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

Page 3: ...commands and syntax The next chapters provide reference information Chapter 5 Chapter 5 Commands by Subsystem starting on page 111 describes the set of commands that belong to an individual subsystem...

Page 4: ...mming commands Finally there is a chapter that contains programming examples Chapter 12 Chapter 12 Programming Examples starting on page 811 Mixed Signal Oscilloscope Channel Differences Because both...

Page 5: ...rsion 5 15 30 What s New in Version 5 10 32 Version 5 00 at Introduction 33 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 36 Step 2 Connect and set up the oscilloscope 37 Using the U...

Page 6: ...ite Length Block Query Response Data 54 Sending Multiple Queries and Reading Results 55 Checking Instrument Status 56 Other Ways of Sending Commands 57 Telnet Sockets 57 Sending SCPI Commands Using Br...

Page 7: ...152 HWERegister CONDition Hardware Event Condition Register 154 HWERegister EVENt Hardware Event Event Register 156 MERGe 158 MTEenable Mask Test Event Enable Register 159 MTERegister EVENt Mask Test...

Page 8: ...ABel 205 BUS n MASK 206 CALibrate Commands 207 CALibrate DATE 209 CALibrate LABel 210 CALibrate OUTPut 211 CALibrate STARt 212 CALibrate STATus 213 CALibrate SWITch 214 CALibrate TEMPerature 215 CALib...

Page 9: ...PERSistence 251 DISPlay SOURce 252 DISPlay VECTors 253 EXTernal Trigger Commands 254 EXTernal BWLimit 256 EXTernal IMPedance 257 EXTernal PROBe 258 EXTernal PROBe ID 259 EXTernal PROBe STYPe 260 EXTe...

Page 10: ...Ter DISPlay 294 MARKer Commands 295 MARKer MODE 297 MARKer X1Position 298 MARKer X1Y1source 299 MARKer X2Position 300 MARKer X2Y2source 301 MARKer XDELta 302 MARKer Y1Position 303 MARKer Y2Position 30...

Page 11: ...ure VRATio 352 MEASure VRMS 353 MEASure VTIMe 354 MEASure VTOP 355 MEASure XMAX 356 MEASure XMIN 357 MTESt Commands 358 MTESt AMASk CREate 363 MTESt AMASk SOURce 364 MTESt AMASk UNITs 365 MTESt AMASk...

Page 12: ...e 398 RECall IMAGe STARt 399 RECall MASK STARt 400 RECall PWD 401 RECall SETup STARt 402 SAVE Commands 403 SAVE FILename 405 SAVE IMAGe STARt 406 SAVE IMAGe AREA 407 SAVE IMAGe FACTors 408 SAVE IMAGe...

Page 13: ...BASE 439 SBUS UART COUNt ERRor 440 SBUS UART COUNt RESet 441 SBUS UART COUNt RXFRames 442 SBUS UART COUNt TXFRames 443 SBUS UART FRAMing 444 SYSTem Commands 445 SYSTem DATE 446 SYSTem DSP 447 SYSTem...

Page 14: ...Gger DURation GREaterthan 490 TRIGger DURation LESSthan 491 TRIGger DURation PATTern 492 TRIGger DURation QUALifier 493 TRIGger DURation RANGe 494 TRIGger EBURst Commands 495 TRIGger EBURst COUNt 496...

Page 15: ...IGger I2S RANGe 534 TRIGger I2S RWIDth 536 TRIGger I2S SOURce CLOCk 537 TRIGger I2S SOURce DATA 538 TRIGger I2S SOURce WSELect 539 TRIGger I2S TRIGger 540 TRIGger I2S TWIDth 542 TRIGger I2S WSLow 543...

Page 16: ...Gger SEQuence TRIGger 580 TRIGger SPI Commands 581 TRIGger SPI CLOCk SLOPe 582 TRIGger SPI CLOCk TIMeout 583 TRIGger SPI FRAMing 584 TRIGger SPI PATTern DATA 585 TRIGger SPI PATTern WIDTh 586 TRIGger...

Page 17: ...Veform POINts 629 WAVeform POINts MODE 631 WAVeform PREamble 633 WAVeform SEGMented COUNt 636 WAVeform SEGMented TTAG 637 WAVeform SOURce 638 WAVeform SOURce SUBSource 642 WAVeform TYPE 643 WAVeform U...

Page 18: ...MEASure TDELta 715 MEASure THResholds 716 MEASure TMAX 717 MEASure TMIN 718 MEASure TSTArt 719 MEASure TSTOp 720 MEASure TVOLt 721 MEASure UPPer 723 MEASure VDELta 724 MEASure VSTArt 725 MEASure VSTOp...

Page 19: ...Register OPERegister CONDition 767 Arm Event Register AER 768 Overload Event Register OVLRegister 769 Hardware Event Event Register HWERegister EVENt 770 Hardware Event Condition Register HWERegister...

Page 20: ...onics 805 Tree Traversal Rules and Multiple Commands 806 Query Return Values 808 All Oscilloscope Commands Are Sequential 809 12 Programming Examples VISA COM Examples 812 VISA COM Example in Visual B...

Page 21: ...eries Oscilloscopes Programmer s Guide 1 What s New What s New in Version 6 00 22 What s New in Version 5 25 25 What s New in Version 5 20 27 What s New in Version 5 15 30 What s New in Version 5 10 3...

Page 22: ...PI BITorder see page 437 Selects the bit order used when displaying data in the SPI serial decode waveform and in the Lister SYSTem PRECision see page 450 Allows measurements and math functions to be...

Page 23: ...pecify 4 000 000 or 8 000 000 points in place of the previous 5 000 000 option WAVeform POINts MODE see page 631 Command syntax is the same but the NORMal mode returns The measurement record when SYST...

Page 24: ...ime triggering not supported by new FLX option TRIGger FLEXray TIME SEGM ent none Time triggering not supported by new FLX option TRIGger FLEXray TIME SLOT none Time triggering not supported by new FL...

Page 25: ...TESt RMODe FACTion MEASure see page 378 Lets you enable or disable measurements on mask test failures SAVE LISTer STARt see page 412 Saves the Lister display data to a file SBUS I2S BASE see page 432...

Page 26: ...S serial bus decode mode TRIGger FLEXray TRIGger see page 516 You can now select FlexRay EVENt triggers TRIGger LIN TRIGger see page 565 You can now select the DATA option for triggering on a LIN fram...

Page 27: ...statistics values MEASure STATistics see page 339 Sets the type of measurement statistics to return MEASure STATistics INCRement see page 340 Updates the statistics once incrementing the count by one...

Page 28: ...directory in addition to querying for this information SAVE WAVeform STARt see page 406 The file extension specified will change the SAVE WAVeform FORMat setting if it is a valid waveform file extens...

Page 29: ...MTESt RMODe FACTion STO P see page 381 MTESt STARt STOP see page 733 RUN see page 174 or STOP see page 178 MTESt TRIGger SOURce see page 734 TRIGger Commands see page 467 There are various commands f...

Page 30: ...an be used as the input to the FFT INTegrate DIFFerentiate and SQRT functions FUNCtion GOFT SOURce1 see page 270 Selects the first input channel for the g t source FUNCtion GOFT SOURce2 see page 271 S...

Page 31: ...t the high resolution acquisition mode with the ACQuire TYPE HRESolution command instead FUNCtion OPERation see page 273 The ADD parameter is new and now that waveform math can be performed using chan...

Page 32: ...mands appear below New Commands Changed Commands Command Description ACQuire SEGMented COUNt see page 191 Sets the number of memory segments ACQuire SEGMented INDex see page 192 Selects the segmented...

Page 33: ...s Guide 33 Version 5 00 at Introduction The Agilent InfiniiVision 7000 Series oscilloscopes were introduced with version 5 00 of oscilloscope operating software The command set is based on the 6000 S...

Page 34: ...34 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 1 What s New...

Page 35: ...IO Libraries Suite software 36 Step 2 Connect and set up the oscilloscope 37 Step 3 Verify the oscilloscope connection 39 This chapter explains how to install the Agilent IO Libraries Suite software c...

Page 36: ...l Agilent IO Libraries Suite software Insert the Automation Ready CD that was shipped with your oscilloscope into the controller PC s CD ROM drive and follow its installation instructions You can also...

Page 37: ...oscilloscope This is a USB 2 0 high speed port 2 On the oscilloscope verify that the controller interface is enabled a Press the Utility button b Using the softkeys press I O and Control c Ensure the...

Page 38: ...N interface a Press the Configure softkey until LAN is selected b Press the LAN Settings softkey c Press the Addresses softkey Use the IP Options softkey and the Entry knob to select DHCP AutoIP or ne...

Page 39: ...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 40: ...cilloscopes 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 on...

Page 41: ...es Oscilloscopes Programmer s Guide 41 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 42: ...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 43: ...end 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 E...

Page 44: ...44 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 2 Setting Up...

Page 45: ...rogramming the 7000 Series oscilloscopes It describes basic oscilloscope program structure and shows how to program the oscilloscope using a few simple examples The getting started examples show how t...

Page 46: ...m the front panel of the oscilloscope Program initialization defines and initializes variables allocates memory or tests system configuration Controller initialization ensures that the interface to th...

Page 47: ...before you make a measurement Agilent does not recommend this because the needed length of the wait loop may vary causing your program to fail DIGitize on the other hand ensures that data capture is...

Page 48: ...meric Variables on page 54 Reading Definite Length Block Query Response Data on page 54 Sending Multiple Queries and Reading Results on page 55 Checking Instrument Status on page 56 Referencing the IO...

Page 49: ...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 50: ...mmand performs a very useful function for unknown waveforms by setting up the vertical channel time base and trigger level of the instrument The syntax for the autoscale command is myScope WriteString...

Page 51: ...ull scale with center screen at 0 4 volts with 10 1 probe attenuation and DC coupling myScope WriteString CHANnel1 PROBe 10 Probe attenuation to 10 1 myScope WriteString CHANnel1 RANGe 1 6 Vertical ra...

Page 52: ...eString 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 comm...

Page 53: ...has a format specification for handling the response message When using the VISA COM library in Visual Basic you use different read methods ReadString ReadNumber ReadList or ReadIEEEBlock for the var...

Page 54: ...WriteString CHANnel1 RANGe Dim varQueryResult As Variant strQueryResult myScope ReadNumber MsgBox Range variant CStr varQueryResult After running this program the controller displays Range variant 40...

Page 55: ...ery result This can be accomplished by reading them back into a single string variable multiple string variables or multiple numeric variables For example to read the TIMebase RANGe DELay query result...

Page 56: ...mands myScope WriteString TIMebase RANGe DELay Dim varResults As Variant varResults myScope ReadList MsgBox Timebase range FormatNumber varResults 0 1000 4 _ ms delay FormatNumber varResults 1 1000000...

Page 57: ...socket issue the following command telnet hostname 5024 where hostname is the hostname of the oscilloscope This will give you a command line with prompt For a command line without a prompt use port 50...

Page 58: ...58 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 3 Getting Started...

Page 59: ...59 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference Command Summary 60 Syntax Elements 108...

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

Page 61: ...Conformance reserved reserved I2S Serial FlexRay Trigger Decode reserved reserved MIL STD 1553 Trigger Decode reserved All field 0 All reserved 0 Factory MSO 0 MSO Upgraded MSO 0 MSO Xilinx FPGA Probe...

Page 62: ...4 16 MAV Message Available 3 8 Not used 2 4 MSG Message 1 2 USR User 0 1 TRG Trigger n a STB see page 134 value 0 to 255 an integer in NR1 format as shown in the following Bit Weight Name 1 Indicates...

Page 63: ...for MSO models source can be repeated up to 5 times n 1 2 or 1 4 in NR1 format AUToscale AMODE value see page 146 AUToscale AMODE see page 146 value NORMal CURRent AUToscale CHANnels value see page 14...

Page 64: ...rmat n a OPERregister CONDiti on see page 165 n 16 bit integer in NR1 format n a OPERegister EVENt see page 167 n 16 bit integer in NR1 format OVLenable mask see page 169 OVLenable see page 170 mask 1...

Page 65: ...models source CHANnel n DIGital0 DIGital15 PMEMory 0 1 2 3 4 5 6 7 8 9 POD 1 2 BUS 1 2 FUNCtion MATH SBUS for MSO models n 1 2 or 1 4 in NR1 format Table 3 Root Commands Summary continued Command Quer...

Page 66: ...SGM n a ACQuire SRATe see page 195 sample_rate sample rate samples s in NR3 format ACQuire TYPE type see page 196 ACQuire TYPE see page 196 type NORMal AVERage HRESolution PEAK Table 4 ACQuire Comman...

Page 67: ...R1 format Table 5 BUS n Commands Summary continued Command Query Options and Query Returns Table 6 CALibrate Commands Summary Command Query Options and Query Returns n a CALibrate DATE see page 209 re...

Page 68: ...age 222 0 1 n 1 2 or 1 4 in NR1 format CHANnel n IMPedance impedance see page 223 CHANnel n IMPedance see page 223 impedance ONEMeg FIFTy n 1 2 or 1 4 in NR1 format CHANnel n INVert 0 OFF 1 ON see pag...

Page 69: ...full scale range value in NR3 format suffix V mV n 1 2 or 1 4 in NR1 format CHANnel n SCALe scale suffix see page 234 CHANnel n SCALe see page 234 scale Vertical units per division value in NR3 forma...

Page 70: ...uffix V mV uV Table 8 DIGital n Commands Summary continued Command Query Options and Query Returns Table 9 DISPlay Commands Summary Command Query Options and Query Returns DISPlay CLEar see page 246 n...

Page 71: ...page 256 EXTernal BWLimit see page 256 bwlimit 0 OFF EXTernal IMPedance value see page 257 EXTernal IMPedance see page 257 impedance ONEMeg FIFTy EXTernal PROBe attenuation see page 258 EXTernal PROBe...

Page 72: ...dels FUNCtion GOFT SOURce 2 source see page 271 FUNCtion GOFT SOURce 2 see page 271 source CHANnel n n 1 2 3 4 for 4ch models depending on SOURce1 selection n 1 2 for 2ch models FUNCtion OFFSet offset...

Page 73: ...ions FUNCtion SOURce2 source see page 278 FUNCtion SOURce2 see page 278 source CHANnel n NONE n 1 2 3 4 for 4ch models depending on SOURce1 selection n 1 2 for 2ch models FUNCtion SPAN span see page 2...

Page 74: ...y PALette palette see page 289 HARDcopy PALette see page 289 palette COLor GRAYscale NONE n a HARDcopy PRINter LIS T see page 290 list printer_spec printer_spec printer_spec index active name index in...

Page 75: ...e 300 MARKer X2Position see page 300 position X2 cursor position value in NR3 format suffix s ms us ns ps Hz kHz MHz return_value X2 cursor position value in NR3 format MARKer X2Y2source source see pa...

Page 76: ...pec2 edge_spec1 slope occurrence edge_spec2 slope occurrence slope occurrence integer MEASure DEFine THResholds threshold spec see page 316 MEASure DEFine THResholds see page 317 threshold spec STANda...

Page 77: ...in NR3 format MEASure NWIDth source see page 324 MEASure NWIDth source see page 324 source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2...

Page 78: ...n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format return_value width of positive pulse in seconds in NR3 format n a MEASure RE...

Page 79: ...Tistics see page 339 type ON 1 CURRent MEAN MINimum MAXimum STDDev COUNt ON all statistics returned MEASure STATistics I NCRement see page 340 n a n a MEASure STATistics R ESet see page 341 n a n a n...

Page 80: ...waveform in volts in NR3 format MEASure VAVerage source see page 347 MEASure VAVerage source see page 347 source CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value calculated average vol...

Page 81: ...e page 354 vtime displayed time from trigger in seconds in NR3 format return_value voltage at the specified time in NR3 format source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 D...

Page 82: ...367 MTESt AMASk YDELta see page 367 value Y delta value in NR3 format n a MTESt COUNt FWAVefor ms CHANnel n see page 368 failed number of failed waveforms in NR1 format MTESt COUNt RESet see page 369...

Page 83: ...ODe TIME seconds see page 383 MTESt RMODe TIME see page 383 seconds from 1 to 86400 in NR3 format MTESt RMODe WAVeform s count see page 384 MTESt RMODe WAVeform s see page 384 count number of waveform...

Page 84: ...rmat POD n SIZE value see page 394 POD n SIZE see page 394 value SMALl MEDium LARGe POD n THReshold type suffix see page 395 POD n THReshold see page 395 n 1 2 in NR1 format type CMOS ECL TTL user def...

Page 85: ...e page 405 SAVE FILename see page 405 base_name quoted ASCII string SAVE IMAGe STARt file_spec see page 406 n a file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quo...

Page 86: ...ng SAVE WAVeform FORMat format see page 417 SAVE WAVeform FORMat see page 417 format ALB ASCiixy CSV BINary NONE SAVE WAVeform LENGth length see page 418 SAVE WAVeform LENGth see page 418 length 100 t...

Page 87: ...IIC ASIZe see page 433 size BIT7 BIT8 SBUS LIN PARity 0 OFF 1 ON see page 434 SBUS LIN PARity see page 434 0 1 SBUS M1553 BASE base see page 435 SBUS M1553 BASE see page 435 base DECimal HEX SBUS MOD...

Page 88: ...Command Query Options and Query Returns SYSTem DATE date see page 446 SYSTem DATE see page 446 date year month day year 4 digit year in NR1 format month 1 12 JANuary FEBruary MARch APRil MAY JUNe JULy...

Page 89: ...ebase RANGe see page 459 range_value 5 ns through 500 s in NR3 format TIMebase REFClock 0 OFF 1 ON see page 460 TIMebase REFClock see page 460 0 1 TIMebase REFerence LEFT CENTer RIGHt see page 461 TIM...

Page 90: ...tion I2S IIC EBURst LIN M1553 SEQuence SPI TV UART USB FLEXray return_value mode none none query returns NONE if the TIMebase MODE is ROLL or XY TRIGger NREJect 0 OFF 1 ON see page 474 TRIGger NREJect...

Page 91: ...e 481 length integer from 1 to 8 in NR1 format with Option AMS TRIGger CAN PATTern ID value mask see page 482 TRIGger CAN PATTern ID see page 482 value 32 bit integer in decimal nondecimal or string w...

Page 92: ...greater than time suffix see page 490 TRIGger DURation GRE aterthan see page 490 greater_than_time floating point number in NR3 format suffix s ms us ns ps TRIGger DURation LES Sthan less than time su...

Page 93: ...ing see page 500 AC DC LF TRIGger EDGE LEVel level source see page 501 TRIGger EDGE LEVel source see page 501 For internal triggers level 75 x full scale voltage from center screen in NR3 format For...

Page 94: ...Keup TSS FES DTS BSS TRIGger FLEXray FRAM e CCBase cycle_count_base see page 511 TRIGger FLEXray FRAM e CCBase see page 511 cycle_count_base integer from 0 63 TRIGger FLEXray FRAM e CCRepetition cycle...

Page 95: ...ernal triggers DSO models level external range setting in NR3 format For digital channels MSO models level 8 V source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO mode...

Page 96: ...er I2S PATTern DATA see page 532 string n where n 32 bit integer in signed decimal when base DECimal string nn n where n 0 1 X when base BINary string 0xnn n where n 0 9 A F X when base HEX TRIGger I2...

Page 97: ...t TRIGger I2S TRIGger operator see page 540 TRIGger I2S TRIGger see page 540 operator EQUal NOTequal LESSthan GREaterthan INRange OUTRange INCReasing DECReasing TRIGger I2S TWIDth word_size see page 5...

Page 98: ...er TYPE type see page 551 TRIGger IIC TRIGger TYPE see page 551 type STARt STOP READ7 READEprom WRITe7 WRITe10 NACKnowledge ANACknowledge R7Data2 W7Data2 RESTart Table 31 TRIGger IIC Commands Summary...

Page 99: ...urce see page 562 TRIGger LIN SOURce see page 562 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 or 1 4 in NR1 format TRIGger LIN STANdard std see pa...

Page 100: ...nds Summary continued Command Query Options and Query Returns Table 34 TRIGger SEQuence Commands Summary Command Query Options and Query Returns TRIGger SEQuence COU Nt count see page 574 TRIGger SEQu...

Page 101: ...DGE2 PATTern2 AND EDGE2 EDGE2 COUNt EDGE2 COUNt NREFind Table 34 TRIGger SEQuence Commands Summary continued Command Query Options and Query Returns Table 35 TRIGger SPI Commands Summary Command Query...

Page 102: ...els n 1 2 or 1 4 in NR1 format Table 35 TRIGger SPI Commands Summary continued Command Query Options and Query Returns Table 36 TRIGger TV Commands Summary Command Query Options and Query Returns TRIG...

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

Page 104: ...Summary continued Command Query Options and Query Returns Table 38 TRIGger USB Commands Summary Command Query Options and Query Returns TRIGger USB SOURce D MINus source see page 612 TRIGger USB SOURc...

Page 105: ...data the syntax would be 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 bytes of data is the actual data WAVeform FORMat v...

Page 106: ...C OUNt see page 636 count an integer from 2 to 2000 in NR1 format with Option SGM n a WAVeform SEGMented T TAG see page 637 time_tag in NR3 format with Option SGM WAVeform SOURce source see page 638 W...

Page 107: ...n a WAVeform XREFerence see page 648 return_value 0 x reference value in the current preamble in NR1 format n a WAVeform YINCrement see page 649 return_value y increment value in the current preamble...

Page 108: ...h Block Response Data on page 109 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 d...

Page 109: ...xample 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 retu...

Page 110: ...00A Series Oscilloscopes Programmer s Guide 4 Commands Quick Reference 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 byte...

Page 111: ...l n Commands on page 217 Control all oscilloscope functions associated with individual analog channels or groups of channels DIGital n Commands on page 237 Control all oscilloscope functions associate...

Page 112: ...mands on page 306 Select automatic measurements to be made and control time markers MTESt Commands on page 358 Control the mask test features provided with Option LMT POD Commands on page 392 Control...

Page 113: ...4 URQ User Request 5 32 CME Command Error 4 16 EXE Execution Error 3 8 DDE Dev Dependent Error 2 4 QYE Query Error 1 2 RQL Request Control 0 1 OPC Operation Complete n a ESR see page 120 status 0 to 2...

Page 114: ...nformance reserved reserved I2S Serial FlexRay Trigger Decode reserved reserved MIL STD 1553 Trigger Decode reserved All field 0 All reserved 0 Factory MSO 0 MSO Upgraded MSO 0 MSO Xilinx FPGA Probe 0...

Page 115: ...16 MAV Message Available 3 8 Not used 2 4 MSG Message 1 2 USR User 0 1 TRG Trigger n a STB see page 134 value 0 to 255 an integer in NR1 format as shown in the following Bit Weight Name 1 Indicates 7...

Page 116: ...eceived by the instrument the instrument remains in the selected subsystem For example if the program message ACQuire TYPE AVERage CLS COUNt 256 is received by the instrument the instrument sets the a...

Page 117: ...error queue and the Request for OPC flag See Also Introduction to Common Commands on page 116 STB Read Status Byte on page 134 ESE Standard Event Status Enable on page 118 ESR Standard Event Status R...

Page 118: ...t in the Standard Event Status Register A zero disables the bit Table 41 Standard Event Status Enable ESE Bit Name Description When Set 1 High True Enables 7 PON Power On Event when an OFF to ON trans...

Page 119: ...gument 0 255 an integer in NR1 format See Also Introduction to Common Commands on page 116 ESR Standard Event Status Register on page 120 OPC Operation Complete on page 124 CLS Clear Status on page 11...

Page 120: ...hows bit weight name and condition for each bit Table 42 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 UR...

Page 121: ...t Status Enable on page 118 OPC Operation Complete on page 124 CLS Clear Status on page 117 SYSTem ERRor on page 448 1 RQL Request Control The device is requesting control Not used 0 OPC Operation Com...

Page 122: ...DN 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...

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

Page 124: ...gister 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...

Page 125: ...ltera FPGA Probe FlexRay Serial Power Measurements RS 232 UART Serial reserved Segmented Memory Mask Test reserved reserved FlexRay Conformance reserved reserved I2S Serial FlexRay Trigger Decode rese...

Page 126: ...is a mixed signal oscilloscope and if so whether it was factory installed or upgraded from an analog channels only oscilloscope DSO The OPT query returns the following See Also Introduction to Common...

Page 127: ...pes Programmer s Guide 127 RCL Recall see page 786 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 A...

Page 128: ...ument in a known state Reset conditions are Acquire Menu Mode Normal Realtime On Averaging Off Averages 8 Analog Channel Menu Channel 1 On Channel 2 Off Volts division 5 00 V Offset 0 00 Coupling DC P...

Page 129: ...ld TTL 1 4V Display Menu Definite persistence Off Grid 33 Vectors On Quick Meas Menu Source Channel 1 Run Control Scope is running Time Base Menu Main time division 100 us Main time base delay 0 00 s...

Page 130: ...following initialization commands are initialized by RST It is not necessary to reinitialize them unless the default setting is not suitable for your application myScope WriteString RST Reset the osci...

Page 131: ...AV Save see page 786 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 th...

Page 132: ...ne in the Service Request Enable Register enables the corresponding bit in the Status Byte Register A zero disables the bit Table 43 Service Request Enable Register SRE Bit Name Description When Set 1...

Page 133: ...atus Byte on page 134 CLS Clear Status on page 117 5 ESB Event Status Bit Interrupts when enabled conditions in the Standard Event Status Register ESR occur 4 MAV Message Available Interrupts when mes...

Page 134: ...has at least one reason for requesting service Return Format value NL value 0 255 an integer in NR1 format Table 44 Status Byte Register STB Bit Name Description When Set 1 High True Indicates 7 OPER...

Page 135: ...service 5 ESB Event Status Bit An enabled condition in the Standard Event Status Register ESR has occurred 4 MAV Message Available There are messages in the Output Queue 3 Not used always 0 2 MSG Mes...

Page 136: ...s Guide 5 Commands by Subsystem TRG Trigger see page 786 Command Syntax TRG The TRG command has the same effect as the DIGitize command with no parameters See Also Introduction to Common Commands on...

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

Page 138: ...rogrammer s Guide 5 Commands by Subsystem WAI Wait To Continue see page 786 Command Syntax WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instrument...

Page 139: ...ows 32 bit integer in NR1 format n a AER see page 143 0 1 an integer in NR1 format AUToscale source source see page 144 n a source CHANnel n for DSO models source CHANnel n DIGital0 DIGital15 POD1 POD...

Page 140: ...pixel memory PMEMory 0 1 2 3 4 5 6 7 8 9 MTEenable n see page 159 MTEenable see page 159 n 16 bit integer in NR1 format n a MTERegister EVENt see page 161 n 16 bit integer in NR1 format OPEE n see pag...

Page 141: ...ion print option COLor GRAYscale PRINter0 BMP8bit BMP PNG NOFactors FACTors print option can be repeated up to 5 times RUN see page 174 n a n a n a SERial see page 175 return value unquoted string con...

Page 142: ...teger in NR1 format bit 0 DIGital 0 bit 15 DIGital 15 See Also Introduction to Root Commands on page 141 POD n THReshold on page 395 DIGital n THReshold on page 243 NOTE Because the ACTivity query ret...

Page 143: ...ation 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 Ser...

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

Page 145: ...ge 141 AUToscale CHANnels on page 147 AUToscale AMODE on page 146 Example Code AUTOSCALE This command evaluates all the input signals and sets the correct conditions to display all of the active signa...

Page 146: ...RMal 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 co...

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

Page 148: ...specified channel 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 141 CDISplay on page 149 CHAN...

Page 149: ...command clears the display and resets all associated measurements If the oscilloscope is stopped all currently displayed data is erased If the oscilloscope is running all the data in active channels...

Page 150: ...troduction to Root Commands on page 141 RUN on page 174 SINGle on page 176 STOP on page 178 ACQuire Commands on page 181 WAVeform Commands on page 616 Example Code DIGITIZE Used to acquire the wavefor...

Page 151: ...ed on a single trigger Keep in mind when the oscilloscope is running communication with the computer interrupts data acquisition Setting up the oscilloscope over the bus causes the data buffers to be...

Page 152: ...current value contained in the Hardware Event Enable register as an integer number Return Format value NL value integer in NR1 format To HWE bit in Operation Status Condition Register OR Bat ON HWEReg...

Page 153: ...e 141 AER Arm Event Register on page 143 CHANnel n PROTection on page 232 EXTernal PROTection on page 261 OPERegister EVENt Operation Status Event Register on page 167 OVLenable Overload Event Enable...

Page 154: ...page 261 OPEE Operation Status Enable Register on page 163 OPERegister EVENt Operation Status Event Register on page 167 To HWE bit in Operation Status Condition Register OR Bat ON HWERegister CONDit...

Page 155: ...finiiVision 7000A Series Oscilloscopes Programmer s Guide 155 OVLenable Overload Event Enable Register on page 169 OVLRegister Overload Event Register on page 171 STB Read Status Byte on page 134 SRE...

Page 156: ...EXTernal PROTection on page 261 OPEE Operation Status Enable Register on page 163 To HWE bit in Operation Status Condition Register OR Bat ON HWERegister CONDition Hardware Event Condition Register H...

Page 157: ...pes Programmer s Guide 157 OPERegister CONDition Operation Status Condition Register on page 165 OVLenable Overload Event Enable Register on page 169 OVLRegister Overload Event Register on page 171 ST...

Page 158: ...EMory8 PMEMory9 The MERGe command stores the contents of the active display in the specified pixel memory The previous contents of the pixel memory are overwritten The pixel memories are PMEMory0 thro...

Page 159: ...query returns the current value contained in the Mask Test Event Enable register as an integer number To MTE bit in Operation Status Condition Register OR MTEenable MTEenable Mask Test Event Enable Ma...

Page 160: ...on to Root Commands on page 141 AER Arm Event Register on page 143 CHANnel n PROTection on page 232 EXTernal PROTection on page 261 OPERegister EVENt Operation Status Event Register on page 167 OVLena...

Page 161: ...PROTection on page 232 EXTernal PROTection on page 261 To MTE bit in Operation Status Condition Register OR MTEenable MTEenable Mask Test Event Enable Mask Register 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14...

Page 162: ...m OPEE Operation Status Enable Register on page 163 OPERegister CONDition Operation Status Condition Register on page 165 OVLenable Overload Event Enable Register on page 169 OVLRegister Overload Even...

Page 163: ...OPEReration CONDition Operation Status Condition Register OPEE OPEE Operation Status Enable Mask Register From Overload Event Registers To OPER bit in Status Byte Register OVLR OR 1 0 2 3 4 5 6 7 9 8...

Page 164: ...ge 143 CHANnel n PROTection on page 232 EXTernal PROTection on page 261 OPERegister EVENt Operation Status Event Register on page 167 OVLenable Overload Event Enable Register on page 169 OVLRegister O...

Page 165: ...Mask Register From Overload Event Registers To OPER bit in Status Byte Register OVLR OR 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14 15 Wait Trig Run OPERation EVENt Operation Status Event Register OVLR HWE 11...

Page 166: ...OVLenable Overload Event Enable Register on page 169 OVLRegister Overload Event Register on page 171 STB Read Status Byte on page 134 SRE Service Request Enable on page 132 HWERegister EVENt Hardware...

Page 167: ...ister From Overload Event Registers To OPER bit in Status Byte Register OVLR OR 1 0 2 3 4 5 6 7 9 8 10 11 12 13 14 15 Wait Trig Run OPERation EVENt Operation Status Event Register OVLR HWE 11 5 3 From...

Page 168: ...Overload Event Enable Register on page 169 OVLRegister Overload Event Register on page 171 STB Read Status Byte on page 134 SRE Service Request Enable on page 132 HWERegister EVENt Hardware Event Even...

Page 169: ...NOTE You can set analog channel input impedance to 50 on the 300 MHz 500 MHz and 1 GHz bandwidth oscilloscope models On these same bandwidth models if there are only two analog channels you can also...

Page 170: ...ster EVENt Operation Status Event Register on page 167 OVLRegister Overload Event Register on page 171 STB Read Status Byte on page 134 SRE Service Request Enable on page 132 7 Channel 2 Fault Event w...

Page 171: ...ere are only two analog channels you can also set external trigger input impedance to 50 9 8 10 11 12 13 14 15 To OVLR bit in Operation Status Register OR 1 0 2 3 4 5 6 7 OVLR Overload Event Register...

Page 172: ...enable Overload Event Enable Register on page 169 STB Read Status Byte on page 134 SRE Service Request Enable on page 132 4 External Trigger OVL Overload has occurred on External Trigger input 3 Chann...

Page 173: ...eter may be repeated up to 5 times The PRINt command formats the output according to the currently selected format device If an option is not specified the value selected in the Print Config menu is u...

Page 174: ...nel See Also Introduction to Root Commands on page 141 SINGle on page 176 STOP on page 178 Example Code RUN_STOP not executed in this example RUN starts the data acquisition for the active waveform di...

Page 175: ...ision 7000A Series Oscilloscopes Programmer s Guide 175 SERial see page 786 Query Syntax SERial The SERial query returns the serial number of the instrument Return Format Unquoted string NL See Also I...

Page 176: ...s by Subsystem SINGle see page 786 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...

Page 177: ...n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The STATus query reports whether the channel function trace memory or serial decode bus specified by s...

Page 178: ...nds by Subsystem STOP see page 786 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 pag...

Page 179: ...curred 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...

Page 180: ...fied channel function trace memory or serial decode bus See Also Introduction to Root Commands on page 141 BLANk on page 148 CHANnel n DISPlay on page 222 DIGital n DISPlay on page 239 FUNCtion DISPla...

Page 181: ...t see page 185 count an integer from 2 to 65536 in NR1 format ACQuire DAALias mode see page 186 ACQuire DAALias see page 186 mode DISable AUTO ACQuire MODE mode see page 187 ACQuire MODE see page 187...

Page 182: ...slower sweep speeds where the digitizer samples faster than needed to fill memory for the displayed time range Instead of decimating samples they are averaged together to provide the value for one dis...

Page 183: ...age 786 Query Syntax ACQuire AALias The ACQuire AALias query returns the current state of the oscilloscope acquisition anti alias control This control can be directly disabled or disabled automaticall...

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

Page 185: ...any 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 fro...

Page 186: ...This is good for cases where dithered data is not desired When set to AUTO the oscilloscope turns off anti alias control as needed Such cases are when the FFT or differentiate math functions are silen...

Page 187: ...ep speeds Real time mode is not available when averaging ACQuire TYPE AVERage The ACQuire MODE ETIMe command sets the oscilloscope in equivalent time mode The ACQuire MODE SEGMented command sets the o...

Page 188: ...ut 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...

Page 189: ...ample clock to the oscilloscope A 10 MHz square or sine wave signal is input to the BNC connector labeled 10 MHz REF The amplitude must be between 180 mV and 1 V with an offset of between 0 V and 2 V...

Page 190: ...d 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 a...

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

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

Page 193: ...strQueryResult Set the number of segments to 50 myScope WriteString ACQuire SEGMented COUNt 50 myScope WriteString ACQuire SEGMented COUNt strQueryResult myScope ReadString Debug Print Acquisition me...

Page 194: ...CStr lngI myScope WriteString ACQuire SEGMented INDex strQueryResult myScope ReadString Debug Print Acquisition memory segment index strQueryResult Display the segment time tag myScope WriteString WAV...

Page 195: ...e page 786 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_...

Page 196: ...ode ACQuire MODE SEGMented The ACQuire TYPE HRESolution command sets the oscilloscope in the high resolution mode also known as smoothing This mode is used to reduce noise at slower sweep speeds where...

Page 197: ...page 181 ACQuire COUNt on page 185 ACQuire MODE on page 187 DIGitize on page 150 WAVeform TYPE on page 643 WAVeform PREamble on page 633 Example Code AQUIRE_TYPE Sets the acquisition mode which can b...

Page 198: ...01 channel_list 0 1 channel_list m m m where is separator and is range n 1 or 2 an integer in NR1 format m 0 15 an integer in NR1 format BUS n CLEar see page 203 n a n 1 or 2 an integer in NR1 format...

Page 199: ...rol the viewing labeling and digital channel makeup of two possible buses Reporting the Setup Use BUS n to query setup information for the BUS subsystem Return Format The following is a sample respons...

Page 200: ...selected bus If the parameter is a 1 ON the bit is included in the definition If the parameter is a 0 OFF the bit is excluded from the definition Note BIT0 15 correspond to DIGital0 15 Query Syntax B...

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

Page 202: ...202 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 5 Commands by Subsystem Include digital channels 1 through 5 8 and 14 in bus 1 myScope WriteString BUS1 BITS 1 5 8 14 ON...

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

Page 204: ...s 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 Re...

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

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

Page 207: ...58 CALibrate Commands Summary Command Query Options and Query Returns n a CALibrate DATE see page 209 return value day month year all in NR1 format CALibrate LABel string see page 210 CALibrate LABel...

Page 208: ...208 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 5 Commands by Subsystem Starting the user calibration procedure...

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

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

Page 211: ...e on the rear panel TRIG OUT BNC TRIGgers pulse when a trigger event occurs SOURce raw output of trigger comparator DSOurce SOURce frequency divided by 8 MASK signal from mask test indicating a succes...

Page 212: ...TARt command starts the user calibration procedure See Also Introduction to CALibrate Commands on page 207 CALibrate SWITch on page 214 NOTE Before starting the user calibration procedure you must set...

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

Page 214: ...Query Syntax CALibrate SWITch The CALibrate SWITch query returns the rear panel calibration protect CAL PROTECT switch state The value PROTected indicates calibration is disabled and UNPRotected indi...

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

Page 216: ...ide 5 Commands by Subsystem CALibrate TIME see page 786 Query Syntax CALibrate TIME The CALibrate TIME query returns the time of the last calibration Return Format date NL date hour minutes seconds in...

Page 217: ...age 223 impedance ONEMeg FIFTy n 1 2 or 1 4 in NR1 format CHANnel n INVert 0 OFF 1 ON see page 224 CHANnel n INVert see page 224 0 1 n 1 2 or 1 4 in NR1 format CHANnel n LABel string see page 225 CHAN...

Page 218: ...HANnel n PROBe SKE W see page 230 skew_value 100 ns to 100 ns in NR3 format n 1 2 or 1 4 in NR1 format CHANnel n PROBe STY Pe signal type see page 231 CHANnel n PROBe STY Pe see page 231 signal type D...

Page 219: ...CHANnel3 or CHANnel4 to query setup information for the CHANnel n subsystem Return Format The following are sample responses from the CHANnel n query In this case the query was issued following a RST...

Page 220: ...scope models n 1 2 for the two channel oscilloscope models The CHANnel n BWLimit command controls an internal low pass filter When the filter is on the bandwidth of the specified channel is limited to...

Page 221: ...ope models n 1 2 for the two channel oscilloscope models The CHANnel n COUPling command selects the input coupling for the specified channel The coupling for each analog channel can be set to AC or DC...

Page 222: ...or the two channel oscilloscope models The CHANnel n DISPlay command turns the display of the specified channel on or off Query Syntax CHANnel n DISPlay The CHANnel n DISPlay query returns the current...

Page 223: ...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 IMPedance The CHANnel n IM...

Page 224: ...oscope models n 1 2 for the two channel oscilloscope models The CHANnel n INVert command selects whether or not to invert the input signal for the specified channel The inversion may be 1 ON inverted...

Page 225: ...analog channel Return Format string NL string quoted ASCII string See Also Introduction to CHANnel n Commands on page 218 DISPlay LABel on page 249 DIGital n LABel on page 240 DISPlay LABList on page...

Page 226: ...d channel The range of legal values varies with the value set by the CHANnel n RANGe and CHANnel n SCALe commands If you set the offset to a value outside of the legal range the offset value is automa...

Page 227: ...ic measurements and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting to set the oscilloscope t...

Page 228: ...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 229: ...cilloscope models The CHANnel n PROBe ID query returns the type of probe attached to the specified oscilloscope channel Return Format probe id NL probe id unquoted ASCII string up to 11 characters Som...

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

Page 231: ...n using the 113xA Series probes and determines how offset is applied When single ended is selected the CHANnel n OFFset command changes the offset value of the probe amplifier When differential is sel...

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

Page 233: ...ANGe The CHANnel n RANGe query returns the current full scale range setting for the specified channel Return Format range_argument NL range_argument vertical full scale range value in NR3 format See A...

Page 234: ...re shown in the following table If the probe attenuation is changed the scale value is multiplied by the probe s attenuation factor Query Syntax CHANnel n SCALe The CHANnel n SCALe query returns the c...

Page 235: ...he measurement units for the connected probe Select VOLT for a voltage probe and select AMPere for a current probe Measurement results channel sensitivity and trigger level will reflect the measuremen...

Page 236: ...ur channel oscilloscope models n 1 2 for the two channel oscilloscope models The CHANnel n VERNier command specifies whether the channel s vernier fine vertical adjustment setting is ON 1 or OFF 0 Que...

Page 237: ...s DIGital n DISPlay 0 OFF 1 ON see page 239 DIGital n DISPlay see page 239 0 1 n 0 15 an integer in NR1 format DIGital n LABel string see page 240 DIGital n LABel see page 240 string any series of 10...

Page 238: ...Series Oscilloscopes Programmer s Guide 5 Commands by Subsystem Return Format The following is a sample response from the DIGital0 query In this case the query was issued following a RST command DIG0...

Page 239: ...ted by the command The DIGital n DISPlay command turns digital display on or off for the specified channel Query Syntax DIGital n DISPlay The DIGital n DISPlay query returns the current digital displa...

Page 240: ...el also adds the name to the label list in non volatile memory replacing the oldest label in the list Query Syntax DIGital n LABel The DIGital n LABel query returns the name of the specified channel R...

Page 241: ...he logic channel that is affected by the command The DIGital n POSition command sets the position of the specified channel Query Syntax DIGital n POSition The DIGital n POSition query returns the posi...

Page 242: ...ecifies the size of digital channels on the display Sizes are set for all digital channels Therefore if you set the size on digital channel 0 for example the same size is set on channels 1 through 15...

Page 243: ...ECL 1 3V The DIGital n THReshold command sets the logic threshold value for all channels grouped with the specified channel D0 D7 D8 D15 The threshold is used for triggering purposes and for displayin...

Page 244: ...rmat area palette displa y data see page 247 DISPlay DATA format area palette see page 247 format TIFF command area GRATicule command palette MONochrome command format TIFF BMP BMP8bit PNG query area...

Page 245: ...rsistence Specify labels Save and Recall display data Reporting the Setup Use DISPlay to query the setup information for the DISPlay subsystem Return Format The following is a sample response from the...

Page 246: ...CLEar command clears the display and resets all associated measurements If the oscilloscope is stopped all currently displayed data is erased If the oscilloscope is running all of the data for active...

Page 247: ...his is the same data saved using the front panel Save Recall menu or the SAV Save command Query Syntax DISPlay DATA format area palette format TIFF BMP BMP8bit PNG area GRATicule SCReen palette MONoch...

Page 248: ...out 15000 myScope WriteString DISPLAY DATA BMP SCREEN COLOR byteData myScope ReadIEEEBlock BinaryType_UI1 Output display data to a file strPath c scope data screen bmp Remove file if it exists If Len...

Page 249: ...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 244 CHAN...

Page 250: ...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 Introductio...

Page 251: ...he persistence setting MINimum indicates zero persistence and INFinite indicates infinite persistence Use the DISPlay CLEar or CDISplay root command to erase points stored by infinite persistence Quer...

Page 252: ...el memory 0 through 9 The DISPlay SOURce command specifies the default source and destination for the DISPlay DATA command and query PMEMory0 9 correspond to the INTERN_0 9 files found in the front pa...

Page 253: ...ay VECTors command turns vector display on or off When vectors are turned on the oscilloscope displays lines connecting sampled data points When vectors are turned off only the sampled data is display...

Page 254: ...t Table 64 EXTernal Trigger Commands Summary Command Query Options and Query Returns EXTernal BWLimit bwlimit see page 256 EXTernal BWLimit see page 256 bwlimit 0 OFF EXTernal IMPedance value see page...

Page 255: ...sion 7000A Series Oscilloscopes Programmer s Guide 255 The following is a sample response from the EXTernal query In this case the query was issued following a RST command EXT BWL 0 IMP ONEM RANG 8 0E...

Page 256: ...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 return...

Page 257: ...is command are ONEMeg 1 M and FIFTy 50 Query Syntax EXTernal IMPedance The EXTernal IMPedance query returns the current input impedance setting for the external trigger Return Format impedance value N...

Page 258: ...onstants for scaling the display factors and for setting trigger levels If an AutoProbe probe is connected to the oscilloscope the attenuation value cannot be changed from the sensed value Attempting...

Page 259: ...turns the type of probe attached to the external trigger input Return Format probe id NL probe id unquoted ASCII string up to 11 characters Some of the possible returned values are 1131A 1132A 1134A 1...

Page 260: ...xternal trigger probe signal type STYPe to differential or single ended when using the 113xA Series probes and determines how offset is applied Query Syntax EXTernal PROBe STYPe The EXTernal PROBe STY...

Page 261: ...used to clear reset the overload protection It allows the external trigger to be used again in 50 mode after the signal that caused the overload has been removed from the external trigger input Reset...

Page 262: ...dels the range can be set to 1 0 V or 8 0 V In 4 channel models the range can only be set to 5 0 V If the probe attenuation is changed the range value is multiplied by the probe attenuation factor Que...

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

Page 264: ...at ion operation see page 269 FUNCtion GOFT OPERat ion see page 269 operation ADD SUBTract MULTiply FUNCtion GOFT SOURce 1 source see page 270 FUNCtion GOFT SOURce 1 see page 270 source CHANnel n n 1...

Page 265: ...selected function FUNCtion SCALe scale value suffix see page 276 FUNCtion SCALe see page 276 scale value integer in NR1 format suffix V dB FUNCtion SOURce1 source see page 277 FUNCtion SOURce1 see pa...

Page 266: ...nels The SOURce1 DISPlay RANGe and OFFSet commands apply to any function The SPAN CENTer and WINDow commands are only useful for FFT functions When FFT is selected the cursors change from volts and ti...

Page 267: ...FUNCtion 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 See...

Page 268: ...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 269: ...INTegrate DIFFerentiate or SQRT functions ADD Source1 source2 SUBTract Source1 source2 MULTiply Source1 source2 The FUNCtion GOFT SOURce1 and FUNCtion GOFT SOURce2 commands are used to select source1...

Page 270: ...first input channel for the g t source that can be used as the input to the FFT INTegrate DIFFerentiate or SQRT functions Query Syntax FUNCtion GOFT SOURce1 The FUNCtion GOFT SOURce1 query returns th...

Page 271: ...functions If CHANnel1 or CHANnel2 is selected for FUNCtion GOFT SOURce1 the SOURce2 selection can be CHANnel1 or CHANnel2 Likewise if CHANnel3 or CHANnel4 is selected for FUNCtion GOFT SOURce1 the SOU...

Page 272: ...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 273: ...the selected waveform source FFT Fast Fourier Transform on the selected waveform source SQRT Square root on the selected waveform source When the operation is ADD SUBTract or MULTiply the FUNCtion SO...

Page 274: ...The FUNCtion RANGe query returns the current full scale range value for the selected function Return Format range NL range the full scale vertical axis value in NR3 format The range for ADD SUBT MULT...

Page 275: ...ale 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 FUNCt...

Page 276: ...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 277: ...r the FFT INTegrate DIFFerentiate or SQRT functions It lets you specify as the function input source the addition subtraction or multiplication of two channels When GOFT is used the g t source is spec...

Page 278: ...tions Choose CHANnel n or ADD SUBT or MULT to specify the desired source for function DIFFerentiate INTegrate and FFT operations specified by the FUNCtion OPERation command If CHANnel1 or CHANnel2 is...

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

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

Page 281: ...e index integer index of printer in list name name of printer in list HARDcopy FACTors 0 OFF 1 ON see page 285 HARDcopy FACTors see page 285 0 1 HARDcopy FFEed 0 OFF 1 ON see page 286 HARDcopy FFEed s...

Page 282: ...formatting options such as inclusion of instrument settings FACTors and generation of formfeed FFEed HARDC is an acceptable short form for HARDcopy Reporting the Setup Use HARDcopy to query setup inf...

Page 283: ...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 284: ...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 285: ...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 286: ...rs of a hardcopy dump ON or 1 is only valid when PRINter0 or PRINter1 is set as the HARDcopy FORMat type Query Syntax HARDcopy FFEed The HARDcopy FFEed query returns a flag indicating whether a formfe...

Page 287: ...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 288: ...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 289: ...hardcopy palette color Query Syntax HARDcopy PALette The HARDcopy PALette query returns the selected hardcopy palette color Return Format palette NL palette COL GRAY NONE See Also Introduction to HAR...

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

Page 291: ...Syntax HARDcopy STARt The HARDcopy STARt command starts a print job See Also Introduction to HARDcopy Commands on page 282 HARDcopy APRinter on page 284 HARDcopy PRINter LIST on page 290 HARDcopy FAC...

Page 292: ...er subsystem is used to turn on off the serial decode Lister display and return data from the Lister display Table 67 LISTer Commands Summary Command Query Options and Query Returns n a LISTer DATA se...

Page 293: ...e page 786 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 Introduc...

Page 294: ...86 Command Syntax LISTer DISPlay value value 1 ON 0 OFF The LISTer DISPlay command turns on or off the on screen lister display Query Syntax LISTer DISPlay The LISTer DISPlay query returns lister disp...

Page 295: ...r position value in NR3 format MARKer X1Y1source source see page 299 MARKer X1Y1source see page 299 source CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value source MARKer X2Position posi...

Page 296: ...up Use MARKer to query setup information for the MARKer subsystem Return Format The following is a sample response from the MARKer query In this case the query was issued following a RST and MARKer MO...

Page 297: ...ng 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 sourc...

Page 298: ...x 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 position X...

Page 299: ...l mode Setting the source for one pair of markers for example X1Y1 sets the source for the other for example X2Y2 If the marker mode is currently WAVeform the X1Y1 source can be set separate from the...

Page 300: ...value Query Syntax MARKer X2Position The MARKer X2Position query returns current X2 cursor position This is functionally equivalent to the obsolete MEASure TSTOp command query Return Format position...

Page 301: ...l mode Setting the source for one pair of markers for example X2Y2 sets the source for the other for example X1Y1 If the marker mode is currently WAVeform the X2Y2 source can be set separate from the...

Page 302: ...cursor Value at X1 cursor Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 296 MARKer MODE on page 297 MARKer X1Position on page 298 MARKer...

Page 303: ...e 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 Format position...

Page 304: ...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 Format position...

Page 305: ...Y1 cursor Return Format value NL value difference value in NR3 format See Also Introduction to MARKer Commands on page 296 MARKer MODE on page 297 MARKer X1Y1source on page 299 MARKer X2Y2source on p...

Page 306: ...16 MEASure DEFine DELay see page 317 delay spec edge_spec1 edge_spec2 edge_spec1 slope occurrence edge_spec2 slope occurrence slope occurrence integer MEASure DEFine THResholds threshold spec see page...

Page 307: ...n NR3 format MEASure NWIDth source see page 324 MEASure NWIDth source see page 324 source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2...

Page 308: ...n FUNCtion MATH for DSO models source CHANnel n DIGital0 DIGital15 FUNCtion MATH for MSO models n 1 2 or 1 4 in NR1 format return_value width of positive pulse in seconds in NR3 format n a MEASure RES...

Page 309: ...istics see page 339 type ON 1 CURRent MEAN MINimum MAXimum STDDev COUNt ON all statistics returned MEASure STATistics I NCRement see page 340 n a n a MEASure STATistics R ESet see page 341 n a n a n a...

Page 310: ...waveform in volts in NR3 format MEASure VAVerage source see page 347 MEASure VAVerage source see page 347 source CHANnel n FUNCtion MATH n 1 2 or 1 4 in NR1 format return_value calculated average volt...

Page 311: ...page 354 vtime displayed time from trigger in seconds in NR3 format return_value voltage at the specified time in NR3 format source CHANnel n FUNCtion MATH for DSO models source CHANnel n DIGital0 DI...

Page 312: ...ttempt to make the measurement inside the zoomed sweep window If the measurement is an average and there are not three edges the oscilloscope will revert to the mode of making the measurement at the s...

Page 313: ...ent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 313 Return Format The following is a sample response from the MEASure query In this case the query was issued following a RST command ME...

Page 314: ...scilloscopes Programmer s Guide 5 Commands by Subsystem MEASure CLEar see page 786 Command Syntax MEASure CLEar This command clears all selected measurements and markers from the screen See Also Intro...

Page 315: ...is automatically adjusted to be 100 ms or twice the current time window whichever is longer up to 1 second The counter measurement can measure frequencies up to 125 MHz The minimum frequency supporte...

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

Page 317: ...r 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 value...

Page 318: ...wer 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 319: ...DEFine command Also in the MEASure DEFine command you can set upper middle and lower threshold values It is the middle threshold value that is used when performing the delay query The standard upper...

Page 320: ...e 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 secon...

Page 321: ...e 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 posit...

Page 322: ...urrent source is 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 referen...

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

Page 324: ...urce parameter is 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 the...

Page 325: ...se and either Vmax or Vmin depending on whether the edge is rising or falling For a rising edge overshoot Vmax Vtop Vtop Vbase x 100 For a falling edge overshoot Vbase Vmin Vtop Vbase x 100 Vtop and V...

Page 326: ...326 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 5 Commands by Subsystem MEASure VTOP on page 355 MEASure VBASe on page 348 MEASure VMIN on page 350...

Page 327: ...d 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 I...

Page 328: ...s the phase between the specified sources A phase measurement is a combination of the period and delay measurements First the period is measured on source1 Then the delay is measured between source1 a...

Page 329: ...ts Vtop Vbase and either Vmin or Vmax depending on whether the edge is rising or falling For a rising edge preshoot Vmin Vbase Vtop Vbase x 100 For a falling edge preshoot Vmax Vtop Vtop Vbase x 100 V...

Page 330: ...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 m...

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

Page 332: ...ency MeasurementArray 1 DUTYcycle MeasurementArray 2 VAMPlitude MeasurementArray 3 VPP Dim Measurement As Variant For Each Measurement In MeasurementArray myScope WriteString MEASure Measurement mySco...

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

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

Page 335: ...nt and starts std deviation measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure SDEViation source The MEASure SDEViation query measures and ou...

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

Page 337: ...f MARKer MODE is set to OFF or MANual setting MEASure SOURce to CHANnel n FUNCtion or MATH will also set MARKer X1Y1source to source1 and MARKer X2Y2source to source2 EXTernal is only a valid source f...

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

Page 339: ...mines the type of information returned by the MEASure RESults query ON means all the statistics are on Query Syntax MEASure STATistics The MEASure STATistics query returns the current statistics mode...

Page 340: ...tics Menu This command lets you for example gather statistics over multiple pulses captured in a single acquisition To do this change the horizontal position and enter the command for each new pulse t...

Page 341: ...MEASure STATistics RESet This command resets the measurement statistics zeroing the counts Note that the measurement statistics configuration is not deleted See Also Introduction to MEASure Commands o...

Page 342: ...pe 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 th...

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

Page 344: ...and this defined occurrence is returned as the response to the query The specified value can be negative or positive To specify a negative value use a minus sign The sign of the slope selects a risin...

Page 345: ...iniiVision 7000A Series Oscilloscopes Programmer s Guide 345 value time in seconds of the specified value crossing in NR3 format See Also Introduction to MEASure Commands on page 312 MEASure TEDGe on...

Page 346: ...easurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VAMPlitude source The MEASure VAMPlitude query measures and returns the vertical amplitude...

Page 347: ...and installs a screen measurement and starts an average value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VAVerage source The MEASure...

Page 348: ...optional source 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...

Page 349: ...een measurement and starts a maximum vertical value measurement If the optional source parameter is specified the current source is modified Query Syntax MEASure VMAX source The MEASure VMAX query mea...

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

Page 351: ...he current source is modified Query Syntax MEASure VPP source The MEASure VPP query measures the maximum and minimum vertical value for the selected source then calculates the vertical peak to peak va...

Page 352: ...two channel oscilloscope models The MEASure VRATio command places the instrument in the continuous measurement mode and starts a ratio measurement Query Syntax MEASure VRATio source1 source2 The MEASu...

Page 353: ...ce parameter is specified the current source is modified Query Syntax MEASure VRMS source The MEASure VRMS query measures and outputs the dc RMS value of the selected waveform The dc RMS value is meas...

Page 354: ...the two channel oscilloscope models The MEASure VTIMe query returns the value at a specified time on the source specified with MEASure SOURce The specified time must be on the screen and is referenced...

Page 355: ...arts a waveform 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...

Page 356: ...selected window 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...

Page 357: ...selected window 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...

Page 358: ...nt DIVisions MTESt AMASk XDELta value see page 366 MTESt AMASk XDELta see page 366 value X delta value in NR3 format MTESt AMASk YDELta value see page 367 MTESt AMASk YDELta see page 367 value Y delta...

Page 359: ...P see page 381 0 1 MTESt RMODe SIGMa level see page 382 MTESt RMODe SIGMa see page 382 level from 0 1 to 9 3 in NR3 format MTESt RMODe TIME seconds see page 383 MTESt RMODe TIME see page 383 seconds f...

Page 360: ...00 000E 06 XDEL 400 000E 06 Y1 3 00000E 00 Y2 3 00000E 00 BIND 0 MTES RMOD FOR RMOD TIME 1E 00 WAV 1000 SIGM 6 0E 00 MTES RMOD FACT STOP 0 PRIN 0 SAVE 0 Example Code Mask testing commands example Opti...

Page 361: ...AMASk SOURce strQueryResult myScope ReadString Debug Print Mask test auto mask source strQueryResult myScope WriteString MTESt AMASk UNITs DIVisions myScope WriteString MTESt AMASk UNITs strQueryResu...

Page 362: ...tion varQueryResult myScope ReadNumber Operation Status Condition Register RUN bit bit 3 H8 If varQueryResult And H8 0 Then Exit Do Else Sleep 100 Small wait to prevent excessive queries lngElapsed ln...

Page 363: ...ta 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 rep...

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

Page 365: ...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 CURR...

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

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

Page 368: ...oscilloscope models The MTESt COUNt FWAVeforms query returns the total number of failed waveforms in the current mask test run This count is for all regions and all waveforms Return Format failed NL f...

Page 369: ...s Guide 369 MTESt COUNt RESet see page 786 Command Syntax MTESt COUNt RESet The MTESt COUNt RESet command resets the mask statistics See Also Introduction to MTESt Commands on page 360 MTESt COUNt WA...

Page 370: ...ESt 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...

Page 371: ...forms 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 t...

Page 372: ...88 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 t...

Page 373: ...7000A Series Oscilloscopes Programmer s Guide 373 MTESt DELete see page 786 Command Syntax MTESt DELete The MTESt DELete command clears the currently loaded mask See Also Introduction to MTESt Comman...

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

Page 375: ...r 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 n...

Page 376: ...ion FAIL the output occurs when there are mask test failures PASS the output occurs when the mask test passes You can place the mask test signal on the rear panel TRIG OUT BNC using the CALibrate OUTP...

Page 377: ...n page 382 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 383 command WAVeforms the mask test runs until a fixed number of wavefor...

Page 378: ...istics 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 Averag...

Page 379: ...on page 281 for more information on setting the hardcopy device and formatting options Query Syntax MTESt RMODe FACTion PRINt The MTESt RMODe FACTion PRINt query returns the current mask failure prin...

Page 380: ...ee SAVE Commands on page 403 for more information on save options Query Syntax MTESt RMODe FACTion SAVE The MTESt RMODe FACTion SAVE query returns the current mask failure save setting Return Format o...

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

Page 382: ...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 waveform...

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

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

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

Page 386: ...0 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 perio...

Page 387: ...ons 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 poly...

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

Page 389: ...ndaries 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 volta...

Page 390: ...t 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 config...

Page 391: ...ry 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 lo...

Page 392: ...for the POD subsystem Return Format The following is a sample response from the POD1 query In this case the query was issued following a RST command POD1 DISP 0 THR 1 40E 00 Table 71 POD n Commands Su...

Page 393: ...command 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 s...

Page 394: ...d by the command POD1 D0 D7 POD2 D8 D15 value SMALl MEDium LARGe The POD n SIZE command specifies the size of digital channels on the display Query Syntax POD n SIZE The POD n SIZE query returns the s...

Page 395: ...low 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 numb...

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

Page 397: ...the RST command REC FIL scope_0 Table 72 RECall Commands Summary Command Query Options and Query Returns RECall FILename base_name see page 398 RECall FILename see page 398 base_name quoted ASCII stri...

Page 398: ...ecifies 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 string See Als...

Page 399: ...e_spec file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_name quoted ASCII string The RECall IMAGe STARt command recalls a trace TIFF image See Also Introduction to RECal...

Page 400: ...c 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 401: ...e 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 402: ..._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 REC...

Page 403: ...a SAVE IMAGe AREA see page 407 area GRAT SCR SAVE IMAGe FACTors 0 OFF 1 ON see page 408 SAVE IMAGe FACTors see page 408 0 1 SAVE IMAGe FORMat format see page 409 SAVE IMAGe FORMat see page 409 format...

Page 404: ...F INKS 0 PAL MON SAVE PWD C setups SAVE WAV FORM NONE LENG 1000 SEGM CURR SAVE SETup STARt file_spec see page 415 n a file_spec internal_loc file_name internal_loc 0 9 an integer in NR1 format file_na...

Page 405: ...ny 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...

Page 406: ...ors on page 408 SAVE IMAGe FORMat on page 409 SAVE IMAGe INKSaver on page 410 SAVE IMAGe PALette on page 411 SAVE FILename on page 405 RECall IMAGe STARt on page 399 NOTE If a file extension is provid...

Page 407: ...AREA query returns the selected image area If the SAVE IMAGe FORMat is TIFF the area is GRAT graticule Otherwise it is SCR screen Return Format area NL area GRAT SCR See Also Introduction to SAVE Comm...

Page 408: ...e 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 See Also Intr...

Page 409: ...ntax SAVE IMAGe FORMat The SAVE IMAGe FORMat query returns the selected image format type Return Format format NL format TIFF BMP BMP8 PNG NONE When NONE is returned it indicates that a waveform data...

Page 410: ...trols whether the graticule colors are inverted or not Query Syntax SAVE IMAGe INKSaver The SAVE IMAGe INKSaver query returns a flag indicating whether graticule colors are inverted or not Return Form...

Page 411: ...IMAGe PALette The SAVE IMAGe PALette query returns the selected image palette color Return Format palette NL palette COL GRAY MON See Also Introduction to SAVE Commands on page 404 SAVE IMAGe STARt o...

Page 412: ...mand Syntax 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 404 SAVE FILe...

Page 413: ...ec 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 404...

Page 414: ...e 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 operatio...

Page 415: ...e_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 C...

Page 416: ...loscope waveform data to a file See Also Introduction to SAVE Commands on page 404 SAVE WAVeform FORMat on page 417 SAVE WAVeform LENGth on page 418 SAVE FILename on page 405 RECall SETup STARt on pag...

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

Page 418: ...The SAVE WAVeform LENGth command sets the waveform data length that is the number of points saved Query Syntax SAVE WAVeform LENGth The SAVE WAVeform LENGth query returns the specified waveform data l...

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

Page 420: ...n see page 426 percent floating point in NR3 format SBUS DISPlay 0 OFF 1 ON see page 427 SBUS DISPlay see page 427 0 1 n a SBUS FLEXray COUNt N ULL see page 428 frame_count integer in NR1 format SBUS...

Page 421: ...integer 4 16 in NR1 format SBUS UART BASE base see page 439 SBUS UART BASE see page 439 base ASCii BINary HEX n a SBUS UART COUNt ERRo r see page 440 frame_count integer in NR1 format SBUS UART COUNt...

Page 422: ...ee page 786 Query Syntax SBUS 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 745 See Also SBUS CAN COU...

Page 423: ...e page 786 Query Syntax SBUS 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 745 See Also SBUS CA...

Page 424: ...yntax SBUS CAN COUNt RESet Resets the frame counters Errors 241 Hardware missing on page 745 See Also SBUS CAN COUNt ERRor on page 422 SBUS CAN COUNt OVERload on page 423 SBUS CAN COUNt TOTal on page...

Page 425: ...ee page 786 Query Syntax SBUS 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 745 See Also SBUS CAN COU...

Page 426: ...ee page 786 Query Syntax SBUS CAN COUNt UTILization Returns the percent utilization Return Format percent NL percent floating point in NR3 format Errors 241 Hardware missing on page 745 See Also SBUS...

Page 427: ...Play The SBUS DISPlay query returns the current display setting of the serial decode bus Return Format display NL display 0 1 Errors 241 Hardware missing on page 745 See Also Introduction to SBUS Comm...

Page 428: ...786 Query Syntax SBUS FLEXray COUNt NULL Returns the FlexRay null frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS FLEX...

Page 429: ...Command Syntax SBUS FLEXray COUNt RESet Resets the FlexRay frame counters Errors 241 Hardware missing on page 745 See Also SBUS FLEXray COUNt NULL on page 428 SBUS FLEXray COUNt SYNC on page 430 SBUS...

Page 430: ...786 Query Syntax SBUS FLEXray COUNt SYNC Returns the FlexRay sync frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS FLEX...

Page 431: ...786 Query Syntax SBUS FLEXray COUNt TOTal Returns the FlexRay total frame count Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS FLE...

Page 432: ...use for the I2S decode display Query Syntax SBUS I2S BASE The SBUS I2S BASE query returns the current I2S display decode base Return Format base NL base DECimal HEX Errors 241 Hardware missing on page...

Page 433: ...he display of the IIC address field of the decode bus Query Syntax SBUS IIC ASIZe The SBUS IIC ASIZe query returns the current IIC address width setting Return Format mode NL mode BIT7 BIT8 Errors 241...

Page 434: ...display of the Frame Id field in the LIN decode bus Query Syntax SBUS LIN PARity The SBUS LIN PARity query returns the current LIN parity bits display setting of the serial decode bus Return Format di...

Page 435: ...MIL STD 1553 decode display Query Syntax SBUS M1553 BASE The SBUS M1553 BASE query returns the current MIL STD 1553 display decode base Return Format base NL base BIN HEX Errors 241 Hardware missing o...

Page 436: ...rmat mode NL mode CAN FLEX I2S IIC LIN M1553 SPI UART NONE Errors 241 Hardware missing on page 745 See Also Introduction to SBUS Commands on page 421 TRIGger MODE on page 473 TRIGger CAN Commands on p...

Page 437: ...ed when displaying data in the serial decode waveform and in the Lister Query Syntax SBUS SPI BITorder The SBUS SPI BITorder query returns the current SPI decode bit order Return Format order NL order...

Page 438: ...data for SPI Query Syntax SBUS SPI WIDTh The SBUS SPI WIDTh query returns the current SPI decode word width Return Format word_width NL word_width integer 4 16 in NR1 format Errors 241 Hardware missin...

Page 439: ...ART decode display Query Syntax SBUS UART BASE The SBUS UART BASE query returns the current UART decode base setting Return Format base NL base ASCii BINary HEX Errors 241 Hardware missing on page 745...

Page 440: ...Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS UART COUNt RESet on page 441 Introduction to SBUS Commands on page 421 SBUS MODE on...

Page 441: ...241 Hardware missing on page 745 See Also SBUS UART COUNt ERRor on page 440 SBUS UART COUNt RXFRames on page 442 SBUS UART COUNt TXFRames on page 443 Introduction to SBUS Commands on page 421 SBUS MOD...

Page 442: ...Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS UART COUNt RESet on page 441 Introduction to SBUS Commands on page 421 SBUS MODE o...

Page 443: ...Return Format frame_count NL frame_count integer in NR1 format Errors 241 Hardware missing on page 745 See Also SBUS UART COUNt RESet on page 441 Introduction to SBUS Commands on page 421 SBUS MODE o...

Page 444: ...termines the byte value to use for framing end of packet or to turn off framing for UART decode Query Syntax SBUS UART FRAMing The SBUS UART FRAMing query returns the current UART decode base setting...

Page 445: ...NR1 format month 1 12 JANuary FEBruary MARch APRil MAY JUNe JULy AUGust SEPtember OCTober NOVember DECember day 1 31 SYSTem DSP string see page 447 n a string up to 254 characters as a quoted ASCII st...

Page 446: ...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 tha...

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

Page 448: ...atedly 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 nu...

Page 449: ...OCK 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 SYS...

Page 450: ...scilloscope waveform update rate this setting allows measurements and math functions to be performed on a precision analysis record see WAVeform POINts MODE on page 631 The precision analysis setting...

Page 451: ...STem 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 PROTectio...

Page 452: ...488 2 format See Also Introduction to SYSTem Commands on page 445 LRN Learn Device Setup on page 123 Example Code SAVE_SYSTEM_SETUP The SYSTEM SETUP query returns a program message that contains the c...

Page 453: ...s Oscilloscopes Programmer s Guide 453 Write setup string back to oscilloscope using SYSTEM SETUP command myScope WriteIEEEBlock SYSTEM SETUP varSetupString CheckForInstrumentErrors Example program fr...

Page 454: ...mat 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...

Page 455: ...0 OFF 1 ON see page 460 TIMebase REFClock see page 460 0 1 TIMebase REFerence LEFT CENTer RIGHt see page 461 TIMebase REFerence see page 461 return_value LEFT CENTer RIGHt TIMebase SCALe scale_value...

Page 456: ...nel 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 Us...

Page 457: ...ts are available in this mode ROLL In the ROLL mode data moves continuously across the display from left to right The oscilloscope runs continuously and is untriggered The TIMebase REFerence selection...

Page 458: ...center 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 ti...

Page 459: ...base RANGe The TIMebase RANGe query returns the current full scale range value for the main window Return Format range_value NL range_value 5 ns through 500 s in NR3 format See Also Introduction to TI...

Page 460: ...erence clock when synchronizing multiple instruments see ACQuire RSIGnal on page 189 The TIMebase REFClock ON command enables the 10 MHz REF BNC and sets the reference signal mode to IN The TIMebase R...

Page 461: ...y where the trigger point is referenced Query Syntax TIMebase REFerence The TIMebase REFerence query returns the current display reference for the main window Return Format reference NL reference LEFT...

Page 462: ...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 463: ...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 464: ...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 465: ...d 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 TIMeb...

Page 466: ...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 467: ...611 TRIGger UART Commands on page 596 Introduction to TRIGger Commands The commands in the TRIGger subsystem define the conditions for an internal trigger Many of these commands are valid in multiple...

Page 468: ...d pattern This pattern is a logical AND combination of the channels Duration triggering lets you define a pattern then trigger on a specified time duration FlexRay triggering will when used with a Bus...

Page 469: ...The serial data string can be specified to be from 4 to 32 bits long TV triggering is used to capture the complicated waveforms of television equipment The trigger circuitry detects the vertical and...

Page 470: ...rn CAN DURation I2S IIC EBURst LIN M1553 SEQuence SPI TV UART USB FLEXray return_value mode none none query returns NONE if the TIMebase MODE is ROLL or XY TRIGger NREJect 0 OFF 1 ON see page 474 TRIG...

Page 471: ...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 472: ...able 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 W...

Page 473: ...ery Syntax TRIGger MODE The TRIGger MODE query returns the current trigger mode If the TIMebase MODE is ROLL or XY the query returns NONE Return Format mode NL mode NONE EDGE GLIT PATT CAN DUR I2S IIC...

Page 474: ...oise 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...

Page 475: ...rument Set a value bit to 0 to set the pattern for the corresponding channel to low Set a value bit to 1 to set the pattern to high Set a mask bit to 0 to ignore the data for the corresponding channel...

Page 476: ...ide 5 Commands by Subsystem Query Syntax TRIGger PATTern The TRIGger PATTern query returns the pattern value the mask and the edge of interest in the simple pattern Return Format pattern NL See Also I...

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

Page 478: ...h see page 481 length integer from 1 to 8 in NR1 format with Option AMS TRIGger CAN PATTern ID value mask see page 482 TRIGger CAN PATTern ID see page 482 value 32 bit integer in decimal nondecimal or...

Page 479: ...rnal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 or 1 4 in NR1 format TRIGger CAN TRIGger condition see page 487 TRIGger CAN TRIGger see page 488 condition SOF without Opti...

Page 480: ...tern to low Set a value bit to 1 to set the bit to high Set a mask bit to 0 to ignore that bit in the data stream Only bits with a 1 set on the mask are used Query Syntax TRIGger CAN PATTern DATA The...

Page 481: ...from 0 bytes to 8 bytes 64 bits The value for these bytes is set by the TRIGger CAN PATTern DATA command Query Syntax TRIGger CAN PATTern DATA LENGth The TRIGger CAN PATTern DATA LENGth query returns...

Page 482: ...o low Set a value bit to 1 to set the bit to high Set a mask bit to 0 to ignore that bit in the identifier stream Only bits with a 1 set on the mask are used Query Syntax TRIGger CAN PATTern ID The TR...

Page 483: ...AN identifier is set by the TRIGger CAN PATTern ID command Query Syntax TRIGger CAN PATTern ID MODE The TRIGger CAN PATTern ID MODE query returns the current setting of the CAN identifier mode Return...

Page 484: ...ime 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...

Page 485: ...a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s If the baud rate you select does not match the system baud rate false triggers may occu...

Page 486: ...scilloscope models n 1 2 for the two channel oscilloscope models The TRIGger CAN SOURce command sets the source for the CAN signal The source setting is only valid when TRIGger CAN TRIGger is set to S...

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

Page 488: ...AN trigger on condition Return Format condition NL condition SOF DATA ERR IDD IDE IDR ALL OVER ACK Errors 241 Hardware missing on page 745 See Also Introduction to TRIGger Commands on page 467 TRIGger...

Page 489: ...Ration LES Sthan see page 491 less_than_time floating point number from in NR3 format suffix s ms us ns ps TRIGger DURation PAT Tern value mask see page 492 TRIGger DURation PAT Tern see page 492 valu...

Page 490: ...mand sets the minimum duration for the defined pattern when TRIGger DURation QUALifier is set to GREaterthan The command also sets the timeout value when the TRIGger DURation QUALifier is set to TIMeo...

Page 491: ...ix s ms us ns ps The TRIGger DURation LESSthan command sets the maximum duration for the defined pattern when TRIGger DURation QUALifier is set to LESSthan Query Syntax TRIGger DURation LESSthan The T...

Page 492: ...he corresponding channel Only channels with a 1 set on the appropriate mask bit are used Query Syntax TRIGger DURation PATTern The TRIGger DURation PATTern query returns the pattern value Return Forma...

Page 493: ...on GREaterthan command Set the LESSthan qualifier value with the TRIGger DURation LESSthan command Set the INRange and OUTRange qualifier values with the TRIGger DURation RANGe command Set the TIMeout...

Page 494: ...ets the duration for the defined pattern when the TRIGger DURation QUALifier command is set to INRange or OUTRange You can enter the parameters in any order the smaller value becomes the greater_than_...

Page 495: ...If a digital channel is selected as the source the DIGital n THReshold or POD n THReshold command is used to set the Nth Edge Burst trigger level Table 80 TRIGger EBURst Commands Summary Command Quer...

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

Page 497: ...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 498: ...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...

Page 499: ...format For external triggers level external range setting in NR3 format For digital channels MSO models level 8 V source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 EXTernal...

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

Page 501: ...he MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger EDGE LEVel command sets the trigger level voltage for the active trigger sour...

Page 502: ...ency 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 frequ...

Page 503: ...ad use TRIGger TV POLarity to set the polarity in TV trigger mode Query Syntax TRIGger EDGE SLOPe The TRIGger EDGE SLOPe query returns the current trigger slope Return Format slope NL slope NEG POS EI...

Page 504: ...channel that produces the trigger Query Syntax TRIGger EDGE SOURce The TRIGger EDGE SOURce query returns the current source If all channels are off the query returns NONE Return Format source NL sourc...

Page 505: ...510 event WAKeup TSS FES DTS BSS TRIGger FLEXray FRAM e CCBase cycle_count_base see page 511 TRIGger FLEXray FRAM e CCBase see page 511 cycle_count_base integer from 0 63 TRIGger FLEXray FRAM e CCRepe...

Page 506: ...s impedance to 50 Ohms Sets the selected source channel 8217 s probe attenuation to 10 1 Sets the trigger level on the selected source channel to 300 mV Turns on trigger Noise Reject Turns on Serial D...

Page 507: ...s the baud rate as 2 5 Mb s 5 Mb s or 10 Mb s Query Syntax TRIGger FLEXray BAUDrate The TRIGger FLEXray BAUDrate query returns the current baud rate setting Return Format baudrate NL baudrate 2500000...

Page 508: ...the bus channel A or B of the FlexRay signal Query Syntax TRIGger FLEXray CHANnel The TRIGger FLEXray CHANnel query returns the current bus channel setting Return Format channel NL channel A B See Als...

Page 509: ...gger 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 TRIGger FLEXray ERRor TYPE The TRIGger FLEXray ERRor TY...

Page 510: ...t FES triggers on Frame End Sequence event DTS triggers on Dynamic Trailing Sequence event BSS triggers on Byte Start Sequence event Query Syntax TRIGger FLEXray EVENt TYPE The TRIGger FLEXray EVENt T...

Page 511: ...o trigger on The cycle count base setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe CCBase The TRIGger FLEXray FRAMe CCBase query returns the curre...

Page 512: ...er to trigger on The cycle count repetition setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe CCRepetition The TRIGger FLEXray FRAMe CCRepetition q...

Page 513: ...F setting is only valid when the FlexRay trigger mode is set to FRAME Query Syntax TRIGger FLEXray FRAMe ID The TRIGger FLEXray FRAMe ID query returns the current frame ID setting for the FlexRay fram...

Page 514: ...trigger on only null frames SYNC will trigger on only sync frames NSTArtup will trigger on frames other than startup frames NNULl will trigger on frames other than null frames NSYNc will trigger on fr...

Page 515: ...ut source for the FlexRay signal Query Syntax TRIGger FLEXray SOURce The TRIGger FLEXray SOURce query returns the current source for the FlexRay signal Return Format source NL See Also Introduction to...

Page 516: ...fied FlexRay event symbol Query Syntax TRIGger FLEXray TRIGger The TRIGger FLEXray TRIGger query returns the current FLEXray trigger on condition Return Format condition NL condition FRAM ERR EVEN See...

Page 517: ...floating point number in NR3 format suffix s ms us ns ps TRIGger GLITch LEVel level source see page 521 TRIGger GLITch LEVel see page 521 For internal triggers level 75 x full scale voltage from cent...

Page 518: ...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 525 TRIGger GLITch SOURc e see page 5...

Page 519: ...LITch 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...

Page 520: ...Gger 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 521: ...l n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger GLITch LEVel...

Page 522: ...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 523: ...ration 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 GL...

Page 524: ...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 525: ...nel oscilloscope models The TRIGger GLITch SOURce command selects the channel that produces the pulse width trigger Query Syntax TRIGger GLITch SOURce The TRIGger GLITch SOURce query returns the curre...

Page 526: ...531 TRIGger I2S PATTern DATA see page 532 string n where n 32 bit integer in signed decimal when base DECimal string nn n where n 0 1 X when base BINary string 0xnn n where n 0 9 A F X when base HEX T...

Page 527: ...n 1 2 or 1 4 in NR1 format TRIGger I2S SOURce W SELect source see page 539 TRIGger I2S SOURce W SELect see page 539 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MS...

Page 528: ...when in I2S mode I2S standard LJ left justified RJ right justified Note that the word select WS polarity is specified separately with the TRIGger I2S WSHigh command Query Syntax TRIGger I2S ALIGnment...

Page 529: ...EITHer The TRIGger I2S AUDio command specifies the audio channel to trigger on RIGHt right channel LEFT left channel EITHer right channel Query Syntax TRIGger I2S AUDio The TRIGger I2S AUDio query re...

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

Page 531: ...ters 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 cha...

Page 532: ...ction to TRIGger Commands on page 467 TRIGger I2S PATTern FORMat on page 533 TRIGger I2S TRIGger on page 540 TRIGger I2S RWIDth on page 536 TRIGger I2S TWIDth on page 542 TRIGger I2S AUDio on page 529...

Page 533: ...PATTern FORMat command sets the entry and query number base used by the TRIGger I2S PATTern DATA command The default base is DECimal Query Syntax TRIGger I2S PATTern FORMat The TRIGger I2S PATTern FOR...

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

Page 535: ...y Subsystem 5 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 535 TRIGger I2S TRIGger on page 540 TRIGger I2S RWIDth on page 536 TRIGger I2S TWIDth on page 542 TRIGger I2S WSLow on...

Page 536: ...he width of the receiver decoded data word in I2S anywhere from 4 bits to 32 bits Query Syntax TRIGger I2S RWIDth The TRIGger I2S RWIDth query returns the currently set I2S receiver data word width Re...

Page 537: ...channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger I2S SOURce CLOCk controls which signal is used as the serial clock SCLK source by the serial decoder and or trigg...

Page 538: ...nnel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger I2S SOURce DATA command controls which signal is used as the serial data SDATA source by the serial decoder and or tr...

Page 539: ...r channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger I2S SOURce WSELect command controls which signal is used as the word select WS source by the serial decoder and...

Page 540: ...r than the specified value INRange enter upper and lower values to specify the range in which to trigger OUTRange enter upper and lower values to specify range in which trigger will not occur INCReasi...

Page 541: ...The TRIGger I2S TRIGger query returns the current I2S trigger operator Return Format operator NL operator EQU NOT LESS GRE INR OUTR INCR DECR See Also Introduction to TRIGger Commands on page 467 TRI...

Page 542: ...the width of the transmitted data word in I2S anywhere from 4 bits to 32 bits Query Syntax TRIGger I2S TWIDth The TRIGger I2S TWIDth query returns the currently set I2S transmitted data word width Ret...

Page 543: ...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 544: ...ger or string string 0xnn n 0 9 A F TRIGger IIC SOURce CLOCk source see page 548 TRIGger IIC SOURce CLOCk see page 548 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for...

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

Page 546: ...A command sets IIC data The data value can range from 0x00 to 0x0FF hexadecimal Use the don t care data pattern 1 or 0xFFFFFFFF to ignore the data value Query Syntax TRIGger IIC PATTern DATA The TRIGg...

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

Page 548: ...l0 DIGital15 for the MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger IIC SOURce CLOCk command sets the source for the IIC serial...

Page 549: ...IGital0 DIGital15 for the MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger IIC SOURce DATA command sets the source for IIC serial...

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

Page 551: ...ing 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 Sta...

Page 552: ...Programmer s Guide 5 Commands by Subsystem TRIGger IIC PATTern ADDRess on page 545 TRIGger IIC PATTern DATA on page 546 TRIGger IIC PATTern DATa2 on page 547 TRIGger IIC TRIGger QUALifier on page 550...

Page 553: ...base BINary string 0xnn n where n 0 9 A F X when base HEX TRIGger LIN PATTern DATA LENGth length see page 558 TRIGger LIN PATTern DATA LENGth see page 558 length integer from 1 to 8 in NR1 format TRIG...

Page 554: ...ue see page 564 TRIGger LIN SYNCbrea k see page 564 value integer 11 12 13 TRIGger LIN TRIGger condition see page 565 TRIGger LIN TRIGger see page 565 condition SYNCbreak without Option AMS condition...

Page 555: ...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 all IDs Query Syntax TRIGger LIN ID The TRIGger LIN ID query...

Page 556: ...e X and characters cannot be entered When queried the character is returned when any bits in the pattern have the value of X and base DECimal When any bits in a given nibble have the value of X and ba...

Page 557: ...TRIGger LIN PATTern DATA The TRIGger LIN PATTern DATA query returns the currently specified LIN trigger data pattern Return Format string NL See Also Introduction to TRIGger Commands on page 467 TRIGg...

Page 558: ...from 0 bytes to 8 bytes 64 bits The value for these bytes is set by the TRIGger LIN PATTern DATA command Query Syntax TRIGger LIN PATTern DATA LENGth The TRIGger LIN PATTern DATA LENGth query returns...

Page 559: ...the TRIGger LIN PATTern DATA command The default base is DECimal Query Syntax TRIGger LIN PATTern FORMat The TRIGger LIN PATTern FORMat query returns the currently set number base for LIN pattern dat...

Page 560: ...led to determine whether the bit is dominant or recessive The sample point represents the percentage of time between the beginning of the bit time to the end of the bit time Query Syntax TRIGger LIN S...

Page 561: ...to 625 kb s in 100 b s increments If you enter a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s Query Syntax TRIGger LIN SIGNal BAUDrate...

Page 562: ...MSO models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger LIN SOURce command sets the source for the LIN signal Query Syntax TRIGger LIN S...

Page 563: ...LIN STANdard command sets the LIN standard in effect for triggering and decoding to be LIN1 3 or LIN2 0 Query Syntax TRIGger LIN STANdard The TRIGger LIN STANdard query returns the current LIN standar...

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

Page 565: ...TA LENGth and TRIGger LIN PATTern DATA commands to specify the data string length and value Query Syntax TRIGger LIN TRIGger The TRIGger LIN TRIGger query returns the current LIN trigger value Return...

Page 566: ...e n 0 1 X TRIGger M1553 RTA value see page 569 TRIGger M1553 RTA see page 569 value 5 bit integer in decimal nondecimal or string from 0 31 nondecimal Hnn where n 0 9 A F string 0xnn where n 0 9 A F T...

Page 567: ...he TRIGger M1553 AUTosetup command copies the position volts div and probe attenuation from the upper threshold channel to the lower threshold channel sets the upper lower trigger levels to 500 mV tur...

Page 568: ...X The TRIGger M1553 PATTern DATA command sets the 11 bits to trigger on if the trigger type has been set to RTA11 RTA 11 Bits using the TRIG M1553 TYPE command Query Syntax TRIGger M1553 PATTern DATA...

Page 569: ...nn where n 0 9 A F string 0xnn where n 0 9 A F The TRIGger M1553 RTA command sets the Remote Terminal Address RTA to trigger on if the trigger type has been set to RTA using the TRIG M1553 TYPE comman...

Page 570: ...Wer command controls which signal is used as the Lower Threshold Channel source by the serial decoder and or trigger when in MIL 1553 mode Query Syntax TRIGger M1553 SOURce LOWer The TRIGger M1553 SOU...

Page 571: ...Per command controls which signal is used as the Upper Threshold Channel source by the serial decoder and or trigger when in MIL 1553 mode Query Syntax TRIGger M1553 SOURce UPPer The TRIGger M1553 SOU...

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

Page 573: ...IN D see page 576 value PATTern1 ENTered PATTern1 EXITed EDGE1 PATTern1 AND EDGE1 TRIGger SEQuence PAT Tern 1 2 value mask see page 577 TRIGger SEQuence PAT Tern 1 2 see page 577 value integer or stri...

Page 574: ...edge counter resource The edge counter is used in the trigger stage to determine the number of edges that must be found before the sequencer generates a trigger Query Syntax TRIGger SEQuence COUNt Th...

Page 575: ...mmand defines the specified sequencer edge resource according to the specified source and slope To disable an edge resource set its source to NONE In this case slope has no meaning Query Syntax TRIGge...

Page 576: ...t for example EDGE1 NONE NONE PATTern1 is specified with the TRIGger SEQuence PATTern command EDGE1 is specified with the TRIGger SEQuence EDGE command Query Syntax TRIGger SEQuence FIND The TRIGger S...

Page 577: ...hannel Only channels with a 1 set on the appropriate mask bit are used Query Syntax TRIGger SEQuence PATTern 1 2 The TRIGger SEQuence PATTern n query returns the current settings of the specified patt...

Page 578: ...e program data parameters you can use NONE to fill out the parameter list for example EDGE1 NONE NONE PATTern1 and PATTern2 are specified with the TRIGger SEQuence PATTern command EDGE1 and EDGE2 are...

Page 579: ...command sets the sequencer timer resource in seconds from 10 ns to 10 s The timer is used in the reset stage to determine how long to wait for the trigger to occur before restarting Query Syntax TRIGg...

Page 580: ...ist for example EDGE2 NONE NONE PATTern2 is specified with the TRIGger SEQuence PATTern command EDGE2 is specified with the TRIGger SEQuence EDGE command COUNt is specified with the TRIGger SEQuence C...

Page 581: ...value integer or string mask integer or string string 0xnnnnnn where n 0 9 A F TRIGger SPI PATTern WIDTh width see page 586 TRIGger SPI PATTern WIDTh see page 586 width integer from 4 to 32 in NR1 for...

Page 582: ...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 TRIGger SPI CLOCk SLOPe The TRIGger SPI CLOCk SLOPe...

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

Page 584: ...sets the SPI trigger framing value If TIMeout is selected the timeout value is set by the TRIGger SPI CLOCk TIMeout command Query Syntax TRIGger SPI FRAMing The TRIGger SPI FRAMing query returns the c...

Page 585: ...h the data width control the data pattern searched for in the data stream Set a value bit to 0 to set the corresponding bit in the data pattern to low Set a value bit to 1 to set the bit to high Set a...

Page 586: ...he TRIGger SPI PATTern WIDTh command sets the width of the SPI data pattern anywhere from 4 bits to 32 bits Query Syntax TRIGger SPI PATTern WIDTh The TRIGger SPI PATTern WIDTh query returns the curre...

Page 587: ...channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce CLOCk command sets the source for the SPI serial clock Query Syntax TRIGger SPI SOURce CLOCk The TRIGg...

Page 588: ...r channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce DATA command sets the source for the SPI serial data Query Syntax TRIGger SPI SOURce DATA The TRIGger...

Page 589: ...nnel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger SPI SOURce FRAMe command sets the frame source when TRIGger SPI FRAMing is set to CHIPselect or NOTChipselect Query S...

Page 590: ...DE see page 592 tv mode FIEld1 FIEld2 AFIelds ALINes LINE VERTical LFIeld1 LFIeld2 LALTernate LVERtical TRIGger TV POLarity polarity see page 593 TRIGger TV POLarity see page 593 polarity POSitive NEG...

Page 591: ...trigger line number setting Return Format line_number NL line_number integer in NR1 format See Also Introduction to TRIGger Commands on page 467 TRIGger TV STANdard on page 595 TRIGger TV MODE on pag...

Page 592: ...dard is GENeric The LALTernate parameter 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 trig...

Page 593: ...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 594: ...oscope models n 1 2 for the two channel oscilloscope models The TRIGger TV SOURce command selects the channel used to produce the trigger Query Syntax TRIGger TV SOURce The TRIGger TV SOURce query ret...

Page 595: ...0HZ P720 P1080L24HZ P1080 P1080L25HZ P1080L50HZ P1080L60HZ I1080L50HZ I1080 I1080L60HZ The TRIGger TV STANdard command selects the video standard GENeric mode is non interlaced Query Syntax TRIGger TV...

Page 596: ...alue OFF 1 to 4096 in NR1 format TRIGger UART DATA value see page 602 TRIGger UART DATA see page 602 value 8 bit integer from 0 255 0x00 0xff in decimal hexadecimal binary or quoted_string format hexa...

Page 597: ...SOURce TX source see page 608 TRIGger UART SOURce TX see page 608 source CHANnel n EXTernal for DSO models source CHANnel n DIGital0 DIGital15 for MSO models n 1 2 or 1 4 in NR1 format TRIGger UART TY...

Page 598: ...t panel data selection is from hexadecimal values The TRIGger UART BASE setting does not affect the TRIGger UART DATA command which can always set data values using ASCII or hexadecimal values Query S...

Page 599: ...be set from 1200 b s to 3 Mb s in 100 b s increments If you enter a baud rate that is not divisible by 100 b s the baud rate is set to the nearest baud rate divisible by 100 b s If the baud rate you...

Page 600: ...e serial decoder and or trigger when in UART mode LSBFirst sets the least significant bit of each message byte as transmitted first MSBFirst sets the most significant bit as transmitted first Query Sy...

Page 601: ...command selects the burst value Nth frame after idle period in the range 1 to 4096 or OFF for the trigger when in UART mode Query Syntax TRIGger UART BURSt The TRIGger UART BURSt query returns the cur...

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

Page 603: ...E command selects the value of the idle period for burst trigger in the range from 1 us to 10 s when in UART mode Query Syntax TRIGger UART IDLE The TRIGger UART IDLE query returns the current UART tr...

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

Page 605: ...he TRIGger UART POLarity command selects the polarity as idle low or idle high for the serial decoder and or trigger when in UART mode Query Syntax TRIGger UART POLarity The TRIGger UART POLarity quer...

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

Page 607: ...r channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger UART SOURce RX command controls which signal is used as the Rx source by the serial decoder and or trigger when...

Page 608: ...r channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger UART SOURce TX command controls which signal is used as the Tx source by the serial decoder and or trigger when...

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

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

Page 611: ...r the DSO models source CHANnel n DIGital0 DIGital15 for the MSO models n 1 2 or 1 4 in NR1 format TRIGger USB SOURce D PLus source see page 613 TRIGger USB SOURce D PLus see page 613 source CHANnel n...

Page 612: ...models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger USB SOURce DMINus command sets the source for the USB D signal Query Syntax TRIGger...

Page 613: ...models n 1 2 3 4 for the four channel oscilloscope models n 1 2 for the two channel oscilloscope models The TRIGger USB SOURce DPLus command sets the source for the USB D signal Query Syntax TRIGger...

Page 614: ...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 615: ...and 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 Th...

Page 616: ...nary data For example to transmit 1000 bytes of data the syntax would be 800001000 1000 bytes of data NL 8 is the number of digits that follow 00001000 is the number of bytes to be transmitted 1000 by...

Page 617: ...OUNt see page 636 count an integer from 2 to 2000 in NR1 format with Option SGM n a WAVeform SEGMented T TAG see page 637 time_tag in NR3 format with Option SGM WAVeform SOURce source see page 638 WAV...

Page 618: ...reamble also contains the X and Y increments origins and references for the acquired data so that word and byte data can be translated to time and voltage values Data Acquisition Types There are four...

Page 619: ...re transferred This can be as many as 4 000 000 in some operating modes or as many as 8 000 000 for a digital channel on the mixed signal oscilloscope Fewer points may be specified to speed data trans...

Page 620: ...000 unless ACQuire COUNt has been set to 1 PEAK Data Peak detect display mode is used to detect glitches for time base settings of 500 us div and slower In this mode the oscilloscope can sample more d...

Page 621: ...be calculated using the following formula time data point number xreference xincrement xorigin This would result in the following calculation for time bucket 3 time 3 0 2 ns 16 ns 22 ns In ACQuire TY...

Page 622: ...uery see page 629 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 623: ...WORD see page 628 is WORD every other data byte will be 0 The setting of WAVeform BYTeorder see page 624 controls which byte is 0 If a digital channel is not displayed its bit value in the pod data b...

Page 624: ...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 625: ...count used to acquire the current waveform This may differ from current values if the unit has been stopped and its configuration modified For all acquisition types except average this value is 1 Retu...

Page 626: ...where there can be zeros in the data incorrectly is when programming over telnet port 5024 Port 5024 provides a command prompt and is intended for ASCII transfers Use telnet port 5025 instead 0x01 or...

Page 627: ...the terminating NL character Dim lngI As Long Dim lngDataValue As Long varQueryResult myScope ReadIEEEBlock BinaryType_UI1 Unsigned integer bytes For lngI 0 To UBound varQueryResult _ Step UBound var...

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

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

Page 630: ...8 WAVeform VIEW on page 645 WAVeform PREamble on page 633 WAVeform POINts MODE on page 631 Example Code WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query mySco...

Page 631: ...cord The precision analysis record can be retrieved when SYSTem PRECision is ON from analog sources If the points_mode is NORMal and SYSTem PRECision is OFF the measurement record is retrieved If the...

Page 632: ...the WAVeform POINts MAXimum query to determine the maximum number of points that can be retrieved at the current settings Query Syntax WAVeform POINts MODE The WAVeform POINts MODE query returns the...

Page 633: ...lock NL preamble_block format 16 bit NR1 type 16 bit NR1 points 32 bit NR1 count 32 bit NR1 xincrement 64 bit floating point NR3 xorigin 64 bit floating point NR3 xreference 32 bit NR1 yincrement 32 b...

Page 634: ...XINCrement on page 646 WAVeform XORigin on page 647 WAVeform XREFerence on page 648 WAVeform YINCrement on page 649 WAVeform YORigin on page 650 WAVeform YREFerence on page 651 Example Code GET_PREAM...

Page 635: ...ata point where y origin occurs Dim Preamble 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 lngXRef...

Page 636: ...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 637: ...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 638: ...re some differences between POD and BUS when formatting and getting data from the oscilloscope When POD1 or POD2 is selected as the waveform source you can choose the BYTE WORD or ASCii formats see WA...

Page 639: ...source for the waveform commands myScope WriteString WAVEFORM SOURCE CHAN1 WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope WriteString WAVEFORM POINT...

Page 640: ...mble 2 lngCount Preamble 3 dblXIncrement Preamble 4 dblXOrigin Preamble 5 lngXReference Preamble 6 sngYIncrement Preamble 7 sngYOrigin Preamble 8 lngYReference Preamble 9 strOutput strOutput strOutput...

Page 641: ...the waveform data block The size can vary depending on the number of points acquired for the waveform You can then read that number of bytes from the oscilloscope and the terminating NL character Dim...

Page 642: ...d lets you choose from the available data sets Currently only UART serial decode lets you get TX data The default NONE specifies RX data RX is an alias for NONE If the WAVeform SOURce is not SBUS or t...

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

Page 644: ...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 645: ...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 646: ...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 647: ...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 648: ...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 649: ...ncrement 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 650: ...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 651: ...specified source This value specifies the data point value where the y origin occurs In this product this is the data point value of the center of the screen It is undefined if the format is ASCii Ret...

Page 652: ...652 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 5 Commands by Subsystem...

Page 653: ...8 E 660 F 660 G 662 H 662 I 663 L 664 M 665 N 668 O 668 P 669 Q 671 R 671 S 673 T 677 U 683 V 684 W 684 X 685 Y 686 A AALias ACQuire AALias on page 183 ACKNowledge TRIGger CAN ACKNowledge on page 738...

Page 654: ...AMASk Commands MTESt AMASk CREate on page 363 MTESt AMASk SAVE STORe on page 727 MTESt AMASk SOURce on page 364 MTESt AMASk UNITs on page 365 MTESt AMASk XDELta on page 366 MTESt AMASk YDELta on page...

Page 655: ...BUS SPI BITorder on page 437 TRIGger UART BITorder on page 600 BITS BUS n BITS on page 201 BLANk on page 148 BURSt TRIGger UART BURSt on page 601 BUS n BIT m on page 200 BUS n BITS on page 201 BUS n C...

Page 656: ...l on page 508 CHANnel ACTivity on page 693 CHANnel LABel on page 694 CHANnel THReshold on page 695 CHANnel2 SKEW on page 696 CHANnel n BWLimit on page 220 CHANnel n COUPling on page 221 CHANnel n DISP...

Page 657: ...on Hardware Event Condition Register on page 154 CONNect DISPlay CONNect on page 699 COUNt Commands ACQuire COUNt on page 185 ACQuire SEGMented COUNt on page 191 MTESt AVERage COUNt on page 729 MTESt...

Page 658: ...ISPlay DATA on page 247 LISTer DATA on page 293 MTESt DATA on page 372 TRIGger CAN PATTern DATA on page 480 TRIGger CAN PATTern DATA LENGth on page 481 TRIGger I2S PATTern DATA on page 531 TRIGger I2S...

Page 659: ...Gital n THReshold on page 243 DIGitize on page 150 DISPlay Commands BUS n DISPlay on page 204 CHANnel n DISPlay on page 222 DIGital n DISPlay on page 239 FUNCtion DISPlay on page 268 LISTer DISPlay on...

Page 660: ...R Standard Event Status Register on page 120 EVENt Commands HWERegister EVENt Hardware Event Event Register on page 156 MTERegister EVENt Mask Test Event Event Register on page 161 TRIGger FLEXray EVE...

Page 661: ...LEXray AUTosetup on page 506 TRIGger FLEXray BAUDrate on page 507 TRIGger FLEXray CHANnel on page 508 TRIGger FLEXray ERRor TYPE on page 509 TRIGger FLEXray EVENt TYPE on page 510 TRIGger FLEXray FRAM...

Page 662: ...FFSet on page 272 FUNCtion OPERation on page 273 FUNCtion RANGe on page 274 FUNCtion REFerence on page 275 FUNCtion SCALe on page 276 FUNCtion SOURce on page 704 FUNCtion SOURce1 on page 277 FUNCtion...

Page 663: ...on page 290 HARDcopy STARt on page 291 HEAD CHANnel n PROBe HEAD TYPE on page 228 HFReject TRIGger HFReject on page 471 HOLDoff TRIGger HOLDoff on page 472 HWEenable Hardware Event Enable Register on...

Page 664: ...EXTernal IMPedance on page 257 INCRement MEASure STATistics INCRement on page 340 INDex ACQuire SEGMented INDex on page 192 INKSaver HARDcopy INKSaver on page 287 INVert CHANnel n INVert on page 224...

Page 665: ...OAD MTESt LOAD on page 730 LOCK Commands MTESt LOCK on page 375 SYSTem LOCK on page 449 SYSTem PROTection LOCK on page 451 LOWer Commands MEASure LOWer on page 713 TRIGger M1553 SOURce LOWer on page 5...

Page 666: ...on page 327 MEASure PHASe on page 328 MEASure PREShoot on page 329 MEASure PWIDth on page 330 MEASure RESults on page 331 MEASure RISetime on page 334 MEASure SCRatch on page 714 MEASure SDEViation o...

Page 667: ...EASure XMIN on page 357 MEASure MTESt RMODe FACTion MEASure on page 378 MERGe on page 158 MODE Commands ACQuire MODE on page 187 MARKer MODE on page 297 SBUS MODE on page 436 TIMebase MODE on page 457...

Page 668: ...378 MTESt RMODe FACTion PRINt on page 379 MTESt RMODe FACTion SAVE on page 380 MTESt RMODe FACTion STOP on page 381 MTESt RMODe SIGMa on page 382 MTESt RMODe TIME on page 383 MTESt RMODe WAVeforms on...

Page 669: ...TPut on page 211 MTESt OUTPut on page 376 OVERload SBUS CAN COUNt OVERload on page 423 OVERshoot MEASure OVERshoot on page 325 OVLenable Overload Event Enable Register on page 169 OVLRegister Overload...

Page 670: ...SPlay PERSistence on page 251 PHASe MEASure PHASe on page 328 PMODe CHANnel n PMODe on page 698 POD n DISPlay on page 393 POD n SIZE on page 394 POD n THReshold on page 395 POINts Commands ACQuire POI...

Page 671: ...lse Width GLITch TRIGger GLITch Commands on page 517 PWD Commands RECall PWD on page 401 SAVE PWD on page 414 PWIDth MEASure PWIDth on page 330 Q QUALifier Commands TRIGger DURation QUALifier on page...

Page 672: ...429 SBUS UART COUNt RESet on page 441 TRIGger SEQuence RESet on page 578 RESults MEASure RESults on page 331 RISetime MEASure RISetime on page 334 RMODe Commands MTESt RMODe on page 377 MTESt RMODe FA...

Page 673: ...Ge INKSaver on page 410 SAVE IMAGe PALette on page 411 SAVE IMAGe STARt on page 406 SAVE LISTer STARt on page 412 SAVE MASK STARt on page 413 SAVE PWD on page 414 SAVE SETup STARt on page 415 SAVE WAV...

Page 674: ...ANnel n SCALe on page 234 FUNCtion SCALe on page 276 MTESt SCALe BIND on page 385 MTESt SCALe X1 on page 386 MTESt SCALe XDELta on page 387 MTESt SCALe Y1 on page 388 MTESt SCALe Y2 on page 389 TIMeba...

Page 675: ...nel n PROBe SKEW on page 230 SLOPe Commands TRIGger EBURst SLOPe on page 498 TRIGger EDGE SLOPe on page 503 TRIGger I2S CLOCk SLOPe on page 530 TRIGger SPI CLOCk SLOPe on page 582 SOFailure MTESt RUMo...

Page 676: ...WAVeform SOURce on page 638 WAVeform SOURce SUBSource on page 642 SOURce1 Commands FUNCtion GOFT SOURce1 on page 270 FUNCtion SOURce1 on page 277 SOURce2 Commands FUNCtion GOFT SOURce2 on page 271 FU...

Page 677: ...us on page 177 STB Read Status Byte on page 134 STOP Commands MTESt RMODe FACTion STOP on page 381 MTESt STARt STOP on page 733 STOP on page 178 STORe MTESt AMASk SAVE STORe on page 727 SUBSource WAVe...

Page 678: ...ebase DELay on page 737 TIMebase MODE on page 457 TIMebase POSition on page 458 TIMebase RANGe on page 459 TIMebase REFClock on page 460 TIMebase REFerence on page 461 TIMebase SCALe on page 462 TIMeb...

Page 679: ...eshold on page 741 TRIGger CAN ACKNowledge on page 738 TRIGger CAN PATTern DATA on page 480 TRIGger CAN PATTern DATA LENGth on page 481 TRIGger CAN PATTern ID on page 482 TRIGger CAN PATTern ID MODE o...

Page 680: ...SSthan on page 520 TRIGger GLITch LEVel on page 521 TRIGger GLITch POLarity on page 522 TRIGger GLITch QUALifier on page 523 TRIGger GLITch RANGe on page 524 TRIGger GLITch SOURce on page 525 TRIGger...

Page 681: ...on page 562 TRIGger LIN STANdard on page 563 TRIGger LIN SYNCbreak on page 564 TRIGger LIN TRIGger on page 565 TRIGger M1553 AUTosetup on page 567 TRIGger M1553 PATTern DATA on page 568 TRIGger M1553...

Page 682: ...ART BASE on page 598 TRIGger UART BAUDrate on page 599 TRIGger UART BITorder on page 600 TRIGger UART BURSt on page 601 TRIGger UART DATA on page 602 TRIGger UART IDLE on page 603 TRIGger UART PARity...

Page 683: ...TYPE on page 551 TRIGger M1553 TYPE on page 572 TRIGger UART TYPE on page 609 U UART Commands SBUS UART BASE on page 439 SBUS UART COUNt ERRor on page 440 SBUS UART COUNt RESet on page 441 SBUS UART...

Page 684: ...7 VBASe MEASure VBASe on page 348 VDELta MEASure VDELta on page 724 VECTors DISPlay VECTors on page 253 VERNier CHANnel n VERNier on page 236 VIEW on page 180 VMAX MEASure VMAX on page 349 VMIN MEASur...

Page 685: ...EFerence on page 648 WAVeform YINCrement on page 649 WAVeform YORigin on page 650 WAVeform YREFerence on page 651 WAVeforms Commands MTESt COUNt WAVeforms on page 371 MTESt RMODe WAVeforms on page 384...

Page 686: ...XORigin WAVeform XORigin on page 647 XREFerence WAVeform XREFerence on page 648 Y Y1 MTESt SCALe Y1 on page 388 Y1Position MARKer Y1Position on page 303 Y2 MTESt SCALe Y2 on page 389 Y2Position MARKe...

Page 687: ...21 ANALog n INVert CHANnel n INVert see page 224 ANALog n LABel CHANnel n LABel see page 225 ANALog n OFFSet CHANnel n OFFSet see page 226 ANALog n PROBe CHANnel n PROBe see page 227 ANALog n PMODe no...

Page 688: ...see page 277 Obsolete command has ADD SUBTract and MULTiply parameters current command has GOFT parameter FUNCtion VIEW see page 705 FUNCtion DISPlay see page 268 HARDcopy DESTination see page 706 HA...

Page 689: ...e page 357 MEASure TSTArt see page 719 MARKer X1Position see page 298 MEASure TSTOp see page 720 MARKer X2Position see page 300 MEASure TVOLt see page 721 MEASure TVALue see page 344 TVALue measures a...

Page 690: ...setting the source with different types of triggers PRINt see page 735 DISPlay DATA see page 247 TIMebase DELay see page 737 TIMebase POSition see page 458 or TIMebase WINDow POSition see page 464 TI...

Page 691: ...none DISPlay PIXel none DISPlay POSition none DISPlay ROW none DISPlay TEXT none FUNCtion MOVE none FUNCtion PEAKs none HARDcopy ADDRess none Only parallel printer port is supported GPIB printing not...

Page 692: ...rammer s Guide 7 Obsolete and Discontinued Commands Discontinued Parameters Some previous oscilloscope queries returned control setting values of OFF and ON The InfiniiVision 7000 Series oscilloscopes...

Page 693: ...at 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 spec...

Page 694: ...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 returns the label associated with a particula...

Page 695: ...ed 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 the voltage and threshold...

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

Page 697: ...he CHANnel n INPut command selects the input impedance setting for the specified channel The legal values for this command are ONEMeg 1 M and FIFTy 50 Query Syntax CHANnel n INPut The CHANnel n INPut...

Page 698: ...ally and cannot be set If a probe with sense is connected to the specified channel auto sensing is enabled otherwise the mode is manual If the PMODe sent matches the oscilloscope s setting the command...

Page 699: ...d 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 cu...

Page 700: ...SCII string See Also DIGital n POSition on page 241 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 ou...

Page 701: ...Series Oscilloscopes Programmer s Guide 701 ERASe see page 786 Command Syntax ERASe The ERASe command erases the screen NOTE The ERASe command is an obsolete command provided for compatibility to prev...

Page 702: ...ommand are ONEMeg 1 M and FIFTy 50 Query Syntax EXTernal INPut The EXTernal INPut query returns the current input impedance setting for the external trigger Return Format impedance value NL impedance...

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

Page 704: ...ce command selects the source for function operations Choose CHANnel n or ADD SUBT or MULT to specify the desired source for function DIFFerentiate INTegrate and FFT operations specified by the FUNCti...

Page 705: ...r 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 FUNCtion...

Page 706: ...ommand sets the hardcopy destination Query Syntax HARDcopy DESTination The HARDcopy DESTination query returns the selected hardcopy destination Return Format destination NL destination CENT FLOP See A...

Page 707: ...ARDcopy DEVice command sets the hardcopy device type Query Syntax HARDcopy DEVice The HARDcopy DEVice query returns the selected hardcopy device type Return Format device NL device TIFF GIF BMP LAS EP...

Page 708: ...nt 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 string See Also In...

Page 709: ...to the oscilloscope s USB ports The first printer connected identified is PRINter0 and the second is PRINter1 Query Syntax HARDcopy FORMat The HARDcopy FORMat query returns the selected hardcopy form...

Page 710: ...Dcopy 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 o...

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

Page 712: ...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 HARDcopy PDRiver query...

Page 713: ...en 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 714: ...ASure SCRatch see page 786 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 p...

Page 715: ...Lta 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 dif...

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

Page 717: ...the current source is modified 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 optiona...

Page 718: ...the current source is modified 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 optiona...

Page 719: ...time at the start marker in NR3 format See Also Introduction to MARKer Commands on page 296 Introduction to MEASure Commands on page 312 MARKer X1Position on page 298 MARKer X2Position on page 300 MAR...

Page 720: ...e at the stop marker in NR3 format See Also Introduction to MARKer Commands on page 296 Introduction to MEASure Commands on page 312 MARKer X1Position on page 298 MARKer X2Position on page 300 MARKer...

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

Page 722: ...722 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 7 Obsolete and Discontinued Commands value time in seconds of the specified voltage crossing in NR3 format...

Page 723: ...ge 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 724: ...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 Se...

Page 725: ...at voltage marker 1 in NR3 format See Also Introduction to MARKer Commands on page 296 Introduction to MEASure Commands on page 312 MARKer Y1Position on page 303 MARKer Y2Position on page 304 MARKer...

Page 726: ...he Y2 cursor in NR3 format See Also Introduction to MARKer Commands on page 296 Introduction to MEASure Commands on page 312 MARKer Y1Position on page 303 MARKer Y2Position on page 304 MARKer YDELta o...

Page 727: ...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 wo...

Page 728: ...cket 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 cu...

Page 729: ...mmand 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 COUN...

Page 730: ...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 36...

Page 731: ...s 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 wa...

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

Page 733: ...d Syntax MTESt STARt STOP The MTESt STARt STOP command starts or stops the acquisition system See Also Introduction to MTESt Commands on page 360 NOTE The MTESt STARt and MTESt STOP commands are obsol...

Page 734: ...r 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 2...

Page 735: ...age 247 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 des...

Page 736: ...nds See Also Introduction to Root Commands on page 141 Introduction to HARDcopy Commands on page 282 HARDcopy FORMat on page 709 HARDcopy FACTors on page 285 HARDcopy GRAYscale on page 710 DISPlay DAT...

Page 737: ...ference point is set with the TIMebase REFerence command see page 461 Query Syntax TIMebase DELay The TIMebase DELay query returns the current delay value Return Format delay_value NL delay_value time...

Page 738: ...h the N2758A CAN trigger module for 54620 54640 Series mixed signal oscilloscopes The InfiniiVision 7000 Series oscilloscopes do not support the N2758A CAN trigger module Query Syntax TRIGger CAN ACKN...

Page 739: ...ntial bus signal RX the Receive signal from the CAN bus transceiver TX the Transmit signal to the CAN bus transceiver DIFFerential the CAN differential bus signal connected to an analog source channel...

Page 740: ...nd bus signal line RX the Receive signal from the LIN bus transceiver TX the Transmit signal to the LIN bus transceiver Query Syntax TRIGger LIN SIGNal DEFinition The TRIGger LIN SIGNal DEFinition que...

Page 741: ...ed 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 threshold text for analog chann...

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

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

Page 744: ...l 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 Illega...

Page 745: ...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 deco...

Page 746: ...2 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 e...

Page 747: ...ring data 150 String data error 148 Character data not allowed 138 Suffix not allowed 134 Suffix too long 131 Invalid suffix 128 Numeric data not allowed 124 Too many digits 123 Exponent too large 121...

Page 748: ...sages 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 err...

Page 749: ...d 106 Print Initialization Failed 107 Invalid Trace File 108 Compression Error 109 No Data For Operation A remote operation wants some information but there is no information available For example you...

Page 750: ...750 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 8 Error Messages...

Page 751: ...Register HWERegister CONDition 771 Mask Test Event Event Register MTERegister EVENt 772 Clearing Registers and Queues 773 Status Reporting Decision Chart 774 IEEE 488 2 defines data structures comman...

Page 752: ...gister group and the Output Queue are defined as the Standard Status Data Structure Model in IEEE 488 2 1987 Overload Event Register Overload Event Enable Register Arm Event Register RUN Bit Operation...

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

Page 754: ...an2 OVL Chan1 OVL Chan3 OVL Chan4 OVL Ext Trig OVL Chan2 Fault Chan1 Fault Chan3 Fault Chan4 Fault Ext Trig Fault Bat ON HWERegister CONDition Hardware Event Condition Register HWEenable HWEenable Har...

Page 755: ...atus Enable Mask Register 1 0 2 3 4 5 6 7 OPER TRG MAV ESB RQS MSS TRG Reg TER Trigger Event Register SRE SRE Service Request Enable Mask Register STB Status Byte Register Output Queue SRQ ESR Standar...

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

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

Page 758: ...leared 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 Statu...

Page 759: ...ister 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 760: ...gger 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 mus...

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

Page 762: ...ssage 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 message...

Page 763: ...led 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 Statu...

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

Page 765: ...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 Ex...

Page 766: ...d 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 in...

Page 767: ...NDition 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 Trigg...

Page 768: ...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 trig...

Page 769: ...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 770: ...00A Series Oscilloscopes Programmer s Guide 9 Status Reporting Hardware Event Event Register HWERegister EVENt This register hosts the Bat On bit bit 0 The Bat On bit is set whenever the instrument is...

Page 771: ...ter CONDition This register hosts the Bat On bit bit 0 and the PLL LOCKED bit bit 12 The HWERegister CONDition query returns the value of the Hardware Event Condition Register The PLL LOCKED bit bit 1...

Page 772: ...ister 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 com...

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

Page 774: ...ster 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 a...

Page 775: ...h 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 start...

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

Page 777: ...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 778: ...Lib ResourceManager Set myScope New VisaComLib FormattedIO488 Set myScope IO myMgr Open TCPIP0 130 29 69 12 inst0 INSTR myScope IO Clear Clear the interface Set up Set up the trigger and horizontal sc...

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

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

Page 781: ...s 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 Mas...

Page 782: ...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 VisaComL...

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

Page 784: ...784 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 10 Synchronizing Acquisitions...

Page 785: ...iVision 7000A Series Oscilloscopes Programmer s Guide 11 More About Oscilloscope Commands Command Classifications 786 Valid Command Query Strings 787 Query Return Values 808 All Oscilloscope Commands...

Page 786: ...Commands Non core commands are commands that provide specific features but are not universal across all Agilent InfiniiVision oscilloscope models Non core commands may be modified or deleted in the f...

Page 787: ...parts of a typical program statement Instructions both commands and queries normally appear as a string embedded in a statement of your host language such as Visual Basic or C C The only time a parame...

Page 788: ...white space White space is defined as one or more space characters ASCII defines a space to be character 32 in decimal Program Data Program data are used to clarify the meaning of the command or query...

Page 789: ...headers contain a single mnemonic AUToscale and DIGitize are examples of simple command headers typically used in the oscilloscope The syntax is program mnemonic terminator Simple command headers must...

Page 790: ...in types of program data are used in commands character and numeric Character Program Data Character program data is used to convey parameter information as alpha or alphanumeric strings For example t...

Page 791: ...in a string Command Tree The command tree shows all of the commands and the relationships of the commands to each other The IEEE 488 2 common commands are not listed as part of the command tree becau...

Page 792: ...see page 212 STATus see page 213 SWITch see page 214 TEMPerature see page 215 TIME see page 216 CDISplay see page 149 CHANnel n see page 217 BWLimit see page 220 COUPling see page 221 DISPlay see pag...

Page 793: ...9 LABList see page 250 PERSistence see page 251 SOURce see page 252 VECTors see page 253 EXTernal see page 254 BWLimit see page 256 IMPedance see page 257 PROBe see page 258 ID see page 259 STYPe see...

Page 794: ...Nter LIST see page 290 STARt see page 291 HWEenable Hardware Event Enable Register see page 152 HWERegister CONDition Hardware Event Condition Register see page 154 EVENt Hardware Event Event Register...

Page 795: ...see page 330 RISetime see page 334 RESults see page 331 SDEViation see page 335 SHOW see page 336 SOURce see page 337 STATistics see page 339 INCRement see page 340 RESet see page 341 TEDGe see page 3...

Page 796: ...ge 367 COUNt FWAVeforms see page 368 RESet see page 369 TIME see page 370 WAVeforms see page 371 DATA see page 372 DELete see page 373 ENABle see page 374 LOCK see page 375 OUTPut see page 376 RMODe s...

Page 797: ...t Register see page 171 POD n see page 392 DISPlay see page 393 SIZE see page 394 THReshold see page 395 RECall FILename see page 398 IMAGe see page 399 STARt see page 399 MASK see page 400 STARt see...

Page 798: ...e 419 SBUS see page 420 CAN COUNt ERRor see page 422 OVERload see page 423 RESet see page 424 TOTal see page 425 UTILization see page 426 DISPlay see page 427 FLEXray COUNt NULL see page 428 RESet see...

Page 799: ...YSTem see page 445 DATE see page 446 DSP see page 447 ERRor see page 448 LOCK see page 449 PRECision see page 450 PROTection LOCK see page 433 SETup see page 452 TIME see page 454 TER Trigger Event Re...

Page 800: ...see page 482 MODE see page 483 SAMPlepoint see page 484 SIGNal BAUDrate see page 485 DEFinition see page 739 SOURce see page 486 TRIGger see page 487 DURation see page 489 GREaterthan see page 490 LE...

Page 801: ...512 ID see page 513 TYPE see page 514 SOURce see page 515 TRIGger see page 516 GLITch see page 517 GREaterthan see page 519 LESSthan see page 520 LEVel see page 521 POLarity see page 522 QUALifier see...

Page 802: ...e 545 DATA see page 546 DATa2 see page 547 SOURce CLOCk see page 548 DATA see page 549 TRIGger QUALifier see page 550 TYPE see page 551 LIN see page 553 ID see page 555 PATTern DATA see page 556 LENGt...

Page 803: ...573 COUNt see page 574 EDGE see page 575 FIND see page 576 PATTern see page 577 RESet see page 578 TIMer see page 579 TRIGger see page 580 SPI see page 581 CLOCk SLOPe see page 582 TIMeout see page 58...

Page 804: ...e 604 QUALifier see page 606 POLarity see page 605 SOURce RX see page 607 TX see page 608 TYPE see page 609 WIDTh see page 610 USB see page 611 SOURce DMINus see page 612 DPLus see page 613 SPEed see...

Page 805: ...age 118 ESR see page 120 IDN see page 122 LRN see page 123 OPC see page 124 OPT see page 125 RCL see page 127 RST see page 128 SAV see page 131 SRE see page 132 STB see page 134 TRG see page 136 TST s...

Page 806: ...use the last mnemonic in the compound header as the reference point for example RANGe Then find the last colon above that mnemonic TIMebase That is the point where the parser resides Any command below...

Page 807: ...and with a semicolon The colon following the semicolon enables you to enter a new subsystem For example program mnemonic data program mnemonic data terminator For example myScope WriteString TIMebase...

Page 808: ...s to the designated listener typically a controller For example the query TIMebase RANGe places the current time base setting in the output queue When using the Agilent VISA COM library in Visual Basi...

Page 809: ...l IEEE 488 2 makes the distinction between sequential and overlapped commands Sequential commands finish their task before the execution of the next command starts Overlapped commands run concurrently...

Page 810: ...810 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 11 More About Oscilloscope Commands...

Page 811: ...ries Oscilloscopes Programmer s Guide 12 Programming Examples VISA COM Examples 812 VISA Examples 845 SICL Examples 891 Example programs are ASCII text files that can be cut from the help file and pas...

Page 812: ...ibrary c Click OK 4 Choose Insert Module 5 Cut and paste the code that follows into the editor 6 Edit the program to use the VISA address of your oscilloscope and save the changes 7 Run the program Ag...

Page 813: ...cilloscope in a known state Initialize Capture After initialization you must make waveform data available to analyze To do this capture the data using the DIGITIZE command Capture Analyze Once the wav...

Page 814: ...tion factor for the selected channel The probe attenuation factor may be set from 0 1 to 1000 myScope WriteString CHAN1 PROBE 10 Set Probe to 10 1 CHANNEL_RANGE Sets the full scale vertical range in v...

Page 815: ...iteString BLANK CHANNEL1 Turn channel 1 off myScope WriteString VIEW CHANNEL1 Turn channel 1 on TIMEBASE_MODE not executed in this example Set the time base mode to MAIN DELAYED XY or ROLL Set time ba...

Page 816: ...unication with the computer interrupts data acquisition Setting up the oscilloscope over the bus causes the data buffers to be cleared and internal hardware to be reconfigured If a measurement is imme...

Page 817: ...ck Write As 1 Put 1 byteData Write data Close 1 Close file myScope IO Timeout 5000 RESTORE_SYSTEM_SETUP Read the setup string from a file and write it back to the oscilloscope Dim varSetupString As Va...

Page 818: ...o be used as the source for the waveform commands myScope WriteString WAVEFORM SOURCE CHAN1 WAVE_POINTS Specifies the number of points to be transferred using the WAVEFORM DATA query myScope WriteStri...

Page 819: ...ble myScope ReadList Read preamble information intFormat Preamble 0 intType Preamble 1 lngPoints Preamble 2 lngCount Preamble 3 dblXIncrement Preamble 4 dblXOrigin Preamble 5 lngXReference Preamble 6...

Page 820: ...block The size can vary depending on the number of points acquired for the waveform You can then read that number of bytes from the oscilloscope and the terminating NL character Dim lngI As Long Dim l...

Page 821: ...Scope WriteString MEASURE TEDGE 2 CHAN1 Read time at edge 2 on ch 1 dblChan1Edge2 myScope ReadNumber Calculate period of ch 1 dblPeriod dblChan1Edge2 dblChan1Edge1 Calculate phase difference between c...

Page 822: ...Add a reference to the VISA COM 3 0 Type Library a Right click the project you wish to modify not the solution in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add...

Page 823: ...WriteLine VISA Error Message err Message catch System SystemException err Console WriteLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error C...

Page 824: ...s eight times the volts per division myScope DoCommand CHANnel1 RANGe 8 TIME_RANGE Sets the full scale horizontal time in seconds The range value is ten times the time per division myScope DoCommand T...

Page 825: ...LANk CHANnel1 myScope DoCommand VIEW CHANnel1 TIME_MODE not executed in this example Set the time base mode to MAIN DELAYED XY or ROLL myScope DoCommand TIMebase MODE MAIN Capture This function prepar...

Page 826: ...ation at a later time Save the oscilloscope display to a file which can be printed Make single channel measurements private static void Analyze byte ResultsArray Results array int nBytes Number of byt...

Page 827: ...myScope SetTimeoutSeconds 15 Get the screen data in PNG format ResultsArray myScope DoQueryIEEEBlock DISPlay DATA PNG SCReen COLor nBytes ResultsArray Length Console WriteLine Read screen image 0 byte...

Page 828: ...oints available is returned by the ACQUIRE POINTS query This can be set to any binary fraction of the total time points available myScope DoCommand WAVeform POINts 1000 GET_PREAMBLE The preamble conta...

Page 829: ...nce 0 e fYreference QUERY_WAVE_DATA Outputs waveform records to the controller over the interface that is stored in a buffer previously specified with the WAVeform SOURce command READ_WAVE_DATA The wa...

Page 830: ...fYincrement fYorigin float i fXreference fXincrement fXorigin SAVE_WAVE_DATA saves the waveform data to a CSV format file named waveform csv if File Exists c scope data waveform csv File Delete c scop...

Page 831: ...sults m_IoObject ReadString Check for instrument errors CheckForInstrumentErrors strQuery Return results string return strResults public double DoQueryValue string strQuery Send the query m_IoObject W...

Page 832: ...tsArray public void DoCommandIEEEBlock string strCommand byte DataArray Send the command m_IoObject WriteIEEEBlock strCommand DataArray true Check for instrument errors CheckForInstrumentErrors strCom...

Page 833: ...edIO488Class Open the default VISA COM IO object try m_IoObject IO IMessage m_ResourceManager Open m_strVisaAddress AccessMode NO_LOCK 0 catch Exception e Console WriteLine An error occurred 0 e Messa...

Page 834: ...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 InfiniiVision...

Page 835: ...hared Sub Initialize Dim strResults As String RESET This command puts the oscilloscope into a known state This statement is very important for programs to work as expected Most of the following initia...

Page 836: ...ER_MODE Set the trigger mode to EDGE GLITch PATTern CAN DURation IIC LIN SEQuence SPI TV UART or USB myScope DoCommand TRIGger MODE EDGE TRIGGER_EDGE_SLOPE Set the slope of the edge for the trigger to...

Page 837: ...mand causes an acquisition to take place with the resulting data being placed in the buffer NOTE The use of the DIGITIZE command is highly recommended as it will ensure that sufficient data is availab...

Page 838: ..._ nBytes RESTORE_SYSTEM_SETUP Uploads a previously saved setup string to the oscilloscope Dim DataArray As Byte Read setup string from file DataArray File ReadAllBytes c scope config setup dat Console...

Page 839: ...A query Once these parameters have been sent the WAVEFORM PREAMBLE query provides information concerning the vertical and horizontal scaling of the waveform data With the preamble information you can...

Page 840: ...OINts 0 e fPoints Dim fCount As Double fResultsArray 3 Console WriteLine Preamble COUNt 0 e fCount Dim fXincrement As Double fResultsArray 4 Console WriteLine Preamble XINCrement 0 e fXincrement Dim f...

Page 841: ...lay As Double fPoints 2 fXincrement fXorigin Print them out Console WriteLine Scope Settings for Channel 1 Console WriteLine Volts per Division 0 f fVdiv Console WriteLine Offset 0 f fOffset Console W...

Page 842: ...tring Send the command m_IoObject WriteString strCommand True Check for instrument errors CheckForInstrumentErrors strCommand End Sub Public Function DoQueryString ByVal strQuery As String As String S...

Page 843: ...ry True Get the results array Dim ResultsArray As Byte ResultsArray _ m_IoObject ReadIEEEBlock IEEEBinaryType BinaryType_UI1 _ False True Check for instrument errors CheckForInstrumentErrors strQuery...

Page 844: ...ub Private Sub OpenIo m_ResourceManager New ResourceManagerClass m_IoObject New FormattedIO488Class Open the default VISA COM IO object Try m_IoObject IO _ DirectCast m_ResourceManager Open m_strVisaA...

Page 845: ...ple c file and click Add 6 Edit the program to use the VISA address of your oscilloscope 7 Choose Project Properties In the Property Pages dialog update these project settings a Under Configuration Pr...

Page 846: ...alize the oscilloscope void extra void Miscellaneous commands not executed shown for reference purposes void capture void Digitize data from oscilloscope void analyze void Make some measurements void...

Page 847: ...of the following initialization commands are initialized by this command It is not necessary to reinitialize them unless you want to change the default setting viPrintf vi RST n Write the IDN string...

Page 848: ...vi TRIGGER MODE EDGE n TRIGGER_EDGE_SLOPE Set the slope of the edge for the trigger to either POSITIVE or NEGATIVE viPrintf vi TRIGGER EDGE SLOPE POSITIVE n extra The commands in this function are no...

Page 849: ...ing data being placed in the buffer NOTE The use of the DIGITIZE command is highly recommended as it will ensure that sufficient data is available for measurement Keep in mind when the oscilloscope is...

Page 850: ...YSTEM_SETUP Uploads a previously saved setup string to the oscilloscope Read setup string from file fp fopen c scope config setup dat rb setup_size fread setup_string sizeof unsigned char SETUP_STR_SI...

Page 851: ...ble 4 10 delay preamble 2 2 preamble 4 preamble 5 Print them out printf Scope Settings for Channel 1 n printf Volts per Division f n vdiv printf Offset f n off printf Seconds per Division f n sdiv pri...

Page 852: ...n the form preamble block NL where the preamble block is FORMAT int16 0 BYTE 1 WORD 4 ASCII TYPE int16 0 NORMAL 1 PEAK DETECT 2 AVERAGE POINTS int32 number of data points transferred COUNT int32 1 and...

Page 853: ...ired for the waveform which can be set using the WAVEFORM POINTS command You may then read that number of bytes from the oscilloscope then read the following NL character to terminate the query wavefo...

Page 854: ...rosoft Excel 2 Press ALT F11 to launch the Visual Basic editor 3 Add the visa32 bas file to your project a Choose File Import File b Navigate to the header file visa32 bas installed with Agilent IO Li...

Page 855: ...Sleep subroutine Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long Main Program Sub Main Open the default resource manager session err viOpenDefaultRM drm If err VI_SUCCESS Then Hand...

Page 856: ...the trigger mode to EDGE DoCommand TRIGger MODE EDGE Debug Print Trigger mode _ DoQueryString TRIGger MODE Set EDGE trigger parameters DoCommand TRIGger EDGE SOURCe CHANnel1 Debug Print Trigger edge s...

Page 857: ...Command TIMebase SCALe 0 0002 Debug Print Timebase scale _ DoQueryString TIMebase SCALe DoCommand TIMebase POSition 0 0 Debug Print Timebase position _ DoQueryString TIMebase POSition Set the acquisit...

Page 858: ...screen image Dim lngBlockSize As Long lngBlockSize _ DoQueryIEEEBlock_Bytes DISPlay DATA PNG SCREEN COLOR Debug Print Screen image bytes CStr lngBlockSize Save screen image to a file Dim strPath As S...

Page 859: ...gXReference As Long Dim sngYIncrement As Single Dim sngYOrigin As Single Dim lngYReference As Long Dim strOutput As String Dim lngNumNumbers As Long lngNumNumbers DoQueryNumbers WAVeform PREamble intF...

Page 860: ...ce 0 Get the waveform data Dim lngNumBytes As Long lngNumBytes DoQueryIEEEBlock_Bytes WAVeform DATA Debug Print Number of data values CStr lngNumBytes Set up output file strPath c scope data waveform_...

Page 861: ...HandleVISAError vi DoCommandIEEEBlock retCount CheckInstrumentErrors End Function Private Function DoQueryString query As String As String Dim strResult As String 200 err viVPrintf vi query vbLf 0 If...

Page 862: ...QueryNumbers retCount CheckInstrumentErrors End Function Private Function DoQueryIEEEBlock_Bytes query As String As Long Send query err viVPrintf vi query vbLf 0 If err VI_SUCCESS Then HandleVISAError...

Page 863: ...0 Request error If err VI_SUCCESS Then HandleVISAError vi err viVScanf vi t strErrVal Read error message If err VI_SUCCESS Then HandleVISAError vi Wend If Not strOut Then MsgBox strOut vbExclamation...

Page 864: ...e visa32 cs installed with Agilent IO Libraries Suite and found in the Program Files VISA winnt include directory select it but do not click the Open button d Click the down arrow to the right of the...

Page 865: ...eLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected Error err Message finally oscp Close Initialize This funct...

Page 866: ...RANGE Sets the full scale horizontal time in seconds The range value is ten times the time per division oscp DoCommand TIMebase RANGe 2e 3 TIME_REFERENCE Possible values are LEFT and CENTER LEFT sets...

Page 867: ...D XY or ROLL oscp DoCommand TIMebase MODE MAIN Capture This function prepares the scope for data acquisition and then uses the DIGITIZE MACRO to capture some data private static void Capture AQUIRE_TY...

Page 868: ...annel measurements private static void Analyze byte ResultsArray Results array int nLength Number of bytes returned from instrument SAVE_SYSTEM_SETUP The SYSTem SETup query returns a program message t...

Page 869: ...scp SetTimeoutSeconds 15 Get the screen data in PNG format nLength oscp DoQueryIEEEBlock DISPlay DATA PNG SCReen COLor out ResultsArray Console WriteLine Read screen image 0 bytes nLength Store the sc...

Page 870: ...INTS query This can be set to any binary fraction of the total time points available oscp DoCommand WAVeform POINts 1000 GET_PREAMBLE The preamble contains all of the current WAVEFORM settings returne...

Page 871: ...AVE_DATA Outputs waveform records to the controller over the interface that is stored in a buffer previously specified with the WAVeform SOURce command READ_WAVE_DATA The wave data consists of two par...

Page 872: ...float i fXreference fXincrement fXorigin SAVE_WAVE_DATA saves the waveform data to a CSV format file named waveform csv if File Exists c scope data waveform csv File Delete c scope data waveform csv...

Page 873: ...er nViStatus visa32 viPrintf m_nSession strCommandAndLength CheckVisaStatus nViStatus Write the data to the formatted I O write buffer nViStatus visa32 viBufWrite m_nSession DataArray nLength out nByt...

Page 874: ...tsArray VisaGetResultValues Check for instrument errors another command and result CheckForInstrumentErrors strQuery Return string results return fResultsArray public int DoQueryIEEEBlock string strQu...

Page 875: ...t nViStatus nViStatus visa32 viPrintf m_nSession strWithNewline CheckVisaStatus nViStatus private StringBuilder VisaGetResultString StringBuilder strResults new StringBuilder 1000 Read return value st...

Page 876: ...ead buffers need to be flushed after IEEE block nViStatus visa32 viFlush m_nSession visa32 VI_WRITE_BUF CheckVisaStatus nViStatus nViStatus visa32 viFlush m_nSession visa32 VI_READ_BUF CheckVisaStatus...

Page 877: ...ollows into the Visual Basic NET source file 4 Edit the program to use the VISA address of your oscilloscope 5 Add Agilent s VISA header file to your project a Right click the project you wish to modi...

Page 878: ...w VisaInstrument USB0 2391 5957 MY47250010 0 INSTR Initialize The extras function contains miscellaneous commands that do not need to be executed for the proper operation of this example The commands...

Page 879: ...L_PROBE Sets the probe attenuation factor for the selected channel The probe attenuation factor may be from 0 1 to 1000 oscp DoCommand CHANnel1 PROBe 10 CHANNEL_RANGE Sets the full scale vertical rang...

Page 880: ...ANnel1 oscp DoCommand VIEW CHANnel1 TIME_MODE not executed in this example Set the time base mode to MAIN DELAYED XY or ROLL oscp DoCommand TIMebase MODE MAIN End Sub Capture This function prepares th...

Page 881: ...e which can be printed Make single channel measurements Private Shared Sub Analyze Results array Dim ResultsArray As Byte Number of bytes returned from instrument Dim nLength As Integer SAVE_SYSTEM_SE...

Page 882: ...s oscp SetTimeoutSeconds 15 Get the screen data in PNG format nLength _ oscp DoQueryIEEEBlock DISPlay DATA PNG SCReen COLor _ ResultsArray Console WriteLine Read screen image 0 bytes nLength Store the...

Page 883: ...the total time points available oscp DoCommand WAVeform POINts 1000 GET_PREAMBLE The preamble contains all of the current WAVEFORM settings returned in the form preamble block NL where the preamble b...

Page 884: ...orm SOURce command READ_WAVE_DATA The wave data consists of two parts the header and the actual waveform data followed by a New Line NL character The query data has the following format header wavefor...

Page 885: ...aveform csv End If Dim writer As StreamWriter _ File CreateText c scope data waveform csv For index As Integer 0 To 999 writer WriteLine 0 E 1 f6 _ CSng index fXreference fXincrement fXorigin _ CSng R...

Page 886: ...rite the data to the formatted I O write buffer nViStatus visa32 viBufWrite m_nSession DataArray nLength _ nBytesWritten CheckVisaStatus nViStatus Write command termination character nViStatus visa32...

Page 887: ...ction Public Function DoQueryIEEEBlock ByVal strQuery As String _ ByRef ResultsArray As Byte As Integer Send the query VisaSendCommandOrQuery strQuery Get the result string Dim length As Integer Numbe...

Page 888: ...ice Dim nViStatus As Integer nViStatus visa32 viScanf m_nSession 1000t strResults CheckVisaStatus nViStatus Return strResults End Function Private Function VisaGetResultValue As Double Dim fResults As...

Page 889: ...viOpenDefaultRM Me m_nResourceManager If nViStatus visa32 VI_SUCCESS Then Throw New _ ApplicationException Failed to open Resource Manager End If End Sub Private Sub OpenSession Dim nViStatus As Integ...

Page 890: ...890 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 12 Programming Examples If m_nResourceManager 0 Then visa32 viClose m_nResourceManager End If End Sub End Class End Namespace...

Page 891: ...y Pages dialog update these project settings a Under Configuration Properties Linker Input add sicl32 lib to the Additional Dependencies field b Under Configuration Properties C C Code Generation sele...

Page 892: ...void analyze void Make some measurements void get_waveform void Download waveform data from oscilloscope void save_waveform void Save waveform data to a file void retrieve_waveform void Load waveform...

Page 893: ...SICL for this application This call is a no op for WIN32 programs _siclcleanup initialize This function initializes both the interface and the oscilloscope to a known state void initialize void RESET...

Page 894: ...n from the left CENTER sets the display reference to the center of the screen iprintf id TIMEBASE REFERENCE CENTER n TRIGGER_SOURCE Selects the channel that actually produces the TV trigger Any channe...

Page 895: ...on criteria for an acquisition The parameter determines the percentage of time buckets needed to be full before an acquisition is considered to be complete iprintf id ACQUIRE COMPLETE 100 n DIGITIZE U...

Page 896: ...string is 2204 bytes in length setup_size SETUP_STR_SIZE Query and read setup string ipromptf id SYSTEM SETUP n b n setup_size setup_string printf Read setup string query d bytes n setup_size Write se...

Page 897: ...mptf id MEASURE FREQUENCY n lf frequency printf The frequency is 4f kHz n frequency 1000 Query for peak to peak voltage ipromptf id MEASURE VPP n lf vpp printf The peak to peak voltage is 2f V n vpp W...

Page 898: ...TE format Set waveform format to BYTE iprintf id WAVEFORM FORMAT BYTE n WAVE_POINTS Sets the number of points to be transferred The number of time points available is returned by the ACQUIRE POINTS qu...

Page 899: ...rm data followed by an New Line NL character The query data has the following format header waveform data block NL Where header 800002048 this is an example header The 8 may be stripped off of the hea...

Page 900: ...data fread waveform_data sizeof waveform_data 0 int preamble 2 fp fclose fp SICL Example in Visual Basic To run this example in Visual Basic for Applications 1 Start the application that provides Visu...

Page 901: ...0000 Public retCount As Long Public byteArray ByteArraySize As Byte Declare fixed length string variable to hold string value returned by ivscanf Public strQueryResult As String 200 Main Program Sub M...

Page 902: ...End Sub Capture the waveform Private Sub Capture On Error GoTo ErrorHandler Use auto scale to automatically configure oscilloscope DoCommand AUToscale Save oscilloscope configuration Dim lngSetupStrin...

Page 903: ...String CHANnel1 SCALe DoCommand CHANnel1 OFFSet 1 5 Debug Print Channel 1 vertical offset _ DoQueryString CHANnel1 OFFSet Set horizontal scale and offset DoCommand TIMebase SCALe 0 0002 Debug Print Ti...

Page 904: ...EASure VAMPlitude MsgBox Vertical amplitude vbCrLf _ FormatNumber dblQueryResult 4 V DoCommand MEASure FREQuency dblQueryResult DoQueryNumber MEASure FREQuency MsgBox Frequency vbCrLf _ FormatNumber d...

Page 905: ...bug Print Waveform X increment channel 1 _ Format dblXIncrement Scientific dblXOrigin DoQueryNumber WAVeform XORigin Debug Print Waveform X origin channel 1 _ Format dblXOrigin Scientific dblYIncremen...

Page 906: ...at dblXOrigin lngI dblXIncrement Scientific _ _ FormatNumber lngDataValue dblYReference dblYIncrement _ dblYOrigin Next lngI Close output file Close hFile Close file MsgBox Waveform format BYTE data w...

Page 907: ...QueryString query As String As String Dim actual As Long On Error GoTo ErrorHandler Dim ret_val As Integer Dim strResult As String 200 Call ivprintf id query vbLf Call ivscanf id 200t strResult CheckF...

Page 908: ...ion ErrorHandler MsgBox Error Error vbExclamation End End Function Private Sub CheckForInstrumentErrors strCmdOrQuery As String On Error GoTo ErrorHandler Dim strErrVal As String 200 Dim strOut As Str...

Page 909: ...ontrol 183 AREA commands 654 area for hardcopy print 283 area for saved image 407 Arm Event Register AER 143 165 167 768 arrange waveforms 700 ASCII format 628 ASCII format for data transfer 622 ASCII...

Page 910: ...code CHANnel n LABel 225 code CHANnel n PROBe 227 code CHANnel n RANGe 233 code DIGitize 150 code DISPlay DATA 248 code DISPlay LABel 249 code DISPlay ORDer 700 code MEASure PERiod 338 code MEASure RE...

Page 911: ...296 DeskJet 707 destination 252 detecting probe types 698 703 device for hardcopy 707 device defined error queue clear 117 differential probe heads 228 differential signal type 231 260 differentiate...

Page 912: ...ommands 660 FACTors commands 660 fail mask test output 376 failed waveforms in mask test 368 failure self test 137 fall time measurement 312 322 falling edge 475 575 Fast Fourier Transform FFT functio...

Page 913: ...le until operation complete 124 IDN Identification Number 122 IEEE 488 2 standard 116 IGColors commands 664 IIC address 545 IIC clock 548 IIC commands 663 IIC data 546 549 IIC data 2 547 IIC serial de...

Page 914: ...ion 298 markers X1Y1 source 299 markers X2 position 300 markers X2Y2 source 301 markers Y delta 305 markers Y1 position 303 markers Y2 position 304 mask 118 132 475 492 mask command bus 206 MASK comma...

Page 915: ...e 721 offset 266 OFFSet commands 668 offset value for channel voltage 226 offset value for selected function 272 275 one values in waveform data 626 OPC Operation Complete command 124 OPC Operation Co...

Page 916: ...rogram message 49 116 program message syntax 787 program message terminator 788 program structure 46 programming examples 4 811 protecting against calibration 214 protection 169 171 232 261 PROTection...

Page 917: ...nput 227 sequence 576 577 578 sequence trigger 580 SEQuence trigger commands 573 sequence triggering 469 sequencer edge counter 574 sequencer timer 579 sequential commands 809 serial clock 548 587 ser...

Page 918: ...threshold 243 395 695 741 THReshold commands 678 threshold voltage lower for measurement 713 threshold voltage upper for measurement 723 thresholds 317 716 thresholds used to measure period 327 thres...

Page 919: ...tern 577 trigger sequence reset 578 trigger sequence timer 579 trigger SPI clock slope 582 trigger SPI clock source 587 trigger SPI clock timeout 583 trigger SPI data source 588 trigger SPI frame sour...

Page 920: ...Wait To Continue 138 wait 138 wait for operation complete 124 Wait Trig bit 165 167 waveform base value measured 348 WAVeform command 47 WAVeform commands 616 684 waveform data 618 waveform data form...

Page 921: ...ilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide 921 Z zero values in waveform data 626 zoomed time base 457 zoomed time base mode how autoscale affects 144 zoomed window horizontal s...

Page 922: ...922 Agilent InfiniiVision 7000A Series Oscilloscopes Programmer s Guide Index...

Reviews: