Tektronix MSO2024B Programmer's Manual

Tektronix MSO2024B Programmer's Manual

Mso2000b series; mso2000 series; dpo2000b series; dpo2000 series
Hide thumbs Also See for MSO2024B:

Advertisement

xx
MSO2000B, DPO2000B, MSO2000 and DPO2000
Series Oscilloscopes
ZZZ
Programmer Manual
*P077073800*
077-0738-00

Advertisement

Table of Contents
loading

Summary of Contents for Tektronix MSO2024B

  • Page 1 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual *P077073800* 077-0738-00...
  • Page 3 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual Revision A www.tektronix.com 077-0738-00...
  • Page 4 Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material.
  • Page 5: Table Of Contents

    Connecting via Ethernet................Connecting via USB ..................Connecting via GPIB ................... Setting Up Remote Communications Software ............Using TekVISA ..................Using Tektronix e*Scope Software ..............Documentation ....................Command Syntax....................Command and Query Structure ................Clearing the oscilloscope ................... Command Entry....................
  • Page 6 Table of Contents Commands Listed in Alphabetical Order ..............2-59 Status and Events ....................Registers ...................... Queues ......................Event Handling Sequence................... Synchronization Methods ................... Messages....................3-12 Appendix A: Character Set ..................Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments... Appendix C: Reserved Words ..................
  • Page 7: Getting Started

    This manual describes commands for the following models: Table 1-1: Number of Analog Record Length, Wfm. Capture Model Bandwidth Channels Sample Rate all ch. Rate MSO2024B, 200 MHz 1 GS/s 1 M pts. 5,000 MSO2024 MSO2022B 200 MHz 1 GS/s 1 M pts. 5,000 MSO2014B,...
  • Page 8: Setting Up Remote Communications Hardware

    PC. First, you’ll need to acquire an optional DPO2CONN Connectivity Module, which provides Ethernet and video out ports for your oscilloscope (search on www.tektronix.com). Then, simply plug one end of the Ethernet cable into the Ethernet port (RJ-45 connector), and the other end into your network connection.
  • Page 9: Connecting Via Usb

    Getting Started To view or change the Ethernet settings on your oscilloscope, do the following: 1. On the front panel, push Utility. 2. Push Utility Page. 3. Select I/O with the Multipurpose knob. 4. Push Ethernet Network Settings. 5. If you are on a DHCP Ethernet network and using a through cable, on the side menu set DHCP/BOOTP to On.
  • Page 10: Connecting Via Gpib

    0x39E MSO2012B (decimal 926) 0x39F DPO2014B (decimal 927) 0x3A0 MSO2014B (decimal 928) 0x3A1 DPO2022B (decimal 929) 0x3A2 MSO2022B (decimal 930) 0x3A3 DPO2024B (decimal 931) 0x3A4 MSO2024B (decimal 932) 0x0372 DPO2012 0x0373 DPO2014 0x0374 DPO2024 0x0376 MSO2012 0x0377 MSO2014 0x0378 MSO2024...
  • Page 11: Setting Up Remote Communications Software

    You can connect using TekVISA drivers, or connect directly from any computer’s web browser using Tektronix e*Scope Web-enabled tools. MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 12: Using Tekvisa

    TekVISA lets you use your MS-Windows computer to acquire data from your oscilloscope for use in an analysis package that runs on your PC, such as Microsoft Excel, National Instruments LabVIEW, Tektronix OpenChoice Desktop software, or your own custom software. You can use a common communications connection, such as USB, Ethernet, or GPIB, to connect the computer to the oscilloscope.
  • Page 13: Using Tektronix E*Scope Software

    Using Tektronix e*Scope Your oscilloscope contains a pre-installed remote control software package by Tektronix called e*Scope. You can use this to “talk” to a networked PC’s web Software browser so that you can view and control the oscilloscope wherever it is on your network.
  • Page 14 Getting Started To set up e*Scope communications between your oscilloscope and a networked computer: 1. With the DPO2CONN Connectivity Module installed, connect an Ethernet cable from the back of the oscilloscope to the same network as your computer. 2. Power up your oscilloscope and test the network connection: a.
  • Page 15: Documentation

    MSO/DPO2000B Series Technical Reference. Oscilloscope specifications and a performance verification procedure. TekVISA Programmer Manual. Description of TekVISA, the Tektronix implementation of the VISA Application Programming Interface (API). TekVISA is industry-compliant software for writing interoperable oscilloscope drivers in a variety of Application Development Environments (ADEs).
  • Page 16 Getting Started 1-10 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 17: Command Syntax

    Command Syntax You can control the operations and functions of the oscilloscope through the Ethernet port or the USB 2.0 device port using commands and queries. The related topics listed below describe the syntax of these commands and queries. The topics also describe the conventions that the oscilloscope uses to process them.
  • Page 18 Command Syntax Table 2-2: Command Message Elements Symbol Meaning <Header> This is the basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character. If the command is concatenated with other commands, the beginning colon is required.
  • Page 19 Command Syntax Queries Queries cause the oscilloscope to return status or setting information. Queries have the structure: [:]<Header> [:]<Header>[<Space><Argument> [<Coma><Argument>]...] You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level.
  • Page 20: Clearing The Oscilloscope

    Command Syntax Clearing the oscilloscope You can clear the Output Queue and reset the oscilloscope to accept a new command or query by using the selected Device Clear (DCL) function. Command Entry The following rules apply when entering commands: You can enter commands in upper or lower case. You can precede any command with white space characters.
  • Page 21 Command Syntax When concatenating commands and queries, you must follow these rules: 1. Separate completely different headers by a semicolon and by the beginning colon on all commands except the first one. For example, the commands , can be concatenated TRIGger:MODe NORMal ACQuire:NUMAVg 8 into the following single command:...
  • Page 22: Constructed Mnemonics

    Command Syntax Table 2-4: End of Message Terminator Symbol Meaning Message terminator <EOM> The end-of-message terminator must be the END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII line feed (LF) character. This oscilloscope does not support ASCII LF only message termination.
  • Page 23: Argument Types

    Command Syntax Measurement Specifier Commands can specify which measurement to set or query as a mnemonic in the header. Up to four automated measurements may be displayed. Mnemonics Table 2-8: Measurement Specifier Mnemonics Symbol Meaning MEAS<x> A measurement specifier; <x> is 1 through 4. Channel Mnemonics Commands specify the channel to use as a mnemonic in the header.
  • Page 24 Command Syntax Table 2-11: Quoted String Argument Symbol Meaning <QString> Quoted string of ASCII text A quoted string can include any character defined in the 7-bit ASCII character set. Follow these rules when you use quoted strings: 1. Use the same type of quote character to open and close the string. For example: "this is a valid string"...
  • Page 25 Command Syntax MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 26 Command Syntax 2-10 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 27: Command Groups

    Command Groups This manual lists the MSO/DPO2000B and MSO/DPO2000 series IEEE488.2 commands in two ways. First, it presents them by functional groups. Then, it lists them alphabetically. The functional group list starts below. The alphabetical list provides detail on each command. (See page 2-59, Commands Listed in Alphabetical Order.) Acquisition Command Group Use the commands in the Acquisition Command Group to set up the modes and...
  • Page 28: Alias Command Group

    Command Groups Alias Command Group Use the Alias commands to define new commands as a sequence of standard commands. You may find this useful when repeatedly using the same commands to perform certain tasks like setting up measurements. Aliases are similar to macros but do not include the capability to substitute parameters into alias bodies.
  • Page 29: Bus Command Group

    Command Groups Bus Command Group Use the Bus commands when working with serial bus measurements. Install the DPO2EMBD application module when working with I C or SPI bus signals. Install the DPO2AUTO module when working with CAN or LIN bus signals. Install the DPO2COMP module when working with RS232 bus signals.
  • Page 30 Command Groups Table 2-15: Bus Commands (cont.) Commands Description BUS:B<x>:POSition Sets or returns the position of the specified bus waveform BUS:B<x>:RS232C:BITRate Sets or returns the RS232 bit rate for the specified bus BUS:B<x>:RS232C:DATABits Sets or returns the number of bits for the data frame BUS:B<x>:RS232C:DELIMiter Sets or returns the RS232 delimiting value...
  • Page 31 Command Groups Table 2-15: Bus Commands (cont.) Commands Description SEARCH:SEARCH<x>:TRIGger:A:BUS? Returns the serial search type SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the search condition for a LIN B<x>:LIN:CONDition search SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the binary data string B<x>:LIN:DATa:HIVALue SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the LIN data qualifier B<x>:LIN:DATa:QUALifier SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the length of the data string...
  • Page 32: Calibration And Diagnostic Command Group

    They also initiate internal signal path calibration (SPC) or execute diagnostic tests. Commands that are specific to factory calibration are not described in this manual. They are described in the Service manual, available for download at www.tektronix.com. Table 2-16: Calibration and Diagnostic Commands Description...
  • Page 33: Cursor Command Group

    Command Groups Cursor Command Group Use the commands in the Cursor Command Group to control the cursor display and readout. You can use these commands to control the setups for cursor 1 and cursor 2, such as cursor position. You can also use the commands to select one of the following cursor functions: Off.
  • Page 34: Display Command Group

    Command Groups Table 2-17: Cursor Commands (cont.) Command Description CURSor:XY:POLar:RADIUS:POSITION<x>? Returns the polar radius of the specified cursor CURSor:XY:POLar:RADIUS:UNIts? Returns the polar radius units CURSor:XY:POLar:THETA:DELta? Returns the XY cursor polar coordinate delta CURSor:XY:POLar:THETA:POSITION<x>? Returns the cursor X or cursor Y polar coordinate CURSor:XY:POLar:THETA:UNIts? Returns the cursor polar coordinate units...
  • Page 35: Ethernet Command Group

    Command Groups Table 2-18: Display Commands Command Description Returns current display settings DISplay? DISplay:CLOCk Sets or returns the display of the date/time stamp DISplay:DIGital:HEIght Sets or returns the height of the digital display and the number of waveforms that you can display DISplay:FORMat Sets or returns the display format DISplay:GRAticule...
  • Page 36: File System Command Group

    Command Groups Table 2-19: Ethernet Commands (cont.) Command Description ETHERnet:HTTPPort Sets or returns the remote interface HTTP port value ETHERnet:IPADDress Sets or returns the IP address assigned to the oscilloscope ETHERnet:NAME Sets or returns the network name assigned to the oscilloscope ETHERnet:PASSWord Sets or returns the Ethernet access password ETHERnet:PING...
  • Page 37: Filtervu Command Group

    Command Groups NOTE. Using back slash as a path separator may produce some unexpected results, depending on how your application treats escaped characters. Many applications recognize the sequence of back slash followed by an alphabetic character as an escaped character, and, as such, interpret that alphabetic character as a control character.
  • Page 38: Hard Copy Command Group

    Command Groups Table 2-21: FilterVuCommands (cont.) Command Description FILTERVu:FREQuency Sets or queries the FilterVu frequency FILTERVu:FREQuency:AVAILable? Returns a comma separated list of filter frequencies available based on the current instrument settings For more information, refer to Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments.
  • Page 39: Horizontal Command Group

    Command Groups Horizontal Command Group Use the commands in the Horizontal Command Group to control the oscilloscope time bases. You can set the time-per-division of the main time base. You can also use the Horizontal commands to set the scale, horizontal position, and reference of the time base.
  • Page 40 Command Groups Table 2-24: Mark Commands Command Description MARK Move to the next or previous mark on the waveform or returns all learnable settings from the mark commands MARK:CREATE Creates a mark on a particular waveform or all waveforms in a column MARK:DELEte Deletes a mark on a particular waveform, all waveforms in a column, or all marks...
  • Page 41: Math Command Group

    Command Groups Math Command Group Use the commands in the Math Command Group to create and define a math waveform. Use the available math functions to define your math waveform. The math waveform you create depends on sources listed in the math expression. If you change these sources, the math waveform you previously defined will be affected.
  • Page 42: Measurement Command Group

    Command Groups Table 2-25: Math Commands (cont.) Command Description MATH[1]:SPECTral:NYQUISTFreq? Returns the Nyquist frequency of the FFT math waveform MATH[1]:SPECTral:WINdow Sets or returns the window function for math waveform spectral input data MATH[1]:TYPe Sets or returns the math waveform mode type MATH[1]:VERTical:POSition Sets or returns the vertical position of the...
  • Page 43 Command Groups Table 2-26: Measurement Commands (cont.) Command Description MEASUrement:IMMed:DELay? Returns information about the immediate delay measurement MEASUrement:IMMed:DELay:DIRection Sets or returns the search direction to use for immediate delay measurements MEASUrement:IMMed:DELay:EDGE<x> Sets or returns the slope of the edge used for immediate delay “from”...
  • Page 44 Command Groups Table 2-26: Measurement Commands (cont.) Command Description MEASUrement:MEAS<x>:MEAN? Returns the mean value accumulated since the last statistical reset MEASUrement:MEAS<x>:MINImum? Returns the minimum value found since the last statistical reset MEASUrement:MEAS<x>:SOURCE[1] Sets or returns the channel from which measurements are taken MEASUrement:MEAS<x>:SOURCE2 Sets or returns the channel to which measurements are sent...
  • Page 45: Miscellaneous Command Group

    firmware *IDN? Returns the same information as the ID? command except the data is formatted according to Tektronix Codes & Formats LANGuage Sets or returns the user interface display language MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 46: Pictbridge Command Group

    Command Groups Table 2-27: Miscellaneous Commands (cont.) Command Description LOCk Sets or returns the front panel lock state *LRN? Returns a listing of oscilloscope settings MESSage Sets or queries message parameters NEWpass Changes the password for user protected data PASSWord Enables the *PUD and NEWpass set commands Specifies a comment, which is ignored by...
  • Page 47: Save And Recall Command Group

    Command Groups Table 2-28: PictBridge Commands (cont.) Command Description PICTBridge:IDPrint Enables or disables printing the oscilloscope model and serial number on the print output PICTBridge:IMAGESize Sets or returns the image print size PICTBridge:PAPERSize Sets the output print paper size PICTBridge:PAPERType Sets or returns the paper type PICTBridge:PRINTQual Sets or returns the output print quality...
  • Page 48 Command Groups Table 2-29: Save and Recall Commands (cont.) Command Description SAVe:IMAGe:LAYout Sets or returns the layout to use for saved screen images SAVe:SETUp Saves the state of the oscilloscope to a specified memory location or file SAVe:WAVEform Saves a waveform to one of four reference memory locations or a file SAVe:WAVEform:FILEFormat Sets or returns the format for saved...
  • Page 49: Search Command Group

    Command Groups Search Command Group Use the commands in the Search Commands Group to seek out information in waveform records. Search Commands Command Description SEARCH? Returns all search-related settings SEARCH:SEARCH<x>:COPy Copies the search criteria to the trigger, or the trigger criteria to the search. SEARCH:SEARCH<x>:STATE Sets the search state to on or off SEARCH:SEARCH<x>:TOTAL?
  • Page 50 Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the I2C address mode to 7 B<x>:I2C:ADDRess:MODe or 10-bit SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the I2C address type to I2C B<x>:I2C:ADDRess:TYPe special addresses SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the binary address string to B<x>:I2C:ADDRess:VALue be used for I2C search SEARCH:SEARCH<x>:TRIGger:A:BUS:...
  • Page 51 Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:EDGE: Sets or returns the source waveform for an SOUrce edge search SEARCH:SEARCH<x>:TRIGger:A:LEVel Sets or returns the level for an edge search SEARCH:SEARCH<x>:TRIGger:A:LEVel: Sets or returns the level for an edge search CH<x> of the specified channel SEARCH:SEARCH<x>:TRIGger:A:LEVel: Sets or returns the math waveform level for...
  • Page 52 Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:LOGIc: Sets or returns the reference waveform THReshold:REF<x> threshold level for logic search SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the lower waveform threshold LOWerthreshold:CH<x> level for all channel waveform searches SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the lower waveform threshold LOWerthreshold:MATH level for all math waveform searches SEARCH:SEARCH<x>:TRIGger:A:...
  • Page 53: Status And Error Command Group

    Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the trigger search setup and SETHold:THReshold:REF<x> hold lower threshold to determine where to place a mark. Ref<x> is the reference waveform number SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the hold time setting for an SETHold:HOLDTime setup/hold search SEARCH:SEARCH<x>:TRIGger:A:...
  • Page 54: Trigger Command Group

    Command Groups Table 2-30: Status and Error Commands (cont.) Command Description *ESE Sets or returns the bits in the Event Status Enable Register *ESR? Returns the contents of the Standard Event Status Register EVENT? Returns event code from the event queue EVMsg? Returns event code, message from the event queue...
  • Page 55 Command Groups set the threshold voltage levels using TRIGger:A:LEVel:AUXin, TRIGger:A:LEVel:CH<x>, or TRIGger:A:LEVel:D<x>. Logic Trigger Logic triggering lets you logically combine the signals on one or more channels; the oscilloscope then triggers when it detects a certain combination of signal levels (set using one of the commands as well as TRIGger:A:LOGIc:INPut TRIGger:A:LOGIc:FUNCtion).
  • Page 56 Command Groups Runt triggering lets you trigger on a pulse amplitude that crosses one threshold but fails to cross a second threshold before recrossing the first. To set up a runt trigger, first set the trigger type to using the PULSe command TRIGger:A:TYPe.
  • Page 57 Command Groups Table 2-31: Trigger Commands Command Description Forces a trigger event to TRIGger occur Returns the available trigger TRIGger:FREQuency? frequency in hertz. TRIGger:A Sets A trigger level to 50% or returns current A trigger parameters TRIGger:A:BUS Sets or returns the serial trigger type TRIGger:A:BUS:B<x>:CAN:CONDition Sets or returns the CAN...
  • Page 58 Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue Sets or returns the binary address string used for LIN trigger TRIGger:A:BUS:B<x>:I2C:ADDRess:MODe Sets or returns the I2C address mode to 7 or 10-bit TRIGger:A:BUS:B<x>:I2C:ADDRess:TYPe Sets or returns the I2C address type to USER TRIGger:A:BUS:B<x>:I2C:ADDRess:VALue Sets or returns the binary address string used for the...
  • Page 59 Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:SPI:DATa{:OUT|:MOSI}:VALue Sets or returns the binary data string used for the SPI trigger TRIGger:A:BUS:B<x>:SPI:DATa:SIZe Sets or returns the length of the data string in bytes to be used for SPI trigger TRIGger:A:BUS:SOUrce Sets or returns the source for a bus trigger...
  • Page 60 Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:LOGIc:INPut:CH<x> Specifies or returns the logic setting for the specified channel TRIGger:A:LOGIc:INPut:D<x> Sets or returns the logic pattern for a trigger on digital channel <x>, where x is the channel number TRIGger:A:LOGIc:INPut:CLOCk:EDGE Sets the polarity of the clock channel.
  • Page 61 Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:PULse:CLAss Sets or returns the type of pulse on which to trigger TRIGger:A:PULSEWIDth? Returns the trigger A pulse width parameters TRIGger:A:PULSEWidth:POLarity Sets or returns the polarity for the A pulse width trigger TRIGger:A:PULSEWidth:SOUrce Sets or returns the source for the pulse width trigger...
  • Page 62 Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:SETHold:DATa? Returns the voltage threshold and data source for the setup/hold trigger TRIGger:A:SETHold:DATa:SOUrce Sets or returns the data source for the setup and hold trigger TRIGger:A:SETHold:DATa:THReshold Sets or returns the data voltage threshold for setup and hold trigger TRIGger:A:SETHold:HOLDTime...
  • Page 63: Vertical Command Group

    Command Groups Table 2-31: Trigger Commands (cont.) Command Description TRIGger:A:VIDeo:POLarity Sets or returns the polarity of the A video trigger TRIGger:A:VIDeo:SOUrce Sets or returns the polarity of the video trigger TRIGger:A:VIDeo:STANdard Sets or returns the video standard TRIGger:A:VIDeo{:SYNC|:FIELD} Sets or returns the video field trigger TRIGger:EXTernal? Returns external trigger...
  • Page 64 Command Groups Table 2-32: Vertical Commands (cont.) Command Description AUXin:PRObe:ID:SERnumber? Returns the serial number of the probe that is attached to the auxiliary input AUXin:PRObe:ID:TYPE? Returns the type of probe that is attached to the auxiliary input AUXin:PRObe:RESistance? Returns the resistance of the probe that is attached to the Auxiliary input AUXin:PRObe:SIGnal Sets or returns the input bypass setting on...
  • Page 65 Command Groups Table 2-32: Vertical Commands (cont.) Command Description CH<x>:PRObe:ID:SERnumber? Returns the serial number of the probe that is attached to the specified channel CH<x>:PRObe:ID:TYPE? Returns the type of probe that is attached to the specified channel CH<x>:PRObe:RESistance? Returns the resistance of the probe that is attached to the specified channel CH<x>:PRObe:SIGnal Sets or returns the input bypass setting of...
  • Page 66: Waveform Transfer Command Group

    Command Groups Table 2-32: Vertical Commands (cont.) Command Description SELect:BUS<x> Turns on or off the specified bus waveform or returns whether the specified bus channel is on or off SELect:CH<x> Turns on or off the specified waveform or returns whether the specified channel is on or off SELect:D<x>...
  • Page 67 Command Groups NOTE. The source waveform (as specified by the DATa:SOUrce) must be turned on for the following queries to return a response: CURVe? DATa:COMPosition:AVAILable? WAVFrm? WFMOutpre:RECOrdlength? WFMOutpre:FILTERFreq? WFMOutpre:NR_Pt? WFMOutpre:PT_Fmt? WFMOutpre:PT_ORder? WFMOutpre:XUNit? WFMOutpre:XINcr? WFMOutpre:XZEro? WFMOutpre:PT_Off? WFMOutpre:YUNit? WFMOutpre:YMUlt? WFMOutpre:YOFf? WFMOutpre:YZEro? Before you transfer waveform data, you must specify the data format, composition, resolution, record length, and waveform source or destination.
  • Page 68 Command Groups Each data value requires two to seven characters. This includes one to five characters to represent the value, another character, if the value is negative, to represent a minus sign, and a comma to separate the data points. An example ASCII waveform data string may look like this: CURVE<space>-110,-109,-110,-110,-109,-107,-109,-107,-106, -105,-103,-100,-97,-90,-84,-80...
  • Page 69 Command Groups command. Next, specify the first data point within the waveform record. For example, when you set DATa:STARt to 1, data points will be stored starting with the first point in the record. The oscilloscope will ignore the value set by DATa:STOP when reading in data.
  • Page 70 Command Groups Transferring Waveform You can transfer waveforms to the oscilloscope from an external controller using the following sequence: Data to the Oscilloscope 1. Specify the reference waveform using DATa:DESTination. 2. Specify the record length of the reference waveform using WFMPre:NR_Pt. 3.
  • Page 71 Command Groups Table 2-34: Waveform Transfer Commands (cont.) Command Description DATa:STOP Sets or returns the ending data point in waveform transfer WAVFrm? Returns a branch query containing waveform data in either binary or ASCII format, waveform formatting data, and the location of the waveform data source WFMInpre? Returns the waveform formatting specification...
  • Page 72 Command Groups Table 2-34: Waveform Transfer Commands (cont.) Command Description WFMInpre:YZEro Sets or returns the vertical offset of the incoming waveform WFMOutpre? Returns the waveform formatting data for the waveform specified by the DATa:SOUrce command WFMOutpre:BYT_Or Sets or returns which byte of binary waveform data is transmitted first, during a waveform data transfer, when data points require more than one byte.
  • Page 73: Zoom Command Group

    Command Groups Table 2-34: Waveform Transfer Commands (cont.) Command Description WFMOutpre:YMUlt? Returns the vertical scale factor per digitizing level for the outgoing waveform WFMOutpre:YOFf? Returns the vertical position in digitizing levels for the outgoing waveform WFMOutpre:YUNit? Returns the vertical units for the outgoing waveform WFMOutpre:YZEro? Returns the vertical offset for the outgoing...
  • Page 74 Command Groups 2-58 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 75: Commands Listed In Alphabetical Order

    Commands Listed in Alphabetical Order ACQuire? (Query Only) Returns the following current acquisition parameters: Stop after Acquisition state Mode Number of averages Sampling mode Group Acquisition Syntax ACQuire? Related Commands ACQuire:MODe, ACQuire:NUMACq?, ACQuire:NUMAVg, ACQuire: STOPAfter Examples might return ACQuire? ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMAVG 16;SAMPLINGMODE RT ACQuire:MAXSamplerate? (Query Only) Returns the maximum real-time sample rate, which is the same across all...
  • Page 76 Commands Listed in Alphabetical Order Waveforms are the displayed data point values taken from acquisition intervals. Each acquisition interval represents a time duration set by the horizontal scale (time per division). The oscilloscope sampling system always samples at the maximum rate, so the acquisition interval may include than one sample. The acquisition mode (which you set using this ACQuire:MODe command) determines how the final value of the acquisition interval is generated from the many data samples.
  • Page 77 Commands Listed in Alphabetical Order start acquisitions again, it will continue from 5000. The number will reset to 0 only if you change the horizontal scale while acquisitions are running. Group Acquisition Syntax ACQuire:NUMACq? Related Commands ACQuire:STATE Returns might return indicating that 350 ACQuire:NUMACq? :ACQUIRE:NUMACQ 350...
  • Page 78 Commands Listed in Alphabetical Order single sequence acquisition will be started. If the last acquisition was continuous, a new continuous acquisition will be started. If RUN is issued in the middle of completing a single sequence acquisition (for example, averaging or enveloping), the acquisition sequence is restarted, and any accumulated data is discarded.
  • Page 79 Commands Listed in Alphabetical Order ACQuire:STOPAfter Sets or returns whether the oscilloscope continually acquires acquisitions or acquires a single sequence. Group Acquisition Syntax ACQuire:STOPAfter {RUNSTop|SEQuence} ACQuire:STOPAfter? Related Commands ACQuire:STATE Arguments specifies that the oscilloscope will continually acquire data, if RUNSTop ACQuire:STATE is turned on.
  • Page 80 Commands Listed in Alphabetical Order Arguments turns alias expansion off. If a defined alias is sent when ALIas is off, a command error (110) will be generated. turns alias expansion on. When a defined alias is received, the specified command sequence is substituted for the alias and executed. = 0 disables alias mode;...
  • Page 81 Commands Listed in Alphabetical Order Related Commands ALIas[:STATE] Arguments The first is the alias label. <QString> This label cannot be a command name. Labels must start with a letter and can contain only letters, numbers, and underscores; other characters are not allowed. The label must be less than or equal to 12 characters.
  • Page 82 Commands Listed in Alphabetical Order Group Alias Syntax ALIas:DELEte:ALL Related Commands ALIas:DELEte, ALIas:DELEte[:NAMe] Examples deletes all existing aliases. ALIAS:DELETE:ALL ALIas:DELEte[:NAMe] (No Query Form) Removes a specified alias. This command is identical to ALIas:DELEte Group Alias Syntax ALIas:DELEte[:NAMe] <QString> Arguments is the name of the alias to remove. Using <QString>...
  • Page 83 Commands Listed in Alphabetical Order Examples turns the command alias feature off. ALIAS[:STATE] OFF returns 0 when the alias feature is off. ALIAS[:STATE]? ALLEv? (Query Only) Prompts the oscilloscope to return all events and their messages (delimited by commas), and removes the returned events from the Event Queue. Use the *ESR? query to enable the events to be returned.
  • Page 84 Commands Listed in Alphabetical Order AUTOSet:ENAble Enables or disables the autoset. Group Miscellaneous Syntax AUTOSet:ENAble {OFF|ON} AUTOSet:ENAble? Related Commands AUTOSet Arguments enables the autoset feature. disables the autoset feature. Examples might return indicating that autoset is AUTOSET:ENABLE ? AUTOSET:ENABLE 1 enabled.
  • Page 85 <QString> the probe attached to the auxiliary input. Examples turns the output of a Tektronix AUXIN:PROBE:COMMAND “OUTPUT”, “ON” VPI-DPG probe on. sets a Tektronix VPI-DPG AUXIN:PROBE:COMMAND “MODE”, “4–4V1MHz”...
  • Page 86 Commands Listed in Alphabetical Order AUXin:PRObe:DEGAUss (No Query Form) Starts a degauss/autozero cycle on a TekVPI current probe attached to the Aux In input. If you send this command to a probe that does not support this function, it is ignored Group Vertical Syntax...
  • Page 87 Commands Listed in Alphabetical Order Arguments is the probe range, which is probe dependent. <NR3> AUXin:PRObe:GAIN Sets or returns the gain factor of a probe that is attached to the Aux In input. Group Vertical Syntax AUXin:PRObe:GAIN <NR3> AUXin:PRObe:GAIN? Arguments is the probe gain, which is probe dependent.
  • Page 88 Commands Listed in Alphabetical Order Group Vertical Syntax AUXin:PRObe:RESistance? Examples might return AUXin:PRObe:RESistance? :AUXin:PROBE:RESISTANCE indicating that the input resistance of the probe attached to the front 1.0000E+6 panel Aux In connector is 1 MΩ. NOTE. This query will return 0.0 if no probe is attached or the attached probe does not report the input resistance.
  • Page 89 Commands Listed in Alphabetical Order Sets or returns the parameters for each bus. These parameters affect either the Serial Trigger Setup or the Bus Display. Conditions This command requires a DPO2AUTO, DPO2EMBD, or DPO2COMP application module. Group Syntax BUS:B<x>:CAN:BITRate Sets or returns the bit rate for CAN bus <x>, where x is the bus number. Conditions This command requires a DPO2AUTO application module.
  • Page 90 Commands Listed in Alphabetical Order Syntax BUS:B<x>:CAN:PRObe {CANH|CANL|RX|TX|DIFFerential} BUS:B<x>:CAN:PRObe? Arguments specifies the single-ended CANH signal, as specified by the CAN standard. CANH specifies the single-ended CANL signal, as specified by the CAN standard. CANL specifies the receive signal on the bus side of the CAN transceiver. specifies the transmit signal.
  • Page 91 Commands Listed in Alphabetical Order Arguments is the analog channel to use as the data source. CH1–CH4 is the digital channel to use as the data source. D0–D15 BUS:B<x>:DISplay:FORMAt Sets or returns the display format for the numerical information in the bus waveform <x>, where x is the bus number.
  • Page 92 Commands Listed in Alphabetical Order OFF does not include the read/write bit in the address. ON includes the read/write bit in the address. Examples includes the read/write bit in the BUS:B1:I2C:ADDRESS:RWINCLUDE ON address. might return BUS:B1:I2C:ADDRESS:RWINCLUDE? indicating that the read/write bit is BUS:B1:I2C:ADDRESS:RWINCLUDE 0 not included in the address.
  • Page 93 Commands Listed in Alphabetical Order Arguments specifies the analog channel to use as the I2C SDATA source. CH1–CH4 specifies the digital channel to use as the I2C SDATA source. D0–D15 BUS:B<x>:LABel Sets or returns the waveform label for bus < x>, where x is the bus number 1 through 4.
  • Page 94 Commands Listed in Alphabetical Order Conditions This command requires a DPO2AUTO application module. Group Syntax BUS:B<x>:LIN:IDFORmat {NOPARity|PARity} BUS:B<x>:LIN:IDFORmat? Arguments sets the LIN ID format to no parity. NOPARity sets the LIN ID format to parity. PARity Examples sets the LIN ID format to parity. BUS:B1:LIN:IDFORMAT PARITY might return BUS:B1:LIN:IDFORMAT?
  • Page 95 Commands Listed in Alphabetical Order Conditions This command requires a DPO2AUTO application module. Group Syntax BUS:B<x>:LIN:SAMPLEpoint <NR1> BUS:B<x>:LIN:SAMPLEpoint? Arguments is the sample point (in %) at which to sample during each bit period. <NR1> Examples sets the sample point is at 10% of the bit period BUS:B1:LIN:SAMPLEPOINT 10 might return BUS:B1:LIN:SAMPLEPOINT?
  • Page 96 Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:LIN:STANDard {V1X|V2X|MIXed} BUS:B<x>:LIN:STANDard? Arguments sets the LIN standard to V1X. sets the LIN standard to V2X sets the LIN standard to MIXED. MIXed Examples sets the LIN standard is V1X. BUS:B1:LIN:STANDARD V1X might return BUS:B1:LIN:STANDARD? BUS:B1:LIN:STANDARD V2X indicating that the LIN standard is V2X.
  • Page 97 Commands Listed in Alphabetical Order Arguments specifies either rising or falling edge as the clock edge. EIther specifies the rising edge as the clock edge. RISing specifies the falling edge as the clock edge. FALling BUS:B<x>:PARallel:CLOCK:ISCLOCKed Sets or returns the parallel bus clock function for bus <x>, where x is the bus number.
  • Page 98 Commands Listed in Alphabetical Order Syntax BUS:B<x>:PARallel:WIDth <NR1> BUS:B<x>:PARallel:WIDth? Arguments is the number of bits. <NR1> BUS:B<x>:POSition Sets or returns the position of the bus <x> waveform on the display, where x is the bus number 1 through 4. Conditions This command requires a DPO2AUTO, DPO2EMBD, or DPO2COMP application module.
  • Page 99 Commands Listed in Alphabetical Order BUS:B<x>:RS232C:DATABits Sets or returns the number of RS232 data bits for bus <x>, where x is the bus number. Conditions This command requires a DPO2COMP application module. Group Syntax BUS:B<x>:RS232C:DATABits {7|8|9} BUS:B<x>:RS232C:DATABits? Arguments specifies seven bits in the RS232 data frame. specifies eight bits in the RS232 data frame.
  • Page 100 Commands Listed in Alphabetical Order Conditions This command requires a DPO2COMP application module. Group Syntax BUS:B<x>:RS232C:DISplaymode {FRAme|PACKET} BUS:B<x>:RS232C:DISplaymode? Arguments displays each frame as a single entity. FRAme displays a group of frames terminated with a single frame defined by the PACKET command or the front panel.
  • Page 101 Commands Listed in Alphabetical Order Syntax BUS:B<x>:RS232C:POLarity {NORMal|INVERTed} BUS:B<x>:RS232C:POLarity? Arguments sets the RS232C bus polarity to positive. NORMal sets the RS232C bus polarity to negative. INVERTed BUS:B<x>:RS232C:RX:SOUrce Sets or returns the RS232 RX source for bus <x>, where x is the bus number. Conditions This command requires a DPO2COMP application module.
  • Page 102 Commands Listed in Alphabetical Order BUS:B<x>:SPI:BITOrder Sets or returns the bit order for the specified SPI bus. Conditions This command requires a DPO2EMBD application module. Group Syntax BUS:B<x>:SPI:BITOrder {LSB|MSB} BUS:B<x>:SPI:BITOrder? Arguments specifies least significant bit first specifies most significant bit first Examples sets the bit order to LSB for the specified bus.
  • Page 103 Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:SPI{:CLOCK|:SCLK}:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:SPI{:CLOCK|:SCLK}:SOUrce? Arguments is the channel to use as the SPI SCLK source. CH1-CH4 is the digital channel to use as the SPI SCLK source. D0-D15 BUS:B<x>:SPI:DATA{:IN|:MISO}:POLARity Sets or returns the SPI MISO polarity for bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module.
  • Page 104 Commands Listed in Alphabetical Order Arguments is the channel to use as the SPI MISO source. CH1-CH4 is the digital channel to use as the SPI MISO source. D0-D15 BUS:B<x>:SPI:DATA{:OUT|:MOSI}:POLARity Sets or returns the SPI MOSI polarity for bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module.
  • Page 105 Commands Listed in Alphabetical Order Conditions This command requires a DPO2EMBD application module. Group Syntax BUS:B<x>:SPI:DATA:SIZe <NR1> BUS:B<x>:SPI:DATA:SIZe? Arguments specifies the number of bits per word. <NR1> Examples sets the data size to 16. BUS:B1:SPI:DATA:SIZe 16 might return BUS:B1:SPI:DATA:SIZe? BUS:B1:SPI:DATA:SIZe 8 indicating that the data size is 8 bits.
  • Page 106 Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:SPI:IDLETime <NR3> BUS:B<x>:SPI:IDLETime? Arguments specifies the idle time in seconds. <NR3> Examples might return BUS:B1:SPI:IDLETime? BUS:B1:SPI:IDLETime 5.0000E-6 indicating that the idle time is 5 μs. BUS:B<x>:SPI{:SELect|:SS}:POLARity Sets or returns the SPI SS polarity for bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module.
  • Page 107 Commands Listed in Alphabetical Order Arguments is the channel to use as the SPI SS source. CH1–CH4 is the digital channel to use as the SPI SS source. D0–D15 BUS:B<x>:STATE Sets or returns the on/off state of bus <x>, where x is the bus number. Group Syntax BUS:B<x>:STATE {<NR1>|OFF|ON}...
  • Page 108 Commands Listed in Alphabetical Order BUS:LOWerthreshold:CH<x> Sets the lower threshold for each channel. This applies to all search and trigger types that use the channel. This command supersedes the above. :BUS:THReshold:CH<x> Group Syntax BUS:LOWerthreshold:CH<x> {<NR3>|ECL|TTL} BUS:LOWerthreshold:CH<x>? Arguments specifies the threshold in volts. <NR3>...
  • Page 109 Commands Listed in Alphabetical Order Arguments specifies a preset high level of –1.3 V. specifies a preset high level of 1.4 V. specifies the threshold level in volts. <NR3> BUS:THReshold:D<x> Sets or returns the threshold for digital channel <x>, where x is the digital channel number.
  • Page 110 Commands Listed in Alphabetical Order Arguments specifies the threshold in volts. <NR3> specifies a preset high level of –1.3 V. specifies a preset high level of 1.4 V. Examples sets the CH1 upper threshold to BUS:UPPERTHRESHOLD:CH1 800.0000E-3 800 mV. might return BUS:UPPERTHRESHOLD:CH1? :BUS:UPPERTHRESHOLD:CH1 indicating that the CH1 upper threshold is set to -800 mV.
  • Page 111 Commands Listed in Alphabetical Order *CAL? (Query Only) Performs an internal self-calibration and returns the oscilloscope calibration status. NOTE. Disconnect or otherwise remove all input signals prior to starting self-calibration. The self-calibration can take several minutes to complete. No other commands are executed until calibration is complete. Group Calibration and Diagnostic Syntax...
  • Page 112 Commands Listed in Alphabetical Order CALibrate:FACtory:STATus? (Query Only) Returns the factory calibration status value saved in nonvolatile memory. Group Calibration and Diagnostic Syntax CALibrate:FACtory:STATus? Examples might return CALIBRATE:FACTORY:STATUS? CALIBRATE:FACTORY:STATUS indicating that factory calibration passed. PASS CALibrate:INTERNal (No Query Form) This command starts a signal path compensation. Group Calibration and Diagnostic Syntax...
  • Page 113 Commands Listed in Alphabetical Order CALibrate:INTERNal:STATus? (Query Only) Returns the current status of the oscilloscope internal signal path calibration for the last SPC operation. Group Calibration and Diagnostic Syntax CALibrate:INTERNal:STATus? Related Commands *CAL? Returns This query will return one of the following: indicates the oscilloscope has not had internal signal path calibration INIT run.
  • Page 114 Commands Listed in Alphabetical Order CALibrate:RESults:FACtory? (Query Only) Returns the status of internal and factory calibration, without performing any calibration operations. Group Calibration and Diagnostic Syntax CALibrate:RESults:FACtory? CALibrate:RESults:SPC? (Query Only) Returns the status of the SPC operation. This query does not initiate a SPC. Group Calibration and Diagnostic Syntax...
  • Page 115 Commands Listed in Alphabetical Order CH<x>? (Query Only) Returns the vertical parameters for channel <x>, where x is the channel number. Group Vertical Syntax CH<x>? CH<x>:BANdwidth Sets or returns the selectable low-pass bandwidth limit filter for channel <x>, where x is the channel number. Group Vertical Syntax...
  • Page 116 Commands Listed in Alphabetical Order Arguments sets channel <x> to AC coupling. sets channel <x> to DC coupling. sets channel<x> to ground. Only a flat, ground-level waveform will be displayed. Examples sets channel 2 to ground. CH2:COUPLING GND might return indicating that channel 3 CH3:COUPling? :CH3:COUPling DC...
  • Page 117 Commands Listed in Alphabetical Order Syntax CH<x>:IMPedance CH<x>:IMPedance? CH<x>:INVert Sets or returns the invert function for channel <x>, where is the channel number. When on, the invert function inverts the waveform for the specified channel. NOTE. This command inverts the waveform for display purposes only. The oscilloscope does not use an inverted waveform for triggers or trigger logic inputs.
  • Page 118 Commands Listed in Alphabetical Order CH<x>:OFFSet Sets or returns the vertical offset for channel <x>, where x is the channel number. This command offsets the vertical acquisition window (moves the level at the vertical center of the acquisition window) for the specified channel. Visualize offset as scrolling the acquisition window towards the top of a large signal for increased offset values, and scrolling towards the bottom for decreased offset values.
  • Page 119 Commands Listed in Alphabetical Order if the position for Channel 3 is set to 2.0 and the offset is set to 3.0, then input signals equal to 3.0 units are displayed 2.0 divisions above the center of the screen (at 1 V/div). Group Vertical Syntax...
  • Page 120 <QString> the probe attached to the specified channel. Examples sets a Tektronix VPI-DPG probe CH1:PROBE:COMMAND “MODE”, “4–4V1MHz” to the 4-4V1MHz mode. turns the output of a Tektronix CH1:PROBE:COMMAND “OUTPUT”, “ON” VPI-DPG probe on. might return CH1:PROBE:COMMAND?“MODE” CH1:PROBE:COMMAND “MODE”,“4-4V1MHZ”...
  • Page 121 Commands Listed in Alphabetical Order NOTE. This command will return for probes that do not support degauss PASSED operations. Group Vertical Syntax CH<x>:PRObe:DEGAUss:STATE? Returns indicates the probe should be degaussed before taking measurements. NEEDED indicates the measurement accuracy might be improved by RECOMMENDED degaussing the probe.
  • Page 122 Commands Listed in Alphabetical Order Group Vertical Syntax CH<x>:PRObe:GAIN <NR3> CH<x>:PRObe:GAIN? Related Commands CH<x>:SCAle Arguments is the probe gain. Allowed values depend on the specific probe. <NR3> Examples might return indicating CH2:PROBE:GAIN? :CH2:PROBE:GAIN 0.1000E+00 that the attached 10x probe delivers 1 V to the channel 2 BNC for every 10 V applied to the probe input.
  • Page 123 Commands Listed in Alphabetical Order Examples might return CH1:PROBE:ID:SERNUMBER? :CH1:PROBE:ID:SERNUMBER indicating that the serial number of the probe attached to channel 1 "B010289" is B010289. CH<x>:PRObe:ID:TYPE? (Query Only) Returns the type of probe attached to the channel specified by <x>, where x is the channel number.
  • Page 124 Commands Listed in Alphabetical Order Group Vertical Syntax CH<x>:PRObe:SIGnal {BYPass|PASS} CH<x>:PRObe:SIGnal? Arguments sets the probe to Bypass mode. BYPass sets the probe to Pass mode. PASS CH<x>:PRObe:UNIts? (Query Only) Returns a string describing the units of measure for the probe attached to channel <x>, where x is the channel number.
  • Page 125 Commands Listed in Alphabetical Order Syntax CH<x>:SCAle <NR3> CH<x>:SCAle? Related Commands CH<x>:OFFSet, CH<x>:POSition, REF<x>:VERTical:SCAle, MATH[1]:VERTical:SCAle Arguments is the vertical channel scale in units-per-division. The value entered here <NR3> is truncated to three significant digits. Examples sets the channel 4 scale to 100 mV per division. CH4:SCALE 100E-03 might return indicating that the current scale...
  • Page 126 Commands Listed in Alphabetical Order CH<x>:YUNits Sets or returns the units for the channel specified by <x>, where x is the channel number. String arguments are case insensitive and any unsupported units will generate an error. Supported units are: %, /Hz, A, A/A, A/V, A/W, A/dB, A/s, AA, AW, AdB, As, B, Hz, IRE, S/s, V, V/A, V/V, V/W, V/dB, V/s, VV, VW, VdB, Volts, Vs, W, W/A, W/V, W/W, W/dB, W/s, WA, WV, WW, WdB, Ws, dB, dB/A, dB/V, dB/W, dB/dB, dBA, dBV, dBW, dBdB, day, degrees, div, hr, min, ohms, percent, s...
  • Page 127 Commands Listed in Alphabetical Order *CLS can suppress a Service Request that is to be generated by an *OPC. This will happen if a single sequence acquisition operation is still being processed when the *CLS command is executed. Group Status and Error Syntax *CLS Related Commands...
  • Page 128 Commands Listed in Alphabetical Order Arguments removes the cursors from the display but does not change the cursor type. specifies both horizontal and vertical bar cursors, which measure the SCREEN selected waveform in horizontal and vertical units. Use these cursors to measure anywhere in the waveform display area.
  • Page 129 Commands Listed in Alphabetical Order Related Commands CURSor:HBArs:UNIts Returns A floating point value with an exponent. Examples might return CURSOR:HBARS:DELTA? :CURSOR:HBARS:DELTA 5.0800E+00 indicating that the difference between the two cursors is 5.08. CURSor:HBArs:POSITION<x> Sets or returns the horizontal bar cursor position relative to ground, which is expressed in vertical units (usually volts).
  • Page 130 Commands Listed in Alphabetical Order Arguments selects the vertical units for the selected waveform. BASe selects ratio cursors. PERcent Examples might return indicating CURSOR:HBARS:UNITS :CURSOR:HBARS:UNITS BASE that the units for the horizontal bar cursors are base. CURSor:HBArs:USE (No Query Form) Sets the horizontal bar cursor measurement scale.
  • Page 131 Commands Listed in Alphabetical Order Syntax CURSor:MODe {TRACk|INDependent} CURSor:MODe? Arguments ties the navigational functionality of the two cursors together. For cursor 1 TRACk adjustments, this ties the movement of the two cursors together; however, cursor 2 continues to move independently of cursor 1. allows independent adjustment of the two cursors.
  • Page 132 Commands Listed in Alphabetical Order CURSor:VBArs:DELTa? (Query Only) Returns the horizontal difference between the two vertical bar cursors. The units are specified by the CURSor:VBArs:UNIts command. This is equivalent to watching the cursor readout in the display while using the appropriate cursor mode.
  • Page 133 Commands Listed in Alphabetical Order CURSor:VBArs:POSITION<x> Sets or returns the horizontal position for the specified vertical bar cursor. The cursor is specified by <x>, which can be 1 or 2. Values are with respect to trigger position or the zero reference point for the designated waveform (if horizontal units are not set to time).
  • Page 134 Commands Listed in Alphabetical Order Returns , or , depending on the current vertical bar SECONDS HERTZ DEGREES PERCENT cursor units. Examples sets the units of the VBArs cursors to 1/seconds. CURSOR:VBARS:UNITS HERtz might return CURSOR:VBARS:UNITS? :CURSOR:VBARS:UNITS SECONDS indicating that the units for the vertical bar cursor are currently set to seconds. CURSor:VBArs:USE (No Query Form) Sets the vertical bar cursor measurement scale.
  • Page 135 Commands Listed in Alphabetical Order Syntax CURSor:VBArs:VDELTa? Related Commands CURSor:HBArs:UNIts Returns indicates the horizontal difference between the two vertical bar cursors. <NR3> Examples might return CURSOR:VBARS:VDELTA 1.064E+0, CURSOR:VBARS:VDELTA? indicating that the vertical difference between the vertical bar cursors ticks is 1.064 units.
  • Page 136 Commands Listed in Alphabetical Order CURSor:XY:POLar:THETA:DELta? (Query Only) Returns the XY cursor polar angle delta. Group Cursor Syntax CURSor:XY:POLar:THETA:DELta? CURSor:XY:POLar:THETA:POSITION<x>? (Query Only) Returns the cursor X or cursor Y polar coordinate, where x is either 1 or 2. Group Cursor Syntax CURSor:XY:POLar:THETA:POSITION<x>? CURSor:XY:POLar:THETA:UNIts? (Query Only)
  • Page 137 Commands Listed in Alphabetical Order CURSor:XY:PRODUCT:POSITION<x>? (Query Only) Returns the position of the X or Y cursor used to calculate the X × Y cursor measurement, Position 1 = (X1 × Y1); Position 2 = (X2 × Y2). The cursor is specified by x, which can be 1 or 2.
  • Page 138 Commands Listed in Alphabetical Order CURSor:XY:RATIO:UNIts? (Query Only) Returns the cursor X and cursor Y units for the ratio measurement. Group Cursor Syntax CURSor:XY:RATIO:UNIts? CURSor:XY:RECTangular:X:DELta? (Query Only) Returns the cursor X delta value in rectangular coordinates. Group Cursor Syntax CURSor:XY:RECTangular:X:DELta? CURSor:XY:RECTangular:X:POSITION<x>...
  • Page 139 Commands Listed in Alphabetical Order CURSor:XY:RECTangular:Y:DELta? (Query Only) Returns The cursor Y delta value in rectangular coordinates. Group Cursor Syntax CURSor:XY:RECTangular:Y:DELta? CURSor:XY:RECTangular:Y:POSITION<x> Sets or returns the Y rectangular coordinate for cursor 1 or cursor 2. The cursor is specified by x. Group Cursor Syntax...
  • Page 140 Commands Listed in Alphabetical Order preview parameters. The user should always follow acquisition parameter changes with a single sequence OPC command prior to CURVe? to ensure the return data reflects the new acquisition parameters. The CURVe command transfers waveform data to the oscilloscope. The data is stored in the reference memory location specified by DATa:DESTination, starting with the data point specified by DATa:STARt.
  • Page 141 Commands Listed in Alphabetical Order <data> is the curve data. <newline> is a single byte new line character at the end of the data. is the waveform data in ASCII format. The format for ASCII data <asc curve> ...], where each represents a data point.
  • Page 142 Commands Listed in Alphabetical Order Examples might return RIBINARY;SOURCE DATA? :DATA:DESTINATION REF1:ENCDG CH1;START 1;STOP 500;WIDTH 1 initializes the waveform data parameters to their factory defaults. DATA INIT DATa:COMPosition Sets or returns the type of data that the CURVe? query returns. NOTE.
  • Page 143 Commands Listed in Alphabetical Order Syntax DATa:COMPosition:AVAILable? Returns for sample data. COMPOSITE_YT for envelope or peak-detect data. COMPOSITE_ENV for sample data. SINGULAR_YT Examples might return DATA:COMPOSITION:AVAILABLE? indicating that the waveform DATA:COMPOSITION:AVAILABLE COMPOSITE_YT data type. DATa:DESTination Sets or returns the reference memory location for storing waveform data transferred into the oscilloscope by the CURVe command.
  • Page 144 Commands Listed in Alphabetical Order Group Waveform Transfer Syntax DATa:ENCdg {ASCIi|FAStest|RIBinary|RPBinary|SRIbinary|SRPbinary} DATa:ENCdg? Related Commands WFMOutpre:ENCdg, WFMOutpre:BN_Fmt, WFMInpre:FILTERFreq Arguments specifies the ASCII representation for waveform data points. If ASCII is ASCIi the value, then :BN_Fmt and :BYT_Or are ignored. specifies that the data be sent in the fastest possible manner consistent FAStest with maintaining accuracy and is interpreted with respect to the waveform specified by DATa:SOUrce.
  • Page 145 Commands Listed in Alphabetical Order Examples might return for the format of the DATA:ENCDG? :DATa:ENCDG SRPBINARY outgoing waveform data. sets the data encoding format to be a positive integer DATA:ENCDG RPBinary where the most significant byte is transferred first. DATa:RESOlution Sets or returns whether the CURVe? query returns full resolution records (acquired data) or reduced resolution records (filtered/displayed data).
  • Page 146 Commands Listed in Alphabetical Order Group Waveform Transfer Syntax DATa:SOUrce {CH1|CH2|CH3|CH4|MATH|REF1|REF2| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} DATa:SOUrce? Related Commands CURVe Arguments specifies which analog channel data will be transferred from the CH1–CH4 oscilloscope to the controller, channels 1 through 4. specifies that the Math waveform data will be transferred from the MATH oscilloscope to the controller.
  • Page 147 Commands Listed in Alphabetical Order Examples might return indicating that the source for DATA:SOURCE? :DATA:SOURCE REF2 the waveform data which is transferred using a CURVe? query is reference 2. specifies that the CH1 waveform will be transferred in the DATA:SOURCE CH1 next CURVe? query.
  • Page 148 Commands Listed in Alphabetical Order Group Waveform Transfer Syntax DATa:STARt <NR1> DATa:STARt? Related Commands CURVe, DATa, DATa:STOP, WFMInpre:NR_Pt, WFMOutpre:NR_Pt? Arguments is the first data point that will be transferred, which ranges from 1 to the <NR1> to DATa:STOP or the record record length.
  • Page 149 Commands Listed in Alphabetical Order Arguments is the last data point that will be transferred, which ranges from 1 to <NR1> the record length. If is greater than the record length, then data will be <NR1> transferred up to the record length. If both DATa:STARt and DATa:STOP are greater than the record length, the last data point in the record is returned.
  • Page 150 Commands Listed in Alphabetical Order Syntax DATE <QString> DATE? TIME Related Commands Arguments is a date in the form "yyyy-mm-dd" where yyyy refers to a four-digit <QString> year number, mm refers to a two-digit month number from 01 to 12, and dd refers to a two-digit day number in the month.
  • Page 151 Commands Listed in Alphabetical Order DESE Sets or returns the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue. For a detailed discussion of the use of these registers, see Registers.
  • Page 152 Commands Listed in Alphabetical Order Arguments continues looping until the self tests (diagnostics) are stopped via the ALWAYS front panel or by an oscilloscope command. causes looping until the first self test (diagnostic) failure or until self tests FAIL (diagnostics) are stopped. causes looping on a specific test group as long as a FAIL status is ONFAIL returned from the test.
  • Page 153 Commands Listed in Alphabetical Order DIAg:RESUlt:FLAg? (Query Only) Returns the pass/fail status from the last self-test sequence execution. Use this query to determine which test(s) has failed. Group Calibration and Diagnostic Syntax DIAg:RESUlt:FLAg? Related Commands DIAg:RESUlt:LOG? Returns indicates that all of the selected self (diagnostic) tests have passed. PASS indicates that at least one of the selected self (diagnostic) tests has failed.
  • Page 154 Commands Listed in Alphabetical Order DIAg:SELect (No Query Form) Sets the type of diagnostics grouping. Group Calibration and Diagnostic Syntax DIAg:SELect {ALL|APPKey|CPU|DISplay|FPAnel|IO|ROM|ACQ} Arguments runs all diagnostic groups. runs just the application key diagnostic group. APPKey runs just the CPU diagnostic group. runs just the display circuit diagnostic group.
  • Page 155 Commands Listed in Alphabetical Order Examples sets the oscilloscope to run just CPU tests. DIAG:SELECT:CPU DIAg:STATE (No Query Form) This command starts or stops the oscilloscope self-test. Depending on the argument, self-test capabilities are either turned on or off. Group Calibration and Diagnostic Syntax DIAg:STATE {EXECute|ABORt}...
  • Page 156 Commands Listed in Alphabetical Order Related Commands DATE, TIME Arguments enables the display of date. DATEOnly enables the display of time. TIMEOnly enables the display of both date and time. DATETIME or ON disables the display of date and time. NONe or OFF = 0 disables the display of date and time;...
  • Page 157 Commands Listed in Alphabetical Order Syntax DISplay:FORMat {YT|XY} DISplay:FORMat? Arguments sets the display to a voltage versus time format and is the default mode. argument displays one waveform against another. Selecting one source causes its corresponding source to be implicitly selected, producing a single trace from the two input waveforms.
  • Page 158 Commands Listed in Alphabetical Order Syntax DISplay:GRAticule {CROSSHair|FRAme|FULl|GRId} DISplay:GRAticule? Arguments specifies a frame and cross hairs. CROSSHair specifies a frame only. FRAme specifies a frame, a grid and cross hairs. FULl specifies a frame and grid only. GRId Examples sets the graticule type to display the frame only. DISPLAY:GRATICULE FRAme might return indicating...
  • Page 159 Commands Listed in Alphabetical Order DISplay:INTENSITy:GLITch Sets the intensity of the glitch capture background of the waveform display. The intensity can be set from 5 to 100% in increments of 5%. The intensity of the glitch capture background can only be adjusted when the glitch capture background is displayed and FilterVu filtering is in use.
  • Page 160 Commands Listed in Alphabetical Order Group Display Syntax DISplay:INTENSITy:WAVEform <NR1> DISplay:INTENSITy:WAVEform? Arguments is the waveform intensity and ranges from 1 to 100 percent. <NR1> Examples might return DISPLAY:INTENSITY:WAVEFORM? DISPLAY:INTEnsITY:WAVEFORM 60 as the intensity of the waveforms. DISplay:PERSistence Sets or returns the display persistence. This affects the display only. NOTE.
  • Page 161 Commands Listed in Alphabetical Order specifies that the waveform persistence is set to the minimum value MINImum of 0.0E0. Examples specifies that the waveform points are displayed DISPLAY:PERSISTENCE 3 fading for 3 seconds before they completely disappear. D<x> Sets or returns parameters for digital channel <x>, where x is the channel number. Group Syntax D<x>...
  • Page 162 Commands Listed in Alphabetical Order Group Syntax D<x>:POSition <NR3> D<x>:POSition? Arguments is the position of the digital channel in slot units. Use the oscilloscope <NR3> front-panel controls to place the channel; then query the channel to obtain an exact value for the position. D<x>:THREshold Sets or returns the logical threshold for digital channel <x>, where x is the channel number.
  • Page 163 Commands Listed in Alphabetical Order Related Commands *CLS, DESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? Arguments specifies the binary bits of the ESER according to this value, which ranges <NR1> from 0 through 255. The power-on default for the ESER is 0 if *PSC is 1. If *PSC is 0, the ESER maintains the previous power cycle value through the current power cycle.
  • Page 164 Commands Listed in Alphabetical Order Syntax ETHERnet:DHCPbootp {ON|OFF} ETHERnet:DHCPbootp? Arguments enables the oscilloscope to search the network for a DHCP or BOOTP server in order to automatically assign a dynamic IP address to the oscilloscope. NOTE. Do not use DHCP/BOOTP searching if your oscilloscope has been assigned a static address on a network.
  • Page 165 Commands Listed in Alphabetical Order Arguments is the network domain name, enclosed in quotes. <QString> Examples sets the domain name that ETHERNET:DOMAINNAME “Alpha1.Mycorp.com” the oscilloscope uses to communicate with the network. ETHERnet:ENET:ADDress? (Query Only) Returns the Ethernet address value assigned to the oscilloscope. This is assigned at the factory and can not be changed.
  • Page 166 Commands Listed in Alphabetical Order Syntax ETHERnet:HTTPPort <QString> ETHERnet:HTTPPort? Arguments is an integer port number, enclosed in quotes. <QString> NOTE. Consider the following if you are using the e*Scope™ control software. If you don't enter a port address in the URL, then the value ETHERnet:HTTPPort must be set to "80", which is the default port for HTTP protocol.
  • Page 167 Commands Listed in Alphabetical Order Examples “labscope1” sets the oscilloscope's network name. ETHERNET:NAME ETHERnet:PASSWord Sets or returns the HTTP Ethernet access password. If a password is set, the user must enter the password before the user's Web browser can access the oscilloscope. Group Ethernet Syntax...
  • Page 168 Commands Listed in Alphabetical Order Returns is returned if the computer at the gateway IP address answers. is returned if the computer at the gateway IP address does not NORESPOnsE answer. is returned if the ping operation is still executing. INPROGRESS ETHERnet:SUBNETMask Sets or returns the remote interface subnet mask value.
  • Page 169 Commands Listed in Alphabetical Order EVMsg? (Query Only) Removes a single event code from the Event Queue that is associated with the results of the last *ESR? read and returns the event code along with an explanatory message. For information, see Event Handling. Group Status and Error Syntax...
  • Page 170 Commands Listed in Alphabetical Order FACtory (No Query Form) Resets the oscilloscope to its factory default settings. This command does the following: Clears the Event Status Enable Register Clears the Service Request Enable Register Sets the Device Event Status Enable Register to 255 Purges all defined aliases Enables all Command Headers Sets the macro defined by *DDT to a "zero-length field"...
  • Page 171 Commands Listed in Alphabetical Order FILESystem Returns the directory listing of the current working directory and the number of bytes of free space available. This query is the same as the FILESystem:DIR? query and the FILESystem:FREESpace? query. Group File System Syntax FILESystem FILESystem?
  • Page 172 Commands Listed in Alphabetical Order Syntax FILESystem:CWD {<new working directory path>} Arguments is a quoted string that defines the current <new working directory path> working; a directory name can have up to 8 characters with an extension of up to 3 characters.
  • Page 173 Commands Listed in Alphabetical Order Group File System Syntax FILESystem:DIR? Related Commands FILESystem:CWD, FILESystem:MKDir Arguments None Returns returns a list of files and directories in the current working FILESystem:DIR? directory. Examples might return FILESYSTEM:DIR? :FILESYSTEM:DIR "TEK00000.PNG","CANSETUP.SET","WFM1.ISF","MYIMAGES" FILESystem:FORMat (No Query Form) Formats a mass storage device.
  • Page 174 Commands Listed in Alphabetical Order Group File System Syntax FILESystem:FREESpace? Related Commands FILESystem:FREESpace?, FILESystem:CWD FILESystem:MKDir (No Query Form) Creates a new folder. Group File System Syntax FILESystem:MKDir <directory path> Related Commands FILESystem:CWD, FILESystem:DIR? Arguments is a quoted string that specifies the directory to create <directory path>...
  • Page 175 Commands Listed in Alphabetical Order Related Commands FILESystem:CWD Arguments is a quoted string that defines the file name and path. If the file path is <QString> within the current working directory, specify only the file name. Examples reads the FILESYSTEM:READFILE “E:/TEST_DATA/TEK00016CH1.CSV” content of the specified file, if the file exists and is readable, and sends the content of the file to the current interface.
  • Page 176 Commands Listed in Alphabetical Order Related Commands FILESystem:CWD Arguments is a quoted string that defines the directory name and path. <directory path> If the file path is within the current working directory, you need only specify the file name. Examples removes the directory named FILESYSTEM:RMDIR "E:/OldDirectory"...
  • Page 177 Commands Listed in Alphabetical Order Arguments is the integer format for the current FilterVu frequency setting. <NR3> Examples might return FILTERVU:FREQUENCY? FILTERVU:FREQUENCY 100000000 indicating that the FilterVu frequency is 100 MHz. FILTERVu:FREQuency:AVAILable? (Query Only) Returns a comma separated list of filter frequencies available based on the current instrument settings.
  • Page 178 Commands Listed in Alphabetical Order Table 2-37: FPAnel:PRESS arguments Argument Description ACQuire Acquire button SAVERecall Save/Recall Menu button MEASurement Measure button UTILity Utility button SEArch Search button TESt Test button MATh M button R button TRIGger Trigger Menu button Channel1 select button Channel2 select button Channel2 select button Channel4 select button...
  • Page 179 Commands Listed in Alphabetical Order Table 2-37: FPAnel:PRESS arguments (cont.) Argument Description BMENU5 Screen bottom menu button BMENU6 Screen bottom menu button BMENU7 Screen right-most bottom menu button RMENU1 Screen top-most side menu button RMENU2 Screen side menu button RMENU3 Screen side menu button RMENU4 Screen side menu button...
  • Page 180 Commands Listed in Alphabetical Order clockwise rotation. The magnitude of <n> specifies the amount of the turn, where <n> = 1 represents turning the knob one unit, <n> = 2 represents turning the knob two units, <n> = 4 represents turning the knob four units, and so on. The range of units depends on which front panel knob is specified.
  • Page 181 Commands Listed in Alphabetical Order Related Commands *WAI, *CLS Arguments sends a block of data representing the current screen image to the requested START port. The data sent is in the image format specified by SAVe:IMAGe:FILEFormat, and the compression level is controlled by whatever format has been selected (BMP and TIFF are uncompressed, while PNG is compressed).
  • Page 182 Commands Listed in Alphabetical Order Arguments ≠ 0 turns preview mode on. <NR1> = 0 turns preview mode off. <NR1> HEADer Sets or returns the Response Header Enable State that causes the oscilloscope to either include or omit headers on query responses. NOTE.
  • Page 183 Commands Listed in Alphabetical Order Syntax HORizontal? Examples might return the following horizontal HORIZONTAL? settings :HORIZONTAL:DIGITAL:RECORDLENGTH:MAIN 100.0000E+3;:HORIZONTAL:DIGITAL:SAMPLERATE:MAIN 1.0000E+9;:HORIZONTAL:MAIN:UNITS "s";:HORIZONTAL:POSITION 50.0000;SAMPLERATE 1.0000E+9;SCALE 4.0000E-6;RECORDLENGTH 100000;DELAY:MODE 1;TIME 0.0E+0 HORizontal:ACQLENGTH? (Query Only) Returns the record length. Group Horizontal Syntax HORizontal:ACQLENGTH? Related Commands HORizontal:RECOrdlength Examples might return HORIZONTAL:ACQLENGTH? HORizontal:ACQLENGTH?
  • Page 184 Commands Listed in Alphabetical Order = 0 sets the Horizontal Delay Mode to off; any other value sets this mode <NR1> to on. Examples sets the Horizontal Delay Mode to off, allowing HORIZONTAL:DELAY:MODE OFF HORizontal:POSition command to horizontally position the waveform. ? might return HORIZONTAL:DELAY:MODE HORIZONTAL:DELAY:MODE OFF...
  • Page 185 Commands Listed in Alphabetical Order Syntax HORizontal:DIGital:SAMPLERate:MAIN? HORizontal:POSition Sets or returns the horizontal position. If Horizontal Delay Mode is turned off, this command is equivalent to adjusting the HORIZONTAL POSITION knob on the front panel. When Horizontal Delay Mode is on, this command stores a new horizontal position that is used when Horizontal Delay Mode is turned off.
  • Page 186 Commands Listed in Alphabetical Order Group Horizontal Syntax HORizontal:RECOrdlength <NR1> HORizontal:RECOrdlength? Arguments represents the supported values for horizontal record lengths, which are: <NR1> 100000 or 1000000. Examples specifies that 100000 data points will HORIZONTAL:RECORDLENGTH 100000 be acquired for each record. might return HORIZONTAL:RECORDLENGTH? :HORIZONTAL:RECOrdlength...
  • Page 187 Commands Listed in Alphabetical Order Group Horizontal Syntax HORizontal:SCAle <NR3> HORizontal:SCAle? Arguments specifies the range from 2 ns to 100 s, depending on the oscilloscope model. <NR3> Examples sets the main scale to 2µs per division. HORIZONTAL:SCALE 2E-6 might return HORIZONTAL:SCALE? :HORIZONTAL:MAIN:SCALE 2.0000E-06 indicating that the main scale is currently set to 2 µs per division.
  • Page 188 Syntax *IDN? Related Commands Examples might return *IDN? :TEKTRONIX,DPO2024,SN123456789,CF:91.1CT indicating that the oscilloscope model number, serial number, FV:v1.00000 configured number, and firmware version number. LANGuage Sets or returns the user interface display language. This command only affects the oscilloscope displayed language. Remote commands and their responses are always in English.
  • Page 189 Commands Listed in Alphabetical Order Group Miscellaneous Syntax LOCk {ALL|NONe} LOCk? Related Commands UNLock Arguments disables all front-panel controls. enables all front-panel controls. This is equivalent to the UNLock NONe command. Examples locks the front-panel controls. LOCK ALL might return indicating that the front-panel controls are LOCK? :LOCK NONE...
  • Page 190 Commands Listed in Alphabetical Order INTERNAL;:SAVE:ASSIGN:TYPE SETUP;:TRIGGER:A:MODE AUTO;TYPE EDGE;LE VEL 20.0000E-3;LEVEL:CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A: UPPERTHRESHOLD:CH1 1.4000;CH2 800.0000E-3;CH3 800.0000E-3;CH4 800.0000E-3;:TRIGG ER:A:LOWERTHRESHOLD:CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A:H OLDOFF:TIME 20.0000E-9;:TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;:TRIGGER:A:LOGIC:CLASS SETHOLD;FUNCTION AND;THRESHOLD:CH1 20.0000E-3;CH2 0.0000;CH3 0.0 000;CH4 0.0000;:TRIGGER:A:LOGIC:INPUT:CH1 X;CH2 X;CH3 X;CH4 X;CLOCK:SOURCE NONE; EDGE RISE;:TRIGGER:A:LOGIC:PATTERN:INPUT:CH1 X;CH2 X;CH3 X;CH4 X;:TRIGGER:A:LOGIC:PATTERN:WHEN TRUE;WHEN:LESSLIMIT 4.0000E-9;LIMIT...
  • Page 191 Commands Listed in Alphabetical Order Syntax MARK:CREATE {CH<x>|MATH|B<x>|REF<x>|COLUMN|DIGItal} Arguments creates the mark on a channel waveform, where <x> is the channel number. CH<x> creates the mark on the math waveform. MATH creates the mark on a bus waveform, where <x> is the bus number. B<x>...
  • Page 192 Commands Listed in Alphabetical Order MARK:SELected:END? (Query Only) Returns the end of the selected mark, 0 to 100% of the waveform. Group Mark Syntax MARK:SELected:END? MARK:SELected:FOCUS? (Query Only) Returns the focus of the selected mark, 0 to 100% of the waveform. Group Mark Syntax...
  • Page 193 Commands Listed in Alphabetical Order MARK:SELected:SOURCE? (Query Only) Returns the source waveform for the selected mark. Group Mark Syntax MARK:SELected:SOURCE? MARK:SELected:STARt? (Query Only) Returns the starting point of the selected mark, 0 to 100% of the waveform. Group Mark Syntax MARK:SELected:STARt? MARK:SELected:STATe? (Query Only) Returns the on or off state of the selected mark.
  • Page 194 Commands Listed in Alphabetical Order MARK:TOTal? (Query Only) Returns how many marks are currently in use. Group Mark Syntax MARK:TOTal? MATH[1]:LABel Sets or queries the waveform label for the math waveform. Group Math Syntax MATH[1]:LABel <QString> MATH[1]:LABel? Arguments is the quoted string used as the label for the math waveform. <QString>...
  • Page 195 Commands Listed in Alphabetical Order "V";:MATH:HORIZONTAL:SCALE 4.0000E-6;POSITION 50.0000;UNITS "s";:MATH:SPECTRAL:MAG DB;WINDOW HANNING;:MATH:LABEL“” MATH[1]:DEFine Sets or returns the current math function as a text string. Dual math is defined if the string is of the form <wfm> <operation> <wfm> where the <wfm>s are any combination of live channels or reference waveforms, <operation>...
  • Page 196 Commands Listed in Alphabetical Order Examples adds the Ch 1 waveform and Ch 2 waveform, MATH1:DEFINE "CH1+CH2" storing the results in Math 1. might return as the expression MATH:DEFINE? :MATH1:DEFINE "CH2*REF2" that defines Math 1. MATH[1]:HORizontal:POSition Sets or returns the math horizontal display position for FFT or (non-live), live math reference waveforms.
  • Page 197 Commands Listed in Alphabetical Order MATH[1]:HORizontal:UNIts Returns the math waveform horizontal measurement unit value. Group Math Syntax MATH[1]:HORizontal:UNIts? Examples might return MATH:HORIZONTAL:UNITS? MATH:HORIZONTAL:UNITS "?" indicating that the math horizontal unit label for unknown values is the default question mark unit. MATH[1]:SPECTral:GATing:INDICators Enables or disables the display of indicators that show the portion of the source waveform record used to compute the math FFT waveform.
  • Page 198 Commands Listed in Alphabetical Order Returns A value between 0 and 1, which represents the fractional portion of the source record. MATH[1]:SPECTral:GATing:INDICators:STARt? (Query Only) Returns the starting point in the source waveform record used for computing the FFT math waveform. Group Math Syntax...
  • Page 199 Commands Listed in Alphabetical Order Syntax MATH[1]:SPECTral:NYQUISTFreq? MATH[1]:SPECTral:WINdow Sets or returns the window function for the spectral analyzer input data for the specified math waveform. A spectral window determines what the filter shape of the spectral analyzer will be in the frequency domain. It can be described by a mathematical function that is multiplied point-by-point times the input data to the spectral analyzer.
  • Page 200 Commands Listed in Alphabetical Order Related Commands MATH[1]:DEFine Arguments sets the math waveform mode to dual waveform math. DUAL sets the math waveform mode to FFT math. Examples sets the math waveform mode to FFT. MATH:TYPE FFT sets the math type to FFT MATH:TYPE FFT;:MATH:DEFINE “FFT( CH1 )”...
  • Page 201 Commands Listed in Alphabetical Order Related Commands CH<x>:SCAle, REF<x>:VERTical:SCAle Arguments is the scale-per-division in the current math vertical units. The range is <NR3> from 1.0E-09 through 5.0. Examples sets the Math scale to 100 mV per division. MATH1:VERTICAL:SCALE 100E-03 might return MATH:VERTICAL:SCALE? :MATH:VERTICAL:SCALE indicating that the current scale setting of Math is 1 V per division.
  • Page 202 Commands Listed in Alphabetical Order DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS3:STATE 1;TYPE PK2PK;UNITS "V";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:MEAS4:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS4:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:METHOD AUTO;REFLEVEL:METHOD PERCENT;ABSOLUTE:HIGH 0.0000;LOW 0.0000;MID1 0.0000;MID2 0.0000;:MEASUREMENT:REFLEVEL:PERCENT:HIGH 90.0000;LOW 10.0000;MID1 50.0000;MID2 50.0000;:MEASUREMENT:INDICATORS:STATE OFF;NUMHORZ 0;NUMVERT 0;HORZ1 99.0000E +36;HORZ2 99.0000E+36;HORZ3 99.0000E+36;HORZ4 99.0000E+36;VERT1...
  • Page 203 Commands Listed in Alphabetical Order limits measurements to the portion of the waveform between the vertical CURSor bar cursors, even if they are off screen. Examples turns on measurement gating using the cursors MEASUREMENT:GATING CURSOR as limits. might return MEASUREMENT:GATING? :MEASUREMENT:GATING CURSOR indicating that measurements are limited to the portion of the waveform between the vertical bar cursors.
  • Page 204 Commands Listed in Alphabetical Order MEASUrement:IMMed:DELay:DIRection Sets or returns the starting point and direction that determines the delay "to" edge when taking an immediate delay measurement. NOTE. Use the MEASUrement:IMMed:SOUrce2 command to specify the delay "to" waveform. Measurement Group Syntax MEASUrement:IMMed:DELay:DIRection {BACKWards|FORWards} MEASUrement:IMMed:DELay:DIRection? Related Commands...
  • Page 205 Commands Listed in Alphabetical Order Related Commands MEASUrement:IMMed:SOUrce1 MEASUrement:IMMed:SOUrce2 Arguments specifies which waveform to use, where <x> = 1 is the "from" waveform, and <x> <x> = 2 is the "to" waveform. specifies the falling edge. FALL specifies the rising edge. RISe Examples specifies that the "from"...
  • Page 206 Commands Listed in Alphabetical Order Examples MEASUREMENT:IMMED:SOURCE1 MATH1 specifies Math1 as the immediate measurement source. might return MEASUREMENT:IMMED:SOURCE1? indicating that channel 3 is the :MEASUREMENT:IMMED:SOURCE1 CH3 immediate measurement source. MEASUrement:IMMed:SOUrce2 Sets or returns the source to measure "to" for phase or delay immediate measurements.
  • Page 207 Commands Listed in Alphabetical Order For SOUrce2: Sets or returns the waveform to measure "to" when taking a delay measurement or phase measurement. Group Measurement Syntax MEASUrement:IMMed:SOUrce<x> {CH1|CH2|CH3|CH4|MATH} MEASUrement:IMMed:SOUrce<x>? Arguments is the source waveform. CH1–CH4 MATH MEASUrement:IMMed:TYPe Sets or returns the immediate measurement type. Group Measurement Syntax...
  • Page 208 Commands Listed in Alphabetical Order (cycle mean) measures the arithmetic mean over the first cycle in the CMEan waveform or the first cycle in the gated region. This measurement is available only on DPO and MSO models. (cycle rms) measures the true Root Mean Square voltage over the first CRMs cycle in the waveform or the first cycle in the gated region.
  • Page 209 Commands Listed in Alphabetical Order (negative width) measurement is the distance (time) between the middle NWIdth reference (default = 50%) amplitude points of a negative pulse. The measurement is made on the first pulse in the waveform or gated region. (positive duty cycle) is the ratio of the positive pulse width to the signal PDUty period, expressed as a percentage.
  • Page 210 Commands Listed in Alphabetical Order VOLTS, VOLTS SQUARED, SEC, HERTZ, PERCENT, DIVS, SAMPLES, OHMS, AMPS, WATTS, MINUTES, DEGREES, UNKNOWN, AMPS SQUARED, HOURS, DAYS, DB, BYTES, INVERSE HERTZ, IRE, V OVER V, V OVER A, VOLTS WATTS, V OVER W, VOLTS DB, V OVER DB, A OVER V, A OVER A, AMPS WATTS, A OVER W, AMPS DB, A OVER DB, WATTS VOLTS, W OVER V, WATTS AMPS, W OVER A, WATTS SQUARED, W OVER W, WATTS DB, W OVER DB, DB VOLTS, DB OVER V, DB AMPS, DB...
  • Page 211 Commands Listed in Alphabetical Order MEASUrement:INDICators? (Query Only) Returns all measurement indicator parameters. Measurement Group Syntax MEASUrement:INDICators? Examples might return MEASUREMENT:INDICATORS? MEASUREMENT:INDICATORS:STATE MEAS1;NUMHORZ 0;NUMVERT 4;HORZ1 7.5E0;HORZ2 -3.400000095367E0;HORZ3 0.0E0;HORZ4 0.0E0;VERT1 -6.351123E-6;VERT2 -3.179753E-6;VERT3 -6.40943E-6;VERT4 -6.403E-6 MEASUrement:INDICators:HORZ<x>? (Query Only) Returns the position of the specified horizontal measurement indicator <x>, where <x>...
  • Page 212 Commands Listed in Alphabetical Order 2 horizontal lines drawn on the graticule. The indicators show where the measurement specified by MEASUrement:INDICators:STATE is being performed. MEASUrement:INDICators:NUMVERT? (Query Only) Returns the number of vertical measurement indicators currently being displayed. Group Measurement Syntax MEASUrement:INDICators:NUMVERT? Examples might return...
  • Page 213 Commands Listed in Alphabetical Order MEASUrement:INDICators:VERT<x>? (Query Only) Returns the value of the specified vertical measurement indicator <x> from the trigger point, where <x> can be 1, 2, 3, or 4. A negative value means that the indicator is positioned earlier in the waveform record than the trigger point. Group Measurement Syntax...
  • Page 214 Commands Listed in Alphabetical Order MEASUrement:MEAS<x>:DELay? (Query Only) Returns the delay measurement parameters for the measurement specified by <x>, which ranges from 1 through 4. Group Measurement Syntax MEASUrement:MEAS<x>:DELay? Examples might return MEASUREMENT:MEAS1? :MEASUREMENT:MEAS1:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE MEASUrement:MEAS<x>:DELay:DIRection Sets or returns the starting point and direction that determines the delay "to" edge when taking a delay measurement.
  • Page 215 Commands Listed in Alphabetical Order might return MEASUREMENT:MEAS3:DELAY:DIRECTION? indicating :MEASUREMENT:MEAS3:DELAY:DIRECTION BACKWARDS that the current search direction is backwards. MEASUrement:MEAS<x>:DELay:EDGE<x> Sets or returns the slope of the edge used for the delay "from" or "to" waveform when taking an immediate delay measurement. The waveform is specified by MEASUrement:MEAS<x>:SOURCE[1].
  • Page 216 Commands Listed in Alphabetical Order MEASUrement:MEAS<x>:MEAN? (Query Only) Returns the mean value accumulated for this measurement since the last statistical reset. Measurements are specified by x, which ranges from 1 through 4. Measurement Group Syntax MEASUrement:MEAS<x>:MEAN? Examples might return MEASUREMENT:MEAS1:MEAN? :MEASUREMENT:MEAS1:MEAN 514.71E-09.
  • Page 217 Commands Listed in Alphabetical Order Examples specifies Math 1 as the measurement MEASUREMENT:MEAS2:SOURCE1 MATH1 2 source. might return MEASUREMENT:MEAS1:SOURCE1? indicating that Math1 is the :MEASUREMENT:MEAS1:SOURCE[1] MATH1 measurement 2 source. MEASUrement:MEAS<x>:SOURCE2 Sets or returns the reference source to measure "to" when taking a delay measurement or phase measurement.
  • Page 218 Commands Listed in Alphabetical Order For SOUrce2: Sets or returns the waveform to measure "to" when taking a delay measurement or phase measurement. Group Measurement Syntax MEASUrement:MEAS<x>:SOUrce<x> {CH<x>|MATH|} MEASUrement:MEAS<x>:SOUrce<x>? Arguments is an input channel waveform, where x is the channel number. CH<x>...
  • Page 219 Commands Listed in Alphabetical Order might return MEASUREMENT:MEAS1:STATE? :MEASUREMENT:MEAS1:STATE 0 indicating that measurement defined for measurement slot 1 is disabled. MEASUrement:MEAS<x>:STDdev? (Query Only) Returns the standard deviation of values accumulated for this measurement since the last statistical reset. Measurements are specified by <x>, the measurement slots, from 1 through 4.
  • Page 220 Commands Listed in Alphabetical Order (cycle area) measures the voltage over time. In other words, it measures, in CARea volt-seconds, the area over the first cycle in the waveform or the first cycle in the gated region. The area measured above the common reference point is positive, while the area below the common reference point is negative.
  • Page 221 Commands Listed in Alphabetical Order (negative overshoot) finds the negative overshoot value over the NOVershoot entire waveform or gated region. This measurement is available only on DPO models. Negative Overshoot = ((Low – Minimum) / Amplitude) × 100%) is the count of negative pulses. NPULSECount (negative width) measurement is the distance (time) between the middle NWIdth...
  • Page 222 Commands Listed in Alphabetical Order might return MEASUREMENT:MEAS1:TYPE? :MEASUREMENT:MEAS1:TYPE RMS indicating that measurement 1 is defined to measure the RMS value of a waveform. MEASUrement:MEAS<x>:UNIts? (Query Only) Returns the units associated with the specified measurement. The measurement slots are specified by <x>, which ranges from 1 through 4. Group Measurement Syntax...
  • Page 223 Commands Listed in Alphabetical Order MEASUrement:METHod Sets or returns the method used to calculate the 0% and 100% reference level. Group Measurement Syntax MEASUrement:METHod {Auto|HIStogram|MINMax} MEASUrement:METHod? Related Commands MEASUrement:REFLevel:PERCent:HIGH, MEASUrement:REFLevel:PERCent: LOW, MEASUrement:REFLevel:PERCent:MID, MEASUrement:REFLevel: PERCent:MID2 Arguments selects the best method for each data set. Auto sets the high and low waveform levels statistically using a histogram HIStogram...
  • Page 224 Commands Listed in Alphabetical Order MEASUrement:REFLevel:ABSolute:HIGH Sets or returns the high reference level, and is the upper reference level when MEASUrement:REFLevel:METHod is set to Absolute. This command affects the results of rise and fall measurements. NOTE. this command affects the associated reference level parameter for all MEASurements:IMMed and the four periodic measurements.
  • Page 225 Commands Listed in Alphabetical Order Related Commands MEASUrement:REFLevel:METHod, MEASUrement:IMMed:TYPe, MEASUrement:MEAS<x>:TYPe Arguments is the low reference level, in volts. The default is 0.0 V. <NR3> Examples sets the low reference level MEASUREMENT:REFLEVEL:ABSOLUTE:LOW 0.0 to 0.0 V. might return MEASUREMENT:REFLEVEL:ABSOLUTE:LOW? indicating :MEASUREMENT:REFLEVEL:ABSOLUTE:LOW 0.0000E+00 that the absolute low reference level is set to 0.0 V.
  • Page 226 Commands Listed in Alphabetical Order MEASUrement:REFLevel:ABSolute:MID2 Sets or returns the mid reference level for the "to" waveform when taking a delay measurement, and is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute. This command affects the results of delay measurements. NOTE.
  • Page 227 Commands Listed in Alphabetical Order MEASUrement:REFLevel:METHod Specifies or returns the reference level units used for measurement calculations. NOTE. this command affects the associated reference level parameter for all MEASurements:IMMed and the eight periodic measurements. To change the parameter for individual measurements, use the MEASUrement:MEAS<x>:REFLevel commands.
  • Page 228 Commands Listed in Alphabetical Order Syntax MEASUrement:REFLevel:PERCent:HIGH <NR3> MEASUrement:REFLevel:PERCent:HIGH? Related Commands MEASUrement:REFLevel:METHod, MEASUrement:IMMed:TYPe, MEASUrement:MEAS<x>:TYPe Arguments is the high reference level, ranging from 0 to 100%. The default high <NR3> reference level is 90%. Examples sets the high reference level MEASUREMENT:REFLEVEL:PERCENT:HIGH 95 to 95% of HIGH.
  • Page 229 Commands Listed in Alphabetical Order might return MEASUREMENT:REFLEVEL:PERCENT:LOW? indicating that the :MEASUREMENT:REFLEVEL:PERCENT:LOW 10 percentage high reference level is set to 10% of HIGH. MEASUrement:REFLevel:PERCent:MID[1] Sets or returns the percent (where 100% is equal to HIGH) that is used to calculate the mid reference level when MEASUrement:REFLevel:METHod is set to Percent.
  • Page 230 Commands Listed in Alphabetical Order Measurement Group Syntax MEASUrement:REFLevel:PERCent:MID2 <NR3> MEASUrement:REFLevel:PERCent:MID2? Related Commands MEASUrement:REFLevel:METHod Arguments is the mid reference level, ranging from 0 to 100%. The default mid <NR3> reference level is 50%. Examples sets the mid2 reference level MEASUREMENT:REFLEVEL:PERCENT:MID2 40 to 40% of HIGH.
  • Page 231 Commands Listed in Alphabetical Order MESSage This command sets or queries message parameters. Group Miscellaneous Syntax MESSage MESSage? Examples might return MESSAGE? MESSAGE:SHOW "TP401";BOX indicating that the message parameters. 271,82,292,114;STATE 0 MESSage:BOX Sets or returns the size and position of the message window. This command does not display the message unless MESSage:STATE is on.
  • Page 232 Commands Listed in Alphabetical Order command automatically sizes the box to fit the message. All four values are returned in a query. MESSage:CLEAR (No Query Form) Removes the message text from the message window. Group Display Syntax MESSage:CLEAR Related Commands MESSage:BOX, MESSage:SHOW, MESSage:STATE Examples...
  • Page 233 Commands Listed in Alphabetical Order The message string itself is not altered. The entire message can be returned as a query response regardless of what is displayed in the message box. The message is left-justified, and is displayed on a single line starting with the top most line in the window.
  • Page 234 Commands Listed in Alphabetical Order Index 10 Tek blue Index 11 Bright blue Index 12 Undefined Index 13 Blue Index 14 Undefined Index 15 Dark blue Bit 4 If set, the foreground color is set to the default foreground color. Bit 3 If set, the background color is set to the default background color.
  • Page 235 Commands Listed in Alphabetical Order Examples MESSage:SHOW “Hello World” displays “Hello world” in the upper left corner of the box (you can define the box size with the MESSAGE BOX command). MESSage:SHOW “ @Hello World @ ... hello” displays “Hello world ... hello” in the upper left corner of the box and the word “world”...
  • Page 236 Commands Listed in Alphabetical Order Arguments is the new password, which can contain up to 16 characters. <QString> Examples creates a new password (mypassword) for accessing NEWPASS "mypassword" your protected data. *OPC Generates the operation complete message in the Standard Event Status Register (SESR) when all pending commands that generate an OPC message are complete.
  • Page 237 Commands Listed in Alphabetical Order might return 1 to indicate that all pending OPC operations are finished. *OPC? PASSWord(No Query Form) Enables the *PUD and NEWpass set commands. Sending PASSWord without any arguments disables these same commands. Once the password is successfully entered, the *PUD and NEWpass commands are enabled until the oscilloscope is powered off, or until the FACtory command or the PASSWord command with no arguments is issued.
  • Page 238 Commands Listed in Alphabetical Order Examples ? might return PICTBRIDGE:DATEPRINT PICTBRIDGE:DATEPRINT DEFLT indicating that the default setting of the printer. enables the date print on the print output. PICTBRIDGE:DATEPRINT ON PICTBridge:DEFault (No Query Form) Sets the arguments for all PictBridge commands to their default values. The default values are the same as printer default settings.
  • Page 239 Commands Listed in Alphabetical Order PICTBridge:IMAGESize Sets or returns the image print size. Group PictBridge Syntax PICTBridge:IMAGESize {DEFLT|IN2P5BY3P25|L|IN4BY6|L2| IN8BY10|L4|E|CARD|HAGAKIPC|CM6BY8|CM7BY10|CM9BY13| CM10BY15|CM13BY18|CM15BY21|CM18BY24| A4|LETTER} Arguments for a default image print size. DEFLT for a 2_5*3_25 image print size. IN2P5BY3P25 for a 3_5*5 image print size. for a 4*6 image print size.
  • Page 240 Commands Listed in Alphabetical Order PICTBridge:PAPERSize Sets the output print paper size. Group PictBridge Syntax PICTBridge:PAPERSize {DEFLT|L|L2|HAGAKIPCARD|MM54BY86|MM100BY150 |IN4BY6|IN8BY10|LETTER|IN11BY17|A0|A1|A2|A3|A4|A5|A6|A7|A8|A9| B0|B1|B2|B3| B4|B5|B6|B7|B8|B9|ROLL89MM|ROLL127MM|ROLL100MM|ROLL210MM} Arguments for a default paper size. DEFLT for a paper size L for a paper size 2L. for a paper size Hagaki. HAGAKIPCARD for a card paper size.
  • Page 241 Commands Listed in Alphabetical Order for a B2 paper size. for a B3 paper size. for a B4 paper size. for a B5 paper size. for a B6 paper size. for a B7 paper size. for a B8 paper size. for a B9 paper size.
  • Page 242 Commands Listed in Alphabetical Order PICTBridge:PRINTQual Sets or returns the output print quality. Group PictBridge Syntax PICTBridge:PRINTQual {DEFLT|NRMAL|FINE|DRAFT} Arguments for the default quality print. DEFLT for a normal quality print. NRMAL for a fine quality print. FINE for a draft quality print. DRAFT Examples might return...
  • Page 243 Commands Listed in Alphabetical Order value sets the power-on status clear flag to true, enabling the power-on status clear preventing any SRQ assertion after power on. Examples sets the power-on status clear flag to false. *PSC 0 might return 1 to indicate that the power-on status clear flag is set to true. *PSC? *PUD Sets or returns a string of Protected User Data.
  • Page 244 Commands Listed in Alphabetical Order Arguments is a value in the range from 1 to 10, which specifies a saved setup storage <NR1> location. Examples restores the oscilloscope from a copy of the settings stored in memory *RCL 3 location 3. RECAll:SETUp (No Query Form) Restores the state of the oscilloscope from a copy of the settings stored in memory.
  • Page 245 Commands Listed in Alphabetical Order Group Save and Recall Syntax RECAll:WAVEform <file path>,REF<x> Related Commands SAVe:WAVEform, FILESystem:CWD, FILESystem Arguments specifies a location in internal reference memory. Reference memory REF<x> location values range from 1 through 4. specifies a location for an oscilloscope setup file. <file path> is <file path>...
  • Page 246 Commands Listed in Alphabetical Order REF<x>:HORizontal:DELay:TIMe Sets or returns the horizontal delay time for reference waveform <x>, where x is the reference channel number. The delay time is expressed in seconds and is limited to ±5 times the reference horizontal scale. Group Vertical Syntax...
  • Page 247 Commands Listed in Alphabetical Order Syntax REF<x>:LABel <Qstring> REF<x>:LABel? Arguments is an alpha-numeric string of text, enclosed in quotes, that contains <Qstring> the label text for the reference channel <x> waveform. The text string is limited to 30 characters. Examples might return REF2:LABEL? :REF2:LABEL “Clk Wfm 2”...
  • Page 248 Commands Listed in Alphabetical Order Group Vertical Syntax REF<x>:TIMe? Examples might return REF2:TIME? “16:54:05” REF<x>:VERTical:POSition Sets or returns the vertical position of the reference waveform specified by <x>, where x is the reference channel number. Increasing the position value of a waveform causes the waveform to move up, and decreasing the position value causes the waveform to move down.
  • Page 249 Commands Listed in Alphabetical Order Each waveform has a vertical scale parameter. For a signal with constant amplitude, increasing the Scale causes the waveform to be displayed smaller. Decreasing the scale causes the waveform to be displayed larger. Scale affects all waveforms, but affects reference and math waveforms differently from channel waveforms: For reference and math waveforms, this setting controls the display only, graphically scaling these waveforms and having no affect on the acquisition...
  • Page 250 Commands Listed in Alphabetical Order Examples is a comment string that the oscilloscope will REM "This is a comment" ignore. *RST (No Query Form) Resets the oscilloscope to the factory default settings. The *RST command does not alter the following: Calibration data that affect device specifications The Output Queue The Service Request Enable Register setting...
  • Page 251 Commands Listed in Alphabetical Order Related Commands *RCL, RECAll:SETUp, SAVe:SETUp Arguments specifies a location in which to save the state of the oscilloscope. Location <NR1> values range from 1 through 10. Using an out-of-range location value causes an execution error. Any settings that have been stored previously at this location will be overwritten.
  • Page 252 Commands Listed in Alphabetical Order SAVe:IMAGe (No Query Form) Saves a capture of the screen image into the specified file. Supported image formats are PNG, Windows Bitmap, and TIFF. If an extension for a supported file type is added to the file name, then the corresponding format will be used. If no supported extension is added to the file, the format to use will be determined by the value obtained from the :SAVe:IMAGe:FILEFormat? query.
  • Page 253 Commands Listed in Alphabetical Order SAVe:IMAGe:LAYout Sets or returns the layout to use for saved screen images. Group Save and Recall Syntax SAVe:IMAGe:LAYout {LANdscape|PORTRait} SAVe:IMAGe:LAYout? Arguments specifies that screen images are saved in landscape format. LANdscape specifies that screen images are saved in portrait format. PORTRait SAVe:SETUp (No Query Form) Stores the state of the oscilloscope to a specified memory location.
  • Page 254 Commands Listed in Alphabetical Order SAVe:WAVEform (No Query Form) This command saves a specified waveform or all displayed waveforms (excluding serial bus waveforms). Only individual analog waveforms (CH<x>, MATH and REF<x>) can be saved to reference memory locations. You can save all displayed waveforms, excluding serial bus waveforms, to a single CSV file when the is set to SAVE:WAVEFORM:FILEFORMAT...
  • Page 255 Commands Listed in Alphabetical Order :SAVE:WAVEFORM:FILEFORMAT SPREADSHEET; :SAVE:WAVEFORM ALL, saves all displayed waveforms "E:/test_folder/test1_all.csv" (excluding serial bus waveforms) to E:/test_folder/test1_all.csv :SAVe:WAVEform:FILEFormat INTERNal; :SAVe:WAVEform ALL, saves all displayed waveforms (excluding serial bus "E:/test_folder/test1" waveforms) to individual files named E:/test_folder/test1_<wfm>.isf (for example test1_CH1.isf SAVe:WAVEform:FILEFormat Specifies or returns the file format for saved waveforms.
  • Page 256 Commands Listed in Alphabetical Order SAVe:WAVEform:GATIng Specifies whether save waveform operations should save the entire waveform (NONe) or a specified portion of the waveform. Group Save and Recall Syntax SAVe:WAVEform:GATIng {NONe|CURSors|SCREEN} SAVe:WAVEform:GATIng? Arguments turns on cursors and the gates are the waveform record points at the CURSors cursor positions.
  • Page 257 Commands Listed in Alphabetical Order sets the reduced SAVE:WAVEFORM:SPREADSHEET:RESOLUTIONREDUced resolution waveform to be saved to a CSV file. SEARCH? (Query Only) Returns all search-related settings. Group Search Syntax SEARCH? Examples might return: SEARCH? :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:CONDITION SS; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:SPI:CONDITION SS; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:DATA:MOSI:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:SPI:DATA:MOSI:VALUE "XXXXXXXX";...
  • Page 258 Commands Listed in Alphabetical Order :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:MODE ADDR7; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:MODE ADDR7; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:TYPE USER; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:TYPE USER; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:VALUE "XXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:VALUE "XXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:CONDITION SOF; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:CONDITION SOF; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:FRAMETYPE DATA; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:FRAMETYPE DATA; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:DATA:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:DATA:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:DATA:SIZE 1; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:DATA:SIZE 1; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A: BUS:B1:CAN:DATA:QUALIFIER EQUAL;...
  • Page 259 Commands Listed in Alphabetical Order :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:LIN:ERRTYPE SYNC; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:PARALLEL:VALUE "XXXXXXXXXXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:PARALLEL:VALUE "XXXXXXXXXXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:SOURCE B1;:SEARCH:SEARCH1:TRIGGER:A:TYPE EDGE; LEVEL 0.0E+0;LEVEL:CH1 0.0E+0; CH20.0E+0;CH30.0E+0;CH4 0.0E+0;MATH 0.0E+0; REF1 0.0E+0 ;REF2 0.0E+0;:SEARCH:SEARCH1:TRIGGER:A:UPPERTHRESHOLD:CH1 1.4000; CH2 1.4000; CH3 1.4000;CH4 1.4000;MATH 492.0000E-3;REF1 492.0000E-3;REF2 492.0000E-3; :SEARCH:SEARCH1:TRIGGER:A:LOWERTHRESHOLD:CH1 0.0E+0;CH2 0.0E+0; CH30.0E+0; CH4 0.0E+0;MATH 0.0E+0;REF1 0.0E+0;REF2 0.0E+0; :SEARCH:SEARCH1:TRIGGER:A:EDGE:SOURCE CH1;SLOPE RISE;...
  • Page 260 Commands Listed in Alphabetical Order THRESHOLD:CH1 0.0E+0;CH2 0.0E+0;CH3 0.0E+0;CH4 0.0E+0; MATH 0.0E+0;REF1 0.0E+0;REF2 0.0E+0; :SEARCH:SEARCH1:STATE 0 SEARCH:SEARCH<x>:COPy (No Query Form) Copies the search criteria to the trigger, or the trigger criteria to a search. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:COPy {SEARCHtotrigger|TRIGgertosearch}...
  • Page 261 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TOTAL? Returns is the total number of matches. <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS? (Query Only) Queries the settings. SEARCH:SEARCH<x>:TRIGger:A:BUS? Group Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS? SEARCH:SEARCH<x>:TRIGger:A:BUS?? Examples might return SEARCH:SEARCH1:TRIGGER:A:BUS? :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:CONDITION SS; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:SPI:CONDITION SS; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:DATA:MOSI:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:SPI:DATA:MOSI:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:DATA:MISO:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:SPI:DATA:MISO:VALUE "XXXXXXXX";...
  • Page 262 Commands Listed in Alphabetical Order :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:DATA:VALUE "XXXXXXXX"; :SEARCH1:TRIGGER:A:BUS:B1:I2C:DATA:SIZE 1; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C: DATA:SIZE 1; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:DATA:DIRECTION NOCARE; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:MODE ADDR7; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:MODE ADDR 7; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:TYPE USER; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:TYPE USER; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:I2C:ADDRESS:VALUE "XXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:I2C:ADDRESS:VALUE "XXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:CONDITION SOF; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:CONDITION SOF; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:FRAMETYPE DATA; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:FRAMETYPE DATA; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:DATA:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:CAN:DATA:VALUE "XXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:CAN:DATA:SIZE 1;...
  • Page 263 Commands Listed in Alphabetical Order :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:LIN:IDENTIFIER:VALUE "XXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:ERRTYPE SYNC; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:LIN:ERRTYPE SYNC; :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:PARALLEL:VALUE "XXXXXXXXXXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:B2:PARALLEL:VALUE "XXXXXXXXXXXXXXXX"; :SEARCH:SEARCH1:TRIGGER:A:BUS:SOURCE B1 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:CONDition Sets or returns the search condition for a CAN trigger search. is the SEARCH<x> search number and is the bus number. B<x> Conditions This command requires a DPO2AUTO application module.
  • Page 264 Commands Listed in Alphabetical Order Conditions This command requires a DPO2AUTO application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:DIRection {READ|WRITE|NOCARE} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:DIRection? Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:CONDition Arguments specifies the read condition. READ specifies the write condition. WRITE specifies either a read or write condition. NOCARE SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:QUALifier Sets or returns the CAN data qualifier for a search.
  • Page 265 Commands Listed in Alphabetical Order searches for bus data less than or equal to the value specified by LESSEQual SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:VALue. searches for bus data more than or equal to the value specified by MOREEQual SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:VALue. searches for bus data equal to the value specified by SEARCH: EQual SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:VALue.
  • Page 266 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:FRAMEtype Sets or returns the CAN Frame Type to be used if the trigger search condition is Frame Type. is the search number and is the bus number. SEARCH<x> B<x> Conditions This command requires a DPO2AUTO application module. Group Search Syntax...
  • Page 267 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN{:IDentifier|:ADDRess}:VALue Sets or returns the binary address string to be used for a CAN trigger search if the search condition is ID or IDANDDATA. is the search number SEARCH<x> is the bus number. B<x> Conditions This command requires a DPO2AUTO application module.
  • Page 268 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:ADDRess:TYPe {GENeralcall|STARtbyte|HSmode|EEPROM|USER} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:ADDRess:TYPe? Arguments specifies the GENeralcall address type. GENeralcall specifies the STARtbyte address type. STARtbyte specifies the HSmode address type HSmode specifies the EEPROM address type. EEPROM specifies a user address. USER SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:ADDRess:VALue Sets or returns the binary address string to be used for an I2C trigger search if...
  • Page 269 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:CONDition {STARt|STOP|REPEATstart|ACKMISS|ADDRess|DATA|ADDRANDDATA} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:CONDition? Arguments specifies a search based on a start condition. STARt specifies a search based on a stop condition. STOP specifies a search based on a repeat of start condition. REPEATstart specifies a search based on a missing acknowledgement condition. ACKMISS specifies a search based on an address.
  • Page 270 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:DATa:SIZe <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:DATa:SIZe? Arguments is the data string length in bytes. <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:I2C:DATa:VALue Sets or returns the binary data string to be used for an I2C trigger search if the search condition is DATA or ADDRANDDATA. is the search SEARCH<x>...
  • Page 271 Commands Listed in Alphabetical Order specifies to search on the identifier and the data. IDANDDATA specifies to search on wake up. WAKEup specifies to search on sleep. SLEEP specifies to search on errors. ERROR Examples might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:CONDITION? SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:CONDITION SYNCFIELD indicating a search on the sync field.
  • Page 272 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:QUALifier {LESSThan|MOREThan|EQUal|UNEQual| LESSEQual|MOREEQual|INrange|OUTrange} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:QUALifier? Arguments sets the LIN data qualifier to less than. LESSThan sets the LIN data qualifier to greater than. MOREThan sets the LIN data qualifier to equal. EQUal sets the LIN data qualifier to not equal. UNEQual sets the LIN data qualifier to less than or equal.
  • Page 273 Commands Listed in Alphabetical Order might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:DATA:SIZE? indicating that SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:DATA:SIZE 1 the LIN data size is 1 byte. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:VALue Sets or returns the binary data string used for a LIN search if the search condition is ID or IDANDDATA. Conditions This command requires a DPO2AUTO application module.
  • Page 274 Commands Listed in Alphabetical Order Examples might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:ERRTYPE? indicating a SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:ERRTYPE SYNC SYNC error type. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue Sets or returns the binary address string used for LIN search if search condition is ID or IDANDDATA. Conditions This command requires a DPO2AUTO application module. Group Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue...
  • Page 275 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:CONDition Sets or returns the condition for a RS232 trigger search. is the search SEARCH<x> number and is the bus number. B<x> Conditions This command requires a DPO2COMP application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:CONDition {RXSTArt|RXDATA|RXENDPacket|RXPARity|TXSTArt| TXDATA|TXENDPacket|TXPARity} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:CONDition? Arguments...
  • Page 276 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue Sets or returns the binary data string for a RS232 trigger search if the condition involves RX. is the search number and is the bus number. SEARCH<x> B<x> Conditions This command requires a DPO2COMP application module. Group Search Syntax...
  • Page 277 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:TX:DATa:VALue SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:TX:DATa:VALue? SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:CONDition Sets or returns the search condition for a SPI trigger search. is the SEARCH<x> search number and is the bus number. B<x> Conditions This command requires a DPO2EMBD application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:CONDition...
  • Page 278 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:DATa{:MOSI|:OUT}:VALue Sets or returns the binary data string for an SPI trigger search if search the condition is MOSI, or MISOMOSI. is the search number and SEARCH<x> B<x> is the bus number. Conditions This command requires a DPO2EMBD application module. Group Search Syntax...
  • Page 279 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:SOUrce {B1|B2} SEARCH:SEARCH<x>:TRIGger:A:BUS:SOUrce? Arguments specifies the Bus 1 source. specifies the Bus 2 source. SEARCH:SEARCH<x>:TRIGger:A:EDGE:SLOpe Sets or returns the slope for an edge trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax...
  • Page 280 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LEVel Sets or returns the level for an edge trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LEVel {<NR3>|TTL|ECL} SEARCH:SEARCH<x>:TRIGger:A:LEVel? Arguments specifies the trigger level, in volts. <NR3>...
  • Page 281 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LEVel:MATH {TTL|ECL} SEARCH:SEARCH<x>:TRIGger:A:LEVel:MATH? Arguments specifies a preset high level of 1.4 V. specifies a preset high level of –1.3 V SEARCH:SEARCH<x>:TRIGger:A:LEVel:REF<x> Sets or returns the specified reference waveform level for an edge trigger search to determine where to place a mark.
  • Page 282 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:CH<x> {HIGH|LOW|X} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:CH<x>? Arguments specifies the logic high. HIGH specifies the logic low. specifies a "don't care" state. SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:CLOCk:EDGE Sets or returns whether the clock edge is a rising or falling for a logic search to determine where to place a mark.
  • Page 283 Commands Listed in Alphabetical Order Arguments specifies a channel input as the clock source, where <x> = 1, 2, 3, or 4. CH<x> specifies the math waveform as the clock source. MATH specifies the reference waveform as the clock source. specifies the digital waveform as the clock source, where <x>=0–15 D<x>...
  • Page 284 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:REF<x> Sets or returns the Boolean logic criteria for a logic trigger search to determine where to place a mark. is the search number and is the SEARCH<x> REF<x> reference channel number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:REF<x>...
  • Page 285 Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:D<x> {HIGH|LOW|X} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:D<x>? Arguments specifies a high logic level. HIGH specifies a low logic level. specifies a “don't care” condition. SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:MATH Sets or returns the Boolean logic criteria for a logic pattern trigger search to determine where to place a mark.
  • Page 286 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn Sets or returns the condition for generating a logic pattern trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn {TRUe|FALSe|LESSThan|MOREThan|Than|EQUal|UNEQual} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn? Arguments places a mark when the pattern becomes true. TRUe places a mark when the pattern becomes false.
  • Page 287 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn:MORELimit Sets or returns the minimum time that the selected pattern may be true and still generate an A logic pattern search to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn:MORELimit <NR3>...
  • Page 288 Commands Listed in Alphabetical Order Arguments specifies a preset high level of 1.4 V. specifies a preset high level of –1.3 V. specifies the threshold voltage level. <NR3> SEARCH:SEARCH<x>:TRIGger:A:LOGIc:THReshold:REF<x> Sets or returns the reference waveform threshold level for a logic trigger search to determine where to place a mark.
  • Page 289 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LOWerthreshold:MATH Sets or returns the math waveform lower threshold to determine where to place a mark. This setting is applied to all math searches that use a lower threshold. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOWerthreshold:MATH...
  • Page 290 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:POLarity {NEGative|POSitive} SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:POLarity? Arguments places a mark only when the polarity of the pulse is positive. POSITIVe places a mark only when the polarity of the pulse is negative. NEGative SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:SOUrce Sets or returns the source waveform for a pulse trigger search to determine where to place a mark.
  • Page 291 Commands Listed in Alphabetical Order places a mark if the pulse width is more than the time set by the MOREthan SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WIDth command. places a mark if the pulse width is equal to the time set by the EQUal SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WIDth command within a tolerance of ±5%.
  • Page 292 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:RUNT:SOUrce Sets or returns the source setting for a runt trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:RUNT:SOUrce {CH1|CH2|CH3|CH4|MATH|REF} SEARCH:SEARCH<x>:TRIGger:A:RUNT:SOUrce? Arguments specifies an input channel as the edge source. CH1–CH4 specifies the math waveform as the search source.
  • Page 293 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:RUNT:WIDth Sets or returns the width setting for a runt trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:RUNT:WIDth <NR3> SEARCH:SEARCH<x>:TRIGger:A:RUNT:WIDth? Arguments specifies the minimum width, in seconds. <NR3>...
  • Page 294 Commands Listed in Alphabetical Order Arguments specifies an input channel as the edge source. CH1–CH4 specifies the math waveform as the search source. MATH specifies the reference waveform as the search source. SEARCH:SEARCH<x>:TRIGger:A:SETHold:CLOCk:THReshold Sets or returns the clock threshold setting for an setup/hold trigger search to determine where to place a mark.
  • Page 295 Commands Listed in Alphabetical Order specifies the math waveform as the search source. MATH specifies the reference waveform as the search source. specifies the digital waveform as the search source. D0–D15 SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa:THReshold Sets or returns the data threshold setting for an setup/hold trigger search to determine where to place a mark.
  • Page 296 Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:SETHold:SETTime <NR3> SEARCH:SEARCH<x>:TRIGger:A:SETHold:SETTime? Arguments specifies the setup time for setup and hold violation triggering. <NR3> SEARCH:SEARCH<x>:TRIGger:A:SETHold:THReshold:CH<x> Sets or returns the trigger search setup and hold lower threshold to determine where to place a mark. Search<x> is the search number, which is always 1. CH<x>...
  • Page 297 Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:SETHold:THReshold:REF<x> Sets or returns the trigger search setup and hold lower threshold to determine where to place a mark. Search<x> is the search number, which is always 1. REF<x> is the reference waveform number. Conditions MSO oscilloscopes only.
  • Page 298 Commands Listed in Alphabetical Order Arguments specifies that a pulse edge must traverse from the lower (most POSitive negative) to higher (most positive) level for transition triggering to occur. specifies that a pulse edge must traverse from the upper (most positive) NEGative to lower (most negative) level for transition triggering to occur.
  • Page 299 Commands Listed in Alphabetical Order sets the trigger to occur when the transitioning signal is not equal to UNEQual the set volts/second rate ±5%. SEARCH:SEARCH<x>:TRIGger:A:TYPe Sets or returns the trigger type setting for a search to determine where to place a mark.
  • Page 300 Commands Listed in Alphabetical Order Arguments specifies a preset high level of 1.4 V. specifies a preset high level of –1.3 V. SEARCH:SEARCH<x>:TRIGger:A:UPPerthreshold:MATH Sets or returns the math waveform upper threshold to determine where to place a mark. This setting is applied to all math waveform searches that uses an upper threshold.
  • Page 301 Commands Listed in Alphabetical Order Syntax SELect {ON|OFF} Arguments turns the selected waveform display on. turns the selected waveform display off. Examples ? might return the following SELECT :SELECT:BUS1 0;BUS2 0;CH1 1;CH2 0;CH3 0;CH4 0;MATH 0;REF1 0;REF2 0;D0 0;D1 0;D2 0;D3 0;D4 0;D5 0;D6 0;D7 0;D8 0;D9 0;D10 0;D11 0;D12 0;D13 0;D14 0;D15 0,CONTROL CH1 SELect:BUS<x>...
  • Page 302 Commands Listed in Alphabetical Order Examples turns the channel 2 waveform display on, and selects channel 2. SELECT:CH2 ON might return indicating that channel 1 is being SELECT:CH1? :SELECT:CH1 1 displayed. SELect:CONTROl Sets or returns the waveform that is the recipient of future channel-related commands, for example, the cursor commands.
  • Page 303 Commands Listed in Alphabetical Order Syntax SELect:D<x> {<NR1>|OFF|ON} SELect:D<x>? Arguments turns on the display of the specified waveform. This waveform also becomes the selected waveform. turns off the display of the specified waveform. = 0 turns off the display of the specified waveform; any other value turns <NR1>...
  • Page 304 Commands Listed in Alphabetical Order SELect:REF<x> Turns on and off the display of the reference waveform <x>. The <x > variable represents the reference channel number. The query returns whether the channel is on or off. Group Vertical Syntax SELect:REF<x> {ON|OFF|<NR1>} SELect:REF<x>? Arguments turns on the display of the specified waveform.
  • Page 305 Commands Listed in Alphabetical Order Related Commands HEADer, *LRN?, VERBose Examples returns a long response, part of which could be as follows: SET? :SET :ACQUIRE:STOPAFTER RUnsTOP;STATE 1;MODE SAMPLE;NUMENV INFINITE;NUMAVG 16;SAMPLINGMODE RT;:HEADER 1;:LOCK NONE;:LANGUAGE ENGLISH;:VERBOSE 1;:ALIAS:STATE 0;: DISPLAY:COLOR:PALETTE NORMAL;:DISPLAY:PERSISTENCE 0.0000;CLOCK 1;GRATICULE FULL;INTEnsITY:WAVEFORM 30;GRATICULE 75;BACKLIGHT HIGH;:HARDCOPY:INKSAVER OFF;LAYOUT LANDSCAPE;PREVIEW 0;...
  • Page 306 Commands Listed in Alphabetical Order SETUP<x>:LABEL Sets or returns the setup label for the specified channel <x>. Group Save and Recall Syntax SETUP<x>:LABEL <Qstring> Arguments is an alpha-numeric string of characters, enclosed in quotes, that <Qstring> defines the label text for SETUP<x>. The length of the string is limited to 30 characters.
  • Page 307 Commands Listed in Alphabetical Order Arguments is a value in the range from 0 through 255. The binary bits of the SRER <NR1> are set according to this value. Using an out-of-range value causes an execution error. The power-on default for SRER is 0 if *PSC is 1. If *PSC is 0, the SRER maintains the previous power cycle value through the current power cycle.
  • Page 308 Commands Listed in Alphabetical Order 10000 :WFMINPRE:PT_FMT Y :WFMINPRE:XUNIT "s" :WFMINPRE:XINCR 4.0000E-9 :WFMINPRE:XZERO 0.0000 :WFMINPRE:PT_OFF 0 :WFMINPRE:YUNIT "V" :WFMINPRE:YMULT 4.0000E-3 :WFMINPRE:YOFF 0.0000 :WFMINPRE:YZERO 0.0000 DATA:DESTINATION REF1 DATA:ENCDG RIBINARY DATA:SOURCE CH1 DATA:START 1 DATA:STOP 10000 DATA:WIDTH 1 :DATA:RESOLUTION FULL :DATA:COMPOSITION COMPOSITE_YT NOTE.
  • Page 309 Commands Listed in Alphabetical Order Syntax TIME <QString> TIME? Related Commands DATE Arguments is a time in the form "hh:mm:ss" where hh refers to a two-digit hour <QString> number, mm refers to a two-digit minute number from 00 to 59, and ss refers to a two-digit second number from 00 to 59.
  • Page 310 Commands Listed in Alphabetical Order TRIGger (No Query Form) Forces a trigger event to occur. Group Trigger Syntax TRIGger FORCe TRIGger? Arguments creates a trigger event. If TRIGger:STATE is set to READy, the acquisition FORCe will complete. Otherwise, this command will be ignored. Examples forces a trigger event to occur.
  • Page 311 Commands Listed in Alphabetical Order 800.0000E-3;:TRIGGER:A:LOWERTHRESHOLD:CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A:HOLDOFF:TIME 20.0000E-9;:TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;:TRIGGER:A:LOGIC:CLASS SETHOLD;FUNCTION AND;THRESHOLD: CH1 20.0000E-3;CH2 0.0000;CH3 0.0000;CH4 0.0000;:TRIGGER:A:LOGIC:INPUT:CH1 X;CH2 X;CH3 X;CH4 X;CLOCK:SOURCE NONE;EDGE RISE;:TRIGGER:A:LOGIC:PATTERN:INPUT:CH1 X; CH2 X;CH3 X;CH4 X;:TRIGGER:A:LOGIC:PATTERN:WHEN TRUE;WHEN:LESSLIMIT 4.0000E-9;MO RELIMIT 4.0000E-9;:TRIGGER:A:SETHOLD:CLOCK:SOURCE CH1;EDGE RISE;THRESHOLD 20.000 0E-3;:TRIGGER:A:SETHOLD:DATA:SOURCE CH2;THRESHOLD 0.0000;:TRIGGER:A:SETHOLD:HOLD TIME 4.0000E-9;SETTIME 4.0000E-9;:TRIGGER:A:PULSE:CLASS TRAnsITION;:TRIGGER:A:PULSEWIDTH:SOURCE...
  • Page 312 Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS {I2C|SPI|CAN|RS232} TRIGger:A:BUS? Arguments specifies the Inter-IC bus. specifies the Serial Peripheral Interface bus. specifies the Controller Area Network bus. TRIGger:A:BUS:B<x>:CAN:CONDition Sets or returns the CAN trigger condition for bus <x>, where x is the bus number. Conditions Requires a DPO2AUTO application module.
  • Page 313 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:CAN:DATa:DIRection Sets or returns the CAN trigger data direction to be valid on a Read, Write, or Either condition for bus <x>, where x is the bus number. This applies only, if the trigger condition is ID. Conditions Requires a DPO2AUTO application module.
  • Page 314 Commands Listed in Alphabetical Order sets the oscilloscope to trigger when the data is not equal to the qualifier UNEQual value. sets the oscilloscope to trigger when the data is less than or equal LESSEQual to the qualifier value. sets the oscilloscope to trigger when the data is more than or equal MOREEQual to the qualifier value.
  • Page 315 Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:CAN:DATa:VALue <QString> TRIGger:A:BUS:B<x>:CAN:DATa:VALue? Arguments is the CAN data value in binary format. The only allowed characters <QString> in the are 0, 1, and X. QString Examples sets the CAN data value to 1011. TRIGGER:A:BUS:B1:CAN:DATA:VALUE 1011 TRIGger:A:BUS:B<x>:CAN:FRAMEtype Sets or returns the frame type for a CAN FRAMEType trigger.
  • Page 316 Commands Listed in Alphabetical Order Conditions This command requires a DPO2AUTO application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:CAN{:IDentifier|:ADDRess}:MODe {STandard|EXTended} TRIGger:A:BUS:B<x>:CAN{:IDentifier|:ADDRess}:MODe? Arguments specifies the standard addressing mode. STandard specifies the extended addressing mode. EXTended TRIGger:A:BUS:B<x>:CAN{:IDentifier|:ADDRess}:VALue Sets or returns the binary address string used for a CAN trigger if the trigger condition is ID or IDANDDATA.
  • Page 317 Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:I2C:ADDRess:MODe {ADDR7|ADDR10} TRIGger:A:BUS:B<x>:I2C:ADDRess:MODe? Arguments specifies the 7-bit I C address mode. ADDR7 specifies the 10-bit I C address mode. ADDR10 Examples sets the I2C address mode TRIGGER:A:BUS:B1:I2C:ADDRESS:MODE ADDR10 to 10-bit. TRIGger:A:BUS:B<x>:I2C:ADDRess:TYPe Sets or returns the I C address type.
  • Page 318 Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:I2C:ADDRess:VALue <QString> TRIGger:A:BUS:B<x>:I2C:ADDRess:VALue? Arguments is up to 7 or 10-bits depending on the address mode that specifies the <QString> address. The only allowed characters in the are 0, 1, and X. QString Examples sets the I C address value TRIGGER:A:BUS:B1:I2C:ADDRESS:VALUE 1011 to XXX1011.
  • Page 319 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:I2C:DATa:DIRection Sets or returns the I C trigger type to be valid on a Read, Write, or Either condition. Read or write is indicated by the R/W bit in the I C protocol. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module.
  • Page 320 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:I2C:DATa:VALue Sets or returns the binary data string used for I2C triggering if the trigger condition is DATA or ADDRANDDATA. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module. Group Trigger Syntax...
  • Page 321 Commands Listed in Alphabetical Order Examples sets the LIN trigger condition TRIGGER:A:BUS:B1:LIN:CONDITION ERROR to error. might return TRIGGER:A:BUS:B1:LIN:CONDITION? indicating that the LIN TRIGGER:A:BUS:B1:LIN:CONDITION SYNCFIELD trigger condition is sync field. TRIGger:A:BUS:B<x>:LIN:DATa:HIVALue Sets or returns the binary data string to be used for LIN trigger if trigger condition is ID or IDANDDATA.
  • Page 322 Commands Listed in Alphabetical Order Arguments sets the LIN data qualifier to less than. LESSThan sets the LIN data qualifier to greater than. MOREThan sets the LIN data qualifier to equal. EQUal sets the LIN data qualifier to not equal. UNEQual sets the LIN data qualifier to less than or equal.
  • Page 323 Commands Listed in Alphabetical Order Conditions This command requires a DPO2AUTO application module. Group Syntax TRIGger:A:BUS:B<x>:LIN:DATa:VALue <QString> TRIGger:A:BUS:B<x>:LIN:DATa:VALue? Arguments is a quoted string that is the LIN trigger data value. <QString> Examples sets the data value to TRIGGER:A:BUS:B1:LIN:DATA:VALUE “11001101” 11001101. might return TRIGGER:A:BUS:B1:LIN:DATA:VALUE? indicating...
  • Page 324 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue Sets or returns the binary address string used for LIN trigger if the trigger condition is ID or IDANDDATA. Conditions This command requires a DPO2AUTO application module. Group Syntax TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue <QString> TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue? Arguments is the binary address string used for LIN trigger if the trigger <QString>...
  • Page 325 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:RS232C:CONDition {RXSTArt|RXDATA|RXENDPacket|RXPARity|TXSTArt| TXDATA|TXENDPacket|TXPARity|} TRIGger:A:BUS:B<x>:RS232C:CONDition? Arguments specifies a search based on the RX Start Bit. RXSTArt specifies a search based on RX Data. RXDATA specifies a search based on the RX End of Packet condition. RXENDPacket specifies a search based on the RX parity.
  • Page 326 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue? Arguments is the binary data string to be used for the trigger. <Qstring> TRIGger:A:BUS:B<x>:RS232C:TX:DATa:SIZe Sets or returns the length of the data string for a RS232 trigger if the trigger condition is TXDATA.
  • Page 327 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:SPI:CONDition Sets or returns the trigger condition for a SPI trigger. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:SPI:CONDition {SS|STARTofframe|MISO|MOSI|MISOMOSI} TRIGger:A:BUS:B<x>:SPI:CONDition? Arguments specifies the Slave Selection condition.
  • Page 328 Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:SPI:DATa{:OUT|:MOSI}:VALue Sets or returns the binary data string to be used for a SPI trigger if the trigger condition is MOSI or MISOMOSI. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO2EMBD application module. Group Trigger Syntax...
  • Page 329 Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:SOUrce {B1|B2} TRIGger:A:BUS:SOUrce? Arguments specifies the Bus 1 source. specifies the Bus 2 source. TRIGger:A:EDGE? (Query Only) Returns the trigger source, coupling, and slope for the A edge trigger. Group Trigger Syntax TRIGger:A:EDGE? Related Commands TRIGger:A:PULse?, TRIGger:A:LOGIc? Examples...
  • Page 330 Commands Listed in Alphabetical Order specifies noise-rejection coupling, which provides stable triggering NOISErej by increasing the trigger hysteresis. Increased hysteresis reduces the trigger sensitivity to noise but may require greater trigger signal amplitude. Examples sets the A edge trigger coupling to DC. TRIGGER:A:EDGE:COUPLING DC might return TRIGGER:A:EDGE:COUPLING?
  • Page 331 Commands Listed in Alphabetical Order Related Commands TRIGger:A:EDGE:SLOpe, TRIGger:A:EDGE:COUPling Arguments specifies an analog input channel as the A edge trigger source. CH1–CH4 specifies a digital input channel as the A edge trigger source. D0–D15 specifies an external trigger using the Aux In connector located on the front panel of the oscilloscope.
  • Page 332 Commands Listed in Alphabetical Order Arguments specifies the holdoff time in seconds. The range is from 20 ns through 8.0 s. <NR3> Examples might return TRIGGER:A:HOLDOFF:TIME ? :TRIGGER:A:HOLDOFFTIME indicating that the A trigger holdoff time is set to 1.2 µs. 1.2000E-06 sets the A trigger holdoff time to 10 s.
  • Page 333 Commands Listed in Alphabetical Order Examples sets the auxiliary input trigger level to -1.3 TRIGGER:A:LEVEL:AUXIN ECL volts. might return TRIGGER:A:LEVEL:AUXIN? TRIGGER:A:LEVEL:AUXIN 0.0E+0 indicating that the auxiliary input trigger level is 0.0 volts. TRIGger:A:LEVel:CH<x> Sets or returns the trigger level for the specified channel. Each channel can have an independent level.
  • Page 334 Commands Listed in Alphabetical Order Arguments specifies a preset high level of –1.3 V. specifies a preset high level of 1.4 V. specifies the trigger level in volts. <NR3> TRIGger:A:LOGIc? (Query Only) Returns all of the A logic trigger parameters. Group Trigger Syntax...
  • Page 335 Commands Listed in Alphabetical Order 3, and 4 are met on four-channel oscilloscopes. On two-channel oscilloscopes, only channel 1 and channel 2 are available. is set to one of the channels, When the TRIGger:A:LOGIc:INPut:CLOCk:SOUrce sets the oscilloscope to trigger when the specified logical combinations of LOGIC the remaining channels is true during a transition on the clock channel.
  • Page 336 Commands Listed in Alphabetical Order TRIGger:A:LOGIc:INPut? (Query Only) Returns the logic input values for all channels. If a clock channel is defined, it returns the clock source and edge. Group Trigger Syntax TRIGger:A:LOGIc:INPut? Examples might return TRIGGER:A:LOGIC:INPUT? :TRIGGER:A:LOGIC:INPUT:CH1 indicating that a logic high is expected on channel 1 while HIGH;CH2 X;CH3 X channel 2 and channel three are “don't care.”...
  • Page 337 Commands Listed in Alphabetical Order Syntax TRIGger:A:LOGIc:INPut:CLOCk:EDGE {FALL|RISe|EITher} TRIGger:A:LOGIc:INPut:CLOCk:EDGE? Arguments specifies to trigger on the rising or positive edge of a signal. RISe specifies to trigger on the falling or negative edge of a signal. FALL specifies to trigger either on the falling or rising edge of a signal. EITher TRIGger:A:LOGIc:INPut:CLOCk:SOUrce Sets or returns the channel to use as the clock source.
  • Page 338 Commands Listed in Alphabetical Order TRIGger:A:LOGIc:PATtern? (Query Only) Returns the conditions used for generating an A logic pattern trigger, with respect to the defined input pattern, and identifies the time that the selected pattern may be true and still generate the trigger. Group Trigger Syntax...
  • Page 339 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:LOGIc:PATtern:INPut:D<x> {HIGH|LOW|X} TRIGger:A:LOGIc:PATtern:INPut:D<x>? Arguments specifies a logic high. HIGH specifies a logic low. specifies a “do not care” state. TRIGger:A:LOGIc:PATtern:WHEn Sets or returns the pattern logic condition on which to trigger the oscilloscope. Group Trigger Syntax...
  • Page 340 Commands Listed in Alphabetical Order TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit Sets or returns the maximum time that the selected pattern may be true and still generate an A logic pattern trigger. Group Trigger Syntax TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit <NR3> TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit? Arguments specifies the maximum amount of time to hold the pattern true. <NR3>...
  • Page 341 Commands Listed in Alphabetical Order TRIGger:A:LOGIc:THReshold:(CH<x>|D<x>) This command sets or queries the logic trigger threshold voltage for both analog and digital channels (for MSO models), specified by x. Group Trigger Syntax TRIGger:A:LOGIc:THReshold:(CH<x>|D<x>) {<NR3>|ECL|TTL} TRIGger:A:LOGIc:THReshold:(CH<x>|D<x>)? Arguments specifies the threshold voltage, in volts. <NR3>...
  • Page 342 Commands Listed in Alphabetical Order Examples sets the lower limit threshold for TRIGGER:A:LOWERTHRESHOLD:CH2 50E-3 CH2 of the pulse runt trigger to 50 mV. might return TRIGGER:A:LOWERTHRESHOLD:CH2? :TRIGGER:A: indicating that the lower limit threshold LOWERTHRESHOLD:CH2 1.2000E-01 for CH2 of the pulse runt trigger is set to 120 mV. TRIGger:A:LOWerthreshold{:EXT|:AUX} Sets or returns the lower threshold for the Auxiliary Input.
  • Page 343 Commands Listed in Alphabetical Order might return indicating that a TRIGGER:A:MODE ? :TRIGGER:A:MODE NORMAL valid trigger event must occur before a trigger is generated. TRIGger:A:PULse? (Query Only) Returns the A pulse trigger parameters. Group Trigger Syntax TRIGger:A:PULse? Related Commands TRIGger:A:EDGE?, TRIGger:A:LOGIc? Examples might return...
  • Page 344 Commands Listed in Alphabetical Order Examples specifies a width pulse for the A trigger. TRIGGER:A:PULSE:CLASS WIDTH might return TRIGGER:A:PULSE:CLASS? :TRIGGER:A:PULSE:CLASS WIDTH indicating that a pulse was found that is of the specified polarity and width. TRIGger:A:PULSEWIDth? (Query Only) Returns the width parameters for the pulse width trigger. Group Trigger Syntax...
  • Page 345 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:PULSEWidth:SOUrce {{CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15|LINE|EXT} TRIGger:A:PULSEWidth:SOUrce? Arguments specifies an analog input channel as the A edge trigger source. CH1–CH4 specifies an digital input channel as the A edge trigger source. D0–D15 specifies an external trigger using the Aux In connector located on the front panel of the oscilloscope.
  • Page 346 Commands Listed in Alphabetical Order Examples specifies that the duration of the A TRIGGER:A:PULSEWIDTH:WHEN LESSTHAN pulse will fall within defined high and low limits. might return TRIGGER:A:PULSEWIDTH:WHEN? :TRIGGER:A:PULSEWIDTH: indicating that the conditions for generating a width trigger. WHEN THAN TRIGger:A:PULSEWidth:WIDth Sets or returns the width setting for the pulse width trigger.
  • Page 347 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:RUNT:POLarity {EITher|NEGative|POSitive} TRIGger:A:RUNT:POLarity? Arguments indicates that the rising edge crosses the low threshold and the falling POSitive edge recrosses the low threshold without either edge ever crossing the high threshold. indicates that the falling edge crosses the high threshold and the NEGative rising edge recrosses the high threshold without either edge ever crossing the low threshold.
  • Page 348 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:RUNT:WHEn {LESSthan|MOREthan|EQual|UNEQual|OCCURS} TRIGger:A:RUNT:WHEn? Related Commands TRIGger:A:RUNT:WIDth Arguments argument specifies a trigger event if a runt of any detectable width occurs. OCCURS argument sets the oscilloscope to trigger if the a runt pulse is detected LESSthan with width less than the time set by the TRIGger:A:RUNT:WIDth...
  • Page 349 Commands Listed in Alphabetical Order Examples sets the minimum width of the pulse runt TRIGGER:A:RUNT:WIDTH 15E-6 trigger to 15 µs. might return TRIGGER:A:RUNT:WIDTH? :TRIGGER:A:PULSE:RUNT:WIDTH indicating that the minimum width of a pulse runt trigger is 2 ns. 2.0000E-09 TRIGger:A:SETHold? (Query Only) Returns the clock edge polarity, voltage threshold and source input;...
  • Page 350 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:SETHold:CLOCk:EDGE {FALL|RISe} TRIGger:A:SETHold:CLOCk:EDGE? Arguments specifies polarity as the clock falling edge. FALL specifies polarity as the clock rising edge. RISe Examples specifies the polarity as the clock TRIGGER:A:SETHOLD:CLOCK:EDGE RISE rising edge. might return TRIGGER:A:SETHOLD:CLOCK:EDGE? :TRIGGER:A:SETHOLD: indicating that polarity is specified as the clock rising edge.
  • Page 351 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:SETHold:CLOCk:THReshold {<NR3>|TTL|ECL} TRIGger:A:SETHold:CLOCk:THReshold? Arguments specifies a preset high level of 1.4 V. specifies a preset high level of –1.3 V. is the clock level, in volts. <NR3> Examples specifies the preset TTL value TRIGGER:A:SETHOLD:CLOCK:THRESHOLD TTL of 1.4 V as the clock threshold for the setup and hold trigger.
  • Page 352 Commands Listed in Alphabetical Order Syntax DPO Models: TRIGger:A:SETHold:DATa:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} TRIGger:A:SETHold:DATa:SOUrce? Related Commands TRIGger:A:SETHold:CLOCk:SOUrce Arguments DPO Models: specifies the source channel number and is one of CH1–CH4, and <wfm> D0–D15. You can specify only one waveform on a DPO. Examples sets channel 1 as the clock source TRIGGER:A:SETHOLD:DATA:SOURCE CH1...
  • Page 353 Commands Listed in Alphabetical Order TRIGger:A:SETHold:HOLDTime Sets or returns the hold time for setup and hold violation triggering. Group Trigger Syntax TRIGger:A:SETHold:HOLDTime <NR3> TRIGger:A:SETHold:HOLDTime? Arguments specifies the hold time setting in seconds. Positive values for hold time <NR3> occur after the clock edge. Negative values occur before the clock edge. Examples sets the hold time for the setup and TRIGGER:A:SETHOLD:HOLDTIME 3.0E-3...
  • Page 354 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:SETHold:THReshold:CH<x> {<NR3>|ECL|TTL} TRIGger:A:SETHold:THReshold:CH<x>? Arguments specifies the threshold voltage, in volts. <NR3> specifies a preset high level of –1.3 V. specifies a preset high level of 1.4 V. Examples sets the channel 1 threshold TRIGGER:A:SETHOLD:THRESHOLD:CH1 1.5 to 1.5 volts.
  • Page 355 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A{:TRANsition|:RISEFall}? Related Commands TRIGger:A:UPPerthreshold:CH<x> TRIGger:A:LOWerthreshold:CH<x> Examples might return TRIGGER:A::TRAnsITION? :TRIGGER:A:TRANSITION:POLARITY POSITIVE;WHEN SLOWER;DELTATIME 8.0000E-9 TRIGger:A{:TRANsition|:RISEFall}:DELTatime Sets or returns the delta time used in calculating the transition value for the transition trigger. Group Trigger Syntax TRIGger:A{:TRANsition|:RISEFall}:DELTatime <NR3>...
  • Page 356 Commands Listed in Alphabetical Order Arguments indicates that a pulse edge must traverse from the lower (most POSitive negative) to higher (most positive) level for transition triggering to occur. indicates that a pulse edge must traverse from the upper (most positive) NEGative to lower (most negative) level for transition triggering to occur.
  • Page 357 Commands Listed in Alphabetical Order Syntax TRIGger:A{:TRANsition|:RISEFall}:WHEn {SLOWer|FASTer|EQual|UNEQual} TRIGger:A{:TRANsition|:RISEFall}:WHEn? Arguments sets the trigger to occur when the signal transition time is faster than the FASTer time set by TRIGger:A{TRAnsition|:RISEFall}:DELTatime sets the trigger to occur when the signal transition time is slower than the SLOWer time set by.
  • Page 358 Commands Listed in Alphabetical Order specifies that a trigger occurs when specified conditions are met and is LOGic controlled by the TRIGger:A:LOGIc? commands. specifies that a trigger occurs when a specified pulse is found and is PULSe controlled by the TRIGger:A:PULse? commands.
  • Page 359 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:VIDeo? Examples might return TRIGGER:A:VIDEO? :TRIGGER:A:VIDEO:POLARITY POSITIVE;SOURCE CH1;STANDARD NTSC;SYNC ALLLINES;HOLDOFF:FIELD 0.0000;:TRIGGER:A:VIDEO:CUSTOM:FORMAT PROGRESSIVE;SCANRATE15K;:TRIGGER: A:VIDEO:LINE 1;HDTV:FORMAT HD1080I60 TRIGger:A:VIDeo:HOLDoff:FIELD Sets or returns the video trigger holdoff in terms of video fields. Group Trigger Syntax TRIGger:A:VIDeo:HOLDoff:FIELD <NR3> TRIGger:A:VIDeo:HOLDoff:FIELD? Arguments argument is a real number from 0.0 to 8.5 in increments of 0.5.
  • Page 360 Commands Listed in Alphabetical Order Related Commands TRIGger:A:VIDeo{:SYNC|:FIELD} Arguments argument is an integer that sets the video line number on which the <NR1> oscilloscope triggers. The following table lists the valid choices, depending on the active video standard. Table 2-41: Video Line Numbering Ranges Video Standard Line Number Range 525/NTSC...
  • Page 361 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:VIDeo:SOUrce {CH1|CH2|CH3|CH4} TRIGger:A:VIDeo:SOUrce? Arguments specifies the input channel to use as the A video trigger. CH1–CH4 specifies the input channel to use as the A video trigger. D0–D15 Examples sets the source for A video trigger to Channel 1. TRIGGER:A:VIDEO:SOURCE CH1 might return TRIGGER:A:VIDEO:SOURCE?
  • Page 362 Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:VIDeo{:SYNC|:FIELD} {ODD|EVEN|ALLFields|ALLLines|NUMERic} TRIGger:A:VIDeo{:SYNC|:FIELD}? Arguments argument sets the oscilloscope to trigger on interlaced video odd fields. argument sets the oscilloscope to trigger on interlaced video even fields. EVEN argument sets the oscilloscope to trigger on all fields. ALLFields argument sets the oscilloscope to trigger on all video lines.
  • Page 363 Commands Listed in Alphabetical Order Examples might return TRIGGER:EXTERNAL:PROBE? :TRIGGER:EXTERNAL:PROBE for a 10X probe. 1.0E1 TRIGger:EXTernal:YUNIts? (Query Only) Returns the external trigger vertical (Y) units value. Group Trigger Syntax TRIGger:EXTernal:YUNIts? Examples might return TRIGGER:EXTERNAL:YUNITS? TRIGGER:EXTERNAL:YUNITS if the vertical unit is volts. “V”...
  • Page 364 Commands Listed in Alphabetical Order indicates that the oscilloscope is in the automatic mode and acquires data AUTO even in the absence of a trigger. indicates that all pretrigger information has been acquired and that the READY oscilloscope is ready to accept a trigger. indicates that the oscilloscope is in save mode and is not acquiring data.
  • Page 365 Commands Listed in Alphabetical Order USBDevice:CONFigure Enables or disables the rear USB port for use with Pictbridge printers. Group PictBridge Syntax USBDevice:CONFigure {DISabled|IMAge|USBTmc} USBDevice:CONFigure? Arguments disables the rear USB port. DISabled enables the rear USB port as an SIC device. IMAge enables the rear USB port as a USBTMC device.
  • Page 366 Commands Listed in Alphabetical Order USBTMC:PRODUCTID:HEXadecimal? (Query Only) Returns the product ID of the USBTMC device in hexadecimal format. Group Misc Syntax USBTMC:PRODUCTID:HEXadecimal? Examples might return USBTMC:PRODUCTID:HEXADECIMAL? indicating that the product ID in USBTMC:PRODUCTID:HEXADECIMAL 0x0372 hexadecimal format is 0x0372. USBTMC:SERIALnumber? (Query Only) Returns the serial number of the USBTMC device.
  • Page 367 Commands Listed in Alphabetical Order Group Misc Syntax USBTMC:VENDORID:HEXadecimal? Examples might return USBTMC:VENDORID:HEXADECIMAL? indicating that 0x0689 is the USBTMC:VENDORID:HEXADECIMAL 0x0699 Vendor ID in hexadecimal format. VERBose Sets or returns the Verbose state that controls the length of keywords on query responses.
  • Page 368 Commands Listed in Alphabetical Order *WAI (No Query Form) Prevents the oscilloscope from executing further commands or queries until all pending commands that generate an OPC message are complete. This command allows you to synchronize the operation of the oscilloscope with your application program.
  • Page 369 Commands Listed in Alphabetical Order “V”;YMULT 4.0000E-3;YOFF 0.0000;YZERO 0.0000;:CURVE 2,1,4,2,4,3,0,3,3,3,3,3,3,4,3,5,6,6,7,3 WFMInpre? (Query Only) Returns the waveform formatting and scaling specifications to be applied to the next incoming CURVe command data. Group Waveform Transfer Syntax WFMInpre? Related Commands WFMOutpre? Examples might return the waveform formatting as WFMINPRE? :WFMINPRE:BIT_NR 8;BN_FMT RI;BYT_NR 1;...
  • Page 370 Commands Listed in Alphabetical Order WFMInpre:BN_Fmt Sets or returns the format of binary data for incoming waveforms. Group Waveform Transfer Syntax WFMInpre:BN_Fmt {RI|RP} WFMInpre:BN_Fmt? Related Commands WFMOutpre:BN_Fmt Arguments specifies signed integer data point representation. specifies positive integer data point representation. Examples specifies positive integer data point representation.
  • Page 371 Commands Listed in Alphabetical Order WFMInpre:BYT_Or Sets or returns which byte of binary waveform data is expected first for incoming waveform data when data points require than one byte. This specification only has meaning when WFMInpre:ENCdg is set to BIN and WFMInpre:BYT_Nr is 2.
  • Page 372 Commands Listed in Alphabetical Order Examples might return WFMINPRE:COMPOSITION? :WFMINPRE:COMPOSITION indicating that the sample part of singular waveform is transferred SINGULAR_YT to the instrument. sets the sample part of composite WFMINPRE:COMPOSITIONCOMPOSITE_YT waveform to be transferred to the instrument. WFMInpre:ENCdg Sets or returns the type of encoding for incoming waveform data. Group Waveform Transfer Syntax...
  • Page 373 Commands Listed in Alphabetical Order Examples might return WFMINPRE:FILTERFREQ? :WFMINPRE:FILTERFREQ 200000000 indicating that the FilterVu frequency for the incoming waveform is 200 MHz. sets the FilterVu frequency for the WFMINPRE:FILTERFREQ 3000000000 incoming waveform to 300 MHz. WFMInpre:NR_Pt Sets or returns the number of data points that are in the incoming waveform record. Group Waveform Transfer Syntax...
  • Page 374 :WFMINPRE:PT_FMT ENV waveform is transmitted as maximum and minimum point pairs. WFMInpre:PT_Off The set form of this command is ignored. The query form always returns a 0. This command is listed for compatibility with other Tektronix oscilloscopes. Group Waveform Transfer Syntax WFMInpre:PT_Off <NR1>...
  • Page 375 Commands Listed in Alphabetical Order Syntax WFMInpre:XINcr <NR3> WFMInpre:XINcr? Related Commands WFMInpre:XUNit, WFMOutpre:XINcr? Arguments is the horizontal interval representation. <NR3> Examples sets the interval between incoming waveform points WFMINPRE:XINCR 3E-3 to 3 ms. might return indicating WFMINPRE:XINCR ? :WFMINPRE:XINCR 1.0000E-3 that if WFMInpre:XUNit is set to "s", there is a 1 ms interval between incoming waveform points.
  • Page 376 Commands Listed in Alphabetical Order WFMInpre:XZEro Sets or returns the position value, in XUNits, of the first sample of the incoming waveform. Group Waveform Transfer Syntax WFMInpre:XZEro <NR3> WFMInpre:XZEro? Related Commands WFMInpre:XINcr, WFMInpre:XUNit, WFMOutpre:XZEro? Arguments argument is the floating point value of the position, in XUNits, of the first <NR3>...
  • Page 377 Commands Listed in Alphabetical Order Related Commands DATa:DESTination, WFMInpre:BYT_Nr, WFMInpre:YUNit Arguments is the vertical scale factor per digitizing level of the incoming waveform <NR3> points. Examples might return , which (if WFMINPRE:YMULT? :WFMINPRE:YMULT 40.0000E-3 YUNit is “V”) indicates that the vertical scale is 40 mV/digitizing level (1V/div for 8-bit data).
  • Page 378 Commands Listed in Alphabetical Order might return indicating that the vertical WFMINPRE:YOFF? :WFMINPRE:YOFF 25 position of the incoming waveform in digitizing levels. WFMInpre:YUNit Sets or returns the vertical units of the incoming waveform. Supported units are: %, /Hz, A, A/A, A/V, A/W, A/dB, A/s, AA, AW, AdB, As, B, Hz, IRE, S/s, V, V/A, V/V, V/W, V/dB, V/s, VV, VW, VdB, Volts, Vs, W, W/A, W/V, W/W, W/dB, W/s, WA, WV, WW, WdB, Ws, dB, dB/A, dB/V, dB/W, dB/dB, dBA, dBV, dBW, dBdB, day, degrees, div, hr, min, ohms, percent, s...
  • Page 379 Commands Listed in Alphabetical Order Group Waveform Transfer Syntax WFMInpre:YZEro <NR3> WFMInpre:YZEro? Related Commands WFMInpre:YUNit, WFMOutpre:YZEro? Arguments is the offset in YUNits. <NR3> Examples specifies that the zero reference point for the WFMINPRE:YZERO 1.5E+0 incoming waveform is 1.5 V below the center of the data range (given that WFMInpre:YUNit is set to V).
  • Page 380 Commands Listed in Alphabetical Order 4.0000E-9;XZERO - 20.0000E-6;PT_OFF 0;YUNIT “V”;YMULT 15.6250E-6;YOFF :”6.4000E+3;YZERO 0.0000 WFMOutpre:BIT_Nr Sets and returns the number of bits per waveform point that outgoing waveforms contain, as specified by the DATa:SOUrce command. Changing the value of WFMOutpre:BIT_Nr also changes the values of WFMInpre:FILTERFreq DATa:WIDth.
  • Page 381 Commands Listed in Alphabetical Order Arguments specifies signed integer data point representation. specifies positive integer data point representation. Examples specifies that outgoing waveform data will be in positive WFMOUTPRE:BN_FMT RP integer format. might return indicating that WFMOUTPRE:BN_FMT? :WFMOUTPRE:BN_FMT RI the outgoing waveform data is currently in signed integer format. WFMOutpre:BYT_Nr Sets or returns the data width for the outgoing waveform specified by the DATa:SOUrce...
  • Page 382 Commands Listed in Alphabetical Order Syntax WFMOutpre:BYT_Or {LSB|MSB} WFMOutpre:BYT_Or? Related Commands WFMOutpre:ENCdg, WFMOutpre:BYT_Nr Arguments specifies that the least significant byte will be transmitted first. specifies that the most significant byte will be transmitted first. Examples sets the most significant outgoing byte of waveform WFMOUTPRE:BYT_OR MSB data to be transmitted first.
  • Page 383 Commands Listed in Alphabetical Order Syntax WFMOutpre:ENCdg {ASCii|BINary} WFMOutpre:ENCdg? Related Commands DATa:ENCdg, WFMOutpre:BYT_Nr, WFMInpre:FILTERFreq, WFMOutpre:BIT_Nr, WFMOutpre:BN_Fmt Arguments specifies that the outgoing data is to be in ASCII format. Waveforms ASCii will be sent as numbers. <NR1> specifies that outgoing data is to be in a binary format whose further BINary specification is determined by WFMOutpre:BYT_Nr, WFMOutpre:BIT_Nr, WFMOutpre:BN_Fmt...
  • Page 384 The set form of this command is ignored. The query form always returns a 0, if the waveform specified by DATA:SOUrce is on or displayed. If the waveform is not displayed, the query form generates an error and returns event code 2244. This command is for compatibility with other Tektronix oscilloscopes. Group Waveform Transfer...
  • Page 385 WFMOUTPRE:PT_OFF? WFMOUTPRE:PT_OFF 0 waveform specified by is on or displayed. DATA:SOURCE WFMOutpre:PT_ORder? (Query Only) This query is for compatibility with other Tektronix oscilloscopes and always returns LINEAR. Group Waveform Transfer Syntax WFMOutpre:PT_ORder? Related Commands DATa:SOUrce...
  • Page 386 Commands Listed in Alphabetical Order time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on. Group Waveform Transfer Syntax WFMOutpre:WFId? Related Commands DATa:SOUrce Returns comprises the following comma-separated fields documented in <QString> the tables below: Table 2-42: Waveform Suffixes Field...
  • Page 387 Commands Listed in Alphabetical Order WFMOutpre:XINcr? (Query Only) Returns the horizontal point spacing in units of WFMOutpre:XUNit for the waveform specified by the DATa:SOUrce command. This value corresponds to the sampling interval. The query command will time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on.
  • Page 388 Commands Listed in Alphabetical Order Group Waveform Transfer Syntax WFMOutpre:XZEro? Related Commands DATa:SOUrce, WFMOutpre:XUNit? Examples might return indicating WFMOUTPRE:XZERO? :WFMOUTPRE:XZERO 5.6300E-9 that the trigger occurred 5.63 ns before the first sample in the waveform record. WFMOutpre:YMUlt? (Query Only) Returns the vertical scale factor per digitizing level in units specified by WFMOutpre:YUNit for the waveform specified by the DATa:SOUrce command.
  • Page 389 Commands Listed in Alphabetical Order Syntax WFMOutpre:YOFf? Related Commands DATa:SOUrce, WFMOutpre:BYT_Nr Examples might return indicating WFMOUTPRE:YOFF? :WFMOUTPRE:YOFF -50.0000E+0 that the position indicator for the waveform was 50 digitizing levels (2 divisions) below center screen (for 8-bit waveform data). WFMOutpre:YUNit? (Query Only) Returns the vertical units for the waveform specified by the DATa:SOUrce command.
  • Page 390 Commands Listed in Alphabetical Order Examples might return WFMOUTPRE:YZERO? :WFMOUTPRE:YZERO -100.0000E-3 indicating that vertical offset is set to –100 mV. ZOOm? (Query Only) Returns the current vertical and horizontal positioning and scaling of the display. Group Zoom Syntax ZOOm? Examples might return ZOOM? :ZOOM:MODE 1;GRATICULE:SIZE 80;SPLIT...
  • Page 391 Commands Listed in Alphabetical Order ZOOm:ZOOM1? (Query Only) Returns the current horizontal positioning and scaling of the display. Group Zoom Syntax ZOOm:ZOOM1? Examples might return ZOOM:ZOOM1? :ZOOM:ZOOM1:STATE 1;SCALE 400.0000E-12;POSITION 46.8986;FACTOR 50.0000E+3;HORIZONTAL:POSITION 46.8986;SCALE 400.0000E-12 ZOOm:ZOOM1:FACtor? (Query Only) Returns the zoom factor of a particular zoom box. Group Zoom Syntax...
  • Page 392 Commands Listed in Alphabetical Order might return ZOOM:ZOOM1:HORIZONTAL:POSITION? indicating that the Zoom1 :ZOOM1:HORIZONTAL:POSITION 50.0000 reference pointer is currently set at 50% of acquired waveform. ZOOm:ZOOM1:HORizontal:SCAle Sets or returns the zoom horizontal scale for the specified zoom. Zoom Group Syntax ZOOm:ZOOM1:HORizontal:SCAle <NR3> ZOOm:ZOOM1:HORizontal:SCAle? Arguments is the amount of expansion in the horizontal direction and ranges from...
  • Page 393 Commands Listed in Alphabetical Order Syntax ZOOm:ZOOM1:SCAle <NR3> ZOOm:ZOOM1:SCAle? Arguments is the amount of expansion in the horizontal direction and ranges from <NR3> 1.0E-3 to 5.0. ZOOm:ZOOM1:STATE Sets or returns the specified zoom on or off, where x is the integer 1 representing the single zoom window.
  • Page 394 Commands Listed in Alphabetical Order 2-378 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 395: Status And Events

    Status and Events The oscilloscope provides a status and event reporting system for the Ethernet, GPIB (with the TEK-USB-488 Adapter), and USB interfaces. This system informs you of certain significant events that occur within the oscilloscope. The oscilloscope status handling system consists of five 8-bit registers and two queues for each interface.
  • Page 396 Status and Events Table 3-1: SESR Bit Functions Function 7 (MSB) Shows that the oscilloscope was powered on. Power On. On completion, the diagnostic self tests also set this bit. Indicates that an application event has User Request. occurred. *See note. Shows that an error occurred while Command Error.
  • Page 397 Status and Events Table 3-2: SBR Bit Functions (cont.) Function Shows that output is available Message Available. in the Output Queue. ———— Not used. ———— Not used. ———— Not used. 1–0 Enable Registers DESER, ESER, and SRER allow you to select which events are reported to the Status Registers and the Event Queue.
  • Page 398: Queues

    Status and Events Use the *SRE command to set the SRER. Use the *SRE? query to read the register. The RQS bit remains set to one until either the Status Byte Register is read with a Serial Poll or the MSS bit changes back to a zero. Figure 3-5: The Service Request Enable Register (SRER) *PSC Command The *PSC command controls the Enable Registers contents at power-on.
  • Page 399: Event Handling Sequence

    Status and Events Read the Event Queue with the EVENT? query (which returns only the event number), with the EVMSG? query (which returns the event number and a text description of the event), or with the ALLEV? query (which returns all the event numbers along with a description of the event).
  • Page 400 Status and Events Figure 3-6: Status and Event Handling Process When an event occurs, a signal is sent to the DESER (1). If that type of event is enabled in the DESER (that is, if the bit for that event type is set to 1), the appropriate bit in the SESR is set to one, and the event is recorded in the Event Queue (2).
  • Page 401: Synchronization Methods

    Status and Events Synchronization Methods Overview Although most commands are completed almost immediately after being received by the oscilloscope, some commands start a process that requires time. For example, once a single sequence acquisition command is executed, depending upon the applied signals and trigger settings, it may take an indeterminate amount of time before the acquisition is complete.
  • Page 402 Status and Events For example, a typical application might involve acquiring a single-sequence waveform and then taking a measurement on the acquired waveform. You could use the following command sequence to do this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE...
  • Page 403 Status and Events The same command sequence using the *WAI command for synchronization looks like this: /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking...
  • Page 404 Status and Events many commands to the input buffer. The controller is still tied up though, and the repeated BUSY? query will result in bus traffic. Using the *OPC Command If the corresponding status registers are enabled, the *OPC command sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete.
  • Page 405 Status and Events The same command sequence using the *OPC command for synchronization looks like this /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Enable the status registers */ DESE 1 *ESE 1 *SRE 32 /* Acquire waveform data */ ACQUIRE:STATE ON...
  • Page 406: Messages

    Status and Events /* Wait until the acquisition is complete */ *OPC? /* Take amplitude measurement */ MEASUREMENT:IMMED:VALUE? This is the simplest approach. It requires no status handling or loops. However, you must set the controller time-out for longer than the acquisition operation. Messages Messages The information contained in the tables below covers all the programming...
  • Page 407 Status and Events Table 3-4: Command Error Messages (CME Bit 5) (cont.) Code Message Parameter not allowed Missing parameter Command header error Program mnemonic too long Undefined header Numeric data error Invalid character in numeric Exponent too large Too many digits Suffix error Invalid suffix Suffix too long...
  • Page 408 Status and Events Table 3-5: Execution Error Messages (EXE Bit 4) (cont.) Code Message Corrupt media Media full Directory full File name not found File name error Media protected File name too long Hardcopy error Hardcopy device not responding Hardcopy is busy Hardcopy aborted Hardcopy configuration error Program error...
  • Page 409 Status and Events Table 3-5: Execution Error Messages (EXE Bit 4) (cont.) Code Message 2220 Measurement error, No valid edge - No arm cross 2221 Measurement error, No valid edge - No trigger cross 2222 Measurement error, No valid edge - No second cross 2223 Measurement error, Waveform mismatch 2224...
  • Page 410 Status and Events Device Error The following table lists the device errors that can occur during oscilloscope operation. These errors may indicate that the oscilloscope needs repair. Table 3-6: Device Error Messages (DDE Bit 3) Code Message System error Memory error PUD memory lost Save/recall memory lost System Event...
  • Page 411 Status and Events Table 3-8: Execution Warning Messages (EXE Bit 4) (cont.) Code Message Measurement warning, Low resolution Measurement warning, Uncertain edge Measurement warning, Invalid in minmax Measurement warning, Need 3 edges Measurement warning, Clipping positive/negative Measurement warning, Clipping positive Measurement warning, Clipping negative Table 3-9: Execution Warning Messages (EXE Bit 4) Code...
  • Page 412 Status and Events 3-18 MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 413: Appendix A: Character Set

    Appendix A: Character Set MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 414 Appendix A: Character Set MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 415 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments An analog channel of an MSO/DPO2000B and MSO/DPO2000 series instrument has a sample waveform and a peak detect waveform being acquired simultaneously. This combination waveform is referred to as a “composite” waveform.
  • Page 416 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments Composition of Waveform The MSO/DPO2000/B series introduces the concept of composite waveform data for analog channels. Sample data is always available for acquired analog channel Data waveforms. Composite waveforms are available in acquisition mode SAMPLE but are not available in...
  • Page 417 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments COMPOSITE_YT COMPOSITE_YT, COMPOSITE_ENV SINGULAR_YT The composition of the waveform data to be queried using the CURVe? or WAVFrm? queries is set using the DATa:COMPosition WFMOutpre:COMPosition command. The compositions which can be set are: COMPOSITE_YT COMPOSITE_ENV SINGULAR_YT...
  • Page 418 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments reduced resolution waveform. The filtering frequency of the full resolution waveform is not under your direct control. It is a function of the horizontal and acquisition settings and the selected FilterVu frequency. The 3 dB cutoff frequency for this filtering may be different for the LRL record and the thumbnail record.
  • Page 419 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments Querying Acquisition 1. Use the DATa:COMPosition:AVAILable? query to determine if peak detect data is available. This query returns a list of waveform Peak Detect Data from the (COMPOSITE_ENV) data types that are available from the instrument under the current instrument Instrument settings: for sample data...
  • Page 420 Appendix B: Waveform Data in MSO/DPO2000B and MSO/DPO2000 Series Instruments turned on. Use the WFMOutpre:RECOrdlength? query to determine the actual record length for digital waveforms. Extensions to the DATA Like the MSO/DPO4000/B series, the MSO/DPO2000/B series provides the DATa:WIDth command that allows you to specify the data word width (in Commands bytes) used when querying data from the instrument or when sending data to the instrument with the...
  • Page 421: Appendix C: Reserved Words

    Appendix C: Reserved Words This is a list of reserved words for your instrument. Capital letters identify the required minimum spelling. *CAL ADDRANDDATA BINary CMEan *CLS ADDRess BITOrder COLUMN COMMAND *DDT ADDress BITRate *ESE ALIas BIT_Nr COMPOSITE_ENV *ESR ALIas[ BLAckmanharris COMPOSITE_YT *IDN COMPosition...
  • Page 422 Appendix C: Reserved Words DATABits FRAMEtype HTTPPort DATE ENVelope FRAMING DATEPrint FRAme DATa EOFTYPE FREE IDANDDATA DAll EQUal FREESpace IDFORmat EQual FRENch IDLETime ERROR FREQuency IDLEtime DECimal ERRTYPE FULL IDPrint DEFLT ERRlog FULl IDentifier FUNCtion DEFault ERRor IMAGESize DEFine ETHERnet GAIN IMAGe DEGAUss...
  • Page 423 Appendix C: Reserved Words LETTER MOREthan PASS RATE35K LEVel MOSI PASSWord RATE50K PATtern RATE800K LFRej NAME PAYLength RATIO NAMe] PAYLoad RDELta LINE NANd PERCent READ LINEAr NEGative PERIod READFile LINEPeriod NEWpass PERSistence RECAll LIST NEXT PERcent RECOrdlength PHAse LOCk NEXt RECTX PHOTO RECTY...
  • Page 424 Appendix C: Reserved Words SAMPLERate SOUrce THETA SAMPLEpoint SOUrce2 THREshold VBArs SAMple SPANish THReshold VDELTa SAVe TIFf VENDORID SCAN SPECTral TIME VERBose SCAle TIMe VERT SCLK SPREADSheet TOTAL VERTical SCREEN SPace TOTal VIDeo SCREen SRIbinary TOTaluptime VOLts TRACk WAKEup SDATA SRPbinary SEARCH TRADitionalchinese...
  • Page 425: Appendix D: Application Module-Enabled Commands

    Appendix D: Application Module-enabled Commands This table lists the commands that become available with installation of an application module. MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 426 Appendix D: Application Module-enabled Commands Application Module Commands DPO2AUTO Automotive Serial Triggering and Analysis Module. Enables triggering on packet-level information on CAN and LIN buses as well as analytical tools such as digital views of the signal, bus views, packet decoding, search tools, and packet decode tables with time-stamp information.
  • Page 427 Appendix D: Application Module-enabled Commands Application Module Commands DPO2COMP Computer Serial Triggering and Analysis Module. Enables triggering on packet-level information on RS-232/422/485/UART buses as well as analytical tools such as digital views of the signal, bus views, packet decoding, search tools, and packet decode tables with time-stamp information. BUS:B<x>:RS232C:BITRate BUS:B<x>:RS232C:DATABits BUS:B<x>:RS232C:DELIMiter...
  • Page 428 Appendix D: Application Module-enabled Commands Application Module Commands DPO2EMBD Embedded Serial Triggering and Analysis Module. Enables triggering on packet-level information on I2C and SPI buses as well as analytical tools such as digital views of the signal, bus views, packet decoding, search tools, and packet decode tables with time-stamp information.
  • Page 429: Appendix E: Search And Trigger Command Sequence Examples

    Appendix E: Search and Trigger Command Sequence Examples The following are some example command sequences that show a variety of different searches and triggers. The commands in these sequences are not order-dependent. To use these examples, connect channel 1, channel 2, channel 3 and channel 4 (if available) to the probe compensation signal located on the right hand side of the front panel.
  • Page 430: Example 3: Dual Threshold Runt Search

    Appendix E: Search and Trigger Command Sequence Examples Command Comment :TRIGger:A:TYPe EDGE Specifies that this will be an edge trigger (trigger will occur when the source waveform passes through a specified threshold level in the specified direction). :TRIGger:A:EDGE:SOUrce CH2 Specifies the CH2 waveform as the source waveform. :TRIGger:A:LOWerthreshold:CH2 1.4 Specifies 1.4 volts as the threshold level.
  • Page 431 Appendix E: Search and Trigger Command Sequence Examples Command Comment *RST Resets the oscilloscope. Wait for the reset to complete (approximately 3 seconds). :SELect:CH1 1 Turns the CH1 waveform on. :SELect:CH2 1 Turns the CH2 waveform on. :SELect:CH3 1 Turns the CH3 waveform on. :AUTOSet EXECute Autosets the displayed waveforms CH1, CH2 and CH3.
  • Page 432 Appendix E: Search and Trigger Command Sequence Examples MSO2000B, DPO2000B, MSO2000 and DPO2000 Series Oscilloscopes Programmer Manual...
  • Page 433 Index BUS:B<x>:I2C{:DATA|:SDATA}:SOUrce, 2-76 BUS:B<x>:LABel, 2-77 ACQuire:MAXSamplerate?, 2-59 BUS:B<x>:LIN:BITRate, 2-77 ACQuire:MODe, 2-59 BUS:B<x>:LIN:IDFORmat, 2-77 ACQuire:NUMACq?, 2-60 BUS:B<x>:LIN:POLARity, 2-78 ACQuire:NUMAVg, 2-61 BUS:B<x>:LIN:SAMPLEpoint, 2-78 ACQuire:STATE, 2-61 BUS:B<x>:LIN:SOUrce, 2-79 ACQuire:STOPAfter, 2-63 BUS:B<x>:LIN:STANDard, 2-79 ACQuire?, 2-59 BUS:B<x>:PARallel:BIT<x>:SOUrce, 2-80 Acquisition Command Group, 2-11 BUS:B<x>:PARallel:CLOCK:EDGE, 2-80 Alias Command Group, 2-12 BUS:B<x>:PARallel:CLOCK:ISCLOCKed, 2-81 ALIas, 2-63 BUS:B<x>:PARallel:CLOCK:SOUrce, 2-81...
  • Page 434 Index CURSor:HBArs?, 2-112 CURSor:MODe, 2-114 *CAL?, 2-95 CURSor:VBArs:ALTERNATE<x>?, 2-115 CALibrate:FACtory, 2-95 CURSor:VBArs:DELTa?, 2-116 CALibrate:FACtory:STATus?, 2-96 CURSor:VBArs:HPOS<x>?, 2-116 CALibrate:INTERNal, 2-96 CURSor:VBArs:POSITION<x>, 2-117 CALibrate:INTERNal:STARt, 2-96 CURSor:VBArs:UNIts, 2-117 CALibrate:INTERNal:STATus?, 2-97 CURSor:VBArs:USE, 2-118 CALibrate:RESults:FACtory?, 2-98 CURSor:VBArs:VDELTa?, 2-118 CALibrate:RESults:SPC?, 2-98 CURSor:VBArs?, 2-115 CALibrate:RESults?, 2-97 CURSor:XY:POLar:RADIUS:DELta?, 2-119 CALibrate:TEMPerature?, 2-98 CURSor:XY:POLar:RADIUS:POSITION<x>?, 2-119 Calibration and Diagnostic Command Group, 2-16...
  • Page 435 Index *DDT, 2-134 File System Command Group, 2-20 DESE, 2-135 FILESystem, 2-155 DIAg:LOOP:OPTion, 2-135 FILESystem:CWD, 2-155 DIAg:LOOP:OPTion:NTIMes, 2-136 FILESystem:DELEte, 2-156 DIAg:LOOP:STOP, 2-136 FILESystem:DIR?, 2-156 DIAg:RESUlt:FLAg?, 2-137 FILESystem:FORMat, 2-157 DIAg:RESUlt:LOG?, 2-137 FILESystem:FREESpace?, 2-157 DIAg:SELect, 2-138 FILESystem:MKDir, 2-158 DIAg:SELect:<function>, 2-138 FILESystem:READFile, 2-158 DIAg:STATE, 2-139 FILESystem:REName, 2-159 Display Command Group, 2-18...
  • Page 436 Index MEASUrement:IMMed:SOUrce2, 2-190 MEASUrement:IMMed:TYPe, 2-191 LANGuage, 2-172 MEASUrement:IMMed:UNIts?, 2-193 LOCk, 2-172 MEASUrement:IMMed:VALue?, 2-194 *LRN?, 2-173 MEASUrement:IMMed?, 2-187 MEASUrement:INDICators:HORZ<x>?, 2-195 MEASUrement:INDICators:NUMHORZ?, 2-195 Mark Command Group, 2-23 MEASUrement:INDICators:NUMVERT?, 2-196 MARK, 2-174 MEASUrement:INDICators:STATE, 2-196 MARK:CREATE, 2-174 MEASUrement:INDICators:VERT<x>?, 2-197 MARK:DELEte, 2-175 MEASUrement:INDICators?, 2-195 MARK:FREE?, 2-175 MEASUrement:MEAS<x>:COUNt?, 2-197 MARK:SELected:END?, 2-176 MEASUrement:MEAS<x>:DELay:DIRection, 2-198...
  • Page 437 Index Miscellaneous Command Group, 2-29 SAVe:SETUp, 2-237 SAVe:WAVEform, 2-238 SAVe:WAVEform:FILEFormat, 2-239 SAVe:WAVEform:GATIng, 2-240 NEWpass, 2-219 SAVe:WAVEform:SPREADSheet:RESOlution, 2-240 Search Commands Group, 2-33 SEARCH:SEARCH<x>:COPy, 2-244 SEARCH:SEARCH<x>:STATE, 2-244 *OPC, 2-220 SEARCH:SEARCH<x>:TOTAL?, 2-244 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: CAN:CONDition, 2-247 PASSWord, 2-221 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: PICTBridge:DATEPrint, 2-221 CAN:DATa:DIRection, 2-247 PICTBridge:DEFault, 2-222 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: PICTBridge:IDPrint, 2-222 CAN:DATa:QUALifier, 2-248...
  • Page 438 Index SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut: DATa:VALue, 2-257 CLOCk:SOUrce, 2-266 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut: ERRTYPE, 2-257 D<x>, 2-267 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut: IDentifier:VALue, 2-258 MATH, 2-267 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut: PARallel:VALue, 2-258 REF<x>, 2-268 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern: RS232C:CONDition, 2-259 INPut:CH<x>, 2-268 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern: RS232C:RX:DATa:SIZe, 2-259 INPut:D<x>, 2-268 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern: RS232C:RX:DATa:VALue, 2-260 INPut:MATH, 2-269 SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>: SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:...
  • Page 439 Index SEARCH:SEARCH<x>:TRIGger:A:RUNT: SET?, 2-288 WHEn, 2-276 SETUP<x>:DATE?, 2-289 SEARCH:SEARCH<x>:TRIGger:A:RUNT: SETUP<x>:LABEL, 2-290 WIDth, 2-277 SETUP<x>:TIME?, 2-290 SEARCH:SEARCH<x>:TRIGger:A:SETHold: *SRE, 2-290 CLOCk:EDGE, 2-277 Status and Error Command Group, 2-37 SEARCH:SEARCH<x>:TRIGger:A:SETHold: *STB?, 2-291 CLOCk:SOUrce, 2-277 SEARCH:SEARCH<x>:TRIGger:A:SETHold: CLOCk:THReshold, 2-278 TEKSecure, 2-291 SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa: TIME, 2-292 SOUrce, 2-278 TOTaluptime?, 2-293 SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa: *TRG, 2-293...
  • Page 440 Index TRIGger:A:BUS:B<x>:RS232C:TX:DATa: TRIGger:A:PULSEWidth:WIDth, 2-330 SIZe, 2-310 TRIGger:A:PULSEWIDth?, 2-328 TRIGger:A:BUS:B<x>:RS232C:TX:DATa: TRIGger:A:RUNT:POLarity, 2-330 VALue, 2-310 TRIGger:A:RUNT:SOUrce, 2-331 TRIGger:A:BUS:B<x>:SPI:CONDition, 2-311 TRIGger:A:RUNT:WHEn, 2-331 TRIGger:A:BUS:B<x>:SPI:DATa:SIZe, 2-312 TRIGger:A:RUNT:WIDth, 2-332 TRIGger:A:BUS:B<x>:SPI:DATa{:IN|:MISO}: TRIGger:A:RUNT?, 2-330 VALue, 2-311 TRIGger:A:SETHold:CLOCk:EDGE, 2-333 TRIGger:A:BUS:B<x>:SPI:DATa{:OUT|:MOSI}: TRIGger:A:SETHold:CLOCk:SOUrce, 2-334 VALue, 2-312 TRIGger:A:SETHold:CLOCk:THReshold, 2-334 TRIGger:A:BUS:SOUrce, 2-312 TRIGger:A:SETHold:CLOCk?, 2-333 TRIGger:A:EDGE:COUPling, 2-313 TRIGger:A:SETHold:DATa:SOUrce, 2-335 TRIGger:A:EDGE:SLOpe, 2-314...
  • Page 441 Index USBTMC:SERIALnumber?, 2-350 WFMOutpre:BYT_Nr, 2-365 USBTMC:VENDORID:DECimal?, 2-350 WFMOutpre:BYT_Or, 2-365 USBTMC:VENDORID:HEXadecimal?, 2-350 WFMOutpre:COMPosition, 2-366 WFMOutpre:ENCdg, 2-366 WFMOutpre:FILTERFreq?, 2-367 WFMOutpre:NR_Pt?, 2-367 VERBose, 2-351 WFMOutpre:PT_Fmt?, 2-368 Vertical Command Group, 2-47 WFMOutpre:PT_Off?, 2-368 WFMOutpre:PT_ORder?, 2-369 WFMOutpre:RECOrdlength?, 2-369 WFMOutpre:WFId?, 2-369 *WAI, 2-352 WFMOutpre:XINcr?, 2-371 Waveform Transfer Command Group, 2-50 WFMOutpre:XUNit?, 2-371 WAVFrm?, 2-352 WFMOutpre:XZEro?, 2-371...

Table of Contents