Table of Contents Getting Started ....................Setting Up Remote Communications..............Command Syntax....................Command and Query Structure ................Clearing the oscilloscope ................... Command Entry....................Constructed Mnemonics ..................Argument Types....................Command Groups ....................2-11 Acquisition Command Group ................2-11 Alias Command Group..................2-12 Bus Command Group ..................
Page 6
Table of Contents Appendix A: Character Set ..................Appendix B: Reserved Words .................. Appendix C: Factory Defaults ................. Default Setup ....................Appendix D: Programming Example................Index MSO4000 and DPO4000 Series Programmer Manual...
Page 7
Table of Contents List of Figures Figure 3-1: The Standard Event Status Register (SESR) ............ Figure 3-2: The Status Byte Register (SBR) ..............Figure 3-3: The Device Event Status Enable Register (DESER) ........... Figure 3-4: The Event Status Enable Register (ESER) ............Figure 3-5: The Service Request Enable Register (SRER) ..........
Page 8
Table of Contents List of Tables Table 1-1: USB Device Parameters ................Table 2-1: Symbols for Backus-Naur Form ..............Table 2-2: Command Message Elements ..............Table 2-3: Comparison of Header Off and Header On Responses .......... Table 2-4: End of Message Terminator ................ Table 2-5: Channel Mnemonics.................
Page 9
Table of Contents Table 2-38: Channel Offset Range ................2-126 Table 2-39: DATa and WFMOutpre Parameter Settings ..........2-153 Table 2-40: FPAnel:PRESS arguments ..............2-184 Table 2-41: FPAnel:TURN arguments ..............2-185 Table 2-42: Advanced Math expression elements ............2-210 Table 2-43: Available HDTV formats............... 2-490 Table 2-44: Video Line Numbering Ranges ..............
Page 10
Table of Contents MSO4000 and DPO4000 Series Programmer Manual...
Getting Started This manual explains the use of commands for remotely controlling your oscilloscope. With this information, you can write computer programs to perform functions, such as setting the front-panel controls, taking measurements, performing statistical calculations, and exporting data for use in other programs. Setting Up Remote Communications You can remotely communicate between your oscilloscope and PC via the Ethernet, USB, and, GPIB using the TEK-USB-488 Adapter.
Product ID 0x0401 (decimal 1025) Serial number Serial number Manufacturer description “Tektronix” Interface description “USBTMC-USB488” GPIB To use GPIB, start by connecting an appropriate USB cable to the USB 2.0 high speed device port on the rear panel of your oscilloscope. Connect the other end to the TEK-USB-488 Adapter host port.
Page 13
Getting Started The oscilloscope has a USB 2.0 High speed device port to control the oscilloscope through USBTMC or GPIB with a TEK-USB-488 Adapter. The USBTMC protocol allows USB devices to communicate using IEEE488 style messages. This lets you run your GPIB software applications on USB hardware. Before setting up the oscilloscope for remote communication using the electronic (physical) GPIB interface, you should familiarize yourself with the following GPIB requirements:...
Page 14
MSO4000 and DPO4000 Series Digital Phosphor Oscilloscopes 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).
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.
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.
Command Syntax Queries Queries cause the oscilloscope to return status or setting information. Queries have the structure: [:]<Header> [:]<Header>[<Space><Argument> [<Comma><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 18
Command Syntax Abbreviating You can abbreviate many oscilloscope commands. Each command in this documentation shows the minimum acceptable abbreviations in capitals. For example, you can enter the command ACQuire:NUMAvg simply as ACQ:NUMA or acq:numa. Abbreviation rules may change over time as new oscilloscope models are introduced.
Command Syntax If the header is off: FULL;1 5. Set commands and queries may be concatenated in the same message. For example, ACQuire:MODe SAMple;NUMAVg?;STATE? is a valid message that sets the acquisition mode to sample. The message then queries the number of acquisitions for averaging and the acquisition state. Concatenated commands and queries are executed in the order received.
Command Syntax Cursor Position When cursors are displayed, commands may specify which cursor of the pair to use. Mnemonics Table 2-5: Channel Mnemonics Symbol Meaning CH<x> A channel specifier; <x> is 1 through 4. Table 2-6: Cursor Mnemonics Symbol Meaning CURSOR<x>...
Command Syntax Argument Types Commands use arguments such as enumeration, numeric, quoted string and block. Each of these arguments are listed in detail below. Enumeration Enter these arguments as unquoted text words. Like key words, enumeration arguments follow the same convention where the portion indicated in uppercase is required and that in lowercase is optional.
Command Syntax 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 23
Command Syntax MSO4000 and DPO4000 Series Programmer Manual...
Page 24
Command Syntax 2-10 MSO4000 and DPO4000 Series Programmer Manual...
Command Groups This manual lists the MSO4000 and DPO4000 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-71, Commands Listed in Alphabetical Order.) Acquisition Command Group Use the commands in the Acquisition Command Group to set up the modes and...
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.
LIN and FlexRay work on DPO4000s with serial numbers greater than C020000 and on all MSO4000s. NOTE. The parallel bus commands work with MSO4000 Series oscilloscopes only. NOTE. The Search Command Group and the Trigger Command Group also contain bus-related commands.
Page 28
Command Groups Table 2-15: Bus Commands (cont.) Commands Description BUS:B<x>:AUDio:DATa:SOUrce Sets or returns the data source waveform for the AUDIO bus BUS:B<x>:AUDio:DISplay:FORMat Sets or returns the display format for the AUDIO bus BUS:B<x>:AUDio:FRAME:SIZe Sets or returns the number of channels in each frame for the AUDIO bus BUS:B<x>:AUDio:FRAMESync:POLarity Sets or returns the frame sync polarity for...
Page 29
Command Groups Table 2-15: Bus Commands (cont.) Commands Description BUS:B<x>:LIN:SOUrce Sets or returns the LIN data source BUS:B<x>:LIN:STANDard Sets or returns the LIN standard BUS:B<x>:PARallel:BIT<x>:SOUrce Sets or returns the Parallel bit source for the specified bus BUS:B<x>:PARallel:CLOCK:EDGE Sets or returns the Parallel clock edge for the specified bus BUS:B<x>:PARallel:CLOCK:ISCLOCKed Sets or returns the Parallel bus clock function...
Page 30
Command Groups Table 2-15: Bus Commands (cont.) Commands Description BUS:B<x>:SPI{:SELect|:SS}:POLARity Sets or returns the SPI SS polarity BUS:B<x>:SPI{:SELect|:SS}:SOUrce Sets or returns the SPI SS source BUS:B<x>:STATE Turns the specified bus on and off BUS:B<x>:TYPE Sets or returns the specified bus type BUS:B<x>:USB:BITRate Sets or returns the USB bit rate BUS:B<x>:USB:PRObe...
Command Groups Calibration and Diagnostic Command Group The Calibration and Diagnostic commands provide information about the current state of oscilloscope calibration. 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, located on the DPO4000 Documentation CD-ROM in PDF format.
Command Groups You can also use the commands to select one of the following cursor functions: Off. Turns off the display of all cursors. Waveform Cursors. Consists of two cursors. Waveform cursors enable you to conveniently measure waveform amplitude and time. Screen Cursors.
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...
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 number of available digital waveform position slots DISplay:GRAticule Sets or returns the type of graticule that is displayed DISplay:FORMat Sets or returns the display format...
Command Groups Table 2-19: Ethernet Commands (cont.) Command Description ETHERnet:GATEWay:IPADDress Sets or returns the remote interface gateway IP address 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...
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 37
Command Groups Table 2-21: Hard Copy Commands (cont.) Command Description HARDCopy:INKSaver Changes hard copy output to print color traces and graticule on a white background HARDCopy:LAYout Sets or returns the page orientation for hard copy HARDCopy:PREVIEW Previews the current screen contents with the InkSaver palette applied HARDCopy:PRINTer:ADD Adds a network printer to the list of available...
Command Groups Histogram Command Group Use the commands in the Histogram Command Group to set up a histogram for measurements. Table 2-22: Histogram Commands Description Command HIStogram? Returns all histogram parameters HIStogram:BOX Sets or returns the histogram box coordinates HIStogram:COUNt Clears the histogram count and statistics HIStogram:DATa? Returns the histogram data...
Command Groups Table 2-23: Horizontal Commands (cont.) Command Description HORizontal:PREViewstate? Returns the display system preview state HORizontal:RECOrdlength Sets or returns the record length HORizontal:SAMPLERate Sets or returns the sample rate HORizontal:SCAle Sets or returns the horizontal scale Mark Command Group Use the commands in the Mark Command Group to identify areas of the acquired waveform that warrant further investigation.
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.
Command Groups Table 2-25: Math Commands (cont.) Command Description MATHVAR? Returns all numerical values used within math expressions MATHVAR:VAR<x> Sets or returns numerical values you can use within math expressions Measurement Command Group Use the commands in the Measurement Command Group to control the automated measurement system.
Page 42
Command Groups Table 2-26: Measurement Commands (cont.) Command Description MEASUrement:IMMed:SOUrce<x> Sets or returns the “from” source for all single channel immediate measurements Sets or returns the source to measure “to” for two-channel measurements MEASUrement:IMMed:TYPe Sets or returns the type of the immediate measurement MEASUrement:IMMed:UNIts? Returns the units of the immediate...
Page 43
Command Groups Table 2-26: Measurement Commands (cont.) Command Description MEASUrement:MEAS<x>:SOUrce<x> Sets or returns the “from” source for all single channel immediate measurements Sets or returns the source to measure “to” for two-channel measurements MEASUrement:MEAS<x>:STATE Sets or returns whether the specified measurement slot is computed and displayed MEASUrement:MEAS<x>:STDdev?
Command Groups Table 2-26: Measurement Commands (cont.) Command Description MEASUrement:STATIstics Clears or returns all of the statistics accumulated for all period measurements (MEAS1 through MEAS4) MEASUrement:STATIstics:MODE Turns measurement statistics on or off MEASUrement:STATIstics:WEIghting Controls the responsiveness of the mean and standard deviation to waveform changes Miscellaneous Command Group Use the commands in the Miscellaneous Command Group to perform actions that do not fit into other categories.
Page 45
Returns identifying information about the oscilloscope and its 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 LOCk Sets or returns the front panel lock state...
Command Groups PictBridge Command Group Use the commands in the PictBridge Command Group to store printer settings. Table 2-28: PictBridge Commands Command Description PICTBridge:DATEPrint Enables or disables printing the date on the print output PICTBridge:DEFault Sets the arguments for all PICTBridge commands to their default values Enables or disables printing the oscilloscope PICTBridge:IDPrint...
Page 47
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:GATing Sets or returns the power application gating POWer:HARMonics:DISPlay:SELect Sets or returns the harmonics to be displayed when the harmonics standard is None POWer:HARMonics:DISPlay:TYPe Sets or returns the display type for harmonics tests POWer:HARMonics:FREQRef Sets or returns the frequency reference...
Page 48
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:HARMonics:RESults:HAR<1-400>: The IEC standard specifies harmonics IECMAX? measurements to be computed in windows of time, with each time window being nominally 200 ms. This returns the maximum of the RMS magnitude of the harmonic, computed across successive 200 ms time windows within an observation period entered by the user...
Page 49
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:HARMonics:RESults:IEC:POHL? Returns the IEC POHL measurement POWer:HARMonics:RESults:IEC:POWer? Returns the IEC input power measurement POWer:HARMonics:RESults:IEC: Returns the IEC power factor measurement POWERFactor? POWer:HARMonics:RESults:PASSFail? Returns the overall harmonics test result: PASS, FAIL or NA POWer:HARMonics:RESults:RMS? Returns the root mean square value of the source waveform...
Page 50
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:QUALity:DISplay:TRUEpwr Sets or returns the display state for the true power readout POWer:QUALity:DISplay:VCRESTfactor Sets or returns the display state for the voltage crest factor readout POWer:QUALity:DISplay:VRMS Sets or returns the display state for the rms voltage (VRMS) readout POWer:QUALity:FREQREFerence Sets or returns the power quality frequency...
Page 51
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:RIPPle:RESults:MAX? Returns the maximum of the peak-to-peak ripple measurements POWer:RIPPle:RESults:MEAN? Returns the mean of the peak-to-peak ripple measurements POWer:RIPPle:RESults:MIN? Returns the minimum of the peak-to-peak ripple measurement POWer:RIPPle:RESults:STDdev? Returns the standard deviation of the peak-to-peak ripple measurements POWer:RIPPle:SOUrce Sets or returns the source waveform for...
Page 52
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:SOA:RESult:NUMACq? Returns the number of acquisitions in the test POWer:SOA:RESult:STATe? Returns the pass/fail state of the SOA test POWer:STATIstics Clears all the accumulated statistics of all measurements POWer:STATIstics:MODE Enables or disables the display of the measurement statistics POWer:STATIstics:WEIghting Sets the number of samples which are...
Page 53
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:SWLoss:REFLevel:ABSolute: Sets or returns the low voltage reference level LOWVoltage used in switching loss power measurements in volts POWer:SWLoss:REFLevel:PERCent: Sets or returns the mid voltage reference GATEMid level used in switching loss power measurements in percentage POWer:SWLoss:REFLevel:PERCent: Sets or returns the low current reference level...
Command Groups Table 2-29: Power Commands (cont.) Command Description POWer:SWLoss:TOTal:POWER:MAX? Returns the maximum total power switching loss calculation POWer:SWLoss:TOTal:POWER:MEAN? Returns the mean total power switching loss calculation POWer:SWLoss:TOTal:POWER:MIN? Returns the minimum total power switching loss calculation POWer:SWLoss:VCEsat Sets or returns VCESAT value for use in switching loss calculations when the conduction calculation method is VCESAT POWer:TYPe...
Command Groups Table 2-30: Save and Recall Commands (cont.) Command Description SAVe:IMAGe:FILEFormat Sets or returns the file format to use for saving screen images. The file format is not automatically determined by the file name extension. You need to choose a file name with an extension which is consistent with the selected file format SAVe:IMAGe:INKSaver...
Page 56
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the search trigger condition B<x>:AUDio:CONDition for the AUDIO bus: Start of Frame or Data SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the search trigger data upper B<x>:AUDio:DATa:HIVALue word for the AUDIO bus SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the search trigger data offset B<x>:AUDio:DATa:OFFSet...
Page 57
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the length of the data string B<x>:FLEXray:DATa:SIZe in bytes SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the low binary data string B<x>:FLEXray:DATa:VALue SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the end of frame type B<x>:FLEXray:EOFTYPE SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the error type B<x>:FLEXray:ERRTYPE...
Page 58
Command Groups Search Commands (cont.) Command Description 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 B<x>:LIN:DATa:SIZe in bytes SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the binary data string used B<x>:LIN:DATa:VALue for a LIN search SEARCH:SEARCH<x>:TRIGger:A:BUS:...
Page 59
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the high limit for USB data B<x>:USB:DATa:HIVALue searches SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the data offset for USB data B<x>:USB:DATa:OFFSet searches SEARCH:SEARCH<x>:TRIGger:A:BUS: Sets or returns the number of data bytes for B<x>:USB:DATa:SIZe USB searches SEARCH:SEARCH<x>:TRIGger:A:BUS:...
Page 60
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:LOGIc: Sets or returns whether the clock edge is rise INPut:CLOCk:EDGE or fall for a logic search SEARCH:SEARCH<x>:TRIGger:A:LOGIc: Sets or returns the clock source definition for INPut:CLOCk:SOUrce logic search SEARCH:SEARCH<x>:TRIGger:A:LOGIc: Sets or returns the criteria for a logic search INPut:D<x>...
Page 61
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the condition for generating PULSEWidth:WHEn a pulse width search SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the pulse width setting for a PULSEWidth:WIDth pulse width search SEARCH:SEARCH<x>:TRIGger:A:RUNT: Sets or returns the polarity setting for a runt POLarity search SEARCH:SEARCH<x>:TRIGger:A:RUNT:...
Command Groups Search Commands (cont.) Command Description SEARCH:SEARCH<x>:TRIGger:A:TYPe Sets or returns the trigger type setting for a search SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the waveform upper threshold UPPerthreshold:CH<x> level for all channel waveform searches SEARCH:SEARCH<x>:TRIGger:A: Sets or returns the waveform upper threshold UPPerthreshold:MATH level for all math waveform searches SEARCH:SEARCH<x>:TRIGger:A:...
Command Groups Table 2-31: Status and Error Commands (cont.) Command Description *RST Resets the oscilloscope to factory default settings *SRE Sets or returns the bits in the Service Request Enable Register *STB? Returns the contents of the Status Byte Register *WAI Prevents the oscilloscope from executing further commands until all pending...
Page 64
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:AUDio:DATa:HIVALue Sets or returns the trigger data upper word for the AUDIO bus TRIGger:A:BUS:B<x>:AUDio:DATa:OFFSet Sets or returns the trigger data offset for the AUDIO TRIGger:A:BUS:B<x>:AUDio:DATa:QUALifier Sets or returns the trigger data qualifier for the AUDIO TRIGger:A:BUS:B<x>:AUDio:DATa:VALue Sets or returns the trigger data lower word for the...
Page 65
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:VALue Sets or returns the binary data string to be used for FLEXRAY cycle count low value TRIGger:A:BUS:B<x>:FLEXray:DATa:HIVALue Sets or returns the high binary data string to be used for FLEXRAY trigger TRIGger:A:BUS:B<x>:FLEXray:DATa:OFFSet Sets or returns the offset of the data string in bytes...
Page 66
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:FLEXray:HEADER:PAYLength Sets or returns the payload length portion of the binary header string 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...
Page 67
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:RS232C:RX:DATa:SIZe Sets or returns the length of the data string in Bytes for an RX RS-232 Trigger TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue Sets or returns the binary data string for an RX RS-232 trigger TRIGger:A:BUS:B<x>:RS232C:TX:DATa:SIZe Sets or returns the length of the data string for a TX RS-232 trigger...
Page 68
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:BUS:B<x>:USB:ENDPoint:VALue Sets or returns the endpoint value for the USB trigger TRIGger:A:BUS:B<x>:USB:ERRORTYPe Sets or returns the error type for the USB trigger TRIGger:A:BUS:B<x>:USB:HANDSHAKEType Sets or returns the handshake type for the USB trigger TRIGger:A:BUS:B<x>:USB:QUALifier Sets or returns the qualifier...
Page 69
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:LOGIc? Returns all A trigger logic settings TRIGger:A:LOGIc:CLAss Sets or returns the type of A trigger logic TRIGger:A:LOGIc:FUNCtion Sets or returns the logical combination of the input channels for the A logic trigger TRIGger:A:LOGIc:INPut? Returns the logic input...
Page 70
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:LOGIc:THReshold:D<x> Sets or returns the trigger A logic threshold level for the specified digital channel TRIGger:A:LOWerthreshold:CH<x> Sets or returns the lower threshold for the channel selected TRIGger:A:LOWerthreshold:D<x> Sets the A trigger lower threshold for the digital channel selected TRIGger:A:LOWerthreshold{:EXT|:AUX}...
Page 71
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A:SETHold? Returns settings for setup and hold violation triggering TRIGger:A:SETHold:CLOCk? Returns clock edge polarity, voltage threshold and source input for setup/hold triggering TRIGger:A:SETHold:CLOCk:EDGE Sets or returns the clock edge polarity for setup and hold triggering TRIGger:A:SETHold:CLOCk:SOUrce Sets or returns the clock...
Page 72
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:A{:TRANsition|:RISEFall}:POLarity Sets or returns the polarity for the A pulse transition trigger TRIGger:A{:TRANsition|:RISEFall}:SOUrce Sets or returns the source for transition trigger TRIGger:A{:TRANsition|:RISEFall}:WHEn Sets or returns the relationship of delta time to transitioning signal TRIGger:A:TYPe Sets or returns the type of A trigger...
Page 73
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:B:EDGE? Returns B trigger edge type parameters TRIGger:B:EDGE:COUPling Sets or returns the type of B trigger coupling TRIGger:B:EDGE:SLOpe Sets or returns the B edge trigger slope TRIGger:B:EDGE:SOUrce Sets or returns the B edge trigger source Returns the current B trigger TRIGger:B:EVENTS?
Command Groups Table 2-32: Trigger Commands (cont.) Command Description TRIGger:FREQuency? Returns the trigger frequency in hertz, if available TRIGger:STATE? Returns the current state of the triggering system Vertical Command Group Use the commands in the Vertical Command Group to control the vertical setup of all live (channel) waveforms for acquisition and display of channel, reference, and math waveforms.
Page 75
Command Groups Table 2-33: Vertical Commands (cont.) Command Description CH<x>:AMPSVIAVOLTs:ENAble Sets or returns the state of the amps via volts feature for the specified channel CH<x>:AMPSVIAVOLTs:FACtor Sets or returns the amps via volts factor for the specified channel CH<x>:BANdwidth Sets or returns the bandwidth of the specified channel CH<x>:COUPling Sets or returns the coupling setting for the...
Page 76
Command Groups Table 2-33: Vertical Commands (cont.) Command Description CH<x>:PRObe:RECDESkew? Returns the recommended deskew for the probe connected 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 channel <x>TekVPI probe CH<x>:PRObe:UNIts? Returns the units of measure of the probe...
Command Groups Table 2-33: Vertical Commands (cont.) Command Description REF<x>:VERTical:SCAle Sets or returns the reference waveform vertical scale in vertical units/div SELect Returns information on which waveforms are on or off and which waveform is selected. 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>...
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 79
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.
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 81
Command Groups Table 2-35: Waveform Transfer Commands (cont.) Command Description WFMInpre:BIT_Nr Sets or returns the number of bits per binary waveform point for the incoming waveform WFMInpre:BN_Fmt Sets or returns the format of binary data for the incoming waveform WFMInpre:BYT_Nr Sets or returns the data width for the incoming waveform WFMInpre:BYT_Or...
Command Groups Table 2-35: Waveform Transfer Commands (cont.) Command Description WFMOutpre:ENCdg Sets or returns the type of encoding for outgoing waveforms WFMOutpre:FRACTional? This query always returns a 0 if the waveform specified by DATA:SOUrce is on or displayed WFMOutpre:NR_Pt? Returns the number of points for the waveform transmitted in response to a CURVe? query WFMOutpre:PT_Fmt?
Page 83
Command Groups Table 2-36: Zoom Commands (cont.) Command Description ZOOm:ZOOM<x>:FACtor? Returns the zoom factor of the zoom window. <x> can only be 1 ZOOm:ZOOM<x>:POSition Sets or returns the horizontal position of the zoom window in terms of 0 to 100% of the overview window.
Page 84
Command Groups 2-70 MSO4000 and DPO4000 Series Programmer Manual...
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 ACQuire:MAGnivu Sets or returns the MagniVu feature, which provides up to 32 times signal detail for fast viewing of short events.
Page 86
Commands Listed in Alphabetical Order ACQuire:MAXSamplerate? (Query Only) Returns the maximum real-time sample rate, which varies from model to model. Group Acquisition Syntax ACQuire:MAXSamplerate? Examples might return 2.5000E+9 in a DPO4034 indicating ACQUIRE:MAXSAMPLERATE? the maximum real-time sample rate is 2.5GS/s. ACQuire:MODe Sets or returns the acquisition mode of the oscilloscope for all live waveforms.
Page 87
Commands Listed in Alphabetical Order of averaging, where the average comes from a single waveform acquisition. The number of samples taken during the acquisition interval determines the number of data values that compose the average. specifies averaging mode, in which the resulting waveform shows an AVErage average of SAMple data points from several separate waveform acquisitions.
Page 88
Commands Listed in Alphabetical Order Group Acquisition Syntax ACQuire:NUMAVg <NR1> ACQuire:NUMAVg? Related Commands ACQuire:MODe Arguments is the number of waveform acquisitions to average. The range of values is <NR1> from 2 to 512 in powers of two. Examples specifies that 16 waveform averages will be performed ACQUIRE:NUMAVG 16 before exponential averaging starts.
Page 89
Commands Listed in Alphabetical Order = 0 stops acquisitions; any other value starts acquisitions. <NR1> Examples starts the acquisition of waveform data and resets the count ACQUIRE:STATE RUN of the number of acquisitions. might return indicating that the ACQUIRE:STATE? :ACQUIRE:STATE 0 acquisition is stopped.
Page 90
Commands Listed in Alphabetical Order Syntax ALIas {OFF|ON|<NR1>} ALIas? Related Commands ALIas:DEFine ALIas[:STATE] 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.
Page 91
Commands Listed in Alphabetical Order Group Alias Syntax ALIas:DEFine <QString><,>{<QString>|<Block>} ALIas:DEFine? <QString> 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 92
Commands Listed in Alphabetical Order Examples deletes the alias named SETUP1. ALIAS:DELETE "SETUP1" ALIas:DELEte:ALL (No Query Form) Deletes all existing aliases. 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...
Page 93
Commands Listed in Alphabetical Order Arguments = 0 turns alias expansion off. If a defined alias is sent when <NR1> ALIas:STATE is OFF, a command error (102) is generated. 0 turns alias expansion on. When a defined alias is received, the <NR1>...
Page 94
Commands Listed in Alphabetical Order Examples vertical, horizontal, and trigger controls of the oscilloscope to AUTOSET EXECUTE automatically acquire and display the selected waveform. AUTOSet:ENAble Enables or disables the autoset feature. This is useful for classroom purposes where the instructor wants the students to achieve the desired instrument settings without the benefit of the autoset feature.
Page 95
<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 96
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 97
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 98
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 99
Commands Listed in Alphabetical Order BUS? (Query Only) Returns the parameters for each bus. These parameters affect either the Serial Trigger Setup or the Bus Display. Conditions This command requires a serial bus analysis module. Group Syntax BUS? BUS:B<x>:AUDio:BITDelay Sets or returns the number of delay bits for the AUDIO bus. NOTE.
Page 100
Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:AUDio:BITOrder {MSB|LSB} BUS:B<x>:AUDio:BITOrder? Arguments specifies that the most significant bit will be expected first in the order. specifies that the least significant bit will be expected first in the order. Examples sets the bit order to LSB. BUS:B1:AUDIO:BITORDER LSB might return BUS:B1:AUDIO:BITORDER?
Page 101
Commands Listed in Alphabetical Order Conditions This command requires DPO4AUDIO application module. Group Syntax BUS:B<x>:AUDio:CLOCk:POLarity {FALL|RISe} BUS:B<x>:AUDio:CLOCk:POLarity? Arguments sets falling edge as the clock polarity. FALL sets rising edge as the clock polarity. RISe Examples sets the clock polarity to Fall. BUS:B1:AUDIO:CLOCK:POLARITY Fall might return BUS:B1:AUDIO:CLOCK:POLARITY?
Page 102
Commands Listed in Alphabetical Order BUS:B<x>:AUDio:DATa:POLarity Sets or returns the data polarity for the AUDIO bus. Conditions This command requires DPO4AUDIO application module. Group Syntax BUS:B<x>:AUDio:DATa:POLarity {NORMal|INVERTed} BUS:B<x>:AUDio:DATa:POLarity? Arguments specifies positive data polarity for the audio bus. NORMal specifies negative data polarity for the audio bus. INVERTed Examples sets the data polarity to Inverted.
Page 103
Commands Listed in Alphabetical Order Examples sets the number of bits per word to 8. BUS:B1:AUDIO:DATA:SIZE 8 might return BUS:B1:AUDIO:DATA:SIZE? :BUS:B1:AUDIO:DATA:SIZE 24 indicating that the number of bits per word is set to 24. BUS:B<x>:AUDio:DATa:SOUrce Sets or returns the data source waveform for the AUDIO bus. Conditions This command requires DPO4AUDIO application module.
Page 104
Commands Listed in Alphabetical Order specifies a signed decimal data display. SIGNEDDECimal Examples sets the display format to Binary. BUS:B1:AUDIO:DISPLAY:FORMAT BINARY might return BUS:B1:AUDIO:DISPLAY:FORMAT? indicating that the :BUS:B1:AUDIO:DISPLAY:FORMAT SIGNEDDECIMAL display format is set to signed decimal. BUS:B<x>:AUDio:FRAME:SIZe Sets or returns the number of channels in each frame for the AUDIO bus. NOTE.
Page 105
Commands Listed in Alphabetical Order Arguments specifies the falling edge as the frame sync polarity. FALL specifies the rising edge as the frame sync polarity. RISe Examples sets the falling edge for frame BUS:B1:AUDIO:FRAMESYNC:POLARITY FALL sync polarity. might return BUS:B1:AUDIO:FRAMESYNC:POLARITY? indicating that the :BUS:B1:AUDIO:FRAMESYNC:POLARITY RISe polarity is set to Rise.
Page 106
Commands Listed in Alphabetical Order Syntax BUS:B<x>:AUDio:TYPe {I2S|LJ|RJ|TDM} BUS:B<x>:AUDio:TYPe? Arguments specifies I S audio format. specifies left-justified audio format. specifies right justified audio format. specifies time-division multiplexing audio format. Examples sets right-justified as the audio format. BUS:B1:AUDIO:TYPE RJ might return indicating BUS:B1:AUDIO:TYPE? :BUS:B1:AUDIO:TYPE I2S...
Page 107
Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:AUDio:WORDSel:SOUrce {CH1|CH2|CH3|CH4 |D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:AUDio:WORDSel:SOUrce? Arguments specifies the channel to use as the word select source. CH1–CH4 specifies the digital channel to use as the word select source. D0-D15 Examples sets CH1 as the word select source. BUS:B1:AUDIO:WORDSEL:SOURCE CH1 might return BUS:B1:AUDIO:WORDSEL:SOURCE?
Page 108
Commands Listed in Alphabetical Order BUS:B<x>:CAN:PRObe Sets or returns the probing method to probe CAN bus <x>, where x is the bus number. Conditions This command requires a DPO4AUTO application module. Group 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.
Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:CAN:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:CAN:SOUrce? 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 , where <x>...
Page 110
Commands Listed in Alphabetical Order Arguments – All values are displayed in binary. BINary – All values are displayed in hexadecimal. HEXadecimal – All values are displayed in an ASCII format, for RS-232 only. ASCII – Values are displayed in a mixture of hexadecimal, binary, and decimal, MIXed depending on the field.
Page 111
Commands Listed in Alphabetical Order Examples sets the FLEXRAY bit rate to 9600 bits per BUS:B1:FLEXRAY:BITRATE 9600 second. might return BUS:B1:FLEXRAY:BITRATE? BUS:B1:FLEXRAY:BITRATE indicating the FLEXRAY bit rate is 10,000,000 bits per second. 10000000 BUS:B<x>:FLEXray:CHannel Sets or returns the FLEXRAY ID format. Group Syntax BUS:B<x>:FLEXray:CHannel {A|B}...
Page 112
Commands Listed in Alphabetical Order Examples sets the FLEXRAY standard is BM. BUS:B1:FLEXRAY:SIGNAL BM might return BUS:B1:FLEXRAY:SIGNAL? BUS:B1:FLEXRAY:SIGNAL indicating the FLEXRAY standard is BDIFFBP. BDIFFBP BUS:B<x>:FLEXray:SOUrce Sets or returns the FLEXRAY data source. Group Syntax BUS:B<x>:FLEXray:SOUrce {CH1|CH2|CH3|CH4|D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:FLEXray:SOUrce? Arguments sets the FLEXRAY source to channel x, where x is 1 to 4. CH<x>...
Page 113
Commands Listed in Alphabetical Order might return BUS:B1:I2C:ADDRESS:RWINCLUDE? indicating the read/write bit is not BUS:B1:I2C:ADDRESS:RWINCLUDE 0 included in the address. BUS:B<x>:I2C{:CLOCK|:SCLK}:SOUrce Sets or returns the I2C SCLK source for bus <x>, where x is the bus number. Conditions This command requires a DPO4EMBD or DPO4COMP application module. Group Syntax BUS:B<x>:I2C{:CLOCK|:SCLK}:SOUrce {CH1|CH2|CH3|CH4|...
Page 114
Commands Listed in Alphabetical Order Group Syntax BUS:B<x>:LABel <Qstring> BUS:B<x>:LABel? Arguments is an alphanumeric string of text, enclosed in quotes, that contains the <Qstring> text label information for bus <x>. The text string is limited to 30 characters. BUS:B<x>:LIN:BITRate Sets or returns the bit rate for LIN. Group Syntax BUS:B<x>:LIN:BITRate <NR1>...
Page 115
Commands Listed in Alphabetical Order Examples sets the LIN id format to parity. BUS:B1:LIN:IDFORMAT PARITY might return BUS:B1:LIN:IDFORMAT? BUS:B1:LIN:IDFORMAT NOPARITY indicating the LIN id format is no parity. BUS:B<x>:LIN:POLARity Sets or returns the LIN polarity. Group Syntax BUS:B<x>:LIN:POLARity {NORMal|INVerted} BUS:B<x>:LIN:POLARity? Arguments specifies normal LIN polarity.
Page 116
Commands Listed in Alphabetical Order BUS:B<x>:LIN:SOUrce Sets or returns the LIN data source. Group Syntax BUS:B<x>:LIN:SOUrce {CH1|CH2|CH3|CH4|D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:LIN:SOUrce? Arguments specifies the LIN source channel where x is 1 to 4. CH<x> specifies the LIN source channel where x is 1 to 16. D<x>...
Page 117
Commands Listed in Alphabetical Order BUS:B<x>:PARallel:BIT<x>:SOUrce Sets or returns the parallel bit source for B<x>, where x is the bus number and Bit<x> is the bit number. Group Syntax BUS:B<x>:PARallel:BIT<x>:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:PARallel:BIT<x>:SOUrce? Arguments specifies the bit source B<x>. BIT<x> specifies the bit CH1–CH4 D0–D15 number.
Page 118
Commands Listed in Alphabetical Order Arguments specifes that the Parallel bus is clocked. specifes that the Parallel bus is not clocked. BUS:B<x>:PARallel:CLOCK:SOUrce Sets or returns the Parallel bus source <x>, where x is the bus number. Group Syntax BUS:B<x>:PARallel:CLOCK:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15} BUS:B<x>:PARallel:CLOCK:SOUrce? Arguments...
Page 119
Commands Listed in Alphabetical Order Syntax BUS:B<x>:POSition <NR3> BUS:B<x>:POSition? Arguments specifies the position. <NR3> BUS:B<x>:RS232C:BITRate Sets or returns the RS-232 bit rate for bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module. Group Syntax BUS:B<x>:RS232C:BITRate <NR1>...
Page 120
Commands Listed in Alphabetical Order BUS:B<x>:RS232C:DELIMiter Sets or returns the RS-232 delimiting value for a packet on bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module. Group Syntax BUS:B<x>:RS232C:DELIMiter {NULl|LF|CR|SPace|XFF} BUS:B<x>:RS232C:DELIMiter? Arguments specifies 0x00. NULl specifies 0x0A.
Page 121
Commands Listed in Alphabetical Order Conditions This command requires a DPO4COMP application module. Group Syntax BUS:B<x>:RS232C:PARity {NONe|EVEN|ODD} BUS:B<x>:RS232C:PARity? Arguments specifies no parity. NONe specifies even parity. EVEN specifies odd parity. BUS:B<x>:RS232C:POLarity Sets or returns the RS-232C polarity for bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module.
Page 122
Commands Listed in Alphabetical Order Arguments specifies the channel to use for the RS-232 RX source. CH1–CH4 D0–D15 sets the specified bus input to off. BUS:B<x>:RS232C:TX:SOUrce Sets or returns the RS-232 TX Source for bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module.
Page 123
Commands Listed in Alphabetical Order BUS:B<x>:SPI{:CLOCK|:SCLK}:POLARity Sets or returns the SPI SCLK polarity for bus <x>, where x is the bus number. Conditions This command requires a DPO4EMBD application module. Group Syntax BUS:B<x>:SPI{:CLOCK|:SCLK}:POLARity {FALL|RISe} BUS:B<x>:SPI{:CLOCK|:SCLK}:POLARity? Arguments specifies the falling edge. FALL specifies the rising edge.
Page 124
Commands Listed in Alphabetical Order Syntax BUS:B<x>:SPI:DATA{:IN|:MISO}:POLARity {LOW|HIGH} BUS:B<x>:SPI:DATA{:IN|:MISO}:POLARity? Arguments specifies an active low polarity. specifies an active high polarity. HIGH BUS:B<x>:SPI:DATA{:IN|:MISO}:SOUrce Sets or returns the SPI MISO source for bus <x, where x is the bus number. Conditions This command requires a DPO4EMBD application module. Group Syntax BUS:B<x>:SPI:DATA{:IN|:MISO}:SOUrce {CH1|CH2|CH3|CH4|...
Page 125
Commands Listed in Alphabetical Order Conditions This command requires a DPO4EMBD application module. Group Syntax BUS:B<x>:SPI:DATA{:OUT|:MOSI}: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:DATA{:OUT|:MOSI}:SOUrce? Arguments is the channel to use as the SPI MISO source. CH1-CH4 D0-D15 BUS:B<x>:SPI:DATA:SIZe Sets or returns the number of bits per word for the specified SPI bus. Group Syntax BUS:B<x>:SPI:DATA:SIZe <NR1>...
Page 126
Commands Listed in Alphabetical Order Examples sets the SPI framing type to SS. BUS:B1:SPI:FRAMING SS might return BUS:B1:SPI:FRAMING IDELTIME BUS:B1:SPI:FRAMING indicating the SPI framing type is set to IDLETIME. IDELTIME BUS:B<x>:SPI:IDLETime Sets or returns the SPI bus idle time in seconds for the specified bus. Group Syntax BUS:B<x>:SPI:IDLETime <NR3>...
Page 127
Commands Listed in Alphabetical Order Conditions This command requires a DPO4EMBD application module. Group Syntax BUS:B<x>:SPI{:SELect|:SS}: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{:SELect|:SS}:SOUrce? Arguments is the channel to use as the SPI SS source. CH1–CH4 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 128
Commands Listed in Alphabetical Order specifies the Controller Area Network bus. specifies the RS-232C bus. RS232C specifies the Parallel bus. PARallel specifies the USB bus. BUS:B<x>:USB:BITRate Sets or returns the bit rate for the USB signal. Group Syntax BUS:B<x>:USB:BITRate {LOW|FULL|HIGH} BUS:B<x>:USB:BITRate? Arguments indicates the bit rate is 1.5 Mbps.
Page 129
Commands Listed in Alphabetical Order might return BUS:B1:USB:PROBE? :BUS:B1:USB:PROBE SINGLEENDED which indicates that the bus probe is not a differential probe. BUS:B<x>:USB:SOUrce:DIFFerential Sets or returns the USB Data Source when using a differential probe. Group Syntax BUS:B<x>:USB:SOUrce:DIFFerential {CH1|CH2|CH3|CH4} BUS:B<x>:USB:SOUrce:DIFFerential? Arguments specifies the channel to use for data source for the USB bus.
Page 130
Commands Listed in Alphabetical Order Examples sets the D-source to channel 2. BUS:B1:USB:SOURCE:DMINUS CH2 might return BUS:B1:USB:SOURCE:DMINUS? :BUS:B1:USB:SOURCE:DMINUS indicating that channel 4 is set to be the D- input for USB data. BUS:B<x>:USB:SOUrce:DPLUs Sets or returns the USB Data Source for D+ input. If you are using single-ended probes, you need to set the sources for both the D+ and D- inputs.
Page 131
Commands Listed in Alphabetical Order Examples sets the CH1 lower threshold to 800mV. BUS:LOWERTHRESHOLD:CH1 TTL might return BUS:LOWERTHRESHOLD:CH1? :BUS:LOWERTHRESHOLD:CH1 indicating the CH1 lower threshold is -800 mV. -800.0000E-3 BUS:THReshold:CH<x> Sets or returns the threshold for analog channel <x>, where x is the channel number.
Page 132
Commands Listed in Alphabetical Order Arguments specifies a preset ECL high level of -1.3V. specifies a preset TTL high level of 1.4V. specifies the threshold level in volts. <NR3> BUS:UPPerthreshold:CH<x> Sets the upper threshold for each channel. This applies to all search and trigger types that use the channel.
Page 133
Commands Listed in Alphabetical Order Returns = 0 means the oscilloscope is not busy processing a command whose <NR1> execution time is extensive. = 1 means the oscilloscope is busy processing a command whose execution <NR1> time is extensive. (See Table 3-3 on page 3-7.) Examples might return indicating that the oscilloscope is currently busy.
Page 134
Commands Listed in Alphabetical Order CALibrate:INTERNal (No Query Form) This command starts a signal path compensation. Group Calibration and Diagnostic Syntax CALibrate:INTERNal Arguments None Examples starts a serial path compensation cycle. CALIBRATE:INTERNAL CALibrate:INTERNal:STARt (No Query Form) Starts the internal signal path calibration (SPC) of the oscilloscope. You can use the CALibrate:INTERNal:STATus? query to return the current status of the...
Page 135
Commands Listed in Alphabetical Order Returns This query will return one of the following: indicates the oscilloscope has not had internal signal path calibration INIT run. indicates the signal path calibration completed successfully. PASS indicates the signal path calibration did not complete successfully. FAIL indicates the signal path calibration is currently running.
Page 136
Commands Listed in Alphabetical Order CALibrate:RESults:SPC? (Query Only) Returns the status of the SPC operation. This query does not initiate a SPC. Group Calibration and Diagnostic Syntax CALibrate:RESults:SPC? Related Commands *CAL? Returns indicates that SPC has never successfully completed. INIT indicates that the last SPC operation passed.
Page 137
Commands Listed in Alphabetical Order Arguments sets the amps via volts function for channel <x> to off. sets the amps via volts function for channel <x> to on. = 0 sets the amps via volts function to off. Any other value sets the <NR1>...
Page 138
Commands Listed in Alphabetical Order is a double-precision ASCII string. The oscilloscope rounds this value to <NR3> an available bandwidth using geometric rounding, and then uses this value to set the upper bandwidth limit. NOTE. Other values may be possible depending on the attached probes. Examples sets the bandwidth of channel 1 to 20 MHz.
Page 139
Commands Listed in Alphabetical Order Syntax CH<x>:DESKew <NR3> CH<x>:DESKew? Arguments is the deskew time for channel <x>, ranging from -100 ns to +100 ns <NR3> with a resolution of 1 ps. Examples sets the deskew time for channel 4 to 5 ns. CH4:DESKew 5.0E-9 might return indicating that the...
Commands Listed in Alphabetical Order Syntax CH<x>:LABel <Qstring> CH<x>:LABel? Arguments is an alphanumeric string of text, enclosed in quotes, that contains the <Qstring> text label information for the channel <x> waveform. The text string is limited to 30 characters. CH<x>:OFFSet Sets or returns the vertical offset for channel <x>, where x is the channel number.
Page 141
Commands Listed in Alphabetical Order Syntax CH<x>:OFFSet <NR3> CH<x>:OFFSet? Related Commands CH<x>:POSition Arguments is the offset value for the specified channel <x>. <NR3> Examples sets the offset for channel 3 to 2 mV. CH3:OFFSet 2.0E-3 might return indicating that the CH4:OFFSet? :CH4:OFFSET 1.0000E-03 offset for channel 4 is set to 1 mV.
Page 142
<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. 2-128 MSO4000 and DPO4000 Series Programmer Manual...
Page 143
Commands Listed in Alphabetical Order might return CH1:PROBE:COMMAND?“MODE” CH1:PROBE:COMMAND “MODE”,“4-4V1MHZ” CH<x>:PRObe:DEGAUss (No Query Form) Starts a degauss auto-zero cycle on a TekVPI current probe attached to the input channel specified by <x>, where x is the channel number. Group Vertical Syntax CH<x>:PRObe:DEGAUss EXECute Arguments...
Page 144
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:FORCEDRange <NR3> CH<x>:PRObe:FORCEDRange? Arguments specifies the range, which is probe specific. <NR3> Returns This command returns for probes that do no support forced range. CH<x>:PRObe:GAIN Sets or returns the gain factor for the probe attached to the channel specified by <x>, where x is the channel number.
Page 145
Commands Listed in Alphabetical Order Syntax CH<x>:PRObe:ID? Examples CH2:PROBE:ID? might return :CH2:PROBE:ID:TYPE "10X";SERNUMBER indicating that a passive 10x probe of unknown serial number is attached "N/A" to channel 2. CH<x>:PRObe:ID:SERnumber? (Query Only) Returns the serial number of the probe attached to channel <x>, where x is the channel number.
Page 146
Commands Listed in Alphabetical Order CH<x>:PRObe:MODel Sets or returns the probe model for the specified channel. If a coded probe is attached or the specified model is not recognized, an error event is set. The argument must be a supported probe. To find the list of supported probes, push the front-panel channel 1, 2, 3, or 4 button, then push the lower-menu More item as many times as needed to select Deskew.
Page 147
Commands Listed in Alphabetical Order Syntax CH<x>:PRObe:RECDESkew? CH<x>:PRObe:RESistance? (Query Only) Returns the resistance factor of the probe attached to channel <x>, where x is the channel number. Group Vertical Syntax CH<x>:PRObe:RESistance? Examples might return CH2:PRObe:RESistance? :CH2:PROBE:RESISTANCE indicating that the input resistance of the probe attached to Channel 10.0000E+6 2 is 1 MΩ.
Page 148
Commands Listed in Alphabetical Order Syntax CH<x>:PRObe:UNIts? Examples might return indicating that the CH4:PROBE:UNITS? :CH4:PROBE:UNITS "V" units of measure for the probe attached to channel 4 are volts. CH<x>:SCAle Sets or returns the vertical scale for the channel specified by <x>, where x is the channel number.
Page 149
Commands Listed in Alphabetical Order CH<x>:TERmination Sets the connected-disconnected status of a 50 Ω resistor, which may be connected between the specified channel’s coupled input and oscilloscope ground. The channel is specified by <x>. There is also a corresponding query that requests the termination parameter and translates this enumeration into one of the two float values.
Page 150
Commands Listed in Alphabetical Order CLEARMenu (No Query Form) Clears the current menu from the display. This command is equivalent to pressing the front panel Menu off. Group Miscellaneous Syntax CLEARMenu *CLS (No Query Form) Clears the following: Event Queue Standard Event Status Register Status Byte Register (except the MAV bit) If the *CLS command immediately follows an <EOI>, the Output Queue and...
Page 151
Commands Listed in Alphabetical Order Syntax CURSor? Examples might return the following as the current cursor settings: CURSOR? :CURSOR:FUNCTION SCREEN;HBARS:POSITION1 0.0000;POSITION2 0.0000;UNITS BASE;:CURSOR:MODE INDEPENDENT;VBARS:POSITION1 -19.0006E-6;POSITION2 -18.9994E-6;UNITS SECONDS CURSor:DDT? (Query Only) Returns the cursor deltaY/deltaT (dY/dT) readout. Conditions This command requires a DPO4PWR application module. Group Cursor Syntax...
Page 152
Commands Listed in Alphabetical Order Examples selects the paired cursors for measuring waveform CURSOR:FUNCTION WAVEFORM amplitude and time. might return indicating that CURSOR:FUNCTION? :CURSor:FUNCtion SCREEN the screen cursors are currently selected. CURSor:HBArs? (Query Only) Returns the current settings for the horizontal bar cursors. Group Cursor Syntax...
Page 153
Commands Listed in Alphabetical Order Group Cursor Syntax CURSor:HBArs:POSITION<x> <NR3> CURSor:HBArs:POSITION<x>? Related Commands CURSor:FUNCtion Arguments specifies the cursor position relative to ground. <NR3> Examples positions Cursor 1 of the horizontal CURSOR:HBARS:POSITION1 25.0E-3 cursors at 25 mV. might return CURSOR:HBARS:POSITION2? :CURSOR:HBARS:POSITION2 indicating that Cursor 2 of the horizontal bar cursors is at -64 mV.
Page 154
Commands Listed in Alphabetical Order Related Commands CURSor:HBArs:UNIts Arguments sets the H Bar measurement scale so that 0% is the current position of the CURrent lowest H Bar cursor and 100% is the current position of the highest H Bar cursor. sets H Bar measurement scale so that half the screen major divisions HALFgrat (five on the MSO/DPO4000) is 100%, where 0% is -2.5 divisions and 100% is...
Page 155
Commands Listed in Alphabetical Order Syntax CURSor:VBArs? Examples might return the following vertical bar settings CURSOR:VBARS? 1.0000E-06;POSITION2 :CURSOR:VBARS:UNITS SECONDS;POSITION1 9.0000E-06 CURSor:VBArs:ALTERNATE<x>? (Query Only) Returns the alternate readout for the waveform (Vbar) cursors specified by <x>. This alternate readout is in effect when the selected waveform is a bus or digital channel.
Page 156
Commands Listed in Alphabetical Order CURSor:VBArs:HPOS<x>? (Query Only) Returns the vertical value of the specified vertical bar ticks for cursor <x>. Group Cursor Syntax CURSor:VBArs:HPOS<x>? Related Commands CURSor:VBArs:UNIts Arguments specifies the cursor. Valid values are 1 and 2. <x> Returns indicates the value of one of the ticks.
Page 157
Commands Listed in Alphabetical Order Examples positions the cursor2 vertical bar cursor CURSor:VBArs:POSITION2 9.00E-6 at 9 ms. this command might return CURSor:VBArs:POSITION1? indicating that the :CURSOR:VBARS:POSITION1 1.0000E-06 cursor1 vertical bar is positioned at 1 μs. CURSor:VBArs:UNIts Sets or returns the units for the vertical bar cursors. Group Cursor Syntax...
Page 158
Commands Listed in Alphabetical Order Related Commands CURSor:VBArs:UNIts Arguments sets the V Bar measurement scale so that 0% is the current position of CURrent the left-most V Bar cursor and 100% is the current position of the right-most V Bar cursor. resets the ratio range to the default positions on the screen, half of the HALFgrat number of horizontal divisions (five on the MSO/DPO4000), from 25% to 75%...
Page 159
Commands Listed in Alphabetical Order Syntax CURSor:XY:POLar:RADIUS:DELta? CURSor:XY:POLar:RADIUS:POSITION<x>? (Query Only) Returns the polar radius for the specified cursor, where x can be either 1 or 2. Group Cursor Syntax CURSor:XY:POLar:RADIUS:POSITION<x>? CURSor:XY:POLar:RADIUS:UNIts? (Query Only) Returns the polar radius units. Group Cursor Syntax CURSor:XY:POLar:RADIUS:UNIts? CURSor:XY:POLar:THETA:DELta? (Query Only)
Page 160
Commands Listed in Alphabetical Order CURSor:XY:POLar:THETA:UNIts? (Query Only) Returns the cursor coordinate units. Group Cursor Syntax CURSor:XY:POLar:THETA:UNIts? CURSor:XY:PRODUCT:DELta? (Query Only) Returns the difference between the cursors X position and cursor Y position. The ΔX × ΔY value is calculated as (X2 - X1) × (Y2 - Y1). Group Cursor Syntax...
Page 161
Commands Listed in Alphabetical Order CURSor:XY:RATIO:DELta? (Query Only) Returns the ratio of the difference between the cursors X position and cursor Y position (ΔY¸ ΔX). The ratio is calculated as (Y2 - Y1) / (X2 - X1). Group Cursor Syntax CURSor:XY:RATIO:DELta? CURSor:XY:RATIO:POSITION<x>? (Query Only) Returns the X (horizontal) or Y (vertical) position for the specified cursor, which...
Page 162
Commands Listed in Alphabetical Order Arguments specifies the XY readout as rectangular coordinates. RECTangular specifies the XY readout as polar coordinates. POLARCord specifies the XY readout in X*Y format. PRODuct specifies the XY readout in X:Y format. RATio CURSor:XY:RECTangular:X:DELta? (Query Only) Returns the cursor X delta value in rectangular coordinates.
Page 163
Commands Listed in Alphabetical Order 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 and can be either 1 or 2. Group Cursor Syntax CURSor:XY:RECTangular:Y:POSITION<x> <NR3> CURSor:XY:RECTangular:Y:POSITION<x>? Arguments is the coordinate in volts.
Page 164
Commands Listed in Alphabetical Order 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. Only one waveform can be transferred at a time. The waveform will only be displayed if the reference is displayed.
Page 165
Commands Listed in Alphabetical Order NOTE. Curve data is transferred from the oscilloscope asynchronously, depending on the length of the curve record. Such transfers may require several seconds to complete. During this period, the oscilloscope will not respond to the user controls.
Page 166
Commands Listed in Alphabetical Order Group Waveform Transfer Syntax DATa:DESTination REF<x> DATa:DESTination? Related Commands CURVe Arguments is the reference location where the waveform will be stored. REF<x> Examples might return indicating that DATA:DESTINATION? :DATA:DESTINATION REF3 reference 3 is the currently selected reference memory location for incoming waveform data.
Commands Listed in Alphabetical Order When :BYT_Nr is 1, the range is from -128 through 127. When :BYT_Nr is 2, the range is from -32,768 through 32,767. Center screen is 0 (zero). The upper limit is the top of the screen and the lower limit is the bottom of the screen. This is the default argument.
Page 168
Commands Listed in Alphabetical Order Syntax DATa:SOUrce {CH1|CH2|CH3|CH4|MATH|REF1|REF2|REF3|REF4|D0|D1|D2|D3|D4|D5|D6|D7|D8|D9 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 169
Commands Listed in Alphabetical Order DATa:STARt and DATa:STOP are order independent. When DATa:STOP is greater than DATa:STARt, the values will be swapped internally for the CURVE? query. Examples might return indicating that data point 214 is DATA:START? :DATA:START 214 the first waveform data point that will be transferred. specifies that the waveform transfer will begin with data point 10.
Page 170
Commands Listed in Alphabetical Order specifies that the waveform transfer will stop at data point DATA:STOP 15000 15000. DATE Sets or returns the date the oscilloscope displays. Group Miscellaneous Syntax DATE <QString> DATE? Related Commands TIME Arguments is a date in the form "yyyy-mm-dd" where yyyy refers to a four-digit <QString>...
Page 171
Commands Listed in Alphabetical Order rules for concatenating commands. The sequence must be less than or equal to 80 characters. The format of this argument is always returned as a query. is a complete sequence of program messages. The messages can <QString>...
Page 172
Commands Listed in Alphabetical Order DESkew (No Query Form) Causes the deskew values for all channels to be set to the recommended values. Equivalent to pressing the "Set all deskews to recommended values" button in the application UI. NOTE. The actual deskew values for each channel can be set or queried using the CH<x>:DESKew command.
Page 173
Commands Listed in Alphabetical Order 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. executes self test (diagnostics test) sequence once.
Page 174
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 175
Commands Listed in Alphabetical Order Examples might return : DIAG:RESULT:LOG? DIAG:RESULT:LOG "NOT RUN--CPU,NOT RUN--DISPLAY,NOT RUN--FPANEL,NOT RUN--IO,NOT RUN--ACQ,NOT RUN--RO M,NOT RUN--APPKEY" 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.
Page 176
Commands Listed in Alphabetical Order tests the front panel controls. FPAnel tests the IO ports. tests the system read only memory. 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.
Page 177
Commands Listed in Alphabetical Order Syntax DISplay:CLOCk {ON|OFF|<NR1>} DISplay:CLOCk? Related Commands DATE, TIME Arguments enables the display of date and time. disables the display of date and time. = 0 disables the display of date and time; any other value enables the <NR1>...
Page 178
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 179
Commands Listed in Alphabetical Order Syntax DISplay:INTENSITy? Examples might return: DISPLAY:INTENSITY? :DISPLAY:INTEnsITY:WAVEFORM 30;GRATICULE 75;BACKLIGHT HIGH DISplay:INTENSITy:BACKLight Sets and returns the waveform backlight intensity settings. Group Display Syntax DISplay:INTENSITy:BACKLight {LOW|MEDium|HIGH} DISplay:INTENSITy:BACKLight? Examples might return DISPLAY:INTENSITY:BACKLIGHT? DISPLAY:INTEnsITY:BACKLIGHT HIGH DISplay:INTENSITy:GRAticule Sets and returns the display graticule intensity settings. Group Display Syntax...
Page 180
Commands Listed in Alphabetical Order 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 181
Commands Listed in Alphabetical Order Examples specifies that the waveform points are displayed DISPLAY:PERSISTENCE 3 fading for 3 seconds before they completely disappear. DISplay:STYle:DOTsonly Turns on or off the dots-only mode for the waveform display. Group Display Syntax DISplay:STYle:DOTsonly {ON|OFF|<NR1>} DISplay:STYle:DOTsonly? Arguments ≠...
Page 182
Commands Listed in Alphabetical Order Examples might return D4:LABEL? :D4:LABEL “Clk Wfm 4” D<x>:POSition Sets or returns the vertical position for digital channel <x>, where x is the channel number. NOTE. Unlike analog channels, which use the center baseline as the zero point, digital channels use the bottom logic level as the zero point.
Page 183
Commands Listed in Alphabetical Order *ESE Sets and queries the bits in the Event Status Enable Register (ESER). The ESER prevents events from being reported to the Status Byte Register (STB). For a detailed discussion on how to use registers, see Registers. Group Status and Error Syntax...
Page 184
Commands Listed in Alphabetical Order Examples might return 213, showing that the SESR contains the binary value *ESR? 11010101. ETHERnet:DHCPbootp Sets or returns the network initialization search for a DHCP/BOOTP server. Group Ethernet 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.
Page 185
Commands Listed in Alphabetical Order ETHERnet:DOMAINname Sets or returns the network domain name. Group Ethernet Syntax ETHERnet:DOMAINname <Qstring> ETHERnet:DOMAINname? 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.
Page 186
Commands Listed in Alphabetical Order Examples sets the gateway IP ETHERNET:GATEWAY:IPADDRESS “128.143.16.1” address. ETHERnet:HTTPPort Sets or returns the remote interface HTTP port value. Group Ethernet 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™...
Page 187
Commands Listed in Alphabetical Order ETHERnet:NAME Sets or returns the network name assigned to the oscilloscope. Group Ethernet Syntax ETHERnet:NAME <QString> ETHERnet:NAME? Arguments is the network name assigned to the oscilloscope, enclosed in quotes. <QString> Examples “labscope1” sets the oscilloscope’s network name. ETHERNET:NAME ETHERnet:PASSWord Sets or returns the HTTP Ethernet access password.
Page 188
Commands Listed in Alphabetical Order Examples causes the oscilloscope to ping the gateway IP ETHERNET:PING EXECUTE address. ETHERnet:PING:STATUS? (Query Only) Returns the results from sending the ETHERnet:PING command to ping the gateway IP address. Group Ethernet Syntax ETHERnet:PING:STATUS? 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.
Page 189
Commands Listed in Alphabetical Order Group Status and Error Syntax EVENT? Related Commands ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB? Examples might return , showing that there was an error in a EVENT? :EVENT 110 command header. (See page 3-12, Messages.) EVMsg? (Query Only) Removes a single event code from the Event Queue that is associated with the results of the last...
Page 190
Commands Listed in Alphabetical Order Group Status and Error Syntax EVQty? Related Commands ALLEv?, EVENT?, EVMsg? Examples might return , indicating the number of event codes in the EVQTY? :EVQTY 3 Event Queue. 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...
Page 191
Commands Listed in Alphabetical Order Related Commands *PSC, *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp Arguments None Examples resets the oscilloscope to its factory default settings. FACTORY FILESystem? (Query Only) Returns the directory listing of the current working directory and the number of bytes of free space available.
Page 192
Commands Listed in Alphabetical Order This command supports the permutations of file and directory names supported by Microsoft Windows: Relative path names; for example, "./Temp" Absolute path names; for example, "D:/MyWaveform" Implied relative path names; for example "newfile.txt" becomes "D:/TekScope/newfile.txt" if the current working directory is "D:/TekScope" Group File System Syntax...
Page 193
Commands Listed in Alphabetical Order The argument will delete all files and subdirectories within the current working directory. Examples deletes the file named FILESYSTEM:DELETE "NOT_MINE.SET" NOT_MINE.SET from the current working directory. FILESystem:DIR? (Query Only) Returns a list of quoted strings. Each string contains the name of a file or directory in the current working directory.
Page 194
Commands Listed in Alphabetical Order Arguments <drive name> is a quoted string that defines the disk drive to format. Examples FILESYSTEM:FORMAT "E:/" Formats the USB flash drive installed in the oscilloscope’s front panel USB port. FILESystem:FREESpace? (Query Only) Returns the number of bytes of free space on the current drive. Group File System Syntax...
Page 195
Commands Listed in Alphabetical Order 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> Examples creates the directory named FILESYSTEM:MKDIR "D:/NewDirectory"...
Page 196
Commands Listed in Alphabetical Order Examples reads the FILESYSTEM:READFILE “D:/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. FILESystem:REName (No Query Form) Assigns a new name to an existing file. Group File System Syntax...
Page 197
Commands Listed in Alphabetical Order Examples removes the directory named FILESYSTEM:RMDIR "D:/OldDirectory" OldDirectory from the root of the D drive. FILESystem:WRITEFile (No Query Form) Writes the specified block data to a file in the oscilloscope current working directory. If the specified file does not exist or is not readable, an appropriate error event is posted.
Commands Listed in Alphabetical Order Table 2-40: FPAnel:PRESS arguments Argument Description ACQuire Acquire button AUTOset Autoset button BMENU<x> Screen bottom menu buttons, where <x>=1 for the left-most bottom menu button and <x>=7 for the right-most bottom menu button B<x> Bus select buttons, where <x> = 1 through 4. CH<x>...
Commands Listed in Alphabetical Order Examples executes the oscilloscope Autoset function. FPANEL:PRESS AUTOSET FPAnel:TURN (No Query Form) Simulates the action of turning a specified front-panel control knob. When the front panel is locked, the front-panel button and multipurpose knob operations are suspended. The FPAnel:PRESS commands FPAnel:TURN...
Page 200
Commands Listed in Alphabetical Order Examples duplicates turning the front-panel Trigger Level FPANEL:TURN TRIGLEVEL,10 knob clockwise by 10 units. GPIBUsb:ADDress? (Query Only) Returns the current GPIB address setting for a connected TEK-USB-488 adaptor module. Group Miscellaneous Syntax GPIBUsb:ADDress? GPIBUsb:ID? (Query Only) Returns the identification string of the connected TEK-USB-488 adaptor module and firmware version.
Page 201
Commands Listed in Alphabetical Order compressed). The SAVe:IMAGe:INKSaver determines whether the data sent is in InkSaver mode. NOTE. The Hardcopy command with no arguments is equivalent to pressing the “HardCopy” button on the front panel, when the data is sent to the printer. As there is no front panel equivalent of the HARDCOPY START, you can choose to save the images to a different location using the “SAVE”...
Page 202
Commands Listed in Alphabetical Order Arguments ≠ 0 sets the ink saver mode on. <NR1> = 0 sets the ink saver mode off. <NR1> Examples will cause subsequent hard copy output to display the HARDCOPY:INKSAVER ON screen on a white background. HARDCopy:LAYout Sets or returns the page orientation for hard copy.
Page 203
Commands Listed in Alphabetical Order HARDCopy:PRINTer:ADD (No Query Form) Adds a network printer to the list of available printers. All three arguments must be present, but only one of server name or server IP address may be specified. An empty string can be used for blank arguments. Group Hard Copy Syntax...
Page 204
Commands Listed in Alphabetical Order be present, but the arguments may be empty strings if the value for a field is to be deleted. Group Hard Copy Syntax HARDCopy:PRINTer:REName <name>,<new_name>,<new_server>,<new_address> Arguments is the name of the printer to be deleted. <name>...
Page 205
Commands Listed in Alphabetical Order Examples specifies that the oscilloscope omits headers on query responses, HEADER OFF so that only the argument is returned. might return indicating that the oscilloscope is including HEADER? :HEADER 1 headers on applicable query responses. HIStogram? (Query Only) This query-only command returns all histogram parameters;...
Page 206
Commands Listed in Alphabetical Order <NR3> specifies the right position of the histogram box in source waveform horizontal units. <NR3> specifies the bottom position of the histogram box in source waveform vertical units. Examples defines the coordinates of the HISTOGRAM:BOX 1E-9, 0.250, 2E-9, 0.500 histogram box in source waveform coordinates.
Page 207
Commands Listed in Alphabetical Order the bottom boundary to 75% of the graticule (0.75 × 10 = 7.5 divisions from the top edge). ? might return HISTOGRAM:BOXPCNT :HISTOGRAM:BOXPCNT 30.0000,25.1000,70.0000,75.2000. HIStogram:COUNt (No Query Form) This command (no query form) clears the count and statistics for the histogram and the histogram source data.
Page 208
Commands Listed in Alphabetical Order Group Histogram Syntax HIStogram:DATa? Related Commands HIStogram:BOX HIStogram:BOXPcnt HIStogram:COUNt HIStogram:DISplay HIStogram:MODe HIStogram:SOUrce Examples might return HISTOGRAM:DATA? :HISTOGRAM:DATA 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,1245,933,903,1003,838,782,764,697, 687,620,582,566,530,595,557,552,518,524,606, 503,526,470,498,554,534,487,546,548,504,554, 513,566,639,508,643,704,662,769,785,806,922, 960,1153,1336,1478,1960,4515,17598,52184, 67040,50417,12885,4104,2382,1866,1699,1428, 1288,1271,1140,975,1024,894,841,841,678,841, 804,685,713,746,729,644,640,787,768,668,671, 661,745,755,692,882,772,802,862,770,854,799, 969,1102,1080,1040,1272,1329,1394,1760,1428, 2418,3313,4475,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0 HIStogram:DISplay This command sets the scaling of the histogram data display to be the count of each histogram bin or the log of that count.
Page 209
Commands Listed in Alphabetical Order Arguments sets the histogram display to logarithmic scaling <LOG> sets the histogram display to linear scaling. This is the default setting. <LINEAr> Examples sets the histogram scaling to be the log count of HISTOGRAM:DISPLAY LOG each histogram bin.
Page 210
Commands Listed in Alphabetical Order Syntax HIStogram:MODe {HORizontal|VERTical|OFF} HIStogram:MODe? Related Commands HIStogram:DISplay Arguments enables a horizontally positioned histogram that shows time HORizontal distribution. enables a vertically positioned histogram that shows a voltage VERTical distribution, or another distribution such as amperes. disables the collection of the histogram measurement.
Page 211
Commands Listed in Alphabetical Order ? might return , indicating that HISTOGRAM:SOURCE :HISTOGRAM:SOURCE CH1 the waveform for Channel 1 is the source for the histogram. HIStogram:STARt? (Query Only) Returns the time (horizontal) or vertical units value (vertical) of the first bin where the histogram data starts.
Page 212
Commands Listed in Alphabetical Order HORizontal:DELay:MODe Sets or returns the horizontal delay mode. Group Horizontal Syntax HORizontal:DELay:MODe {OFF|ON|<NR1>} HORizontal:DELay:MODe? Related Commands HORizontal:POSition Arguments sets the Horizontal Delay Mode to off. This causes the HORizontal:POSition command to operate like the HORIZONTAL POSITION knob on the front panel. sets the Horizontal Delay Mode to on.
Page 213
Commands Listed in Alphabetical Order Arguments is the delay in seconds. Examples sets the delay of acquisition data so that the HORizontal:DELay:TIME 0.3 resulting waveform is centered 300 ms after the trigger occurs. HORizontal:DIGital:RECOrdlength:MAGnivu? (Query Only) Returns the record length of the MagniVu digital acquisition. Group Horizontal Syntax...
Page 214
Commands Listed in Alphabetical Order HORizontal:POSition Sets or returns the horizontal position, in percent, that is used when delay if off. 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 215
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> 1000, 10000, 100000, 1000000, or 10000000. Examples specifies that 10000 data points will be HORIZONTAL:RECORDLENGTH 10000 acquired for each record. might return HORIZONTAL:RECORDLENGTH? :HORIZONTAL:RECOrdlength...
Page 216
Syntax *IDN? Related Commands Examples might return *IDN? :TEKTRONIX,DPO4034,SN123456789,CF:91.1CT indicating 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 217
Commands Listed in Alphabetical Order Group Miscellaneous Syntax LANGuage {ENGLish|FRENch|GERMan|ITALian|SPANish|PORTUguese|JAPAnese| KOREan|RUSSian|SIMPlifiedchinese|TRADitionalchinese} LANGuage? Examples might return LANGUAGE? :LANGUAGE ENGLISH LOCk Enables or disables all front-panel buttons and knobs. There is no front panel equivalent. When the front panel is locked, neither theFPAnel:PRESS nor the FPAnel:TURN...
Page 218
Commands Listed in Alphabetical Order oscilloscope settings. You can use these commands to return the oscilloscope to the state it was in when you made the *LRN? query. This command is identical to the SET? Command. Group Miscellaneous Syntax *LRN? Related Commands SET? Examples...
Page 219
Commands Listed in Alphabetical Order MARK Moves to the next or previous reference mark on the waveform. Returns the current mark position. Group Mark Syntax MARK {NEXT|PREVious} MARK? Arguments moves to the next reference mark on the right. NEXT moves to the next reference mark on the left. PREVious MARK:CREATE (No Query Form) Creates a mark on a specified waveform or all waveforms in a column.
Page 220
Commands Listed in Alphabetical Order Syntax MARK:DELEte {CH<x>|MATH|B<x>|REF<x>|DIGital|COLUMN} Arguments deletes the mark on a channel waveform, where <x> is the channel number. CH<x> deletes the mark on the math waveform. MATH deletes the mark on a bus waveform, where <x> is the bus number. B<x>...
Page 221
Commands Listed in Alphabetical Order MARK:SELected:MARKSINCOLumn? (Query Only) Returns the number of marks in the current zoom pixel column. Group Mark Syntax MARK:SELected:MARKSINCOLumn? MARK:SELected:OWNer? (Query Only) Returns the owner of the selected mark. Group Mark Syntax MARK:SELected:OWNer? Returns is the owner of the mark. <QString>...
Page 222
Commands Listed in Alphabetical Order MARK:SELected:STATe? (Query Only) Returns the on or off state of the selected mark. The selected mark is at or near the center of the screen. If you press the front-panel Set/Clear button, this mark will disappear. Group Mark Syntax...
Page 223
Commands Listed in Alphabetical Order Examples sets the label for the math waveform to Output. MATH:LABEL “Output” might return MATH:LABEL? MATH:LABEL "Sum of channel 1 and indicating the current label for the math waveform. channel 2" MATH[1]? (Query Only) Returns the definition of the math waveform. The returned data depends on the setting of the MATH[1]:TYPe command.
Commands Listed in Alphabetical Order Related Commands MATHVAR:VAR<x>, MATH[1]:TYPe Arguments quoted string argument is the mathematical expression that defines <QString> the waveform. Table 2-42: Advanced Math expression elements Expression Description CH1-CH4, REF1-REF4 Specifies a waveform data source. FFT( , INTG( , DIFF( Executes a Fast Fourier Transform, integration, or differentiation operation on the expression that follows.
Page 225
Commands Listed in Alphabetical Order MATH[1]:HORizontal:POSition Sets or returns the math horizontal display position for FFT or (non-live) math reference waveforms. Group Math Syntax MATH[1]:HORizontal:POSition <NR3> MATH[1]:HORizontal:POSition? Arguments is the % of the math waveform that precedes center screen. It can vary <NR3>...
Page 226
Commands Listed in Alphabetical Order 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:MAG Sets or returns the units of the Spectral Magnification function in the math string. Group Math Syntax...
Page 227
Commands Listed in Alphabetical Order Arguments window function is equivalent to multiplying all gate data by one. RECTangular window function is based on a cosine series. HAMming window function is based on a cosine series. HANning window function is based on a cosine series. BLAckmanharris Examples applies a Hanning window to the spectral...
Page 228
Commands Listed in Alphabetical Order Group Math Syntax MATH[1]:VERTical:POSition <NR3> MATH[1]:VERTical:POSition? Related Commands CH<x>:POSition, REF<x>:VERTical:POSition Arguments is the desired position in divisions from the center graticule. <NR3> Examples positions the Math 1 input signal MATH1:VERTICAL:POSITION 1.3E+00 1.3 divisions higher than a position of 0. might return MATH1:VERTICAL:POSITION? :MATH1:VERTICAL:POSITION...
Page 229
Commands Listed in Alphabetical Order Group Math Syntax MATH[1]:VERTical:UNIts? Examples might return MATH:VERTICAL:UNITS? MATH:VERTICAL:UNITS "joules" indicating that the math vertical unit label for unknown values is joules. MATHVAR? (Query Only) Queries both numerical values you can use within math expressions. Group Math Syntax...
Page 230
Commands Listed in Alphabetical Order Arguments specifies the numerical value to be stored in location x <1 through 2>. <NR3> Examples stores the value -2.43e-5 in the second math variable MATHVAR:VAR2 -2.43E-5 location. might return for the MATHVAR:VAR2? :MATHVAR:VAR2 24.3000E-6 expression stored in location 2.
Page 231
Commands Listed in Alphabetical Order MEASUrement:CLEARSNapshot (No Query Form) Removes the measurement snapshot display. Group Measurement Syntax MEASUrement:CLEARSNapshot Related Commands CLEARMenu MEASUrement:GATing Specifies or returns the measurement gating setting. Group Measurement Syntax MEASUrement:GATing {OFF|SCREen|CURSor} MEASUrement:GATing? Arguments turns off measurement gating (full record). turns on gating, using the left and right edges of the screen.
Page 232
Commands Listed in Alphabetical Order Examples might return MEASUREMENT:IMMED? :MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2 MEASUrement:IMMed:DELay? (Query Only) Returns information about the immediate delay measurement. This command is equivalent to viewing the delay measurement settings on the measurement readout. Group Measurement Syntax...
Page 233
Commands Listed in Alphabetical Order Examples starts searching from the MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS beginning of the waveform record and looks for the first rising or falling edge. might return MEASUREMENT:IMMED:DELAY:DIRECTION? indicating :MEASUREMENT:IMMED:DELAY:DIRECTION BACKWARDS that searching begins at the end of the waveform record and looks for the last rising or falling edge.
Page 234
Commands Listed in Alphabetical Order Group Measurement Syntax MEASUrement:IMMed:SOUrce<x> {CH1|CH2|CH3|CH4|MATH|D<x>|HIStogram} MEASUrement:IMMed:SOUrce<x>? Arguments is the source waveform. CH1–CH4 MATH is the math waveform. MATH is a digital waveform. The x variable can be expressed as an integer, where x D<X> is the digital channel number. Digital channels are available only on MSO models. indicates the histogram as the object to be measured.
Page 235
Commands Listed in Alphabetical Order measures the duration of a burst. The measurement is made over the entire BURst waveform or gated region. (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.
Page 236
Commands Listed in Alphabetical Order (negative duty cycle) is the ratio of the negative pulse width to the signal NDUty period, expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region. Negative Duty Cycle = ((Negative Width) / Period) ×...
Page 237
Commands Listed in Alphabetical Order low reference value (default is 10%) to a high reference value (default is 90%). This measurement is applicable only to the analog channels. amplitude measurement finds the true Root Mean Square voltage in the entire waveform or gated region. This measurement is applicable only to the analog channels.
Page 238
Commands Listed in Alphabetical Order Unit string Description "A/W" ampere per watt "A/dB" amperes per decibel amperes per second "A/s" "AA" amperes squared "AW" ampere-watts "AdB" ampere-decibels "As" ampere-seconds "B" bytes "Hz" hertz "IRE" Institute of Radio Engineers units "S/s" samples per second "V"...
Page 239
Commands Listed in Alphabetical Order Unit string Description "dB/W" decibels per watt "dB/dB" decibels per decibel "dBA" decibel-amperes "dBV" decibel-volts "dBW" decibel-watts "dBdB" decibels squared "day" days "degrees" degrees "div" divisions "edges" edges "hits" hits "hr" hours "joules" joules "min" minutes "ohms"...
Page 240
Commands Listed in Alphabetical Order Related Commands MEASUrement:IMMed:TYPe, MEASUrement:IMMed:SOUrce<x>, *ESR?, ALLEv? Examples might return :MEASUREMENT:IMMED:VALUE MEASUREMENT:IMMED:VALUE? If the measurement has an error or warning associated with it, 9.9000E+37. then an item is added to the error queue. The error can be checked for with the *ESR? ALLEv? commands.
Page 241
Commands Listed in Alphabetical Order Measurement Group Syntax MEASUrement:INDICators:NUMHORZ? Examples might return MEASUREMENT:INDICATORS:NUMHORZ? indicating there are currently MEASUREMENT:INDICATORS:NUMHORZ 2 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.
Page 242
Commands Listed in Alphabetical Order Examples turns on the display of visible MEASUREMENT:INDICATORS:STATE MEAS2 measurement indicators for measurement 2. might return MEASUREMENT:INDICATORS:STATE? indicating that no measurement MEASUREMENT:INDICATORS:STATE OFF indicators are active. MEASUrement:INDICators:VERT<x>? (Query Only) Returns the value of the specified vertical measurement indicator <x> from the trigger point, where <x>...
Page 243
Commands Listed in Alphabetical Order Examples might return MEASUREMENT:MEAS3:COUNT? :MEASUREMENT:MEAS3:COUNT 3247. MEASUrement:MEAS<x>:DELay? (Query Only) Returns the delay measurement parameters for the measurement specified by <x>, which ranges from 1 through 8. Measurement Group 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"...
Page 244
Commands Listed in Alphabetical Order Examples starts searching from MEASUREMENT:MEAS3:DELAY:DIRECTION BACKWARDS the end of the waveform record. 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.
Page 245
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 8. Measurement Group Syntax MEASUrement:MEAS<x>:MEAN? Examples might return MEASUREMENT:MEAS1:MEAN? :MEASUREMENT:MEAS1:MEAN 514.71E-09.
Page 246
Commands Listed in Alphabetical Order Related Commands MEASUrement:MEAS<x>:TYPe Arguments is an input channel waveform, where x is the channel number. CH<x> is the math waveform. MATH is a reference waveform, where x is the reference channel number. REF<x> is a digital waveform, where x is the digital channel number. Digital D<x>...
Page 247
Commands Listed in Alphabetical Order Examples computes and displays the measurement MEASUREMENT:MEAS2:STATE ON defined as measurement 2. 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.
Page 248
Commands Listed in Alphabetical Order measures the voltage over time. The area is over the entire waveform or AREa gated region and is measured in volt-seconds. The area measured above the ground is positive, while the area below ground is negative. This measurement is applicable only to the analog channels.
Page 249
Commands Listed in Alphabetical Order finds the minimum amplitude. This value is typically the most negative MINImum peak voltage. It is measured over the entire waveform or gated region. This measurement is applicable only to the analog channels. (negative duty cycle) is the ratio of the negative pulse width to the signal NDUty period, expressed as a percentage.
Page 250
Commands Listed in Alphabetical Order (positive width) is the distance (time) between the middle reference PWIdth (default = 50%) amplitude points of a positive pulse. The measurement is made on the first pulse in the waveform or gated region. timing measurement finds the rise time of the waveform. The rise time is RISe the time it takes for the leading edge of the first pulse encountered to rise from a low reference value (default is 10%) to a high reference value (default is 90%).
Page 251
Commands Listed in Alphabetical Order Unit string Description "%" percent "/Hz" inverse hertz indeterminate "?" amperes "A" amperes per ampere "A/A" "A/V" amperes per volt ampere per watt "A/W" amperes per decibel "A/dB" "A/s" amperes per second "AA" amperes squared ampere-watts "AW"...
Page 252
Commands Listed in Alphabetical Order Unit string Description "WdB" watt-decibels "Wfms" waveforms "Ws" watt-seconds "dB" decibels "dB/A" decibels per ampere decibels per volt "dB/V" "dB/W" decibels per watt "dB/dB" decibels per decibel "dBA" decibel-amperes "dBV" decibel-volts "dBW" decibel-watts "dBdB" decibels squared "day"...
Page 253
Commands Listed in Alphabetical Order Measurement Group Syntax MEASUrement:MEAS<x>:VALue? Related Commands MEASUrement:MEAS<x>:UNIts?, *ESR?, ALLEv? Examples might return MEASUREMENT:MEAS1:VALUE? :MEASUREMENT:MEAS1:VALue . If the measurement has an error or warning associated with it, 2.8740E-06 then an item is added to the error queue. The error can be checked for with the *ESR? ALLEv? commands.
Page 254
Commands Listed in Alphabetical Order Measurement Group Syntax MEASUrement:REFLevel? Examples might return these reference MEASUREMENT:REFLEVEL? level settings :MEASUREMENT: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:REFLevel:ABSolute:HIGH Sets or returns the high reference level, and is the upper reference level when MEASUrement:REFLevel:METHod is set to Absolute.
Page 255
Commands Listed in Alphabetical Order NOTE. this command affects the associated reference level parameter for all MEASurements:IMMed and the four periodic measurements. Group Measurement Syntax MEASUrement:REFLevel:ABSolute:LOW <NR3> MEASUrement:REFLevel:ABSolute:LOW? 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>...
Page 256
Commands Listed in Alphabetical Order Examples sets the mid reference level MEASUREMENT:REFLEVEL:ABSOLUTE:MID 1 .71 to .71 V. might return MEASUREMENT:REFLEVEL:ABSOLUTE:MID? indicating :MEASUREMENT:REFLEVEL:ABSOLUTE:MID 0.7100E+00 that the absolute mid1 reference level is set to .71 V. 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.
Page 257
Commands Listed in Alphabetical Order Syntax MEASUrement:REFLevel:ABSolute:MID<x> <NR3> MEASUrement:REFLevel:ABSolute:MID<x>? Arguments is the mid reference level in volts. <NR3> 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 258
Commands Listed in Alphabetical Order NOTE. This command affects the associated reference level parameter for all MEASurements:IMMed and the four periodic measurements. Group Measurement 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>...
Page 259
Commands Listed in Alphabetical Order Arguments is the low reference level, ranging from 0 to 100%. The default low <NR3> reference level is 10%. Examples sets the high reference level to MEASUREMENT:REFLEVEL:PERCENT:LOW 15 15% of HIGH. might return MEASUREMENT:REFLEVEL:PERCENT:LOW? indicating that the :MEASUREMENT:REFLEVEL:PERCENT:LOW 10 percentage high reference level is set to 10% of HIGH.
Page 260
Commands Listed in Alphabetical Order MEASUrement:REFLevel:METHod is set to Percent. This command affects the results of delay measurements. NOTE. this command affects the associated reference level parameter for all MEASurements:IMMed and the four periodic measurements. Group Measurement Syntax MEASUrement:REFLevel:PERCent:MID2 <NR3> MEASUrement:REFLevel:PERCent:MID2? Related Commands MEASUrement:REFLevel:METHod...
Page 261
Commands Listed in Alphabetical Order Measurement Group Syntax MEASUrement:SNAPShot MEASUrement:STATIstics (No Query Form) Clears all of the statistics accumulated for all periodic measurements (MEAS1 through MEAS4). The query form returns statistic settings. Group Measurement Syntax MEASUrement:STATIstics RESET MEASUrement:STATIstics? Arguments clears the measurements. RESET MEASUrement:STATIstics:MODE Controls the operation and display of management statistics.
Page 262
Commands Listed in Alphabetical Order MEASUrement:STATIstics:WEIghting Sets or returns the time constant for mean and standard deviation statistical accumulations. Measurement Group Syntax MEASUrement:STATIstics:WEIghting <NR1> MEASUrement:STATIstics:WEIghting? Related Commands MEASUrement:STATIstics:MODE Arguments is the number of samples used for the mean and standard deviation <NR1>...
Page 263
Commands Listed in Alphabetical Order X1 and Y1 are the screen coordinates of the top left corner of the message box. X2 and Y2 are the screen coordinates of the bottom right corner of the message box. All four coordinates are returned by the query. Changing the text in the message box, using the MESSAGE:SHOW command, automatically resizes the message box.
Page 264
Commands Listed in Alphabetical Order MESSage:SHOW Sets or returns the contents of the message box. MESSage:SHOW <Qstring> defines the content of the message box. Change in string length causes automatic resize of the message box to fit the text. The box may be resized using the MESSage:BOX command.
Page 265
Commands Listed in Alphabetical Order 279, then 279 = 0x0117; split the hexadecimal number into two characters 0x01 and 0x17 and send \x09\x01\x17. Special characters which control decoration are two character sequences where the first character is an escape (0x1b) and the second character is as described below. Bit 7 Bit 6 If set, inverse video is toggled from current state and the following text...
Page 266
Commands Listed in Alphabetical Order Example: “abcESC#defESC)ESC@ghi” specifies the string “abcdefghi” where the “def” portion appears in the channel 3 color (magenta) and the “ghi” portion appears in the normal text color except it’s in inverse video. An alternate way to enter characters is octal escape sequences. This consists of a backslash followed by numerals in the standard C language printf fashion.
Page 267
Commands Listed in Alphabetical Order Related Commands MESSage:BOX MESSage:SHOW, MESSage:CLEAR Arguments removes the message window from the screen. OFF or <NR1> = 0 displays the message window and its contents on the screen. ON or <NR1> ≠ 0 NEWpass (No Query Form) This command changes the password that enables access to password protected data.
Page 268
Commands Listed in Alphabetical Order Syntax *OPC *OPC? Related Commands BUSY?, *WAI Examples generates the operation complete message in the SESR at the completion of *OPC all pending OPC operations. might return 1 to indicate that all pending OPC operations are finished. *OPC? PASSWord(No Query Form) Enables the *PUD and NEWpass set commands.
Page 269
Commands Listed in Alphabetical Order Syntax PICTBridge:DATEPrint {DEFLT|OFF|ON} Arguments is the default setting of the printer. DEFLT enables the date print on the print output. disables the date print on the print output. Examples enables the date print on the print output. PICTBRIDGE:DATEPRINT ON ? might return PICTBRIDGE:DATEPRINT...
Page 270
Commands Listed in Alphabetical Order Examples enables the printing of oscilloscope model and serial PICTBRIDGE:IDPRINT ON number on the print output. ? might return indicating PICTBRIDGE:IDPRINT PICTBRIDGE:IDPRINT OFF that the ID print is disabled on the print output. PICTBridge:IMAGESize Sets or returns the image print size. Group PictBridge Syntax...
Page 271
Commands Listed in Alphabetical Order Examples sets the image print size to 89 MM* 55 MM. PICTBRIDGE:IMAGESIZE CARD ? might return PICTBRIDGE:IMAGESIZE PICTBRIDGE:IMAGESIZE DEFLT indicating the default image print size. PICTBridge:PAPERSize Sets the output print paper size. Group PictBridge Syntax PICTBridge:PAPERSize DEFLT|L|L2|HAGAKIPCARD|MM54BY86|MM100BY150|IN4BY6|IN8BY10|LETTER|IN11 B4|B5|B6|B7|B8|B9|ROLL89MM|ROLL127MM|ROLL100MM|ROLL210MM}...
Page 272
Commands Listed in Alphabetical Order for a A9 paper size. for a B0 paper size. for a B1 paper size. 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.
Page 273
Commands Listed in Alphabetical Order Examples sets the paper type to Plain. PICTBRIDGE:PAPERTYPE PLAIN might return PICTBRIDGE:PAPERTYPE? PICTBRIDGE:PAPERTYPE DEFLT indicating the default paper type. 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.
Page 274
Commands Listed in Alphabetical Order Examples sets the current source as CH1. POWER:CURRENTSOURCE CH1 ? might return indicating POWER:CURRENTSOURCE POWER:CURRENTSOURCE CH2 that CH2 is the current source. POWer:DISplay Sets or returns the display state for the power application. This is the equivalent to pressing the Test button and then selecting the power application.
Page 275
Commands Listed in Alphabetical Order is set when the gate source is not used in the application. NONe Examples sets the gated source as CH1. POWER:GATESOURCE CH1 ? might return indicating that POWER:GATESOURCE POWER:GATESOURCE CH2 CH2 is the gated source. POWer:GATing Sets or returns the power application gating.
Page 276
Commands Listed in Alphabetical Order Arguments to display only odd harmonics. to display only even harmonics. EVEN to display both odd and even harmonics. Examples displays only even harmonics. POWER:HARMONICS:DISPLAY:SELECT EVEN might return POWER:HARMONICS:DISPLAY:SELECT? indicating that both odd and :POWER:HARMONICS:DISPLAY:SELECT ALL even harmonics are displayed.
Page 277
Commands Listed in Alphabetical Order Syntax POWer:HARMonics:FREQRef {VOLTage|CURRent|HARMSOURce|FIXEDFREQuency} POWer:HARMonics:FREQRef? Arguments to use a voltage waveform as the frequency reference. VOLTage to use a current waveform as the frequency reference. CURRent to use a harmonic source waveform as the frequency reference. HARMSOURce to use a fixed frequency value instead of a waveform for the FIXEDFREQuency...
Page 278
Commands Listed in Alphabetical Order POWer:HARMonics:IEC:CLAss Sets or returns the equipment class for IEC harmonics. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:IEC:CLAss {A|B|C1|C2|C3|D} POWer:HARMonics:IEC:CLAss? Arguments specifies Class A Equipment. specifies Class B Equipment. specifies Class C Equipment that use Table 1 limits of the IEC standard. specifies Class C Equipment that use Table 2 limits of the IEC standard.
Page 279
Commands Listed in Alphabetical Order Examples disables filtering of IEC harmonics. POWER:HARMONICS:IEC:FILTER OFF might return POWER:HARMONICS:IEC:FILTER? indicating that the IEC harmonics are :POWER:HARMONICS:IEC:FILTER 1 filtered. POWer:HARMonics:IEC:FUNDamental Sets or returns the rated fundamental current for IEC harmonics. Valid values ranges from 0 to 16 in increments of 0.1. The unit is ampere. Conditions This command requires a DPO4PWR application module.
Page 280
Commands Listed in Alphabetical Order Arguments or 1 enables grouping of IEC harmonics. or 0 disables grouping of IEC harmonics. Examples disables grouping of IEC harmonics. POWER:HARMONICS:IEC:GROUPING OFF might return POWER:HARMONICS:IEC:GROUPING? indicating that the grouping is enabled :POWER:HARMONICS:IEC:GROUPING 1 for IEC harmonics. POWer:HARMonics:IEC:INPUTPOWer Sets or returns the class D rated input power for IEC harmonics.
Page 281
Commands Listed in Alphabetical Order Syntax POWer:HARMonics:IEC:LINEFREQuency <NR3> POWer:HARMonics:IEC:LINEFREQuency? Arguments is the line frequency. The valid values are 50 and 60. <NR3> Examples sets the line frequency to 50 Hz. POWER:HARMONICS:IEC:LINEFREQUENCY 50 might return POWER:HARMONICS:IEC:LINEFREQUENCY? indicating that the :POWER:HARMONICS:IEC:LINEFREQUENCY 60 line frequency value is set to 60 Hz.
Page 282
Commands Listed in Alphabetical Order Syntax POWer:HARMonics:IEC:POWERFACtor <NR3> POWer:HARMonics:IEC:POWERFACtor? Arguments is the power factor. Valid values ranges from 0 to 1 in increments of 0.1. <NR3> Examples sets the power factor to 1.0000. POWER:HARMONICS:IEC:POWERFACTOR 1 might return POWER:HARMONICS:IEC:POWERFACTOR? indicating :POWER:HARMONICS:IEC:POWERFACTOR 900.0000E-03 that the power factor is set to 0.9.
Page 283
Commands Listed in Alphabetical Order Power Group Syntax POWer:HARMonics:MIL:FUNDamental:USER:CURRent <NR3> POWer:HARMonics:MIL:FUNDamental:USER:CURRent? Arguments is the current in amperes for USER CALCmethod. <NR3> Examples sets the RMS POWER:HARMONICS:MIL:FUNDAMENTAL:USER:CURRENT 2 fundamental current to 2 A in calculating limits. might return POWER:HARMONICS:MIL:FUNDAMENTAL:USER:CURRENT? indicating :POWER:HARMONICS:MIL:FUNDAMENTAL:USER:CURRENT 1.0000 that the RMS fundamental current for use in calculating limits is 1.0000 A.
Page 284
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:MIL:POWERLEVel {LOW|HIGH} POWer:HARMonics:MIL:POWERLEVel? Arguments specifies low power level for MIL-STD-1399 harmonics tests. specifies high power level for MIL-STD-1399 harmonics tests. HIGH Examples sets the MIL power level to High. POWER:HARMONICS:MIL:POWERLEVEL HIGH might return POWER:HARMONICS:MIL:POWERLEVEL?
Page 285
Commands Listed in Alphabetical Order NOTE. The command returns NA, if the current harmonic standard is set to a new standard other than the returned query. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:RESults:HAR<1-400>:FREQuency? Examples might return POWER:HARMONICS:RESULTS:HAR400:FREQUENCY? indicating that :POWER:HARMONICS:RESULTS:HAR400:FREQUENCY 24000...
Page 286
Commands Listed in Alphabetical Order the standard. IEC Class C (Table 2) and MIL standards specify the limit as a percentage of the fundamental. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:RESults:HAR<1-400>:LIMit? Examples might return POWER:HARMONICS:RESULTS:HAR3:LIMIT? indicating that :POWER:HARMONICS:RESULTS:HAR3:LIMIT 2.30 the harmonic magnitude limit for IEC standard for the 3rd harmonic is set to...
Page 287
Commands Listed in Alphabetical Order Syntax POWer:HARMonics:RESults:HAR<1-400>:RMS:ABSolute? Examples might return POWER:HARMONICS:RESULTS:HAR400:RMS:ABSOLUTE? indicating that :POWER:HARMONICS:RESULTS:HAR400:RMS:ABSOLUTE 1.0 the RMS magnitude of the harmonic is set to 1.0 A. POWer:HARMonics:RESults:HAR<1-400>:RMS:PERCent? (Query Only) Returns the RMS magnitude of the harmonic expressed as a percentage of the fundamental.
Page 288
Commands Listed in Alphabetical Order POWer:HARMonics:RESults:HAR<1-400>:TEST:IEC:NORMAL? (Query Only) Specifies if the Normal IEC harmonic limits are met. NOTE. The command returns NA if the standard does not specify a limit. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:RESults:HAR<1-400>:TEST:IEC:NORMAL? , or...
Page 289
Commands Listed in Alphabetical Order NOTE. The command returns NA if the standard does not specify a limit for the specific harmonic. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:RESults:HAR<1-400>:TEST:MIL:NORMAL? , or Returns PASS FAIL POWer:HARMonics:RESults:IEC:FUNDamental? (Query Only) Returns the IEC fundamental current used in calculating limits.
Page 290
Commands Listed in Alphabetical Order , or Returns PASS FAIL Examples might return POWER:HARMONICS:RESULTS:IEC:HARM3ALTERNATE? indicating the POWER:HARMONICS:RESULTS:IEC:HARM3ALTERNATE PASS test result. POWer:HARMonics:RESults:IEC:HARM5ALTernate? (Query Only) Returns the overall harmonics test result for the 5th harmonic. NOTE. The command returns NA the harmonic limit does not apply. Conditions This command requires a DPO4PWR application module.
Page 291
Commands Listed in Alphabetical Order POWer:HARMonics:RESults:IEC:POHL? (Query Only) Returns the IEC POHL measurement. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:RESults:IEC:POHL? Examples might return POWER:HARMONICS:RESULTS:IEC:POHL? indicating that the :POWER:HARMONICS:RESULTS:IEC:POHL 0.5 IEC POHL is set to 0.5 A. POWer:HARMonics:RESults:IEC:POWer? (Query Only) Returns the IEC input power that is used to calculate limits.
Page 292
Commands Listed in Alphabetical Order Examples might return POWER:HARMONICS:RESULTS:IEC:POWERFACTOR? indicating :POWER:HARMONICS:RESULTS:IEC:POWERFACTOR 9.1900E+37 that the IEC power factor is set to 9.1900E+37. POWer:HARMonics:RESults:PASSFail? (Query Only) Returns the overall harmonics test result: PASS, FAIL or NA. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 293
Commands Listed in Alphabetical Order Power Group Syntax POWer:HARMonics:RESults:SAVe <String> POWer:HARMonics:RESults:THDF? (Query Only) Returns the Total Harmonic Distortion (THD) in percentage, measured as a ratio to the RMS value of the fundamental component of the source waveform. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 294
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:HARMonics:SOURce {VOLTage|CURRent} POWer:HARMonics:SOURce? Arguments specifies voltage source waveform for harmonic tests. VOLTage specifies current source waveform for harmonic tests. CURRent Examples sets voltage source for harmonic tests. POWER:HARMONICS:SOURCE VOLTage might return POWER:HARMONICS:SOURCE?
Page 295
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:INDICators {OFF|ON|0|1} POWer:INDICators? Arguments or 0 turns off the measurement indicators. or 1 turns on the measurement indicators. Examples turns on the indicator. POWER:INDICATORS 1 might return indicating that POWER:INDICATORS?
Page 296
Commands Listed in Alphabetical Order POWer:MODulation:TYPe Sets or returns the modulation type. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:MODulation:TYPe {PWIdth|NWIdth|PERIod|PDUty|NDUty|FREQuency} POWer:MODulation:TYPe? Arguments (positive width) is the distance (time) between the middle reference PWIdth (default = 50%) amplitude points of a positive pulse. The measurement is made on all the cycles in the waveform or gated region.
Page 297
Commands Listed in Alphabetical Order POWer:QUALity:APPpwr? (Query Only) Returns the apparent power measurement. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:APPpwr? Examples might return POWER:QUALITY:APPPWR? :POWER:QUALITY:APPpwr 100 indicating that the apparent power value is set to 100 VA. POWer:QUALity:DISplay:APPpwr Sets or returns the display state for the apparent power readout.
Page 298
Commands Listed in Alphabetical Order Power Group Syntax POWer:QUALity:DISplay:FREQuency {OFF|ON|0|1} POWer:QUALity:DISplay:FREQuency? Arguments or 0 turns off the frequency display. or 1 turns on the frequency display. Examples turns on the frequency readout POWER:QUALITY:DISPLAY:FREQUENCY 1 display. might return POWER:QUALITY:DISPLAY:FREQUENCY? indicating that the :POWER:QUALITY:DISPLAY:FREQUENCY 0 frequency readout display is off.
Page 299
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:DISplay:IRMS {OFF|ON|0|1} POWer:QUALity:DISplay:IRMS? Arguments or 0 turns off the rms current display. or 1 turns on the rms current display. Examples turns on the rms current display. POWER:QUALITY:DISPLAY:IRMS 1 might return POWER:QUALITY:DISPLAY:IRMS?
Page 300
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:DISplay:POWERFACtor {OFF|ON|0|1} POWer:QUALity:DISplay:POWERFACtor? Arguments or 0 turns off the power factor display. or 1 turns on the power factor display. Examples turns on the power factor display. POWER:QUALITY:DISPLAY:POWERFACTOR 1 might return POWER:QUALITY:DISPLAY:POWERFACTOR?
Page 301
Commands Listed in Alphabetical Order POWer:QUALity:DISplay:TRUEpwr Sets or returns the display state for the true power readout. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:DISplay:TRUEpwr {OFF|ON|0|1} POWer:QUALity:DISplay:TRUEpwr? Arguments or 0 turns off the true power display. or 1 turns on the true power display.
Page 302
Commands Listed in Alphabetical Order might return POWER:QUALITY:DISPLAY:VCRESTFACTOR? indicating that the :POWER:QUALITY:DISPLAY:VCRESTFACTOR 0 voltage crest factor display is off. POWer:QUALity:DISplay:VRMS Sets or returns the display state for the rms voltage readout. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:DISplay:VRMS {OFF|ON|0|1}...
Page 303
Commands Listed in Alphabetical Order Examples sets current as the power quality POWER:QUALITY:FREQREFERENCE CURRent frequency reference source. might return POWER:QUALITY:FREQREFERENCE? indicating that the power quality :POWER:QUALITY:FREQREFERENCE VOLTAGE frequency reference source is set to Voltage. POWer:QUALity:FREQuency? (Query Only) Returns the frequency measurement. Conditions This command requires a DPO4PWR application module.
Page 304
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:QUALity:IRMS? Examples might return POWER:QUALITY:IRMS? :POWER:QUALITY:IRMS 1.00 indicating that the RMS current value is set to 1.00 A. POWer:QUALity:PHASEangle? (Query Only) Returns the phase angle measurement. Conditions This command requires a DPO4PWR application module.
Page 305
Commands Listed in Alphabetical Order POWer:QUALity:REACTpwr? (Query Only) Returns the reactive power measurement. Conditions This command requires a DPO4PWR application module. Power Group Syntax POWer:QUALity:REACTpwr? Examples might return POWER:QUALITY:REACTPWR? :POWER:QUALITY:REACTpwr 100 indicating that the reactor power value is set to 100 VAR. POWer:QUALity:TRUEpwr? (Query Only) Returns the true power measurement.
Page 306
Commands Listed in Alphabetical Order Examples might return indicating POWER:QUALITY:VRMS? :POWER:QUALITY:VRMS 115 that the rms voltage value is set to 115 V. POWer:REFLevel:ABSolute (No Query Form) Sets the reference levels to their default unit values. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 307
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:REFLevel:ABSolute:LOW <NR3>; Ranges={D,-1e6,+1E6} POWer:REFLevel:ABSolute:LOW? Arguments is the absolute low value in volts. Default value is 0.0E+0. <NR3> Examples sets the absolute high value to 1.0000. POWER:REFLEVEL:ABSOLUTE:LOW 1.0 might return POWER:REFLEVEL:ABSOLUTE:LOW?
Page 308
Commands Listed in Alphabetical Order Conditions This command requires a DPO4PWR application module. Power Group Syntax POWer:REFLevel:HYSTeresis <NR3> POWer:REFLevel:HYSTeresis? Arguments is the hysteresis value. <NR3> Examples sets the hysteresis value to 30. POWER:REFLEVEL:HYSTERESIS 30 might return POWER:REFLEVEL:HYSTERESIS? indicating that the hysteresis value is POWER:REFLEVEL:HYSTERESIS 10 set to 10.
Page 309
Commands Listed in Alphabetical Order POWer:REFLevel:PERCent (No Query Form) Sets the reference levels to the default percentage values. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:REFLevel:PERCent <SETTODEFaults> Arguments sets the reference levels to their default percentage values. SETTODEFaults POWer:REFLevel:PERCent:HIGH Sets or returns the top reference percent level for power measurements.
Page 310
Commands Listed in Alphabetical Order Power Group Syntax POWer:REFLevel:PERCent:LOW <NR3>; Ranges={D,0.0,100.0} POWer:REFLevel:PERCent:LOW? Arguments is the low value in percentage. <NR3> Examples sets the low reference level to 15% of the POWER:REFLEVEL:PERCENT:LOW 15 signal amplitude. might return POWER:REFLEVEL:PERCENT:LOW? indicating that the percentage low :POWER:REFLEVEL:PERCENT:LOW 10 reference level is set to 90% of the signal amplitude.
Page 311
Commands Listed in Alphabetical Order Power Group Syntax POWer:RIPPle {VERTAUTOset|VERTDEFault} Arguments automatically scales the source waveform to optimize ripple VERTAUTOset measurements. sets the vertical offset of the source waveform to 0 volts (for VERTDEFault voltage source) or 0 amperes (for current source). POWer:RIPPle:RESults:AMPLitude? (Query Only) Returns the peak-to-peak ripple measurement.
Page 312
Commands Listed in Alphabetical Order POWer:RIPPle:RESults:MEAN? (Query Only) Returns the mean of the peak-to-peak ripple measurements. Conditions This command requires a DPO4PWR application module. Power Group Syntax POWer:RIPPle:RESults:MEAN? Examples might return POWER:RIPPLE:RESULTS:MEAN? indicating that the mean peak-to-peak :POWER:RIPPLE:RESULTS:MEAN 1.0 amplitude is set to 1.0 V. POWer:RIPPle:RESults:MIN? (Query Only) Returns the minimum of the peak-to-peak ripple measurement.
Page 313
Commands Listed in Alphabetical Order Examples might return POWER:RIPPLE:RESULTS:STDDEV? indicating that the standard :POWER:RIPPLE:RESULTS:STDDEV 0.14 deviation of the peak-to-peak amplitude is set to 0.14. POWer:RIPPle:SOUrce Sets or returns the source waveform for ripple tests. The voltage source waveform is specified using the POWer:VOLTAGESOurce command and the current waveform is specified using the...
Page 314
Commands Listed in Alphabetical Order Examples sets the XMAX value to 700.0000. POWER:SOA:LINEAR:XMAX 700 might return POWER:SOA:LINEAR:XMAX ? :POWER:SOA:LINear:XMAX indicating that the XMAX value for linear plot type is set to 500.0000. 500.0000 POWer:SOA:LINear:XMIN Sets or returns the user XMIN value for use in linear SOA calculations. Conditions This command requires a DPO4PWR application module.
Page 315
Commands Listed in Alphabetical Order Examples sets the YMAX value to 700.0000. POWER:SOA:LINEAR:YMAX 700 might return POWER:SOA:LINEAR:YMAX ? :POWER:SOA:LINear:YMAX indicating that the YMAX value for linear plot type is set to 50.0000. 50.0000 POWer:SOA:LINear:YMIN Sets or returns the user YMIN value for use in linear SOA calculations. Conditions This command requires a DPO4PWR application module.
Page 316
Commands Listed in Alphabetical Order Examples sets the XMAX value to 1.0000. POWER:SOA:LOG:XMAX 1 might return POWER:SOA:LOG:XMAX ? :POWER:SOA:LOG:XMAX 1.0000E+3 indicating that the XMAX value for log plot type is set to 1.0000E+3. POWer:SOA:LOG:XMIN Sets or returns the user XMIN value for use in Log SOA calculations. Conditions This command requires a DPO4PWR application module.
Page 317
Commands Listed in Alphabetical Order Examples sets the YMAX value to 10.0000. POWER:SOA:LOG:YMAX 10 might return POWER:SOA:LOG:YMAX ? :POWER:SOA:LOG:YMAX 100.0000 indicating that the YMAX value for log plot type is set to 100.0000. POWer:SOA:LOG:YMIN Sets or returns the user YMIN value for use in Log SOA calculations. Conditions This command requires a DPO4PWR application module.
Page 318
Commands Listed in Alphabetical Order Examples specifies the SOA mask coordinates as POWER:SOA:MASK:DEFINE 10 0.0E+0,0.0E+0,0.0E+0,0.0E+0,0.0E+0,30.0000,25.0000,30.0000,300.0000,2.5000,300.0000,2.4 might return POWER:SOA:MASK:DEFINE ? :POWER:SOA:MASK:DEFINE 0.0E+0,30.0000,25.0000,30.0000,300.0000,2.5000,300.0000,0.0E+0 indicating that the SOA mask coordinates are set to 0.0E+0,30.0000,25.0000,30.0000,300.0000,2.5000,300.0000,0.0E+0. POWer:SOA:MASK:MAXAmps Sets or returns the maximum current applied to SOA mask testing. Conditions This command requires a DPO4PWR application module.
Page 319
Commands Listed in Alphabetical Order Examples sets the SOA mask testing voltage to 200 V. POWER:SOA:MASK:MAXVOLTS 200 might return POWER:SOA:MASK:MAXVOLTS ? :POWER:SOA:MASK:MAXVOLTS indicating that the SOA mask testing maximum voltage is set to 300 V. 300.0000 POWer:SOA:MASK:MAXWatts Sets or returns the maximum power applied to SOA mask testing. Conditions This command requires a DPO4PWR application module.
Page 320
Commands Listed in Alphabetical Order POWer:SOA:MASK:STATe Sets or returns the state of the mask for SOA calculations. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:SOA:MASK:STATe {OFF|LIMITS|POINTS} POWer:SOA:MASK:STATe? Arguments disables mask testing. enables mask testing based on limits specified using LIMITS POWer:SOA:MASK:MAXAmps, POWer:SOA:MASK:MAXVolts, and POWer:SOA:MASK:MAXWatts...
Page 321
Commands Listed in Alphabetical Order Examples disables the state of the mask stop on POWER:SOA:MASK:STOPONVIOL 1 violation condition. might return POWER:SOA:MASK:STOPONVIOL ? indicating that the mask stop is enabled. :POWER:SOA:MASK:STOPONVIOL 0 POWer:SOA:PLOTTYPe Sets or returns the Safe Operating Area (SOA) plot type. Conditions This command requires a DPO4PWR application module.
Page 322
Commands Listed in Alphabetical Order POWer:SOA:RESult:NUMACq? (Query Only) Returns the number of acquisitions in the test. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:SOA:RESult:NUMACq? Examples might return POWER:SOA:RESULT:NUMACQ? :POWER:SOA:RESULT:NUMACQ indicating that the number of acquisitions is 10. POWer:SOA:RESult:STATe? (Query Only) Returns the pass/fail state of the SOA test.
Page 323
Commands Listed in Alphabetical Order Syntax POWer:STATIstics {RESET} Arguments clears the measurement statistics. RESET POWer:STATIstics:MODE Enables or disables the display of the measurement statistics. Performs the same function as the MEASUrement:STATIstics:MODE command. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 324
Commands Listed in Alphabetical Order Arguments is the number of samples used for the mean and standard deviation <NR1> statistical accumulations Examples sets statistical weighting to four samples. POWER:STATISTICS:WEIGHTING 4 might return POWER:STATISTICS:WEIGHTING ? indicating that statistics weighting is :POWER:STATISTICS:WEIGHTING 4 currently set to 4 samples.
Page 325
Commands Listed in Alphabetical Order Syntax POWer:SWLoss:CONDuction:ENERGY:MAX? Examples might return POWER:SWLOSS:CONDUCTION:ENERGY:MAX? indicating that the :POWER:SWLOSS:CONDUCTION:ENERGY:MAX 1 maximum conduction energy switching loss calculation is set to 1 J. POWer:SWLoss:CONDuction:ENERGY:MEAN? (Query Only) Returns the mean conduction energy in the conduction period for the switching loss calculation.
Page 326
Commands Listed in Alphabetical Order POWer:SWLoss:CONDuction:POWER:MAX? (Query Only) Returns the maximum conduction power for the switching loss calculation. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:SWLoss:CONDuction:POWER:MAX? Examples might return POWER:SWLOSS:CONDUCTION:POWER:MAX? indicating that the :POWER:SWLOSS:CONDUCTION:POWER:MAX 1 maximum conduction power switching loss calculation is set to 1 W. POWer:SWLoss:CONDuction:POWER:MEAN? (Query Only) Returns the mean conduction power for the switching loss calculation.
Page 327
Commands Listed in Alphabetical Order Examples might return POWER:SWLOSS:CONDUCTION:POWER:MIN? indicating that the :POWER:SWLOSS:CONDUCTION:POWER:MIN 1 minimum conduction power switching loss calculation is set to 1 W. POWer:SWLoss:DISplay Sets or returns the display selection for switching loss results: All measurements, energy loss measurements or power loss measurements. Conditions This command requires a DPO4PWR application module.
Page 328
Commands Listed in Alphabetical Order Arguments sets falling edge as the switching loss gate polarity. FALL sets rising edge as the switching loss gate polarity. RISe Examples sets the gate polarity to Fall. POWER:SWLOSS:GATE:POLARITY FALL might return POWER:SWLOSS:GATE:POLARITY ? indicating that the gate polarity :POWER:SWLOSS:GATE:POLARITY RISE is set to Rise.
Page 329
Commands Listed in Alphabetical Order Loss power enabled, it indicates the possibility of incorrect settings and might return the following : *ESR? ALLEV? 2202,"Measurement error, No period found; :power:swloss:numcycles?",410,"Query INTERRUPTED" POWer:SWLoss:RDSon Sets or returns the user RDSON value for use in switching loss calculations when the conduction calculation method is RDSON.
Page 330
Commands Listed in Alphabetical Order Arguments is the mid voltage reference level in volts. <NR3> Examples sets the absolute gate POWER:SWLOSS:REFLEVEL:ABSOLUTE:GATEMID 100 mid reference voltage to 100.0000 V. might return POWER:SWLOSS:REFLEVEL:ABSOLUTE:GATEMID ? indicating that :POWER:SWLOSS:REFLEVEL:ABSOLUTE:GATEMID 50.0000 the gate mid reference voltage is set to 50.0000 V. POWer:SWLoss:REFLevel:ABSolute:LOWCurrent Sets or returns the low current reference level used in switching loss power measurements in amperes.
Page 331
Commands Listed in Alphabetical Order Syntax POWer:SWLoss:REFLevel:ABSolute:LOWVoltage <NR3> POWer:SWLoss:REFLevel:ABSolute:LOWVoltage? Arguments is the low voltage reference level in volts. <NR3> Examples sets the absolute POWER:SWLOSS:REFLEVEL:ABSOLUTE:LOWVOLTAGE 2.5 reference low voltage to 2.5000 V. might return POWER:SWLOSS:REFLEVEL:ABSOLUTE:LOWVOLTAGE ? indicating that :POWER:SWLOSS:REFLEVEL:ABSOLUTE:LOWVOLTAGE 5.0000 the absolute reference low voltage is set to 5.0000 V. POWer:SWLoss:REFLevel:PERCent:GATEMid Sets or returns the mid voltage reference level used in switching loss power measurements in percent.
Page 332
Commands Listed in Alphabetical Order Power Group Syntax POWer:SWLoss:REFLevel:PERCent:LOWCurrent <NR3> POWer:SWLoss:REFLevel:PERCent:LOWCurrent? Arguments is the low voltage reference level percent. <NR3> Examples sets the reference low POWER:SWLOSS:REFLEVEL:PERCENT:LOWCURRENT 15 current to 15%. might return POWER:SWLOSS:REFLEVEL:PERCENT:LOWCURRENT ? indicating that :POWER:SWLOSS:REFLEVEL:PERCENT:LOWCURRENT 5.0000 the reference low current is set to 5%. POWer:SWLoss:REFLevel:PERCent:LOWVoltage Sets or returns the low voltage reference level used in switching loss power measurements in percent.
Page 333
Commands Listed in Alphabetical Order Power Group Syntax POWer:SWLoss:TOFF:ENERGY:MAX? Examples might return POWER:SWLOSS:TOFF:ENERGY:MAX? indicating that the maximum Toff energy :POWER:SWLOSS:TON:ENERGY:MAX 1 switching loss calculation is set to 1 J. POWer:SWLoss:TOFF:ENERGY:MEAN? (Query Only) Returns the mean Toff energy for the switching loss calculation. Conditions This command requires a DPO4PWR application module.
Page 334
Commands Listed in Alphabetical Order POWer:SWLoss:TOFF:POWER:MAX? (Query Only) Returns the maximum Toff power for the switching loss calculation. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:SWLoss:TOFF:POWER:MAX? Examples might return POWER:SWLOSS:TOFF:POWER:MAX? indicating that the maximum Toff power :POWER:SWLOSS:TON:POWER:MAX 1 switching loss calculation is set to 1 W.
Page 335
Commands Listed in Alphabetical Order Examples might return POWER:SWLOSS:TOFF:POWER:MIN? indicating that the minimum Toff power :POWER:SWLOSS:TON:POWER:MIN 1 switching loss calculation is set to 1 W. POWer:SWLoss:TON:ENERGY:MAX? (Query Only) Returns the maximum Ton energy for the switching loss calculation. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 336
Commands Listed in Alphabetical Order Power Group Syntax POWer:SWLoss:TON:ENERGY:MIN? Examples might return POWER:SWLOSS:TON:ENERGY:MIN? indicating that the minimum Ton energy :POWER:SWLOSS:TON:ENERGY:MIN 1 switching loss calculation is set to 1 J. POWer:SWLoss:TON:POWER:MAX? (Query Only) Returns the maximum Ton power for the switching loss calculation. Conditions This command requires a DPO4PWR application module.
Page 337
Commands Listed in Alphabetical Order POWer:SWLoss:TON:POWER:MIN? (Query Only) Returns the minimum Ton power for the switching loss calculation. Conditions This command requires a DPO4PWR application module. Group Power Syntax POWer:SWLoss:TON:POWER:MIN? Examples might return POWER:SWLOSS:TON:POWER:MIN? indicating that the minimum Ton power :POWER:SWLOSS:TON:POWER:MIN 1 switching loss calculation is set to 1 W.
Page 338
Commands Listed in Alphabetical Order Examples might return POWER:SWLOSS:TOTAL:ENERGY:MEAN? indicating that the mean conduction :POWER:SWLOSS:TOTAL:ENERGY:MEAN 1 energy switching loss calculation is set to 1 J. POWer:SWLoss:TOTal:ENERGY:MIN? (Query Only) Returns the minimum total energy for the switching loss calculation. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 339
Commands Listed in Alphabetical Order Power Group Syntax POWer:SWLoss:TOTal:POWER:MEAN? Examples might return POWER:SWLOSS:TOTAL:POWER:MEAN? indicating that the mean total power :POWER:SWLOSS:TOTAL:POWER:MEAN 1 switching loss calculation is set to 1 W. POWer:SWLoss:TOTal:POWER:MIN? (Query Only) Returns the minimum total power loss. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 340
Commands Listed in Alphabetical Order Examples sets the VCEsat value to 5.0000. POWER:SWLOSS:VCESAT 5 might return POWER:SWLOSS:VCESAT ? :POWER:SWLOSS:VCEsat 2.0000 indicating that the VCEsat value is set to 2.0000. POWer:TYPe Sets or returns the power application measurement type. Conditions This command requires a DPO4PWR application module. Group Power Syntax...
Page 341
Commands Listed in Alphabetical Order oscilloscope. Many oscilloscope users do not have to worry about this because they use the same type of probe on all channels. Power measurement users, however, frequently use both a voltage probe and a current probe. A current probe typically has a larger delay than a voltage probe, so setting deskew values becomes important.
Page 342
Commands Listed in Alphabetical Order Syntax *PSC {OFF|ON|NR1>} *PSC? Related Commands DESE, *ESE, FACtory, *RST, *SRE Arguments sets the power-on status clear flag to false. sets the power-on status clear flag to true. = 0 sets the power-on status clear flag to false. This disables the power-on <NR1>...
Page 343
Commands Listed in Alphabetical Order *RCL (No Query Form) This command restores the state of the oscilloscope from a copy of the settings stored in memory (The settings are stored using the *SAV command). Group Save and Recall Syntax *RCL <NR1> Related Commands FACtory, *LRN?, RECAll:SETUp, *RST, *SAV, SAVe:SETUp...
Page 344
Commands Listed in Alphabetical Order Examples recalls (and makes current) the oscilloscope setup RECALL:SETUP FACTORY to its factory defaults. recalls the oscilloscope setup from setup storage location 2. RECALL:SETUP 2 recalls the setup from the file TEK00000.SET RECALL:SETUP "TEK00000.SET" in the current working directory. RECAll:WAVEform (No Query Form) This command (no query form) recalls a stored waveform to a reference location.
Page 345
Commands Listed in Alphabetical Order REF<x>:DATE? (Query Only) Returns the date that reference waveform data for channel <x> was copied into the internal reference memory, where x is the reference channel number. Group Vertical Syntax REF<x>:DATE? REF<x>:HORizontal:DELay:TIMe Sets or returns the horizontal delay time for reference waveform <x>, where x is the reference channel number.
Page 346
Commands Listed in Alphabetical Order REF<x>:LABel Sets or returns the reference waveform label for the channel specified by <x>, where x is the reference channel number. Group Vertical Syntax REF<x>:LABel <Qstring> REF<x>:LABel? Arguments is an alphanumeric string of text, enclosed in quotes, that contains <Qstring>...
Page 347
Commands Listed in Alphabetical Order Group Vertical Syntax REF<x>:VERTical:POSition <NR3> REF<x>:VERTical:POSition? Related Commands CH<x>:POSition, MATH[1]:VERTical:POSition Arguments is the desired position, in divisions from the center horizontal graticule. <NR3> The range is from -5.0 to 5.0 divisions. Examples positions the Reference 2 input signal REF2:VERTICAL:POSITION 1.3E+00 1.3 divisions above the center horizontal graticule.
Page 348
Commands Listed in Alphabetical Order Arguments is the gain in user units-per-division. <NR3> Examples sets the Reference 4 scale to 100 mV per REF4:VERTICAL:SCALE 100E-03 division. might return REF4:VERTICAL:SCALE? :REF2:VERTICAL:SCALE indicating that the current vertical scale setting for Reference 2 is 1.0000e+00 1 V per division.
Page 349
Commands Listed in Alphabetical Order Group Status and Error Syntax *RST Related Commands FACtory, RECAll:SETUp, SAVe:SETUp, *PSC, *RCL, *SAV Arguments None Examples resets the oscilloscope settings to factory defaults. *RST *SAV (No Query Form) Stores the state of the oscilloscope to a specified memory location. You can use the *RCL command to restore the oscilloscope to this saved state at a later time.
Page 350
Commands Listed in Alphabetical Order Arguments assigns the Save button to save screen images. IMAGe assigns the Save button to save waveforms. WAVEform assigns the Save button to save setups. SETUp SAVe:EVENTtable:BUS<x> (No Query Form) Saves the data from bus<x> to a specified file and location; where x is the bus number Group Save and Recall...
Page 351
Commands Listed in Alphabetical Order recommended. The path “D:/foo.png” will save an image to the file “foo.png” on the Compact Flash card. SAVe:IMAGe:FILEFormat Sets or returns the file format to use for saving screen images. NOTE. The file format is not automatically determined by the file name extension. You need to choose a file format with an extension which is consistent with the selected file format.
Page 352
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 353
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 354
Commands Listed in Alphabetical Order :SAVe:WAVEform:FILEFormat INTERNal; :SAVe:WAVEform ALL, saves all displayed waveforms (excluding serial "D:/test_folder/test1" bus waveforms and digital channels for MSO models) to individual files named (for example D:/test_folder/test1_<wfm>.isf test1_CH1.isf SAVe:WAVEform:FILEFormat Specifies or returns the file format for saved waveforms. Waveform header and timing information is included in the resulting file of non-internal formats.
Page 355
Commands Listed in Alphabetical Order 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. saves the entire waveform. NONe , if zoom is on, the gates are the start and end waveform record points of SCREEN the zoom (upper) graticule, otherwise the gates are the start and end waveform record points of the main graticule.
Page 357
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:STATE Sets the search state to on or off. <x> is the search number, which is always 1. The query form returns the search state. Group Search Syntax SEARCH:SEARCH<x>:STATE {<NR1>|OFF|ON} SEARCH:SEARCH<x>:STATE? Arguments = 0 sets the search state to off. <NR1>...
Page 358
Commands Listed in Alphabetical Order specifies the Serial Peripheral Interface bus. specifies the Controller Area Network 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:B3:SPI:CONDITION SS;:SEARCH:SEARCH1:TRIGGER:A:BUS:B4:SPI:CONDITION SS;:SEARCH:SEARCH1:TRIGGER:A:BUS:B1:SPI:DATA:MOSI:VALUE "XX" SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:CONDition Sets or returns the search trigger condition for the AUDIO bus: Start of Frame or Data.
Page 359
Commands Listed in Alphabetical Order Arguments specifies the search data trigger data upper word. <String> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:OFFSet Sets or returns the search trigger data offset for the AUDIO bus. Conditions This command requires DPO4AUDIO application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:OFFSet <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:OFFSet? Arguments is the search trigger data offset value.
Page 360
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:VALue Sets or returns the search trigger data lower word for the AUDIO bus. Conditions This command requires DPO4AUDIO application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:VALue <String> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:VALue? Arguments <String> is the search trigger data lower word. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:AUDio:DATa:WORD Sets or returns the search trigger data alignment for the AUDIO bus.
Page 361
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:CONDition {SOF|FRAMEtype|IDentifier|DATA|IDANDDATA|EOF|ACKMISS} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:CONDition? Arguments specifies a search based on the start of frame. specifies a search based on the frame type. FRAMEtype specifies a search based on the frame identifier. IDentifier specifies a search based on the frame data. DATA specifies a search based on the frame identifier and data.
Page 362
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:QUALifier Sets or returns the CAN data qualifier for a search. is the search SEARCH<x> number and is the bus number. This only applies if the trigger condition is B<x> IDANDDATA or DATA. Conditions This command requires a DPO4AUTO application module. Group Search Syntax...
Page 363
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:SIZe <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:SIZe? Arguments is the data string length in bytes. <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN:DATa:VALue Sets or returns the binary data string to be used for a CAN search if the search condition is ID or IDANDDATA. is the search number and SEARCH<x>...
Page 364
Commands Listed in Alphabetical Order specifies an error frame. ERRor specifies an overload frame. OVERLoad SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:CAN{:IDentifier|:ADDRess}:MODe Sets or returns the CAN addressing mode for a trigger search to a standard or extended format. is the search number and is the bus number. SEARCH<x>...
Page 365
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CONDition Sets or returns the trigger condition for FLEXRAY. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CONDition {SOF|FRAMETypeid|CYCLEcount|HEADer|DATA|IDANDDATA|EOF|ERROR} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CONDition? Arguments sets the FLEXRAY trigger condition to start of frame. sets the FLEXRAY trigger condition to a frame type id. FRAMETypeid sets the FLEXRAY trigger condition to cycle count.
Page 366
Commands Listed in Alphabetical Order Arguments is a quoted string that is the cycle count high value. <QString> Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:CYCLECOUNT:HIVALUE sets the cycle count high value to 110010. “110010” SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:CYCLECOUNT:HIVALUE? might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:CYCLECOUNT:HIVALUE indicating the cycle count high value is set to don’t cares. "XXXXXX"...
Page 367
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:VALue Sets or returns the binary data string to be used for FLEXRAY cycle count low value. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:VALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount: VALue? Arguments is a quoted string that is the binary cycle count value. <QString>...
Page 368
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:DATa:OFFSet Sets or returns the offset of the data string in bytes to be used for FLEXRAY trigger. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:DATa:OFFSet <NR1> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:DATa:OFFSet? Arguments is the FLEXRAY data offset in bytes. A byte offset of -1 signifies don’t <NR1>...
Page 369
Commands Listed in Alphabetical Order sets the FLEXRAY data qualifier to in range. INrange sets the FLEXRAY data qualifier to out of range. OUTrange Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:DATA:QUALIFIER sets the data qualifier to LESSTHAN. LESSTHAN might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:DATA:QUALIFIER? return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:DATA:QUALIFIER indicating the data qualifier is EQUAL. EQUAL SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:DATa:SIZe Sets or returns the length of the data string in bytes to be used for FLEXRAY...
Page 370
Commands Listed in Alphabetical Order Arguments is a quoted string that is the low binary data string to be used for <QString> FLEXRAY trigger condition if trigger condition is ID or IDANDDATA. Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:DATA:VALUE sets the binary data string to 11001010. “11001010”...
Page 371
Commands Listed in Alphabetical Order Arguments sets the FLEXRAY error type to CRC header. CRCHeader sets the FLEXRAY error type to CRC trailer. CRCTrailer sets the FLEXRAY error type to SYNC frame. SYNCFrame sets the FLEXRAY error type to start up with no sync. STARTupnosync sets the FLEXRAY error type to null frame static.
Page 372
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS: B<x>:FLEXray:FRAMEID:QUALifier {LESSThan|MOREThan|EQUal|UNEQual|LESSEQual|MOREEQual| INrange|OUTrange} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:FRAMEID: QUALifier? Arguments sets the frame id qualifier to LESSThan LESSThan sets the frame id qualifier to MOREThan MOREThan sets the frame id qualifier to QUal QUal sets the frame id qualifier to UNEQual UNEQual sets the frame id qualifier to LESSEQual LESSEQual...
Page 373
Commands Listed in Alphabetical Order Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:VALUE sets the value of the frame id is 11001101010. “11001101010” might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:VALUE? return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:VALUE indicating the value of the frame id is 10110010101. "10110010101" SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:FRAMEType Sets or returns the frame type for FLEXRAY. Group Search Syntax...
Page 374
Commands Listed in Alphabetical Order Arguments is a quoted string representing the CRC portion of the binary header <QString> string used for FLEXRAY trigger. Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CRC sets the CRC protion of the binary header string 00110010101. “00110010101” might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CRC? return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CRC indicating the CRC protion of the binary header string is don’t "XXXXXXXXXXX"...
Page 375
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:HEADER:FRAMEID <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:HEADER:FRAMEID? Arguments is a quoted string representing the frame id portion of the binary <QString> header string used for FLEXRAY trigger. Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:HEADER:FRAMEID sets the frame id portion of the binary header string to “10110010101”...
Page 376
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:HEADER:PAYLength <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:FLEXray:HEADER: PAYLength? Arguments is a quoted string representing the payload length portion of the <QString> binary header string used for FLEXRAY trigger. Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:FLEXRAY:HEADER:PAYLENGTH sets the payload length portion of the binary header string to 1001101. “1001101”...
Page 377
Commands Listed in Alphabetical Order Conditions This command requires a DPO4EMBD application module. 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.
Page 378
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 379
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 380
Commands Listed in Alphabetical Order SLEEP specifies to search on sleep. ERROR specifies to search on errors. 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. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:HIVALue Sets or returns the binary data string to be used for LIN searches if the search condition is ID or IDANDDATA.
Page 381
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 382
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:VALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:DATa:VALue? Arguments is the binary data string for the search. <QString> Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:DATA:VALUE? might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:DATA:VALUE "XXXXXXXX" indicating the data value is don’t care. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:ERRTYPE Sets or returns the error type used for a LIN Search. Group Search Syntax...
Page 383
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:LIN:IDentifier:VALue? Arguments is a quoted string specifying the binary address string to be used for <QString> LIN search if search condition is ID or IDANDDATA. Examples might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:IDENTIFIER:VALUE? return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:LIN:IDENTIFIER:VALUE indicating the binary address is undefined.
Page 384
Commands Listed in Alphabetical Order 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 base on the TX Start Bit. TXSTArt specifies a search based on TX Data.
Page 385
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:RS232C:TX:DATa:SIZe Sets or returns the length of the data string to be used for an RS-232 trigger search if the Trigger condition is TX. is the search number and is the SEARCH<x> B<x> bus number. Conditions This command requires a DPO4COMP application module.
Page 386
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:CONDition {SS|STARTofframe|MISO|MOSI|MISOMOSI} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:CONDition? Related Commands BUS:B<x>:SPI:IDLETime, BUS:B<x>:SPI:FRAMING Arguments specifies a search based on the Slave Selection condition. is applicable when is set to STARTofframe BUS:B<x>:SPI:FRAMING . When the trigger condition is set to , the instrument IDLEtime STARTofframe triggers on the first SPI clock after an idle time when there are no clocks.
Page 387
Commands Listed in Alphabetical Order Conditions This command requires a DPO4EMBD application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:DATa{:MOSI|:OUT}: VALue <bin> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:DATa{:MOSI|:OUT}: VALue? Arguments is the data in binary format. <bin> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:SPI:DATa:SIZe Sets or returns the length of the data string for an SPI trigger search if the search condition is MISO, MOSI, or MISOMOSI.
Page 388
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:ADDRess:HIVALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:ADDRess:HIVALue? Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition, SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:ADDRess:VALue Arguments within the range 0000000 to 1111111 (00 hex to 7F hex). <QString> Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ADDRESS:HIVALUE sets the upper limit to binary 0001000 (08 hex). “0001000” might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ADDRESS:HIVALUE? return :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ADDRESS:HIVALUE , which indicates that the upper limit is 1111111 (7F hex).
Page 389
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition Sets or returns the trigger condition for the USB search. Conditions This command requires the DPO4USB application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition {SYNC|RESET|SUSPEND|RESUME|EOP|TOKENPacket|DATAPacket |HANDSHAKEPacket|SPECIALPacket|ERRor} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition? Arguments indicates triggering on a Sync field of a packet. SYNC sets triggering on a reset condition.
Page 390
Commands Listed in Alphabetical Order Conditions This command requires the DPO4USB application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:DATa:HIVALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:DATa:HIVALue? Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition, SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:DATa:VALue Arguments within the range 00000000 to 11111111 (00 hex to FF hex). <QString> Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:HIVALUE “00001000” sets the upper limit to binary 00001000 (08 hex). might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:HIVALUE? :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:HIVALUE “01111111”...
Page 391
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:DATa:SIZe Sets or returns the number of contiguous data bytes to trigger the search on. The minimum and default values are 1 and the maximum value is 16. Conditions This command requires the DPO4USB application module. Group Search Syntax...
Page 392
Commands Listed in Alphabetical Order Examples sets the SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:TYPE DATA0 oscilloscope to trigger on a DATA0 data packet type. might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:TYPE? , indicating :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:DATA:TYPE DATA1 that the data packet type is set to DATA1. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:DATa:VALue Sets or returns the binary data string to be used for the USB search trigger when the search trigger condition is DATAPacket.
Page 393
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:ENDPoint:VALue <QString> SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:ENDPoint:VALue? Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition Arguments within the range 0000 to 1111 (00 hex to 0F hex). <QString> Examples sets SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ENDPOINT:VALUE “1000” the binary address to 1000 (08 hex). might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ENDPOINT:VALUE? :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:ENDPOINT:VALUE “1001” which indicates that the binary address is 1001 (09 hex).
Page 394
Commands Listed in Alphabetical Order might return SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:CONDITION? , indicating :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:CONDITION PID the error trigger condition is packet ID. SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:HANDSHAKEType Sets or returns the handshake type for the USB search trigger. Conditions This command requires the DPO4USB application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:HANDSHAKEType...
Page 395
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:QUALifier {LESSThan|MOREThan|EQUal|UNEQual|LESSEQual |MOREEQual|INrange|OUTrange} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:QUALifier? Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition Arguments triggers the search on an value that is less than a set value. LESSThan triggers the search on an value that is greater than a set value. MOREThan triggers the search on an value that is to a set value.
Page 396
Commands Listed in Alphabetical Order Related Commands SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:CONDition Arguments within the range 000 0000 0000 to 111 1111 1111 (000 hex to 7FF <QString> hex). Examples SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:SOFFRAMENUMBER sets the start of frame number to 00000001000 (008 hex). “00000001000” might SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:SOFFRAMENUMBER? return :SEARCH:SEARCH1:TRIGGER:A:BUS:B1:USB:SOFFRAMENUMBER , which indicates that the start of frame number is 00000001001...
Page 397
Commands Listed in Alphabetical Order Conditions This command requires the DPO4USB application module. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:TOKENType {ANY|SOF|OUT|IN|SETUP} SEARCH:SEARCH<x>:TRIGger:A:BUS:B<x>:USB:TOKENType? Arguments indicates any of the token types. indicates a SOF (start-of-frame) token type indicates an OUT token type. indicates an IN token type. indicates a SETUP token type.
Page 398
Commands Listed in Alphabetical Order 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 SEARCH:SEARCH<x>:TRIGger:A:EDGE:SLOpe {RISe|FALL} SEARCH:SEARCH<x>:TRIGger:A:EDGE:SLOpe? Arguments specifies a rising edge. RISe specifies a falling edge.
Page 399
Commands Listed in Alphabetical Order Arguments specifies the trigger level, in volts. <NR3> specifies a preset TTL high level of 1.4V. SEARCH:SEARCH<x>:TRIGger:A:LEVel:CH<x> Sets or returns the level for an edge trigger search to determine where to place a mark. is the search number and is the channel number.
Page 400
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LEVel:REF<x> {TTL} SEARCH:SEARCH<x>:TRIGger:A:LEVel:REF<x>? Arguments specifies a preset TTL high level of 1.4 V. SEARCH:SEARCH<x>:TRIGger:A:LOGIc:FUNCtion Sets or returns the logic operator for a logic trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax...
Page 401
Commands Listed in Alphabetical Order 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. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:CLOCk:EDGE {FALL|RISe} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:CLOCk:EDGE? Arguments specifies a rising edge.
Page 402
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:INPut:D<x> {HIGH|LOW|X} SEARCH:SEARCH<x>:TRIGger:A:LOGIc: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:INPut:MATH Sets or returns the Boolean logic criteria for a logic trigger search to determine where to place a mark.
Page 403
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:CH<x> Sets or returns the logic criteria for a logic pattern trigger search to determine where to place a mark. is the search number and is the SEARCH<x> CH<x> channel number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:CH<x> {HIGH|LOW|X} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:CH<x>? Arguments...
Page 404
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:MATH {HIGH|LOW|X} SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:INPut:MATH? 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:REF<x> Sets or returns the Boolean logic criteria for a pattern trigger search to determine where to place a mark.
Page 405
Commands Listed in Alphabetical Order places a mark if the specific pattern is true less than the time set by LESSThan SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn:LESSLimit command. places a mark if the specific pattern is true longer than the specified time set Than by the SEARCH:SEARCH<x>:TRIGger:A:LOGIc:PATtern:WHEn:MORELimit command.
Page 406
Commands Listed in Alphabetical Order Arguments specifies the minimum amount of time to hold the pattern true. <NR3> SEARCH:SEARCH<x>:TRIGger:A:LOGIc:THReshold:CH<x> Sets or returns the channel threshold level for a logic trigger search to determine where to place a mark. is the search number and is the SEARCH<x>...
Page 407
Commands Listed in Alphabetical Order Arguments specifies a preset TTL high level of 1.4 V. SEARCH:SEARCH<x>:TRIGger:A:LOWerthreshold:CH<x> Sets or returns the channel waveform lower threshold to determine where to place a mark. This setting is applied to all channel searches that use a lower threshold. is the search number and is the channel number.
Page 408
Commands Listed in Alphabetical Order Syntax SEARCH:SEARCH<x>:TRIGger:A:LOWerthreshold:REF<x> {TTL} SEARCH:SEARCH<x>:TRIGger:A:LOWerthreshold:REF<x>? Arguments specifies a preset TTL high level of 1.4 V. SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:POLarity Sets or returns the polarity for a pulse trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax...
Page 409
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WHEn {LESSthan|than|EQual|UNEQual} SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WHEn? Arguments places a mark if the pulse width is less than the time set by the LESSThan SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WIDth command. places a mark if the pulse width is true longer than the specified time set by Than SEARCH:SEARCH<x>:TRIGger:A:PULSEWidth:WIDth command.
Page 410
Commands Listed in Alphabetical Order Arguments places a mark when the rising edge crosses the low threshold and POSitive the falling edge re-crosses the low threshold without either edge ever crossing the high threshold. places a mark when the falling edge crosses the high threshold and NEGative the rising edge re-crosses the high threshold without either edge ever crossing the low threshold.
Page 411
Commands Listed in Alphabetical Order argument sets the oscilloscope to trigger if the a runt pulse is detected with than width than the time set by the SEARCH:SEARCH<x>:TRIGger:A:RUNT:WIDth command. argument sets the oscilloscope to trigger when the pattern is true for a time EQUal period equal to the time period specified in SEARCH:SEARCH<x>:TRIGger:A:...
Page 412
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:SETHold:CLOCk:SOUrce Sets or returns the clock source setting for an setup/hold trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:SETHold:CLOCk:SOUrce {CH1|CH2|CH3|CH4|MATH|REF} SEARCH:SEARCH<x>:TRIGger:A:SETHold:CLOCk:SOUrce? Related Commands SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa:SOUrce Arguments specifies an input channel as the edge source.
Page 413
Commands Listed in Alphabetical Order Group Search Syntax DPO Models: SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa:SOUrce {CH1|CH2|CH3|CH4|MATH|REF} MSO Models: SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa:SOUrce <wfm>[,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] [,<wfm>] SEARCH:SEARCH<x>:TRIGger:A:SETHold:DATa:SOUrce? Related Commands SEARCH:SEARCH<x>:TRIGger:A:SETHold:CLOCk:SOUrce Arguments DPO Models: specifies an input channel as the search source. CH1–CH4 specifies the math waveform as the search source.
Page 414
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A:SETHold:HOLDTime Sets or returns the hold time setting for an setup/hold trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:SETHold:HOLDTime <NR3> SEARCH:SEARCH<x>:TRIGger:A:SETHold:HOLDTime? Arguments specifies the hold time setting in seconds. Positive values for hold time <NR3>...
Page 415
Commands Listed in Alphabetical Order Arguments is the lower threshold in volts. <NR3> SEARCH:SEARCH<x>:TRIGger:A:SETHold:THReshold{:MATH|:MATH1} Sets or returns the trigger search setup and hold threshold for the math waveform. This helps to determine where to place search marks. Search<x> is the search number, which is always 1.
Page 416
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:DELTatime <NR3> SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:DELTatime? Arguments specifies the transition time, in seconds. <NR3> SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:POLarity Sets or returns the polarity setting for an transition trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax...
Page 417
Commands Listed in Alphabetical Order SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:WHEn Sets or returns the condition setting for an transition trigger search to determine where to place a mark. <x> is the search number. Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:WHEn {SLOWer|FASTer|EQual|UNEQual} SEARCH:SEARCH<x>:TRIGger:A{:TRANsition|:RISEFall}:WHEn? Arguments sets the trigger to occur when the transitioning signal is faster than the set FASTer volts/second rate.
Page 418
Commands Listed in Alphabetical Order The polarity is selected using the SEARCH:SEARCH<x>:TRIGger:A:RUNT: POLarity command. triggers when a pulse crosses both thresholds in the same direction TRANsition as the specified polarity and the transition time between the two threshold crossings is greater or less than the specified time delta. SEARCH:SEARCH<x>:TRIGger:A:UPPerthreshold:CH<x>...
Page 419
Commands Listed in Alphabetical Order Group Search Syntax SEARCH:SEARCH<x>:TRIGger:A:UPPerthreshold:REF<x> {TTL} SEARCH:SEARCH<x>:TRIGger:A:UPPerthreshold:REF<x>? Arguments specifies a preset high level of 1.4 V. SELect Sets or returns the selected waveform display (controlled by the front-panel) on or off. Group Vertical Syntax SELect {ON|OFF} Arguments turns the selected waveform display on.
Page 420
Commands Listed in Alphabetical Order SELect:CH<x> Turns the display of the channel <x> waveform on or off, where <x > is the channel number. This command also resets the acquisition. The query returns whether the channel is on or off but does not indicate whether it is the selected waveform.
Page 421
Commands Listed in Alphabetical Order specifies a bus waveform as the waveform affected by the front-panel BUS<x> controls. <x> specifies the bus number. Returns if all the channels are turned off. is ignored on input. NONE NONE Examples resets acquisition displays on channel 2, and causes the SELECT:CONTROL CH2 selected waveform to be the implied object of waveform commands.
Page 422
Commands Listed in Alphabetical Order Group Vertical Syntax SELect:MATH[1] {ON|OFF|<NR1>} SELect:MATH[1]? 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 423
Commands Listed in Alphabetical Order SET? (Query Only) Returns the commands that list the oscilloscope settings except for configuration information for the calibration values, the WFMInpre? query, and the WFMOutpre? query. This query allows you to record or "learn" the current oscilloscope settings.
Page 424
Commands Listed in Alphabetical Order SETUP<x>:DATE? (Query Only) Returns the date when the oscilloscope setup was saved for the specified channel <x>. Group Save and Recall Syntax SETUP<x>:DATE? Examples might return which is the setup SETUP4:DATE? SETUP4:DATE: 04–18–06 date for channel 4. SETUP<x>:LABEL Sets or returns the setup label for the specified channel <x>, where x can be 1 through 10.
Page 425
Commands Listed in Alphabetical Order Examples might return which is the setup SETUP2:TIME? “SETUP2:TIME: 15:24:07 time for channel 2. *SRE The *SRE (Service Request Enable) command sets or returns the bits in the Service Request Enable Register. For information, refer to Registers. Group Status and Error Syntax...
Page 426
Commands Listed in Alphabetical Order Examples might return 96, showing that the SBR contains the binary value 01100000. *STB? TEKSecure (No Query Form) This command initializes both waveform and setup memories, overwriting any previously stored data. These are the WFMInpre?, WFMOutpre?, and DATa command values after the operation.
Page 427
Commands Listed in Alphabetical Order # Bit 5 of the SRE (Service Request Enable Register) enables # the generation of SRQ when the ESB bit of the SBR becomes # TRUE *SRE 32 TEKSECURE;*OPC When the operation has completed, the OPC bit of the SESR will be TEKSECURE TRUE and SRQ will have been generated.
Page 428
Commands Listed in Alphabetical Order *TRG (No Query Form) Performs a group execute trigger on commands defined by *DDT. Group Miscellaneous Syntax *TRG Related Commands *DDT Examples immediately executes all commands that have been defined by *DDT. *TRG TRIGger (No Query Form) Forces a trigger event to occur.
Page 429
Commands Listed in Alphabetical Order Syntax TRIGger:A SETLevel TRIGger:A? Related Commands TRIGger:A:EDGE?, TRIGger:A:LOGIc?, TRIGger:A:PULse? Arguments sets the A trigger level to 50% of the range of the minimum and SETLevel maximum values of the trigger input signal. Examples sets the A trigger level to 50% of the range of the TRIGGER:A SETLEVEL minimum and maximum values of the trigger input signal.
Page 430
Controller Area Network bus. specifies the Parallel bus. PARallel NOTE. Parallel bus commands work with MSO4000 Series oscilloscopes only. TRIGger:A:BUS:B<x>:AUDio:CONDition Sets or returns the trigger condition for the AUDIO bus: Start of Frame or Data. Conditions This command requires DPO4AUDIO application module.
Page 431
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:AUDio:DATa:HIVALue Sets or returns the trigger data upper word for the AUDIO bus. Conditions This command requires DPO4AUDIO application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:AUDio:DATa:HIVALue <String> TRIGger:A:BUS:B<x>:AUDio:DATa:HIVALue? TRIGger:A:BUS:B<x>:AUDio:DATa:OFFSet Sets or returns the trigger data offset for the AUDIO bus. Conditions This command requires DPO4AUDIO application module.
Page 432
Commands Listed in Alphabetical Order Arguments sets the Audio data qualifier to less than. LESSThan sets the Audio data qualifier to greater than. MOREThan sets the Audio data qualifier to equal. EQUal sets the Audio data qualifier to not equal. UNEQual sets the Audio data qualifier to less than or equal.
Page 433
Commands Listed in Alphabetical Order aligns the trigger data to the right. RIGht 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 DPO4AUTO application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:CAN:CONDition {SOF|FRAMEtype|IDentifier|DATA|IDANDDATA|EOF|ACKMISS} TRIGger:A:BUS:B<x>:CAN:CONDition? Arguments...
Page 434
Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:CAN:DATa:DIRection {READ|WRITE|NOCARE} TRIGger:A:BUS:B<x>:CAN:DATa:DIRection? Arguments sets the CAN data direction to READ. READ sets the CAN data direction to WRITE. WRITE sets the CAN data direction to either. NOCARE Examples sets the CAN data TRIGGER:A:BUS:B1:CAN:DATA:DIRECTION WRITE direction to Write.
Page 435
Commands Listed in Alphabetical Order might return TRIGGER:A:BUS:B1:CAN:DATA:QUALIFIER? , indicating that the :TRIGGER:A:BUS:B1:CAN:DATA:QUALIFIER THAN oscilloscope is set to trigger when the data is than the qualifier value. TRIGger:A:BUS:B<x>:CAN:DATa:SIZe Sets or returns the length of the data string in bytes for a CAN trigger if the condition is DATA or IDANDDATA.
Page 436
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:CAN:FRAMEtype Sets or returns the frame type for a CAN FRAMEType trigger. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4AUTO application module. This command is only valid when the TRIGger:A:BUS:B<x>:CAN:CONDition is FRAMETYPE.
Page 437
Commands Listed in Alphabetical Order 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. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4AUTO application module.
Page 438
Commands Listed in Alphabetical Order sets the FLEXRAY trigger condition to data. DATA sets the FLEXRAY trigger condition to id and data. IDANDDATA sets the FLEXRAY trigger condition to end of frame. sets the FLEXRAY trigger condition to error. ERROR Examples might return TRIGGER:A:BUS:B1:FLEXRAY:CONDITION?
Page 439
Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:QUALifier {LESSThan|MOREThan|EQUal|UNEQual|LESSEQual|MOREEQual| INrange|OUTrange} TRIGger:A:BUS:B<x>:FLEXray:CYCLEcount:QUALifier? Arguments sets the FLEXRAY cycle count qualifier to less than. LESSThan sets the FLEXRAY cycle count qualifier to more than. MOREThan sets the FLEXRAY cycle count qualifier to equal. EQUal sets the FLEXRAY cycle count qualifier to not equal.
Page 440
Commands Listed in Alphabetical Order might return TRIGGER:A:BUS:B1:FLEXRAY:CYCLECOUNT:VALUE? indicating the TRIGGER:A:BUS:B1:FLEXRAY:CYCLECOUNT:VALUE "XXXXXX" cycle count value is don’t care. TRIGger:A:BUS:B<x>:FLEXray:DATa:HIVALue Sets or returns the high binary data string to be used for FLEXRAY trigger if trigger condition is ID or IDANDDATA. Group Trigger Syntax...
Page 441
Commands Listed in Alphabetical Order Examples might return TRIGGER:A:BUS:B1:FLEXRAY:DATA:OFFSET? indicating that a data offset TRIGGER:A:BUS:B1:FLEXRAY:DATA:OFFSET 0 of 0. might return TRIGGER:A:BUS:B1:FLEXRAY:DATA:OFFSET? indicating that a data offset TRIGGER:A:BUS:B1:FLEXRAY:DATA:OFFSET 0 of 0. TRIGger:A:BUS:B<x>:FLEXray:DATa:QUALifier Sets or returns the FLEXRAY data qualifier. Group Trigger Syntax TRIGger:A:BUS:B<x>:FLEXray:DATa:QUALifier {LESSThan|MOREThan|EQUal|UNEQual|LESSEQual|MOREEQual|...
Page 442
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:FLEXray:DATa:SIZe <NR1> TRIGger:A:BUS:B<x>:FLEXray:DATa:SIZe? Arguments is the FLEXRAY data string length in bytes. <NR1> Examples sets the data string size to 8 TRIGGER:A:BUS:B1:FLEXRAY:DATA:SIZE 8 bytes. might return TRIGGER:A:BUS:B1:FLEXRAY:DATA:SIZE? indicating the data TRIGGER:A:BUS:B1:FLEXRAY:DATA:SIZE 1 size is 1 byte.
Page 443
Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:FLEXray:EOFTYPE {STATic|DYNAMic|ANY} TRIGger:A:BUS:B<x>:FLEXray:EOFTYPE? Arguments STATic specifies triggering on the STATIC end of file type. DYNAMic specifies triggering on the DYNAMIC end of file type. ANY specifies triggering on a STATIC or DYNAMIC end of file type. Examples sets the FLEXRAY end of file TRIGGER:A:BUS:B1:FLEXRAY:EOFTYPE ANY...
Page 444
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:HIVALue Sets or returns the binary data string to be used for FLEXRAY frame ID high value. Group Trigger Syntax TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:HIVALue <QString> TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:HIVALue? Arguments is a quoted string that is the binary frame id high value. <QString>...
Page 445
Commands Listed in Alphabetical Order Examples sets the TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:QUALIFIER LESSTHAN frame id qualifier to less than. might return TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:QUALIFIER? indicating the TRIGGER:A:BUS:B1:FLEXRAY:FRAMEID:QUALIFIER EQUAL frame id qualifier is set to equal. TRIGger:A:BUS:B<x>:FLEXray:FRAMEID:VALue Sets or returns the binary data string to be used for FLEXRAY frame ID low value. Group Trigger Syntax...
Page 446
Commands Listed in Alphabetical Order specifies the startup frame type. STARTup Examples sets the frame type to TRIGGER:A:BUS:B1:FLEXRAY:FRAMETYPE PAYLOAD payload. might return TRIGGER:A:BUS:B1:FLEXRAY:FRAMETYPE? indicating the TRIGGER:A:BUS:B1:FLEXRAY:FRAMETYPE NORMAL frame type is set to normal. TRIGger:A:BUS:B<x>:FLEXray:HEADER:CRC Sets or returns the CRC portion of the binary header string to be used for FLEXRAY trigger.
Page 447
Commands Listed in Alphabetical Order Examples sets the TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CYCLECOUNT “110010” cycle count to 110010. might return TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CYCLECOUNT? indicating TRIGGER:A:BUS:B1:FLEXRAY:HEADER:CYCLECOUNT "XXXXXX" the cycle count is don’t care. TRIGger:A:BUS:B<x>:FLEXray:HEADER:FRAMEID Sets or returns the frame id portion of the binary header string to be used for FLEXRAY trigger.
Page 448
Commands Listed in Alphabetical Order Examples sets the indicator TRIGGER:A:BUS:B1:FLEXRAY:HEADER:INDBITS “11001 bits portion of the header string to 11001. might return TRIGGER:A:BUS:B1:FLEXRAY:HEADER:INDBITS? indicating that TRIGGER:A:BUS:B1:FLEXRAY:HEADER:INDBITS "XXXXX" the indicator bits portion of the header string are don’t cares. TRIGger:A:BUS:B<x>:FLEXray:HEADER:PAYLength Sets or returns the payload length portion of the binary header string to be used for FLEXRAY trigger.
Page 449
Commands Listed in Alphabetical Order 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. The only supported address type is USER. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4EMBD application module.
Page 450
Commands Listed in Alphabetical Order Examples sets the I C address value TRIGGER:A:BUS:B1:I2C:ADDRESS:VALUE 1011 to XXX1011. TRIGger:A:BUS:B<x>:I2C:CONDition Sets or returns the trigger condition for an I C trigger. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4EMBD application module. Group Trigger Syntax...
Page 451
Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:I2C:DATa:DIRection {READ|WRITE|NOCARE} TRIGger:A:BUS:B<x>:I2C:DATa:DIRection? Arguments specifies read as the data direction. READ specifies write as the data direction. WRITE specifies either as the data direction. NOCARE Examples specifies write as the TRIGGER:A:BUS:B1:I2C:DATA:DIRECTION WRITE C data direction. TRIGger:A:BUS:B<x>:I2C:DATa:SIZe Sets or returns the length of the data string in bytes to be used for an I2C trigger if the trigger condition is DATA or ADDRANDDATA.
Page 452
Commands Listed in Alphabetical Order Arguments is the binary data string, where the number of bits is 8 times the <QString> number of bytes specified. The only allowed characters in the string are 0, 1, and X. TRIGger:A:BUS:B<x>:LIN:CONDition Sets or returns the trigger condition for LIN. Group Trigger Syntax...
Page 453
Commands Listed in Alphabetical Order Arguments is a quoted string that is the binary data string used for LIN trigger if <QString> the trigger condition is ID or IDANDDATA. Examples sets the high value TRIGGER:A:BUS:B1:LIN:DATA:HIVALUE "11001010" 11001010 might return TRIGGER:A:BUS:B1:LIN:DATA:HIVALUE? indicating TRIGGER:A:BUS:B1:LIN:DATA:HIVALUE "XXXXXXXX"...
Page 454
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:LIN:DATa:SIZe Sets or returns the length of the data string in bytes to be used for LIN trigger. Group Trigger Syntax TRIGger:A:BUS:B<x>:LIN:DATa:SIZe <NR1> TRIGger:A:BUS:B<x>:LIN:DATa:SIZe? Arguments is the size of the data string in bytes. <NR1> Examples sets the data size to 8 bytes.
Page 455
Commands Listed in Alphabetical Order Syntax TRIGger:A:BUS:B<x>:LIN:ERRTYPE {SYNC|PARity|CHecksum|HEADertime|RESPtime|FRAMetime} TRIGger:A:BUS:B<x>:LIN:ERRTYPE? Arguments sets the LIN error type to SYNC. SYNC sets the LIN error type to parity. PARity sets the LIN error type to checksum. CHecksum sets the LIN error type to header time. HEADertime sets the LIN error type to response time.
Page 456
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:PARallel:VALue Sets or returns the binary data string to be used for a Parallel trigger. Applies to bus <x>, where x is the bus number. Group Trigger Syntax TRIGger:A:BUS:B<x>:PARallel:VALue <QString> TRIGger:A:BUS:B<x>:PARallel:VALue? Arguments is the binary data string. <QString>...
Page 457
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:RS232C:RX:DATa:SIZe <NR1> TRIGger:A:BUS:B<x>:RS232C:RX:DATa:SIZe? Arguments is the length of the data string in bytes. <NR1> TRIGger:A:BUS:B<x>:RS232C:RX:DATa:VALue Sets or returns the binary data string for an RS-232 trigger if the trigger condition involves RX. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module.
Page 458
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:RS232C:TX:DATa:VALue Sets or returns the binary data string for an RS-232 trigger if the condition involves TX. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4COMP application module. Group Trigger Syntax...
Page 459
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:SPI:DATa{:IN|:MISO}:VALue Sets or returns the binary data string to be used for a SPI trigger if the trigger condition is MISO or MISOMOSI. Applies to bus <x>, where x is the bus number. Conditions This command requires a DPO4EMBD application module. Group Trigger Syntax...
Page 460
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:SPI:DATa:SIZe <NR1> TRIGger:A:BUS:B<x>:SPI:DATa:SIZe? Arguments is the length of the data string in bytes. <NR1> TRIGger:A:BUS:B<x>:USB:ADDRess:HIVALue Sets or returns the binary address string for the upper limit for inside-of-range and outside-of-range qualifiers for the USB trigger. Use the command TRIGger:A:BUS:B<x>:USB:ADDRess:VALue to set the lower limit.
Page 461
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:USB:ADDRess:VALue <Qstring> TRIGger:A:BUS:B<x>:USB:ADDRess:VALue? Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments within the range 0000000 to 1111111 (00 hex to 7F hex). <QString> Examples sets the binary TRIGGER:A:BUS:B1:USB:ADDRESS:VALUE “0001000” address to 0001000 (08 hex). might return TRIGGER:A:BUS:B1:USB:ADDRESS:VALUE? , which :TRIGGER:A:BUS:B1:USB:ADDRESS:VALUE “1000000”...
Page 462
Commands Listed in Alphabetical Order indicates triggering on a special status packet. SPECIALPacket indicates triggering on an error condition. ERRor Examples sets the trigger condition TRIGGER:A:BUS:B1:USB:CONDITION TOKENPACKET to be a token packet. might return TRIGGER:A:BUS:B1:USB:CONDITION? , which indicates that the trigger :TRIGGER:A:BUS:B1:USB:CONDITION SYNC condition is a sync field.
Page 463
Commands Listed in Alphabetical Order Conditions This command requires the DPO4USB application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:USB:DATa:OFFSet <NR1> TRIGger:A:BUS:B<x>:USB:DATa:OFFSet? Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments <NR1> is number in the range 0 to 1024. Examples sets the data offset to 36. TRIGGER:A:BUS:B1:USB:DATA:OFFSET 36 might return TRIGGER:A:BUS:B1:USB:DATA:OFFSET? , indicating that the...
Page 464
Commands Listed in Alphabetical Order TRIGger:A:BUS:B<x>:USB:DATa:TYPe Sets or returns the data type for when the trigger condition is set to DATAPacket. Conditions This command requires the DPO4USB application module. Group Trigger Syntax TRIGger:A:BUS:B<x>:USB:DATa:TYPe {ANY|DATA0|DATA1} TRIGger:A:BUS:B<x>:USB:DATa:TYPe? Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments indicates either a DATA0 or DATA1 data packet type. indicates a DATA0 data packet type.
Page 465
Commands Listed in Alphabetical Order Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments within the range 00000000 to 11111111 (00 hex to FF hex). <QString> Examples sets the binary address TRIGGER:A:BUS:B1:USB:DATA:VALUE “00001000” to 00001000 (08 hex). might return TRIGGER:A:BUS:B1:USB:DATA:VALUE? , which :TRIGGER:A:BUS:B1:USB:DATA:VALUE “01000000” indicates that the binary address is 0100000 (40 hex). TRIGger:A:BUS:B<x>:USB:ENDPoint:VALue Sets or returns the binary endpoint string to be used for the USB trigger.
Page 466
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:BUS:B<x>:USB:ERRORTYPe {PID|CRC5|CRC16|BITSTUFFing} TRIGger:A:BUS:B<x>:USB:ERRORTYPe? Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments indicates the error type is set to packet ID. indicates the error type is set to 5-bit CRC. CRC5 indicates the error type is set to 16-bit CRC. CRC16 indicates the error type is set to bit stuffing.
Page 467
Commands Listed in Alphabetical Order indicates the oscilloscope will trigger when a device requires intervention STALL from the host. Examples sets the handshake type to TRIGGER:A:BUS:B1:USB:HANDSHAKETYPE ACK acknowledgement. might return TRIGGER:A:BUS:B1:USB:HANDSHAKETYPE? , indicating that :TRIGGER:A:BUS:B1:USB:HANDSHAKETYPE STALL the handshake type is set to stall. TRIGger:A:BUS:B<x>:USB:QUALifier Sets or returns the USB trigger qualifier for address, endpoint and data.
Page 468
Commands Listed in Alphabetical Order might return TRIGGER:A:BUS:B1:USB:QUALIFIER? indicating that the trigger :TRIGGER:A:BUS:B1:USB:QUALIFIER EQUAL condition is to trigger when an address, data, or endpoint is equal to a set value. TRIGger:A:BUS:B<x>:USB:SOFFRAMENUMber Sets or returns the binary data string to be used for start of frame number, when the trigger condition is Token Packet and the token type is Start of Frame.
Page 469
Commands Listed in Alphabetical Order Related Commands TRIGger:A:BUS:B<x>:USB:CONDition Arguments indicates any type of special packet. indicates a preamble special packet. PREamble indicates a reserved special packet. RESERVed Examples sets the special packet type TRIGGER:A:BUS1:USB:SPECIALTYPE PREAMBLE to preamble. might return TRIGGER:A:BUS1:USB:SPECIALTYPE? , indicating that the special :TRIGGER:A:BUS1:USB:SPECIALTYPE PREAMBLE type is set to preamble.
Page 470
Commands Listed in Alphabetical Order TRIGger:A:BUS:SOUrce Sets or returns the source for a Serial bus trigger. Conditions This command requires a DPO4AUTO or DPO4EMBD application module. Group Trigger Syntax TRIGger:A:BUS:SOUrce {B1|B2|B3|B4} TRIGger:A:BUS:SOUrce? Arguments specifies the Bus 1 source. specifies the Bus 2 source. specifies the Bus 3 source.
Page 471
Commands Listed in Alphabetical Order Syntax TRIGger:A:EDGE:COUPling {DC|HFRej|LFRej|NOISErej} TRIGger:A:EDGE:COUPling? Related Commands TRIGger:A:EDGE:SOUrce, TRIGger:A:EDGE:SLOpe Arguments specifies DC trigger coupling, which passes all input signals to the trigger circuitry. specifies high-frequency rejection coupling, which attenuates signals HFRej above 50 kHz before passing the signals to the trigger circuitry. specifies low-frequency rejection coupling, which attenuates signals below LFRej 50 kHz before passing the signals to the trigger circuitry.
Page 472
Commands Listed in Alphabetical Order TRIGger:A:EDGE:SOUrce Sets or returns the source for the A edge trigger. Group Trigger Syntax TRIGger:A:EDGE:SOUrce {CH1|CH2|CH3|CH4| D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|D12|D13|D14|D15| EXT|LINE|AUX} TRIGger:A:EDGE:SOUrce? 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 channel as the source (MSO models only).
Page 473
Commands Listed in Alphabetical Order Examples might return TRIGGER:A:HOLDOFF? :TRIGGER:A:HOLDOFF:TIME indicating that the A edge trigger holdoff time 900.0000E-09;BY DEFAULT (by default) is 900 ns. TRIGger:A:HOLDoff:TIMe Sets or returns the A trigger holdoff time. Group Trigger Syntax TRIGger:A:HOLDoff:TIMe <NR3> TRIGger:A:HOLDoff:TIMe? Arguments specifies the holdoff time in seconds.
Page 474
Commands Listed in Alphabetical Order TRIGger:A:LEVel:AUXin Sets or returns the trigger level for the AUXIN port. Group Trigger Syntax TRIGger:A:LEVel:AUXin {<NR3>|ECL|TTL} TRIGger:A:LEVel:AUXin? Arguments specifies the trigger level, in volts. <NR3> specifies a preset ECL trigger level of –1.3V. specifies a preset TTL trigger level of 1.4V. Examples sets the auxiliary input trigger level to -1.3 TRIGGER:A:LEVEL:AUXIN ECL...
Page 475
Commands Listed in Alphabetical Order TRIGger:A:LEVel:D<x> Sets or returns the trigger level for the specified digital channel <x>, where x is the channel number. Each digital channel can have an independent level. Group Trigger Syntax TRIGger:A:LEVel:D<x> {<NR3>|ECL|TTL} TRIGger:A:LEVel:D<x>? Arguments specifies a preset ECL high level of –1.3V. specifies a preset TTL high level of 1.4V.
Page 476
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:LOGIc:CLAss {LOGIC|SETHold} TRIGger:A:LOGIc:CLAss? Related Commands TRIGger:A:TYPe, TRIGger:A:PULse:CLAss Arguments sets the oscilloscope to trigger on logical combinations of the channels. LOGIC When the TRIGger:A:LOGIc:INPut:CLOCk:SOUrce is NONE, sets the LOGIC oscilloscope to trigger when the specified logical combinations of channels 1, 2, 3, and 4 are met on four-channel oscilloscopes.
Page 477
Commands Listed in Alphabetical Order Arguments specifies to trigger if all conditions are true. specifies to trigger if any of the conditions is false. NANd specifies to trigger if all conditions are false. specifies to trigger if any of the conditions is true. Examples might return TRIGGER:A:LOGIC:FUNCTION?
Page 478
Commands Listed in Alphabetical Order specifies a "don’t care" state. Examples might return TRIGGER:A:LOGIC:INPUT:CH1? :TRIGGER:LOGIC:INPUT:CH1 indicating that the setting for the A logic trigger input to channel 1 does not matter. sets the A logic trigger input to logic TRIGGER:A:LOGIC:INPUT:CH2 HIGH HIGH for channel 2.
Page 479
Commands Listed in Alphabetical Order 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. Group Trigger Syntax TRIGger:A:LOGIc:INPut:D<x> {HIGH|LOW|X} TRIGger:A:LOGIc:INPut:D<x>? Arguments specifies the logic high state. High specifies the logic low state. specifies a "don’t care"...
Page 480
Commands Listed in Alphabetical Order Syntax TRIGger:A:LOGIc:PATtern:DELTatime <NR3> TRIGger:A:LOGIc:PATtern:DELTatime? Arguments is a floating point value with exponent that sets the pattern trigger time <NR3> value. This argument has a range of 39.6E–9 (39.6 ns) to 10.0E0 (10 s), in increments of 13.2 ns. Values that are not an increment of 13.2 ns are rounded to the nearest correct value.
Page 481
Commands Listed in Alphabetical Order triggers the oscilloscope when the input pattern is true for a time period LESSTHAN less than the time period specified in TRIGGER:A:LOGIC:PATTERN:DELTATIME triggers the oscilloscope when the input pattern is true MORETHAN for a time period more (greater) than the time period specified in TRIGGER:A:LOGIC:PATTERN:DELTATIME triggers the oscilloscope when the input pattern is true for a time period EQUAL...
Page 482
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:LOGIc:PATtern:WHEn:MORELimit <NR3> TRIGger:A:LOGIc:PATtern:WHEn:MORELimit? Arguments specifies the minimum amount of time to hold the pattern true. <NR3> Examples sets the minimum TRIGGER:A:LOGIC:PATTERN:WHEN:MORELIMIT 10.0E+00 time that the selected pattern may hold true (and generate an A logic pattern trigger) to 10 s.
Page 483
Commands Listed in Alphabetical Order TRIGger:A:LOGIc:THReshold:D<x> Sets or returns the trigger A logic threshold level for the specified digital channel <x>. This commands affects all trigger types using the digital channel. Group Trigger Syntax TRIGger:A:LOGIc:THReshold:D<x> {<NR3>|ECL|TTL} TRIGger:A:LOGIc:THReshold:D<x>? Related Commands TRIGger:A:LEVel:D<x> Arguments specifies the threshold level in volts.
Page 484
Commands Listed in Alphabetical Order 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:D<x> Sets the lower threshold for the digital channel selected. Each channel can have an independent level.
Page 485
Commands Listed in Alphabetical Order TRIGger:A:MODe Sets or returns the A trigger mode. Group Trigger Syntax TRIGger:A:MODe {AUTO|NORMal} TRIGger:A:MODe? Related Commands TRIGger:A:LEVel Arguments generates a trigger if one is not detected within a specified time period. AUTO waits for a valid trigger event. NORMal Examples specifies that a valid trigger event must occur before...
Page 486
Commands Listed in Alphabetical Order Syntax TRIGger:A:PULse:CLAss {RUNt|WIDth|TRANsition} TRIGger:A:PULse:CLAss? Related Commands TRIGger:A:RUNT?, TRIGger:A:PULSEWIDth?, TRIGger:A{:TRANsition|: RISEFall}?, TRIGger:A:TYPe Arguments triggers when a pulse crosses the first preset voltage threshold but does not RUNt cross the second preset threshold before recrossing the first. triggers when a pulse is found that has the specified polarity and is either WIDth inside or outside the specified time limits.
Page 487
Commands Listed in Alphabetical Order Arguments specifies a negative pulse. NEGative specifies a positive pulse. POSitive Examples sets the pulse polarity to TRIGGER:A:PULSEWIDTH:POLARITY NEGATIVE negative. might return TRIGGER:A:PULSEWIDTH:POLARITY? indicating a positive pulse. :TRIGGER:A:WIDTH:POLARITY POSITIVE TRIGger:A:PULSEWidth:SOUrce Sets or returns the source for the pulse-width trigger. Group Trigger Syntax...
Page 488
Commands Listed in Alphabetical Order Arguments argument sets the oscilloscope to trigger if a pulse is detected with LESSthan width less than the time set by the TRIGger:A:PULSEWidth:WIDth command. argument sets the oscilloscope to trigger if a pulse is detected with width than than the time set by the TRIGger:A:PULSEWidth:WIDth...
Page 489
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:RUNT? Examples might return TRIGGER:A:RUNT? :TRIGGER:A:RUNT:SOURCE CH1;POLARITY POSITIVE;WHEN OCCURS;WIDTH 4.0000E-9 TRIGger:A:RUNT:POLarity Sets or returns the polarity for the runt trigger. 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.
Page 490
Commands Listed in Alphabetical Order Arguments specifies the input channel number, depending on the model of the CH1–CH4 oscilloscope. Examples sets channel 4 as the source for the A pulse TRIGGER:A:RUNT:SOURCE CH4 trigger. might return TRIGGER:A:RUNT:SOURCE? :TRIGGER:A:RUNT:SOURCE CH2 indicating that channel 2 is the source for the A pulse trigger. TRIGger:A:RUNT:WHEn Sets or returns the type of pulse width the trigger checks for when it detects a runt.
Page 491
Commands Listed in Alphabetical Order TRIGger:A:RUNT:WIDth Sets or returns the width for a runt trigger. Group Trigger Syntax TRIGger:A:RUNT:WIDth <NR3> TRIGger:A:RUNT:WIDth? Related Commands TRIGger:A:RUNT:WHEn Arguments specifies the minimum width, in seconds. <NR3> Examples sets the minimum width of the pulse runt TRIGGER:A:RUNT:WIDTH 15E-6 trigger to 15 µs.
Page 492
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:SETHold:CLOCk? Examples might return TRIGGER:A:SETHOLD:CLOCK? :TRIGGER:A:SETHOLD:CLOCK:SOURCE EXT;EDGE FALL;THRESHOLD 1.4000 TRIGger:A:SETHold:CLOCk:EDGE Sets or returns the clock edge polarity for setup and hold triggering. 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.
Page 493
Commands Listed in Alphabetical Order Arguments specifies the input channel number. is only for CH1–CH4 D0–D15 D0–D15 MSO models. specifies an external trigger using the Aux Input connector located on the front panel of the oscilloscope. Examples specifies channel 1 as the clock TRIGGER:A:SETHOLD:CLOCK:SOURCE CH1 input for setup and hold input.
Page 494
Commands Listed in Alphabetical Order Related Commands TRIGger:A:SETHold:CLOCk? Examples might return TRIGGER:A:SETHOLD:DATA? :TRIGGER:A:SETHOLD:DATA:SOURCE CH2;THRESHOLD 80.0000E-3 TRIGger:A:SETHold:DATa:SOUrce Sets or returns the data source for the setup and hold trigger. You cannot specify the same source for both clock and data. For DPO models, you can specify only a single data source. Data sources for DPO models may be one of CH1-CH4 or the Auxin port (EXT or AUX).
Page 495
Commands Listed in Alphabetical Order TRIGger:A:SETHold:DATa:THReshold Sets or returns the data voltage threshold for setup and hold trigger. Group Trigger Syntax TRIGger:A:SETHold:DATa:THReshold {<NR3>|TTL} TRIGger:A:SETHold:DATa:THReshold? Arguments specifies the preset TTL high level of 1.4 V. is the setup and hold data level, in V. <NR3>...
Page 496
Commands Listed in Alphabetical Order TRIGger:A:SETHold:SETTime Sets or returns the setup time for setup and hold violation triggering. Group Trigger Syntax TRIGger:A:SETHold:SETTime <NR3> TRIGger:A:SETHold:SETTime? Arguments specifies the setup time for setup and hold violation triggering. <NR3> Examples specifies that the current setup time for TRIGGER:A:SETHOLD:SETTIME 3.0E-6 setup and hold trigger is 3 µs.
Page 497
Commands Listed in Alphabetical Order TRIGger:A:SETHold:THReshold:D<x> Sets the threshold for the selected digital channel. Affects all trigger types using the digital channel. Group Trigger Syntax TRIGger:A:SETHold:THReshold:D<x> {<NR3>|ECL|TTL} TRIGger:A:SETHold:THReshold:D<x>? Arguments specifies the threshold voltage, in volts. <NR3> specifies a preset ECL high level of –1.3V. specifies a preset TTL high level of 1.4V.
Page 498
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A{:TRANsition|:RISEFall}:DELTatime <NR3> TRIGger:A{:TRANsition|:RISEFall}:DELTatime? Arguments specifies the delta time, in seconds. <NR3> Examples sets the delta time of the TRIGGER:A:TRANSITION:DELTATIME 15E-6 transition trigger to 15 µs. might return TRIGGER:A:TRANSITION:DELTATIME? :TRIGGER:A indicating that the delta time of the :TRANSITION:DELTATIME 2.0000E-09 transition trigger is set to 2 ns.
Page 499
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A{:TRANsition|:RISEFall}:SOUrce {CH1|CH2|CH3|CH4} TRIGger:A{:TRANsition|:RISEFall}:SOUrce? Arguments specifies one of the input channels. CH1–CH4 Examples sets channel 4 as the source for the TRIGGER:A:TRANSITION:SOURCE CH4 transition trigger. might return TRIGGER:A:TRANSITION:SOURCE? :TRIGGER:A:TRANSITION: indicating that channel 2 is the source for the A transition trigger. SOURCE CH2 TRIGger:A{:TRANsition|:RISEFall}:WHEn Sets or returns whether to check for a transitioning signal that is faster or slower...
Page 500
Commands Listed in Alphabetical Order TRIGger:A:TYPe Sets or returns the type of A trigger. Once you have set the trigger type, you may also need to identify the associated trigger class. For details on selecting Logic and Pulse trigger classes, see TRIGger:A:LOGIc:CLAss TRIGger:A:PULse:CLAss respectively.
Page 501
Commands Listed in Alphabetical Order Syntax TRIGger:A:UPPerthreshold:CH<x> {<NR3>|ECL|TTL} TRIGger:A:UPPerthreshold:CH<x>? Arguments is the threshold level in volts. <NR3> specifies a preset ECL high level of –1.3V. specifies a preset TTL high level of 1.4V. Examples sets the upper limit of the pulse TRIGGER:A:UPPERTHRESHOLD:CH2 50E-3 runt trigger to 50 mV for channel 2.
Page 502
Commands Listed in Alphabetical Order TRIGger:A:VIDeo:CUSTom{:FORMat|:TYPE}? Arguments argument sets the format for interlaced video lines. INTERLAced argument sets the format for progressive video lines. PROGressive Examples sets the custom format for TRIGGER:A:VIDEO:CUSTOM:FORMAT PROGRESSIVE the A video trigger to progressive lines. might return TRIGGER:A:VIDEO:CUSTOM:FORMAT? :TRIGGER:A:VIDEO:...
Page 503
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:A:VIDeo:CUSTom:SCAN {RATE15K|RATE20K|RATE25K|RATE35K|RATE50K} TRIGger:A:VIDeo:CUSTom:SCAN? Arguments sets the range of the video line scan rate to 15 kHz through 20 kHz. This RATE15 is the standard broadcast rate. sets the range of the video line scan rate to 20 kHz through 25 kHz. RATE20 sets the range of the video line scan rate to 25 kHz through 35 kHz RATE25...
Commands Listed in Alphabetical Order might return TRIGGER:A:VIDEO:CUSTOM:SYNCINTERVAL? indicating the sync TRIGGER:A:VIDEO:CUSTOM:SYNCINTERVAL 4.7200E-6 interval is set to 4.72 μs. TRIGger:A:VIDeo:HDtv:FORMat Sets or returns the HDTV video signal format on which to trigger. Conditions This command requires a DPO4VID application module. Group Trigger Syntax...
Commands Listed in Alphabetical Order 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. The <NR3> argument sets the number of fields that the oscilloscope waits before rearming the video trigger. Examples might return TRIGGER:A:VIDEO:HOLDOFF:FIELD?
Page 506
Commands Listed in Alphabetical Order Examples sets the oscilloscope to trigger on the line 23. TRIGGER:A:VIDEO:LINE 23 might return TRIGGER:A:VIDEO:LINE ? :TRIGger:A:VIDeo:LINE 10 indicating that the oscilloscope is set to trigger on line 10. TRIGger:A:VIDeo:POLarity Sets or returns the polarity of the A video trigger. Conditions This command requires a DPO4VID application module.
Page 507
Commands Listed in Alphabetical Order Examples sets the source for A video trigger to Channel 1. TRIGGER:A:VIDEO:SOURCE CH1 might return TRIGGER:A:VIDEO:SOURCE? :TRIGger:A:VIDeo:SOURCE CH2 indicating that the source for the A video trigger is set to Channel 2. TRIGger:A:VIDeo:STANdard Sets or returns the standard for the video trigger. Group Trigger Syntax...
Page 508
Commands Listed in Alphabetical Order 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. ALLLines argument sets the oscilloscope to trigger on the video signal line NUMERic...
Page 509
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:B:BY {EVENTS|TIMe} TRIGger:B:BY? Related Commands TRIGger:B:EVENTS:COUNt, TRIGger:B:TIMe, , Arguments sets the B trigger to take place following a set number of trigger EVENTS events after the A trigger occurs. The number of events is specified by TRIGger:B: :COUNt.
Page 510
Commands Listed in Alphabetical Order Syntax TRIGger:B:EDGE:COUPling {DC|HFRej|LFRej|NOISErej} TRIGger:B:EDGE:COUPling? Related Commands TRIGger:B:EDGE? Arguments selects trigger coupling. selects high-frequency reject coupling. HFRej selects low-frequency reject coupling. LFRej selects low sensitivity. NOISErej Examples selects DC for the B trigger coupling. TRIGGER:B:EDGE:COUPLING DC might return TRIGGER:B:EDGE:COUPLING? :TRIGGER:B:EDGE:COUPLING...
Page 511
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:B:EDGE:SOUrce {CH<x>|EXT|LINE} TRIGger:B:EDGE:SOUrce? Related Commands TRIGger:B:EDGE? Arguments specifies one of the input channels as the B trigger source. CH<x> specifies an external trigger (using the Aux In connector, located on the front panel of the oscilloscope) as the B trigger source.
Page 512
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:B:EVENTS:COUNt <NR1> TRIGger:B:EVENTS:COUNt? Related Commands TRIGger:B:EVENTS? Arguments is the number of B trigger events, which can range from 1 to 10,000,000. <NR1> Examples specifies that the B trigger will occur four trigger TRIGGER:B:EVENTS:COUNT 4 events after the A trigger.
Page 513
Commands Listed in Alphabetical Order Group Trigger Syntax TRIGger:B:LEVel:CH<x> {ECL|TTL|<NR3>} TRIGger:B:LEVel:CH<x>? Arguments specifies a preset ECL high level of –1.3V. specifies a preset TTL high level of 1.4V. specifies the trigger level in user units (usually volts). <NR3> Examples might return TRIGGER:B:LEVEL:CH2? :TRIGGER:B:LEVEL:CH2 indicating that the B edge trigger is set to 1.3 V for channel 2.
Page 514
Commands Listed in Alphabetical Order Syntax TRIGger:B:LOWerthreshold:CH<x> {ECL|TTL|<NR3>} TRIGger:B:LOWerthreshold:CH<x>? Arguments specifies a preset ECL high level of –1.3V. specifies a preset TTL high level of 1.4V. is the threshold level, in volts. <NR3> TRIGger:B:LOWerthreshold:D<x> Sets or queries the lower threshold for the digital channel selected. Each channel can have an independent level.
Page 515
Commands Listed in Alphabetical Order Arguments specifies that the B trigger is active and in causes trigger events conjunction with the A trigger. specifies that only the A trigger causes trigger events. a 0 turns off the B trigger; any other value activates the B trigger. <NR1>...
Page 516
Commands Listed in Alphabetical Order Related Commands TRIGger:A:TYPe Arguments sets the B trigger type to edge. EDGE Examples sets the B trigger type to edge. TRIGGER:B:TYPE EDGE might return TRIGGER:B:TYPE? :TRIGGER:B:TYPE EDGE TRIGger:B:UPPerthreshold:CH<x> Sets the upper threshold for the channel selected. Each channel can have an independent level.
Page 517
Commands Listed in Alphabetical Order Arguments is the attenuation factor of the probe. <NR3> 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...
Page 518
Commands Listed in Alphabetical Order Related Commands TRIGger:A:MODe Returns indicates that the oscilloscope is acquiring pretrigger information. ARMED 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.
Page 519
Commands Listed in Alphabetical Order Examples unlocks all front-panel buttons and knobs. UNLOCK ALL 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.
Page 520
Commands Listed in Alphabetical Order Related Commands USBTMC:PRODUCTID:HEXadecimal?, USBTMC:SERIALnumber?, USBTMC:VENDORID:DECimal?, USBTMC:VENDORID:HEXadecimal? Examples might return USBTMC:PRODUCTID:DECIMAL? USBTMC:PRODUCTID:DECIMAL , indicating the product ID in decimal is 1025. 1025 USBTMC:PRODUCTID:HEXadecimal? (Query Only) This query to returns the USBTMC product ID. The product ID numbers vary for each instrument family and model.
Page 521
Commands Listed in Alphabetical Order USBTMC:VENDORID:DECimal? (Query Only) This query returns the USBTMC vendor ID. The Vendor ID for Tektronix is 0x699 or 1689 decimal. Group Miscellaneous Syntax USBTMC:VENDORID:DECimal? Related Commands USBTMC:PRODUCTID:DECimal?, USBTMC:PRODUCTID:HEXadecimal?, USBTMC:SERIALnumber?, USBTMC:VENDORID:HEXadecimal? Examples might return USBTMC:VENDORID:DECIMAL? USBTMC:VENDORID:DECIMAL , indicating the vendor ID in decimal is 1689.
Page 522
Commands Listed in Alphabetical Order NOTE. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk). This command does affect the verbose state of both the USBTMC and VXI-11 interfaces. Refer to the Introduction for information.
Page 523
Commands Listed in Alphabetical Order Examples prevents the oscilloscope from executing any further commands or queries *WAI until all pending commands that generate an OPC message are complete. WAVFrm? (Query Only) Returns WFMOutpre? and CURVe? data for the waveform as specified by the DATA:SOUrce command.
Page 524
Commands Listed in Alphabetical Order Y; PT_OFF 0;XINCR 2.0000E-6;XZERO 1.7536E-6; XUNIT "s";YMULT 1.0000E-3;YOFF 0.0000; YZERO 0.0000;YUNIT "V" WFMInpre:BIT_Nr Sets or returns the number of bits per binary waveform point for the incoming waveform. Changing the value of WFMInpre:BIT_Nr also changes the value of WFMInpre:BYT_Nr.
Page 525
Commands Listed in Alphabetical Order Examples specifies positive integer data point representation. WFMINPRE:BN_FMT RP might return indicating that the WFMINPRE:BN_FMT? :WFMINPRE:BN_FMT RI incoming data is currently interpreted as signed integers. WFMInpre:BYT_Nr Sets or returns the data width for the incoming waveform. Changing the value of WFMInpre:BYT_Nr also changes the value of WFMInpre:BIT_Nr.
Page 526
Commands Listed in Alphabetical Order Arguments specifies that the least significant byte will be expected first. specifies that the most significant byte will be expected first. Examples sets the most significant incoming byte of incoming WFMINPRE:BYT_OR MSB waveform data to be expected first. might return indicating that the WFMINPRE:BYT_OR?
Page 527
Commands Listed in Alphabetical Order Related Commands CURVe, DATa, DATa:STARt, DATa:STOP, SAVe:WAVEform, SAVe:WAVEform:FILEFormat, WFMOutpre:NR_Pt? Arguments is the number of data points if WFMInpre:PT_Fmt is set to Y. It is the <NR1> number of min-max pairs if WFMInpre:PT_Fmt is set to ENV. Examples specifies that 10000 data points will be expected.
Page 528
: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 529
Commands Listed in Alphabetical Order WFMInpre:XUNit Sets or returns the horizontal 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 Group...
Page 530
Commands Listed in Alphabetical Order Examples , which indicates the trigger occurred 5.7 µs before the WFMINPRE:XZERO 5.7E-6 first sample in the waveform. might return indicating WFMINPRE:XZERO? :WFMINPRE:XZEro –7.5000E-6 that the trigger occurs 7.5 µs after the first sample in the waveform. WFMInpre:YMUlt Sets or returns the vertical scale factor of the incoming waveform, expressed in YUNits per waveform data point level.
Page 531
Commands Listed in Alphabetical Order WFMInpre:YOFf Sets or returns the vertical position of the incoming waveform in digitizing levels. Variations in this number are analogous to changing the vertical position of the waveform. YMUlt, YOFf, and YZEro are used to convert waveform record values to YUNit values using the following formula (where dl is the data level;...
Page 532
Commands Listed in Alphabetical Order Syntax WFMInpre:YUNit <QString> WFMInpre:YUNit? Related Commands WFMOutpre:YUNit? Arguments contains a maximum of three alpha characters that represent the <QString> vertical unit of measure for the incoming waveform. Examples might return indicating the vertical WFMINPRE:YUNIT? :WFMINPRE:YUNIT "V" units for the incoming waveform are volts.
Page 533
Commands Listed in Alphabetical Order 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). might return indicating WFMINPRE:YZERO? :WFMINPRE:YZEro 7.5000E-6 that the zero reference for the incoming waveform is 7.5 µV below the center of the data range (given that WFMInpre:YUNit is set to V).
Page 534
Commands Listed in Alphabetical Order Examples sets the number of bits per waveform point to 16 for WFMOUTPRE:BIT_NR 16 outgoing waveforms. might return indicating that :WFMOUTPRE:BIT_NR 8 WFMOUTPRE:BIT_NR? outgoing waveforms use 8 bits per waveform point. WFMOutpre:BN_Fmt Sets or returns the format of binary data for outgoing waveforms specified by DATa:SOUrce command.
Page 535
Commands Listed in Alphabetical Order Arguments is the number of bytes per data point and can be 1 or 2. <NR1> Examples sets the number of bytes per outgoing waveform data WFMOUTPRE:BYT_NR 1 point to 1, which is the default setting. might return indicating that WFMOUTPRE:BYT_NR?
Page 536
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 537
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 538
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...
Commands Listed in Alphabetical Order Table 2-45: Waveform Suffixes Field Description Examples Source The source identification string as it appears in “CH1–4” the front-panel scale factor readouts. “Math1 “Ref1–4" Coupling A string describing the vertical coupling of the “AC coupling” waveform (the Source1 waveform in the case of “DC couplng”...
Page 540
Commands Listed in Alphabetical Order Related Commands DATa:SOUrce, WFMOutpre:XUNit? Examples might return WFMOUTPRE:XINCR? :WFMOUTPRE:XINCR 10.0000E-6 indicating that the horizontal sampling interval is 10 µs/point. WFMOutpre:XUNit? (Query Only) Returns the horizontal units for the waveform specified by the DATa:SOUrce command. The query command will time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on.
Page 541
Commands Listed in Alphabetical Order 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. The query command will time out and an error is generated if the waveform specified by DATa:SOUrce is not turned on.
Page 542
Commands Listed in Alphabetical Order WFMOutpre:YUNit? (Query Only) Returns the vertical units for the waveform specified by the DATa:SOUrce command. The query command will time out and an error will be generated if the waveform specified by DATa:SOUrce is not turned on. Group Waveform Transfer Syntax...
Page 543
Commands Listed in Alphabetical Order Syntax ZOOm? Examples might return ZOOM? :ZOOM:MODE 1;GRATICULE:SIZE 80;SPLIT EIGHTYTWENTY;:ZOOM:ZOOM1:STATE 1;SCALE 400. 0000E-12;POSITION 46.8986;FACTOR 50.0000E+3;HORIZONTAL:POSITION 46.8986;SCALE 40 0.0000E-12 ZOOm:MODe Turns Zoom mode on or off. The Zoom query returns the current state of Zoom mode. This command is equivalent to pressing the zoom button located on the front panel.
Page 544
Commands Listed in Alphabetical Order Examples might return ZOOM:ZOOM1? :ZOOM:ZOOM1:STATE 1;SCALE 400.0000E-12;POSITION 46.8986;FACTOR 50.0000E+3;HORIZO NTAL:POSITION 46.8986;SCALE 400.0000E-12 ZOOm:ZOOM<x>:FACtor? (Query Only) Returns the zoom factor of a particular zoom box. <x> can only be 1. Group Zoom Syntax ZOOm:ZOOM<x>:FACtor? Returns is the zoom factor of a zoom box. <NR1>...
Page 545
Commands Listed in Alphabetical Order ZOOm:ZOOM<x>:STATE Sets or returns the specified zoom on or off, where x is the integer 1 representing the single zoom window. <x> can only be 1. Zoom Group Syntax ZOOm:ZOOM<x>:STATE {ON|OFF|<NR1>} ZOOm:ZOOM<x>:STATE? Arguments turns Zoom 1 on. turns Zoom 1 off.
Page 546
Commands Listed in Alphabetical Order 2-532 MSO4000 and DPO4000 Series Programmer Manual...
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.
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.
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.
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.
Status and Events Event Queue The Event Queue stores detailed information on up to 33 events. If than 32 events stack up in the Event Queue, the 32nd event is replaced by event code 350, "Queue Overflow." 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).
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).
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 extended period of time before the acquisition is complete.
Status and Events Table 3-3: Oscilloscope operations that can generate OPC (cont.) Command Conditions SAVe:WAVEform REF1|REF2|REF3|REF4 TEKSecure 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...
Page 555
Status and Events You can use four commands to synchronize the operation of the oscilloscope with your application program: *WAI, BUSY, *OPC, and *OPC? Using the *WAI Command The *WAI command forces completion of previous commands that generate an OPC message. No commands after the *WAI are processed before the OPC message(s) are generated The same command sequence using the *WAI command for synchronization looks like this:...
Page 556
Status and Events ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the measurement */ While BUSY? keep looping /* Take amplitude measurement */ MEASUREMENT:IMMED:VALUE? This sequence lets you create your own wait loop rather than using the *WAI command.
Page 557
Status and Events While serial poll = 0, keep looping /* Take amplitude measurement */ MEASUREMENT:IMMED:VALUE? This technique requires less bus traffic than did looping on BUSY. Service Request Method: Enable the OPC bit in the Device Event Status Enable Register (DESER) and the Event Status Enable Register (ESER) using the DESE and *ESE commands.
Status and Events ACQUIRE:STATE OFF SELECT:CH1 ON HORIZONTAL:RECORDLENGTH 1000 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 the measurement*/ *OPC? Wait for read from Output Queue.
Status and Events Table 3-5: Command Error Messages (CME Bit 5) Code Message Command error Invalid character Syntax error Invalid separator Data type error GET not allowed Parameter not allowed Missing parameter Command header error Program mnemonic too long Undefined header Numeric data error Invalid character in numeric Exponent too large...
Page 560
Status and Events Table 3-6: Execution Error Messages (EXE Bit 4) (cont.) Code Message Illegal parameter value Hardware missing Mass storage error Missing mass storage Missing media Corrupt media Media full Directory full File name not found File name error Media protected File name too long Hardcopy error...
Page 561
Status and Events Table 3-6: Execution Error Messages (EXE Bit 4) (cont.) Code Message 2214 Measurement error, No crossing, target waveform 2215 Measurement error, No crossing, second waveform 2216 Measurement error, No crossing, target waveform 2217 Measurement error, Constant waveform 2219 Measurement error, No valid edge - No arm sample 2220...
Status and Events Table 3-6: Execution Error Messages (EXE Bit 4) (cont.) Code Message 2620 Mask error, too few points received 2760 Mark limit reached 2761 No mark present 2762 Search copy failed Device Error The following table lists the device errors that can occur during oscilloscope operation.
Status and Events Table 3-9: Execution Warning Messages (EXE Bit 4) Code Message Parameter out of range Curve data too long, Curve truncated Curve error, Preamble values are inconsistent Measurement warning, Uncertain edge Measurement warning, Low signal amplitude Measurement warning, Unstable histogram Measurement warning, Low resolution Measurement warning, Uncertain edge Measurement warning, Invalid in minmax...
Page 564
Status and Events 3-18 MSO4000 and DPO4000 Series Programmer Manual...
Appendix B: Reserved Words This is a list of reserved words for your instrument. Capital letters identify the required minimum spelling. *CAL ADVanced BITOrder CM10BY15 *CLS ALIas BITRate CM13BY18 CM15BY21 *DDT BITSTUFFing *ESE ALLEv BIT_Nr CM18BY24 *ESR ALLFields CM6BY8 *IDN ALLLines BLAckmanharris CM7BY10...
Page 568
Appendix B: Reserved Words DYNAMic FIRst HARM5ALTernate FIVEdivs HARMSOURce FIXEDFREQValue HARMonics FIXEDFREQuency HBArs EDGE FLAg HD1080I50 EEPROM FLEXray HD1080I60 EITher FOCUS HD1080P24 ENAble FOLder HD1080P25 DATA ENCdg FORCEDRange HD1080PSF24 FORCe DATA0 HD480P60 DATA1 ENDPoint FORMAt HD720P60 DATABits ENERGY FORWards HDtv DATAPacket ENERGYLoss FPAnel...
Page 569
Appendix B: Reserved Words INDICators PARity INDIvidual LOWCurrent NAME PASS INDependent LOWLimit NANd PASSFail INFInite LOWVoltage NDUty PASSWord INIT LOWerthreshold NEGative PATtern INKSaver NEWpass PAYLength INPUTPOWer NEXT PAYLoad INPut MAGnivu NEXt PDUty INTENSITy MAIN PEAKdetect NOCARE INTERLAced MARK PERCent INTERNal MARKSINCOLumn NOISErej PERIod...
Page 570
Appendix B: Reserved Words PT_Fmt SETTime STandard PT_ORder RIBinary SETUP SUBNETMask PT_Off RIGht SETUp SUSPEND PULSEWIDth RIPPle SHOW SWITCHingloss PULSEWidth RISEFall SIGMA1 SWLoss PULSe RISe SIGMA2 SYNC PULse RISing SIGMA3 SYNCField PWIdth SIGNEDDECimal SYNCFrame RMDir SIGnal SYNCInterval SIMPlifiedchinese QUALifier TABle QUALity ROLL100MM SINGleended...
Page 571
Appendix B: Reserved Words VERTAUTOset WFMOutpre USBDevice VERTDEFault WHEn XZEro USBTMC VERTical WIDth USBTmc VIDeo WINdow YDELta VOLTAGESOurce WORD USER VOLTage WORDSel YMAX VOLts WRITE YMIN VRMS WRITEFile YMUlt VALue WAKEup YOFf VBArs WAVEFORMS XDELta VCEsat WAVEform YUNIts VCRESTfactor WAVFrm XINcr YUNit VDELTa...
Page 572
Appendix B: Reserved Words MSO4000 and DPO4000 Series Programmer Manual...
Appendix C: Factory Defaults Default Setup The following table lists the default values for each command. NOTE. Find the most up-to-date default values for your instrument and software by performing a TekSecure command, saving the instrument setup and looking at the instrument or setup file. Table C-1: Default values Command Default value...
Appendix D: Programming Example The following series of commands and queries illustrate many of the most common commands and techniques. In this example, data sent from the controller computer to the oscilloscope is prefaced with the > symbol. Replies from the oscilloscope have no preface.
Page 610
Appendix D: Programming Example > rem “Be sure to use the *esr? query to check for measurement errors.” > measu:immed:type freq > measu:immed:value :MEASUREMENT:IMMED:VALUE 9.9100E+37 > *esr? > allev? :ALLEV 2202,”Measurement error, No period found “ > rem “Query out the waveform points, for later analysis on your controller computer.”...