Page 1 Programmer Manual TDS200-, TDS1000-, and TDS2000-Series Digital Oscilloscope 071-1075-00 This document supports TDS210 and TDS220 with FV:v1.09 and above when used with TDS2CM version CMV:v1.04 and above, or TDS2CMA and TDS2MM any version; TDS224, TDS1000- and TDS2000-series, all versions www.tektronix.com...
Page 2 Copyright © Tektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix or its suppliers and are protected by United States copyright laws and international treaty provisions. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1)
Page 3 Tektronix, with shipping charges prepaid. Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the Tektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any other charges for products returned to any other locations.
Page 5: Table Of Contents
........Contacting Tektronix .
Page 6 Table of Contents Waveform Data Formats ......2-29 Waveform Data Record ......2-31 Waveform Data Locations and Memory Allocation .
Page 7 Table of Contents List of Figures Figure 2-1: Command message elements ....Figure 2-2: Block argument example ....2-13 Figure 3-1: The Standard Event Status Register (SESR) Figure 3-2: The Status Byte Register (SBR)
Page 8 Table of Contents Table 2-9: Cursor commands ......2-16 Table 2-10: Display commands ..... . . 2-17 Table 2-11: Hard Copy commands .
Page 9: Preface
Preface This programmer manual provides information on how to operate your TDS 200-, TDS1000- or TDS2000-series digital oscilloscope with the RS-232 or General Purpose Interface Bus (GPIB) protocols. Related Documents The TDS1000- and TDS2000-series oscilloscopes offer the following standard and optional documents: H For information on the general operation of the oscilloscopes and how to use a TDS2CMA communications module with the oscilloscope, refer to the TDS1000- and TDS2000-Series Digital...
Page 10: Conventions
Manual, a standard accessory available in eleven languages H For information on how to use a TDS2CMA communications module, or a TDS2MM measurements module with the oscilloscope, refer to the TDS200 Series Extension Modules Instructions Manual (071-0409-XX), a standard accessory for extension modules in English only...
Page 11: Contacting Tektronix
This phone number is toll free in North America. After office hours, please leave a voice mail message. Outside North America, contact a Tektronix sales office or distributor; see the Tektronix web site for a list of offices. TDS200/1000/2000 Series Oscilloscope Programmer Manual...
Page 12 Preface TDS200/1000/2000 Series Oscilloscope Programmer Manual viii...
Page 13: Getting Started
Getting Started...
Page 15 Math and measurement functions of the TDS2MM extension module. For a TDS200 oscilloscope, you must have installed a TDS2CMA Communications Extension Module or TDS2MM Measurement Extension Module. Follow the instructions in the TDS200 Series Extension Module Instructions Manual to install, test, and configure your extension module.
Page 16 Getting Started TDS200/1000/2000 Series Oscilloscope Programmer Manual 1−2...
Page 17: Syntax And Commands
Syntax and Commands...
Page 19: Command Syntax
Command Syntax You can control the oscilloscope through the GPIB or RS-232 interface using a large group of commands and queries. This section describes the syntax these commands and queries use and the conventions the oscilloscope uses to process them. The commands and queries themselves are listed in the Command Descriptions section.
Page 20: Command And Query Structure
Command Syntax Command and Query Structure Commands consist of set commands and query commands (usually simply called commands and queries). Commands change oscillo- scope settings or perform a specific action. Queries cause the oscilloscope to return data and information about its status. Most commands have both a set form and a query form.
Page 21: Figure 2-1: Command Message Elements
Command Syntax Table 2−2: Command message elements (Cont.) Symbol Meaning <Argument> A quantity, quality, restriction, or limit associated with the header. Not all commands have an argument, while other commands have multiple arguments. Arguments are separated from the header by a <Space>.
Page 22 Command Syntax Commands Commands cause the oscilloscope to perform a specific function or change one of its settings. Commands have the structure: [:]<Header>[<Space><Argument>[<Comma><Argument>]...] A command header is made up of one or more mnemonics arranged in a hierarchical or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off of the previous one.
Page 23: Command Entry
Command Syntax Table 2−3: Comparison of Header Off and Header On responses Query Header Off response Header On response ACQuire:NUMAVg? :ACQUIRE:NUMAVG 64 CHx1:COUPling? :CH1:COUPLING DC Clearing the Output Queue To clear the output queue and reset the oscilloscope to accept a new command or query, send a Device Clear (DCL) from a GPIB host or a break signal from an RS-232 host.
Page 24 Command Syntax Concatenating Commands You can concatenate any combination of set commands and queries using a semicolon (;). The oscilloscope executes concatenated commands in the order received. When concatenating commands and queries you must follow these rules: H Completely different headers must be separated by both a semicolon and by the beginning colon on all commands but the first.
Page 25 Command Syntax H When you concatenate queries, the responses to all queries are combined into a single response message. For example, if channel 1 coupling is set to DC and the bandwidth is set to 20 MHz, the concatenated query: CH1:COUPling?;BANdwidth? returns :CH1:COUPLING DC;:CH1:BANDWIDTH ON if header is on, or DC;ON if header is off.
Page 26: Constructed Mnemonics
Command Syntax Message Terminators This manual uses the term <EOM> (End of message) to represent a message terminator. GPIB End of Message Terminators. GPIB EOM terminators can be the END message (EOI asserted concurrently with the last data byte), the ASCII code for line feed (LF) sent as the last data byte, or both. The oscilloscope always terminates messages with LF and EOI.
Page 27 Measurement Specifier Mnemonics Commands can specify which measurement to set or query as a mnemonic in the header. The oscilloscope can display up to four (TDS200 series) or five (TDS1000 and TDS2000 series) automated measurements. TDS200/1000/2000 Series Oscilloscope Programmer Manual...
Page 28: Argument Types
Command Syntax Symbol Meaning MEAS<x> A measurement specifier; <x> is 1−4 (TDS200 Series) or 1−5 (TDS1000 and TDS2000 series). Argument Types A command argument can be in one of several forms. The individual descriptions of each command tell which argument types to use with that command.
Page 29: Table 2-5: Oscilloscope Handling Of Incorrect Numeric
Command Syntax Table 2−5: Oscilloscope handling of incorrect numeric arguments Argument value Oscilloscope response Numeric argument is Sets the specified command to the lowest correct less than lowest correct value and executes the command value for that command Numeric argument is Sets the specified command to the highest correct greater than the highest value and executes the command...
Page 30: Table 2-6: Parts Of A Block Argument
Command Syntax 4. You can include a quote character within a string simply by repeating the quote. For example, "here is a "" mark" 5. Strings can have upper or lower case characters. 6. If you use a GPIB network, you cannot terminate a quoted string with the END message before the closing delimiter.
Page 31: Figure 2-2: Block Argument Example
Command Syntax Figure 2-2 shows an example of a block argument. Block argument *DDT #217ACQuire:STATE RUN Block header Specifies data length Specifies number of length digits that follow Figure 2−2: Block Argument example <NZDig> specifies the number of <Dig> elements that follow. Taken together, the <Dig>...
Page 32 Command Syntax TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−14...
Page 33: Command Groups
This section lists the commands organized by functional group. The Command Descriptions section, starting on page 2-35, lists all commands alphabetically. The oscilloscope GPIB and RS-232 interfaces conform to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2–1987 except where noted.
Page 34: Cursor Commands
Command Groups Table 2−8: Calibration and Diagnostic commands Header Description *CAL? Perform an internal self−calibration and return result status CALibrate:ABOrt Stop an in−progress factory calibration CALibrate:INTERNAL Perform an internal self−calibration CALibrate:FACtory Initialize the factory calibration sequence CALibrate:CONTINUE Perform the next step in the factory calibration sequence CALibrate:STATUS? Return PASS or FAIL status of the last...
Page 35: Display Commands
Command Groups Table 2−9: Cursor commands (Cont.) Header Description CURSor:HBArs:POSITION<x> Set/query position of a horizontal bar cursor CURSor:HBArs:UNIts? Query vertical scale units CURSor:SELect:SOUrce Select waveform CURSor:VBArs? Return vertical bar settings CURSor:VBArs:DELTa? Return horizontal distance between cursors CURSor:VBArs:POSITION<x> Set/query position of a vertical bar cursor CURSor:VBArs:UNIts Set/query vertical cursors to time or frequency...
Page 36: Hard Copy Commands
You can set the position and time per division of both the main and window time bases. You can substitute SECdiv for SCAle in all appropriate horizontal commands. This provides program compati- bility with previous Tektronix digitizing oscilloscopes. Table 2-12 lists and describes Horizontal commands. Table 2−12: Horizontal commands...
Page 37: Math Commands
Set/query FFT horizontal display position MATH:FFT:HORizontal:SCAle Set/query FFT horizontal zoom factor MATH:FFT:VERtical:POSition Set/query FFT vertical display position MATH:FFT:VERtical:SCAle Set/query FFT vertical zoom factor TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurement module. TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−19...
Page 38: Measurement Commands
Command Groups Measurement Commands Measurement commands control the automated measurement system. Up to four (TDS200 series) or five (TDS1000 and TDS2000 series) automated measurements can be displayed on the oscillo- scope screen. In the commands, these measurement readouts are named MEAS<x>, where <x> can be 1, 2, 3, or 4 (or 5 for TDS1000 and TDS2000 series).
Page 39: Miscellaneous Commands
Command Groups Table 2−14: Measurement commands (Cont.) Header Description MEASUrement:IMMed:VALue? Return the immediate measurement result MEASUrement:MEAS<x>? Return parameters on the periodic measurement MEASUrement:MEAS<x>:SOUrce Set/query channel to take the periodic measurement from MEASUrement:MEAS<x>:TYPe Set/query the type of periodic measure− ment to be taken MEASUrement:MEAS<x>:UNIts? Returns the units for periodic measure−...
Page 40 Command Groups Table 2−15: Miscellaneous commands (Cont.) Header Description *DDT Set/query group execute trigger (GET) FACtory Reset to factory default Same as HEADer HEADer Set/query command header Returns identification information *IDN? Returns identification information LANGUAGE Set/query language for display mes− sages LOCk Lock front panel (local lockout)
Page 41: Save And Recall Commands
Command Groups Table 2−16: RS−232 commands Header Description RS232? Query RS232 parameters RS232:BAUd Set/query baud rate RS232:HARDFlagging Set/query hard flagging RS232:PARity Set/query parity type RS232:SOFTFlagging Set/query soft flagging RS232:TRANsmit:TERMinator Set/query end−of−line terminator Save and Recall Commands Save and Recall commands allow you to store and retrieve internal waveforms and settings.
Page 42: Status And Error Commands
Command Groups Status and Error Commands Status and error commands let you determine the status of the oscilloscope and control events. Several commands and queries are common to all devices on the GPIB bus. These commands and queries are defined by IEEE Std. 488.2–1987 and Tek Standard Codes and Formats 1989, and begin with an asterisk (*) character.
Page 43: Trigger Commands
Command Groups Trigger Commands Trigger commands control all aspects of oscilloscope triggering. The two types of triggers are edge and video. Edge triggering is the default type. Edge triggering lets you acquire a waveform when the signal passes through a voltage level of your choosing. Video triggering adds the capability of triggering on video fields and lines.
Page 44: Vertical Commands
Command Groups Table 2−19: T rigger commands (Cont.) Header Description TRIGger:MAIn:VIDeo? Query video trigger parameters TRIGger:MAIn:VIDeo:LINE Set/query video trigger line TRIGger:MAIn:VIDeo:POLarity Set/query video trigger polarity TRIGger:MAIn:VIDeo:SOUrce Set/query video trigger source TRIGger:MAIn:VIDeo:STANdard Set/query video trigger standard TRIGger:MAIn:VIDeo:SYNC Set/query video trigger sync TRIGger:STATE? Return trigger system status TDS1000 and TDS2000 series only.
Page 45: Waveform Commands
Command Groups Table 2−20: V ertical commands (Cont.) Header Description CH<x>:VOLts Same as CH<x>:SCAle SELect:<wfm> Set/query waveform display state All oscilloscope, firmware version, and module combinations except TDS210 and TDS220 with firmware below V 2.00 and a TDS2CMA communications module. Waveform Commands Waveform commands let you transfer waveform data points to and from the oscilloscope.
Page 46 Command Groups Table 2−21: W aveform commands (Cont.) Header Description DATa:STARt Set/query the starting point in waveform transfer DATa:STOP Set/query the ending point in waveform transfer DATa:TARget Same as DATa:DESTination DATa:WIDth Set/query the byte width of waveform points WAVFrm? Returns waveform preamble and curve data WFMPre? Returns waveform preamble...
Page 47: Waveform Data Formats
WFMPre:<wfm>:YUNit Set/query the vertical units WFMPre:<wfm>:YZEro? Set/query the waveform conversion factor TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurement module. Waveform Data Formats Internally, the oscilloscope uses one 8-bit data byte to represent each waveform data point, regardless of the acquisition mode.
Page 48 Command Groups When DATa:WIDth is set to two: H If sending data, the oscilloscope mulitplies each point by 256; the most significant byte then has meaningful data and the least significant byte is 0 H If receiving data, the oscilloscope truncates the data (divides by 256) and saves the most significant byte NOTE.
Page 49: Waveform Data Record
Command Groups Table 2−22: Binary data ranges Byte width Signed integer range Positive integer range –128 to 127 0 to 255 –32,768 to 32,767 0 to 65,535 The defined binary formats also specify the order in which the bytes are transferred giving a total of four binary formats: RIBinary, RPBinary, SRIbinary, and SRPbinary.
Page 50: Waveform Data Locations And Memory Allocation
Command Groups Waveform Data Locations and Memory Allocation The DATa:SOUrce command specifies the location of the data when transferring waveforms from the oscilloscope. You can transfer one waveform at a time. You can transfer only one waveform into the oscilloscope at a time. Each waveform is stored in one of two stored waveform locations for 2-channel models or one of four stored waveform locations for 4-channel models.
Page 51 Command Groups 3. Use the DATa:WIDth command to specify the number of bytes per data point. 4. Use the DATa:STARt and DATa:STOP commands to specify the portion of the waveform that you want to transfer. 5. Use the WFMPRe? command to transfer waveform preamble information.
Page 52 Command Groups TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−34...
Page 53: Command Descriptions
Command Descriptions Commands either set or query oscilloscope values. Some commands both set and query, some only set, and some only query. Manual Conventions This manual uses the following conventions: H No Query Form indicates set-only commands H A question mark (?) appended to the command and Query Only indicates query-only commands H Fully spells out headers, mnemonics, and arguments with the minimal spelling shown in upper case;...
Page 54 Command Descriptions Returns Returns current acquisition parameters. Examples ACQuire? might return the string :ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMAVG 16 for the current acquisition parameters. ACQuire:MODe Sets or queries the oscilloscope acquisition mode. This affects all live waveforms and is equivalent to setting the Mode option in the Acquire menu.
Page 55 Peak Detect mode does not reset the value NOTE. Any change made when in Average mode aborts the acquisition and resets ACQuire:NUMACq to zero. H TDS200 series: changing the vertical position does not reset the value TDS200/1000/2000 Series Oscilloscope Programmer Manual...
Page 56 Command Descriptions H TDS1000 and TDS2000 series: if the Trigger mode is set to Auto, and the Horizontal Scale is 10 ms/div or slower, changing the vertical position does not reset the value NOTE. In Scan mode, ACQuire:NUMACq? always returns zero. Group Acquisition Syntax...
Page 57 Command Descriptions Arguments <NR1> is the number of waveform acquisitions. Correct values are 4, 16, 64, and 128. Examples ACQuire:NUMAVg 16 specifies that an averaged waveform will show the result of combining 16 separately acquired waveforms. ACQuire:NUMAVg? might return 64, indicating that there are 64 acquisitions specified for averaging.
Page 58 Command Descriptions ON | RUN | <NR1> ≠ 0 starts acquisition and display of waveforms. If the command was issued in the middle of an acquisition sequence (for instance averaging), RUN restarts the sequence, discarding any data accumulated before the STOP. It also resets the number of acquisitions.
Page 59 Command Descriptions SEQuence specifies “single sequence” operation, where the oscilloscope stops after it has acquired enough waveforms to satisfy the conditions of the acquisition mode. For example, if the acquisition mode is set to sample, the oscilloscope stops after digitizing a waveform from a single trigger event. However, if the acquisition mode is set to average 64 waveforms, then the oscillo- scope stops only after acquiring all 64 waveforms.
Page 60 Command Descriptions <Event Code><Comma><QString>[<Comma><Event Code><Comma><QString>...] <QString>::= <Message>;[<Command>] <Command> is the command that caused the error and may be returned when a command error is detected by the oscilloscope. As much of the command is returned as possible without exceeding the 60 character limit of the <Message>...
Page 61 Command Descriptions AUTOSet:SIGNAL? (Query Only) NOTE. You can use this command ONLY with the TDS1000 and TDS2000 series. Returns the type of signal discovered by the most recent execution of Autoset. Group Miscellaneous Syntax AUTOSet:SIGNAL? Returns { LEVEL | SINE | SQUARE | VIDPAL | VIDNTSC | OTHER | NONE } LEVEL The oscilloscope discovered a DC level.
Page 62 Command Descriptions AUTOSet:VIEW NOTE. You can use this command ONLY with the TDS1000 and TDS2000 series. Sets and queries the current view. If the current menu is not the Autoset menu, or if the view is not valid for the detected waveform, the set command causes the oscilloscope to generate error 221 (Settings conflict).
Page 63 Command Descriptions Video signal display that is synced on odd fields. EVEN Video signal display that is synced on even fields. LINE Video signal display synced on all lines. LINENum Video signal display synced on the specified line number. DCLIne Query response when the oscilloscope found a DC level.
Page 64 Command Descriptions Examples BUSY? might return 1, indicating that the oscilloscope is busy. Related Commands *OPC, *WAI *CAL? (Query Only) Performs an internal self-calibration and returns its status. This is equivalent to selecting the Do Self Cal option in the Utility menu. Although *CAL? is a query command, it does perform an action.
Page 65 Command Descriptions Related Commands CALibrate:INTERNAL CALibrate:ABOrt (No Query Form) NOTE. You should only use this command in a qualified service environment. For more information about the factory calibration sequence, refer to the sevice manual for your oscilloscope. Aborts the factory calibration process. When you abort the factory calibration, the oscilloscope restores the calibration settings to the previous factory calibration constants stored in non-volatile memory.
Page 66 Command Descriptions Syntax CALibrate:CONTINUE Examples CALibrate:CONTINUE performs the next step in the factory calibration operation. CALibrate:FACtory (No Query Form) NOTE. You should only use this command in a qualified service environment. For more information about the factory calibration sequence, refer to the service manual for your oscilloscope. Starts the oscilloscope’s internal factory calibration operation.
Page 67 Command Descriptions CALibrate:INTERNAL (No Query Form) Performs an internal self-calibration but does not return any status. This is equivalent to selecting the Do Self Cal option in the Utility menu. NOTE. The self-calibration can take several minutes to complete. During this time, the oscilloscope does not execute any commands. Disconnect all signals from the oscilloscope before performing an internal self-calibration.
Page 68 Command Descriptions FAIL indicates that the oscilloscope detected errors during the last calibration operation, or that no calibration operations have been performed since power up. Examples CALibrate:STATUS? might return CALIBRATE:STATUS FAIL if the oscilloscope failed the last calibration operation. CH<x>? (Query Only) Returns the oscilloscope vertical parameters.
Page 69 20 MHz. TDS200 Series At vertical scales of 5 mV/div or less (sensitivity at the BNC; that is, after the probe factor is removed), the full bandwidth is 20 MHz.
Page 70 Command Descriptions CH<x>:COUPling Sets or queries the input attenuator coupling setting of the specified oscilloscope channel. This command is equivalent to setting the Coupling option in the Vertical menu. Group Vertical Syntax CH<x>:COUPling { AC | DC | GND } CH<x>:COUPling? Arguments AC sets the specified oscilloscope channel to AC coupling.
Page 71 Command Descriptions Group Vertical Syntax CH<x>:INVert { ON | OFF } CH<x>:INVert? Arguments ON inverts the specified oscilloscope channel. OFF sets the specified oscilloscope channel to non-inverted. Examples CH1:INVert ON inverts the signal on channel 1. CH2:INVert? might return OFF, indicating that channel 2 is not inverted. CH<x>:POSition Sets or queries the vertical position of the specified oscilloscope channel.
Page 72 Command Descriptions Table 2−23: V ertical position ranges using a 1X probe CH<x>:SCAle Position range ±1000 divs 2 mV/div ±400 divs 5 mV/div ±400 divs 10 mV/div ±400 divs 20 mV/div ±400 divs 50 mV/div ±400 divs 100 mV/div ±10 divs 200 mV/div ±100 divs 500 mV/div...
Page 73 Command Descriptions CH<x>:PRObe? Arguments 1 sets the specified oscilloscope channel to 1X attenuation. 10 sets the specified oscilloscope channel to 10X attenuation. 100 sets the specified oscilloscope channel to 100X attenuation. 1000 sets the specified oscilloscope channel to 1000X attenuation. Returns <NR1>...
Page 74 Command Descriptions Examples CH1:SCAle 100E–3 sets the channel 1 gain to 100 mV/div. CH2:SCAle? might return 1.0E0, indicating that the current V/div setting of channel 2 is 1 V/div. Related Commands CH1:VOLts CH<x>:VOLts Sets or queries the vertical gain of the specified channel. This command is identical to the CH<x>:SCAle command and is included for compatibility purposes.
Page 75 Command Descriptions Refer to Registers on page 3-1 for more information. Group Status and Error Syntax *CLS Related Commands DESE, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? CURSor? (Query Only) Returns all current oscilloscope cursor settings. Group Cursor Syntax CURSor? Returns Oscilloscope cursor parameters Examples CURSor?
Page 76 Command Descriptions menu. Setting the function to anything other than OFF causes the Cursor menu to be displayed. NOTE. Setting the display format to XY removes the cursors. Sending the CURSor:FUNCtion command when the display format is XY causes the oscilloscope to generate event 221 (Settings conflict) and leaves the display in XY format.
Page 77 Command Descriptions Syntax CURSor:HBArs? Returns Current horizontal bar cursor settings. Examples CURSor:HBArs? might return CURSOR:HBARS:UNITS VOLTS;POSITION1 0.0E0; POSITION2 0.0E0 CURSor:HBArs:DELTa? (Query Only) Returns the difference (in vertical units) between the two horizontal bar cursors in the oscilloscope display. NOTE. If Trigger View is active, this query returns 9.9E37 and generates event 221 (Settings conflict).
Page 78 Command Descriptions NOTE. If Trigger View is active, the query form returns 9.9E37 and generates event 221 (Settings conflict). Group Cursor Syntax CURSor:HBArs:POSITION<x> <NR3> CURSor:HBArs:POSITION<x>? Arguments <x> specifies which cursor position, and has the value of 1 or 2. <NR3> specifies the horizontal bar cursor position, relative to ground (in volts when the units are volts), relative to the center of the screen (in divs when units are divisions), or relative to 1 V RMS (in decibels when the source is an FFT math waveform), for the...
Page 79 Command Descriptions CURSor:HBArs:UNIts? (Query Only) Returns the vertical scale units for the selected cursor source waveform. Group Cursor Syntax CURSor:HBArs:UNIts? Returns VOLts indicates volts from ground as the unit of measure. DIVs indicates divisions as the unit of measure, with center of screen as 0 divisions and bottom of screen as –4 divisions.
Page 80 Command Descriptions CURSor:SELect:SOUrce? Arguments <wfm> specifies the waveform data source on which cursor measurements will be taken. Examples CURSor:SELect:SOUrce CH1 selects channel 1. CURSor:SELect:SOUrce? might return MATH CURSor:VBArs? (Query Only) Returns the current vertical bar cursor horizontal position and units settings.
Page 81 Command Descriptions NOTE. If Trigger View is active, this query returns 9.9E37 and generates event 221 (Settings conflict). Group Cursor Syntax CURSor:VBArs:DELTa? Returns <NR3> Examples CURSor:VBArs:DELTa? might return 8.92E–1, indicating that the time difference between the vertical bar cursors is 0.892 seconds. CURSor:VBArs:POSITION<x>...
Page 82 Command Descriptions CURSor:VBArs:POSITION<x>? Arguments <x> specifies which cursor to position. Correct values are 1 and 2. <NR3> specifies the cursor position in the units specified by the CURSor:VBArs:UNIts command. The position is relative to the trigger except when the cursor source is a math FFT waveform. The cursor position is limited to the graticule whenever an attempt is made to move it outside the graticule.
Page 83 Command Descriptions HERtz specifies units of frequency (reciprocal of time). Examples CURSor:VBArs:UNIts SECONDS sets the units for the vertical bar cursors to seconds. CURSor:VBArs:UNIts? returns HERTZ when the vertical bar cursor units are Hertz. CURVe Transfers oscilloscope waveform data to and from the oscilloscope in binary or ASCII format.
Page 84 Command Descriptions Refer to Waveform Commands on page 2-27 for a description of the waveform transfer process. Group Waveform Syntax CURVe { <Block> | <asc curve> } CURVe? Arguments <Block> is the waveform data in binary format. The waveform is formatted as: #<x><yyy><data>...
Page 85 Command Descriptions DATa Sets or queries the format and location of the waveform data that is transferred with the CURVe command. Since DATa:DESTination and DATa:TARget are equivalent, only DATa:DESTination is returned by the DATa? query. Group Waveform Syntax DATa { INIT } DATa? Arguments INIT initializes the waveform data parameters to their factory...
Page 86 Command Descriptions DATa:DESTination Sets or queries the reference memory location for storing oscillo- scope waveform data that is transferred into the oscilloscope by the CURVe command. This command is identical to the DATa:TARget command. Group Waveform Syntax DATa:DESTination REF<x> DATa:DESTination? Arguments REF<x>...
Page 87 Command Descriptions Group Waveform Syntax DATa:ENCdg { ASCIi | RIBinary | RPBinary | SRIbinary | SRPbinary } DATa:ENCdg? Arguments ASCIi specifies the ASCII representation of signed integer (RIBinary) data. If this is the value at power-on, the WFMPre values for BN_Fmt, BYT_Or, and ENCdg are set as RP, MSB, and ASC respectively.
Page 88 Command Descriptions Table 2−24: DATa and WFMPre parameter settings WFMPre settings :ENCdg :BN_Fmt :BYT_Or DATa:ENCdg setting ASCIi RIBinary RPBinary SRIbinary SRPbinary Examples DATa:ENCdg RPBINARY sets the data encoding format to be positive integer where the most significant byte is transferred first. DATa:ENCdg? might return SRPBINARY for the format of the waveform data.
Page 89 Command Descriptions Arguments <wfm> is the location of the waveform data that will be transferred from the oscilloscope to the external device. Allowable values are CH<x>, MATH, and REF<x>. Examples DATa:SOUrce REFB specifies that reference waveform REFB will be transferred in the next CURVe? query.
Page 90 Command Descriptions Examples DATa:STARt 10 specifies that the waveform transfer will begin with data point 10. DATa:STARt? might return 214 as the first waveform data point that will be transferred. Related Commands CURVe? DATa:STOP Sets or queries the last data point in the waveform that will be transferred when executing the CURVe? command.
Page 91 CURVe command. This command is equivalent to the DATa:DES- Tination command and is included here for compatibility with older Tektronix oscilloscopes. DATa:WIDth Sets the number of bytes per waveform data point to be transferred when executing the CURVe command.
Page 92 Command Descriptions <NR1> = 2 sets the number of bytes per waveform data point to 2 bytes (16 bits). If DATa:WIDth is set to 2, the least significant byte is always zero. Examples DATa:WIDth 1 sets the data width to 1 byte per data point for CURVe data. Related Commands CURVe, WFMPre:BIT_Nr, WFMPre:BYT_Nr *DDT...
Page 93 Command Descriptions Related Commands *TRG DESE Sets and queries the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether or not events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue. Refer to the Status and Events chapter on page 3-1 for more information.
Page 94 Command Descriptions Examples DESE 209 sets the DESER to binary 11010001, which enables the PON, URQ, EXE, and OPC bits. DESE? might return the string :DESE 186, showing that DESER contains the binary value 10111010. Related Commands *CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB? DIAg:RESUlt:FLAg? (Query Only) Returns the Pass/Fail status from the last diagnostic test sequence execution (those run automatically at power on, or those requested...
Page 95 Command Descriptions DIAg:RESUlt:LOG? (Query Only) Returns the internal results log from the last diagnostic test sequence execution (those run automatically at power on, or those requested through the Service Menu). The list contains all modules and module interfaces that were tested along with the pass or fail status of each. Group Calibration and Diagnostic Syntax...
Page 96 Command Descriptions Examples DISplay? might return :DISPLAY:FORMAT YT;STYLE VECTORS; PERSISTENCE OFF;CONTRAST 50; INVERT OFF DISplay:CONTRast Sets or queries the contrast of the LCD display. This command is equivalent to setting the Contrast option in the Display menu. Group Display Syntax DISplay:CONTRast <NR1>...
Page 97 TDS1000 series. The TDS2000-Series does not have a Display Style option, but accepts the DISplay:INVert command and query for compatibility. The query always returns OFF. The TDS200 series is not supported. Group Display TDS200/1000/2000 Series Oscilloscope Programmer Manual...
Page 98 Command Descriptions Syntax DISplay:INVert { ON | OFF} DISplay:INVert? Arguments OFF chooses a default black-on-white display. ON chooses a white-on-black display. DISplay:PERSistence Sets the length of time that data points are displayed. Group Display Syntax DISplay:PERSistence { 1 | 2 | 5 | INF | OFF } DISplay:PERSistence? Arguments 1 | 2 | 5 specifies the length, in seconds, that the waveform points...
Page 99 Command Descriptions DISplay:STYle Selects how to display the waveform data. This command is equivalent to setting the Type option in the Display menu. Group Display Syntax DISplay:STYle { DOTs | VECtors } DISplay:STYle? Arguments DOTs displays individual data points. VECtors connects adjacent data points. Examples DISplay:STYle VEC sets the display to connect adjacent data points.
Page 100 Command Descriptions Returns Refer to the service manual for your oscilloscope for information about error log message format. ERRLOG:NEXT? (Query Only) Returns the next entry in the error log, or an empty string if the error log is empty or you have reached the end of the log. To start at the top of the error log, run the ERRLOG:FIRST? query to return the first error log message.
Page 101 Command Descriptions Arguments <NR1> is a value in the range from 0 through 255. The binary bits of the ESER are set according to this value. The power-on default for ESER is 0 if *PSC is 1. If *PSC is 0, the ESER maintains its value through a power cycle.
Page 102 Command Descriptions *ESR? (Query Only) Returns the contents of the Standard Event Status Register (SESR). *ESR? also clears the SESR (since reading the SESR clears it). Refer to the Status and Events chapter on page 3-1 for more information. Group Status and Error Syntax *ESR?
Page 103 Command Descriptions Returns <NR1> Examples EVENT? might return the response :EVENT 110, showing that there was an error in a command header. Related Commands ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB? EVMsg? (Query Only) Removes from the Event Queue a single event code associated with the results of the last *ESR? read, and returns the event code along with an explanatory message.
Page 104 Command Descriptions Examples EVMsg? might return the message :EVMSG 110, Command header error" Related Commands ALLEv?, *CLS, DESE, *ESE, *ESR?, EVENT?, *SRE, *STB? EVQty? (Query Only) Returns the number of event codes that are in the Event Queue. This is useful when using ALLEv? since it lets you know exactly how many events will be returned.
Page 105 Command Descriptions Syntax FACtory Setting the oscilloscope to factory default has the following impact on the programming interface: H Clears the Event Status Enable Register H Clears the Service Request Enable Register H Sets the Device Event Status Enable Register to 255 H Sets the Power On Status Clear Flag to TRUE H Enables all Command Headers (HEADer ON) H Sets the macro defined by *DDT to a “zero-length field”...
Page 106 This command is equivalent to pressing the PRINT button on the front panel of the TDS1000 and TDS2000 series or the HARDCOPY button on the front panel of the TDS200 series. HARDCopy? returns format, layout, and port information. NOTE. This command is not IEEE Std 488.2–1987 compatible.
Page 107 Command Descriptions NOTE. Use the *WAI command between HARDCopy STARt commands to ensure that the first hard copy is complete before starting another. Examples HARDCopy ABOrt stops any hard copy output that is in process. Related Commands *WAI HARDCopy:FORMat Sets the hard copy output data format. This command is the same as "...
Page 108 EPSOn sets the hard copy output format to 9-pin or 24-pin dot matrix printer format. INTERLEAF (TDS200 series only) sets the hard copy format data to Interleaf file format. LASERJet sets the hard copy output format to HP LaserJet II printer format.
Page 109 Command Descriptions HARDCopy:INKSaver NOTE. This command ONLY affects the TDS2000 series. Sets the TDS2000 Ink Saver feature to on or off. This command is equivalent to setting the Ink Saver option in the TDS2000 series " " UTILITY Options Printer Setup menu. This command has no effect in TDS1000 oscilloscopes, but is accepted for compatibility.
Page 110 Command Descriptions Syntax HARDCopy:LAYout { LANdscape | PORTRait } HARDCopy:LAYout? Arguments LANdscape specifies that the bottom of the hard copy is along the long side of the piece of paper. PORTRait specifies that the bottom of the hard copy is along the short side of the piece of paper.
Page 111 HARDCopy:PORT? might return RS232 as the selected hard copy output port. This command is identical to the HEADer query and is included for compatibility with other Tektronix oscilloscopes. HEADer Sets and queries the Response Header Enable State that causes the oscilloscope to either include or omit headers on query responses.
Page 112 Command Descriptions HEADer? might return the value 1, showing that the Response Header Enable State is true. Related Commands VERBose HORizontal? (Query Only) Returns all settings for the horizontal commands. The commands HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizon- tal:SCAle, and HORizontal:SECdiv are equivalent, so HORizon- tal:MAIn:SCAle is the value that is returned.
Page 113 Command Descriptions HORizontal:DELay? (Query Only) Returns all settings for the window time base. The commands HORizontal:DELay:SECdiv and HORizontal:DELay:SCAle are equivalent, so only the values for HORizontal:DELay:SCAle are returned. Group Horizontal Syntax HORizontal:DELay? Returns All settings for the window time base Examples HORizontal:DELay? might return :HORIZONTAL:DELAY:POSITION 0.0E0;...
Page 114 Command Descriptions Arguments <NR3> is the position in seconds. This value is the difference between the trigger point and the center graticule. Positive values place the trigger before the center graticule. Examples HORizontal:DELay:POSition 2.0E–6 sets the window position to 2 ms before the center graticule. HORizontal:DELay:POSition? might return –1.0E–3, indicating that the window position is 1 ms after the center graticule.
Page 115 HORizontal:DELay:SECdiv This command is identical to the HORizontal:DELay:SCAle. It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes. HORizontal:MAIn? (Query Only) Returns all settings for the oscilloscope main time base. The HORizontal:MAIn:SECdiv and HORizontal:MAIn:SCAle com- mands are identical so only HORizontal:MAIn:SCAle is returned.
Page 116 Command Descriptions HORizontal:MAIn:POSition Sets or queries the main time base horizontal position. This command is equivalent to adjusting the Horizontal Position when Main is selected from the Horizontal menu. Group Horizontal Syntax HORizontal:MAIn:POSition <NR3> HORizontal:MAIn:POSition? Arguments <NR3> is the position in seconds. This value is the difference between the trigger point and the center graticule.
Page 117 Sets the time per division for the oscilloscope main time base. This command is identical to the HORizontal:MAIn:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes. HORizontal:POSition Sets or queries the main time base horizontal position. This command is identical to the HORizontal:MAIn:POSition command.
Page 118 HORizontal:RECOrdlength? (Query Only) Returns the number of acquisition data points. For TDS200, TDS1000 and TDS2000 series oscilloscopes, this value is always 2500, even in FFT mode. This command is provided to maintain program compatibility with other Tektronix digital oscilloscopes. Group Horizontal Syntax...
Page 119 Command Descriptions HORizontal:SECdiv Sets the time per division for the main time base and is identical to the HORizontal:MAIn:SCAle command. It is included for compati- bility purposes. HORizontal:VIEW Specifies whether the horizontal display uses the Main, Window Zone, or Window view. This is equivalent to setting the View in the Horizontal menu.
Page 120 ID? (Query Only) Returns identifying information about the oscilloscope and its firmware in Tektronix Codes and Formats notation. NOTE. ID? must be the last command when it is part of a concate- nated statement. Otherwise the oscilloscope generates event message 440.
Page 121 Where XX is the module type, CM (communications module) or MM (measurement module). The *IDN? and ID? responses are slightly different. Examples *IDN? might return the response TEKTRONIX,TDS 220,0,CF:91.1CT FV:v1.00 TDS2CM:CMV:v1.00 Related Commands TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−103...
Page 122 Command Descriptions LANGuage Sets or queries the languages that the oscilloscope uses to display information on the screen. This is equivalent to the Language option in the Utility menu. Group Miscellaneous Syntax LANGuage { ENGLish | FRENch | GERMan | ITALian | PORTUguese | SPANish | JAPAnese | KOREan | TRADitionalchinese | SIMPlifiedchinese } LANGuage?
Page 123 Command Descriptions Arguments ALL disables all front-panel controls. NONe enables all front-panel controls. This is equivalent to the UNLock ALL command. Examples LOCk ALL locks the front-panel controls. LOCk? returns NONE when the front-panel controls are enabled by this command. Related Commands UNLock *LRN? (Query Only)
Page 124 Command Descriptions Returns Definition for the math waveform. Examples MATH? returns :MATH:DEFINE CH1 + CH2" if the math waveform is defined as channel 1 plus channel 2. MATH:DEFINE Performs the specified mathematical operation on the input signal or signals. To activate or deactivate the math waveform, use the SELect:<wfm>...
Page 125 Command Descriptions TDS2014 and TDS2024 models; TDS224 model with a TDS2MM measure− ment module. CH1+CH2 CH3+CH4 CH1–CH2 CH2–CH1 CH3–CH4 CH4–CH3 FFT (CH<x> [, <window>]) TDS210 and TDS220 models, firmware below V2.00 with a TDS2CMA communications module. CH1–CH2 CH2–CH1 CH1+CH2 –CH1 –CH2 TDS210 and TDS220 models (firmware below V2.00) with a TDS2MM measurement module.
Page 126 FFT of channel 1 using a Hanning window. NOTE. You can use this example with a TDS1000 or TDS2000 series, as well as a TDS200 series with a TDS2MM measurement module. MATH:FFT:HORizontal:POSition NOTE. You can use this command with a TDS1000 or TDS2000 series, as well as a TDS200 series with a TDS2MM measurement module.
Page 127 MATH:FFT:HORizontal:SCAle NOTE. You can use this command with a TDS1000 or TDS2000 series, as well as a TDS200 series with a TDS2MM measurement module. Sets or queries the FFT math waveform horizontal zoom factor.
Page 128 2.0E0, indicating that the zoom factor setting is X2. MATH:FFT:VERtical:POSition NOTE. You can use this command with a TDS1000 or TDS2000 series, as well as a TDS200 series with a TDS2MM measurement module. Sets or queries the FFT math waveform vertical position.
Page 129 Command Descriptions MATH:FFT:VERtical:SCAle NOTE. You can use this command with a TDS1000 or TDS2000 series, as well as a TDS200 series with a TDS2MM measurement module. Sets or queries the FFT math waveform vertical zoom factor. Group Vertical Syntax MATH:FFT:VERtical:SCAle <NR3>...
Page 130 Command Descriptions Syntax MEASUrement? Returns Oscilloscope measurement parameters Examples MEASUrement? might return the following: :MEASUREMENT:MEAS1:TYPE PERIOD;UNITS s";SOURCE CH1; :MEASUREMENT:MEAS2:TYPE FREQUENCY;UNITS Hz";SOURCE CH1; :MEASUREMENT:MEAS3:TYPE PK2PK;UNITS V";SOURCE CH2; :MEASUREMENT:MEAS4:TYPE MEAN;UNITS V";SOURCE CH2; :MEASUREMENT:IMMED:TYPE CRMS;UNITS V";SOURCE CH1 MEASUrement:IMMed? (Query Only) Returns all immediate measurement setup parameters. Immediate queries and commands are the preferred methods for programming.
Page 131 Command Descriptions MEASUrement:IMMed:SOUrce Sets or queries the source for all immediate measurements. Group Measurement Syntax MEASUrement:IMMed:SOUrce CH<x> MEASUrement:IMMed:SOUrce? Arguments CH<x> is an input channel. Examples MEASUrement:IMMed:SOUrce CH1 specifies channel 1 as the immediate measurement source. MEASUrement:IMMed:TYPe Sets or queries the immediate measurement type. Group Measurement Syntax...
Page 132 MAXImum (TDS1000 and TDS2000 series only) is the value of the largest point in the waveform. RISe (TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurement module only) is the rise time between 10% and 90% of the first rising edge of the waveform. Rising edge must be displayed to measure.
Page 133 Command Descriptions MEASUrement:IMMed:UNIts? (Query Only) Returns the units for the immediate oscilloscope measurement. Group Measurement Syntax MEASUrement:IMMed:UNIts? Returns <QString> returns V" for volts, s" for seconds, or Hz" for Hertz. Examples MEASUrement:IMMed:UNIts? might return s", indicating that the unit for the immediate measurement is seconds.
Page 134 *ESR?, EVENT?, ALLEv? MEASUrement:MEAS<x>? (Query Only) Returns all measurement parameters for the displayed oscilloscope periodic measurement specified by <x>, where <x> is 1 through 4 for the TDS200 series, and 1 through 5 for the TDS1000 and TDS2000 series. Group Measurement TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−1 16...
Page 135 Command Descriptions Syntax MEASUrement:MEAS<x>? Returns Settings for the specified measurement source. Examples MEASUrement:MEAS3? might return PERIOD; s";CH1 MEASUrement:MEAS<x>:SOUrce Sets or queries the source for the measurement. This is equivalent to selecting the measurement source in the MEASURE menu. Group Measurement Syntax MEASUrement:MEAS<x>:SOUrce CH<y>...
Page 136 MAXImum (TDS1000 and TDS2000 only) is the value of the largest point in the waveform. RISe (TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurementmodule only) is the rise time between 10% and 90% of the first rising edge of the waveform. Rising edge must be displayed to measure.
Page 137 Command Descriptions FALL (TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurementmodule only) is the fall time between 90% and 10% of the first falling edge of the waveform. Falling edge must be displayed to measure. The oscilloscope automatically calculates the 10% and 90% measurement points.
Page 138 Command Descriptions Examples MEASUrement:MEAS3:UNIts? might return V", indicating the units for measurement 3 are volts. MEASUrement:MEAS<x>:VALue? (Query Only) Returns the value that has been calculated for the oscilloscope on-screen periodic measurement specified by <x>. This value is a display value and will be updated about every 1/2 second if both the MEASURE menu and the MEAS<x>...
Page 139 Command Descriptions Examples MEASUrement:MEAS3:VALue? might return 28.75E6 if measurement number three is frequency. *OPC The *OPC? query and the *OPC set command provide two different methods for checking for the completion of the commands listed in Table 2-21 on page 2-121, such as single sequence acquisitions. The *OPC? query uses a more simple method than the *OPC set command.
Page 140 Command Descriptions Group Status and Error Syntax *OPC *OPC? Examples Using the *OPC? query to check for completion of a single sequence acquisition: ACQuire:STOPAfter SEQUENCE ACQuire:STATE ON *OPC? will return a 1 after the acquisition is complete. Refer to page 3-14 for examples of how to use the *OPC set command.
Page 141 Save and Recall Syntax *RCL <NR1> Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 series) or 1 to 10 (TDS1000 and TDS2000 series), and specifies a setup storage location. TDS200/1000/2000 Series Oscilloscope Programmer Manual...
Page 142 Syntax RECAll:SETUp { FACtory | <NR1> } Arguments FACtory selects the factory setup. <NR1> is a value in the range from 1 to 5 (TDS200 series) or 10 (TDS1000 and TDS2000 series) and specifies a setup storage location. Examples RECALL:SETUp FACtory recalls the front-panel setup to its factory defaults.
Page 143 Command Descriptions REM (No Query Form) Specifies a comment. This line is ignored by the oscilloscope. Group Miscellaneous Syntax REM <QString> Arguments <QString> is a string that can have a maximum of 80 characters. Examples REM This is a comment" is ignored by the oscilloscope.
Page 144 Command Descriptions RS232:BAUd Sets or queries the RS-232C interface transmission speed. If no flow control (flagging) is used, commands may be received faster than the oscilloscope can process them. Also, if another command is sent immediately after this command, without waiting for the baud rate to be programmed, the first couple of characters may be lost.
Page 145 Command Descriptions Group RS-232 Syntax RS232:HARDFlagging { ON | OFF | <NR1> } RS232:HARDFlagging? Arguments <ON> or <NR1>≠ 0 activates hard flagging and turns off soft flagging. <OFF> or <NR1> = 0 deactivates hard flagging (RTS always asserted). Examples RS232:HARDFlagging ON activates hard flagging and deactivates soft flagging.
Page 146 Command Descriptions ODD sets odd parity. NONe sets no parity (no ninth bit transmitted). Examples RS232:PARity EVEN sets even parity. RS232:SOFTFlagging Sets or queries the input and output soft flagging over the RS-232C port. After receiving an XOFF (DC3), the oscilloscope sends two or less characters.
Page 147 Command Descriptions Examples RS232:SOFTFlagging ON activates soft flagging and deactivates hard flagging. RS232:TRANsmit:TERMinator Sets or queries the end-of-line (EOL) terminator. When transmitting, the oscilloscope appends the terminator to the end of each message. When receiving, the oscilloscope accepts all four terminators, regardless of the currently selected terminator.
Page 148 Command Descriptions *RST (No Query Form) (Reset) Returns the oscilloscope to a known set of oscilloscope settings, but does not purge any stored settings. This command executes a subset of the FACtory command. Group Status and Error Syntax *RST Sending the *RST command does the following: H Returns the oscilloscope settings to the factory defaults (refer to Appendix B) H Sets the macro defined by *DDT to a zero-length field...
Page 149 *SAV <NR1> Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 series) or from 1 to 10 (TDS1000 and TDS2000 series) and specifies a memory location. Any settings that have been stored previously at this location are overwritten.
Page 150 Syntax SAVe:SETUp <NR1> Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 series) or 10 (TDS1000 and TDS2000 series) and specifies a memory location. Any settings that have been stored previously at this location are overwritten.
Page 151 Command Descriptions Examples SAVe:WAVEform MATH, REFB saves the math waveform in stored waveform memory location REFB. Related Commands SELect:<wfm> can be used to display a saved reference waveform. SELect? (Query Only) Returns the display status of all waveforms. Group Vertical Syntax SELect? Returns...
Page 152 Command Descriptions SELect:<wfm> Controls the display of waveforms. This command is equivalent to activating or deactivating a waveform from the oscilloscope front panel. Group Vertical Syntax SELect:<wfm> { OFF | ON | <NR1> } SELect:<wfm>? Arguments OFF or <NR1> = 0 deactivates the display of the specified waveform. ON or <NR1>...
Page 153 Command Descriptions Syntax SET? NOTE. The SET? query always returns command headers, regardless of the setting of the HEADer command. This is because the returned data is intended to be able to be sent back to the oscilloscope as concatenated commands. The VERBose command can still be used to specify whether the returned headers should be abbreviated or full length.
Page 154 Command Descriptions Arguments <NR1> is an integer value in the range from 0 to 255. The binary bits of the SRER are set according to this value. Using an out-of-range value causes an execution error. The power-on default for SRER is 0 if *PSC is 1.
Page 155 Command Descriptions Related Commands *CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *SRE *TRG (No Query Form) (Trigger) Executes commands that are defined by *DDT. Group Miscellaneous Syntax *TRG Examples *TRG immediately executes all commands that have been defined by *DDT. Related Commands *DDT TRIGger...
Page 156 Command Descriptions Examples TRIGger FORCe forces a trigger event to occur. TRIGger? might return :TRIGGER:MAIN:MODE AUTO;TYPE EDGE;LEVEL 0.0E0;HOLD− OFF:VALUE 5.0E–7;:TRIGGER:MAIN:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;:TRIGGER:MAIN:VIDEO:SOURCE CH1;SYNC FIELD;POLARITY NORMAL TRIGger:MAIn Sets the oscilloscope trigger level to 50% of the minimum and maximum values of the signal. Returns the current main trigger parameters when used as a query.
Page 157 Command Descriptions TRIGger:MAIn:EDGE? (Query Only) Returns the trigger coupling, source, and slope settings for the edge trigger. Group Trigger Syntax TRIGger:MAIn:EDGE? Returns Trigger coupling, source, and slope settings for the main edge trigger Examples TRIGger:MAIn:EDGE? might return SOURCE CH1;COUPLING DC;SLOPE RISE TRIGger:MAIn:EDGE:COUPling Sets or queries the type of coupling for the edge trigger.
Page 158 Command Descriptions LFRej coupling removes the low-frequency components of the AC signal. NOISErej selects DC low sensitivity. It requires added signal amplitude for more stable, less false triggering. Examples TRIGger:MAIn:EDGE:COUPling DC sets the main edge trigger coupling to DC. TRIGger:MAIn:EDGE:SLOpe Selects a rising or falling slope for the edge trigger.
Page 159 Command Descriptions TRIGger:MAIn:EDGE:SOUrce Sets or queries the source for the edge trigger. This is equivalent to setting the Source option in the Trigger menu. Group Trigger Syntax TRIGger:MAIn:EDGE:SOUrce { CH<x> | EXT | EXT5 | LINE } TRIGger:MAIn:EDGE:SOUrce? Arguments CH<x> specifies one of the allowable input channels. EXT specifies the external input (not available on TDS224 oscillo- scopes).
Page 160 Command Descriptions If the trigger frequency is less than 10 Hz, the query returns 9.9e37 and generates error 2207 (Measurement error, Measurement overflow). If the trigger type is video, the query returns 9.9e37 and generates event 221 (Settings conflict). Group Trigger Syntax TRIGger:MAIn:FREQuency?
Page 161 Command Descriptions Examples TRIGger:MAIn:HOLDOff? might return :TRIGGER:MAIN:HOLDOFF:VALUE 5.0E–7 TRIGger:MAIn:HOLDOff:VALue Sets or queries the oscilloscope trigger holdoff value. Group Trigger Syntax TRIGger:MAIn:HOLDOff:VALue <NR3> TRIGger:MAIn:HOLDOff:VALue? Arguments <NR3> is the main trigger holdoff value, in the range of 500 ns to 10 s. Examples TRIGger:MAIn:HOLDOff:VALue 10 sets the holdoff value to 10 s.
Page 162 Command Descriptions Group Trigger Syntax TRIGger:MAIn:LEVel <NR3> TRIGger:MAIn:LEVel? Arguments <NR3> the main trigger level, in volts. Examples TRIGger:MAIn:LEVel? might return 1.4, indicating that the main edge trigger is set to 1.4 V. TRIGger:MAIn:MODe Sets or queries the trigger mode for the Edge (all models) and Pulse width (TDS1000 and TDS2000 series only) trigger types.
Page 163 Command Descriptions Related Commands ACQuire:STOPAfter TRIGger:MAIn:PULse? (Query Only) NOTE. You can use this command ONLY with the TDS1000 and TDS2000 series. Returns the pulse trigger parameters. Group Trigger Syntax TRIGger:MAIn:PULse? Examples TRIGger:MAIn:PULse? might return :TRIGGER:MAIN:PULSE:SOURCE CH1;WIDTH:POLARITY POSITIVE;WHEN EQUAL;WIDTH 1.0E−3 TRIGger:MAIn:PULse:SOUrce NOTE.
Page 164 Command Descriptions Syntax TRIGger:MAIn:PULse:SOUrce { CH<x> | EXT | EXT5 } TRIGger:MAIn:PULse:SOUrce? Arguments CH<x> specifies one of the allowable input channels. EXT specifies the external input (not available on TDS224 oscillo- scopes). EXT5 specifies the external input attenuated by a factor of 5 (not available on TDS224 oscilloscopes).
Page 165 Command Descriptions TRIGger:MAIn:PULse:WIDth:POLarity NOTE. You can use this command ONLY with the TDS1000 and TDS2000 series. Sets or queries the polarity for the pulse trigger. This is equivalent to setting the Polarity option in the Pulse Trigger menu. Group Trigger Syntax TRIGger:MAIn:PULse:WIDth:POLarity { POSITIVe | NEGAtive }...
Page 166 Command Descriptions TRIGger:MAIn:PULse:WIDth:WHEN? Arguments EQual triggers on the trailing edge of pulses of the specified width. NOTEQual triggers when a pulse’s trailing edge occurs before the specified width, or a pulse continues longer than the specified width without a trailing edge. INside (less than) triggers on the trailing edge of any pulses that are narrower than the specified width.
Page 167 Command Descriptions Examples TRIGger:MAIn:PULse:WIDth:WIDth .000000123 followed by TRIGGER:MAIN:PULse:WIDth:WIDth? might return 1.155E−7 TRIGger:MAIn:TYPe Sets or queries the type of oscilloscope trigger. This is equivalent to setting the Type option in the Trigger menu. Group Trigger Syntax TRIGger:MAIn:TYPe { EDGE | VIDeo | PULse } TRIGger:MAIn:TYPe? Arguments EDGE is a normal trigger.
Page 168 Command Descriptions TRIGger:MAIn:VIDeo? (Query Only) Returns the main video trigger parameters. Group Trigger Syntax TRIGger:MAIn:VIDeo? Examples TRIGger:MAIn:VIDeo? might return :TRIGGER:MAIN:VIDEO:SOURCE CH1;SYNC FIELD;PO− Larity NORMAL TRIGger:MAIn:VIDeo:LINE NOTE. You can use this command ONLY with the TDS1000 and TDS2000 series. Sets or queries the line number for the video trigger when TRIGger:MAIn:VIDeo:SYNC is set to LINENUM.
Page 169 Command Descriptions Examples The following sequence sets the oscilloscope to trigger on video line 123: TRIGger:MAIn:TYPe VIDeo TRIGger:MAIn:VIDeo:SYNC LINENum TRIGger:MAIn:VIDeo:LINE 123 TRIGger:MAIn:VIDeo:POLarity Sets or queries the video trigger polarity. This is equivalent to selecting the Polarity option in the Trigger/Video menu. Group Trigger Syntax...
Page 170 Command Descriptions TRIGger:MAIn:VIDeo:SOUrce Sets or queries the source for the video trigger. This is equivalent to selecting the Source option in the Video trigger menu. Group Trigger Syntax TRIGger:MAIn:VIDeo:SOUrce {CH<x> | EXT | EXT5} TRIGger:MAIn:VIDeo:SOUrce? Arguments CH<x> specifies one of the allowable input channels. EXT specifies the external input (not available with TDS224 oscilloscopes).
Page 171 Command Descriptions Syntax TRIGger:MAIn:VIDeo:STANDard { NTSc | PAL } TRIGger:MAIn:VIDeo:STANdard? Arguments NTSC (default) specifies the NTSC video standard. PAL specifies the PAL or SECAM video standard. Examples TRIGger:MAIn:VIDeo:STANdard NTSC selects the NTSC standard for the video trigger. TRIGger:MAIn:VIDeo:SYNC Sets or queries the type for the video trigger sync. This is equivalent to selecting the Sync option in the Trigger/Video menu.
Page 172 Command Descriptions LINENum (TDS1000 and TDS2000 series only) sets the oscilloscope to trigger on a specific line number, which is specified through TRIGger:MAIn:VIDeo:LINE. Examples TRIGger:MAIn:VIDeo:SYNC FIELD selects the vertical sync pulse for the video trigger sync. TRIGger:STATE? (Query Only) Returns the current state of the triggering system. NOTE.
Page 173 Command Descriptions SAVE indicates that acquisition is stopped or that all channels are off. SCAN indicates that the oscilloscope is in scan mode. Examples TRIGger:STATE? might return READY, indicating that pretrigger data has been acquired and the oscilloscope is waiting for a trigger. Related Commands *OPC? *TST? (Query Only)
Page 174 Command Descriptions Group Miscellaneous Syntax UNLock ALL Arguments ALL specifies all front-panel buttons. Examples UNLock ALL unlocks all front-panel buttons and knobs so they can be used. Related Commands LOCk VERBose Sets and queries the Verbose state that controls the length of keywords on query responses.
Page 175 Command Descriptions Examples VERBose ON sets the Verbose state true. VERBose? might return the value 1, showing that the Verbose state is true. Related Commands HEADer, *LRN?, SET? *WAI (No Query Form) *WAI (wait) prevents the oscilloscope from executing further commands or queries until all pending operations finish.
Page 176 Command Descriptions Group Waveform Syntax WAVFrm? Returns See WFMPre? and CURVe? commands. Related Commands CURVe?, DATa:SOUrce, WFMPre? WFMPre? (Query Only) Returns waveform transmission and formatting parameters for the waveform specified by the DATa:SOUrce command. If the waveform specified by the DATa:SOUrce command is not displayed, the oscilloscope returns only the waveform transmission parameters (BYT_Nr, BIT_Nr, ENCdg, BN_Fmt, BYT_Or).
Page 177 Command Descriptions WFMPre:BIT_Nr Sets or queries the number of bits per waveform point for the waveform to be transferred. Changing the value of WFMPre:BIT_Nr also changes the values of WFMPRe:BYT_Nr and DATa:WIDth. Group Waveform Syntax WFMPre:BIT_Nr <NR1> WFMPre:BIT_Nr? Arguments <NR1> is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8 and DATa:WIDth * 8.
Page 178 Command Descriptions Arguments RI specifies signed integer data-point representation. RP specifies positive integer data-point representation. Examples WFMPre:BN_Fmt RP specifies that the binary waveform data are positive integer data-points. WFMPre:BN_Fmt? returns either RI or RP as the current waveform data format. Related Commands DATa:ENCdg WFMPre:BYT_Nr...
Page 179 Command Descriptions Related Commands DATa:WIDth WFMPre:BYT_Or Sets or queries which byte of binary waveform data is transmitted first during a waveform data transfer when DATa:WIDth or WFMPre:BYT_Nr is set to 2, or WFMPre:BIT_Nr is set to 16. Changing WFMPre:BYT_Or changes DATa:ENCdg. Group Waveform Syntax...
Page 180 Command Descriptions WFMPre:ENCdg Sets or queries the type of encoding for waveform data transferred with the CURVe command. Changing WFMPre:ENCdg also changes DATa:ENCdg. Group Waveform Syntax WFMPre:ENCdg { ASC | BIN } WFMPre:ENCdg? Arguments ASC specifies ASCII curve data. BIN specifies binary curve data. Examples WFMPre:ENCdg ASC specifies that the waveform data is in ASCII format.
Page 181 Command Descriptions When the DATa:SOUrce is not displayed, the TDS210 and TDS220 (firmware below V 2.00) with a TDS2CMA communications module will return a value. All other oscilloscope, firmware version, and module combinations will generate an error and will return event code 2244.
Page 182 Command Descriptions Arguments Y specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record. For Y format, the time (absolute coordinate) of a point, relative to the trigger, can be calculated using the following formula. N ranges from 0 to 2499.
Page 183 The set form of this command is ignored. The query form always returns a 0, unless the DATA:SOUrce waveform is not displayed, in which case the query generates an error and returns event code 2244. This command is included for compatibility with other Tektronix oscilloscopes. Group Waveform...
Page 184 Command Descriptions Examples WFMPre:WFId? For a YT waveform, this might return :WFMPRE:WFID Ch1, DC coupling, 1.0E0 V/div, 5.0E−4 s/div, 2500 points, Sample mode" For a Math waveform, this might return :WFMPRE:WFID Math, DC coupling, 1.0E0 V/div, 5.0E−4 s/div, 2500 points, Sample mode" (For an FFT spectrum (TDS1000 and TDS2000 series, or TDS200 series with a TDS2MM measurement module), this might return :WFMPRE:WFID...
Page 185 DATa:SOUrce CH1 WFMPre:XINcr might return :WFMPRE:XINCR 2.0E−6 WFMPre:XUNit For all model and firmware combinations except the TDS200 series with a TDS2CMA communications module, the set form of this command specifies the horizontal units ("s" for seconds and Hz" for Hertz) for the reference waveform specified by the DATa:DES- Tination command.
Page 186 Command Descriptions Arguments <qstring> is s" or Hz" WFMPre:XZEro The set form of this command specifies the position, in XUNits, of the first sample of the reference waveform specified by the DATa:DESTination command, relative to the trigger. The query form returns the position of the first sample of the waveform specified by the DATa:SOUrce command, if that waveform is active or displayed.
Page 187 Command Descriptions WFMPre:YMUlt YMUlt is a value, expressed in YUNits per digitizer level, used to convert waveform record values to YUNit values using the following formula (where dl is digitizer levels): value_in_YUNits = ((curve_in_dl – YOFF_in_dl) * YMUlt) + YZERO_in_YUNits The set form of this command sets the vertical scale factor of the reference waveform specified by the DATa:DESTination command, expressed in YUNits per digitizing level.
Page 188 Arguments <NR3> is a value expressed in digitizing levels. WFMPre:YUNit For all model and firmware combinations except the TDS200 series with a TDS2CMA communications module or a TDS2MM measurement module, the set form of this command sets the vertical units for the reference waveform specified by DATa:DESTination.
Page 189 Command Descriptions NOTE. It is possible to set a combination of WFMPre:XUNit and WFMPre:YUNit for a reference waveform that is inconsistent (for example, seconds with dB or Hertz with volts). The oscilloscope will not warn you of this condition. The oscilloscope uses WFMPre:XU- Nit to determine whether the waveform is a YT or an FFT.
Page 190 Command Descriptions WFMPre:YZEro For all model and firmware combinations except the TDS210 or TDS220 oscilloscope (firmware below V 2.00) with a TDS2CMA communications module, YZEro is a value, expressed in YUNits, used to convert waveform record values to YUNit values using the following formula (where dl is digitizer levels): value_in_YUNits = ((curve_in_dl –...
Page 191 Command Descriptions WFMPre, Additional Commands for Compatibility The set form of these additional commands is ignored. The query form generates event messages 100 (Command Error) and 420 (Query Unterminated). These commands are included for compati- bility purposes only. Table 2-26 lists additional WFMPre commands. Table 2−26: Additional WFMPre commands Command Argument...
Page 192 Command Descriptions Syntax WFMPre:<wfm>? (Refer to Waveform Mnemonics on page 2-9 for more information.) Returns The format of the response is: :WFMPre:<wfm>:WFID <Qstring>;PT_FMT { ENV | Y }; XINcr <NR3>;PT_Off <NR1>;XZEro <NR3>;XUNit <QString>; YMUlt <NR3>;YZEro <NR3>;YOFF <NR3>;YUNit <QString>; NR_Pt <NR1> WFMPre:<wfm>:NR_Pt? (Query Only) NOTE.
Page 193 Command Descriptions WFMPre:<wfm>:PT_Fmt Same as WFMPre:PT_Fmt, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION. For set commands, if <wfm> is not a reference waveform, the oscilloscope generates error 2241. WFMPre:<wfm>:PT_Off Same as WFMPre:PT_Off, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION.
Page 194 Command Descriptions WFMPre:<wfm>:XUNit Same as WFMPre:XUNit, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION. WFMPre:<wfm>:XZEro Same as WFMPre:XZEro, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION. For set commands, if <wfm> is not a reference waveform, the oscilloscope generates error 2241.
Page 195 Command Descriptions WFMPre:<wfm>:YUNit Same as WFMPre:YUNit, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION. For set commands, if <wfm> is not a reference waveform, the oscilloscope generates error 2241. WFMPre:<wfm>:YZEro Same as WFMPre:YZEro, except that <wfm> specifies the source/destinaton waveform instead of DATa:SOUrce and DATa:DESTINATION.
Page 196 Command Descriptions TDS200/1000/2000 Series Oscilloscope Programmer Manual 2−178...
Page 197 Status and Events...
Page 199 Status and Events The oscilloscope provides a status and event reporting system for the GPIB and RS-232 interfaces. This system informs you of certain significant events that occur within the oscilloscope. The oscilloscope status reporting system consists of five 8-bit registers and two queues.
Page 200: Figure 3-1: The Standard Event Status Register (Sesr)
Status and Events The Standard Event Status Register (SESR). The SESR, shown in Figure 3-1, records eight types of events that can occur within the oscilloscope. Use *ESR? to read the SESR register. Reading the register clears the bits of the register so that the register can accumulate information about new events.
Page 201: Figure 3-2: The Status Byte Register (Sbr)
Status and Events Table 3−1: SESR bit functions (Cont.) Function RQC (Request Control). Not used. 0 (LSB) OPC (Operation Complete). Shows that the operation is complete. This bit is set when all pending operations complete following a *OPC command. See Table 2−25 on page 2−121 for a list of commands that generate an Operation Complete message.
Page 202 Status and Events Table 3−2: SBR bit functions Function 7 (MSB) Not used. RQS (Request Service), obtained from a serial poll. Shows that the oscilloscope requests service from the GPIB controller. MSS (Master Status Summary), obtained from *STB?. Summarizes the ESB and MAV bits in the SBR. ESB (Event Status Bit).
Page 203: Figure 3-3: The Device Event Status Enable Register
Status and Events Use the DESE command to enable and disable the bits in the DESER. Use the DESE? query to read the DESER. Figure 3-3 shows the DESER bit functions. PON URQ CME EXE DDE QYE RQC OPC Figure 3−3: The Device Event Status Enable Register (DESER) The Event Status Enable Register (ESER).
Page 204 Status and Events The Enable Registers and the *PSC Command The *PSC command controls the contents of the Enable Registers at power on. Sending *PSC 1 sets the Enable Registers at power on as follows: H DESER 255 (equivalent to a DESe 255 command) H ESER 0 (equivalent to an *ESE 0 command) H SRER 0 (equivalent to an *SRE 0 command) Sending *PSC 0 lets the Enable Registers maintain their values in...
Page 205: The Event Queue
Status and Events NOTE. When a controller sends a query, an <EOM>, and a second query, the digitizing oscilloscope normally clears the first response and outputs the second while reporting a Query Error (QYE bit in the ESER) to indicate the lost response. A fast controller, however, may receive a part or all of the first response as well.
Page 206: Event Handling Sequence
Status and Events Event Handling Sequence In this description, the numbers in parentheses map to the corre- sponding numbers in Figure 3-6. When an event occurs, a signal is sent to the DESER (1). If that type of event is enabled in the DESER (that is, if the bit for that event type is set to 1), the appropriate bit in the SESR is set to one and the event is recorded in the Event Queue (2).
Page 207: Figure 3-6: Status And Event Handling Process
Status and Events Device Event Status Enable Register (DESER) PON URQ CME EXE DDE QYE RQC OPC Read using DESE? Write using DESE Event Event Queue Event Event Standard Event Status Register (SESR) PON URQ CME EXE DDE QYE RQC OPC Read using *ESR? Cannot be written Event Status Enable Register...
Page 208: Synchronization Methods
Status and Events Synchronization Methods Although most commands are completed almost immediately after being received by the oscilloscope, some commands start a process that requires more time. For example, once a HARDCOPY START command is executed, it may be a few seconds before the hardcopy operation is complete.
Page 209: Using The *Wai Command
Status and Events ACQUIRE:STATE ON Acquiring Waveform Data MEASUREMENT:IMMED:VALUE? Processing Time Figure 3−7: Command processing without using synchronization The acquisition of the waveform must be completed before the measurement can be taken on the acquired data. This is achieved by synchronizing the program so that the measurement command is not processed by the oscilloscope until the acquisition is complete.
Page 210 Status and Events The same command sequence using the *WAI command for synchronization follows: /* Set up single-sequence acquisition */ SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE PK2PK MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the...
Page 211: Using The Busy Query
Status and Events Using the BUSY Query BUSY? allows you to find out whether the oscilloscope is busy processing a command that has an extended processing time, such as single-sequence acquisition. The same command sequence using BUSY? for synchronization follows: /* Set up single-sequence acquisition */ SELECT:CH1 ON ACQUIRE:MODE SAMPLE...
Page 212: Using The *Opc Set Command
Status and Events Using the *OPC Set Command If the corresponding status registers are enabled, the *OPC command sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete. You can use this command in conjunction with either a serial poll or service request handler to achieve synchronization.
Page 213 Status and Events MEASUREMENT:IMMED:VALUE? This technique requires less bus traffic than did looping on BUSY?. Service Request Method (GPIB Only). 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. Also, enable service requests by setting the ESB bit in the Service Request Enable Register (SRER) using the *SRE command.
Page 214: Using The *Opc? Query
Status and Events This technique requires less bus traffic than did looping on BUSY?. The program can now do different tasks such as talk to other devices. The SRQ, when it comes, interrupts those tasks and returns control to this task. /* Take peak-to-peak measurement on acquired data */ MEASUREMENT:IMMED:VALUE? This technique is more efficient but requires more sophisticated...
Page 215: Messages
Status and Events Wait for read from Output Queue. /* Take peak−to−peak measurement on acquired data */ MEASUREMENT:IMMED:VALUE? Using *OPC? synchronization is the simplest approach. It requires no status handling or loops. However, you must set the controller time out for longer than the acquisition operation. Messages Tables 3-3 through 3-9 list all the programming interface messages the oscilloscope generates in response to commands and queries.
Page 216 Status and Events Table 3-4 shows the error messages generated by improper command syntax. Check that the command is properly formed and that it follows the rules in the Command Syntax section starting on page 2-1. Table 3−4: Command error messages – CME bit 5 Code Message Command error...
Page 217 Status and Events Table 3−5: Execution error messages – EXE bit 4 (Cont.) Code Message Trigger ignored Arm ignored Parameter error Settings conflict Data out of range Too much data Illegal parameter value Data corrupt or stale Hardware error Hardware missing Hardware configuration error Hardware I/O device error Expression error...
Page 218 Status and Events Table 3−5: Execution error messages – EXE bit 4 (Cont.) Code Message 2210 Measurement error, No Mid Ref crossing, second waveform 2211 Measurement error, No backwards Mid Ref crossing 2212 Measurement error, No negative crossing 2213 Measurement error, No positive crossing 2214 Measurement error, No crossing 2215...
Page 219 Status and Events Table 3−5: Execution error messages – EXE bit 4 (Cont.) Code Message 2243 Waveform requested is not a data source 2244 Waveform requested is not turned on 2245 Saveref error, Selected channel is turned off 2246 Saveref error, Selected channel data invalid 2248 Saveref error, Source reference data invalid 2260...
Page 220 Status and Events Table 3−6: Device error messages – DDE bit 3 (Cont.) Code Message Framing error in program message (check baud rate) Input buffer overrun (check flagging) Table 3-7 lists the system event messages. These messages are generated whenever certain system conditions occur. Table 3−7: System event messages Code Message...
Page 221 Status and Events Table 3-8 lists warning messages that do not interrupt the flow of command execution. These notify you that you may get unexpected results. Table 3−8: Execution warning messages – EXE Bit 4 Code Message Execution warning String data too long, truncated Parameter underrange Parameter overrange Parameter rounded...
Page 222 Status and Events Table 3-9 lists internal errors that indicate an internal fault in the oscilloscope. Table 3−9: Internal warning messages Code Message Internal warning TDS200/1000/2000 Series Oscilloscope Programmer Manual 3−24...
Page 223: Programming Example
Programming Example...
Page 225 Programming Example The following series of commands and queries illustrate many of the most common commands and techniques. To use these commands and queries over RS232, you will need to use a communications program on your computer, such as tip in the Unix environment, or Hyperterminal in the Microsoft Windows environment.
Page 226 Programming Example > rem "Use the oscilloscope built−in measurements to measure the waveform you acquired." > measu:immed:type mean > measu:immed:value? :MEASUREMENT:IMMED:VALUE 2.4631931782E0 > rem "Be sure to use the *esr? query to check for measurement errors." > measu:immed:type freq > Measu:immed:value? :MEASUREMENT:IMMED:VALUE 9.9E37 >...
Page 227: Appendices
Appendices...
Page 229: Appendix A: Ascii Code Chart
Appendix A: ASCII Code Chart ” & ’ Continued on next page TDS200/1000/2000 Series Oscilloscope Programmer Manual A−1...
Page 230 Appendix A: ASCII Code Chart < − > (RUBOUT) octal ASCII character decimal TDS200/1000/2000 Series Oscilloscope Programmer Manual A−2...
Page 231: Appendix B: Factory Setup
Appendix B: Factory Setup The following listing is the instrument response to the concatenated command FACtory;SET?. This response describes the factory default setup in detail. (Carriage returns have been inserted for clarity.) Items enclosed in ( ) parentheses are returned by the SET? query response, but are not changed by the FACtory command.
Page 232 Appendix B: Factory Setup DC;SLOPE RISE;:TRIGGER:MAIN:VIDEO:SOURCE CH1;SYNC LINE;POLARITY NORMAL;LINE 1;STANDARD NTSC;:TRIGGER:MAIN:PULSE:SOURCE CH1;WIDTH:POLARITY POSITIVE;WHEN EQUAL;WIDTH 1.0E−3;:TRIGGER:MAIN:LEVEL 0.0E0; :SELECT:CH1 1;CH2 0;CH3 0;CH4 0;MATH 0;REFA 0;REFB 0;REFC 0;REFD 0; :CURSOR:FUNCTION OFF;SELECT:SOURCE CH1;:CURSOR:VBARS:UNITS SECONDS;POSITION1 −2.0E−3;POSITION2 2.0E−3;:CURSOR:HBARS:POSITION1 −3.2E0;POSITION2 3.2E0; :MEASUREMENT:MEAS1:TYPE NONE;SOURCE CH1;:MEASUREMENT:MEAS2:TYPE NONE;SOURCE CH1;:MEASUREMENT:MEAS3:TYPE NONE;SOURCE CH1;:MEASUREMENT:MEAS4:TYPE NONE;SOURCE CH1;:MEASUREMENT:MEAS5:TYPE NONE;SOURCE CH1;:MEASUREMENT:IMMED:TYPE PERIOD;SOURCE CH1;...
Page 233 Appendix B: Factory Setup TDS210 and TDS220 Oscilloscopes Items enclosed in < > brackets are present only when the TDS2MM module is installed. :HEADER 1;(:VERBOSE 1;) :DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1; START 1;STOP 2500;WIDTH 1; (:LOCK NONE;) :DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 0; CONTRAST 50;...
Page 234 Appendix B: Factory Setup :MATH:DEFINE "CH1 + CH2"; <FFT:HORIZONTAL:POSITION 5.0E1;SCALE 1.0E0;> <:MATH:FFT:VERTICAL:POSITION 0.0E0;SCALE 1.0E0;> (:HARDCOPY:FORMAT EPSON;PORT CENTRONICS; LAYOUT PORTRAIT;) (:LANGUAGE ENGLISH) TDS224 Oscilloscopes Items enclosed in < > brackets are present only when the TDS2MM module is installed. :HEADER 1;(:VERBOSE 1;) :DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1;...
Page 235 Appendix B: Factory Setup SLOPE RISE;:TRIGGER:MAIN:VIDEO:SOURCE CH1; SYNC LINE;POLARITY NORMAL; :TRIGGER:MAIN:LEVEL 0.0E0; :SELECT:CH1 1;CH2 0;CH3 0;CH4 0;MATH 0;REFA 0; REFB 0;REFC 0;REFD 0; :CURSOR:FUNCTION OFF;SELECT:SOURCE CH1; :CURSOR:VBARS:UNITS SECONDS;POSITION1 −2.0E−3; POSITION2 2.0E−3; :CURSOR:HBARS:POSITION1 −3.2E0;POSITION2 3.2E0; :MEASUREMENT:MEAS1:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS2:TYPE NONE;SOURCE CH1; :MEASUREMENT:MEAS3:TYPE NONE;SOURCE CH1;...
Page 236 Appendix B: Factory Setup TDS200/1000/2000 Series Oscilloscope Programmer Manual B−6...
Page 237: Glossary And Index
Glossary and Index...
Page 239 Glossary ASCII Acronym for the American Standard Code for Information Interchange. Controllers transmit commands to the digitizing oscilloscope using ASCII character encoding. Address A 7-bit code that identifies an instrument on the communication bus. The digitizing oscilloscope must have a unique address for the controller to recognize and transmit commands to it.
Page 240 Glossary Serial Poll A device (such as an oscilloscope) on the GPIB bus can request service from the GPIB Controller by asserting the GPIB SRQ line (a Hardware line that is only present on the GPIB communications bus). When a controller achnowledges the SRQ, it ”serial polls”...
Page 241 DIAG:RESULT:FLAG?, 2-76 ACQUIRE:NUMACQ?, 2-37 DIAG:RESULT:LOG?, 2-77 ACQUIRE:NUMAVG, 2-38 ERRORLOG:FIRST?, 2-81 ACQUIRE:STATE, 2-39 ERRORLOG:NEXT?, 2-82 ACQUIRE:STOPAFTER, 2-40 CH<x>, command mnemonic, 2-8 Address, Tektronix, vii CH<x>?, 2-50 ALLEV?, 2-41 CH<x>:BANDWIDTH, 2-50 Argument, command, 2-3 CH<x>:COUPLING, 2-52 ASCII, 2-1, A-1 CH<x>:INVERT, 2-52 AUTOSET, 2-42 CH<x>:POSITION, 2-53...
Page 242 Index message, 2-2 Common command, 2-24 mnemonic, 2-2 Common GPIB commands *OPC, 3-14 *CAL?, 2-46 query, 2-2 CALIBRATE:CONTINUE, 2-47 separator, 2-3 CALIBRATE:FACTORY, 2-48 set, 2-2 CALIBRATE:INTERNAL, 2-49 synchronizing, 3-10 CALIBRATE:STATUS?, 2-49 syntax, BNF (Backus-Naur *CLS, 2-56 form), 2-1 communications modules, refer- *WAI, 3-11 ences to, vi Command argument...
Page 243 Index CURSOR:VBARS?, 2-62 CURSOR:VBARS:DELTA?, 2-62 Entering commands, 2-5 CURSOR:VBARS:POSITION<x>, 2-63 Entering incorrect numeric argu- CURSOR:VBARS:UNITS, 2-64 ments, 2-10 CURVE, 2-65 EOM (end of message), 2-8 Error message, programming interface, 3-17 ERRORLOG:FIRST?, 2-81 ERRORLOG:NEXT?, 2-82 DATA, 2-67 *ESE, 2-82, 3-5 DATA:DESTINATION, 2-68 ESER register, 2-82, 2-122, 3-5 DATA:ENCDG, 2-68 *ESR?, 2-84...
Page 244 Index HORIZONTAL:TRIGGER: POSITION, 2-101 Hard copy commands MATH:FFT:HORIZONTAL: POSITION, 2-108 HARDCOPY, 2-88 MATH:FFT:HORIZONTAL: HARDCOPY:FORMAT, 2-89 SCALE, 2-109 HARDCOPY:INKSAVER , 2-91 HORIZONTAL?, 2-94 HARDCOPY:LAYOUT, 2-91 HORIZONTAL:DELAY?, 2-95 HARDCOPY:PORT, 2-92 HORIZONTAL:DELAY: HARDCOPY, 2-88 POSITION, 2-95, 2-98, 2-99 Hardcopy command group, 2-18 HORIZONTAL:DELAY:SCALE, HARDCOPY:FORMAT, 2-89 2-96 HARDCOPY:INKSAVER , 2-91...
Page 245 Index Measurement specifier, command mnemonic, 2-9 Manual trigger, simulation with MEASUREMENT?, 2-111 command, 2-137 MEASUREMENT:IMMED?, 2-1 12 Math command group, 2-19 MEASUREMENT:IMMED: MATH?, 2-105 SOURCE1, 2-113 MATH:DEFINE, 2-106 MEASUREMENT:IMMED:TYPE, MATH:FFT:HORIZONTAL: 2-1 13 POSITION, 2-108 MATH:FFT:HORIZON- MEASUREMENT:IMMED: UNITS?, 2-115 TAL:SCALE, 2-109 MEASUREMENT:IMMED: MATH:FFT:VERTICAL:POSI- TION, 2-110...
Page 246 Operation complete wait, 2-157 Register Output queue, 3-6 DESER, 2-75, 2-122, 3-4 ESER, 2-82, 2-122, 3-5 SBR, 2-136, 3-3 SESR, 2-56, 2-84, 2-121, 3-2 Phone number, Tektronix, vii SRER, 2-122, 2-135, 3-5 Power-on status clear command, REM, 2-125 2-122 Reset Preamble, waveform, 2-32...
Page 247 Index RS232:BAUD, 2-126 Setting RS232:HARDFLAGGING, 2-126 command query, 2-105 RS232:PARITY, 2-127 query, 2-105 RS232:SOFTFLAGGING, 2-128 recall command, 2-123 RS232:TRANSMIT:TERMINA- save command, 2-131 TOR, 2-129 Setups, factory setup description, *RST, 2-130 Rules, command entry, 2-5 *SRE command, 2-135, 3-5 Rules, quoted strings, 2-11 SRER register, 2-122, 2-135, 3-5 Status, 3-1 Status and error command group,...
Page 248 Index TDS2CM communications module, Transferring data see TDS2CMA, vi from the oscilloscope, 2-32 TDS2CMA communications mod- to the oscilloscope, 2-33 ule, where to find installation *TRG, 2-137 information, 1-1 TRIGGER, 2-137 TDS2MM measurement module, Trigger command group, 2-25 where to find installation infor- Trigger commands mation, 1-1 TRIGGER, 2-137...
Page 249 TRIGGER:MAIN:VIDEO: TRIGGER:STATE?, 2-154 SOURCE, 2-152, 2-153 *TST? query, 2-155 TRIGGER:MAIN:VIDEO: STANDARD , 2-152 TRIGGER:STATE?, 2-154 TRIGGER:MAIN, 2-138 UNLOCK, 2-155 TRIGGER:MAIN:EDGE?, 2-139 URL, Tektronix, vii TRIGGER:MAIN:EDGE: COUPLING, 2-139 TRIGGER:MAIN:EDGE:SLOPE, 2-140 TRIGGER:MAIN:EDGE: VERBOSE, 2-156 SOURCE, 2-141 Vertical bar cursors, 2-62 TRIGGER:MAIN:FREQUENCY?, Vertical command group, 2-26...
Page 250 WFMPRE:ZOFF, 2-173 DATA, 2-67 WFMPRE:ZUNIT, 2-173 DATA:DESTINATION, 2-68 Waveform preamble, 2-32 DATA:ENCDG, 2-68 WAVFRM?, 2-157 DATA:SOURCE, 2-70 Web site address, Tektronix, vii DATA:START, 2-71 <wfm>, command mnemonic, 2-9 DATA:STOP, 2-72 WFMPRE?, 2-158 DATA:TARGET, 2-73 WFMPRE:<wfm>?, 2-173 DATA:WIDTH, 2-73 WFMPRE:<wfm>:PT_OFF, 2-175 WAVFRM?, 2-157 WFMPRE:<wfm>:YOFF, 2-176...

This manual is also suitable for:

Tds1000 series Tds2000 series Tds1002 Tds1012 Tds2002 Tds2012 ... Show all

Tektronix TDS200 Series Programmer's Manual

Preface

Getting Started

Command Syntax

Table 2-1: BNF Notation

Table 2-2: Command Message Elements

Figure 2-1: Command Message Elements

Table 2-3: Comparison of Header off and Header on

Table 2-4: Types of Numeric Arguments

Table 2-5: Oscilloscope Handling of Incorrect Numeric

Table 2-6: Parts of a Block Argument

Figure 2-2: Block Argument Example

Command Groups

Table 2-7: Acquisition Commands

Table 2-8: Calibration and Diagnostic Commands

Command Descriptions

Figure 3-1: the Standard Event Status Register (SESR)

Programming Example

Appendix A: ASCII Code Chart

Appendix B: Factory Setup

Quick Links

Related Manuals for Tektronix TDS200 Series

Summary of Contents for Tektronix TDS200 Series

This manual is also suitable for:

Table of Contents