manualshive.com logo in svg

Agilent Technologies Infiniium 90000 Q-Series, Programmer'S Manual

Share
Download
Agilent Technologies Infiniium 90000 Q-Series Programmer'S Manual Download Page 54

54

Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference

3

Introduction to Programming

 

Instructions

Instructions, both commands and queries, normally appear as strings 
embedded in a statement of your host language, such as Visual Basic for 
Applications (VBA), Visual Basic .NET, C#, C, etc.

The only time a parameter is not meant to be expressed as a string is 
when the instruction's syntax definition specifies <block data>, such as 
with the :SYSTem:SETup command. There are only a few instructions that 
use block data.

Instructions are composed of two main parts:

•

The header, which specifies the command or query to be sent.

•

The program data, which provides additional information to clarify the 
meaning of the instruction.

Summary of Contents for Infiniium 90000 Q-Series

Page 1: ...s1 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference...

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

Page 3: ...s Reporting starting on page 103 Chapter 7 Remote Acquisition Synchronization starting on page 127 Chapter 8 Programming Conventions starting on page 137 The next chapters describe the commands used t...

Page 4: ...are no longer supported Chapter 37 Error Messages starting on page 1007 describes error messages Chapter 38 Sample Programs starting on page 1019 shows example programs in various languages using the...

Page 5: ...39 What s New in Version 3 11 40 What s New in Version 3 10 41 2 Setting Up Step 1 Install Agilent IO Libraries Suite software 44 Step 2 Connect and set up the oscilloscope 45 Using the USB Device In...

Page 6: ...a Subsystem 70 Selecting Multiple Subsystems 71 Programming Getting Started 72 Referencing the IO Library 73 Opening the Oscilloscope Connection via the IO Library 74 Initializing the Interface and t...

Page 7: ...ssage Communication and System Functions Protocols 100 Functional Elements 100 Protocol Overview 100 Protocol Operation 101 Protocol Exceptions 101 Suffix Multiplier 101 Suffix Unit 102 6 Status Repor...

Page 8: ...form 130 Retrieving Results 131 Acquisition Synchronization 132 Blocking Synchronization 132 Polling Synchronization With Timeout 132 Single Shot Device Under Test DUT 134 Averaging Acquisition Synchr...

Page 9: ...SRATe ANALog 170 ACQuire SRATe ANALog AUTO 172 ACQuire SRATe DIGital 173 ACQuire SRATe DIGital AUTO 174 10 Bus Commands BUS B N TYPE 176 BUS N BIT M 177 BUS N BITS 178 BUS N CLEar 179 BUS N CLOCk 180...

Page 10: ...HANnel N PROBe AUTozero 219 CHANnel N PROBe COUPling 220 CHANnel N PROBe EADapter 221 CHANnel N PROBe ECOupling 223 CHANnel N PROBe EXTernal 224 CHANnel N PROBe EXTernal GAIN 225 CHANnel N PROBe EXTer...

Page 11: ...8 14 Digital Commands DIGital N DISPlay 270 DIGital N LABel 271 DIGital N SIZE 272 DIGital N THReshold 273 15 Disk Commands DISK CDIRectory 276 DISK COPY 277 DISK DELete 278 DISK DIRectory 279 DISK LO...

Page 12: ...308 DISPlay PERSistence 309 DISPlay ROW 310 DISPlay SCOLor 311 DISPlay STATus COL 313 DISPlay STATus ROW 314 DISPlay STRing 315 DISPlay TAB 316 DISPlay TEXT 317 17 Function Commands FUNCtion F 322 FUN...

Page 13: ...n F MULTiply 353 FUNCtion F OFFSet 354 FUNCtion F RANGe 355 FUNCtion F SMOoth 356 FUNCtion F SQRT 357 FUNCtion F SQUare 358 FUNCtion F SUBTract 359 FUNCtion F VERSus 360 FUNCtion F VERTical 361 FUNCti...

Page 14: ...ce 392 ISCan RUNT HYSTeresis 393 ISCan RUNT LLEVel 394 ISCan RUNT SOURce 395 ISCan RUNT ULEVel 396 ISCan SERial PATTern 397 ISCan SERial SOURce 398 ISCan ZONE HIDE 399 ISCan ZONE SOURce 400 ISCan ZONE...

Page 15: ...UNITs 437 MTESt AMASk XDELta 438 MTESt AMASk YDELta 439 MTESt AUTO 440 MTESt AVERage 441 MTESt AVERage COUNt 442 MTESt COUNt FAILures 443 MTESt COUNt FUI 444 MTESt COUNt FWAVeforms 445 MTESt COUNt UI...

Page 16: ...ion 488 MEASure CGRade EHEight 489 MEASure CGRade EWIDth 490 MEASure CGRade EWINdow 491 MEASure CGRade JITTer 492 MEASure CGRade QFACtor 493 MEASure CLEar 494 MEASure CLOCk 495 MEASure CLOCk METHod 49...

Page 17: ...STogram MEAN 549 MEASure HISTogram MEDian 550 MEASure HISTogram MIN 551 MEASure HISTogram MODE 552 MEASure HISTogram PEAK 553 MEASure HISTogram PP 554 MEASure HISTogram RESolution 555 MEASure HISTogra...

Page 18: ...SCOPe RN 588 MEASure NOISe STATe 589 MEASure NOISe UNITs 590 MEASure NPERiod 591 MEASure NPULses 592 MEASure NUI 593 MEASure NWIDth 594 MEASure OVERshoot 596 MEASure PAMPlitude 598 MEASure PBASe 599...

Page 19: ...HResholds ABSolute 646 MEASure THResholds HYSTeresis 648 MEASure THResholds METHod 650 MEASure THResholds PERCent 651 MEASure THResholds TOPBase METHod 653 MEASure THResholds TOPBase ABSolute 654 MEAS...

Page 20: ...nt N SOURce 695 26 Pod Commands POD N DISPlay 698 POD N PSKew 699 POD N THReshold 700 27 Root Level Commands ADER 705 AER 706 ATER 707 AUToscale 708 AUToscale CHANnels 709 AUToscale PLACement 710 AUTo...

Page 21: ...order 746 SBUS N SPI CLOCk SLOPe 747 SBUS N SPI CLOCk TIMeout 748 SBUS N SPI FRAMe STATe 749 SBUS N SPI SOURce CLOCk 750 SBUS N SPI SOURce DATA 751 SBUS N SPI SOURce FRAMe 752 SBUS N SPI SOURce MISO 7...

Page 22: ...izer TAP UTARget 784 SPRocessing DFEQualizer TAP LTARget 785 SPRocessing DFEQualizer TAP AUTomatic 786 SPRocessing FFEQualizer DISPlay 787 SPRocessing FFEQualizer SOURce 788 SPRocessing FFEQualizer NP...

Page 23: ...INDow POSition 827 TIMebase WINDow RANGe 828 TIMebase WINDow SCALe 829 33 Trigger Commands General Trigger Commands 833 TRIGger AND ENABle 834 TRIGger AND SOURce 835 TRIGger HOLDoff 836 TRIGger HOLDof...

Page 24: ...ce 868 TRIGger GLITch WIDTh 869 Pattern Trigger Commands 870 TRIGger PATTern CONDition 871 TRIGger PATTern LOGic 872 Pulse Width Trigger Commands 873 TRIGger PWIDth DIRection 874 TRIGger PWIDth POLari...

Page 25: ...er TIMeout CONDition 906 TRIGger TIMeout SOURce 907 TRIGger TIMeout TIME 908 Transition Trigger Commands 909 TRIGger TRANsition DIRection 910 TRIGger TRANsition SOURce 911 TRIGger TRANsition TIME 912...

Page 26: ...WAVeform SEGMented XLISt 973 WAVeform SOURce 974 WAVeform STReaming 975 WAVeform TYPE 976 WAVeform VIEW 977 WAVeform XDISplay 979 WAVeform XINCrement 980 WAVeform XORigin 981 WAVeform XRANge 982 WAVef...

Page 27: ...020 VISA COM Example in Visual Basic 1020 VISA COM Example in C 1031 VISA COM Example in Visual Basic NET 1041 VISA COM Example in Python 1051 VISA Examples 1059 VISA Example in C 1059 VISA Example in...

Page 28: ...gilent Infiniium 90000 Series Oscilloscopes Programmer s Reference BIN Header Format 1155 File Header 1155 Waveform Header 1155 Waveform Data Header 1157 Example Program for Reading Binary Data 1158 I...

Page 29: ...at s New What s New in Version 4 50 30 What s New in Version 4 30 33 What s New in Version 4 20 34 What s New in Version 4 10 35 What s New in Version 4 00 36 What s New in Version 3 50 37 What s New...

Page 30: ...oscilloscopes which provide up to 16 digital input channels DISable DIGital see page 716 The DISable DIGital command supports the new MSO 90000 X Series mixed signal oscilloscopes which provide up to...

Page 31: ...me see page 639 Digital channels can now be specified as sources MEASure SOURce see page 642 Digital channels can now be specified as sources MEASure TEDGe see page 644 Digital channels can now be spe...

Page 32: ...857 Digital channels can now be specified as the source TRIGger DELay TRIGger SOU Rce see page 861 Digital channels can now be specified as the source TRIGger EDGE SOURce see page 865 Digital channel...

Page 33: ...aveform delayed in time FUNCtion F GATing see page 340 Defines a horizontal gating function of another waveform similar to horizontal zoom Measurements on horizontal gating functions are essentially g...

Page 34: ...OCk METHod JT F see page 502 Specifies the clock recovery PLL s response in terms of the Jitter Transfer Function s JTF 3 dB bandwidth MEASure CLOCk METHod OJ TF see page 504 Specifies the clock recov...

Page 35: ...AILfit to specify which method is used for the reports MEASure RJDJ METHod see page 627 Lets you select the method for random jitter RJ analysis either the SPECtral method or BOTH the spectral and tai...

Page 36: ...dwidth models of the 90000 Q Series oscilloscopes this command enables or disables the RealEdge channel inputs DISK SAVE PRECprobe see page 287 Saves PrecisionProbe Cable data to a file ISCan ZONE HID...

Page 37: ...MEASure NOISe see page 580 Adds a Noise measurement to the oscilloscope display like Measure Data Noise from the front panel or gets the measured noise value MEASure NOISe ALL see page 581 Returns th...

Page 38: ...with Meas Histogram math functions MEASure HISTogram MAX see page 548 Can now use this command with Meas Histogram math functions MEASure HISTogram MEAN see page 549 Can now use this command with Mea...

Page 39: ...X Series oscilloscope software appear below New Commands Command Description MARKer MEASurement MEA Surement see page 419 Specifies which measurement markers track when the MARKer MODE is set to MEASu...

Page 40: ...CHANnel N ISIM PEXTracti on see page 210 Selects a channel s InfiniiSim port extraction MEASure HISTogram MODE see page 552 Returns the measurement histogram s Mode value Command Description BUS B N T...

Page 41: ...ion CHANnel N PROBe PRECpr obe ZSRC see page 238 Specifies how PrecisionProbe characterizes the time domain and frequency domain response DISPlay STATus COL see page 313 Used to position the real time...

Page 42: ...INT16 options have been added for specifying the 1 2 4 8 or 16 point Sin x x interpolation ratios MEASure RJDJ BER see page 622 You can now set J2 and J9 jitter BER levels MEASure VRMS see page 686 T...

Page 43: ...scilloscope connection 46 This chapter explains how to install the Agilent IO Libraries Suite software on a controller PC connect the oscilloscope to the controller PC set up the oscilloscope and veri...

Page 44: ...To install the Agilent IO Libraries Suite software on a controller PC 1 Download the Agilent IO Libraries Suite software from the Agilent web site at http www agilent com find iolib 2 Run the setup f...

Page 45: ...to the USB DEVICE port on the back of the oscilloscope This is a USB 2 0 high speed port Using the LAN Interface 1 If the controller PC is not already connected to the local area network LAN do that f...

Page 46: ...choose Agilent Connection Expert from the popup menu 2 In the Agilent Connection Expert application instruments connected to the controller s USB and GPIB interfaces should automatically appear You c...

Page 47: ...ies Oscilloscopes Programmer s Reference 47 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 48: ...click Add Address i In the next dialog select either Hostname or IP address and enter the oscilloscope s hostname or IP address ii Click Test Connection iii If the instrument is successfully opened cl...

Page 49: ...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 50: ...50 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 2 Setting Up...

Page 51: ...rogram Data 66 Numeric Program Data 67 Embedded Strings 68 Program Message Terminator 69 Common Commands within a Subsystem 70 Selecting Multiple Subsystems 71 Programming Getting Started 72 Referenci...

Page 52: ...eans of remote control Basic operations that you can do with a computer and an oscilloscope include Set up the oscilloscope Make measurements Get data waveform measurements and configuration from the...

Page 53: ...A COM library provides the WriteString method for sending commands and queries After a query is sent the response can be read using the ReadString method The ReadString method passes the value across...

Page 54: ...tions VBA Visual Basic NET C C etc The only time a parameter is not meant to be expressed as a string is when the instruction s syntax definition specifies block data such as with the SYSTem SETup com...

Page 55: ...o be performed by the oscilloscope See Chapter 8 Programming Conventions starting on page 137 for more information Queries are formed by adding a question mark to the end of the header Many instructio...

Page 56: ...ace Separator White space is used to separate the instruction header from the program data If the instruction does not require any program data parameters you do not need to include any white space In...

Page 57: ...90000 Series Oscilloscopes Programmer s Reference 57 Braces When several items are enclosed by braces only one of these elements may be selected Vertical line indicates or For example ON OFF indicate...

Page 58: ...Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 3 Introduction to Programming Ellipsis An ellipsis trailing dots indicates that the preceding element may be repeated one or more ti...

Page 59: ...Introduction to Programming 3 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 59 Square Brackets Items enclosed in square brackets are optional...

Page 60: ...ies require that a source be specified Depending on the command or query and the model number of Infiniium oscilloscope being used some of the sources are not available The following is a list of sour...

Page 61: ...f the command or query It provides necessary information such as whether a function should be on or off or which waveform is to be displayed Each instruction s syntax definition shows the program data...

Page 62: ...is program mnemonic terminator For example AUTOSCALE When program data must be included with the simple command header for example DIGITIZE CHAN1 white space is added to separate the data from the hea...

Page 63: ...ons within the oscilloscope The syntax is command header terminator No space or separator is allowed between the asterisk and the command header CLS is an example of a common command header Duplicate...

Page 64: ...r Range You can use queries to find out how the oscilloscope is currently configured and to get results of measurements made by the oscilloscope For example the query MEASURE RISETIME tells the oscill...

Page 65: ...short form For example TIMebase DELay 1E 6 is the long form TIM DEL 1E 6 is the short form The command descriptions in this reference show upper and lowercase characters For example AUToscale indicate...

Page 66: ...to left center or right The character program data in this case may be LEFT CENTER or RIGHT The command TIMEBASE REFERENCE RIGHT sets the time base reference to right The available mnemonics for char...

Page 67: ...all equal 28 0 28E2 280E 1 28000m 0 028K 28E 3K When a syntax definition specifies that a number is an integer it means that the number should be whole Any fractional part is ignored and truncated Nu...

Page 68: ...ic characters which are treated as a unit of data by the oscilloscope An example of this is the line of text written to the advisory line of the oscilloscope with the SYSTEM DSP command SYSTEM DSP Thi...

Page 69: ...eived The terminator may be either an NL New Line character an EOI End Or Identify asserted in the GPIB interface or a combination of the two Asserting the EOI sets the EOI control line low on the las...

Page 70: ...subsystem For example if the program message ACQUIRE AVERAGE ON CLS COUNT 1024 is received by the oscilloscope the oscilloscope turns averaging on then clears the status information without leaving t...

Page 71: ...es for different subsystems on the same line by separating each command with a semicolon The colon following the semicolon lets you enter a new subsystem For example program mnemonic data program mnem...

Page 72: ...Getting Started The remainder of this chapter explains how to set up the oscilloscope how to retrieve setup information and measurement results how to digitize a waveform and how to pass data to the c...

Page 73: ...ry files see the Agilent IO Libraries Suite documentation for more information To reference the Agilent VISA COM library in Visual Basic for Applications VBA which comes with Microsoft Office products...

Page 74: ...od the FormattedIO488 object s WriteString WriteNumber WriteList or WriteIEEEBlock methods are used for sending commands and queries After a query is sent the response is read using the ReadString Rea...

Page 75: ...r and set the interface timeout to 10 seconds myScope IO Clear myScope IO Timeout 10000 When you are using GPIB CLEAR also resets the oscilloscope s parser The parser is the program which reads in the...

Page 76: ...elay time delay reference trigger mode trigger level and slope A typical example of the commands sent to the oscilloscope are CHANNEL1 PROBE 10 RANGE 16 OFFSET 1 00 terminator SYSTEM HEADER OFF termin...

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

Page 78: ...umber of data points comprising a waveform varies according to the number requested in the ACQUIRE subsystem The ACQUIRE subsystem determines the number of data points type of acquisition and number o...

Page 79: ...ructures available formatting and I O capabilities You must convert the data values to determine the voltage value of each point These data values are passed starting with the left most point on the o...

Page 80: ...CHANNEL1 INPUT you would use the ReadString method Dim strSetting As String myScope WriteString CHANnel1 INPut strSetting myScope ReadString This would enter the current setting for the channel 1 coup...

Page 81: ...for the formats and types of data returned from queries This example shows the data being returned to a string variable Dim strRang As String myScope WriteString CHANNEL1 RANGE strRang myScope ReadStr...

Page 82: ...Programming Numeric Variable Example This example shows the data being returned to a numeric variable Dim varRang As Variant myScope WriteString CHANnel1 RANGe varRang myScope ReadNumber Debug Print C...

Page 83: ...antities of data or 8 bit extended ASCII codes The syntax is a pound sign followed by a non zero digit representing the number of digits in the decimal integer After the non zero digit is the decimal...

Page 84: ...single string variable each response is separated by a semicolon For example the output of the previous example would be Timebase range delay range_value delay_value To read the TIMebase RANGe DELay q...

Page 85: ...5 Oscilloscope Status Status registers track the current status of the oscilloscope By checking the oscilloscope status you can find out whether an operation has completed and is receiving triggers Ch...

Page 86: ...86 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 3 Introduction to Programming...

Page 87: ...ies 91 GPIB Command and Data Concepts 92 Communicating Over the GPIB Interface 93 Communicating Over the LAN Interface 94 Communicating via Telnet and Sockets 96 Bus Commands 98 There are several type...

Page 88: ...on the rear panel This allows direct connect to your network However before you can use the LAN interface to program the oscilloscope the network properties must be configured Unless you are a Network...

Page 89: ...loscope by installing a GPIB cable between the two units Finger tighten the captive screws on both ends of the GPIB cable to avoid accidentally disconnecting the cable during operation A maximum of fi...

Page 90: ...hex Service Request Enable Register is set to 0x80 hex The Operation Status Enable Register is set to 0xFFFF hex The Overload Event Enable Register is set to 0xFF hex The Mask Test Event Enable Regis...

Page 91: ...Function Capability SH1 Source Handshake Full Capability AH1 Acceptor Handshake Full Capability T5 Talker Basic Talker Serial Poll Talk Only Mode Unaddress if Listen Address MLA L4 Listener Basic List...

Page 92: ...ention ATN control line is true The command mode is used to send talk and listen addresses and various interface commands such as group execute trigger GET The interface is in the data mode when the A...

Page 93: ...face Select Code Each interface card has a unique interface select code This code is used by the computer to direct commands and communications to the proper interface The default is typically 7 for t...

Page 94: ...Setup from the Infiniium oscilloscope application s main menu as shown below The following C example program shows how to communicate with the oscilloscope using the LAN interface and the Agilent Sta...

Page 95: ...90000 Series Oscilloscopes Programmer s Reference 95 Clear the interface iclear Bus Query and print the oscilloscope s Id iwrite Bus IDN 5 1 actualcnt iread Bus buffer BUFFER_SIZE reason actualcnt bu...

Page 96: ...a Windows or Unix machine The sockets are located on port 5025 on your oscilloscope Between ports 5024 and 5025 only six socket ports can be opened simultaneously It is therefore important that you u...

Page 97: ..._SOCKET printf Error at socket ld n WSAGetLastError WSACleanup return NULL sockaddr_in clientService clientService sin_family AF_INET clientService sin addr s_addr inet_addr ipAddress clientService si...

Page 98: ...C commands clear the input buffer and output queue reset the parser and clear any pending commands If either of these commands is sent during a digitize operation the digitize operation is aborted Gro...

Page 99: ...ts Protocols and Common Commands This oscilloscope series is designed to be compatible with other Agilent Technologies IEEE 488 2 compatible instruments Oscilloscopes that are compatible with IEEE 488...

Page 100: ...rsing and executing commands Output Queue The output queue of the oscilloscope is the memory area where all output data or response messages are stored until read by the computer Parser The oscillosco...

Page 101: ...t After you send a query message the next message should be the response message The computer should always read the complete response message associated with a query message before sending another pr...

Page 102: ...d System Functions Suffix Unit The suffix units that the oscilloscope will accept are shown in Table 3 Table 2 suffix mult Value Mnemonic Value Mnemonic 1E18 EX 1E 3 M 1E15 PE 1E 6 U 1E12 T 1E 9 N 1E9...

Page 103: ...er 120 Trigger Armed Event Register 121 Auto Trigger Event Register 122 Error Queue 1008 Output Queue 124 Message Queue 125 Clearing Registers and Queues 126 An overview of the oscilloscope s status r...

Page 104: ...loscope defined structures and bits The status reporting structure consists of the registers shown here Table 4 lists the bit definitions for each bit in the status reporting data structure Figure 2 S...

Page 105: ...have occurred RQS Request Service Indicates that the device is requesting service MSS Master Summary Status Indicates if a device has a reason for requesting service ESB Event Status Bit Indicates if...

Page 106: ...e bits are enabled by using the ESE common command to set the corresponding bit in the Standard Event Status Enable Register To generate a service request SRQ interrupt to the computer you must enable...

Page 107: ...Status Reporting 6 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 107 Figure 4 Status Reporting Data Structures Continued...

Page 108: ...ry reads bit 6 as the Master Summary Status MSS and does not clear the bit or have any effect on the SRQ interrupt The value returned is the total bit weights of all of the bits that are set at the pr...

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

Page 110: ...are set are read with the SRE query Bit 6 always returns 0 Refer to the Status Reporting Data Structures shown in Figure 3 Example The following example sets bit 4 MAV and bit 5 ESB in the Service Re...

Page 111: ...register sets the MSG bit in the status byte register when an internally generated message is written to the advisory line on the oscilloscope The message is read using the SYSTEM DSP query Note that...

Page 112: ...rigger event register stays set until it is cleared by reading the register with the TER query or by using the CLS clear status command If your application needs to detect multiple triggers the trigge...

Page 113: ...n the Standard Event Status Enable Register a summary bit ESB in the Status Byte Register is set You can read the contents of the Standard Event Status Register and clear the register by sending the E...

Page 114: ...u can enable any of these bits to generate the summary bit by sending myScope WriteString ESE CStr CInt H3C Whenever an error occurs it sets one of these bits in the Standard Event Status Register Bec...

Page 115: ...ll math processes are done The WAIT TRIG bit is set by the Trigger Armed Event Register and indicates the trigger is armed The MASK bit is set whenever at least one of the Mask Test Event Register bit...

Page 116: ...n enable this bit to generate the summary bit by sending myScope WriteString OPEE CStr CInt H200 Whenever an error occurs the oscilloscope sets this bit in the Mask Test Event Register Because this bi...

Page 117: ...Test Fail bit is set whenever the mask test failed The Mask Low Amplitude bit is set whenever the signal is below the mask amplitude The Mask High Amplitude bit is set whenever the signal is above th...

Page 118: ...ope WriteString MTEE CStr CInt H2 Whenever an error occurs the oscilloscope sets the MASK bit in the Operation Status Register Because the bits in the Operation Status Enable Register are all enabled...

Page 119: ...nt Register ACQ DONE sets bit 0 ACQ DONE bit in the Operation Status Register when the oscilloscope acquisition is completed The ACQ DONE event register stays set until it is cleared by reading the re...

Page 120: ...s Reference 6 Status Reporting Process Done Event Register The Process Done Event Register PDER sets bit 1 PROC DONE of the Operation Status Register when all functions and all math operations are com...

Page 121: ...igger Armed Event Register TDER sets bit 5 WAIT TRIG in the Operation Status Register when the oscilloscope becomes armed The ARM event register stays set until it is cleared by reading the register w...

Page 122: ...ger Event Register AUTO TRIG sets bit 11 AUTO TRIG in the Operation Status Register when an auto trigger event occurs The AUTO TRIG register stays set until it is cleared by reading the register with...

Page 123: ...n for the Queue overflow message The error queue is read with the SYSTEM ERROR query Executing this query reads and removes the oldest error from the head of the queue which opens a position at the ta...

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

Page 125: ...5 Message Queue The message queue contains the text of the last message written to the advisory line on the screen of the oscilloscope The queue is read with the SYSTEM DSP query Note that messages se...

Page 126: ...WXV WH 5HJLVWHU 8VH WKH 6 FRPPRQ FRPPDQG WR HQDEOH WKH ELWV RX ZDQW WR JHQHUDWH WKH 546 066 ELW WR VHW ELW LQ WKH 6WDWXV WH 5HJLVWHU DQG VHQG 654 WR WKH FRPSXWHU I HYHQWV DUH PRQLWRUHG E WKH 6WDQGDUG...

Page 127: ...with SCPI commands it is often necessary to know when the oscilloscope has finished the previous operation and is ready for the next SCPI command The most common example is when an acquisition is star...

Page 128: ...Oscilloscopes Programmer s Reference 7 Remote Acquisition Synchronization Programming Flow Most remote programming follows these three general steps 1 Setup the oscilloscope and device under test 2 Ac...

Page 129: ...loscope Before making changes to the oscilloscope setup it is best to make sure it is stopped using the STOP command followed by the OPC command After the oscilloscope is configured it is ready for an...

Page 130: ...Blocking Wait Polling Wait Use When You know the oscilloscope will trigger based on the oscilloscope setup and device under test You know the oscilloscope may or may not trigger based on the oscillos...

Page 131: ...Acquisition Synchronization 7 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 131 Retrieving Results Once the acquisition is complete it is safe to retrieve measurements and stati...

Page 132: ...rocessing is complete Example Setup TRIGGER MODE EDGE TIMEBASE SCALE 5e 9 Acquire DIG Get results MEASURE RISETIME Polling Synchronization With Timeout This example requires a timeout value so the ope...

Page 133: ...Remote Acquisition Synchronization 7 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 133 MEASURE RISETIME...

Page 134: ...he DUT is enabled This example is the same as the previous example with the addition of checking for the armed event status Example TIMEOUT 1000ms currentTime 0ms Setup STOP OPC if not stopped ADER cl...

Page 135: ...Remote Acquisition Synchronization 7 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 135 MEASURE RISETIME...

Page 136: ...cannot be used The SINGle command does not average If it is known that a trigger will occur a DIG will acquire the complete number of averages but if the number of averages is large it may cause a tim...

Page 137: ...Command Tree 139 Infinity Representation 142 Sequential and Overlapped Commands 143 Response Generation 144 EOI 145 This chapter describes conventions used to program the Infiniium Series Oscilloscop...

Page 138: ...irst four characters of the keyword unless the fourth character is a vowel Then the mnemonic is the first three characters of the keyword If the length of the keyword is four characters or less this r...

Page 139: ...pendent of the tree and do not affect the position of the parser within the tree RST is an example of a common command Root level commands control many of the basic functions of the oscilloscope These...

Page 140: ...preceding it because the CHANNEL1 RANGE command sets the parser to the CHANNEL1 node in the tree Example 2 Consider the following commands myScope WriteString TIMEBASE REFERENCE CENTER POSITION 0 0000...

Page 141: ...000 Series Oscilloscopes Programmer s Reference 141 In this example the leading colon before CHANNEL1 tells the parser to go back to the root of the command tree The parser can then recognize the CHAN...

Page 142: ...Series Oscilloscopes Programmer s Reference 8 Programming Conventions Infinity Representation The representation for infinity for this oscilloscope is 9 99999E 37 This is also the value returned when...

Page 143: ...verlapped Commands IEEE 488 2 makes a distinction between sequential and overlapped commands Sequential commands finish their task before the execution of the next command starts Overlapped commands r...

Page 144: ...Response Generation As defined by IEEE 488 2 query responses may be buffered for these reasons When the query is parsed by the oscilloscope When the computer addresses the oscilloscope to talk so that...

Page 145: ...Programming Conventions 8 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 145 EOI The EOI bus control line follows the IEEE 488 2 standard without exception...

Page 146: ...146 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 8 Programming Conventions...

Page 147: ...re POINts AUTO 163 ACQuire POINts DIGital 164 ACQuire REDGe 165 ACQuire RESPonse 166 ACQuire SEGMented COUNt 167 ACQuire SEGMented INDex 168 ACQuire SEGMented TTAGs 169 ACQuire SRATe ANALog 170 ACQuir...

Page 148: ...ging is not available in PDETect mode The MTESt AVERage command performs the same function as this command Example This example turns averaging on myScope WriteString ACQUIRE AVERAGE ON Query ACQuire...

Page 149: ...a values must be averaged for each time bucket to be considered complete The number of time buckets that must be complete for the acquisition to be considered complete is specified by the ACQuire COMP...

Page 150: ...idth of the bandwidth filter whose range of values depends on the model number of your oscilloscope NOTE This command is only available with Enhanced Bandwidth or Noise Reduction options Model Bandwid...

Page 151: ...lent Infiniium 90000 Series Oscilloscopes Programmer s Reference 151 Query ACQuire BANDwidth The ACQuire BANDwidth query returns the bandwidth setting of the bandwidth control Returned Format ACQuire...

Page 152: ...lly has no effect and the behavior of the oscilloscope is the same as when the completion criteria is set to 100 this is the same as in PDETect mode When ACQuire AVERage is on all of the previous data...

Page 153: ...is example reads the completion criteria and places the result in the variable varPercent Then it prints the content of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF mySc...

Page 154: ...record as the result of any given trigger event You set the acquire mode of the oscilloscope by using the ACQuire MODE command ON Turns the COMPlete mode on Then you can specify the completion percen...

Page 155: ...bits of vertical resolution which can affect the sampling rate Example This example sets the bit resolution setting to a minimum of 11 bits myScope WriteString ACQuire HRESolution BITS11 Query ACQuir...

Page 156: ...n or off when the oscilloscope is in one of the real time sampling modes You can also specify the 1 2 4 8 or 16 point Sin x x interpolation ratios using INT1 INT2 INT4 INT8 or INT16 When ON the number...

Page 157: ...rmines the number of data points per data region From each data region four sample points are chosen to be displayed for each time column The four sample points chosen from each data region are the mi...

Page 158: ...Peak Detect Segmented mode SEGHres Enables High Resolution Segmented mode To set the desired bits of vertical resolution see ACQuire HRESolution on page 155 Example This example sets the acquisition m...

Page 159: ...channel depends on the oscilloscope settings of sampling mode sampling rate and trigger sweep The following tables show the range of memory values for the different memory options Table 6 1G Memory O...

Page 160: ...d sample rate Trigger Sweep Single Auto or Triggered Normal Peak Detect full sample rate and High Resolution Modes 16 to 205 000 000 Normal and High Resolution modes with averaging 16 to 2 050 000 Pea...

Page 161: ...l Peak Detect full sample rate and High Resolution modes 16 to 51 250 000 Normal and High Resolution modes with averaging 16 to 2 050 000 Peak Detect Mode at full sample rate 16 to 51 250 000 Equivale...

Page 162: ...rmat ACQuire POINts ANALog points_value NL Example This example checks the current setting for memory depth and places the result in the variable varLength Then the program prints the contents of the...

Page 163: ...ire POINts command Example This example sets the automatic memory depth control to off myScope WriteString ACQUIRE POINTS AUTO OFF Query ACQuire POINts AUTO The ACQuire POINts AUTO query returns the a...

Page 164: ...00 Series Oscilloscopes Programmer s Reference 9 Acquire Commands ACQuire POINts DIGital Query ACQuire POINts DIGital The ACQuire POINts DIGital query returns the current memory depth for the digital...

Page 165: ...ixed at 160 GSa s Real Time Normal is the only acquisition mode available Example This example enables the RealEdge channel inputs myScope WriteString ACQuire REDGe ON Query ACQuire REDGe The ACQuire...

Page 166: ...s the decrease in bandwidth Please consult the Flat Magnitude Magnitude Magnitude Filters topic in the help system for specific information regarding the decrease in bandwidth Example This example tur...

Page 167: ...rol to 1000 myScope WriteString ACQUIRE SEGMented COUNt 1000 Query ACQuire SEGMented COUNt The ACQuire SEGMented COUNT query returns the number of segments control value Returned Format ACQuire SEGMen...

Page 168: ...the index number of the segment that you want to display Example This example sets the segmented memory index number control to 1000 myScope WriteString ACQUIRE SEGMented INDex 1000 Query ACQuire SEG...

Page 169: ...ACQUIRE SEGMented TTAGs ON Query ACQuire SEGMented TTAGs The ACQuire SEGMented TTAGs query returns the segmented memory time tags control value Returned Format ACQuire SEGMented TTAGs 1 0 NL Example T...

Page 170: ...POINts ANALog If you assign a sample rate value with ACQuire SRATe ANALog or a points value using ACQuire POINts ANALog the following interactions will occur Manual means you are setting a non AUTO va...

Page 171: ...400 500 1k 2k 2 5k 4k 5k 10k 20k 25k 40k 50k 100k 200k 250k 400k 500k 1M 2M 2 5M 4M 5M 10M 20M 25M 40M 50M 100 M 125 M 200 M 250 M 400 M 500 M 1G 1 25 G 2G 2 50 G 4G 5G 10G 20G 40G Table 13 90604A 904...

Page 172: ...Manual Example This example changes the sampling rate to manual myScope WriteString ACQuire SRATe ANALog AUTO OFF Query ACQuire SRATe ANALog AUTO The ACQuire SRATe ANALog AUTO query returns the curre...

Page 173: ...e but the value is rounded to the next fastest sample rate Interaction between ACQuire SRATe D IGital and ACQuire POINts DIGital If you assign a sample rate value with ACQuire SRATe DIGital the digita...

Page 174: ...e to manual myScope WriteString ACQuire SRATe DIGital AUTO OFF Query ACQuire SRATe DIGital AUTO The ACQuire SRATe DIGital AUTO query returns the current digital channel acquisition sample rate Returne...

Page 175: ...6 BUS N BIT M 177 BUS N BITS 178 BUS N CLEar 179 BUS N CLOCk 180 BUS N CLOCk SLOPe 181 BUS N DISPlay 182 BUS N LABel 183 BUS N READout 184 NOTE The BUS B N TYPE command applies to oscilloscopes with t...

Page 176: ...eric HOTLink IIC INFiniband JTAG LIN MIPI MPHY PCI3 PCIexpress SAS SATA SPI UART USB2 USB3 XAUI N An integer 1 4 Example This example sets the serial bus waveform number one protocol type to FLEXray m...

Page 177: ...excluded from the definition The digital subsystem must be enabled for this command will work See ENABle command in the root subsystem M An integer 0 15 N An integer 1 4 Example This example includes...

Page 178: ...for this command will work See ENABle command in the root subsystem N An integer 1 4 channel_list The channel range is from 0 to 15 in the following format Example This example includes bits 1 2 4 5 6...

Page 179: ...Command BUS N CLEar The BUS N CLEar command excludes all of the digital channels from the selected bus definition N An integer 1 4 Example This example excludes all the digital channels from the bus 1...

Page 180: ...for decoding the bus values M An integer 0 15 N An integer 1 4 O An integer 1 4 Example This example sets the clock to channel 1 for bus 1 myScope WriteString ENABLE DIGITAL myScope WriteString BUS1...

Page 181: ...or decoding the bus values O An integer 1 4 Example This example sets the clock edge to falling for bus 1 myScope WriteString ENABLE DIGITAL myScope WriteString BUS1 CLOCk SLOPE FALLING Query BUS N CL...

Page 182: ...igital subsystem must be enabled before this command will work See the ENABle command in the root subsystem N An integer 1 4 Example This example enables the viewing of bus 1 myScope WriteString ENABL...

Page 183: ...uoted_string A series of 6 or less characters as a quoted ASCII string Example This example sets the bus 1 label to Data myScope WriteString BUS1 LABEL Data Query BUS N LABel The BUS N LABel query ret...

Page 184: ...anges the format of the numbers displayed in the bus waveform N An integer 1 4 Example This example sets the bus read out to decimal myScope WriteString BUS1 READOUT DECIMAL Query BUS N READout The BU...

Page 185: ...the calibration procedure and how the calibration subsystem is intended to be used Oscilloscope Calibration Oscilloscope calibration establishes calibration factors for the oscilloscope These factors...

Page 186: ...factors only if a probe calibration is performed If you do not perform a probe calibration but want to use an unidentified probe enter the attenuation factor in the Setup Channel Probes Configure Pro...

Page 187: ...umber from 2 4 V to 2 4 V dc ZERO a 450 mV DV level ONE a 150 mV DC level DPULse A double pulse signal SOSC The 100 MHz reference clock output HFOSC A high frequency oscillator output Example This exa...

Page 188: ...to the current time base position to shift the position of the channel s data in time Use this command to compensate for differences in the electrical lengths of input paths due to cabling and probes...

Page 189: ...hese are ten comma separated integers with 1 0 or 1 A 1 indicates pass a 0 indicates fail and a 1 indicates unused This matches the status in the Calibration dialog box in the Utilities menu Returned...

Page 190: ...190 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 11 Calibration Commands...

Page 191: ...HANnel N ISIM CONVolve 205 CHANnel N ISIM CORRection 206 CHANnel N ISIM DEConvolve 208 CHANnel N ISIM DELay 209 CHANnel N ISIM PEXTraction 210 CHANnel N ISIM SPAN 212 CHANnel N ISIM STATe 213 CHANnel...

Page 192: ...l subsystem commands control all vertical Y axis functions of the oscilloscope You may toggle the channel displays on and off with the root level commands VIEW and BLANk or with CHANnel DISPlay NOTE I...

Page 193: ...ns channel 1 common mode channel on channel 1 channel 3 myScope WriteString CHANnel1 COMMonmode ON Query CHANnel N COMMonmode The CHANnel N COMMonmode query returns whether the channel is in commonmod...

Page 194: ...urns channel 1 differential on channel 1 channel 3 myScope WriteString CHANNEL1 DIFFerential ON Query CHANnel N DIFFerential The CHANnel N DIFFerential query returns whether the channel is in differen...

Page 195: ...l to 10 s myScope WriteString CHANNEL1 DIFFerential SKEW 10E 6 Query CHANnel N DIFFerential SKEW The CHANnel N DIFFerential SKEW query returns the skew that is applied to the differential or common mo...

Page 196: ...nnel 1 display in the variable varDisplay then prints the contents of the variable to the computer s screen myScope WriteString SYSTem HEADer OFF myScope WriteString CHANNEL1 DISPLAY varDisplay myScop...

Page 197: ...DISPlay AUTO 1 0 NL Example This example places whether or not the channel 1 channel 3 differential channel display scale and offset is tracking the acquisition scale and offset in the variable varAut...

Page 198: ...lue NL Example This example places the displayed offset of channel 1 in the variable varOffset then prints the contents of the variable to the computer s screen myScope WriteString SYSTem HEADer OFF m...

Page 199: ...Format CHANnel N DISPlay RANGe range NL Example This example places the range of channel 1 in the variable varRange then prints the contents of the variable to the computer s screen myScope WriteStrin...

Page 200: ...ISPlay SCALe scale NL Example This example places the display scale of channel 1 in the variable varScale then prints the contents of the variable to the computer s screen myScope WriteString SYSTem H...

Page 201: ...eger 1 4 Example This example sets the channel 1 input to DC50 myScope WriteString CHANNEL1 INPut DC50 Query CHANnel N INPut The CHANnel N INPut query returns the selected channel input parameter and...

Page 202: ...rently selected function file name when 2 port or 4 port mode is enabled Returned Format CHANnel N ISIM APPLy file_name NL Example This example puts the current transfer function file name in the vari...

Page 203: ...nnel input s bandwidth limit cutoff frequency Returned Format CHANnel N ISIM BANDwidth parameter NL Example This example puts the current input for channel 1 in the string variable varBwLimit The prog...

Page 204: ...bandwidth limiting feature Returned Format CHANnel N ISIM BWLimit 1 0 NL Example This example puts the current InfiniiSim bandwidth limit state for channel 1 in the string variable varLimit The progra...

Page 205: ...meter file Example This example convolves the s parameter file example s2p with the waveform on channel 1 myScope WriteString CHANNEL1 ISIM CONVolve example s2p NOTE This CHANnel command only applies...

Page 206: ...a lower percentage Example This example sets the channel 1 InfiniiSim correction factor to 80 myScope WriteString CHANnel1 ISIM CORRection 80 Query CHANnel N ISIM CORRection The CHANnel N ISIM CORRec...

Page 207: ...nt Infiniium 90000 Series Oscilloscopes Programmer s Reference 207 myScope WriteString SYSTem HEADer OFF myScope WriteString CHANnel1 ISIM CORRection varIsimCorrection myScope ReadNumber Debug Print F...

Page 208: ...rameter file Example This example deconvolves the s parameter file example s2p with the waveform on channel 1 myScope WriteString CHANNEL1 ISIM DEConvolve example s2p NOTE This CHANnel command only ap...

Page 209: ...puts whether or not the transfer function delay is included in the resultant waveform for channel 1 in the string variable strDelay The program then prints the contents of the variable to the computer...

Page 210: ...e current InfiniiSim port extraction selection Returned Format CHANnel N ISIM PEXTraction P12 P32 P34 P14 DIFF COMM NL Example This example puts the current InfiniiSim port extraction selection for ch...

Page 211: ...Channel Commands 12 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 211 strMode myScope ReadString Debug Print strMode...

Page 212: ...ximum time span value in the variable varTspan The program then prints the contents of the variable to the computer s screen myScope WriteString SYSTem HEADer OFF myScope WriteString CHANNEL1 ISIM SPA...

Page 213: ...ple puts the current InfiniiSim state for channel 1 in the string variable strMode The program then prints the contents of the variable to the computer s screen myScope WriteString SYSTem HEADer OFF m...

Page 214: ...he CHANnel N LABel query returns the label of the specified channel Returned Format CHANnel N LABel string NL NOTE You can specify differential and or common mode channels using the following conventi...

Page 215: ...ave specified other units using the CHANnel N UNITs command or the CHANnel N PROBe EXTernal UNITs command Example This example sets the offset for channel 1 to 0 125 in the current measurement units m...

Page 216: ...attenuation units or from 80 dB to 60 dB for the DECibel attenuation units Example This example sets the probe attenuation factor for a 10 1 probe on channel 1 in ratio units myScope WriteString CHANN...

Page 217: ...cisionProbe or PrecisionCable AC response calibration for the probe on channel 1 myScope WriteString CHANNEL1 PROBE ACCAL PRECprobe Query CHANnel N PROBe ACCAL The CHANnel N PROBe ACCAL query returns...

Page 218: ...onnected to the channel you will get a settings conflict error N An integer 1 4 Example This example sets the probe attenuation for channel 1 to divide by 10 myScope WriteString CHANNEL1 PROBE ATTENUA...

Page 219: ...Be AUTozero command initiates the N2893A probe s auto degauss offset cal If the N2893A probe is not connected to the channel you will get a settings conflict error N An integer 1 4 Example This exampl...

Page 220: ...ROBe COUPling command sets the coupling to either AC or DC N An integer 1 4 Example This example sets the probe coupling for channel 1 to AC myScope WriteString CHANNEL1 PROBE COUPling AC Query CHANne...

Page 221: ...10 myScope WriteString CHANNEL1 PROBE EADAPTER DIV10 Query CHANnel N PROBe EADapter The CHANnel N PROBe EADapter query returns the current external adapter value for the specified channel Returned Fo...

Page 222: ...niium 90000 Series Oscilloscopes Programmer s Reference 12 Channel Commands Dim strAdapter As String Dimension variable myScope WriteString CHANNEL1 PROBE EADAPTER strAdapter myScope ReadString Debug...

Page 223: ...nal coupling adapter for channel 1 to ac myScope WriteString CHANNEL1 PROBE ECOUPLING AC Query CHANnel N PROBe ECOupling The CHANnel N PROBe ECoupling query returns the current external adapter coupli...

Page 224: ...ring CHANNEL1 PROBE EXTERNAL ON Query CHANnel N PROBe EXTernal The CHANnel N PROBe EXTernal query returns the current external probe mode for the specified channel Returned Format CHANnel N PROBe EXTe...

Page 225: ...4 gain_factor A real number from 0 001 to 10000 for the RATio gain units or from 60 dB to 80 dB for the DECibel gain units Example This example sets the probe external scaling gain factor for channel...

Page 226: ...s but can be in other measurement units such as amperes if you have specified other units using the CHANnel N PROBe EXTernal UNITs command Example This example sets the external offset for the probe o...

Page 227: ...eString CHANNEL1 PROBE EXTERNAL ON myScope WriteString CHANNEL1 PROBE EXTERNAL UNITS AMPERE Query CHANnel N PROBe EXTernal UNITs The CHANnel N PROBe EXTernal UNITs query returns the current external u...

Page 228: ...154A probe is not connected to the channel you will get a settings conflict error N An integer 1 4 Example This example sets the probe gain for channel 1 to times 10 myScope WriteString CHANNEL1 PROBE...

Page 229: ...he CHANnel N PROBe HEAD ADD command adds an entry to the list of probe heads N An integer 1 4 head A quoted string matching the probe head model such as N5381A E2678A etc label An optional quoted stri...

Page 230: ...DELete ALL The CHANnel N PROBe HEAD DELete ALL command deletes all the nodes in the list of probe heads except for one default probe head which remains after this command is executed N An integer 1 4...

Page 231: ...HEAD ADD N5444A 2 92 foo myScope WriteString CHANnel1 PROBe HEAD SELect 1 myScope WriteString CHANnel1 PROBe HEAD SELect foo Query CHANnel N PROBe HEAD SELect MODel LABel The CHANnel N PROBe HEAD SEL...

Page 232: ...ets the termination voltage for the N5444A probe head N An integer 1 4 voltage A real number for the internal termination voltage setting Example To set an internal termination voltage of 1 0 V myScop...

Page 233: ...integer 1 4 Returned Format CHANnel N PROBe ID probe_id probe_id A string of alphanumeric characters Some of the possible returned values are Example This example reports the probe type connected to...

Page 234: ...s not connected to the channel you will get a settings conflict error N An integer 1 4 Example This example sets the probe InfiniiMode for channel 1 to common mode myScope WriteString CHANNEL1 PROBE M...

Page 235: ...top applying correction BOOSt boost_dB Lets you specify a dB limit at which to stop applying correction Example This example specifies that for PrecisionProbe or PrecisionCable on channel 1 correction...

Page 236: ...The SMA probe heads can use two independent calibration files Example This example says to use the PrecisionProbe or PrecisionCable calibration named 2 8 2 for channel 1 myScope WriteString CHANNEL1 P...

Page 237: ...ple chooses PrecisionProbe calibration for the probe on channel 1 myScope WriteString CHANNEL1 PROBE PRECprobe MODE PROBe Query CHANnel N PROBe PRECprobe MODE The CHANnel N PROBe PRECprobe MODE query...

Page 238: ...e which corrects the probe as what would be there if the probe were not present and specifies a constant Zo 2 value in ohms as the system source impedance One drawback of defining the probe s response...

Page 239: ...90000 Series Oscilloscopes Programmer s Reference 239 See Also CHANnel N PROBe ACCAL on page 217 CHANnel N PROBe PRECprobe MODE on page 237 CHANnel N PROBe PRECprobe CALibration on page 236 CHANnel N...

Page 240: ...loscope s probe skew control to remove timing differences between probes or cables on different channels N An integer 1 4 skew_value A real number for the skew value in the range 1 ms to 1 ms Example...

Page 241: ...the CHANnel N PROBe EXTernal OFFset command changes the offset value of the probe amplifier When differential is selected the CHANnel N PROBe EXTernal OFFset command changes the offset value of the ch...

Page 242: ...4 range_value A real number for the full scale voltage of the specified channel number Example This example sets the full scale range for channel 1 to 500 mV myScope WriteString CHANNEL1 RANGE 500E 3...

Page 243: ...r division Example This example sets the scale value for channel 1 to 500 mV div myScope WriteString CHANNEL1 SCALE 500E 3 Query CHANnel N SCALe The CHANnel N SCALe query returns the current scale set...

Page 244: ...sets the units for channel 1 to amperes myScope WriteString CHANNEL1 UNITS AMPERE Query CHANnel N UNITs The CHANnel N UNITs query returns the current units setting for the specified channel Returned...

Page 245: ...e remote interface as separate program messages or within other program messages Receiving Common Commands Common commands can be received and processed by the oscilloscope whether they are sent over...

Page 246: ...ing bits in the enable register you can select the status information for use Refer to the chapter Status Reporting for a complete discussion of status NOTE Headers and Common Commands Headers are not...

Page 247: ...eference 247 CLS Clear Status Command CLS The CLS command clears all status and error registers Example This example clears the status data structures of the oscilloscope myScope WriteString CLS See A...

Page 248: ...gn is also returned representing a mask value for the bits enabled in the Standard Event Status Register as shown in Table 17 Example This example places the current contents of the Standard Event Sta...

Page 249: ...ith the current settings 3 8 DDE Device Dependent Error Indicates whether the device was unable to complete an operation for device dependent reasons 2 4 QYE Query Error Indicates if the protocol for...

Page 250: ...variable to the computer s screen myScope WriteString ESR varEvent myScope ReadNumber Debug Print FormatNumber varEvent 0 Table 18 lists each bit in the Event Status Register and the corresponding bit...

Page 251: ...x which is the same for all identical oscilloscopes The last five digits are the serial suffix which is assigned sequentially and is different for each oscilloscope Rev Specifies the software version...

Page 252: ...size is subject to change with different firmware revisions Example This Python and PyVISA example saves the LRN string to a file and then restores the oscilloscope setup from the file Using the LRN...

Page 253: ...iniium write RST n Set up oscilloscope by loading previously saved learn string sLearn f open learn stp rb sLearn f read f close Infiniium write s n sLearn check_instrument_errors print Learn string b...

Page 254: ...cilloscope s output queue when all pending selected device operations have finished Returned Format 1 NL Example This example places an ASCII character 1 in the oscilloscope s output queue when the AU...

Page 255: ...CAN SA1 DDR NL Table 19 Possible Installed Options and Descriptions Installed Option Description AP2 U7233A DDR1 Compliance B30 N5416A USB Compliance CAN N5402A CAN FlexRay Protocols CFL N8803A B Basi...

Page 256: ...ink Compliance MPI U7238A MIPI D PHY Compliance MPH U7249A MIPI M PHY Compliance MPP N8802A MIPI D PHY Protocol MYC N5467A User Defined App PCI N5393B PCI Express 1 0a Compliance PC2 N5393B PCI Expres...

Page 257: ...ade STP N8801A SATA SAS Protocol SVD N8812A SVID Protocol SWT N5414A B N5415B InfiniiScan TBL N6463A Thunderbolt Compliance U3P N5464A B USB 3 0 Protocol UDF N5430A User Def Fn UH2 Ultra HS2 SD Compli...

Page 258: ...le Register must be set to 128 decimal and the Service Request Enable Register must be set to 32 decimal This allows the Power On PON bit to set the SRQ line when the oscilloscope is ready to receive...

Page 259: ...sly in the specified register Registers 0 through 9 are general purpose registers and can be used by the RCL command register An integer 0 through 9 specifying the save recall register that contains t...

Page 260: ...he RST command performs a default setup which is the same as pressing the oscilloscope front panel default key Example This example resets the oscilloscope to a known state myScope WriteString RST NOT...

Page 261: ...V register The SAV command stores the current state of the oscilloscope in a save register register An integer 0 through 9 specifying the register used to save the current oscilloscope setup Example T...

Page 262: ...The SRE query returns the current contents of the Service Request Enable Register Returned Format mask NL mask An integer 0 to 255 representing a mask value for the bits enabled in the Service Request...

Page 263: ...ds 13 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 263 2 4 MSG Message 1 2 USR User Event Register 0 1 TRG Trigger Table 20 Service Request Enable Register Bits continued Bit We...

Page 264: ...se to a serial poll SPOLL Request Service RQS is reported on bit 6 of the status byte Otherwise the Master Summary Status bit MSS is reported on bit 6 MSS is the inclusive OR of the bitwise combinatio...

Page 265: ...has been displayed 1 message has been displayed 1 2 USR 0 no enabled user event conditions have occurred 1 an enabled user event condition has occurred 0 1 TRG 0 no trigger has occurred 1 a trigger o...

Page 266: ...ires data for the active waveform display if the trigger conditions are met according to the current settings Example This example starts the data acquisition for the active waveform display according...

Page 267: ...ample performs a self test on the oscilloscope and places the results in the numeric variable varResults The program then prints the results to the computer s screen myScope WriteString TST varResults...

Page 268: ...00 Series Oscilloscopes Programmer s Reference 13 Common Commands WAI Wait Command WAI The WAI command has no function in the oscilloscope but is parsed for compatibility with other instruments Exampl...

Page 269: ...ium 90000 Series Oscilloscopes Programmer s Reference 14 Digital Commands DIGital N DISPlay 270 DIGital N LABel 271 DIGital N SIZE 272 DIGital N THReshold 273 NOTE The DIGital commands only apply to t...

Page 270: ...view for the selected digital channel N An integer 0 15 Example This example turns on the display of bit 5 for the digital channels myScope WriteString DIGital5 DISPlay ON Query DIGital N DISPlay The...

Page 271: ...quoted_string A series of 16 or less characters as a quoted ASCII string Example This example sets the label for bit 7 to Clock myScope WriteString DIGital7 LABel Clock Query DIGital N LABel The DIGit...

Page 272: ...d before this command will work See ENABle command in the root subsystem N An integer 0 15 Example This example changes the size to medium for all displayed digital channels or buses myScope WriteStri...

Page 273: ...he voltage values for the predefined thresholds are CMOS50 2 5 V CMOS33 1 65 V CMOS25 1 25 V ECL 1 3 V PECL 3 7 V TTL 1 4 V DIFFerential 0 V N An integer 0 15 value A real number representing the volt...

Page 274: ...274 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 14 Digital Commands...

Page 275: ...ASurements 286 DISK SAVE PRECprobe 287 DISK SAVE SETup 288 DISK SAVE WAVeform 289 DISK SEGMented 291 The DISK subsystem commands perform the disk operations as defined in the File menu This allows sav...

Page 276: ...ry does not exist You can then view the error with the SYSTem ERRor NUMBer STRing query directory A character quoted ASCII string which can include the subdirectory designation You must separate the d...

Page 277: ...e on the disk An error is displayed on the oscilloscope screen if the requested file does not exist The default path is C Document and Settings All Users Shared Documents Infiniium Data source_file de...

Page 278: ...he disk An error is displayed on the oscilloscope screen if the requested file does not exist The default path is C Document and Settings All Users Shared Documents Infiniium Data file_name A characte...

Page 279: ...at DISK DIRectory n NL directory n The specifier that is returned before the directory listing indicating the number of lines in the listing directory The list of filenames and directories Each line i...

Page 280: ...p file SETUP0 SET using the command DISK LOAD C Document and Settings All Users Shared Documents Infiniium Setups SETUP0 SET Or you can use DISK CDIRectory to change the present working directory to C...

Page 281: ...f the requested subdirectory does not exist directory A quoted ASCII string which can include subdirectories You must separate the directory name and any subdirectories with a backslash Example 1 This...

Page 282: ...All Users Shared Documents Infiniium Data has not been changed by the DISK CDIRectory command the DISK PWD query will return an empty string Returned Format DISK PWD present_working_directory NL Exam...

Page 283: ...the selected file format If you do not include the format in the command the file is saved in the format shown in the Save Screen dialog box file_name A quoted ASCII string with a maximum of 254 char...

Page 284: ...J tab at the bottom of the oscilloscope screen along with the RJDJ histograms in a comma separated variables CSV file format The csv extension is supplied by the oscilloscope The default path is C Doc...

Page 285: ...window to a file in either a csv or txt format The default path is C Document and Settings All Users Shared Documents Infiniium Data source SERial N The default serial bus is the one currently display...

Page 286: ...hown in the measurements tab at the bottom of the oscilloscope screen in a comma separated variables CSV file format The csv extension is supplied by the oscilloscope The default path is C Document an...

Page 287: ...N4 The DISK SAVE PRECprobe command saves PrecisionProbe Cable data in a comma separated variables CSV file format The default path is C Document and Settings All Users Shared Documents Infiniium Data...

Page 288: ...e setup to a disk The file will have a set extension file_name A quoted ASCII string with a maximum of 254 characters including the entire path name if used The filename assumes the present working di...

Page 289: ...e has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization opt...

Page 290: ...Commands In the H5 format data is saved as floats In the H5INt format data is saved as integers header ON 1 OFF 0 Example This example saves the channel 1 waveform to FILE1 on the disk in the CSV for...

Page 291: ...re MODE must be set to the SEGMented mode and segments must be acquired Example This example sets the disk segmented memory store method to CURRent myScope WriteString DISK SEGMENTED CURRENT Query DIS...

Page 292: ...292 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 15 Disk Commands...

Page 293: ...ISPlay GRATicule 302 DISPlay GRATicule INTensity 303 DISPlay GRATicule NUMBer 304 DISPlay GRATicule SETGrat 305 DISPlay GRATicule SIZE 306 DISPlay LABel 307 DISPlay LINE 308 DISPlay PERSistence 309 DI...

Page 294: ...uilding the database The database is the size of the graticule area and varies in size Behind each pixel is a 53 bit counter Each counter is incremented each time a pixel is hit by data from a channel...

Page 295: ...ue Yellow maximum value White minimum value White maximum value Returned Format DISPlay CGRade LEVels color format NL color format intensity color min max is an integer value from 0 to 9 007 199 254 7...

Page 296: ...296 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 16 Display Commands See Also DISPlay CGRade on page 294 DISPlay CGRade SCHeme on page 297...

Page 297: ...the range of the counters in the database In the CLASsic color grade scheme the counters with the largest counts are displayed using a white pixel while the counters with the smallest counts are displ...

Page 298: ...rned Format DISPlay CGRade SCHeme CLASsic TEMP NL Example This example gets the specified color scheme and prints it on the computer screen Dim strCgradeScheme As String Dimension variable myScope Wri...

Page 299: ...0 Example This example sets the starting column for subsequent DISPlay STRing and DISPlay LINE commands to column 10 myScope WriteString DISPLAY COLUMN 10 Query DISPlay COLumn The DISPlay COLumn query...

Page 300: ...onsecutive waveform data points This is also known as linear interpolation DISPlay CONNect is forced to OFF when color grade DISPlay CGRade persistence is on Example This example turns on the connect...

Page 301: ...are BMP file type SCReen mode compression turned ON and inversion set to NORMal type The bitmap type BMP JPG GIF TIF PNG screen_mode The display setting SCReen GRATicule Selecting GRATicule displays a...

Page 302: ...rame that is separated into major and minor divisions myScope WriteString DISPlay GRATicule FRAMe Queries DISPlay GRATicule The DISPlay GRATicule query returns the type of graticule currently displaye...

Page 303: ...ensity _value A integer from 0 to 100 indicating the percentage of grid intensity Example This example sets the graticule intensity to 50 myScope WriteString DISPlay GRATicule INTensity 50 Queries DIS...

Page 304: ...riteString DISPlay GRATicule NUMBer 2 Queries DISPlay GRATicule NUMBer The DISPlay GRATicule NUMBer query returns the the number of viewing areas Returned Format DISPlay GRATicule NUMBer 1 2 4 8 16 NL...

Page 305: ...M4 MEM N where N is between 1 and 4 FN N where N is between 1 and 16 function HIST D M where M is between 0 and 15 on MSO models with 16 digital channels BUS Y where Y is between 1 and 4 on MSO models...

Page 306: ...ing DISPlay GRATicule SIZE EXTended Queries DISPlay GRATicule SIZE The DISPlay GRATicule SIZE query returns the graticule size Returned Format DISPlay GRATicule SIZE STANdard EXTended MAXimized MINimi...

Page 307: ...ABel command Example This example turns on the display of all labels myScope WriteString DISPLAY LABEL ON Query DISPlay LABel The DISPlay LABel query returns the current state of the labels Returned F...

Page 308: ...tring DISPLAY LINE Infiniium Test When using the C programming language quotation marks within a string are escaped using the backslash character as shown in the next example This example writes the m...

Page 309: ...at is you can specify how long acquisitions remain on the screen Example This example sets the persistence to infinite myScope WriteString DISPlay PERSistence INFinite Query DISPlay PERSistence The DI...

Page 310: ...g row for subsequent DISPlay STRing and DISPlay LINE commands The range of values is 9 to 23 Example This example sets the starting row for subsequent DISPlay STRing and DISPlay LINE commands to 10 my...

Page 311: ...lay element CGLevel5 Color Grade Level 5 waveform display element CGLevel6 Color Grade Level 6 waveform display element CGLevel7 Color Grade Level 7 waveform display element CHANnel1 Channel 1 wavefor...

Page 312: ...s A 0 luminosity is pure black Example This example sets the hue to 50 the saturation to 70 and the luminosity to 90 for the markers myScope WriteString DISPLAY SCOLOR MARKERS 50 70 90 Query DISPlay S...

Page 313: ...1 the far right Example For example a column of 0 5 will place the upper left of the status label at the center screen myScope WriteString DISPLAY STATus COL 0 5 Query DISPlay STATus COL The DISPlay...

Page 314: ...e far bottom Example For example a row and column of 0 5 will place the upper left of the status label at the center screen myScope WriteString DISPLAY STATus ROW 0 5 Query DISPlay STATus ROW The DISP...

Page 315: ...rting at the current row and column settings If the column limit is reached the excess text is discarded The DISPlay STRing command does not increment the row value but DISPlay LINE does string _argum...

Page 316: ...example sets the Status tab as the displayed one myScope WriteString DISPlay TAB STATus Query DISPlay TAB The DISPlay TAB query returns the tab that is currently displayed Returned Format DISPlay TAB...

Page 317: ...loscopes Programmer s Reference 317 DISPlay TEXT Command DISPlay TEXT BLANk The DISPlay TEXT command blanks the user text area of the screen Example This example blanks the user text area of the oscil...

Page 318: ...318 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 16 Display Commands...

Page 319: ...erence 333 FUNCtion F FFT RESolution 334 FUNCtion F FFT TDELay 335 FUNCtion F FFT WINDow 336 FUNCtion F FFTMagnitude 338 FUNCtion F FFTPhase 339 FUNCtion F HIGHpass 341 FUNCtion F HORizontal 342 FUNCt...

Page 320: ...zontal scaling and position values of the functions using the HORizontal RANge and HORizontal POSition queries in this subsystem If a channel is not on but is used as an operand that channel will acqu...

Page 321: ...common mode channel between these same channels DIFF2 refers to the differential signal between channels 2 and 4 and COMMonmode4 refers to the common mode channel between these same channels Waveform...

Page 322: ...els differential channels common mode channels waveform memories 1 4 functions 1 4 a constant jitter measurement trend and jitter spectrum If the function is applied to a constant the source returns t...

Page 323: ...ABSolute command takes the absolute value an operand operand CHANnel N FUNCtion F WMEMory N DIFF P COMMonmode P MTRend MSPectrum See the discussion of possible operands in the introduction to Chapter...

Page 324: ...lgebraic sum of the two operands F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion of poss...

Page 325: ...quadrature Q parts of the input signal and then performs a square root of the sum of the real and imaginary parts to get the demodulated amplitude envelope waveform F An integer 1 16 representing the...

Page 326: ...ages F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion of possible operands in the introdu...

Page 327: ...erands and divides by 2 point by point F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion o...

Page 328: ...ifting the function waveform in time F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n MTRend MSPectrum See the discussion of possible ope...

Page 329: ...r 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion of possible operands in the introduction to Chapter...

Page 330: ...e This example turns function 1 on myScope WriteString FUNCTION1 DISPLAY ON Query FUNCtion F DISPlay The FUNCtion F DISPlay query returns the displayed status of the specified function Returned Format...

Page 331: ...e second operand F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion of possible operands in...

Page 332: ...nd sets the center frequency for the FFT when FUNCtion F FFTMagnitude is defined for the selected function F An integer 1 16 representing the selected function center _frequency _value A real number f...

Page 333: ...point to DISPlay myScope WriteString FUNCTION1 FFT REFERENCE DISPLAY Query FUNCtion F FFT REFerence The FUNCtion F FFT REFerence query returns the currently selected reference point for the FFT phase...

Page 334: ...6 representing the selected function resolution _value Resolution frequency The FFT resolution is determined by the sample rate and memory depth settings The FFT resolution is calculated using the fol...

Page 335: ...FUNCtion1 FFT TDELay 1E 3 Query FUNCtion F FFT TDELay The FUNCtion F FFT TDELay query returns the time delay for the FFT phase function Returned Format FUNCtion F FFT TDELay time_delay NL Example This...

Page 336: ...NNing is useful for frequency resolution and general purpose use It is good for resolving two frequencies that are close together or for making frequency measurements FLATtop is best for making accura...

Page 337: ...nce 337 Example This example places the current state of the function 1 FFT window in the string variable strWND then prints the contents of the variable to the computer s screen Dim strWND As String...

Page 338: ...the digitized time record and transforms it to magnitude and phase components as a function of frequency F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNC...

Page 339: ...ord and transforms it into magnitude and phase components as a function of frequency F An integer 1 16 representing the selected function source CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n floa...

Page 340: ...he selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n MTRend MSPectrum See the discussion of possible operands in the introduction to Chapter 17 Function Commands starting on...

Page 341: ...t is the 3 dB bandwidth of the filter F An integer 1 16 representing the selected function source CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n MTRend MSPectrum See the discussion of possible ope...

Page 342: ...on RANGe F An integer 1 16 representing the selected function Query FUNCtion F HORizontal The FUNCtion F HORizontal query returns the current horizontal scaling mode of the specified function Returned...

Page 343: ...tically selects manual mode F An integer 1 16 representing the selected function position _value A real number for the position value in time in seconds from 10E15 to 10E15 Query FUNCtion F HORizontal...

Page 344: ...of screen in current X axis units usually seconds from 100E 15 to 100E15 Query FUNCtion F HORizontal RANGe The FUNCtion F HORizontal RANGe query returns the current time range setting of the specifie...

Page 345: ...al of the specified operand s waveform F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion o...

Page 346: ...d operand s waveform by multiplying by 1 F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion...

Page 347: ...u set is the 3 dB bandwidth of the filter F An integer 1 16 representing the selected function source CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n MTRend MSPectrum See the discussion of possible...

Page 348: ...this function It is useful for scaling channels another function or memories with the RANGe and OFFSet commands in this subsystem F An integer 1 16 representing the selected function operand CHANnel...

Page 349: ...cket for the defined operand s waveform F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion...

Page 350: ...istogram statistics using the MEASure HISTogram queries F An integer 1 16 representing the selected function Example This example sets up a histogram function of the first measurement myScope WriteStr...

Page 351: ...cket for the defined operand s waveform F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion...

Page 352: ...measurement threshold settings as the waveform progresses across the screen For every cycle a measurement is made and the value is displayed on the screen for the cycle If a measurement cannot be mad...

Page 353: ...the first operand by the second operand F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion...

Page 354: ...et value is limited to being within the vertical range that can be represented by the function data Example This example sets the offset voltage for function 1 to 2 mV myScope WriteString FUNCTION1 OF...

Page 355: ...om 100E15 to 100E15 Example This example sets the full scale range for function 1 to 400 mV myScope WriteString FUNCTION1 RANGE 400E 3 Query FUNCtion F RANGe The FUNCtion F RANGe query returns the cur...

Page 356: ...An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion of possible operands in the introduction t...

Page 357: ...SQRT command takes the square root of the operand operand CHANnel N DIFF P COMMonmode P FUNCtion F WMEMory N MTRend MSPectrum See the discussion of possible operands in the introduction to Chapter 17...

Page 358: ...SQUare command takes the square value of the operand operand CHANnel N DIFF P COMMonmode P FUNCtion F WMEMory N MTRend MSPectrum See the discussion of possible operands in the introduction to Chapter...

Page 359: ...e second operand from the first operand F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P FUNCtion F WMEMory n float_value MTRend MSPectrum See the discussion...

Page 360: ...ual to that of the first operand and you can adjust them with the RANGe and OFFSet commands in this subsystem F An integer 1 16 representing the selected function operand CHANnel n DIFF P COMMonmode P...

Page 361: ...n integer 1 16 representing the selected function Query FUNCtion F VERTical The FUNCtion F VERTical query returns the current vertical scaling mode of the specified function Returned Format FUNCtion F...

Page 362: ...elected Y axis units normally volts The offset value is limited only to being within the vertical range that can be represented by the function data Query FUNCtion F VERTical OFFset The FUNCtion F VER...

Page 363: ...elected function full_scale _range A real number for the full scale vertical range from 100E15 to 100E15 Query FUNCtion F VERTical RANGe The FUNCtion F VERTical RANGe query returns the current range s...

Page 364: ...364 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 17 Function Commands...

Page 365: ...18 Hardcopy Commands HARDcopy AREA 366 HARDcopy DPRinter 367 HARDcopy FACTors 368 HARDcopy IMAGe 369 HARDcopy PRINters 370 The HARDcopy subsystem commands set various parameters for printing the scree...

Page 366: ...entire screen is printed Example This example selects the graticule for printing myScope WriteString HARDCOPY AREA GRATICULE Query HARDcopy AREA The HARDcopy AREA query returns the current setting fo...

Page 367: ...the HARDcopy PRINters query myScope WriteString HARDCOPY DPRINTER 2 This example sets the default printer to the installed printer with the name HP Laser myScope WriteString HARDCOPY DPRINTER HP Lase...

Page 368: ...ure Printer dialog box Example This example turns on the setup factors myScope WriteString HARDCOPY FACTORS ON Query HARDcopy FACTors The HARDcopy FACTors query returns the current setup factors setti...

Page 369: ...This example sets the hard copy image output to normal myScope WriteString HARDCOPY IMAGE NORMAL Query HARDcopy IMAGe The HARDcopy IMAGe query returns the current image setting Returned Format HARDcop...

Page 370: ...The word DEFAULT appears next to the printer that is the currently selected default printer The printer_data return string has the following format printer_number printer_string DEFAULT Example This e...

Page 371: ...vertical histogram that measures the noise on a waveform Jitter is measured by sizing the histogram window to a narrow portion of voltage and observing a horizontal histogram that measures the jitter...

Page 372: ...ou can avoid overlapping data in the database caused by multiple waveforms Even if the display is set to show only the most recent acquisition the database keeps track of all pixel hits while the data...

Page 373: ...histogram can be used to measure voltage related information like noise Example This example defines a vertical histogram myScope WriteString HISTOGRAM AXIS VERTICAL Query HISTogram AXIS The HISTogram...

Page 374: ...Togram ON command will automatically set HISTOgram MODE to MEASurement Example This example sets the histogram mode to track the waveform myScope WriteString HISTOGRAM MODE WAVEFORM Query HISTogram MO...

Page 375: ...and from 1 0 to 10 0 for the vertical mode Example This example sets the histogram size to 3 5 myScope WriteString HISTOGRAM SCALE SIZE 3 5 Query HISTogram SCALe SIZE The HISTogram SCALe SIZE query re...

Page 376: ...ram WINDow DEFault The HISTogram WINDow DEFault command positions the histogram markers to a default location on the display Each marker will be positioned one division off the left right top and bott...

Page 377: ...integer 1 16 Example This example sets the histogram window s source to Channel 1 myScope WriteString HISTOGRAM WINDOW SOURCE CHANNEL1 Query HISTogram WINDow SOURce The HISTogram WINDow SOURce query...

Page 378: ...ram window source left_limit A real number that represents the left boundary of the histogram window Example This example sets the left limit position to 200 microseconds myScope WriteString HISTOGRAM...

Page 379: ...of the histogram window source right_limit A real number that represents the right boundary of the histogram window Example This example sets the Bx marker to 200 microseconds myScope WriteString HIS...

Page 380: ...f the histogram window source bottom_limit A real number that represents the bottom boundary of the histogram window Example This example sets the position of the Ay marker to 250 mV myScope WriteStri...

Page 381: ...of the histogram window source top_limit A real number that represents the top boundary of the histogram window Example This example sets the position of the By marker to 250 mV myScope WriteString HI...

Page 382: ...382 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 19 Histogram Commands...

Page 383: ...tonic HYSTeresis 391 ISCan NONMonotonic SOURce 392 ISCan RUNT HYSTeresis 393 ISCan RUNT LLEVel 394 ISCan RUNT SOURce 395 ISCan RUNT ULEVel 396 ISCan SERial PATTern 397 ISCan SERial SOURce 398 ISCan ZO...

Page 384: ...s the amount of time that the InfiniiScan trigger is delayed from the hardware trigger Example The following example causes the oscilloscope to delay by 1 ms myScope WriteString ISCAN DELay 1E 06 Quer...

Page 385: ...t by the ISCan MEASurement LIMit and ISCan MEASurement ULIMit commands OUTSide OUTside causes the oscilloscope to fail a test when the measurement results exceed the parameters set by the ISCan MEASur...

Page 386: ...LLIMIT 1 0 If for example you chose to measure volts peak peak and want the smallest acceptable signal swing to be one volt you could use the above command then set the measurement limit to trigger w...

Page 387: ...n the Measurements tab area of the screen Example The following example selects the first measurement as the source for the limit testing commands myScope WriteString ISCAN MEASUREMENT MEAS1 Query ISC...

Page 388: ...se you are measuring the maximum voltage of a signal with Vmax and that voltage should not exceed 500 mV You can use the above program and set the ISCan MEASurement FAIL OUTside command to specify tha...

Page 389: ...t Limit trigger mode NONMonotonic Sets the Non monotonic edge trigger mode RUNT Sets the Runt trigger mode SERial Sets the Serial trigger mode ZONE Sets the Zone Qualify trigger mode Example The follo...

Page 390: ...edge trigger to falling edges RISing Sets the edge used by the Non monotonic edge trigger to rising edges Example The following example selects the falling edge non monotonic trigger myScope WriteStr...

Page 391: ...e sets the hysteresis value used by the Non monotonic trigger mode to 10 mV myScope WriteString ISCAN NONMONOTONIC HYSTERESIS 1E 2 Query ISCan NONMonotonic HYSTersis The query returns the hysteresis v...

Page 392: ...mple sets the source used by the Non monotonic trigger mode to channel 1 myScope WriteString ISCAN NONMONOTONIC SOURCE CHANNEL1 Query ISCan NONMonotonic SOURce The query returns the source used by the...

Page 393: ...ng example sets the hysteresis value used by the Runt trigger mode to 10 mV myScope WriteString ISCAN RUNT HYSTERESIS 1E 2 Query ISCan RUNT HYSTersis The query returns the hysteresis value used by the...

Page 394: ...sets the lower level limit to 1 0 V myScope WriteString ISCAN RUNT LLEVel 1 0 Query ISCan RUNT LLEVel The query returns the lower level limit set by the command Returned Format ISCan RUNT LLEVel lowe...

Page 395: ...e following example sets the source used by the Runt trigger mode to channel 1 myScope WriteString ISCAN RUNT SOURCE CHANNEL1 Query ISCan RUNT SOURce The query returns the source used by the Runt trig...

Page 396: ...lue used by the Runt trigger mode to 500 mV myScope WriteString ISCAN RUNT ULEVEL 500E 3 Query ISCan RUNT ULEVel The query returns the current upper level value used by the Runt trigger Returned Forma...

Page 397: ...only be expressed in the binary format Example The following example sets the pattern used by the Serial trigger to 101100 myScope WriteString ISCAN SERIAL PATTERN 101100 Query ISCan SERial PATTern Th...

Page 398: ...ollowing example sets the source used by the Serial trigger mode to channel 1 myScope WriteString ISCAN SERIAL SOURCE CHANNEL1 Query ISCan SERial SOURce The query returns the source used by the Serial...

Page 399: ...can zones on the display Example The following example hides all InfiniiScan zones on the display myScope WriteString ISCAN ZONE HIDE ON Query ISCan ZONE HIDE The query returns the current zone hide s...

Page 400: ...The following example sets the source used by the zone qualify trigger to channel 1 myScope WriteString ISCAN ZONE SOURCE CHANNEL1 Query ISCan ZONE SOURce The query returns the source used by the zone...

Page 401: ...intersect mode the waveform cannot enter a zone region to qualify as a valid waveform N is an integer from 1 4 Example The following example sets the mode to intersect for zone 1 myScope WriteString I...

Page 402: ...f the center of the zone in seconds y_center is a real number defining the y coordinate of the center of the zone in volts Example The following example sets the size of zone 1 to be 500 ps wide and 0...

Page 403: ...e qualify trigger N is an integer from 1 4 Example The following example turns on zone 2 myScope WriteString ISCAN ZONE2 STATE ON Query ISCan ZONE N STATe The query returns the state value for a zone...

Page 404: ...404 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 20 InfiniiScan ISCan Commands...

Page 405: ...TESt RESults 409 LTESt TEST 410 LTESt ULIMit 411 The Limit Test commands and queries control the limit test features of the oscilloscope Limit testing automatically compares measurement results with p...

Page 406: ...ment results are within the parameters set by the LLTESt LIMit and LTESt ULIMit commands OUTSide FAIL OUTside causes the oscilloscope to fail a test when the measurement results exceed the parameters...

Page 407: ...e WriteString LTEST LLIMIT 1 0 If for example you chose to measure volts peak peak and want the smallest acceptable signal swing to be one volt you could use the above command then set the limit test...

Page 408: ...are numbered from left to right Example The following example selects the first measurement as the source for the limit testing commands myScope WriteString LTEST MEASUREMENT MEAS1 Query LTESt MEASure...

Page 409: ...ts fail_min fail_max num_meas NL fail_min A real number representing the total number of measurements that have failed the minimum limit fail_max A real number representing the total number of measure...

Page 410: ...xample The following example turns off the limit test function myScope WriteString LTEST TEST OFF Query LTESt TEST The query returns the state of the TEST control Returned Format LTESt TEST 1 0 NL Exa...

Page 411: ...g LTEST ULIMIT 500E 3 Suppose you are measuring the maximum voltage of a signal with Vmax and that voltage should not exceed 500 mV You can use the above program and set the LTESt FAIL OUTside command...

Page 412: ...412 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 21 Limit Test Commands...

Page 413: ...m 90000 Series Oscilloscopes Programmer s Reference 22 Lister Commands LISTer DATA 414 LISTer DISPlay 415 The LISTer subsystem is used to turn on off the serial decode Lister display and return data f...

Page 414: ...erence 22 Lister Commands LISTer DATA Query LISTer DATA SBUS1 SBUS2 SBUS3 SBUS4 The LISTer DATA query returns the lister data Returned Format binary block NL binary_block comma separated data with new...

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

Page 416: ...416 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 22 Lister Commands...

Page 417: ...kers volts amps and watts for the Y axis You typically set the Y axis measurement units using the CHANnel UNITs command NOTE Guidelines for Using Queries in Marker Modes In Track Waveforms mode use MA...

Page 418: ...nit marker 1 to the string variable strPosition The program then prints the contents of the variable to the computer s screen Dim strPosition As String Dimension variable myScope WriteString MARKER CU...

Page 419: ...th measurement myScope WriteString MARKER MEASurement MEASurement MEASurement4 Query MARKer MEASurement MEASurement The MARKer MEASurement MEASurement query returns the currently specified measurement...

Page 420: ...measurement FFTPeak Tracks the current FFT peak that has been navigated to Example This example sets the marker mode to waveform myScope WriteString MARKer MODE WAVeform Query MARKer MODE The MARKer M...

Page 421: ...ple sets the Ax marker to 90 ns myScope WriteString MARKER X1POSITION 90E 9 Query MARKer X1Position The MARKer X1Position query returns the time at the Ax marker position Returned Format MARKer X1Posi...

Page 422: ...le This example sets the Bx marker to 90 ns myScope WriteString MARKER X2POSITION 90E 9 Query MARKer X2Position The MARKer X2Position query returns the time at Bx marker in seconds Returned Format MAR...

Page 423: ...Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 BUS N is an integer 1 4 Buses are a...

Page 424: ...Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 BUS N is an integer 1 4 Buses are a...

Page 425: ...Returned Format MARKer XDELta time NL time Time difference between Ax and Bx time markers in seconds Example This example returns the current time between the Ax and Bx time markers to the numeric va...

Page 426: ...arker to 10 mV myScope WriteString MARKER Y1POSITION 10E 3 Query MARKer Y1Position The MARKer Y1Position query returns the current measurement unit level at the Ay marker position Returned Format MARK...

Page 427: ...rker to 100 mV myScope WriteString MARKER Y2POSITION 100E 3 Query MARKer Y2Position The MARKer Y2Position query returns the current measurement unit level at the By marker position Returned Format MAR...

Page 428: ...By value at Ay Returned Format MARKer YDELta value NL value Measurement unit difference between Ay and By Example This example returns the voltage difference between Ay and By to the numeric variable...

Page 429: ...ESt AVERage COUNt 442 MTESt COUNt FAILures 443 MTESt COUNt FUI 444 MTESt COUNt FWAVeforms 445 MTESt COUNt UI 446 MTESt COUNt WAVeforms 447 MTESt DELete 448 MTESt ENABle 449 MTESt FOLDing 450 MTESt FOL...

Page 430: ...TRIGger SOURce 472 The MTESt subsystem commands and queries control the mask test features Mask Testing automatically compares measurement results with the boundaries of a set of polygons that you def...

Page 431: ...mand automatically aligns and scales the mask to the current waveform on the display The type of mask alignment performed depends on the current setting of the Use File Setup When Aligning control See...

Page 432: ...umn indicates that the control can be adjusted Example This example specifies the alignment type to be EYEAMI myScope WriteString MTEST ALIGNFIT EYEAMI Query MTESt AlignFIT The MTEST AlignFIT query re...

Page 433: ...ommands 24 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 433 Returned Format MTESt AlignFIT EYEAMI EYECMI EYENRZ FANWidth FAPeriod FAPWidth FYNWidth FYPWidth NONE NWIDth PWIDth T...

Page 434: ...defined by the AMASk XDELta AMASk YDELta and 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 dis...

Page 435: ...that UNITs are CURRent and that you set SOURce to CHANNEL1 which is using units of volts Then you can define AMASk XDELta in terms of volts and AMASk YDELta in terms of seconds N An integer 1 4 Exampl...

Page 436: ...a maximum of 254 characters long including the path name if used The filename assumes the present working directory if a path does not precede the file name The default save path is C Documents and S...

Page 437: ...specified as parts of a screen division The mask test subsystem maintains separate XDELta and YDELta settings for CURRent and DIVisions Thus XDELta and YDELta are not converted to new values when the...

Page 438: ...t the tolerance to 250 millidivisions or 1 4 of a division Example This example sets the units to divisions and sets the X tolerance to one eighth of a division myScope WriteString MTEST AMASK UNITS D...

Page 439: ...k UNITs is DIVisions the same ydelta_value will set the tolerance to 250 millidivisions or 1 4 of a division Example This example sets the units to current and sets the Y tolerance to 30 mV assuming t...

Page 440: ...is alignment guarantees that the aligned mask and any subsequent mask tests meet the requirements of the standard When disabled the alignment is performed using the current oscilloscope settings This...

Page 441: ...ACQuire AVERage command performs the same function as this command Averaging is not available in PDETect mode Example This example turns averaging on myScope WriteString MTEST AVERAGE ON Query MTESt...

Page 442: ...6 data values must be averaged for each time bucket to be considered complete The number of time buckets that must be complete for the acquisition to be considered complete is specified by the MTESt C...

Page 443: ...region number that is unused number An integer 1 through 8 designating the region for which you want to determine the failure count Returned Format MTESt COUNt FAILures REGion number number_of_failure...

Page 444: ...nterval failures that have occurred Returned Format MTESt COUNt FUI unit_interval_failures NL unit_interval_fa ilures The number of unit interval failures Example This example determines the current n...

Page 445: ...e true Mask testing was turned on before the histogram or color grade persistence and No mask changes have occurred including scaling changes editing or new masks The value 9 999E37 is returned if mas...

Page 446: ...that have been mask tested Returned Format MTESt COUNt UI unit_intervals_tested NL unit_intervals_t ested The number of unit intervals tested Example This example determines the current number of uni...

Page 447: ...returned if mask testing is not enabled Returned Format MTESt COUNt WAVeforms number_of_waveforms NL number_of_ waveforms The total number of waveforms for the current test run Example This example d...

Page 448: ...scilloscopes Programmer s Reference 24 Mask Test Commands MTESt DELete Command MTESt DELete The MTESt DELete command clears the currently loaded mask Example This example clears the currently loaded m...

Page 449: ...example enables the mask test features myScope WriteString MTEST ENABLE ON Query MTESt ENABle The MTESt ENABle query returns the current state of mask test features Returned Format MTESt ENABle 1 0 N...

Page 450: ...the real time eye myScope WriteString MTEST FOLDING ON Query MTESt FOLDing The MTESt FOLDing query returns the current state of clock recovery folding Returned Format MTESt FOLDing 1 0 NL Example myS...

Page 451: ...it types pattern An eight character string 8 of 1 0 or X For example 101XX010 cursor A value from 0 to 7 representing which bit is bit 0 from the LSB Example This example sets bit type to transition b...

Page 452: ...eft and right of the eye at the threshold hysteresis level Top and bottom of the eye at the center For each bit that represents the worst case at one of the evaluated points the 1 000 bits that surrou...

Page 453: ...volts of a pulse as allowed by the pulse standard Example This example sets the maximum pulse amplitude to 3 6 volts myScope WriteString MTEST HAMPLITUDE 3 6 Query MTESt HAMPlitude The MTESt HAMPlitud...

Page 454: ...ion of a mask file NONE Disables the probe impedance check IMP75 Enables the probe impedance check for the E2622A probe IMP100 Enables the probe impedance check for the E2621A probe with the switch se...

Page 455: ...negative going pulses The trigger level and mask offset are also adjusted Not all masks support negative going pulse testing and for these masks the command is ignored Example This example inverts th...

Page 456: ...volts of a pulse as allowed by the pulse standard Example This example sets the minimum pulse amplitude to 2 4 volts myScope WriteString MTEST LAMPLITUDE 2 4 Query MTESt LAMPlitude The MTESt LAMPlitud...

Page 457: ...es is C Documents and Settings All Users Documents Infiniium MASKS To use a different path specify the complete path and file name filename An MS DOS compatible name of the file a maximum of 254 chara...

Page 458: ...t NREGions query returns the number of regions that define the mask Returned Format MTESt NREGions regions NL regions An integer from 0 to 8 Example This example returns the number of mask regions myS...

Page 459: ...ing for the E2621A and E2622A probes for the current mask test channel Returned Format MTESt PROBe IMPedance impedance NL impedance An unquoted string 75 100 110 120 or NONE Example This example retur...

Page 460: ...number of failures TIME TIME sets the amount of time in minutes that a mask test will run before it terminates time A real number 0 1 to 1440 0 WAVeforms WAVeforms sets the maximum number of waveform...

Page 461: ...he Stop On Failure run until criteria When a mask test is run and a mask violation is detected the mask test is stopped and the acquisition system is stopped Example This example enables the Stop On F...

Page 462: ...sabled adjusting either the 1 Level or the 0 Level control changes the vertical height of the mask If the Bind 1 0 Levels control is enabled the 1 Level and the 0 Level controls track each other Adjus...

Page 463: ...simplifies reprogramming to handle different data rates For example if you halve the period of the waveform of interest you need only to adjust the XDELta value to set up the mask for the new waveform...

Page 464: ...rate without corresponding changes in the waveform can easily be handled by changing X The X coordinate of polygon vertices is normalized using this equation xdelta_value A time value specifying the...

Page 465: ...1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV y1_value A voltage value specifying the point at which Y 0 Example This example sets the Y1 marker to 150 mV myScope WriteString M...

Page 466: ...ou set Y1 to 100 mV and Y2 to 1 V a Y value of 0 100 in a vertex is at 190 mV y2_value A voltage value specifying the location of the Y2 marker Example This example sets the Y2 marker to 2 5 V myScope...

Page 467: ...re enabled This command uses the Feed Forward Equalized FFE signal as the source N An integer 1 4 F An integer 1 16 Example This example selects channel 1 as the mask test source myScope WriteString M...

Page 468: ...e 24 Mask Test Commands MTESt STARt Command MTESt STARt The MTESt STARt command starts the mask test The MTESt STARt command also starts the oscilloscope acquisition system Example This example starts...

Page 469: ...ies Oscilloscopes Programmer s Reference 469 MTESt STOP Command MTESt STOP The MTESt STOP command stops the mask test The MTESt STOP command does not stop the acquisition system Example This example s...

Page 470: ...t failure timeout An integer from 1 to 120 seconds representing the time between triggers not the time that it takes to finish the alignment Example This example sets the timeout value for the Autoali...

Page 471: ...is displayed in the mask test dialog box and mask test tab when a mask file is loaded Returned Format MTESt TITLe mask_title NL mask_title A string of up to 23 ASCII characters which is the mask title...

Page 472: ...n integer 1 4 Example This example sets the mask trigger source to channel 1 myScope WriteString MTEST TRIGGER SOURCE CHANNEL1 Query MTESt TRIGger SOURce The query returns the currently selected mask...

Page 473: ...de QFACtor 493 MEASure CLEar 494 MEASure CLOCk 495 MEASure CLOCk METHod 496 MEASure CLOCk METHod ALIGn 498 MEASure CLOCk METHod DEEMphasis 499 MEASure CLOCk METHod EDGE 500 MEASure CLOCk METHod JTF 50...

Page 474: ...HISTogram MIN 551 MEASure HISTogram MODE 552 MEASure HISTogram PEAK 553 MEASure HISTogram PP 554 MEASure HISTogram RESolution 555 MEASure HISTogram STDDev 556 MEASure HOLDtime 557 MEASure JITTer HISTo...

Page 475: ...587 MEASure NOISe SCOPe RN 588 MEASure NOISe STATe 589 MEASure NOISe UNITs 590 MEASure NPERiod 591 MEASure NPULses 592 MEASure NUI 593 MEASure NWIDth 594 MEASure OVERshoot 596 MEASure PAMPlitude 598 M...

Page 476: ...re SLEWrate 641 MEASure SOURce 642 MEASure STATistics 643 MEASure TEDGe 644 MEASure THResholds ABSolute 646 MEASure THResholds HYSTeresis 648 MEASure THResholds METHod 650 MEASure THResholds PERCent 6...

Page 477: ...tware commands The following MEASure commands are available when the E2688A High Speed Serial Software is installed MEASure CLOCk on page 495 MEASure CLOCk METHod on page 496 MEASure CLOCk METHod ALIG...

Page 478: ...TATistics on page 570 MEASure JITTer TRENd on page 571 MEASure NCJitter on page 578 MEASure NPERiod on page 591 MEASure NUI on page 593 MEASure SETuptime on page 639 MEASure TIEClock2 on page 656 MEAS...

Page 479: ...RJDJ CLOCk on page 624 MEASure RJDJ EDGE on page 625 MEASure RJDJ INTerpolate on page 626 MEASure RJDJ PLENgth on page 629 MEASure RJDJ SOURce on page 633 MEASure RJDJ STATe on page 634 MEASure RJDJ...

Page 480: ...of the defined measurements are requested the oscilloscope first determines the top 100 and base 0 voltages of the waveform From this information the oscilloscope determines the other important volta...

Page 481: ...measurements on a particular cycle display only that cycle on the screen Measurements are made on the displayed waveforms specified by the SOURce command The SOURce command lets you specify two sourc...

Page 482: ...N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example turns on the area measurement which measures between the waveform and ground Only that p...

Page 483: ...s the minimum time between bursts source CHANnel N FUNCtion F WMEMory N N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 idle time Minimum amount of idle time...

Page 484: ...is the minimum time between bursts source CHANnel N FUNCtion F WMEMory N N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 idle time Minimum amount of idle tim...

Page 485: ...ial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N An integer 1 4 F An integer 1 16 idle_...

Page 486: ...tion installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the features...

Page 487: ...de CROSsing query returns the crossing level percent measurement of the current eye diagram on the color grade display Before using this command or query you must use the DISPlay CGRade command to ena...

Page 488: ...ISTORTION TIME Query MEASure CGRade DCDistortion format The MEASure CGRade DCDistortion query returns the duty cycle distortion measurement of the color grade display Before using this command or quer...

Page 489: ...on the mean and standard deviation of the eye top and base Example This example enables the eye height measurement myScope WriteString MEASURE CGRADE EHEIGHT Query MEASure CGRade EHEight The MEASure C...

Page 490: ...h based upon the mean and standard deviation of the crossings Example This example measures the eye width myScope WriteString MEASURE CGRADE EWIDTH Query MEASure CGRade EWIDth The MEASure CGRade EWIDt...

Page 491: ...making measurements Default value is 1 Example This example sets the eye window starting point to 2 the stopping point to 75 and the start after to 5 000 hits myScope WriteString SYSTEM HEADER OFF Res...

Page 492: ...at The MEASure CGRade JITTer query returns the jitter measurement of the color grade display Before using this command or query you must use the DISPlay CGRade command to enable the color grade persis...

Page 493: ...de QFACtor query returns the Q factor measurement of the color grade display Before using this command or query you must use the DISPlay CGRade command to enable the color grade persistence feature Re...

Page 494: ...ommands MEASure CLEar Command MEASure CLEar SCRatch The MEASure CLEar command clears the measurement results from the screen and disables all previously enabled measurements Example This example clear...

Page 495: ...k The MEASure CLOCk query returns the state of the recovered clock display Returned Format MEASure CLOCk 1 0 NL Example This example places the current setting of the recovered clock display in the va...

Page 496: ...er Transfer Function OJTF see MEASure CLOCk METHod OJTF on page 504 For setting phase locked loop PLL clock recovery methods in terms of the Jitter Transfer Function JTF see MEASure CLOCk METHod JTF o...

Page 497: ...FLEXR baud_rate FLEXT baud_rate Example This example places the current setting of the clock recovery method in the variable strSetting then prints the contents of the variable to the computer s scree...

Page 498: ...s are aligned with the center of data myScope WriteString MEASURE CLOCK METHOD ALIGn CENTer Query MEASure CLOCK METHod ALIGn The MEASure CLOCk METHod ALIGn query returns the clock recovery method s ed...

Page 499: ...Sure CLOCk METHod DEEMphasis query returns whether or not de emphasis is turned on Returned Format MEASure CLOCk METHod DEEMphasis OFF ON Example This example places the current setting of the de emph...

Page 500: ...QSOPLL Equalized Second Order PLL To measure jitter on only rising or falling edges of a clock you must also set MEASure RJDJ EDGE to the same RISing or FALLing option and you must set MEASure RJDJ CL...

Page 501: ...er OFF myScope WriteString MEASure CLOCk METHod EDGE strSetting myScope ReadString Debug Print strSetting See Also MEASure CLOCk METHod on page 496 MEASure CLOCk METHod OJTF on page 504 MEASure CLOCk...

Page 502: ...L Second Order PLL EQFOPLL Equalized First Order PLL EQSOPLL Equalized Second Order PLL EXPFOPLL Explicit First Order PLL EXPSOPLL Explicit Second Order PLL The EQUalized clock recovery methods are on...

Page 503: ...MEASure CLOCk METHod JTF query returns the state of the clock recovery method Returned Format MEASure CLOCk METHod JTF FOPLL data_rate jtf_loop_bandwidth EQFOPLL data_rate jtf_loop_bandwidth SOPLL dat...

Page 504: ...OPLL First Order PLL SOPLL Second Order PLL EQFOPLL Equalized First Order PLL EQSOPLL Equalized Second Order PLL EXPFOPLL Explicit First Order PLL EXPSOPLL Explicit Second Order PLL The EQUalized cloc...

Page 505: ...MEASure CLOCk METHod OJTF query returns the state of the clock recovery method Returned Format MEASure CLOCk METHod OJTF FOPLL data_rate ojtf_loop_bandwidth EQFOPLL data_rate ojtf_loop_bandwidth SOPL...

Page 506: ...RE CLOCk VERTical AUTO Query MEASure CLOCk VERTical The MEASure CLOCk VERTical query returns the current recovered clock vertical scale mode setting Returned Format MEASure CLOCk VERTical AUTO MANual...

Page 507: ...query returns the clock recovery vertical offset setting Returned Format MEASure CLOCk VERTical OFFSet value NL value The clock recovery vertical offset setting Example This example places the current...

Page 508: ...VERTical RANGe query returns the recovered clock vertical range setting Returned Format MEASure CLOCk VERTical RANGe value NL value The recovered clock vertical range setting Example This example pla...

Page 509: ...riteString MEASure CROSsing CHANnel1 CHANnel2 Query MEASure CROSsing source1 source2 The MEASure CROSsing query returns the crossing measurement value If the source parameters are not specified the tw...

Page 510: ...s are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 direction RISing FALLing S...

Page 511: ...he cycle to cycle duty cycle of channel 1 in the numeric variable varValue then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response headers off...

Page 512: ...tures are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 direction RISing FALLi...

Page 513: ...es the cycle to cycle jitter of channel 1 in the numeric variable varValue then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response headers off...

Page 514: ...mand uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example measures the cycle to cycle...

Page 515: ...iniium 90000 Series Oscilloscopes Programmer s Reference 515 myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE CTCNWIDTH CHANNEL1 varValue myScope ReadNumber Debug...

Page 516: ...mand uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example measures the cycle to cycle...

Page 517: ...iniium 90000 Series Oscilloscopes Programmer s Reference 517 myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE CTCPWIDTH CHANNEL1 varValue myScope ReadNumber Debug...

Page 518: ...gh Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1...

Page 519: ...s the current data rate of the channel 1 waveform in the numeric variable varValue then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response head...

Page 520: ...e if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial D...

Page 521: ...lt_state If SENDvalid is ON the result state is returned with the measurement result See the MEASure RESults table in this chapter for a list of the result states Example This example places the curre...

Page 522: ...displayed source CHANnel N FUNCtion F DIGital M WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sources are only available if the oscilloscope has the EZJIT option installed and the f...

Page 523: ...sult states Example This example places the current value of delta time in the numeric variable varValue then prints the contents of the variable to the computer s screen This example assumes the sour...

Page 524: ...e This example sets the delta time starting edge to a rising edge on the 5th edge at the middle position and the stopping edge to falling on the 50th edge at the lower position myScope WriteString SYS...

Page 525: ...t Infiniium 90000 Series Oscilloscopes Programmer s Reference 525 NOTE Turn Off Headers When receiving numeric data into numeric variables turn off the headers Otherwise the headers may cause misinter...

Page 526: ...ption and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an...

Page 527: ...result See the MEASure RESults table in this chapter for a list of the result states Example This example places the current duty cycle of the channel 1 waveform in the numeric variable varValue then...

Page 528: ...ption and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an...

Page 529: ...the MEASure RESults table in this chapter for a list of the result states Example This example places the current duty cycle of the channel 1 waveform in the numeric variable varValue then prints the...

Page 530: ...9 99999E 37 if the necessary edges are not displayed source CHANnel N FUNCtion F WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sources are only available if the oscilloscope has the...

Page 531: ...scope has the EZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUaliz...

Page 532: ...le places the current value for fall time in the numeric variable varValue then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response headers off...

Page 533: ...Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Quer...

Page 534: ...Programmer s Reference 25 Measure Commands myScope WriteString meas FFT dfr func4 Perform dfrequency meas myScope WriteString meas FFT dfr func4 Query for measurement varFrequency myScope ReadNumber...

Page 535: ...Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Query ME...

Page 536: ...Programmer s Reference 25 Measure Commands myScope WriteString meas FFT dmag func4 Perform magnitude meas myScope WriteString meas FFT dmag func4 Query for measurement varMagnitude myScope ReadNumber...

Page 537: ...n installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Query MEASure FFT FREQuency...

Page 538: ...n installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Query MEASure FFT MAGNitude...

Page 539: ...ified with the MEASure SOURce command as FUNCtion F or WMEMory N 1st_peak _number An integer 1 to 100 specifying the number of the first peak N WMEMory N is an integer 1 4 F FUNCtion F is an integer 1...

Page 540: ...ified with the MEASure SOURce command as FUNCtion F or WMEMory N 2nd_peak _number An integer 1 to 100 specifying the number of the second peak N WMEMory N is an integer 1 4 F FUNCtion F is an integer...

Page 541: ...eshold The MEASure FFT THReshold query returns the peak search threshold value Returned Format MEASure FFT THReshold threshold_value NL These MEASure commands also operate on FFT functions See Also Al...

Page 542: ...IT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only...

Page 543: ...n the screen using the mid threshold levels of the waveform result_state If SENDvalid is ON the result state is returned with the measurement result See the MEASure RESults table in this chapter for a...

Page 544: ...number of hits within the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram HITS WMEMory1 Query MEASure HISTogram HITS source The MEASure HISTogram HITS query returns the number of h...

Page 545: ...data stored in waveform memory 3 myScope WriteString MEASure HISTogram M1S WMEMory3 Query MEASure HISTogram M1S source The MEASure HISTogram M1S query returns the measurement of the percentage of poi...

Page 546: ...specified using the MEASure SOURce command myScope WriteString MEASure HISTogram M2S WMEMory1 Query MEASure HISTogram M2S source The MEASure HISTogram M2S query returns the measurement of the percenta...

Page 547: ...histogram myScope WriteString MEASure HISTogram M3S HISTogram Query MEASure HISTogram M3S source The MEASure HISTogram M3S query returns the measurement of the percentage of points within three stand...

Page 548: ...s tab the maximum value of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram MAX WMEMory1 Query MEASure HISTogram MAX source The MEASure HISTogram MAX query returns the measuremen...

Page 549: ...urements tab the mean of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram MEAN WMEMory1 Query MEASure HISTogram MEAN source The MEASure HISTogram MEAN query returns the measureme...

Page 550: ...ents tab the median of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram MEDian WMEMory1 Query MEASure HISTogram MEDian source The MEASure HISTogram MEDian query returns the measu...

Page 551: ...nts tab the minimum the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram MIN WMEMory1 Query MEASure HISTogram MIN source The MEASure HISTogram MIN query returns the measurement of th...

Page 552: ...ments tab the mode of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram MODE WMEMory1 Query MEASure HISTogram MODE source The MEASure HISTogram MODE query returns the measurement...

Page 553: ...the greatest peak of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram PEAK WMEMory1 Query MEASure HISTogram PEAK source The MEASure HISTogram PEAK query returns the number of hit...

Page 554: ...easurements tab the width of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram PP WMEMory1 Query MEASure HISTogram PP source The MEASure HISTogram PP query returns the measurement...

Page 555: ...easurements tab the bin width of the histogram stored in WMEMory1 myScope WriteString MEASure HISTogram RESolution WMEMory1 Query MEASure HISTogram RES source The MEASure HISTogram RES query returns t...

Page 556: ...togram stored in WMEMory1 myScope WriteString MEASure HISTogram STDDev WMEMory1 Query MEASure HISTogram STDDev source The MEASure HISTogram STDDev query returns the measurement of standard deviation o...

Page 557: ...and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source clock_source CHANnel N FUNCtion F WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sou...

Page 558: ...me between the specified clock and data source Returned Format MEASure SETuptime value NL value Hold time in seconds Example This example places the current value of hold time in the numeric variable...

Page 559: ...N Query MEASure JITTer HISTogram The MEASure JITTer HISTogram query returns the state of measurement histogram display Returned Format MEASure JITTer HISTogram 1 0 Example This example places the curr...

Page 560: ...MEASurement The MEASure JITTer MEASurement query returns the measurement number you are performing the jitter analysis on If no measurements are being displayed on the oscilloscope the query will retu...

Page 561: ...N Query MEASure JITTer SPECtrum The MEASure JITTer SPECtrum query returns the state of jitter spectrum display Returned Format MEASure JITTer SPECtrum 1 0 Example This example places the current setti...

Page 562: ...ode to automatic myScope WriteString MEASURE JITTER SPECTRUM HORIZONTAL AUTO Query MEASure JITTer SPECtrum HORizontal The MEASure JITTer SPECtrum HORizontal query returns the current jitter spectrum h...

Page 563: ...rum HORizontal POSition The MEASure JITTer SPECtrum HORizontal POSition query returns the current jitter spectrum horizontal center frequency position setting Returned Format MEASure JITTer SPECtrum H...

Page 564: ...r SPECtrum HORizontal RANGe The MEASure JITTer SPECtrum HORizontal RANGe query returns the current jitter spectrum horizontal range setting Returned Format MEASure JITTer SPECtrum HORizontal RANGe val...

Page 565: ...atic myScope WriteString MEASURE JITTER SPECTRUM VERTICAL AUTO Query MEASure JITTer SPECtrum VERTical The MEASure JITTer SPECtrum VERTical query returns the current jitter spectrum vertical mode setti...

Page 566: ...RTical OFFSet The MEASure JITTer SPECtrum VERTical OFFSet query returns the jitter spectrum vertical offset time Returned Format MEASure JITTer SPECtrum VERTical OFFSet value result_state NL value The...

Page 567: ...ITTer SPECtrum VERTical RANGe The MEASure JITTer SPECtrum VERTical RANGe query returns the jitter spectrum range time setting Returned Format MEASure JITTer SPECtrum VERTical RANGe value result_state...

Page 568: ...Near Query MEASure JITTer SPECtrum VERTical TYPE The MEASure JITTer SPECtrum VERTical TYPE query returns the current jitter spectrum plot vertical scale setting Returned Format MEASure JITTer SPECtrum...

Page 569: ...HANNing Query MEASure JITTer SPECtrum WINDow The MEASure JITTer SPECtrum WINDow query returns the current jitter spectrum window mode setting Returned Format MEASure JITTer SPECtrum WINDow RECTangula...

Page 570: ...sure all edges in the waveform not just the first edge on screen Example This example turns the jitter measurement statistics and the Measure All Edges mode on myScope WriteString MEASure JITTer STATi...

Page 571: ...WriteString MEASURE JITTER TREND ON Query MEASure JITTer TRENd The MEASure JITTer TRENd query returns the state of jitter trend display Returned Format MEASure JITTer TRENd 1 0 Example This example pl...

Page 572: ...ng MEASURE JITTer TREND SMOOTH ON Query MEASure JITTer TRENd SMOoth The MEASure JITTer TRENd SMOoth query returns the current jitter trend smoothing mode setting Returned Format MEASure JITTer TRENd S...

Page 573: ...EASure JITTer TRENd SMOoth POINts The MEASure JITTer TRENd SMOoth POINts query returns the current setting for jitter trend smoothing points Returned Format MEASure JITTer TRENd SMOoth POINts value NL...

Page 574: ...tic myScope WriteString MEASURE JITTer TRENd VERTical AUTO Query MEASure JITTer TRENd VERTical The MEASure JITTer TRENd VERTical query returns the current jitter trend vertical mode setting Returned F...

Page 575: ...RENd VERTical OFFSet The MEASure JITTer TRENd VERTical OFFSet query returns the jitter trend vertical offset setting Returned Format MEASure JITTer TRENd VERTical OFFSet value NL value The jitter vert...

Page 576: ...s the jitter trend vertical range setting Returned Format MEASure JITTer TRENd VERTical RANGe value NL value The jitter trend vertical range setting result_state If SENDvalid is ON the result state is...

Page 577: ...AS4 name The MEASure NAME commands sets the name of the specified measurement to whatever string is given to name This enables you to give specific names to measurements displayed on the oscilloscope...

Page 578: ...enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 direction RISing FALLing specifi...

Page 579: ...Sults table in this chapter for a list of the result states Example This example places the current value of N cycle jitter in the numeric variable varValue then prints the contents of the variable to...

Page 580: ...lized FFE signal as the source N In CHANnel N and WMEMory N N is an integer 1 4 representing the selected channel or waveform memory F FUNCtion F is an integer 1 16 Example This example adds a ones No...

Page 581: ...t was derived using a bit error rate of 1E 12 A format of rms means the measurement is a root mean square measurement A format of dd means the measurement uses a dual Dirac delta model to derive the m...

Page 582: ...level Example This example places the noise measurement result for ones in the strResults variable and displays it on the computer s screen Dim strResult As String Dimension variable myScope WriteStr...

Page 583: ...E myScope WriteString MEASURE NOISe BANDWIDTH WIDE Query MEASure NOISe BANDwidth The MEASure NOISe BANDwidth query returns the RN bandwidth filter setting Returned Format MEASure NOISe BANDwidth NARRo...

Page 584: ...measurement location to 60 myScope WriteString MEASURE NOISe LOCation 60 Query MEASure NOISe LOCation The MEASure NOISe LOCation query returns the measurement location setting Returned Format MEASure...

Page 585: ...ground bounce effects present in your signal you can select the SPECtral method in order to run faster When this option is selected the deterministic interference DI that is uncorrelated to the data...

Page 586: ...l and tail fit analysis including aperiodic bounded uncorrelated interference ABUI measurements myScope WriteString MEASURE NOISe REPort TAILfit Query MEASure NOISe REPort The MEASure NOISe REPort que...

Page 587: ...random noise RNrms One The known amount of ones random noise OFF Disables the specification of random noise amounts Specified amounts of ones and zeros random noise is shown in the noise measurement r...

Page 588: ...rom the front panel user interface will set RNrms Zero and RNrms One to the measured values however the measures values can be changed by this command Example This example specifies 100 V of oscillosc...

Page 589: ...MEASure NOISe STATe The MEASure NOISe STATe query returns the state of the NOISe measurements Returned Format MEASure NOISe STATe 1 0 NL Example This example places the current state of the NOISe meas...

Page 590: ...amplitude Query MEASure NOISe UNITs The MEASure NOISe UNITs query returns the units of measure being used for the NOISe measurements Returned Format MEASure NOISe UNITs VOLT UNITamplitude NL Example T...

Page 591: ...onsecutive periods The measurement then moves over one period and measures the span of time of the next N consecutive periods source the source on which the measurement is made slope rising or falling...

Page 592: ...es source The MEASure NPULses measures the number of negative pulses on the screen source the source on which the measurement is made Example This example measures the number of negative pulses on cha...

Page 593: ...cutive unit intervals The measurement then moves over one unit interval and measures the span of time of the next N consecutive unit intervals source the source on which the measurement is made N An i...

Page 594: ...rces are only available if the oscilloscope has the EZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed...

Page 595: ...ith the measurement result See the MEASure RESults table in this chapter for a list of the result states Example This example places the current width of the first negative pulse on the screen in the...

Page 596: ...talled and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if...

Page 597: ...ure RESults table in this chapter for a list of the result states Example This example places the current value of overshoot in the numeric variable varValue then prints the contents of the variable t...

Page 598: ...ory N N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 width width to measure at the top and base of the pulse in percent 0 100 direction the edge direction to...

Page 599: ...he middle threshold level A 100 window would measure the average of the entire positive or negative pulse In measure all edges mode and EZJIT these measurements can be trended histogrammed etc source...

Page 600: ...installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only availabl...

Page 601: ...st complete cycle on the screen result_state If SENDvalid is ON the result state is returned with the measurement result See the MEASure RESults table in this chapter for a list of the result states E...

Page 602: ...option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is...

Page 603: ...he measurement result See the MEASure RESults table in this chapter for a list of the result states Example This example places the current phase angle value between channel 1 and channel 2 in the var...

Page 604: ...es source The MEASure PPULses measures the number of positive pulses on the screen source the source on which the measurement is made Example This example measures the number of positive pulses on cha...

Page 605: ...ZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is on...

Page 606: ...RESults table in this chapter for a list of the result states Example This example places the current value of preshoot in the numeric variable varPreshoot then prints the contents of the variable to...

Page 607: ...d at the middle threshold level A 100 window would measure the average of the entire positive or negative pulse In measure all edges mode and EZJIT these measurements can be trended histogrammed etc s...

Page 608: ...ources are only available if the oscilloscope has the EZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installe...

Page 609: ...sult See the MEASure RESults table in this chapter for a list of the result states Example This example places the value of the width of the first positive pulse on the screen in the numeric variable...

Page 610: ...e This example sets the level qualifier 2 condition to HIGH myScope WriteString MEASURE QUALIFIER2 CONDITION HIGH Query MEASure QUALifier M CONDition The MEASure QUALifier M CONDition query returns th...

Page 611: ...ce CHANNEL1 Query MEASure QUALifier M SOURce The MEASure QUALifier M SOURce query returns the source being used of the level qualifier for timing measurements Returned Format MEASure QUALifier M SOURc...

Page 612: ...WriteString MEASURE QUALIFIER2 STATE ON Query MEASure QUALifier M STATe The MEASure QUALifier M STATe query returns the state of the level qualifier for timing measurements Returned Format MEASure QUA...

Page 613: ...t MEASure RESults result_list NL result_list A list of the measurement results separated with commas The following shows the order of values received for a single measurement if MEASure STATistics is...

Page 614: ...id Lower threshold not on waveform 13 Result invalid Upper threshold not on waveform 14 Result invalid Upper and lower thresholds are too close 15 Result invalid Top not on waveform 16 Result invalid...

Page 615: ...s measurement or must be in jitter mode to make this measurement 40 Current measurement is not on screen 41 Not enough points available to recover the clock 42 The loop bandwidth of the PLL is too hig...

Page 616: ...the 90 point on the rising edge source CHANnel N FUNCtion F WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sources are only available if the oscilloscope has the EZJIT option install...

Page 617: ...ASure RESults table in this chapter for a list of the result states Example This example places the current value of rise time in the numeric variable varRise then prints the contents of the variable...

Page 618: ...For instance TJ 1E 12 means that the TJ measurement was derived using a bit error rate of 1E 12 A format of rms means the measurement is a root mean square measurement A format of dd means the measure...

Page 619: ...mple This example places the jitter measures in the strResults variable and displays it on the computer s screen Dim strResult As String Dimension variable myScope WriteString SYSTem HEADer OFF Respon...

Page 620: ...ttern length as a numeric data value Invalid 9 99999E 37 is returned if there is no data Example This example places the calculated pattern length in the strResults variable and displays it on the com...

Page 621: ...cope WriteString MEASURE RJDJ BANDWIDTH WIDE Query MEASure RJDJ BANDwidth The MEASure RJDJ BANDwidth query returns the RJ bandwidth filter setting Returned Format MEASure RJDJ BANDwidth NARRow WIDE NL...

Page 622: ...9 E10 1E 10 E11 1E 11 E12 1E 12 E13 1E 13 E14 1E 14 E15 1E 15 E16 1E 16 E17 1E 17 E18 1E 18 J2 2 5E 3 J9 2 5E 10 Example This example sets the bit error rate to E16 myScope WriteString MEASURE RJDJ BE...

Page 623: ...nt Infiniium 90000 Series Oscilloscopes Programmer s Reference 623 myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE RJDJ BER varRate myScope ReadNumber Debug Prin...

Page 624: ...ption Example This example turns on the RJDJ clock option myScope WriteString MEASURE RJDJ CLOCk ON Query MEASure RJDJ CLOCk The MEASure RJDJ CLOCk query returns the setting Returned Format MEASure RJ...

Page 625: ...EASure RJDJ EDGE The MEASure RJDJ EDGE query returns the edge being used for the RJDJ measurements Returned Format MEASure RJDJ EDGE RISING FALLING BOTH NL Example This example places the current edge...

Page 626: ...ure RJDJ INTerpolate The MEASure RJDJ INTerpolate query returns the edge being used for the RJDJ measurements Returned Format MEASure RJDJ INTerpolate LINear NONE NL Example This example places the cu...

Page 627: ...ground bounce effects present in your signal you can select the SPECtral method in order to run faster When this option is selected the deterministic jitter DJ that is uncorrelated to the data pattern...

Page 628: ...the RJDJ measurement mode If NUI is selected then ui selects the number of unit intervals for example MEASure RJDJ MODe NUI 5 Example This example sets the RJDJ mode to TIE myScope WriteString MEASURE...

Page 629: ...f pattern from 2 to 1024 Example This example sets the RJDJ bits to 5 myScope WriteString MEASURE RJDJ PLENgth 5 Query MEASure RJDJ PLENgth The MEASure RJDJ PLENgth query returns the number of bits be...

Page 630: ...he spectral and tail fit analysis including aperiodic bounded uncorrelated jitter ABUJ measurements myScope WriteString MEASURE RJDJ REPort TAILfit Query MEASure RJDJ REPort The MEASure RJDJ REPort qu...

Page 631: ...a specified amount of random jitter RJrms The known amount of random jitter OFF Disables the specification of known random jitter The amount of random jitter is shown in the jitter measurement results...

Page 632: ...rom the reported RJ The calculated oscilloscope random jitter is shown in the jitter measurement results see page 618 as Scope RJ rms OFF Disables the removal of the oscilloscope s calibrated random j...

Page 633: ...on option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an inte...

Page 634: ...MEASure RJDJ STATe The MEASure RJDJ STATe query returns the state of the RJDJ measurements Returned Format MEASure RJDJ STATe 1 0 NL Example This example places the current state of the RJDJ measureme...

Page 635: ...easurement A format of d d means the measurement uses from a dual Dirac delta model used to derive the measurement A format of p p means the measurement is a peak to peak measurement tj_result rj_resu...

Page 636: ...AL Query MEASure RJDJ UNITs The MEASure RJDJ UNITs query returns the units of measure being used for the RJDJ measurements Returned Format MEASure RJDJ UNITs SECond UNITinterval NL Example This exampl...

Page 637: ...MEASure SCRatch Command MEASure SCRatch CLEar The MEASure SCRatch command clears the measurement results from the screen This command performs the same function as MEASure CLEar Example This example...

Page 638: ...ASure SENDvalid query returns the state of the send valid control Returned Format MEASure SENDvalid 0 1 NL Example This example places the current mode for SENDvalid in the string variable strMode the...

Page 639: ...enabled This command uses the Feed Forward Equalized FFE signal as the source clock_source CHANnel N FUNCtion F DIGital M WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sources are o...

Page 640: ...1 RIS CHAN2 RIS Query MEASure SETuptime data_source data_source_dir clock_source clock_ source_dir The MEASure SETuptime query returns the measured setup time between the specified clock and data sour...

Page 641: ...d and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N An integer 1 4 F An integer 1 16 edge_dir RISing FALLing BOTH Example This example measures the s...

Page 642: ...ature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command...

Page 643: ...URE STATISTICS ON Query MEASure STATistics The MEASure STATistics query returns the current statistics mode Returned Format MEASure STATistics ON CURRent MAXimum MEAN MINimum STDDev NL Example This ex...

Page 644: ...tal M WMEMory N CLOCk MTRend MSPectrum EQUalized MTRend and MSPectrum sources are only available if the oscilloscope has the EZJIT option installed and the feature is enabled The CLOCk source is only...

Page 645: ...rigger event and the 90 threshold on the second rising edge of the source waveform to the numeric variable varTime The contents of the variable are then printed to the computer s screen myScope WriteS...

Page 646: ...mand uses the Feed Forward Equalized FFE signal as the source Setting the source to ALL does not affect the individual channel settings which is the behavior as the user interface N An integer 1 4 F A...

Page 647: ...STem HEADer OFF Response headers off myScope WriteString MEASure THResholds ABSolute CHANnel1 strThresholds myScope ReadString Debug Print strThresholds NOTE Turn Off Headers When receiving numeric da...

Page 648: ...e High Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source Setting the source to AL...

Page 649: ...Tem HEADer OFF Response headers off myScope WriteString MEASure THResholds HYSTeresis CHANNEL1 strRangeLevel myScope ReadString Debug Print strRangeLevel NOTE Turn Off Headers When receiving numeric d...

Page 650: ...enabled This command uses the Feed Forward Equalized FFE signal as the source Setting the source to ALL does not affect the individual channel settings which is the behavior as the user interface N An...

Page 651: ...urce to ALL does not affect the individual channel settings which is the behavior as the user interface N An integer 1 4 F An integer 1 16 M An integer 0 15 Digital channels are available on mixed sig...

Page 652: ...s Reference 25 Measure Commands strThresholdsPct myScope ReadString Debug Print strThresholdsPct NOTE Turn Off Headers When receiving numeric data into numeric variables turn off the headers Otherwis...

Page 653: ...command uses the Feed Forward Equalized FFE signal as the source Setting the source to ALL does not affect the individual channel settings which is the behavior as the user interface N An integer 1 4...

Page 654: ...source to ALL does not affect the individual channel settings which is the behavior as the user interface N An integer 1 4 F An integer 1 16 M An integer 0 15 Digital channels are available on mixed s...

Page 655: ...t Infiniium 90000 Series Oscilloscopes Programmer s Reference 655 NOTE Turn Off Headers When receiving numeric data into numeric variables turn off the headers Otherwise the headers may cause misinter...

Page 656: ...ized MTRend and MSPectrum sources are only available if the oscilloscope has the EZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High S...

Page 657: ...e TIEClock2 source SECond UNITinterval direction AUTO CUSTOM frequency VARiable frequency bandwidth CLOCk The MEASure TIEClock2 query returns the current value of the clock time interval error Returne...

Page 658: ...ly available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and t...

Page 659: ...state If SENDvalid is ON the result state is returned with the measurement result See the MEASure RESults table in this chapter for a list of the result states Example This example places the current...

Page 660: ...ecade myScope WriteString MEASURE TIEFilter SHAPe DB40 Query MEASure TIEFilter SHAPe The MEASure TIEFilter SHAPe query returns the specified shape of the TIE filter edge s Returned Format MEASure TIEF...

Page 661: ...cy of the TIE filter Returned Format MEASure TIEFilter STARt value NL value The start frequency for the TIE filter Example This example returns the current value of the starting frequency for the TIE...

Page 662: ...tate of the TIE data filter Returned Format MEASure TIEFilter STATe 0 1 NL Example This example returns the current state of the TIE data filter then prints the contents of the variable to the compute...

Page 663: ...y of the TIE filter Returned Format MEASure TIEFilter STOP value NL value The stop frequency for the TIE filter Example This example returns the current value of the stopping frequency for the TIE fil...

Page 664: ...Sure TIEFilter TYPE query returns the current type of TIE filter being used Returned Format MEASure TIEFilter TYPE BANDpass LOWPass HIGHpass NL Example This example places the current mode for TIEFilt...

Page 665: ...Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F...

Page 666: ...option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer...

Page 667: ...be reported if one the first crossing is reported if two the second crossing is reported etc The desired crossing must be present on the display Occurrences are counted with 1 being the first occurren...

Page 668: ...t states Example This example returns the time interval between the trigger event and the transition through 0 250 Volts on the third rising occurrence of the source waveform to the numeric variable v...

Page 669: ...t interval and makes another measurement When N 1 this is analogous to cycle cycle jitter but measures unit intervals instead of periods When N 1 this is analogous to N Cycle jitter but measures unit...

Page 670: ...High Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer...

Page 671: ...e current unit interval of the channel 1 waveform in the numeric variable varValue then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response head...

Page 672: ...This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example calculates the dif...

Page 673: ...has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization optio...

Page 674: ...the current average voltage in the numeric variable varAverage then prints the contents of the variable to the computer s screen myScope WriteString SYSTEM HEADER OFF Response headers off myScope Wri...

Page 675: ...enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example measures t...

Page 676: ...and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an inte...

Page 677: ...d the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This...

Page 678: ...678 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 25 Measure Commands varMaximum myScope ReadNumber Debug Print FormatNumber varMaximum 0...

Page 679: ...ed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the features are enabled...

Page 680: ...features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This exampl...

Page 681: ...Measure Commands 25 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 681 varMinimum myScope ReadNumber Debug Print FormatNumber varMinimum 0...

Page 682: ...he feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized source is only available if the oscillo...

Page 683: ...ilable if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as th...

Page 684: ...ries Oscilloscopes Programmer s Reference 25 Measure Commands myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE VPP CHANNEL1 varVoltage myScope ReadNumber Debug Pr...

Page 685: ...s the EZJIT option installed and the feature is enabled The CLOCk source is only available if the oscilloscope has the High Speed Serial option installed and the feature is enabled The EQUalized sourc...

Page 686: ...ter is also useful when measuring noise AC The AC parameter is used to measure the RMS voltage subtracting the DC component DC The DC parameter is used to measure RMS voltage including the DC componen...

Page 687: ...ult_state NL value RMS voltage of the selected waveform result_state If SENDvalid is ON the result state is returned with the measurement result See the MEASure RESults table in this chapter for a lis...

Page 688: ...d Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMo...

Page 689: ...niium 90000 Series Oscilloscopes Programmer s Reference 689 myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE VTIME 500E 3 CHANNEL1 varValue myScope ReadNumber Deb...

Page 690: ...e features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This exam...

Page 691: ...ption installed and the features are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer...

Page 692: ...692 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 25 Measure Commands varValue myScope ReadNumber Debug Print FormatNumber varValue 0...

Page 693: ...are made in the ZOOM window measurement gating or over the entire acquisition MAIN or ALL The MAIN and ALL parameters are equivalent Example This example gates Measurement 1 to the zoom window myScope...

Page 694: ...e of the specified measurement to whatever string is given to name This lets you give specific names to measurements displayed on the oscilloscope s screen N An integer 1 10 This number represents the...

Page 695: ...The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the features are enabled This command uses the Feed F...

Page 696: ...696 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 25 Measure Commands...

Page 697: ...1 697 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 26 Pod Commands POD N DISPlay 698 POD N PSKew 699 POD N THReshold 700 NOTE The POD commands only apply to the MSO oscilloscope...

Page 698: ...Displaying a pod automatically enables digital channels See ENABle command in the root subsystem N An integer 1 2 Example This example turns on the display of bit 5 for the digital channels myScope Wr...

Page 699: ...me delay between the analog and digital channels This can occur when different length cables are used N An integer 1 2 skew_value A real number for the skew value in the range 1 ms to 1 ms Example Thi...

Page 700: ...are CMOS50 2 5 V CMOS33 1 65 V CMOS25 1 25 V ECL 1 3 V PECL 3 7 V TTL 1 4 V DIFFerential 0 V N An integer 1 2 value A real number representing the voltage value which distinguishes a 1 logic level fr...

Page 701: ...Pod Commands 26 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 701 See Also DIGital N THReshold on page 273...

Page 702: ...702 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 26 Pod Commands...

Page 703: ...ls 709 AUToscale PLACement 710 AUToscale VERTical 711 BEEP 712 BLANk 713 CDISplay 714 DIGitize 715 DISable DIGital 716 ENABle DIGital 717 MTEE 719 MTER 720 MODel 718 OPEE 721 OPER 722 OVLRegister 723...

Page 704: ...f the basic operations of the oscilloscope that you can select by pressing the labeled keys on the front panel These commands are always recognized by the parser if they are prefixed with a colon rega...

Page 705: ...quisition Done Event Register and returns 1 or 0 After the Acquisition Done Event Register is read the register is cleared The returned value 1 indicates an acquisition completed event has occurred an...

Page 706: ...eared The returned value 1 indicates a trigger armed event has occurred and 0 indicates a trigger armed has not occurred Once the AER bit is set it is cleared only by doing AER or by sending a CLS com...

Page 707: ...Event Register Query ATER The ATER query reads the Auto Trigger Event Register and returns 1 or 0 After the Auto Trigger Event Register is read the register is cleared The returned value 1 indicates...

Page 708: ...el 4 then channel 3 channel 2 and channel 1 until a trigger waveform is detected If waveforms cannot be found on any vertical input the oscilloscope is returned to its former state Autoscale sets the...

Page 709: ...s Command AUToscale CHANnels ALL DISPlayed The AUToscale CHANnels command selects whether to apply autoscale to all of the input channels or just the input channels that are currently displayed Exampl...

Page 710: ...rms because they no longer take up the full dynamic range of th ADC analog to digital converter If Separate is chosen then the screen is divided into the same number of grids that there are waveforms...

Page 711: ...d scaling for the corresponding channel without changing anything else for example trigger or timebase settings Example This example automatically autoscales the vertical position and scale for the wa...

Page 712: ...y duration The BEEP command makes the oscilloscope beep at a defined frequency and duration frequency A real number representing frequency of beep in Hertz duration A real number representing duration...

Page 713: ...OCk MTRend MSPectrum EQUalize ALL The BLANk command turns off an active channel function histogram waveform memory measurement trend measurement spectrum or Feed Forward Equalized waveform The VIEW co...

Page 714: ...resets all associated measurements If the oscilloscope is stopped all currently displayed data is erased If the oscilloscope is running all of the data in active channels and functions is erased howe...

Page 715: ...played in the Infiniium waveform viewing area In this case the display state of the acquired waveforms is not changed after the DIGitize command is completed Because the command executes more quickly...

Page 716: ...opes Programmer s Reference 27 Root Level Commands DISable DIGital Command DISable DIGital The DISable DIGital command disables the digital channels 0 15 Example This example will disable the digital...

Page 717: ...90000 Series Oscilloscopes Programmer s Reference 717 ENABle DIGital Command ENABle DIGital The ENABle DIGital command enables the digital channels 0 15 Example This example will enable the digital ch...

Page 718: ...ned by header and longform status as in Table 25 Example This example places the model number in a string variable strModel then prints the contents of the variable on the computer s screen Dim strMod...

Page 719: ...n interrupt whenever a Mask Test Fail occurs in the mask test register You can enable this bit to generate the summary bit by sending myScope WriteString MTEE 2 Whenever an error occurs the oscillosco...

Page 720: ...is complete Bit 1 Mask Test Fail bit is set whenever the mask test failed Bit 2 Mask Low Amplitude bit is set whenever the signal is below the mask amplitude Bit 3 Mask High Amplitude bit is set whene...

Page 721: ...E command sets a mask in the Operation Status Enable register Each bit that is set to a 1 enables that bit to set bit 7 in the status byte register and potentially causes an SRQ to be generated Bit 5...

Page 722: ...OPER query returns the value contained in the Operation Status Register as a decimal number This register contains the WAIT TRIG bit bit 5 and the OVLR bit bit 11 The WAIT TRIG bit is set by the Trig...

Page 723: ...Query OVLRegister The OVLRegister query returns the value stored in the Overload Event Register The integer value returned by this query represents the channels as follows Bit 0 Channel 1 Bit 1 Chann...

Page 724: ...PDER query reads the Processing Done Event Register and returns 1 or 0 After the Processing Done Event Register is read the register is cleared The returned value 1 indicates indicates that all math...

Page 725: ...RINt command outputs a copy of the screen to a printer or other device destination specified in the HARDcopy subsystem You can specify the selection of the output and the printer using the HARDcopy su...

Page 726: ...ory_num setup _memory_num Setup memory number an integer 0 through 9 The RECall SETup command recalls a setup that was saved in one of the oscilloscope s setup memories You can save setups using eithe...

Page 727: ...ording to its current settings Acquisition runs repetitively until the oscilloscope receives a STOP command or until there is only one acquisition if Trigger Sweep is set to Single However the TRIGger...

Page 728: ...tring returned for the IDN query described in the Common Commands chapter serial _number A ten character alphanumeric serial number enclosed with quotation marks Example This example sets the serial n...

Page 729: ...loscope to make a single acquisition when the next trigger event occurs However this command does not set the TRIGger SWEep to SINGle Example This example sets up the oscilloscope to make a single acq...

Page 730: ...option installed and the feature is enabled The EQUalized source is only available if the oscilloscope has the High Speed Serial option and the Serial Data Equalization option installed and the featu...

Page 731: ...illoscopes Programmer s Reference 731 STOP Command STOP The STOP command causes the oscilloscope to stop acquiring data To restart the acquisition use the RUN or SINGle command Example This example st...

Page 732: ...owed by the RJ DJ measurement results section After the RJ DJ measurement results section is the data for each of the measurements Each data section has a header showing what the measurement data is t...

Page 733: ...Tup Command STORe SETup setup_memory_num setup _memory_num Setup memory number an integer 0 through 9 The STORe SETup command saves the current oscilloscope setup in one of the setup memories Example...

Page 734: ...r 1 4 F An integer 1 16 The STORe WAVeform command copies a channel function stored waveform measurement trend or measurement spectrum to a waveform memory The parameter preceding the comma specifies...

Page 735: ...the waveform meets the trigger criteria Returned Format 1 0 NL Example This example checks the current status of the Trigger Event Register places the status in the string variable strCurrent then pr...

Page 736: ...D P The VIEW command turns on a channel function histogram or waveform memory The BLANk command turns them off MTRend and MSPectrum sources are only available if the oscilloscope has the EZJIT option...

Page 737: ...ial Bus Commands General SBUS N Commands 738 SBUS N IIC Commands 741 SBUS N SPI Commands 745 The SBUS N subsystem commands control the serial decode bus viewing mode and other options NOTE These comma...

Page 738: ...738 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 28 Serial Bus Commands General SBUS N Commands SBUS N DISPlay on page 739 SBUS N MODE on page 740...

Page 739: ...y display 1 ON 0 OFF The SBUS N DISPlay command turns displaying of the serial decode bus on or off Query SBUS N DISPlay The SBUS N DISPlay query returns the current display setting of the serial deco...

Page 740: ...N MODE command determines the decode mode for the serial bus Query SBUS N MODE The SBUS n MODE query returns the current serial bus decode mode setting Returned Format SBUS N MODE mode NL mode IIC SP...

Page 741: ...oscopes Programmer s Reference 741 SBUS N IIC Commands SBUS n IIC ASIZe on page 742 SBUS N IIC SOURce CLOCk on page 743 SBUS N IIC SOURce DATA on page 744 NOTE These commands are only valid when the l...

Page 742: ...BUS n IIC ASIZe size size BIT7 BIT8 The SBUS n IIC ASIZe command determines whether the Read Write bit is included as the LSB in the display of the IIC address field of the decode bus Query SBUS n IIC...

Page 743: ...N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Example This example selects channel 2 a...

Page 744: ...l N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Example This example selects channel 1...

Page 745: ...Ck TIMeout on page 748 SBUS N SPI FRAMe STATe on page 749 SBUS N SPI SOURce CLOCk on page 750 SBUS N SPI SOURce DATA on page 751 SBUS N SPI SOURce FRAMe on page 752 SBUS N SPI SOURce MISO on page 753...

Page 746: ...SPI BITorder command selects the bit order most significant bit first MSB or least significant bit first LSB used when displaying data in the serial decode waveform and in the Lister N An integer 1 4...

Page 747: ...SPI CLOCk SLOPe command specifies the rising edge POSitive or falling edge NEGative of the SPI clock source that will clock in the data N An integer 1 4 Query SBUS N SPI CLOCk SLOPe The SBUS N SPI CL...

Page 748: ...l clock timeout resource in seconds from 100 ns to 10 s when the SBUS N SPI FRAMing command is set to TIMeout The timer is used to frame a signal by a clock timeout N An integer 1 4 Query SBUS N SPI C...

Page 749: ...nd SBUS N SPI FRAMe STATe value value LOW HIGH The SBUS N SPI FRAMe STATe command sets the SPI trigger frame state N An integer 1 4 Query SBUS N SPI FRAMe STATe The SBUS N SPI FRAMe STATe query return...

Page 750: ...N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Query SBUS N SPI SOURce CLOCk The SBUS N SPI SOURce CLOCk query retu...

Page 751: ...BUS N SPI SOURce MOSI command N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Q...

Page 752: ...MEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Query SBUS N SPI SOURce FRAMe The SBUS N SPI SOURce FRAMe quer...

Page 753: ...CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Query SBUS N SPI SOURce MISO The...

Page 754: ...ce DATA command to set the MOSI data source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 M An integer 0 15 Digital channels are available on mixed signal o...

Page 755: ...An integer 1 4 Example To set the 3 wire SPI decode type myScope WriteString SBUS1 SPI TYPE WIRE3 Query SBUS N SPI TYPE The SBUS N SPI TYPE query returns the decode type setting Returned Format SBUS...

Page 756: ...ord_width integer 4 16 in NR1 format The SBUS N SPI WIDTh command determines the number of bits in a word of data for SPI N An integer 1 4 Query SBUS N SPI WIDTh The SBUS N SPI WIDTh query returns the...

Page 757: ...f Test Commands SELFtest CANCel 758 SELFtest SCOPETEST 759 The SELFtest subsystem commands set up the self test dialog and run the Infiniium Series Oscilloscopes Self Tests NOTE Enclose File Name in Q...

Page 758: ...copes Programmer s Reference 29 Self Test Commands SELFtest CANCel Command SELFtest CANCel The SELFtest CANCel command stops the currently running selftest Example This example stops the currently run...

Page 759: ...e_stamp NL test_name A string as follows Scope Self Tests time_stamp The time stamp follows the test name and test status and is the part of the returned string that includes the date and time in the...

Page 760: ...760 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 29 Self Test Commands...

Page 761: ...775 SPRocessing DFEQualizer SOURce 776 SPRocessing DFEQualizer NTAPs 777 SPRocessing DFEQualizer TAP 778 SPRocessing DFEQualizer TAP WIDTh 779 SPRocessing DFEQualizer TAP DELay 780 SPRocessing DFEQual...

Page 762: ...er TAP TDELay 799 SPRocessing FFEQualizer TAP TDMode 800 SPRocessing FFEQualizer VERTical 801 SPRocessing FFEQualizer VERTical OFFSet 802 SPRocessing FFEQualizer VERTical RANGe 803 The N5461A Serial D...

Page 763: ...d turns the display of a Continuous Time Linear Equalizer CTLE real time eye diagram on or off Turning CTLE on automatically turns FFE off and vice versa Example This example turns on the display of a...

Page 764: ...ry N The CTLequalizer SOURce command sets the source for the Continuous Time Linear Equalization N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This...

Page 765: ...r DCGain dc_gain The CTLequalizer DCGain command sets the DC Gain parameter for the Continuous Time Linear Equalization dc_gain A real number Example This example sets the CTLE DC Gain parameter to 1...

Page 766: ...r NUMPoles POLE2 POLE3 The SPRocessing CTLequalizer NUMPoles command selects either a 2 Pole or 3 Pole Continuous Time Linear Equalizer CTLE Example This example selects a 2 Pole CTLE myScope WriteStr...

Page 767: ...lizer P1 pole1_freq The CTLequalizer P1 command sets the Pole 1 frequency for the Continuous Time Linear Equalization pole1_freq A real number Example This example sets the CTLE Pole 1 frequency to 1G...

Page 768: ...lizer P2 pole2_freq The CTLequalizer P1 command sets the Pole 2 frequency for the Continuous Time Linear Equalization pole2_freq A real number Example This example sets the CTLE Pole 2 frequency to 4...

Page 769: ...lizer P3 pole3_freq The CTLequalizer P1 command sets the Pole 3 frequency for the Continuous Time Linear Equalization pole3_freq A real number Example This example sets the CTLE Pole 3 frequency to 4...

Page 770: ...SPRocessing CTLequalizer RATe data_rate The CTLequalizer RATe command sets the data rate for the CTLE equalizer data_rate A real number Example This example sets the CTLE data rate to 3e9 myScope Writ...

Page 771: ...his example sets the CTLE signal s vertical scale mode to automatic myScope WriteString SPRocessing CTLequalizer VERTical AUTO Query SPRocessing CTLequalizer VERTical The SPRocessing CTLequalizer VERT...

Page 772: ...CTLequalizer VERTICAL OFFSET 1 Query SPRocessing CTLequalizer VERTical OFFSet The SPRocessing CTLequalizer VERTical OFFSet query returns the CTLE signal s vertical offset setting Returned Format SPRoc...

Page 773: ...String SPRocessing CTLequalizer VERTICAL RANGE 16 Query SPRocessing CTLequalizer VERTical RANGe The SPRocessing CTLequalizer VERTical RANGe query returns the CTLE signal s vertical range setting Retur...

Page 774: ...izer ZERo zero_freq The CTLequalizer ZERo command sets the zero frequency for the Continuous Time Linear Equalization zero_freq A real number Example This example sets the CTLE zero frequency to 900 M...

Page 775: ...Te Command SPRocessing DFEQualizer STATe OFF 0 ON 1 The DFEQualizer STATe command turns the Decision Feedback Equalization on or off Example This example turns on DFE myScope WriteString SPRocessing D...

Page 776: ...he source for the Decision Feedback Equalization Setting the source to EQUalized means the Feed Forward Equalized FFE waveform is used as the DFE source N CHANnel N is an integer 1 4 WMEMory N is an i...

Page 777: ...alizer NTAPs command sets the number of taps to be used in the DFE algorithm DFE tap indices always begin with 1 and extend to the number of taps number An integer between 2 and 40 Example This exampl...

Page 778: ...value for each DFE tap For example when tap is equal to 0 then the 0th tap is set to value DFE tap indices always start at 1 and extend to the number of taps tap The tap number when tap 0 Tap 1 is set...

Page 779: ...eformed at the location of the clock Setting the width to 1 0 means the entire acquisition is used in the optimization The default value for DFE is 0 0 For more information on this parameter refer to...

Page 780: ...ay command specifies the amount of drift the equalized eye diagram has relative to the unequalized one This drift is then accounted for so the two eyes overlap For more information on this parameter r...

Page 781: ...e upper and lower limits on the tap values The DFEQualizer TAP MAX command sets the upper limit on taps determined through optimization max_tap_value A real number Example This example sets the Upper...

Page 782: ...e upper and lower limits on the tap values The DFEQualizer TAP MIN command sets the lower limit on taps determined through optimization min_tap_value A real number Example This example sets the Lower...

Page 783: ...ectly compare the eye at the receiver to the eye at the transmitter a gain factor needs to be applied The DFEQualizer TAP GAIN command allows you to set this gain For more information on this paramete...

Page 784: ...the DFE algorithm For example in DFE when a bit is determined to be a logical high its value will be equal to Upper Target The DFEQualizer TAP UTARget command allows you to set this value upper_target...

Page 785: ...the DFE algorithm For example in DFE when a bit is determined to be a logical low its value will be equal to Lower Target The DFEQualizer TAP LTARget command allows you to set this value lower_target...

Page 786: ...FEQualizer TAP AUTomatic Command SPRocessing DFEQualizer TAP AUTomatic The DFEQualizer TAP AUTomatic command starts the DFE tap optimization Be sure to first specify the number of taps and the max min...

Page 787: ...ON 1 The FFEQualizer DISPlay command turns the display of a Feed Forward Equalized FFE real time eye diagram on or off Example This example turns on the display of a FFE real time eye diagram myScope...

Page 788: ...F WMEMory N The FFEQualizer SOURce command sets the source for the Feed Forward Equalization N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This exam...

Page 789: ...er The FFEQualizer NPRecursor command sets the number of precursor taps to be used in the FFE algorithm number An integer between 1 and NTAPs 1 Example This example sets the number of FFE precursor ta...

Page 790: ...depend on the number of precursor taps being used For example if you are using zero precursor taps then your FFE tap indices would range from 0 to NTAPs 1 If you are using two precursor taps then you...

Page 791: ...d SPRocessing FFEequalizer RATe data_rate The FFEequalizer RATe command sets the data rate for the FFE equalizer data_rate A real number Example This example sets the FFE data rate to 3e9 myScope Writ...

Page 792: ...ur FFE taps depend on the number of precursor taps being used For example if you are using zero precursor taps then your FFE tap indices would range from 0 to NTAPs 1 If you are using two precursor ta...

Page 793: ...EQualizer TAP PLENgth command sets the pattern for the FFE tap optimization algorithm The file parameter is only used in CUSTom mode For more information on this parameter refer to the N5461A Infiniiu...

Page 794: ...rmed at the location of the clock Setting the width to 1 0 means the entire acquisition is used in the optimization The default value for FFE is 0 33 For more information on this parameter refer to th...

Page 795: ...Lay command specifies the amount of drift the equalized eye diagram has relative to the unequalized one This drift is then accounted for so the two eyes overlap For more information on this parameter...

Page 796: ...TAP AUTomatic Command SPRocessing FFEQualizer TAP AUTomatic The FFEQualizer TAP AUTomatic command starts the FFE tap optimization Be sure to first specify the number of taps and specify the Pattern an...

Page 797: ...zer TAP BWMode command is set to CUSTom and in this case it sets the bandwidth at which the response generated by equalization rolls off To understand more about this parameter consult the N5461A Infi...

Page 798: ...de command sets the bandwidth at which the response generated by equalization is rolled off To understand more about this parameter consult the N5461A Infiniium Serial Data Equalization User s Guide E...

Page 799: ...ommand is only needed if the FFEQualizer TAP TDMode is set to CUSTom To determine what this value should be use the equation tap delay 1 data rate x of taps per bit To understand more about this param...

Page 800: ...one tap per bit use the TBITrate selection If you are using multiple taps per bit use CUSTom and then use the FFEQualizer TAP TDELay command to set the value To understand more about this parameter c...

Page 801: ...This example sets the FFEE signal s vertical scale mode to automatic myScope WriteString SPRocessing FFEQualizer VERTical AUTO Query SPRocessing FFEQualizer VERTical The SPRocessing FFEQualizer VERTi...

Page 802: ...FFEQualizer VERTICAL OFFSET 1 Query SPRocessing FFEQualizer VERTical OFFSet The SPRocessing FFEQualizer VERTical OFFSet query returns the FFE signal s vertical offset setting Returned Format SPRocess...

Page 803: ...eString SPRocessing FFEQualizer VERTICAL RANGE 16 Query SPRocessing FFEQualizer VERTical RANGe The SPRocessing FFEQualizer VERTical RANGe query returns the FFE signal s vertical range setting Returned...

Page 804: ...804 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 30 Serial Data Equalization Commands...

Page 805: ...Der 811 SYSTem LOCK 812 SYSTem LONGform 813 SYSTem PRESet 814 SYSTem SETup 815 SYSTem TIME 817 SYSTem subsystem commands control the way query responses are formatted send and receive setup strings an...

Page 806: ...alues range from 1992 to 2035 month Specifies the month in the format 1 2 12 JAN FEB MAR day Specifies the day in the format 1 31 Example This example sets the date to December 1 2002 myScope WriteStr...

Page 807: ...debug file or any other debug file This is a read only mode output_mode FILE SCReen FileSCReen file_name An MS DOS compatible name of the file a maximum of 254 characters long including the path name...

Page 808: ...ing NL SYSTEM ERROR 0 No error ACQuire BEST FLATness NL 113 Undefined header syst err string NL SYSTEM ERROR 113 Undefined header syst err string NL SYSTEM ERROR 0 No error Debug information file C Do...

Page 809: ...Query SYSTem DSP The SYSTem DSP query returns the last string written to the advisory line This may be a string written with a SYSTem DSP command or an internally generated advisory The string is actu...

Page 810: ...strCondition then prints the contents of the variable to the computer s screen Dim strCondition As String Dimension variable myScope WriteString SYSTEM ERROR STRING strCondition myScope ReadString De...

Page 811: ...s with query responses myScope WriteString SYSTEM HEADER ON Query SYSTem HEADer The SYSTem HEADer query returns the state of the SYSTem HEADer command Returned Format SYSTem HEADer 1 0 NL Example This...

Page 812: ...nt panel can be re enabled by sending the SYSTem LOCK OFF command or by using the mouse to click on the Minimize button in the upper right hand corner of the oscilloscope screen Example This example d...

Page 813: ...m LONGform The SYSTem LONGform query returns the current state of the SYSTem LONGform command Returned Format SYSTem LONGform 1 0 NL Example This example checks the current format for query responses...

Page 814: ...rol settings found in the User Preferences dialog box display color settings screen options probe skew probe external adapter settings for differential probes or probe internal attenuation and gain se...

Page 815: ...le varSetup Read data Close hFile Close file Write setup to oscilloscope myScope WriteIEEEBlock SYSTem SETup varSetup Debug Print Setup bytes restored CStr LenB varSetup Query SYSTem SETup The SYSTem...

Page 816: ...put setup string to a file Dim strPath As String strPath c scope config setup dat Dim hFile As Long hFile FreeFile Open strPath For Binary Access Write Lock Write As hFile Put hFile varSetup Write dat...

Page 817: ...command sets the time in the oscilloscope and is not affected by the RST common command hour 0 23 minute 0 59 second 0 59 Example This example sets the oscilloscope time to 10 30 45 a m myScope WriteS...

Page 818: ...818 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 31 System Commands...

Page 819: ...POSition 820 TIMebase RANGe 821 TIMebase REFClock 822 TIMebase REFerence 823 TIMebase SCALe 824 TIMebase VIEW 825 TIMebase WINDow DELay 826 TIMebase WINDow POSition 827 TIMebase WINDow RANGe 828 TIMeb...

Page 820: ...rigger to the delay reference point Example This example sets the delay position to 2 ms myScope WriteString TIMEBASE POSITION 2E 3 Query TIMebase POSition The TIMebase POSition query returns the curr...

Page 821: ...s div Example This example sets the full scale horizontal range to 10 ms myScope WriteString TIMEBASE RANGE 10E 3 Query TIMebase RANGe The TIMebase RANGe query returns the current full scale horizont...

Page 822: ...ntal scale section instead of the internal reference clock Example This example turns on the 10 MHz reference clock mode myScope WriteString TIMebase REFClock ON Query TIMebase REFClock The TIMebase R...

Page 823: ...er of the display myScope WriteString TIMEBASE REFERENCE CENTER Query TIMebase REFerence The TIMebase REFerence query returns the current delay reference position Returned Format TIMebase REFerence LE...

Page 824: ...scale is 5 ps div to 20 s div Example This example sets the scale to 10 ms div myScope WriteString TIMEBASE SCALE 10E 3 Query TIMebase SCALe The TIMebase SCALe query returns the current scale time se...

Page 825: ...mple turns the horizontal zoom mode on myScope WriteString TIMebase VIEW WINDow Query TIMebase VIEW The TIMebase VIEW query returns the horizontal zoom mode setting Returned Format TIMebase VIEW MAIN...

Page 826: ...20E 9 Query TIMebase WINDow DELay The TIMebase WINDow DELay query returns the current horizontal position in the delayed view Returned Format TIMebase WINDow DELay delay_position NL Example This examp...

Page 827: ...int The maximum position depends on the main sweep range and the main sweep horizontal position Example This example sets the time base window delay position to 20 ns myScope WriteString TIMEBASE WIND...

Page 828: ...ge of the time base window in seconds Example This example sets the full scale range of the delayed view to 100 ns myScope WriteString TIMEBASE WINDOW RANGE 100E 9 Query TIMebase WINDow RANGe The TIMe...

Page 829: ...layed view This command rescales the horizontal components of displayed waveforms time A real number for the delayed windows scale Example This example sets the scale of the time base window to 2 mill...

Page 830: ...830 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 32 Time Base Commands...

Page 831: ...ng but the one that is used most often is edge triggering Edge triggering identifies a trigger condition by looking for the slope rising or falling and voltage level trigger level on the source you se...

Page 832: ...the oscilloscope is in the proper trigger mode is to send the TRIGger MODE command in the same program message as the parameter to be set For example these commands place the instrument in the proper...

Page 833: ...n page 834 TRIGger AND SOURce on page 835 TRIGger HOLDoff on page 836 TRIGger HOLDoff MAX on page 837 TRIGger HOLDoff MIN on page 838 TRIGger HOLDoff MODE on page 839 TRIGger HTHReshold on page 840 TR...

Page 834: ...TRIGger AND ENABle command enables the ability to further qualify the trigger using other channels The optional 1 2 parameter sets whether the AND qualifier goes with the TERM1 or TERM2 state if sequ...

Page 835: ...and determines what voltage level is considered a HIGH or a LOW logic value If you set more than one channel to a HIGH or a LOW then the multiple channels are used to qualify the trigger The optional...

Page 836: ...TRIGger HOLDoff command specifies the amount of time the oscilloscope should wait after receiving a trigger before enabling the trigger again holdoff_time A real number for the holdoff time ranging f...

Page 837: ...s The Random holdoff mode ensures that the oscilloscope re arms after each acquisition in a manner that minimizes or eliminates the likelihood of triggering at the beginning of a DDR burst Randomizing...

Page 838: ...s The Random holdoff mode ensures that the oscilloscope re arms after each acquisition in a manner that minimizes or eliminates the likelihood of triggering at the beginning of a DDR burst Randomizing...

Page 839: ...be between the values specified by the TRIGger HOLDoff MAX and TRIGger HOLDoff MIN commands The Random holdoff mode ensures that the oscilloscope re arms after each acquisition in a manner that minimi...

Page 840: ...lected trigger source Set the high threshold level to a value considered to be a high level for your logic family your data book gives two values VIH and VOH N An integer 1 4 level A real number for t...

Page 841: ...oise reject as either normal or high sensitivity NORMal sensitivity adds hysteresis to the trigger circuitry for rejecting noise and should be used for waveforms of 4 GHz or below HSENsitivity lowers...

Page 842: ...channel for the trigger source Only one trigger level is stored in the oscilloscope for each channel This level applies to the channel throughout the trigger dialog N An integer 1 4 level A real numbe...

Page 843: ...pecifies the low threshold voltage level for the selected trigger source Set the low threshold level to a value considered to be a low level for your logic family your data book gives two values VIL a...

Page 844: ...nnel as the trigger source You can also use pattern triggering to trigger on a pulse of a given width PWIDth PWIDth or pulse width trigger is used to find pulse that are either narrower or wider than...

Page 845: ...nce SHOLd STATe TIMeout TRANsition TV WINDow SBUS N NL TV TV trigger mode lets you trigger the oscilloscope on one of the standard television waveforms You can also use this mode to trigger on a custo...

Page 846: ...matically forces a trigger which causes the oscilloscope to sweep If the frequency of your waveform is 50 Hz or less you should not use the AUTO sweep mode because it is possible that the oscilloscope...

Page 847: ...90000 Series Oscilloscopes Programmer s Reference 847 Comm Trigger Commands TRIGger COMM BWIDth on page 848 TRIGger COMM ENCode on page 849 TRIGger COMM PATTern on page 850 TRIGger COMM POLarity on pa...

Page 848: ...th_value The TRIGger COMM BWIDth command is used to set the width of a bit for your waveform The bit width is usually defined in the mask standard for your waveform bwidth_value A real number that rep...

Page 849: ...COMM ENCode RZ NRZ This TRIGger COMM ENCode command sets the type of waveform encoding for your waveform You should use NRZ for CMI type waveforms and RZ for all other type of waveforms Query TRIGger...

Page 850: ...re must be at least one logic 0 to logic 1 transition in the pattern For NRZ waveforms with negative polarity there must be at least one logic 1 to logic 0 transition in the pattern For RZ type wavefo...

Page 851: ...orm is used to trigger the oscilloscope When set to a negative value the falling edge of a pulse or waveform is used The polarity setting is also used to check for valid patterns If you are trying to...

Page 852: ...ce Command TRIGger COMM SOURce CHANnel N The TRIGger COMM SOURce command selects the channel used for the communication trigger N An integer 1 4 Query TRIGger COMM SOURce The TRIGger COMM SOURce query...

Page 853: ...ARM SOURce on page 854 TRIGger DELay ARM SLOPe on page 855 TRIGger DELay EDELay COUNt on page 856 TRIGger DELay EDELay SOURce on page 857 TRIGger DELay EDELay SLOPe on page 858 TRIGger DELay MODE on...

Page 854: ...ets the Arm On source for arming the trigger circuitry when the oscilloscope is in the Delay trigger mode N An integer 1 4 M An integer 0 15 Digital channels are available on mixed signal oscilloscope...

Page 855: ...r DELay ARM SLOPe NEGative POSitive This command sets a positive or negative slope for arming the trigger circuitry when the oscilloscope is in the Delay trigger mode Query TRIGger DELay ARM SLOPe The...

Page 856: ...sets the event count for a Delay By Event trigger event edge_num An integer from 0 to 16 000 000 specifying the number of edges to delay Query TRIGger DELay EDELay COUNt The query returns the currentl...

Page 857: ...DIGital M This command sets the Event source for a Delay By Event trigger event N An integer 1 4 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Query TRIGger DELay EDE...

Page 858: ...Command TRIGger DELay EDELay SLOPe NEGative POSitive This command sets the trigger slope for the Delay By Event trigger event Query TRIGger DELay EDELay SLOPe The query returns the currently defined...

Page 859: ...RIGger DELay MODE Command TRIGger DELay MODE EDELay TDELay The TRIGger DELay MODE command selects the type of delay trigger mode to either events or to time Query TRIGger DELay MODE The query returns...

Page 860: ...elay This command sets the delay for a Delay By Time trigger event delay Time in seconds set for the delay trigger from 10 ns to 10 s Query TRIGger DELay TDELay TIME The query returns the currently de...

Page 861: ...el N DIGital M This command sets the Trigger On source for a Delay trigger event N An integer 1 4 M An integer 0 15 Digital channels are available on mixed signal oscilloscopes Query TRIGger DELay TRI...

Page 862: ...er SLOPe Command TRIGger DELay TRIGger SLOPe NEGative POSitive This command sets the trigger slope for the Delay trigger event Query TRIGger DELay TRIGger SLOPe The query returns the currently defined...

Page 863: ...Trigger Commands 33 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 863 Edge Trigger Commands TRIGger EDGE SLOPe on page 864 TRIGger EDGE SOURce on page 865...

Page 864: ...e of the trigger source previously selected by the TRIGger EDGE SOURce command The LINE source has no slope The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state...

Page 865: ...urce that will be used for subsequent TRIGger EDGE SLOPe commands or queries The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is bei...

Page 866: ...nt Infiniium 90000 Series Oscilloscopes Programmer s Reference 33 Trigger Commands Glitch Trigger Commands TRIGger GLITch POLarity on page 867 TRIGger GLITch SOURce on page 868 TRIGger GLITch WIDTh on...

Page 867: ...the polarity of the glitch as positive or negative The trigger source must be set using the TRIGger GLITch SOURce command The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 o...

Page 868: ...tch trigger mode The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An integer 1 4 M An integer 0 15 Digital channels...

Page 869: ...pe will trigger on a pulse that has a width less than the specified width The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being...

Page 870: ...870 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 33 Trigger Commands Pattern Trigger Commands TRIGger PATTern CONDition on page 871 TRIGger PATTern LOGic on page 872...

Page 871: ...sequential triggering is being used gt_time The minimum time greater than time for the trigger pattern from 10 ns to 9 999 s lt_time The maximum time less than time for the trigger pattern from 10 5...

Page 872: ...ected channel The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An integer 1 4 M An integer 0 15 Digital channels are...

Page 873: ...ies Oscilloscopes Programmer s Reference 873 Pulse Width Trigger Commands TRIGger PWIDth DIRection on page 874 TRIGger PWIDth POLarity on page 875 TRIGger PWIDth SOURce on page 876 TRIGger PWIDth TPOi...

Page 874: ...whether a pulse must be wider or narrower than the width value to trigger the oscilloscope The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential tr...

Page 875: ...lse the oscilloscope triggers when the rising edge of a pulse crosses the trigger level For a positive polarity pulse the oscilloscope triggers when the falling edge of a pulse crosses the trigger lev...

Page 876: ...loscope with the pulse width trigger The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An integer 1 4 M An integer 0...

Page 877: ...r at the end of the pulse or at a specified timeout period This command is only available if the pulse direction is set to GTHan The optional 1 2 parameter sets whether the trigger mode goes with the...

Page 878: ...s how wide a pulse must be to trigger the oscilloscope The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used width Pulse wi...

Page 879: ...ilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 879 Runt Trigger Commands TRIGger RUNT POLarity on page 880 TRIGger RUNT QUALified on page 881 TRIGger RUNT SOURce on page 882 TRIGger...

Page 880: ...rity of the runt pulse as positive or negative The trigger source must be set using the TRIGger RUNT SOURce command The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM...

Page 881: ...eature the polarity of the runt pulse as positive or negative The trigger source must be set using the TRIGger RUNT SOURce command The optional 1 2 parameter sets whether the trigger mode goes with th...

Page 882: ...This command sets the source for the runt trigger mode The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An integer...

Page 883: ...igger on a runt pulse that has a width greater than the specified time The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being use...

Page 884: ...ds TRIGger SEQuence TERM1 on page 885 TRIGger SEQuence TERM2 on page 886 TRIGger SEQuence RESet ENABle on page 887 TRIGger SEQuence RESet TYPE on page 888 TRIGger SEQuence RESet EVENt on page 889 TRIG...

Page 885: ...t not both 4 You can only use one long timer 30 ns Therefore trigger modes that use timers greater than 30 ns can only be used for either the Term1 state or the Term2 state but not both Some examples...

Page 886: ...ut not both 4 You can only use one long timer 30 ns Therefore trigger modes that use timers greater than 30 ns can only be used for either the Term1 state or the Term2 state but not both Some examples...

Page 887: ...mote command WAIT is used as well then the Reset timer does not start counting down until after the delay period is complete You can also base the Reset condition on a logical pattern If the specified...

Page 888: ...without triggering If the Delay feature remote command WAIT is used as well then the Reset timer does not start counting down until after the delay period is complete You can also base the Reset condi...

Page 889: ...9 TRIGger SEQuence RESet EVENt Command TRIGger SEQuence RESet EVENt CHANnel N HIGH LOW DONTcare This command defines the logical pattern used for an event Reset condition You can specify for each chan...

Page 890: ...nds TRIGger SEQuence RESet TIME Command TRIGger SEQuence RESet TIME time This command defines the length of time to use for the time based Reset condition time A length of time in seconds Query TRIGge...

Page 891: ...ON 1 OFF 0 This command turns the Delay feature on or off for the sequential trigger The Delay feature allows you to define a length of time for the sequential trigger system to wait after the TERM1 e...

Page 892: ...r Commands TRIGger SEQuence WAIT TIME Command TRIGger SEQuence WAIT TIME time This command defines the length of time to use for the Delay condition time A length of time in seconds Query TRIGger SEQu...

Page 893: ...rammer s Reference 893 Setup and Hold Trigger Commands TRIGger SHOLd CSOurce on page 894 TRIGger SHOLd CSOurce EDGE on page 895 TRIGger SHOLd DSOurce on page 896 TRIGger SHOLd HoldTIMe HTIMe on page 8...

Page 894: ...ion The clock must pass through the voltage level you have set before the trigger circuitry looks for a setup and hold time violation The optional 1 2 parameter sets whether the trigger mode goes with...

Page 895: ...on The clock must pass through the voltage level you have set before the trigger circuitry looks for a setup and hold time violation The optional 1 2 parameter sets whether the trigger mode goes with...

Page 896: ...pecify the data source for the trigger setup and hold violation The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An...

Page 897: ...hold trigger violation The hold time is the amount of time that the data must be stable and valid after a clock edge The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TE...

Page 898: ...s HOLD When using the hold time mode the waveform must not cross the threshold voltages after the specified clock edge for at least the hold time you have selected Otherwise a violation event occurs a...

Page 899: ...trigger violation The setup time is the amount of time that the data must be stable and valid before a clock edge The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2...

Page 900: ...90000 Series Oscilloscopes Programmer s Reference 33 Trigger Commands State Trigger Commands TRIGger STATe CLOCk on page 901 TRIGger STATe LOGic on page 902 TRIGger STATe LTYPe on page 903 TRIGger ST...

Page 901: ...lock waveform in the State Trigger Mode The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N An integer 1 4 M An integer...

Page 902: ...settings conflict on a channel that has been defined as the clock The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used N...

Page 903: ...input waveforms match the pattern specified by the TRIGger STATe LOGic command If the logic type is set to NAND then a trigger is generated on the edge of the clock when the input waveforms do not mat...

Page 904: ...used to generate a trigger The waveform source used for the clock is selected by using the TRIGger STATe CLOCk command The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or T...

Page 905: ...mands 33 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 905 Timeout Trigger Commands TRIGger TIMeout CONDition on page 906 TRIGger TIMeout SOURce on page 907 TRIGger TIMeout TIME...

Page 906: ...he waveform has been high for a period time longer than the time value which is set by the TRIGger TIMeout TIME command LOW Trigger when the waveform has been low for a period time longer than the tim...

Page 907: ...he channel source used to trigger the oscilloscope with the timeout trigger The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is bein...

Page 908: ...ion violations that are greater than or less than the time specified The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used...

Page 909: ...um 90000 Series Oscilloscopes Programmer s Reference 909 Transition Trigger Commands TRIGger TRANsition DIRection on page 910 TRIGger TRANsition SOURce on page 911 TRIGger TRANsition TIME on page 912...

Page 910: ...violations that are greater than or less than the time specified by the TRIGger TRANsition TIME command The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if s...

Page 911: ...a transition violation trigger by looking for any pulses in your waveform with rising or falling edges that do not cross two voltage levels in the amount of time you have specified The optional 1 2 p...

Page 912: ...s that are greater than or less than the time specified The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used time The time...

Page 913: ...u select either a rise time or fall time transition violation trigger event The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is bein...

Page 914: ...TV LINE on page 915 TRIGger TV MODE on page 916 TRIGger TV POLarity on page 917 TRIGger TV SOURce on page 918 TRIGger TV STANdard on page 919 TRIGger TV UDTV ENUMber on page 920 TRIGger TV UDTV HSYNc...

Page 915: ...number of lines specified line_number Horizontal line number as shown below Query TRIGger TV LINE The query returns the current line number Returned Format TRIGger TV LINE line_number NL Video Standa...

Page 916: ...mand TRIGger TV MODE AFIelds ALINes ALTernate FIElds1 FIElds2 LIN E The TRIGger TV MODE command determines which portion of the video waveform is used to trigger Query TRIGger TV MODE The query return...

Page 917: ...mand TRIGger TV POLarity NEGative POSitive The TRIGger TV POLarity command specifies the vertical sync pulse polarity for the selected field used during TV mode triggering Query TRIGger TV POLarity Th...

Page 918: ...ce CHANnel N The TRIGger TV SOURce command selects the source for the TV mode triggering This is the source that will be used for subsequent TRIGger TV commands and queries N An integer 1 4 Query TRIG...

Page 919: ...DTV The TRIGger TV STANdard command sets triggering to one of the standard video types There is also a user defined TV type that can be used to set the triggering to one of the non standard types of v...

Page 920: ...orizontal sync pulses to delay after arming the trigger before looking for the trigger event Specify conditions for arming the trigger using TRIGger TV UDTV PGTHan and TRIGger TV UDTV POLarity count A...

Page 921: ...ence 921 TRIGger TV UDTV HSYNc Command TRIGger TV UDTV HSYNc ON 1 OFF 0 This command enables the horizontal sync mode of triggering Query TRIGger TV UDTV HSYNc The query returns the current state of t...

Page 922: ...V HTIMe time The TRIGger TV UDTV HTIMe command sets the time that a sync pulse must be present to be considered a valid sync pulse time A real number that is the time width for the sync pulse Query TR...

Page 923: ...ger TV UDTV PGTHan Present Greater THan command specifies the minimum pulse width of the waveform used to arm the trigger used during user defined trigger mode lower_limit Minimum pulse width time fro...

Page 924: ...r TV UDTV POLarity NEGative POSitive The TRIGger TV UDTV POLarity command specifies the polarity for the sync pulse used to arm the trigger in the user defined trigger mode Query TRIGger TV UDTV POLar...

Page 925: ...t Infiniium 90000 Series Oscilloscopes Programmer s Reference 925 Window Trigger Commands TRIGger WINDow CONDition on page 926 TRIGger WINDow SOURce on page 927 TRIGger WINDow TIME on page 928 TRIGger...

Page 926: ...command describes the condition applied to the trigger window to actually generate a trigger The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential...

Page 927: ...the channel source used to trigger the oscilloscope with the window trigger The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is bein...

Page 928: ...ions that are greater than or less than the time specified The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential triggering is being used time The t...

Page 929: ...the window trigger should occur at the boundary of the window or at a specified timeout period The optional 1 2 parameter sets whether the trigger mode goes with the TERM1 or TERM2 state if sequential...

Page 930: ...930 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 33 Trigger Commands...

Page 931: ...m PREamble 965 WAVeform SEGMented ALL 970 WAVeform SEGMented COUNt 971 WAVeform SEGMented TTAG 972 WAVeform SEGMented XLISt 973 WAVeform SOURce 974 WAVeform STReaming 975 WAVeform TYPE 976 WAVeform VI...

Page 932: ...ize command to stop the oscilloscope so that all subsequent queries will be consistent Waveform Data and Preamble The waveform record consists of two parts the preamble and the waveform data The wavef...

Page 933: ...the time X axis units must be zero so the time of the first data point is the X origin Data Format for Data Transfer There are four types of data formats that you can select using the WAVeform FORMat...

Page 934: ...m the acquisition path and software filtering Returned Format WAVeform BANDpass lower_cutoff upper_cutoff NL lower_cutoff Minimum frequency passed by the acquisition system upper_cutoff Maximum freque...

Page 935: ...n myScope WriteString WAVEFORM BYTEORDER MSBFIRST Query WAVeform BYTeorder The WAVeform BYTeorder query returns the current setting for the byte order Returned Format WAVeform BYTeorder MSBFirst LSBFi...

Page 936: ...is the number of time buckets that have had the specified number of hits divided by the memory depth The hits are specified by the ACQuire AVERage COUNt command For the VERSus waveform type percent c...

Page 937: ...al RAW INTerpolate and VERSus waveform types the count value returned is one unless the data contains holes sample points where no data is acquired If the data contains holes zero is returned Returned...

Page 938: ...ring Dimension variable myScope WriteString WAVEFORM COUPLING strSetting myScope ReadString Debug Print strSetting See Also The CHANnel N INPut command sets the coupling for a particular channel You c...

Page 939: ...he size is adjusted to be the maximum available memory depth minus the start value Streaming Off The returned waveform data response depends upon the setting of the WAVeform STReaming command When the...

Page 940: ...SOURce CHANnel1 Select source myScope WriteString WAVeform FORMat WORD Select word format myScope WriteString WAVeform DATA varWavData myScope ReadIEEEBlock BinaryType_I2 Figure 6 Streaming Off N L N...

Page 941: ...es a waveform which is connected to Channel 1 include stdio h location of printf include stdlib h location of atof atoi include string h location of strlen include sicl h Prototypes int InitIO void vo...

Page 942: ...oFile BytesToRead CloseIO Function name InitIO Parameters none Return value TRUE if successful otherwise FALSE Description This routine initializes the SICL environment It sets up error handling opens...

Page 943: ...maximum number of bytes to read Return value integer which indicates the actual number of bytes read Description This routine inputs strings from the scope device session using SICL commands unsigned...

Page 944: ...ouble double buffer iscanf scope lf buffer Function name close_IO Parameters none Return value none Description This routine closes device and interface sessions for the SICL environment and calls the...

Page 945: ...ifference represented by adjacent waveform data digital codes double yOrg which is the voltage value of digital code 0 Return value none Description This routine reads the conversion factors used to c...

Page 946: ...onFactors double xInc double xOrg Read values which are used to create time values WriteIO WAVeform XINCrement ReadDouble xInc WriteIO WAVeform XORigin ReadDouble xOrg Function name WriteCsvToFile Par...

Page 947: ...ate time j j 1 Volts buff i yInc yOrg calculate voltage fprintf fp e f n Time Volts fclose fp else printf Unable to open file pairs csv n DATA Example for Digital Channels The following C example show...

Page 948: ...d void ReadDouble double buffer void CloseIO void void AcquireData void void GetTimeConversionFactors void void CreateTimeData unsigned long AcquiredLength double TimeValues void WriteCsvToFile double...

Page 949: ...5E 6 ReadWord wordData BytesToRead ReadByte Term 1L Read termination character WriteIO WAVeform FORMat BYTE Setup transfer format BytesToRead SetupDataTransfer 25E 6 25E 6 ReadByte byteData BytesToRea...

Page 950: ...ession if scope 0 printf Scope session invalid n iclose bus close interface session _siclcleanup required for 16 bit applications return FALSE itimeout scope IO_TIMEOUT set device timeout iclear scope...

Page 951: ...r buffer unsigned long BytesToRead unsigned long BytesRead 0L int reason BytesRead BytesToRead iread scope buffer BytesToRead reason BytesRead return BytesRead Function name ReadWord Parameters short...

Page 952: ...eturn value none Description This routine closes device and interface sessions for the SICL environment and calls the routine _siclclean up which de allocates resources used by the SICL environm ent v...

Page 953: ...data to read Description This routine sets up the waveform data transfer and get s the number of bytes to be read The beginning of data starts with the character followed by a number which tells how m...

Page 954: ...d BytesRead ReadByte header_str BytesToRead header_str BytesRead 0 BytesToRead atoi header_str return BytesToRead Function name GetTimeConversionFactors Parameters none Return value none Description T...

Page 955: ...ointer to an array of calculated time values unsigned short wordData which is a pointer to an arr ay of word format digital values unsigned char byteData which is a pointer to an arra y of byte format...

Page 956: ...er Description This routine takes a floating point number and create s an integer int Round double number if number 0 0f return int number 0 5f else return int number 0 5f Understanding WORD and BYTE...

Page 957: ...rent reference dc voltage The output of the comparators is converted into an 8 bit integer by the encoder All ADCs have non linearity errors which if not corrected can give less accurate vertical meas...

Page 958: ...put is controlled by Infiniium s CPU There are 65 536 dc voltage levels that are produced by the 16 bit DAC at the Aux Out At each dc voltage value the output of the ADC is checked to see if a new dig...

Page 959: ...ch as 26 188 could be produced which represents an ADC clipped value This number will vary from one oscilloscope to the next WORD and BYTE Data Formats When downloading the waveform data in WORD forma...

Page 960: ...er s Reference 34 Waveform Commands This conversion is what makes the BYTE download format less accurate than the WORD format 16 Bit Integers 8 Bit Integer Decimal Hex Hex Decimal 26 240 0x6680 Trunca...

Page 961: ...ing point engineering notation For example 8 0836E 2 8 1090E 2 3 1245E 3 In ASCii format Table 27 Selecting a Format Type Advantages Disadvantages ASCii Data is returned as voltage values and does not...

Page 962: ...matted data is transferred as signed 16 bit integers in two bytes If WAVeform BYTeorder is set to MSBFirst the most significant byte of each word is sent first If the BYTeorder is LSBFirst the least s...

Page 963: ...ASCii BINary BYTE WORD NL Example This example places the current output format for data transmission in the string variable strMode then prints the contents of the variable to the computer s screen...

Page 964: ...ted points Returned Format WAVeform POINts points NL points An integer See the ACQuire POINts command for a table of possible values Example This example places the current acquisition length in the n...

Page 965: ...model acquisition mode completion X units Y units max bandwidth limit min bandwidth limit format 0 for ASCii format 1 for BYTE format 2 for WORD format 3 for LONG format 4 for LONGLONG type Returned...

Page 966: ...uired See the WAVeform YORigin on page 987 query Y reference The Y reference is the level associated with the Y origin It is at this level that the Y origin is defined In this oscilloscope this value...

Page 967: ...he source waveform The bandwidth limit is computed as a function of the selected coupling and filter mode See the WAVeform BANDpass on page 934 query See Table 28 for descriptions of all the waveform...

Page 968: ...s zero See the WAVeform YREFerence on page 989 query Coupling The input coupling of the waveform The coupling value is ignored when sent to the oscilloscope in the preamble See the WAVeform COUPling o...

Page 969: ...ope in the preamble See the WAVeform COMPlete on page 936 query X Units The X axis units of the waveform See the WAVeform XUNits on page 984 query Y Units The Y axis units of the waveform See the WAVe...

Page 970: ...the oscilloscope or performing a Default Setup sets this command to OFF There is complete backwards compatibility when this command is set to OFF The ON setting only supports channel and pod sources...

Page 971: ...e of zero indicates that the ACQuire MODE is not set to SEGMented index_number An integer number representing the index value of the last segment Returned Format WAVeform SEGMented COUNt index_number...

Page 972: ...a_time A real number in exponential format representing the time value difference between the first segment s trigger point and the currently displayed segment Returned Format WAVeform SEGMented TTAG...

Page 973: ...uery rapidly downloads x parameter values for all segments RELXorigin relative X origin for each segment ABSXorigin relative origin time tag for each segment TTAG time tag for each segment This query...

Page 974: ...he Feed Forward Equalized FFE signal as the source POD1 is the activated digital channels in the D0 D7 set while POD2 is the activated digital channels in the D8 D15 set PODALL is all the activated di...

Page 975: ...bytes of data to be transfered from the Infiniium oscilloscope to a PC when using the WAVeform DATA query See the WAVeform DATA query for information on receiving this much data Example This example t...

Page 976: ...histogram Histograms are transferred using the LONGLONG format They can be generated using the Histogram subsystem commands HHIStogram data is a horizontal histogram Histograms are transferred using t...

Page 977: ...sponds to the first time bucket in the delayed view and the last value corresponds to the last time bucket in the delayed view Memories For memories if you specify ALL all the data in the waveform rec...

Page 978: ...nds Example This example returns the current view setting to the string variable strSetting then prints the contents of the variable to the computer s screen Dim strSetting As String Dimension variabl...

Page 979: ...it floating point number Returned Format WAVeform XDISplay value NL value A real number representing the X axis value at the left edge of the display Example This example returns the X axis value at t...

Page 980: ...Returned Format WAVeform XINCrement value NL value A real number representing the duration between data points on the X axis Example This example places the current X increment value for the currently...

Page 981: ...Returned Format WAVeform XORigin value NL value A real number representing the X axis value of the first data point in the data record Example This example places the current X origin value for the c...

Page 982: ...rned Format WAVeform XRANge value NL value A real number representing the X axis duration of the displayed waveform Example This example returns the X axis duration of the displayed waveform to the nu...

Page 983: ...cilloscope the value is always zero Returned Format WAVeform XREFerence 0 NL Example This example places the current X reference value for the currently specified source in the numeric variable varVal...

Page 984: ...ource may be a channel function or waveform memory Returned Format WAVeform XUNits UNKNown VOLT SECond CONStant AMP DECibels HERTz WATT NL Example This example returns the X axis units of the currentl...

Page 985: ...alue A real number representing the Y axis value at the center of the display Example This example returns the current Y display value to the numeric variable varValue then prints the contents of the...

Page 986: ...ent is the full scale voltage range covered by the A D converter Returned Format WAVeform YINCrement real_value NL real_value A real number in exponential format Example This example places the curren...

Page 987: ...increment Returned Format WAVeform YORigin real_value NL real_value A real number in exponential format Example This example places the current Y origin value in the numeric variable varCenter then pr...

Page 988: ...e A real number representing the Y axis duration of the displayed waveform Example This example returns the current Y range value to the numeric variable varValue then prints the contents of the varia...

Page 989: ...eform YREFerence 0 NL Example This example places the current Y reference value for the currently specified source in the numeric variable varValue then prints the contents of the variable to the comp...

Page 990: ...d source may be a channel function or waveform memory Returned Format WAVeform YUNits UNKNown VOLT SECond HITS DECibels CONStant AMP NL Example This example returns the Y axis units of the currently s...

Page 991: ...OAD 994 WMEMory N SAVE 995 WMEMory N XOFFset 996 WMEMory N XRANge 997 WMEMory N YOFFset 998 WMEMory N YRANge 999 The Waveform Memory Subsystem commands let you save and display waveforms memories and...

Page 992: ...Reference 35 Waveform Memory Commands WMEMory N CLEar Command WMEMory N CLEar The WMEMory N CLEar clears the associated wave memory N The memory number is an integer from 1 to 4 Example This example c...

Page 993: ...DISPlay command enables or disables the viewing of the selected waveform memory N The memory number is an integer from 1 to 4 Example This example turns on the waveform memory 1 display myScope WriteS...

Page 994: ...for waveforms is c Document and Settings All Users Shared Documents Infiniium Data To use a different path specify the path and file name completely N The memory number is an integer from 1 to 4 file_...

Page 995: ...hether the waveform memory is displayed or not The WAVeform VIEW command determines the view of the data being saved N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an intege...

Page 996: ...osition is referenced to center screen N The memory number is an integer from 1 to 4 offset_value A real number for the horizontal offset position value Example This example sets the X axis horizontal...

Page 997: ...orizontal scale is the horizontal range divided by 10 N The memory number is an integer from 1 to 4 range_value A real number for the horizontal range value Example This example sets the X axis horizo...

Page 998: ...e selected waveform memory N The memory number is an integer from 1 to 4 offset_value A real number for the vertical offset value Example This example sets the Y axis vertical offset of waveform memor...

Page 999: ...The vertical scale is the vertical range divided by 8 N The memory number is an integer from 1 to 4 range_value A real number for the vertical range value Example This example sets the Y axis vertica...

Page 1000: ...1000 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 35 Waveform Memory Commands...

Page 1001: ...able if any Obsolete Command Current Command Equivalent Behavior Differences MEASure CLOCk METHod see page 1002 MEASure CLOCk METHod see page 496 MEASure CLOCk METHod J TF see page 502 MEASure CLOCk M...

Page 1002: ...k METHod command sets the clock recovery method to FOPLL first order phase locked loop SOPLL second order phase locked loop EQFOPLL equalized first order phase locked loop EQSOPLL equalized second ord...

Page 1003: ...quency of the PLL damping_fact A real number used for the damping factor of the PLL baud_rate A real number used for the baud rate Example This example sets the clock recovery method to phase locked l...

Page 1004: ...m 90000 Series Oscilloscopes Programmer s Reference 36 Obsolete and Discontinued Commands myScope WriteString SYSTem HEADer OFF myScope WriteString MEASURE CLOCK METHOD strSetting myScope ReadString D...

Page 1005: ...res are enabled This command uses the Feed Forward Equalized FFE signal as the source N CHANnel N is an integer 1 4 WMEMory N is an integer 1 4 F FUNCtion F is an integer 1 16 Example This example mea...

Page 1006: ...cilloscopes Programmer s Reference 36 Obsolete and Discontinued Commands myScope WriteString SYSTEM HEADER OFF Response headers off myScope WriteString MEASURE DDPWS CHANNEL1 varValue myScope ReadNumb...

Page 1007: ...ror Numbers 1009 Command Error 1010 Execution Error 1011 Device or Oscilloscope Specific Error 1012 Query Error 1013 List of Error Messages 1014 This chapter describes the error messages and how they...

Page 1008: ...arded The length of the oscilloscope s error queue is 30 29 positions for the error messages and 1 position for the Queue overflow message Reading an error from the head of the queue removes that erro...

Page 1009: ...he type of error that is detected 0 indicates no errors were detected 100 to 199 indicates a command error was detected 200 to 299 indicates an execution error was detected 300 to 399 indicates a devi...

Page 1010: ...by the parser That is a computer to oscilloscope message was received that is in violation of the IEEE 488 2 standard This may be a data element that violates the oscilloscope s listening formats or a...

Page 1011: ...e of the following events occurred The program data following a header is outside the legal input range or is inconsistent with the oscilloscope s capabilities A valid program message could not be pro...

Page 1012: ...s that the instrument has detected an error caused by an oscilloscope operation that did not properly complete This may be due to an abnormal hardware or firmware condition For example this error may...

Page 1013: ...trument has detected a problem with the message exchange protocol An occurrence of any error in this class should cause the query error bit bit 2 in the event status register to be set An occurrence o...

Page 1014: ...d for the header 109 Missing parameter Fewer parameters were received than required for the header 112 Program mnemonic too long The header or character data element contains more than twelve characte...

Page 1015: ...ment was encountered but was not allowed by the oscilloscope at this point in parsing 170 Expression error This error can be generated when parsing an expression data element It is used if the oscillo...

Page 1016: ...m error Indicates that a system error occurred 311 Memory error 312 PUD memory error 313 Calibration memory lost 314 Save recall memory lost 315 Configuration memory lost 321 Out of memory 330 Self te...

Page 1017: ...test log file could not be found 375 Attenuator relay actuation counts can only be modified during factory service 400 Query error This is the generic query error 410 Query INTERRUPTED 420 Query UNTE...

Page 1018: ...1018 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 37 Error Messages...

Page 1019: ...copes Programmer s Reference 38 Sample Programs VISA COM Examples 1020 VISA Examples 1059 SICL Examples 1110 SCPI NET Examples 1129 Example programs are ASCII text files that can be cut from the help...

Page 1020: ...brary a Choose Tools References from the main menu b In the References dialog check VISA COM 3 0 Type Library Microsoft Scripting Runtime c Click OK 4 Choose Insert Module 5 Cut and paste the code tha...

Page 1021: ...Clear Clear the interface Initialize start from a known state Initialize Capture data Capture Analyze the captured waveform Analyze Exit Sub VisaComError MsgBox VISA COM Error vbCrLf Err Description E...

Page 1022: ...QueryString TRIGger EDGE SOURce DoCommand TRIGger LEVel CHANnel1 2E 3 Debug Print Trigger level channel 1 _ DoQueryString TRIGger LEVel CHANnel1 DoCommand TRIGger EDGE SLOPe POSitive Debug Print Trigg...

Page 1023: ...saved setup Dim varSetupString As Variant strPath c scope config setup dat Open strPath For Binary Access Read As hFile Open file for input Get hFile varSetupString Read data Close hFile Close file Wr...

Page 1024: ...trPath Then Kill strPath Remove file if it exists End If Dim hFile As Long hFile FreeFile Open strPath For Binary Access Write Lock Write As hFile Put hFile byteData Write data Close hFile Close file...

Page 1025: ...Double Dim dblMinBwLimit As Double Dim dctWavFormat As Scripting Dictionary Set dctWavFormat New Scripting Dictionary dctWavFormat Add 0 ASCii dctWavFormat Add 1 BYTE dctWavFormat Add 2 WORD dctWavFor...

Page 1026: ...13 dblYDispOrigin Preamble 14 strDate Preamble 15 strTime Preamble 16 strFrameModel Preamble 17 intAcqMode Preamble 18 intCompletion Preamble 19 intXUnits Preamble 20 intYUnits Preamble 21 dblMaxBwLim...

Page 1027: ...Mode Debug Print Completion pct _ FormatNumber intCompletion 0 Debug Print Waveform X units dctUnits Item intXUnits Debug Print Waveform Y units dctUnits Item intYUnits Debug Print Max BW limit _ Form...

Page 1028: ...oTo VisaComError myScope WriteString command CheckInstrumentErrors Exit Sub VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End En...

Page 1029: ...oQueryNumber myScope ReadNumber CheckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End End Functi...

Page 1030: ...ckInstrumentErrors Exit Function VisaComError MsgBox VISA COM Error vbCrLf CStr Err Number _ Err Source _ Err Description vbExclamation VISA COM Error End End Function Private Sub CheckInstrumentError...

Page 1031: ...olution in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add Reference c In the Add Reference dialog select the COM tab d Select VISA COM 3 0 Type Library then click...

Page 1032: ...WriteLine VISA COM Error err Message catch System SystemException err Console WriteLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Conso...

Page 1033: ...HANnel1 myScope DoCommand TRIGger EDGE SLOPe POSitive Console WriteLine Trigger edge slope 0 myScope DoQueryString TRIGger EDGE SLOPe Save oscilloscope setup byte ResultsArray Results array int nLengt...

Page 1034: ...myScope DoCommandIEEEBlock SYSTem SETup DataArray Console WriteLine Setup bytes restored 0 nBytesWritten Set the desired number of waveform points and capture an acquisition myScope DoCommand ACQuire...

Page 1035: ...ring WAVeform TYPE Get the number of waveform points Console WriteLine Waveform points 0 myScope DoQueryString WAVeform POINts Set the waveform source myScope DoCommand WAVeform SOURce CHANnel1 Consol...

Page 1036: ...Console WriteLine Waveform average count 0 strsPreamble 3 Console WriteLine Waveform X increment 0 strsPreamble 4 Console WriteLine Waveform X origin 0 strsPreamble 5 Console WriteLine Waveform X ref...

Page 1037: ...YORigin Get the waveform data myScope DoCommand WAVeform STReaming OFF short WordDataArray Results array WordDataArray myScope DoQueryIEEEBlock_I2 WAVeform DATA nLength WordDataArray Length Console Wr...

Page 1038: ...to the device m_IoObject WriteIEEEBlock strCommand DataArray true Check for inst errors CheckInstrumentErrors strCommand public string DoQueryString string strQuery Send the query m_IoObject WriteStr...

Page 1039: ...uery m_IoObject WriteString strQuery true Get the results array System Threading Thread Sleep 2000 Delay before reading byte ResultsArray ResultsArray byte m_IoObject ReadIEEEBlock IEEEBinaryType Bina...

Page 1040: ...bFirstError Console WriteLine ERROR s for command 0 strCommand bFirstError false Console Write strInstrumentError while strInstrumentError ToString StartsWith 0 private void OpenIo m_ResourceManager...

Page 1041: ...n in the Solution Explorer window of the Microsoft Visual Studio environment b Choose Add Reference c In the Add Reference dialog select the COM tab d Select VISA COM 3 0 Type Library then click OK e...

Page 1042: ...ionException Console WriteLine VISA Error Message err Message Catch err As System SystemException Console WriteLine System Error Message err Message Catch err As System Exception System Diagnostics De...

Page 1043: ...slope 0 _ myScope DoQueryString TRIGger EDGE SLOPe Save oscilloscope configuration Dim ResultsArray As Byte Results array Dim nLength As Integer Number of bytes returned from inst Dim strPath As Stri...

Page 1044: ...taArray Console WriteLine Setup bytes restored 0 nBytesWritten Set the desired number of waveform points and capture an acquisition myScope DoCommand ACQuire POINts 32000 myScope DoCommand DIGitize En...

Page 1045: ...urce myScope DoCommand WAVeform SOURce CHANnel1 Console WriteLine Waveform source 0 _ myScope DoQueryString WAVeform SOURce Choose the format of the data returned myScope DoCommand WAVeform FORMat WOR...

Page 1046: ...eamble 6 Console WriteLine Waveform Y increment 0 strsPreamble 7 Console WriteLine Waveform Y origin 0 strsPreamble 8 Console WriteLine Waveform Y reference 0 strsPreamble 9 Console WriteLine Coupling...

Page 1047: ...sts strPath Then File Delete strPath End If Open file for output Dim writer As StreamWriter File CreateText strPath Output waveform data in CSV format For index As Integer 0 To nLength 1 Write time va...

Page 1048: ...tion DoQueryString ByVal strQuery As String As String Send the query m_IoObject WriteString strQuery True Get the result string Dim strResults As String strResults m_IoObject ReadString Check for inst...

Page 1049: ...Dim ResultsArray As Byte ResultsArray _ m_IoObject ReadIEEEBlock IEEEBinaryType BinaryType_UI1 _ False True Check for inst errors CheckInstrumentErrors strQuery Return results array Return ResultsArra...

Page 1050: ...rror ToString StartsWith 0 End Sub Private Sub OpenIo m_ResourceManager New ResourceManagerClass m_IoObject New FormattedIO488Class Open the default VISA COM IO object Try m_IoObject IO _ DirectCast m...

Page 1051: ...ariable open a Command Prompt window then change to the folder that contains the example py file and enter python example py Agilent VISA COM Example in Python using comtypes This program illustrates...

Page 1052: ...lt do_query_string TRIGger EDGE SOURce print Trigger edge source s qresult do_command TRIGger LEVel CHANnel1 2E 3 qresult do_query_string TRIGger LEVel CHANnel1 print Trigger level channel 1 s qresult...

Page 1053: ...up_bytes print Setup bytes restored d len setup_bytes Set the desired number of waveform points and capture an acquisition do_command ACQuire POINts 32000 do_command DIGitize Analyze def analyze Make...

Page 1054: ...rint Waveform source s qresult Choose the format of the data returned do_command WAVeform FORMat WORD print Waveform format s do_query_string WAVeform FORMat Display the waveform settings from preambl...

Page 1055: ...aveform Y display range s y_display_range print Waveform Y display origin s y_display_origin print Date s date print Time s time print Frame model s frame_model print Acquire mode s acq_mode_dict int...

Page 1056: ...ring check_instrument_errors query return result Send a query check for errors return string def do_query_ieee_block_UI1 query myScope WriteString s query True result myScope ReadIEEEBlock VisaComLib...

Page 1057: ...error print ERROR s command s error_string command print Exited because of error sys exit 1 else No error break else SYSTem ERRor STRing should always return string print ERROR SYSTem ERRor STRing re...

Page 1058: ...1058 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 38 Sample Programs initialize capture analyze print End of program...

Page 1059: ...xample c file and click Add 6 Edit the program to use the VISA address of your oscilloscope 7 Choose Project Properties In the Property Pages dialog update these project settings a Under Configuration...

Page 1060: ...ieeeblock char query Query for IEEE byte block int do_query_ieeeblock_words char query Query for word block void check_instrument_errors Check for inst errors void error_handler VISA error handler Glo...

Page 1061: ...N printf Oscilloscope IDN string s n str_result Load the default setup do_command RST Capture the waveform void capture void int num_values FILE fp Set probe attenuation factor do_command CHANnel1 PRO...

Page 1062: ...vertical scale and offset do_command CHANnel1 SCALe 0 1 do_query_string CHANnel1 SCALe printf Channel 1 vertical scale s n str_result do_command CHANnel1 OFFSet 0 0 do_query_string CHANnel1 OFFSet pr...

Page 1063: ...turned from instrument int i Make measurements do_command MEASure SOURce CHANnel1 do_query_string MEASure SOURce printf Measure source s n str_result do_command MEASure FREQuency do_query_number MEASu...

Page 1064: ...crement num_result printf Waveform X increment e n x_increment do_query_number WAVeform XORigin x_origin num_result printf Waveform X origin e n x_origin do_query_number WAVeform YINCrement y_incremen...

Page 1065: ...d num_bytes char command int num_bytes char message 80 int data_length strcpy message command strcat message 8 08d err viPrintf vi message num_bytes if err VI_SUCCESS error_handler err viBufWrite vi i...

Page 1066: ...uery_numbers query char query char message 80 strcpy message query strcat message n err viPrintf vi message if err VI_SUCCESS error_handler err viScanf vi 10lf n dbl_results if err VI_SUCCESS error_ha...

Page 1067: ...gth IEEEBLOCK_SPACE err viScanf vi hb n data_length ieeeblock_data_words if err VI_SUCCESS error_handler if data_length IEEEBLOCK_SPACE printf IEEE block buffer full printf May not have received all d...

Page 1068: ...LT 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 Libraries Suite and foun...

Page 1069: ...strQueryResult As String 200 For Sleep subroutine Private Declare Sub Sleep Lib kernel32 ByVal dwMilliseconds As Long Main Program Sub Main Open the default resource manager session err viOpenDefault...

Page 1070: ...DoQueryString CHANnel1 PROBe Use auto scale to automatically configure oscilloscope DoCommand AUToscale Set trigger mode EDGE PULSe PATTern etc and input source DoCommand TRIGger MODE EDGE Debug Prin...

Page 1071: ...eryString CHANnel1 SCALe DoCommand CHANnel1 OFFSet 0 0 Debug Print Channel 1 vertical offset _ DoQueryString CHANnel1 OFFSet Set horizontal scale and position DoCommand TIMebase SCALe 0 0002 Debug Pri...

Page 1072: ...matNumber dblQueryResult 1000 4 kHz DoCommand MEASure VAMPlitude dblQueryResult DoQueryNumber MEASure VAMPlitude MsgBox Vertical amplitude vbCrLf _ FormatNumber dblQueryResult 4 V Download the screen...

Page 1073: ...Increment As Double Dim dblYOrigin As Double dblXIncrement DoQueryNumber WAVeform XINCrement Debug Print Waveform X increment _ Format dblXIncrement Scientific dblXOrigin DoQueryNumber WAVeform XORigi...

Page 1074: ...I_SUCCESS Then HandleVISAError vi CheckInstrumentErrors End Sub Private Function DoCommandIEEEBlock command As String _ lngBlockSize As Long retCount lngBlockSize Dim strCommandAndLength As String str...

Page 1075: ...Set up paramsArray for multiple parameter query returning array paramsArray 0 VarPtr retCount paramsArray 1 VarPtr dblArray 0 Set retCount to max number of elements array can hold retCount DblArraySi...

Page 1076: ...SUCCESS Then HandleVISAError vi Set up paramsArray for multiple parameter query returning array paramsArray 0 VarPtr retCount paramsArray 1 VarPtr wordArray 0 Set retCount to max number of elements ar...

Page 1077: ...al Read error message If err VI_SUCCESS Then HandleVISAError vi Wend If Not strOut Then MsgBox strOut vbExclamation INST Error Messages err viFlush vi VI_READ_BUF If err VI_SUCCESS Then HandleVISAErro...

Page 1078: ...Libraries Suite and found in the Program Files IVI Foundation VISA WinNT include directory select it but do not click the Open button d Click the down arrow to the right of the Add button and choose...

Page 1079: ...err Message catch System SystemException err Console WriteLine System Error Message err Message catch System Exception err System Diagnostics Debug Fail Unexpected Error Console WriteLine Unexpected E...

Page 1080: ...CHANnel1 myScope DoCommand TRIGger EDGE SLOPe POSitive Console WriteLine Trigger edge slope 0 myScope DoQueryString TRIGger EDGE SLOPe Save oscilloscope configuration byte ResultsArray Results array...

Page 1081: ...lock SYSTem SETup DataArray Console WriteLine Setup bytes restored 0 nBytesWritten Set the desired number of waveform points and capture an acquisition myScope DoCommand ACQuire POINts 32000 myScope D...

Page 1082: ...String WAVeform TYPE Get the number of waveform points Console WriteLine Waveform points 0 myScope DoQueryString WAVeform POINts Set the waveform source myScope DoCommand WAVeform SOURce CHANnel1 Cons...

Page 1083: ...ints 0 strsPreamble 2 Console WriteLine Waveform average count 0 strsPreamble 3 Console WriteLine Waveform X increment 0 strsPreamble 4 Console WriteLine Waveform X origin 0 strsPreamble 5 Console Wri...

Page 1084: ...fYorigin myScope DoQueryNumber WAVeform YORigin Get the waveform data myScope DoCommand WAVeform STReaming OFF nLength myScope DoQueryIEEEBlock_Words WAVeform DATA out WordResultsArray Console WriteL...

Page 1085: ...strCommandAndLength int nViStatus nLength nBytesWritten nLength DataArray Length strCommandAndLength String Format 0 8 08d strCommand Write first part of command to formatted I O write buffer nViStat...

Page 1086: ...ouble DoQueryNumbers string strQuery Send the query VisaSendCommandOrQuery strQuery Get the result string double fResultsArray fResultsArray VisaGetResultNumbers Check for inst errors CheckInstrumentE...

Page 1087: ...String Format 0 n strCommandOrQuery int nViStatus nViStatus visa32 viPrintf m_nSession strWithNewline CheckVisaStatus nViStatus private StringBuilder VisaGetResultString StringBuilder strResults new S...

Page 1088: ...ed after IEEE block nViStatus visa32 viFlush m_nSession visa32 VI_WRITE_BUF CheckVisaStatus nViStatus nViStatus visa32 viFlush m_nSession visa32 VI_READ_BUF CheckVisaStatus nViStatus return length pri...

Page 1089: ...while strInstrumentError ToString StartsWith 0 private void OpenResourceManager int nViStatus nViStatus visa32 viOpenDefaultRM out this m_nResourceManager if nViStatus visa32 VI_SUCCESS throw new Appl...

Page 1090: ...le to your project 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 and then choose Add Existing It...

Page 1091: ...s 10 Initialize start from a known state Initialize Capture data Capture Analyze the captured waveform Analyze Catch err As System ApplicationException Console WriteLine VISA Error Message err Message...

Page 1092: ...ueryString TRIGger EDGE SOURce myScope DoCommand TRIGger LEVel CHANnel1 2E 3 Console WriteLine Trigger edge level 0 _ myScope DoQueryString TRIGger LEVel CHANnel1 myScope DoCommand TRIGger EDGE SLOPe...

Page 1093: ...yScope DoQueryString ACQuire MODE Or set up by loading a previously saved setup Dim DataArray As Byte Dim nBytesWritten As Integer Read setup string from file strPath c scope config setup stp DataArra...

Page 1094: ...m Close Console WriteLine Screen image 0 bytes written to 1 _ nLength strPath Download waveform data Get the waveform type Console WriteLine Waveform type 0 _ myScope DoQueryString WAVeform TYPE Get t...

Page 1095: ...trsPreamble strPreamble Split c Console WriteLine Waveform format 0 _ dctWavFormat strsPreamble 0 Console WriteLine Acquire type 0 _ dctAcqType strsPreamble 1 Console WriteLine Waveform points 0 strsP...

Page 1096: ...ble fYincrement myScope DoQueryNumber WAVeform YINCrement Dim fYorigin As Double fYorigin myScope DoQueryNumber WAVeform YORigin Get the waveform data myScope DoCommand WAVeform STReaming OFF nLength...

Page 1097: ...nstrumentErrors strCommand End Sub Public Function DoCommandIEEEBlock ByVal strCommand As String _ ByVal DataArray As Byte As Integer Send the command to the device Dim strCommandAndLength As String D...

Page 1098: ...for inst errors CheckInstrumentErrors strQuery Return string results Return fResults End Function Public Function DoQueryNumbers ByVal strQuery As String _ As Double Send the query VisaSendCommandOrQ...

Page 1099: ...rQuery _ As String Send command or query to the device Dim strWithNewline As String strWithNewline String Format 0 Chr 10 _ strCommandOrQuery Dim nViStatus As Integer nViStatus visa32 viPrintf m_nSess...

Page 1100: ...32 viScanf m_nSession b length _ ResultsArray CheckVisaStatus nViStatus Write and read buffers need to be flushed after IEEE block nViStatus visa32 viFlush m_nSession visa32 VI_WRITE_BUF CheckVisaStat...

Page 1101: ...End Sub Private Sub OpenResourceManager Dim nViStatus As Integer nViStatus visa32 viOpenDefaultRM Me m_nResourceManager If nViStatus visa32 VI_SUCCESS Then Throw New _ ApplicationException Failed to...

Page 1102: ...http www python org and http pyvisa sourceforge net respectively To run this example with Python and PyVISA 1 Cut and paste the code that follows into a file named example py 2 Edit the program to us...

Page 1103: ...rint Trigger mode s qresult Set EDGE trigger parameters do_command TRIGger EDGE SOURCe CHANnel1 qresult do_query_string TRIGger EDGE SOURce print Trigger edge source s qresult do_command TRIGger LEVel...

Page 1104: ...ously saved setup sSetup f open setup stp rb sSetup f read f close do_command SYSTem SETup 8 08d s len sSetup sSetup hide_param s True print Setup bytes restored d len sSetup Set the desired number of...

Page 1105: ...Veform POINts print Waveform points s qresult Set the waveform source do_command WAVeform SOURce CHANnel1 qresult do_query_string WAVeform SOURce print Waveform source s qresult Choose the format of t...

Page 1106: ...print Coupling s coupling_dict int coupling print Waveform X display range s x_display_range print Waveform X display origin s x_display_origin print Waveform Y display range s y_display_range print W...

Page 1107: ...t command 1 if debug print nCmd s header else if debug print nCmd s command Infiniium write s n command if hide_params check_instrument_errors header else check_instrument_errors command Send a query...

Page 1108: ...mmand print Exited because of error sys exit 1 Returns data from definite length block def get_definite_length_block_data sBlock First character should be pound sBlock 0 1 if pound print PROBLEM Inval...

Page 1109: ...Sample Programs 38 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 1109 print End of program...

Page 1110: ...operties In the Property Pages dialog update these project settings a Under Configuration Properties Linker Input add sicl32 lib to the Additional Dependencies field b Under Configuration Properties C...

Page 1111: ...s int do_query_ieeeblock char query Query for IEEE block int do_query_ieeeblock_words char query Query for word data void check_instrument_errors Check for inst errors Global variables INST id Device...

Page 1112: ...o release resources allocated by SICL for this application This call is a no op for WIN32 programs _siclcleanup Initialize the oscilloscope to a known state void initialize void Clear status do_comman...

Page 1113: ...SYSTem SETup printf Read setup string query d bytes n num_values Write setup string to file fp fopen c scope config setup stp wb num_values fwrite ieeeblock_data sizeof unsigned char num_values fp fcl...

Page 1114: ...n num_values Set the desired number of waveform points and capture an acquisition do_command ACQuire POINts 32000 do_command DIGitize Analyze the captured waveform void analyze void double wav_format...

Page 1115: ...form source do_command WAVeform SOURce CHANnel1 do_query_string WAVeform SOURce printf Waveform source s n str_result Choose the format of the data returned do_command WAVeform FORMat WORD do_query_st...

Page 1116: ...a csv n Send a command to the instrument void do_command command char command char message 80 strcpy message command strcat message n iprintf id message check_instrument_errors Command with IEEE defin...

Page 1117: ...iscanf id lf num_result check_instrument_errors Query for numbers result void do_query_numbers query char query char message 80 strcpy message query strcat message n iprintf id message iscanf id 10lf...

Page 1118: ...ntf id message data_length IEEEBLOCK_SPACE iscanf id wb data_length ieeeblock_data_words if data_length IEEEBLOCK_SPACE printf IEEE block buffer full printf May not have received all data n check_inst...

Page 1119: ...paste the code that follows into the editor 6 Edit the program to use the SICL address of your oscilloscope and save the changes 7 Run the program Agilent SICL Example in Visual Basic This program ill...

Page 1120: ...m Analyze Close the vi session and the resource manager session Call iclose id Exit Sub ErrorHandler MsgBox Error Error vbExclamation End End Sub Initialize the oscilloscope to a known state Private S...

Page 1121: ...r LEVel CHANnel1 2E 3 Debug Print Trigger level channel 1 _ DoQueryString TRIGger LEVel CHANnel1 DoCommand TRIGger EDGE SLOPe POSitive Debug Print Trigger edge slope _ DoQueryString TRIGger EDGE SLOPe...

Page 1122: ...mmand ACQuire MODE RTIMe Debug Print Acquire mode _ DoQueryString ACQuire MODE Or configure by loading a previously saved setup strPath c scope config setup dat Open strPath For Binary Access Read As...

Page 1123: ...reen image Dim lngBlockSize As Long lngBlockSize DoQueryIEEEBlock_Bytes DISPlay DATA PNG Debug Print Screen image bytes CStr lngBlockSize Save screen image to a file Dim strPath As String strPath c sc...

Page 1124: ...ueryNumber WAVeform YINCrement Debug Print Waveform Y increment _ Format dblYIncrement Scientific dblYOrigin DoQueryNumber WAVeform YORigin Debug Print Waveform Y origin _ FormatNumber dblYOrigin 0 Ge...

Page 1125: ...r vbExclamation End End Sub Private Sub DoCommand command As String On Error GoTo ErrorHandler Call ivprintf id command vbLf CheckInstrumentErrors Exit Sub ErrorHandler MsgBox Error Error vbExclamatio...

Page 1126: ...g strResult CheckInstrumentErrors Exit Function ErrorHandler MsgBox Error Error vbExclamation End End Function Private Function DoQueryNumber query As String As Double On Error GoTo ErrorHandler Dim d...

Page 1127: ...byteArray ByteArraySize vbNull retCount Get number of block length digits Dim intLengthDigits As Integer intLengthDigits CInt Chr byteArray 1 Get block length from those digits Dim strBlockLength As S...

Page 1128: ...um Error String While Val strErrVal 0 End if find 0 No Error strOut strOut INST Error strErrVal Call ivprintf id SYSTem ERRor STRing vbLf Request error me ssage Call ivscanf id 200t strErrVal Read err...

Page 1129: ...EW Microsoft Excel Agilent VEE and Agilent SystemVue For more information on Agilent Command Expert and to download the software see http www agilent com find commandexpert SCPI NET Example in C on pa...

Page 1130: ...ming features of your Agilent oscilloscope using System using System IO using System Text using System Collections Generic using Agilent CommandExpert ScpiNet AgInfiniium90000_3_10 namespace Infiniium...

Page 1131: ...to a known state private static void Initialize string strResults Get and display the device s IDN string myScope SCPI IDN Query out strResults Console WriteLine IDN result is 0 strResults Clear stat...

Page 1132: ...etup string myScope SCPI SYSTem SETup Query out byteResultsArray nLength byteResultsArray Length Write setup string to file strPath c scope config setup stp FileStream fStream File Open strPath FileMo...

Page 1133: ...ray Results array string strResults double fResult Make measurements myScope SCPI MEASure SOURce Command CHANnel1 null myScope SCPI MEASure SOURce Queryx out strResultsArray Console WriteLine Measure...

Page 1134: ...s 0 nPointsAvail Set the waveform source myScope SCPI WAVeform SOURce Command CHANnel1 myScope SCPI WAVeform SOURce Query out strResults Console WriteLine Waveform source 0 strResults Choose the forma...

Page 1135: ...2 Console WriteLine Waveform average count 0 strsPreamble 3 Console WriteLine Waveform X increment 0 strsPreamble 4 Console WriteLine Waveform X origin 0 strsPreamble 5 Console WriteLine Waveform X re...

Page 1136: ...yScope SCPI WAVeform YINCrement Query out fYincrement double fYorigin myScope SCPI WAVeform YORigin Query out fYorigin Get the waveform data myScope SCPI WAVeform STReaming Command false short WordDat...

Page 1137: ...og select the Browse tab and navigate to the ScpiNetDrivers folder Windows XP C Documents and Settings All Users Agilent Command Expert ScpiNetDrivers Windows 7 C ProgramData Agilent Command Expert Sc...

Page 1138: ...data Capture Analyze the captured waveform Analyze Console WriteLine Press any key to exit Console ReadKey Catch err As System ApplicationException Console WriteLine SCPI NET Error err Message Catch e...

Page 1139: ...0 strResults myScope SCPI TRIGger LEVel Command CHANnel1 0 002 myScope SCPI TRIGger LEVel Query CHANnel1 fResult Console WriteLine Trigger edge level 0 F2 fResult myScope SCPI TRIGger EDGE SLOPe Comm...

Page 1140: ...Dim nBytesWritten As Integer Read setup string from file strPath c scope config setup stp DataArray File ReadAllBytes strPath nBytesWritten DataArray Length Restore setup string myScope SCPI SYSTem SE...

Page 1141: ...h fStream Close Console WriteLine Screen image 0 bytes written to 1 _ nLength strPath Download waveform data Get the waveform points mode myScope SCPI WAVeform TYPE Query strResults Console WriteLine...

Page 1142: ...Add 2 SECOND dctUnits Add 3 CONSTANT dctUnits Add 4 AMP dctUnits Add 5 DECIBEL Dim strPreamble As String Dim strsPreamble As String myScope SCPI WAVeform PREamble Query strPreamble strsPreamble strPr...

Page 1143: ...XINCrement Query fXincrement Dim fXorigin As Double myScope SCPI WAVeform XORigin Query fXorigin Dim fYincrement As Double myScope SCPI WAVeform YINCrement Query fYincrement Dim fYorigin As Double myS...

Page 1144: ...m to use the address of your oscilloscope 4 If the IronPython ipy exe can be found via your PATH environment variable open a Command Prompt window then change to the folder that contains the example p...

Page 1145: ...GE trigger parameters scope SCPI TRIGger EDGE SOURce Command None CHANnel1 qresult scope SCPI TRIGger EDGE SOURce Query None print Trigger edge source s qresult scope SCPI TRIGger LEVel Command CHANne...

Page 1146: ...tion scope SCPI ACQuire POINts Command 32000 scope SCPI DIGitize Command None Analyze def analyze Make measurements scope SCPI MEASure SOURce Command CHANnel1 None source_list scope SCPI MEASure SOURc...

Page 1147: ...veform source s qresult Choose the format of the data returned scope SCPI WAVeform FORMat Command WORD qresult scope SCPI WAVeform FORMat Query print Waveform format s qresult scope SCPI WAVeform BYTe...

Page 1148: ...display range s x_display_range print Waveform X display origin s x_display_origin print Waveform Y display range s y_display_range print Waveform Y display origin s y_display_origin print Date s dat...

Page 1149: ...D data written to s strPath Main program addr labi trex lp11 cos agilent com addr TCPIP0 labi trex lp11 cos agilent com inst0 INSTR scope AgInfiniium90000 addr scope Transport DefaultTimeout Set 10000...

Page 1150: ...1150 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 38 Sample Programs...

Page 1151: ...s1 1151 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference 39 Reference HDF5 Example 1152 CSV and TSV Header Format 1153 BIN Header Format 1155...

Page 1152: ...d HDF5 file Channel 1 6576 Group Size 1 Number of Attributes 17 Waveform Type 1 Start 1 NumPoints 1000000 NumSegments 0 Count 1 XDispRange 1 0E 6 XDispOrigin 5 0E 7 XInc 5 0E 11 XOrg 2 4999999E 5 XUni...

Page 1153: ...umber of sources being stored The X display range is the X axis duration of the waveform that is displayed For time domain waveforms it is the duration of time across the display If the value is zero...

Page 1154: ...uired YOrg The number of Y origin columns n depends on the number of sources being store The Y origin is the Y axis value at level zero For voltage waveforms it is the voltage at level zero If the val...

Page 1155: ...bytes that are in the file Number of Waveforms An integer 4 byte signed which is the number of waveforms that are stored in the file Waveform Header The waveform header contains information about the...

Page 1156: ...me at the start of the display This value is treated as a double precision 64 bit floating point number If the value is zero then no data has been acquired X Increment A double 8 bytes which is the du...

Page 1157: ...e signed which is the segment index of the data that follows the waveform data header Waveform Data Header The waveform data header consists of information about the waveform data points that are stor...

Page 1158: ...location of atof atoi include string h location of strlen include sicl h Defines define MAX_LENGTH 10000000 define INTERFACE lan 130 29 70 247 inst0 Change the IP address to the one found in the Remo...

Page 1159: ...E_STRING_LENGTH char Time DATE_TIME_STRING_LENGTH char Frame FRAME_STRING_LENGTH char WaveformLabel SIGNAL_STRING_LENGTH double TimeTag unsigned int SegmentIndex WaveformHeader typedef struct int Head...

Page 1160: ...LENGTH float MaxVolts MAX_LENGTH float MinVolts MAX_LENGTH UINT64 HistogramData MAX_LENGTH int main int argc char argv FileHeader fileHeader WaveformHeader waveformHeader if argc 1 InputFile fopen arg...

Page 1161: ...double xOrg which is the time value of the first data point Return value none Description This routine transfers the waveform conversion factors for the time values void GetTimeConversionFactors Wave...

Page 1162: ...olts i if BytesRead MAX_LENGTH done TRUE Function name OutputHistogramWaveform Parameters WaveformHeader waveformHeader which is a structure that contains the waveform header information Return value...

Page 1163: ...ataHeader waveformDataHeader int done FALSE size_t BytesRead 0L int NumberToRead NumberToRead waveformDataHeader BufferSize while done BytesRead fread char Volts 1 NumberToRead InputFile BytesRead fwr...

Page 1164: ...BufferType PB_DATA_MAX OutputData MaxFile waveformDataHeader OutputData MinFile waveformDataHeader else OutputData MinFile waveformDataHeader OutputData MaxFile waveformDataHeader fclose MaxFile fclo...

Page 1165: ...CHANnel N ISIM BWLimit command query 204 CHANnel N ISIM CONVolve command query 205 CHANnel N ISIM CORRection command query 206 CHANnel N ISIM DEConvolve command query 208 CHANnel N ISIM DELay command...

Page 1166: ...mand query 374 HISTogram SCALe SIZE command query 375 HISTogram WINDow BLIMit command query 380 HISTogram WINDow DEFault command 376 HISTogram WINDow LLIMit command query 378 HISTogram WINDow RLIMit c...

Page 1167: ...ation command query 584 MEASure NOISe METHod command query 585 MEASure NOISe REPort command query 586 MEASure NOISe RN command query 587 MEASure NOISe SCOPe RN command query 588 MEASure NOISe STATe co...

Page 1168: ...ry 750 SBUS N SPI SOURce DATA command query 751 SBUS N SPI SOURce FRAMe command query 752 SBUS N SPI SOURce MISO command query 753 SBUS N SPI SOURce MOSI command query 754 SBUS N SPI TYPE command quer...

Page 1169: ...Quence RESet ENABle command query 887 TRIGger SEQuence RESet EVENt command 889 TRIGger SEQuence RESet TIME command query 890 TRIGger SEQuence RESet TYPE command query 888 TRIGger SEQuence TERM1 comman...

Page 1170: ...e RJDJ ALL query 618 ALL MEASure RJDJ APLength query 620 alphanumeric characters in embedded string 68 alphanumeric strings 66 AMASk MTESt AMASk CREate command 434 AMASk MTESt AMASk SAVE command 436 A...

Page 1171: ...CLEar BUS N CLEar command query 179 CLEar MEASure CLEar command 494 CLEar WMEMory N CLEar command 992 Clearing Buffers 98 clearing DONE bit 119 clearing error queue 123 1008 Clearing Pending Commands...

Page 1172: ...command query 894 CSOurce TRIGger SHOLd CSOurce EDGE command query 895 CTCDutycycle MEASure CTCDutycycle command query 510 CTCJitter MEASure CTCJitter command query 512 CTCNwidth MEASure CTCNwidth co...

Page 1173: ...64 DIGital ACQuire SRATe DIGital command query 173 DIGital ACQuire SRATe DIGital AUTO command query 174 Digitize Aborting 98 DIGitize setting up for execution 147 DIRection TRIGger PWIDth DIRection co...

Page 1174: ...PRocessing FFEQualizer NTAPs command query 790 FFEQualizer SPRocessing FFEQualizer SOURce command query 788 FFEQualizer SPRocessing FFEQualizer TAP command query 792 FFEQualizer SPRocessing FFEQualize...

Page 1175: ...ommand query 544 HOLDoff TRIGger HOLDoff command query 836 HOLDoff TRIGger HOLDoff MAX command query 837 HOLDoff TRIGger HOLDoff MIN command query 838 HOLDoff TRIGger HOLDoff MODE command query 839 Ho...

Page 1176: ...74 JITTer MEASure JITTer TRENd VERTical OFFSet command query 575 JITTer MEASure JITTer TRENd VERTical RANGe command query 576 JITTer STORe JITTer command 732 JTF MEASure CLOCk METHod JTF command query...

Page 1177: ...MODE HISTogram MODE command query 374 MODE ISCan MODE command query 389 MODE ISCan ZONE N MODE command query 401 MODE MARKer MODE command query 420 MODE MEASure HISTogram MODE command query 552 MODe...

Page 1178: ...AK1 command query 539 PEAK2 MEASure FFT PEAK2 command query 540 peak to peak voltage and VPP 683 Pending Commands Clearing 98 PERCent MEASure THResholds PERCent command query 651 period measurement se...

Page 1179: ...MEASure QUALifier M CONDition command query 610 QUALifier M MEASure QUALifier M SOURce command query 611 QUALifier M MEASure QUALifier M STATe command query 612 Query 55 64 Query Error 1013 Query Erro...

Page 1180: ...al 139 RUMode MTESt RUMode command query 460 RUMode MTESt RUMode SOFailure command query 461 RUN and GET relationship 98 RUNT ISCan RUNT HYSTeresis command query 393 RUNT ISCan RUNT LLEVel command que...

Page 1181: ...simple command header 62 SIZE DIGital N SIZE command query 272 SIZE DISPlay GRATicule SIZE command query 306 SIZE HISTogram SCALe SIZE command query 375 SKEW CALibrate SKEW command query 188 SKEW CHA...

Page 1182: ...SR 113 Standard Event Status Register bits 250 Standard Status Data Structure Model 104 STANdard TRIGger TV STANdard command query 919 STARt MEASure TIEFilter STARt command query 661 STARt MTESt STARt...

Page 1183: ...and date setting 805 Time Base Commands 819 time buckets and POINts 964 time scale operands and functions 320 TIME SYSTem TIME command query 817 TIME TRIGger DELay TDELay TIME command query 860 TIME...

Page 1184: ...1 VERTical FUNCtion F VERTical command query 361 VERTical FUNCtion F VERTical OFFSet command query 362 VERTical FUNCtion F VERTical RANGe command query 363 VERTical MEASure CLOCk VERTical command quer...

Page 1185: ...decode 756 WORD and FORMat 962 WORD Understanding the format 956 WriteIEEEBlock method 74 WriteList method 74 WriteNumber method 74 WriteString method 74 WriteString VISA COM method 53 writing text to...

Page 1186: ...1186 Agilent Infiniium 90000 Series Oscilloscopes Programmer s Reference Index...

Reviews:

No comments

Brands by name

Popular brands

Load more brands