Tektronix TDS200 Series Programmer's Manual
  1. Manuals
  2. Brands
  3. Tektronix Manuals
  4. Test Equipment
  5. TDS200 Series
  6. Programmer's manual

Tektronix TDS200 Series Programmer's Manual

Digital oscilloscopes
Hide thumbs Also See for TDS200 Series:
Table of Contents

Advertisement

Quick Links

Programmer Manual
TDS200, TDS1000/TDS2000,
TDS1000B/TDS2000B, and
TPS2000 Series Digital Oscilloscopes
071-1075-04
This document supports:
S TPS2000 Series instruments, any version.
S TDS1000B and TDS2000B Series instruments,
any version.
S TDS2CM or TDS2CMA, any version, when
used in TDS1000 or TDS2000 Series instruments,
any version.
S TDS2MEM any version, when used in most
TDS1000 or TDS2000 Series instruments (except
TDS1001 and TDS2004 models), any version.
S TDS2CM, TDS2CMA, or TDS2MM any
version, when used in a TDS224 instrument, any
version.
S TDS2CM or TDS2CMA version CMV:v1.04
and above, or TDS2MM any version, when used
in TDS210 and TDS220 instruments with
FV:v1.09 and above.
www.tektronix.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TDS200 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Tektronix TDS200 Series

Summary of Contents for Tektronix TDS200 Series

  • Page 1 TDS1001 and TDS2004 models), any version. S TDS2CM, TDS2CMA, or TDS2MM any version, when used in a TDS224 instrument, any version. S TDS2CM or TDS2CMA version CMV:v1.04 and above, or TDS2MM any version, when used in TDS210 and TDS220 instruments with FV:v1.09 and above. www.tektronix.com...
  • Page 2 Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending.

  • Page 3: Table Of Contents

    Table of Contents Preface ..........Related Documents .
  • Page 4 Table of Contents Waveform Data Record ....... 2- - 42 Waveform Data Locations and Memory Allocation .
  • Page 5 Table of Contents List of Figures Figure 2- - 1: Command message elements ....2- - 4 Figure 2- - 2: Block Argument example ....2- - 14 Figure 3- - 1: The Standard Event Status Register (SESR) 3- - 2...
  • Page 6 Table of Contents List of Tables Table 1- - 1: Communications ports and functions ..1- - 1 Table 1- - 2: Oscilloscope, extension module, and adapter compatibility ......1- - 2 Table 2- - 1: Oscilloscope communication protocol .
  • Page 7 Table of Contents Table 2- - 22: Save and Recall commands ....2- - 33 Table 2- - 23: Status and Error commands ....2- - 33 Table 2- - 24: Trigger commands .
  • Page 8 Table of Contents TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer...

  • Page 9: Preface

    Preface This programmer manual provides information on how to remotely operate your TDS200, TDS1000/TDS2000, TDS1000B/TDS2000B, or TPS2000 series oscilloscope. You can use communication ports and protocols, such as for the RS-232, the General Purpose Interface Bus (GPIB), or Universal Serial Bus (USB) standards, to remotely control and operate your oscilloscope.
  • Page 10 Preface For information on the TPS2PWR1 Power Analysis Application, refer to the TPS2PWR1 Power Analysis Application User Manual, an optional accessory available in eleven languages. Language TDS2PWR1 user manual part number English 071-1452-XX French 071-1453-XX Italian 071-1454-XX German 071-1455-XX Spanish 071-1456-XX Japanese 071-1457-XX...
  • Page 11 Preface Traditional Chinese 071-1825-XX Korean 071-1826-XX Russian 071-1827-XX TDS1000 and TDS2000 Series Manuals For general operation, and information on the TDS2CMA Commu- nications module, refer to the TDS1000 and TDS2000 Series Digital Storage Oscilloscope User Manual, a standard accessory. Language TDS1000/TDS2000 user manual part number English 071-1064-XX...
  • Page 12 Preface TDS200 Series Manuals For general operation, refer to the TDS200 Series Digital Real-Time Oscilloscope User Manual, a standard accessory. Language TDS200 series user manual part number English 071-0398-XX French 071-0400-XX Italian 071-0401-XX German 071-0402-XX Spanish 071-0399-XX Japanese 071-0405-XX Portuguese...

  • Page 13: Conventions

    H TDS1000B and TDS2000B Series Digital Storage Oscilloscopes Service Manual (071-1828-XX) H TDS1000 and TDS2000 Series Digital Storage Oscilloscopes Service Manual (071-1076-XX) H TDS200 Series Digital Real-Time Oscilloscopes Service Manual (071-0492-XX) Conventions Refer to the Command Syntax section of the Syntax and Commands chapter (page 2- - 1) for information about command conventions.
  • Page 14 Preface TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer...

  • Page 15: Getting Started

    Getting Started...

  • Page 17: Table 1- 1: Communications Ports And Functions

    Getting Started This manual contains information on how to remotely control and operate your oscilloscope through communications protocol and commands. NOTE. For TDS1000B and TDS2000B series, you need to install the PC Communications software from the CD that came with the oscilloscope on a PC before you connect the oscilloscope USB Device port to the PC.

  • Page 18: Table 1- - 2: Oscilloscope, Extension Module, And

    Getting Started Refer to your oscilloscope user manual (Tektronix part numbers listed on page v) for information on how to install, test, and configure your oscilloscope and module. NOTE. The firmware for the TDS1000B, TDS2000B, and TPS2000 series oscilloscopes includes communications, math, and storage memory functions.

  • Page 19: Syntax And Commands

    Syntax and Commands...

  • Page 21: Command Syntax

    Command Syntax You can control the oscilloscope through the GPIB, RS-232, or USB 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 22: Command And Query Structure

    Command Syntax The Backus Naur Form (BNF) notation is used in this manual to describe commands and queries. Table 2- - 2 lists the BNF notation. Table 2- 2: BNF notation Symbol Meaning Defined element < > Is defined as Exclusive OR Group;...

  • Page 23: Tps2000 Series Oscilloscopes

    Command Syntax Table 2- - 3 lists and describes the five element types. Table 2- 3: Command message elements Symbol Meaning <Header> 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;...

  • Page 24: Enable Registers

    Command Syntax Figure 2- - 1 shows the five command message elements. Header Comma SAVe:WAVEform CH1,REFA Mnemonics Arguments Space Figure 2- 1: Command message elements 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.

  • Page 25: Tds1000 And Tds2000 Series Oscilloscopes

    Command Syntax For example, MEASUrement:MEAS<x>:UNIts? returns the measure- ment units, while MEASUrement:MEAS<x>:TYPe? returns the measurement type selected for the measurement, and MEASUre- ment:MEAS<x>? returns all the measurement parameters for the specified measurement. Headers in Query Responses You can control whether the oscilloscope returns headers as part of the query response.

  • Page 26: Command Entry

    Command Syntax Command Entry Follow these general rules when entering commands: H Enter commands in upper or lower case. H You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).

  • Page 27: The Event Queue

    Command Syntax H If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, the commands ACQuire:MODe AVErage and ACQuire:NUMAVg 16 could be concatenated into a single command: ACQuire:MODe AVErage;...

  • Page 28: Event Handling Sequence

    Command Syntax H Any query that returns arbitrary data, such as ID?, must be the last query when part of a concatenated command. If the query is not last, the oscilloscope generates event message 440. Here are some INVALID concatenation examples: H CH1:COUPling DC;ACQuire:NUMAVg 16 (missing colon before ACQuire) H CH1:COUPling DC;:BANDwidth ON...

  • Page 29: Constructed Mnemonics

    Command Syntax RS-232 End of Message Terminators. RS-232 EOM terminators can be a CR (carriage return), LF (line feed), CRLF (carriage return followed by a line feed), or LFCR (line feed followed by a carriage return). When receiving, the oscilloscope accepts all four combinations as valid input message terminators regardless of the currently selected terminator.

  • Page 30: Synchronization Methods

    Command Syntax Waveform Mnemonics In some commands you can specify a waveform without regard to its type: channel waveform, math waveform, or reference waveform. The “y” is the same as “x” in Reference Waveform Mnemonics. Symbol Meaning <wfm> Can be CH<x>, MATH, or REF<y> Cursor Position Mnemonic When the oscilloscope displays cursors, commands may specify which cursor of the pair to use.

  • Page 31: Argument Types

    Command Syntax 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. Numeric Arguments Many oscilloscope commands require numeric arguments. Table 2- - 5 lists the three types of numeric argument.

  • Page 32: Table 2- - 6: Oscilloscope Handling Of Incorrect

    Command Syntax Table 2- 6: 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 33: Using The Busy Query

    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 34: Using The *Opc Set Command

    Command Syntax Figure 2- - 2 shows an example of a block argument. Block argument *DDT #217ACQuire:STATE RUN Specifies data length Block header 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 35: Command Groups

    The oscilloscope GPIB, USB, 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. The USB interface also conforms to USB Test and Measurement Class, Subclass USB488 Specification, except where noted.

  • Page 36: Calibration And Diagnostic Commands

    Command Groups Calibration and Diagnostic Commands Calibration and Diagnostic commands let you initiate the oscillo- scope self-calibration routines and examine the results of diagnostic tests. Table 2- - 9 lists and describes Calibration and Diagnostic commands. Table 2- 9: Calibration and Diagnostic commands Header Description *CAL?

  • Page 37: Cursor Commands

    Command Groups Cursor Commands Cursor commands provide control over the oscilloscope cursor display and readout. Table 2- - 10 lists and describes Cursor com- mands. Table 2- 10: Cursor commands Header Description CURSor? Return cursor settings CURSor:FUNCtion Set or query the cursors on or off; select cursor type CURSor:HBArs? Return horizontal bar settings...

  • Page 38: Display Commands

    Command Groups Table 2- 10: Cursor commands (Cont.) Header Description CURSor:VBArs:UNIts Set or query the vertical cursors to time or frequency CURSor:VBArs:VDELTa? Return the vertical distance between (TDS1000B, TDS2000B, and cursors TPS2000 only) Display Commands Display commands let you change the graticule style, displayed contrast, and alter other display attributes.

  • Page 39: File System Commands (Tds2Mem Module, Tds1000B, Tds2000B, And Tps2000 Only)

    Command Groups File System Commands (TDS2MEM Module, TDS1000B, TDS2000B, and TPS2000 Only) File system commands perform file management tasks on the CompactFlash (CF) card of TPS2000 oscilloscopes, and TDS models with a TDS2MEM module; and on USB flash drives of TDS1000B and TDS2000B oscilloscopes.

  • Page 40: Hard Copy Commands

    Command Groups File System Conventions Use the following conventions when specifying file paths and file names:: H The default folder (directory) is A:\. H File and folder names have a maximum of 11 characters; eight characters, followed by a period, followed by up to three characters.

  • Page 41: Horizontal Commands

    You can substitute SECdiv for SCAle in all appropriate horizontal commands. This provides program compati- bility with previous Tektronix digitizing oscilloscopes. Table 2- - 14 lists and describes Horizontal commands. Table 2- 14: Horizontal commands...

  • Page 42: Math Commands

    Command Groups Table 2- 14: Horizontal commands (Cont.) Header Description HORizontal:MAIn:SCAle Set or query the main time base time/di- vision HORizontal:MAIn:SECdiv Same as HORizontal:MAIn:SCAle HORizontal:POSition Set or query the position of waveform to display HORizontal:RECOrdlength Return waveform record length HORizontal:SCAle Same as HORizontal:MAIn:SCAle HORizontal:SECdiv Same as HORizontal:MAIn:SCAle...

  • Page 43: Measurement Commands

    Command Groups Table 2- 15: Math commands (Cont.) Header Description MATH:FFT:HORizontal:SCAle Set or query the FFT hori- (TDS200 with a TDS2MM module, TDS1000, zontal zoom factor TDS2000, TDS1000B, TDS2000B, and TPS2000 only) MATH:FFT:VERtical:POSition Set or query the FFT vertical (TDS200 with a TDS2MM module, TDS1000, display position TDS2000, TDS1000B, TDS2000B, and TPS2000 only)

  • Page 44: Table 2- 16: Measurement Commands

    Command Groups Because they are computed only when they are requested, immediate measurements slow the waveform update rate less than displayed measurements. Use the VALue? query to obtain measurement results of either displayed or immediate measurements. Several measurement commands set and query measurement parameters.

  • Page 45: Miscellaneous Commands

    GPIB or USB bus, and the device on the RS-232 interface. These commands and queries are defined by IEEE Std. 488.2–1987 and Tektronix Standard Codes and Formats 1989 and begin with an asterisk (*) character. Table 2- - 17 lists and describes Miscellaneous commands.
  • Page 46 Command Groups Table 2- 17: Miscellaneous commands (Cont.) Header Description AUTOSet:SIGNAL? Return the type of signal found by (TDS1000, TDS2000, TDS1000B, autoset TDS2000B, and TPS2000 only) AUTOSet:VIEW Set or query the Autoset view (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 only) DATE Set or query the date value (TDS2MEM, TDS1000B,...

  • Page 47: Pictbridge Commands (Tds1000B And Tds2000B Only)

    Command Groups Table 2- 17: Miscellaneous commands (Cont.) Header Description UNLock Unlock front panel (local lockout) VERBose Return full command name or minimum spellings with query AUTOSet: ENABLE can be manually set from the Service Diag menu. To access the service diagnostics menu, refer to the TDS1000B and TDS2000B series service manual.

  • Page 48: Power And Battery-Related Commands (Tps2000 Only)

    Command Groups Power and Battery-Related Commands (TPS2000 Only) Power and Battery-Related commands provide battery management functions to a TPS2000 oscilloscope. Table 2- - 19 lists and describes the Power and Battery-Related commands. Table 2- 19: Power and Battery-Related commands (TPS2000 only) Header Description POWer?

  • Page 49: Table 2- 20: Power Measurement Commands (Tps2000 With Tps2Pwr1 Only)

    Command Groups Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1 only) Header Description HARmonics? Return all harmonic parameters HARmonics:ENABle Set or query the harmonics menu on and off HARmonics:FREquency? Return the frequency of the selected harmonic HARmonics:HRMS? Return the frequency of the selected harmonic HARmonics:PERCent? Return the amplitude of the selected harmonic as a percent of the fundamental...
  • Page 50 Command Groups Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1 only) (Cont.) Header Description SWLoss:AVErage:N? Return the number of measurements used to calculate the averaged value for switching loss commands SWLoss:AVErage:TOTAL? Return the sum of the turn-on, turn-off, and conduction switching losses for an Average measurement SWLoss:AVErage:TURNOFF?
  • Page 51 Command Groups Table 2- 20: Power Measurement commands (TPS2000 with TPS2PWR1 only) (Cont.) Header Description SWLoss:TOFFEND Set or query a level on the first falling edge of the current waveform that occurs after the turn-off starts SWLoss:TONEND Set or query a level on the first rising edge of the voltage waveform that occurs after the first falling edge SWLoss:TOFFSTART...

  • Page 52: Rs-232 Commands

    Command Groups RS-232 Commands (TDS200, TDS1000, TDS2000, and TPS2000 Only) RS-232 commands allow you to set or query the parameters that control the RS-232 port. Table 2- - 21 lists and describes RS-232 commands. Table 2- 21: RS-232 commands Header Description RS232? Query RS232 parameters...

  • Page 53: Status And Error Commands

    Command Groups Table 2- 22: Save and Recall commands Header Description *RCL Recall setting RECAll:SETUp Recall saved oscilloscope setting RECAll:WAVEform Recall saved waveform *SAV Save oscilloscope setting SAVe:IMAge Save screen image to file (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 only) SAVe:IMAge:FILEFormat Set screen image file format (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 only)

  • Page 54: Trigger Commands

    Command Groups Table 2- 23: Status and Error commands (Cont.) Header Description DESE Set or query the device event status enable *ESE Set or query the standard event status enable *ESR? Return standard event status register; this is the usual way to determine whether a set command executed without error EVENT?
  • Page 55 Command Groups Table 2- 24: Trigger commands Header Description TRIGger Force trigger event TRIGger:MAIn Set main trigger level to 50%; Query returns main trigger settings TRIGger:MAIn:EDGE? Return edge trigger settings TRIGger:MAIn:EDGE:COUPling Set or query the edge trigger cou- pling TRIGger:MAIn:EDGE:SLOpe Set or query the edge trigger slope TRIGger:MAIn:EDGE:SOUrce Set or query the edge trigger source...

  • Page 56: Vertical Commands

    Command Groups Table 2- 24: Trigger commands (Cont.) Header Description TRIGger:MAIn:TYPe Set or query the main trigger type TRIGger:MAIn:VIDeo? Query video trigger parameters TRIGger:MAIn:VIDeo:LINE Set or query the video trigger line (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 only) TRIGger:MAIn:VIDeo:POLarity Set or query the video trigger polarity TRIGger:MAIn:VIDeo:SOUrce Set or query the video trigger source TRIGger:MAIn:VIDeo:STANdard...

  • Page 57: Waveform Commands

    Command Groups Table 2- 25: Vertical commands (Cont.) Header Description CH<x>:INVert Set or query the channel invert All oscilloscope, firmware version, and module combinations except TDS210 and TDS220 with firmware below V 2.00 and a TDS2CMA communications module. CH<x>:POSition Set or query the channel position CH<x>:PRObe Set or query the channel probe parame- ters...
  • Page 58 Command Groups Table 2- 26: Waveform commands Header Description CURVe Transfer waveform data to or from the oscilloscope DATa Set or query the waveform data format and location DATa:DESTination Set or query the destination for waveforms sent to the oscilloscope DATa:ENCdg Set or query the waveform data encoding method...
  • Page 59 Command Groups Table 2- 26: Waveform commands (Cont.) Header Description WFMPre:NR_Pt Query the number of points in the curve transfer WFMPre:PT_Fmt Set or query the format of curve points WFMPre:PT_Off Query the trigger offset WFMPre:WFId? Query the waveform identifier WFMPre:XINcr Set or query the horizontal sampling interval WFMPre:XUNit...

  • Page 60: Waveform Data Formats

    Command Groups Table 2- 26: Waveform commands (Cont.) Header Description WFMPre:<wfm>:YMUlt Set or query the vertical scale factor WFMPre:<wfm>:YOFf Set or query the vertical position WFMPre:<wfm>:YUNit Set or query the vertical units WFMPre:<wfm>:YZEro? Set or query the waveform conversion (TDS200 with TDS2MM module, factor TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 only)
  • Page 61 Command Groups The oscilloscope can transfer waveform data in either ASCII or binary format. Use the DATa:ENCdg command to specify one of the following formats: H ASCII data is represented by signed integer values. The range of values depends on the byte width specified. One-byte-wide data ranges from –128 to 127.

  • Page 62: Waveform Data Record

    Command Groups RIBinary is signed integer where the most significant byte is transferred first, and RPBinary is positive integer where the most significant byte is transferred first. SRIbinary and SRPbinary correspond to RIBinary and RPBinary respectively but use a swapped byte order where the least significant byte is transferred first.

  • Page 63: Waveform Preamble

    Command Groups NOTE. The oscilloscope stores waveforms that are ≤2500 data points long. The oscilloscope truncates waveforms longer than 2500 data points. Waveform Preamble Each waveform that is transferred has an associated waveform preamble that contains information such as the horizontal scale, vertical scale, and other settings in place when the waveform was created.
  • Page 64 Command Groups To the Oscilloscope. To transfer waveform data to an oscilloscope waveform storage location, follow these steps: 1. Use the DATa:DESTination command to specify the stored waveform location. 2. Use the DATa:ENCdg command to specify the waveform data format. 3.

  • Page 65: 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 exists for commands identified as “Set Only” H A question mark (?) appended to the command and “Query Only”...
  • Page 66 Command Descriptions Syntax ACQuire? Returns Returns current acquisition settings. Examples ACQuire? Might return the following string for the current acquisition: ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMAVG 16 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 67 Command Descriptions Arguments SAMple specifies that the displayed data point value is the first sampled value that was taken during the acquisition interval. The waveform data has 8 bits of precision in all acquisition modes. You can request 16 bit data with a CURVe? query, but the lower-order 8 bits of data will be zero.
  • Page 68 Command Descriptions NOTE. Any change made when in Average mode aborts the acquisition and resets ACQuire:NUMACq to zero. H TDS200: changing the vertical position does not reset the value H TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 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.
  • Page 69 Command Descriptions Syntax ACQuire:NUMAVg <NR1> ACQuire:NUMAVg? Arguments <NR1> is the number of waveform acquisitions. Correct values are 4, 16, 64, and 128. Examples ACQuire:NUMAVg 16 This 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 70 Command Descriptions Arguments OFF | STOP | <NR1> = 0 stops acquisitions. 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.
  • Page 71 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 72 Command Descriptions Returns The event code and message in the following format: <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 73 Command Descriptions Might return :AUTORANGE:SETTINGS BOTH;STATE 1, indicating that Autorange is active and adjusting both the horizontal and vertical settings. AUTORange:STATE (TDS1000B, TDS2000B, and TPS2000 Series Only) Toggles Autorange off and on. Group Miscellaneous Syntax AUTORange:STATE { OFF | ON | <NR1> } AUTORange:STATE? Arguments OFF deactivates the Autorange feature.
  • Page 74 Command Descriptions AUTORange:SETTings (TDS1000B, TDS2000B, and TPS2000 Series Only) Controls the parameters that the Autorange function can adjust. It is equivalent to the option buttons in the Autorange menu. Group Miscellaneous Syntax AUTORange:SETTings { HORizontal | VERTical | BOTH } AUTORange:SETTings? Arguments HORizontal allows Autorange to adjust the horizontal, but not...
  • Page 75 Command Descriptions AUTOSet (Set Only) Causes the oscilloscope to adjust its vertical, horizontal, and trigger controls to display a stable waveform. This command is equivalent to pushing the front-panel AUTOSET button. For a detailed description of the Autoset function, refer to the user manual for your oscilloscope.
  • Page 76 Command Descriptions Group Miscellaneous Syntax AUTOSet:SIGNAL? Returns Might return { LEVEL | SINE | SQUARE | VIDPAL | VIDNTSC | OTHER | NONe } LEVEL if the oscilloscope discovered a DC level. SINE if the oscilloscope discovered a sine-like waveform. SQUARE if the oscilloscope discovered a square-like waveform.
  • Page 77 Command Descriptions Arguments MULTICYcle displays a sine or square wave of several cycles. Default for sine-like and square-like signals. SINGLECYcle displays a sine or square wave of approximately one cycle. FFT displays the FFT of a sine wave. RISING displays the rising edge of a square wave. FALLING displays the falling edge of a square wave.
  • Page 78 Command Descriptions Group Status and error Syntax BUSY? Returns 0 when the oscilloscope is not busy processing any of the commands listed in Table 2- - 30 (*OPC) on page 2- - 170. 1 when the oscilloscope is busy processing one of the commands listed in Table 2- - 30 (*OPC) on page 2- - 170.
  • Page 79 Command Descriptions Syntax *CAL? Returns 0 indicates that the self-calibration completed without any errors detected. Any value other than zero indicates that the self-calibration did not complete successfully or completed with errors. Examples *CAL? Performs a self-calibration and might return 0 to indicate that it completed successfully.
  • Page 80 Command Descriptions Stops the in-process factory calibration procedure. CALibrate:CONTINUE (Set Only) 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. Performs the next step in the factory calibration operation. Group Calibration and Diagnostic Syntax...
  • Page 81 Command Descriptions You can only send synchronization commands or queries (such as *OPC, OPC?, *WAI, BUSY?) while doing a factory calibration. Group Calibration and Diagnostic Syntax CALibrate:FACtory Examples CALibrate:FACtory Starts the factory calibration process. CALibrate:INTERNAL (Set Only) 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.
  • Page 82 Command Descriptions CALibrate:STATUS? (Query Only) Returns the status of the last calibration operation performed (either self- or factory-calibration) since power up. Group Calibration and Diagnostic Syntax CALibrate:STATUS? Returns PASS indicates that the oscilloscope completed the last calibration operation without detecting any errors. FAIL indicates that the oscilloscope detected errors during the last calibration operation, or that no calibration operations have been performed since power up.
  • Page 83 Command Descriptions Returns Oscilloscope vertical settings. Examples CH1? Might return the following string for channel 1: CH1:SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH OFF;PROBE 1.0E0 Related Commands SELect:CH<x> CH<x>:BANdwidth Sets or queries the bandwidth setting of the specified oscilloscope channel. The value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments.
  • Page 84 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 85 Command Descriptions DC sets the specified oscilloscope channel to DC coupling. GND sets the specified oscilloscope channel to ground. Only a flat ground-level waveform is displayed. Examples CH1:COUPlING AC This establishes AC coupling on channel 1. CH2:COUPlING? Might return DC. Indicating that channel 2 is set to DC coupling. CH<x>:CURRENTPRObe (TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the scale factor of the specified channel for current...
  • Page 86 Command Descriptions 10 sets the specified oscilloscope channel to 10X attenuation. 50 sets the specified oscilloscope channel to 50X attenuation. 100 sets the specified oscilloscope channel to 100X attenuation. 1000 sets the specified oscilloscope channel to 1000X attenuation. Returns <NR1> Examples CH2:CURRENTPRObe 1000 This sets channel 2 to 1000X attenuation.
  • Page 87 Command Descriptions 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 88 Command Descriptions Table 2- 28: Vertical position ranges using a 1X probe CH<x>:SCAle Position range ±1000 divs 2 mV/div ±400 divs 5 mV/div ±200 divs 10 mV/div ±100 divs 20 mV/div ±40 divs 50 mV/div ±20 divs 100 mV/div ±10 divs 200 mV/div ±100 divs 500 mV/div...
  • Page 89 Command Descriptions Syntax CH<x>:PRObe { 1 | 10 | 20 | 50 | 100 | 500 | 1000 } CH<x>:PRObe? Arguments 1 sets the specified oscilloscope channel to 1X attenuation. 10 sets the specified oscilloscope channel to 10X attenuation. 20 sets the specified oscilloscope channel to 20X attenuation. (TDS1000B, TDS2000B, and TPS2000 series only) 50 sets the specified oscilloscope channel to 50X attenuation.
  • Page 90 Command Descriptions Group Vertical Syntax CH<x>:SCAle <NR3> CH<x>:SCAle? Arguments <NR3> is the gain, in volts or amps per division. For example, the voltage range is 5 V/div to 2 mV/div when using a 1X voltage probe. 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.
  • Page 91 Command Descriptions CH<x>:YUNit (TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the units of the specified channel. The value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments. Group Vertical Syntax CH<x>:YUNit <QString>...
  • Page 92 Command Descriptions If the *CLS command immediately follows an <EOI>, the Output Queue and MAV bit (Status Byte Register bit 4) are also cleared. MAV indicates information is in the output queue. The device clear (DCL) GPIB control message and the USBTMC INITIATE_CLEAR control message will clear the output queue and also MAV.
  • Page 93 Command Descriptions Might return the following string as the current cursor settings: CURSOR:FUNCTION VBARS;SELECT:SOURCE CH1; :CUR- SOR:VBARS:UNITS SECONDS;POSITION1 0.0E0;POSITION2 4.48E–3;:CURSOR:HBARS:UNITS VOLTS;POSITION1 0.0E0;POSI- TION2 5.0E–1. CURSor:FUNCtion Selects and displays the oscilloscope cursor type. Cursors are attached to the waveform selected by CURSor:SELect:SOUrce. This command is equivalent to setting the Type option in the Cursor menu.
  • Page 94 Command Descriptions Examples CURSor:FUNCtion VBArs Selects vertical bar type cursors. CURSor:HBArs? (Query Only) Returns the current settings for the oscilloscope horizontal bar cursors. Group Cursor Syntax CURSor:HBArs? Returns Current horizontal bar cursor settings. Examples CURSor:HBArs? Might return the following string: CURSOR:HBARS:UNITS VOLTS;POSITION1 0.0E0;...
  • Page 95 Command Descriptions Syntax CURSor:HBArs:DELTa? Returns <NR3> Examples CURSor:HBArs:DELTa? Might return 5.08E0 for the difference between the two cursors. CURSor:HBArs:POSITION<x> Positions a horizontal bar cursor. The value of <x> can vary from 1 through 2. NOTE. If Trigger View is active, the query form returns 9.9E37 and generates event 221 (Settings conflict).
  • Page 96 Command Descriptions NOTE. The source always determines the measurement units. Examples CURSor:HBArs:POSITION1 25.0E–3 Positions one of the horizontal cursors at 25.0 mV (assuming the vertical units are volts). CURSor:HBArs:POSITION2? Might return –6.40E–2, indicating that the second horizontal bar cursor is at –64.0 mV (assuming the vertical units are volts). CURSor:HBArs:UNIts? (Query Only) Returns the vertical scale units for the selected cursor source waveform.
  • Page 97 Command Descriptions VOLTSSQUARED indicates volts squared (V*V) as the unit of measure. (TDS1000B, TDS2000B, and TPS2000 series only) AMPSSQUARED indicates amps squared (A*A) as the unit of measure. (TDS1000B, TDS2000B, and TPS2000 series only) VOLTSAMPS indicates voltage times current (V*A) as the unit of measure.
  • Page 98 Command Descriptions 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. Group Cursor Syntax CURSor:VBArs? Examples CURSor:VBArs? Might return CURSOR:VBARS:UNITS SECONDS; POSITION1 1.00E–6;POSITION2 9.00E–6 CURSor:VBArs:DELTa? (Query Only) Returns the time or frequency difference between the two vertical bar cursors.
  • Page 99 Command Descriptions 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:HDELTa? (Query Only) (TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the time or frequency difference between the two vertical bar cursors.
  • Page 100 Command Descriptions Returns <NR3> Examples CURSor:VBArs:HDELTa? Might return 8.92E–1, indicating that the time difference between the vertical bar cursors is 0.892 seconds. CURSor:VBArs:HPOS<x>? (Query Only) (TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the waveform amplitude at the specified cursor position. The units are specified by the CURSor:HBArs:UNIts query.
  • Page 101 Command Descriptions CURSor:VBArs:POSITION<x> Positions a vertical bar cursor. The unit is specified by the CURSor:VBArs:UNIts command, and can be in units of seconds or frequency (Hertz). If the cursor source is an FFT math waveform, CURSor:VBArs:POSITION is always in Hertz, regardless of the value set by CURSor:VBArs:UNIts.
  • Page 102 Command Descriptions CURSor:VBArs:SLOPE? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the change in amplitude divided by the change in time, as measured between the two cursors. The units are derivable from the CURSor:HBArs:UNIts and CURSor:VBArs:UNIts queries. Group Cursor Syntax...
  • Page 103 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. CURSor:VBArs:VDELTa? (Query Only) (TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the vertical (amplitude) difference between the two vertical bar cursors.
  • Page 104 Command Descriptions CURVe Transfers oscilloscope waveform data to and from the oscilloscope in binary or ASCII format. Each waveform that is transferred has an associated waveform preamble that contains information such as data format and scale. For information about the waveform preamble, refer to WFMPre? (Query Only) on page 2- - 244.
  • Page 105 Command Descriptions CURVe? Arguments <Block> is the waveform data in binary format. The waveform is formatted as: #<x><yyy><data> where <x> is the number of characters in <yyy>. For example, if <yyy> = 500, then <x> = 3, where <yyy> is the number of bytes to transfer. Refer to Block Arguments on page 2- - 13 for more information.
  • Page 106 Command Descriptions DATa? Arguments INIT reinitializes the waveform data settings to their factory defaults. Examples DATa INIT Reinitializes the waveform data settings to their factory defaults: DESTINATION = REFA (=TARGET) ENCDG = RIBINARY SOUrce = CH1 START = 1 STOP = 2500 WIDTH = 1 DATa? Might return the following string:...
  • Page 107 Command Descriptions DATa:DESTination? Arguments REF<x> is the reference memory location where the waveform will be stored. Examples DATa:DESTINATION REFA Stores incoming waveform data into reference memory REFA. DATa:DESTINATION? Might return REFB as the waveform location that is currently selected. Related Commands CURVe? DATa:ENCdg Sets or queries the format of the waveform data.
  • Page 108 Command Descriptions 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. RIBinary specifies signed integer data-point representation with the most significant byte transferred first.
  • Page 109 Command Descriptions Table 2- 29: DATa and WFMPre parameter settings (Cont.) :ENCdg :BN_Fmt :BYT_Or DATa:ENCdg setting 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. Related Commands WFMPre:ENCdg, WFMPre:BN_Fmt, WFMPre:BYT_Or DATa:SOUrce...
  • Page 110 Command Descriptions Examples DATa:SOUrce REFB Specifies that reference waveform REFB will be transferred in the next CURVe? query. DATa:SOUrce? Might return REFA, indicating the source for the waveform data that is transferred using the CURVe? command. Related Commands CURVe?, WFMPre?, WAVFrm? DATa:STARt Sets or queries the starting data point for waveform data transfers.
  • Page 111 Command Descriptions 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. This lets you transfer partial waveforms from the oscilloscope.
  • Page 112 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 113 Command Descriptions Related Commands CURVe, WFMPre:BIT_Nr, WFMPre:BYT_Nr DATE (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the oscilloscope date value. The oscilloscope uses these values to time stamp files saved to the CompactFlash card (TDS2MEM and TPS2000 series only), or to the USB flash drive (TDS1000B and TDS2000B series only), as well as show the time and date on the oscilloscope display.
  • Page 114 Command Descriptions TRG command, or the GET GPIB interface message, or the USBTMC TRIGGER message. Group Miscellaneous Syntax *DDT { <Block> | <QString> } *DDT? Arguments <Block> or <QString> is a complete sequence of program messages. The messages must contain only valid commands that must be separated by semicolons and must follow all rules for concatenating commands (refer to page 2- - 6).
  • Page 115 Command Descriptions Syntax DESE <NR1> DESE? Arguments <NR1> is an integer value in the range from 0 to 255. The binary bits of DESER are set according to this value. For example, DESE 209 sets the DESER to the binary value 11010001 (that is, the most significant bit in the register is set to 1, the next most significant bit to 1, the next bit to 0, and so on).
  • Page 116 Command Descriptions 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 through the Service Menu). Use the DIAg:RESUlt:LOG? query to determine which test(s) has failed. Group Calibration and Diagnostic Syntax DIAg:RESUlt:FLAg?
  • Page 117 Command Descriptions Returns <QString> in the following format: <Status>,<Module name>[,<Status>,<Module name>...] Examples DIAg:RESUlt:LOG? Might return “pass-CPU, pass-ACQ1, pass-EXTENSION” for power-up diagnostics. DISplay? (Query Only) Returns the current display settings. Group Display Syntax DISplay? Returns The current display settings Examples DISplay? Might return :DISPLAY:FORMAT YT;STYLE VECTORS;...
  • Page 118 Command Descriptions Syntax DISplay:BRIGHTness { 100 | 90 | 75| 60 | 45 | 30 | 15 | 0 } DISplay:BRIGHTness? Arguments Sets the display brightness in percent. Examples DISPLAY:BRIGHTNESS 75 Sets the display brightness to 75%. Related Commands DISplay:CONTRast DISplay:INVert DISplay:CONTRast Sets or queries the contrast of the LCD display.
  • Page 119 Command Descriptions Related Commands DISplay:INVert, DISplay:BRIGHTness DISplay:FORMat Sets or queries the oscilloscope display format. This command is equivalent to setting the Format option in the Display menu. Group Display Syntax DISplay:FORMat { XY | YT } DISplay:FORMat? Arguments XY displays the voltage of channel 1 (horizontal axis) against the voltage of channel 2 (vertical axis).
  • Page 120 Utility Options menu for the TDS1000 and TDS1000B series. The TDS2000, TDS2000B, and TPS2000 series do not have a Display Style option, but accept the DISplay:INVert command and query for compatibility. The query always returns OFF. The TDS200 series is not supported. Group Display Syntax...
  • Page 121 Command Descriptions DISplay:PERSistence? Arguments 1 | 2 | 5 specifies the length, in seconds, that the waveform points are displayed on the screen. INF specifies infinite persistence. OFF specifies that persistence is turned off. Returns 0 means that the persistence is turned off. 2 or 5 means that the persistence is set to two or five seconds.
  • Page 122 Command Descriptions Examples DISplay:STYle VEC Sets the display to connect adjacent data points. DISplay:STYle? Might return DOTS indicating that the display shows individual waveform data points. ERRLOG:FIRST? (Query Only) Returns the first entry in the error log, or an empty string if the error log is empty.
  • Page 123 Command Descriptions Returns Refer to the service manual for your oscilloscope for information about error log message format. *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).
  • Page 124 Command Descriptions *ESE? Might return the string *ESE 186, showing that the ESER contains the binary value 10111010. Related Commands *CLS, DESE, *ESR?, EVENT?, EVMsg? *SRE, *STB? *ESR? (Query Only) Returns the contents of the Standard Event Status Register (SESR). *ESR? also clears the SESR (since reading the SESR clears it).
  • Page 125 Command Descriptions EVENT? (Query Only) Returns from the Event Queue an event code that provides information about the results of the last *ESR? read. EVENT? also removes the returned value from the Event Queue. Refer to Event Handling Sequence on page 3- - 8 for for more information. Group Status and Error Syntax...
  • Page 126 Command Descriptions Returns The event code and message in the following format: <Event Code><Comma><QString>[<Event Code><Comma> <QString>...] <QString>::= <Message>;[<Command>] where <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 as possible is returned without exceeding the 60 character limit of the <Message>...
  • Page 127 Command Descriptions Related Commands ALLEv?, EVENT?, EVMsg? FACtory (Set Only) Resets the oscilloscope to its factory default settings. Refer to Appendix B: Factory Setup for a list of the factory default settings. Group Miscellaneous 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...
  • Page 128 Command Descriptions H Calibration data that affects device specifications H Stored settings H Stored waveforms or data H Hard copy parameters H Display messages language selection H Current page of paged menus H SAVE:IMAGE:FILEFORMAT H FILESYSTEM:CWD Examples Refer to Appendix B: Factory Setup. Related Commands *PSC, *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp, SAVe:IMAge:FILEFormat, FILESystem:CWD...
  • Page 129 Command Descriptions Related Commands FILESystem:CWD FILESystem:CWD (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the current working folder path on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only). Group File system Syntax...
  • Page 130 Command Descriptions FILESystem:DELEte (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Deletes the specified file name from the CompactFlash card (TDS2MEM and TPS2000 series only), or from the USB flash drive (TDS1000B and TDS2000B series only). Group File system Syntax FILESystem:DELEte <file path>...
  • Page 131 Command Descriptions Group File system Syntax FILESystem:DIR? Examples FILESystem:DIR? Might return FILESYSTEM:DIR “ALL000”,”ALL001”. Related Commands FILESystem:CWD FILESystem:FORMat (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Formats the CompactFlash card (TDS2MEM and TPS2000 series only) or the USB flash drive (TDS1000B and TDS2000B series only).
  • Page 132 Command Descriptions NOTE. The oscilloscope reads the internal structure of the Compact- Flash card or the USB flash drive every time the card is inserted. The time to complete the read depends on the size of the card and how it was formatted.
  • Page 133 Command Descriptions FILESystem:MKDir (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Creates a folder at the specified location on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only). Group File system Syntax FILESystem:MKDir <folder path>...
  • Page 134 Command Descriptions FILESystem:REName (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Assigns a new name to a file or folder on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only). You can also move a file or folder by specifying the new name in a different folder.
  • Page 135 Command Descriptions Related Commands FILESystem:CWD; FILESystem:RMDir FILESystem:RMDir (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Deletes a folder at the specified location on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only). Group File system Syntax...
  • Page 136 TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series or the HARDCOPY button on the front panel of the TDS200 series. : NOTE. The TDS1000B and TDS2000B series support the HARDCo- py:PORT commands and queries for compatibility with programs designed for earlier oscilloscopes.
  • Page 137 Command Descriptions NOTE. DCL does not clear the output queue once a hard copy is in process. The only way to abort the hard copy process is to send the HARDCopy ABOrt command. The output queue can then be cleared by sending a DCL message.
  • Page 138 Command Descriptions HARDCopy:BUTTON? Arguments PRINTS sets the PRINT button to send the screen image to the current printer port, using the current printer format. SAVESAll sets the PRINT button to save all active oscilloscope information (waveforms, screen image, settings) to files in a new subfolder in the current CompactFlash card folder (TDS2MEM and TPS2000 series only), or in the current USB flash drive folder (TDS1000B and TDS2000B series only).
  • Page 139 Command Descriptions Group Hard copy Syntax HARDCopy:FORMat { BMP | BUBBLEJet | DESKJet | DPU3445 | DPU411 | DPU412 | EPSC60 | EPSC80 | EPSIMAGE | EPSOn | INTERLEAF | JPEG | LASERJet | PCX | RLE | THINKjet | TIFF } HARDCopy:FORMat? Arguments...
  • Page 140 Command Descriptions INTERLEAF (TDS200 series only) sets the hard copy format data to Interleaf file format. JPEG (TDS1000B and TDS2000B series only) sets the hard copy format to JPEG format. LASERJet (TDS200, TDS1000, TDS2000, and TPS2000 series only) sets the hard copy output format to HP LaserJet II printer format.
  • Page 141 Command Descriptions NOTE. This command also controls the format of saved images. Group Hard copy Syntax HARDCopy:INKSaver { ON | OFF } HARDCopy:INKSaver? Arguments OFF prints “WYSIWYG” hard copies, with color waveforms on a black background. ON (default) prints color waveforms on a white background. Examples HARDCopy:INKSaver? Might return ON...
  • Page 142 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 143 Command Descriptions Arguments CENtronics specifies that the hard copy data is sent out the Centronics port. RS232 specifies that the hard copy data is sent out the RS232 port. If you set the port to RS232, and use it to transfer a BMP screen image format file to a PC or other computer, observe the following precaution that the BMP file is a binary file, and therefore does not use linefeeds (hexadecimal 0a) as a terminator.
  • Page 144 Command Descriptions Examples HARmonics? Might return :HARMONICS:ENABLE ON;SETUP AUTOMATIC;SHOW ALL;SELECT 1;SOURCE CH1, indicating that the oscilloscope is acquiring and showing all harmonics and measuring the first harmonic from channel 1. HARmonics:ENABle (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Turns the harmonics measurement on or off. Group Power Measurement Syntax...
  • Page 145 Command Descriptions Group Power Measurement Syntax HARmonics:FREquency? Returns <NR3> Examples HARmonics:FREquency? Might return 3.60576923E2, indicating that the frequency of the selected harmonic is 360.57 Hz. Related Commands HARmonics:SELect HARmonics:HRMS? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the RMS amplitude of the selected harmonic in the same units as the source waveform.
  • Page 146 Command Descriptions Related Commands HARmonics:SELect HARmonics:PERCent? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the amplitude of the selected harmonic as a percent of the fundamental. Group Power Measurement Syntax HARmonics:PERCent? Examples HARmonics:PERCent? Might return 5.0, indicating that the amplitude of the selected harmonic as a percent of the fundamental frequency is 5.0%.
  • Page 147 Command Descriptions Examples HARmonics:PHAse? Might return 45.0, indicating that the phase of the selected harmonic, relative to the fundamental frequency, is 45 degrees. Related Commands HARmonics:SELect HARmonics:RMS? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the amplitude of the harmonics source in RMS. This may be or I depending on the type of source waveform.
  • Page 148 Command Descriptions H Frequency H Phase angle NOTE. You can view the contents of the saved file on your personal computer. You cannot recall saved harmonics files to the oscillo- scope. Group Power Measurement Syntax HARmonics:SAVe <file path> Arguments <file path> specifies the full path to save harmonic measurement data.
  • Page 149 Command Descriptions Syntax HARmonics:SELect <NR1> HARmonics:SELect? Arguments <NR1> specifies the harmonic from 1 to 50. Examples HARmonics:SELect 1 Instructs the oscilloscope to select the first harmonic. HARmonics:SELect? Might return 3, indicating that the third harmonic is selected. Related Commands HARmonics:SHOW HARmonics:SETUp (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries the operating mode of harmonics measurements.
  • Page 150 Command Descriptions Examples HARmonics:SETUp? Might return AUTOMATIC. HARmonics:SHOW (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or returns the type of displayed harmonics. Group Power Measurement Syntax HARmonics:SHOW { ALL | ODD | EVEN } HARmonics:SHOW? Arguments ALL displays both odd and even harmonics. ODD displays odd harmonics only.
  • Page 151 Command Descriptions HARmonics:SOUrce (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets the source in the power menu. Group Power Measurement Syntax HARmonics:SOUrce { CH<x> } HARmonics:SOUrce? Arguments CH<x> is one of the allowable input channels. The value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments.
  • Page 152 HARmonics:THDR? Might return 1.1094271493299E1, indicating that the harmonic distortion is 11.09% of the RMS input voltage. This command is identical to the HEADer query and is included for compatibility with other Tektronix oscilloscopes. TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer 2- 132...
  • Page 153 Command Descriptions HEADer Sets and queries the Response Header Enable State that causes the oscilloscope to either include or omit headers on query responses. This command does not affect IEEE Std 488.2–1987 Common Commands (those starting with an asterisk); they never return headers.
  • Page 154 Command Descriptions 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. The commands HORizontal:MAIn:POSition and HORizontal:POSi- tion are equivalent, so HORizontal:MAIn:POSition is the value that is returned.
  • Page 155 Command Descriptions Syntax HORizontal:DELay? Returns All settings for the window time base Examples HORizontal:DELay? Might return :HORIZONTAL:DELAY:POSITION 0.0E0; SCALE 5.0E–4 HORizontal:DELay:POSition Sets or queries the window time base horizontal position. This command is equivalent to adjusting the Horizontal Position when Window Zone or Window is selected from the Horizontal menu.
  • Page 156 Command Descriptions HORizontal:DELay:SCAle Sets the time per division for the oscilloscope window time base. This command is equivalent to setting SEC/DIV when Window Zone or Window is selected from the Horizontal menu. Group Horizontal Syntax HORizontal:DELay:SCAle <NR3> HORizontal:DELay:SCAle? Arguments <NR3> is the time per division. The range depends on the oscillo- scope model.
  • Page 157 Command Descriptions 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 158 Command Descriptions HORizontal:MAIn:POSition? 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:MAIn:POSition 2.0E–6 Sets the main trigger position to 2 s before the center graticule. HORizontal:MAIn:POSition? Might return -1.0E-3, indicating that the main trigger position is 1 ms after the center graticule.
  • Page 159 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 160 Returns the number of acquisition data points. For TDS200, TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 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 161 HORizontal:VIEW MAIn specifies the default horizontal view. 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 part of a concatenated statement. Otherwise the oscilloscope generates event message 440.
  • Page 162 Command Descriptions Group Status and Events Syntax Returns Returns the oscilloscope identification in the following format for TDS2CM, TDS2CMA, and TDS2MM modules: ID TEK/<model number>,CF:91.1CT,FV:v<oscilloscope firmware version number>,TDS2XX:XXV:v<module firmware version number> Where XX is the module type, CM (TDS2CM or TDS2CMA communications module) or MM (measurement module).
  • Page 163 *IDN? Returns Returns the oscilloscope identification in the following format for TDS2CM, TDS2CMA, and TDS2MM modules: TEKTRONIX, <model number>,CF:91.1CT FV:v<oscilloscope firmware version number>,TDS2XX:XXV:v<module firmware version number> Where XX is the module type CM (TDS2CM or TDS2CMA communications module) or MM (measurement module).
  • Page 164 FV:v<oscilloscope firmware version number> Examples *IDN? Might return the following response with a TDS2CMA installed: ID TEKTRONIX,TDS 220,0,CF:91.1CT FV:v2.12 TDS2CM:CMV: v1.04 Might return the following response with a TDS2MEM installed: ID TEKTRONIX,TDS 2022,0,CF:91.1CT TDS2MEM:FV:v6.00 Might return the following response for a TPS2012 oscilloscope with a TPS2PWR1 power analysis module installed: TEKTRONIX,TPS 2012,0,CF:91.1CT FV:v9.48 TPS2PWR1:v1.00...
  • Page 165 Command Descriptions Related Commands LANGuage Sets or queries the languages that the oscilloscope uses to display information on the screen. This is equivalent to setting the Language option in the Utility menu. Group Miscellaneous Syntax LANGuage { ENGLish | FRENch | GERMan | ITALian | SPANish | JAPAnese | PORTUguese | KOREan | TRADitionalchinese | SIMPlifiedchinese } LANGuage?
  • Page 166 Command Descriptions Syntax LOCk { ALL | NONe } LOCk? 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.
  • Page 167 Command Descriptions Syntax MATH? Returns Definition for the math waveform. Examples MATH? Might return the following for an FFT waveform: :MATH:DEFINE ”FFT(CH1,HANNING)”;VERTICAL:POSITION 0.0E0;SCALE 1.0E0;:MATH:FFT:HORIZONTAL:POSITION 5.0E1;SCALE 1.0E0;:MATH:FFT:VERTICAL:POSITION 0.0E0;SCALE 1.0E0 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 168 Command Descriptions Arguments <QString> specifies a math waveform, and can be one of the following: TDS1001, TDS1002, TDS1012, TDS2002, TDS2012 and TDS2022 models; TDS210 and TDS220 models (firmware V2.00 and above) with a TDS2MM measurement module. CH1+CH2 CH1–CH2 CH2–CH1 FFT (CH<x> [, <window>]) TDS2004, TDS2014 and TDS2024 models;...
  • Page 169 Command Descriptions TDS210 and TDS220 models (firmware V2.00) and above with a TDS2CMA communications module. CH1+CH2 CH1–CH2 CH2–CH1 TDS224 model with a TDS2CMA communications module. CH1+CH2 CH3+CH4 CH1–CH2 CH2–CH1 CH3–CH4 CH4–CH3 TDS1000B, TDS2000B, and TPS2000 Series. CH1+CH2 CH3+CH4 (4-channel models) CH1–CH2 CH2–CH1 CH3–CH4 (4-channel models)
  • Page 170 NOTE. You can use this example with a TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series oscilloscope, as well as a TDS200 series oscilloscope with a TDS2MM measurement module. MATH:FFT? (Query Only) NOTE. You can use this command with a TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 oscilloscope, as well as a TDS200 oscilloscope with a TDS2MM measurement module.
  • Page 171 Command Descriptions Group Math Syntax MATH:FFT:HORizontal:POSition <NR3> MATH:FFT:HORizontal:POSition? Arguments <NR3> specifies the point in the FFT waveform data record to display at the center vertical graticule line. The data record point is a percentage of the total record length, in the range of 0 to 100. The default value is 50.
  • Page 172 Command Descriptions Syntax MATH:FFT:HORizontal:SCAle <NR3> MATH:FFT:HORizontal:SCAle? Arguments <NR3> specifies the horizontal magnification factor, where the axis of magnification is the center vertical graticule line. Valid zoom factors are 1, 2, 5, and 10. If other values are entered the oscilloscope rounds the value of <NR3>...
  • Page 173 Command Descriptions Examples MATH:FFT:VERtical:POSition 2 Sets the FFT waveform vertical position to 2 major divisions above the center horizontal graticule line. MATH:FFT:VERtical:POSition? Might return 5, indicating that the FFT waveform 0 reference point is 5 major divisions from the center horizontal graticule line. MATH:FFT:VERtical:SCAle NOTE.
  • Page 174 Command Descriptions Might return 2.0E0, indicating that the zoom factor setting is X2. MATH:VERtical? (Query Only) (TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the MATH:VERtical display settings. Group Math Syntax MATH:VERtical? Examples MATH:VERtical? Might return :MATH:VERTICAL:POSITION 0.0E0;SCALE 5.0E-1, indicating the math waveform position and scale. MATH:VERtical:POSition (TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or returns the math waveform display position.
  • Page 175 Command Descriptions Examples MATH:VERtical:POSITION? Might return -3.0E0, indicating that the math waveform is 3 divisions below center screen. MATH:VERtical:SCAle (TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or returns the math waveform display scale in units per division. It is not possible to use this command to set the math scale to a fine scale not achievable from the front panel.
  • Page 176 Command Descriptions Syntax MEASUrement? Returns Oscilloscope measurement settings. 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 177 Command Descriptions MEASUrement:IMMed:SOUrce1 Sets or queries the source for single-source immediate measure- ments. Group Measurement Syntax TDS1000B, TDS2000B, and TPS2000 series: MEASUrement:IMMed:SOUrce1 { CH<x> | MATH } MEASUrement:IMMed:SOUrce1? Arguments CH<x> specifies the measurement source channel as one of the input channels.
  • Page 178 Command Descriptions Group Measurement Syntax MEASUrement:IMMed:SOURCE2 { CH<x> | MATH } MEASUrement:IMMed:SOURCE2? Arguments CH<x> specifies the measurement source channel as one of the input channels. The value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments. For power analysis, Source2 must be Amperes.
  • Page 179 TPS2000 series only) is the value of the largest point in the waveform. RISe ( TDS200 series with a TDS2MM measurement module, TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series only) is the rise time between 10% and 90% of the first rising edge of the waveform.
  • Page 180 Command Descriptions PWIdth (TDS200 series with a TDS2MM measurement module, TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series only) is the positive pulse width between the first rising edge and the next falling edge at the waveform 50% level. Rising and falling edges must be displayed to measure.
  • Page 181 Command Descriptions PHAse (TPS2000 series with TPS2PWR1 Power Analysis Module only) is the measurement of phase between source 1 and source 2, in degrees. Examples MEASUrement:IMMed:TYPe FREQuency Defines the immediate measurement to be a frequency measurement. MEASUrement:IMMed:UNIts? (Query Only) Returns the units for the immediate oscilloscope measurement. Group Measurement Syntax...
  • Page 182 Command Descriptions MEASUrement:IMMed:VALue? (Query Only) Executes the immediate oscilloscope measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is taken on the source specified by the MEASUrement:IMMed:SOUrce command. Immediate queries and commands are the preferred measurement method for programming. To check whether the measurement was successful, use the *ESR? query followed by the EVENT? or ALLEv? queries to read the Standard Event Status Register (SESR).
  • Page 183 MEASUrement:MEAS<x>? (Query Only) Returns all measurement parameters for the displayed oscilloscope periodic measurement specified by <x>. Where <x> identifies the measurement, 1 through 4 for the TDS200 series, and 1 through 5 for the TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series.
  • Page 184 Sets or queries the on-screen periodic oscilloscope measurement type for the measurement specified by <x>. Where <x> identifies the measurement, 1 through 4 for the TDS200 series, and 1 through 5 for the TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series.
  • Page 185 Command Descriptions This is equivalent to selecting the measurement type in the MEASURE menu. Setting the type to anything other than NONE displays the MEASURE menu on the screen. NOTE. You should use the MEASUrement:IMMed command with programming to take measurements, as this is preferred to the MEASUrement:MEAS<x>command.
  • Page 186 Command Descriptions RISe (TDS200 series with a TDS2MM measurement module, TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series only) is the rise time between 10% and 90% of the first rising edge of the waveform. Rising edge must be displayed to measure. The oscilloscope automatically calculates the 10% and 90% measure- ment points.
  • Page 187 Command Descriptions MEASUrement:MEAS<x>:UNIts? (Query Only) Returns the units for the oscilloscope measurement specified by MEASUrement:MEAS<x>:TYPe. Where <x> identifies the measurement, 1 through 4 for the TDS200 series, and 1 through 5 for the TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series. Group...
  • Page 188 Returns the value that has been calculated for the oscilloscope on-screen periodic measurement specified by <x>. Where <x> identifies the measurement, 1 through 4 for the TDS200 series, and 1 through 5 for the TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series.
  • Page 189 Command Descriptions Group Measurement Syntax MEASUrement:MEAS<x>:VALue? Returns <NR3> 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- - 30 on page 2- - 170, such as single sequence acquisitions.
  • Page 190 Command Descriptions Table 2- 30: Commands that generate an Operation Complete message Command Operation *CAL?, CALibrate:CONTINUE, Internal self-calibration CALIbrate:FACtory, CALIbrate:INTERNAL ACQuire:STATE ON or Busy single sequence ACQuire:STATE RUN acquisition (when ACQuire:STOPAfter is set to SEQuence) HARDCopy STARt Busy hard copy output Group Status and Error Syntax...
  • Page 191 Command Descriptions PICTBridge:DEF (Set Only) (TDS1000B and TDS2000B Series Only) Sets the arguments for all PictBridge commands to their default values. The default values are the same as the default settings for the printer. This command is equivalent to setting all the options to default in the UTILITY >...
  • Page 192 Command Descriptions Syntax PICTBridge:PAPERSIZE { DEFLT | L | L2 | HAGAKIPCARD | MM54BY86 | MM100BY150 | IN4BY6 | IN8BY10 | LETTER | IN11BY17 | A0 | A1 | A2 | A3 | A4 | A5 | A6 | A7 | A8 | A9 | B0 | B1 | B2 | B3 | B4 | B5 | B6 | B7 | B8 | B9 | ROLL89MM | ROLL127MM | ROLL100MM | ROLL210MM } PICTBridge:PAPERSIZE?
  • Page 193 Command Descriptions Arguments DEFLT specifies the default size of the image to print. All image size arguments are valid as long as the paper size can accommodate the image. The paper size should be larger than the image size. Examples PICTBridge:IMAGESIZE? Might return LETTER as the size of the image to print.
  • Page 194 Command Descriptions PICTBridge:PRINTQUAL (TDS1000B and TDS2000B Series Only) Sets the quality of the print from those available on the compatible printer. This command is equivalent to setting the Print Quality option in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu of TDS1000B and TDS2000B oscilloscopes.
  • Page 195 Command Descriptions Group PictBridge Syntax PICTBridge:DATEPRINT { DEFLT | OFF | ON } PICTBridge:DATEPRINT? Arguments DEFLT will match the default setting of the printer: on or off. ON prints the date and time on the hard copy. OFF does not print the date and time. Examples PICTBridge:DATEPRINT? Might return ON if the printer is set to print the date and time.
  • Page 196 Command Descriptions OFF does not print the model and serial number. Examples PICTBridge:IDPRINT? Might return ON if the printer is set to print the model and serial number. POWer? (Query Only) (TPS2000 Series Only) Returns the current POWer measurement settings. Group Power and Battery-Related Syntax...
  • Page 197 Command Descriptions Syntax POWer:AC:PRESENt? Returns 0 if the oscilloscope is being powered by battery. 1 if the oscilloscope is being powered by AC. Examples POWER:AC:PRESENT? Might return 0, specifying that the oscilloscope is being powered by its battery. POWer:BATTERY<x>:GASgauge? (Query Only) (TPS2000 Series Only) Returns the amount of charge remaining in Battery x, where x is Battery 1 or Battery 2.
  • Page 198 Command Descriptions POWer:BATTERY<x>:STATUS? (Query Only) (TPS2000 Series Only) Returns the status of battery x, where x is Battery 1 or Battery 2. Group Power and Battery-Related Syntax POWer:BATTERY<x>:STATUS? Returns FULL indicates that the battery is fully charged. DISCHARGED indicates that the battery has no charge remaining. The battery can be discharged, but still report a small percent remaining.
  • Page 199 Command Descriptions Syntax POWer:BATTERIES:TIME? Returns <NR1> specifies the operating time remaining for both batteries in minutes. Examples POWER:BATTERIES:TIME? Might return 10, specifying that the battery or batteries installed can provide about 10 minutes of power to the oscilloscope. POWer:BUTTONLIGHT (TPS2000 Series Only) Turns the lights on the front-panel buttons of the TPS2000 on and off.
  • Page 200 Command Descriptions POWerANALYSIS:SOUrces (TPS2000 Series Only) Sets or queries the Power Analysis sources. This command is equivalent to setting the Sources option in the Power Analysis menu. It does not affect the sources for any customer- - visible PI measure- ments.
  • Page 201 Command Descriptions *PSC Sets and queries the power-on status flag that controls the automatic power-on handling of the DESER, SRER, and ESER registers. When *PSC is true, the DESER register is set to 255 and the SRER and ESER registers are set to 0 at power on. When *PSC is false, the current values in the DESER, SRER, and ESER registers are preserved in nonvolatile memory when power is shut off and are restored at power on.
  • Page 202 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, TDS2000, TDS1000B, TDS2000B, and TPS2000 series), and specifies a setup storage location. Examples *RCL 3 Restores the oscilloscope from a copy of the settings stored in memory location 3.
  • Page 203 RECAll:SETUp { FACtory | <NR1> | <file path> } Arguments FACtory selects the factory setup. <NR1> is a value in the range from 1 to 5 (TDS200 series), or from 1 to 10 (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series), and specifies a setup storage location.
  • Page 204 Command Descriptions Group Save and Recall Syntax RECAll:WAVEForm <file path>,REF<x> Arguments <file path> is a quoted string that defines the location and name of the waveform file to recall. If you do not specify a path to the folder, the oscilloscope looks for the file in the current working folder.
  • Page 205 Command Descriptions Examples REM “This is a comment” This command is ignored by the oscilloscope. RS232? (Query Only) (TDS200, TDS1000, TDS2000, and TPS2000 Series Only) Returns the RS232 settings. Group RS-232 Syntax RS232? Returns The current RS-232 settings Examples RS232? Might return the following string: :RS232:BAUD 9600;...
  • Page 206 Command Descriptions Syntax RS232:BAUd <NR1> RS232:BAUd? Arguments <NR1> which can be 300, 600, 1200, 2400, 4800, 9600, or 19200. Examples RS232:BAUd 9600 Sets the transmission rate to 9600 baud. RS232:HARDFlagging (TDS200, TDS1000, TDS2000, and TPS2000 Series Only) Sets or queries the state of RS232 hard flagging. When hard flagging is enabled, the oscilloscope sends data as long as CTS (Clear To Send) is asserted.
  • Page 207 Command Descriptions OFF or <NR1> = 0 deactivates hard flagging (RTS always asserted). Examples RS232:HARDFlagging ON Activates hard flagging and deactivates soft flagging. RS232:PARity (TDS200, TDS1000, TDS2000, and TPS2000 Series Only) Sets or queries the parity used for all RS-232C data transfers. When parity is odd or even, the oscilloscope generates the selected parity on output and checks all input against the selected parity.
  • Page 208 Command Descriptions Examples RS232:PARity EVEN\ Sets even parity. RS232:SOFTFlagging (TDS200, TDS1000, TDS2000, and TPS2000 Series Only) 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. The oscilloscope begins transmitting data again when it receives an XON (DC1) character.
  • Page 209 Command Descriptions Examples RS232:SOFTFlagging ON Activates soft flagging and deactivates hard flagging. RS232:TRANsmit:TERMinator (TDS200, TDS1000, TDS2000, and TPS2000 Series Only) 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 210 Command Descriptions *RST (Set Only) (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: Factory Setup) H Sets the macro defined by *DDT to a zero-length field...
  • Page 211 Syntax *SAV <NR1> Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 series) or from 1 to 10 (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series) and specifies a memory location. Any settings that have been stored previously at this location are overwritten.
  • Page 212 Command Descriptions SAVe:IMAge (Set Only) (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Saves the screen image to a file on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only). Group Save and Recall Syntax SAVe:IMAge <file path>...
  • Page 213 Command Descriptions SAVe:IMAge:FILEFormat (TDS2MEM, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets the screen image file format used by the SAVe:IMAGE command and by the SAVE > Action > Save Image and SAVE > Action > Save All front-panel operations. Group Save and Recall Syntax SAVe:IMAge:FILEFormat {BMP | EPSIMAGE | JPG | PCX | RLE...
  • Page 214 Syntax SAVe:SETUp {<NR1> | <file path>} Arguments <NR1> is an integer value in the range from 1 to 5 (TDS200 series), or 1 to 10 (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series), and specifies a memory location. Any settings that have been stored previously at this location are overwritten.
  • Page 215 Command Descriptions Related Commands RECAll:SETUp, *RCL, *SAV SAVe:WAVEform (Set Only) Stores a waveform in one of the nonvolatile reference memory locations, or to a file on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only).
  • Page 216 Command Descriptions Saves the math waveform in stored waveform memory location REFB. SAVe:WAVEform CH1, “A:\PROD-TST\FRQTST03.CSV” Saves the channel 1 waveform data to the file FRQTST03.CSV in the folder A:\PROD-TST on the CompactFlash card (TDS2MEM and TPS2000 series only), or on the USB flash drive (TDS1000B and TDS2000B series only).
  • Page 217 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 218 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 219 Command Descriptions *SRE? 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 220 Command Descriptions Examples *STB? Might return the value 96, showing that the SBR contains the binary value 01100000. Related Commands *CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *SRE SWLoss? (Query only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the current Switching Loss measurement settings. Group Power Measurement Syntax...
  • Page 221 Command Descriptions Syntax SWLoss:ACQuire { STOPAfter | CONTINUOUS } SWLoss:ACQuire? Arguments STOPAfter instructs the oscilloscope to perform measurements on N acquisitions and then stop. CONTINUOUS instructs the oscilloscope to continuously acquire waveforms and display measurements. Examples SWLoss:ACQuire? Might return SWLOSS:ACQUIRE CONTINUOUS, indicating that the oscilloscope is continuously taking switching loss measurements.
  • Page 222 Command Descriptions Syntax SWLoss:AVErage:CONDUCTION? Returns <NR3> Examples SWLoss:AVErage:CONDUCTION? Might return 6.0880498608E-2. SWLoss:AVErage:N? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the number of measurements used to calculate the AVG. (averaged) measurement value for switching loss measurements. NOTE. This command returns error 221 (settings conflict) if the Switching Loss menu is not active.
  • Page 223 Command Descriptions SWLoss:AVErage:TOTAL? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the sum of the Turn-On, Turn-Off, and Conduction switching losses. The oscilloscope reports this measurement in the Avg column of the Switching Loss display. NOTE. This command returns error 221 (settings conflict) if the Switching Loss menu is not active.
  • Page 224 Command Descriptions NOTE. This command returns error 221 (settings conflict) if the Switching Loss menu is not active. Group Power Measurement Syntax SWLoss:AVErage:TURNOFF? Returns <NR3> Examples SWLoss:AVErage:TURNOFF? Might return 1.3790115628E- - 2. SWLoss:AVErage:TURNON? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the power loss of the device under test when the device is transitioning between its off and on state.
  • Page 225 Command Descriptions Syntax SWLoss:AVErage:TURNON? Returns <NR3> Examples SWLoss:AVErage:TURNON? Might return 1.698264356E-2. SWLoss:ENABLe (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries the switching loss menu, on or off. Group Power Measurement Syntax SWLoss:ENABLe { ON | OFF } SWLoss:ENABLe? Arguments ON enables the switching loss menu.
  • Page 226 Command Descriptions SWLoss:LEVELS (Set Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the Switching Loss measurement levels to factory default values for the following commands: SWLoss:TONSTART SWLoss:TONEND SWLoss:TOFFSTART SWLoss:TOFFEND Group Power Measurement Syntax Syntax SWLoss:LEVELS { DEFault } Arguments DEFault sets Switching Loss measurement levels to default values.
  • Page 227 Command Descriptions Group Power Measurement Syntax SWLoss:LOG:CONDUCTION? Returns <NR3> Examples SWLoss:LOG:CONDUCTION? Might return 6.0524113476E-2. Related Commands SWLoss:LOG:INDEX SWLoss:LOG:TOTAL? SWLoss:LOG:TURNON? SWLoss:LOG:TUNROFF? SWLoss:LOG:INDEX (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries which measurement to return for the following commands: SWLoss:LOG:CONDUCTION?, SWLoss:LOG:TO- TAL?, SWLoss:LOG:TURNON?, and SWLoss:LOG:TURNOFF?.
  • Page 228 Command Descriptions Arguments <NR1> The default value is 1. Examples SWLoss:LOG:INDEX? Might return 5. SWLoss:LOG:TOTAL? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the Total Loss for a switching loss measurement specified by the SWLoss:LOG:INDEX command. NOTE. The oscilloscope generates error 221 if the SWLoss:LOG:IN- DEX? command returns a number greater than that reported by SWLoss:AVErage:N? This indicates that insufficient measurements have been taken to generate a log report.
  • Page 229 Command Descriptions SWLoss:LOG:TURNON? SWLoss:LOG:TUNRNOFF? SWLoss:LOG:TURNOFF? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the Turn-Off Loss for a switching loss measurement specified by the SWLoss:LOG:INDEX command. NOTE. The oscilloscope generates error 221 if the SWLoss:LOG:IN- DEX? command returns a number greater than that reported by SWLoss:AVErage:N? This indicates that insufficient measurements have been taken to generate a log report.
  • Page 230 Command Descriptions SWLoss:LOG:TURNON? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the Turn-On Loss for a switching loss measurement specified by the SWLoss:LOG:INDEX command. NOTE. The oscilloscope generates error 221 if the SWLoss:LOG:IN- DEX? command returns a number greater than that reported by SWLoss:AVErage:N? This indicates that insufficient measurements have been taken to generate a log report.
  • Page 231 Command Descriptions SWLoss:SAVE (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Saves the Switching Loss measurements to the oscilloscope CompactFlash card. Uses .CSV format. NOTE. You can view the contents of the saved file on your personal computer. You cannot recall saved Switching Loss files to the oscilloscope.
  • Page 232 Command Descriptions Group Power Measurement Syntax SWLoss:SOURCES { CH1CH2 | CH3CH4 } SWLoss:SOURCES? Arguments CH1CH2 specifies Channel 1 and Channel 2 as the input sources. CH3CH4 specifies Channel 3 and Channel 4 as the input sources. NOTE. The “CH3CH4” argument is only valid for instruments with four channels.
  • Page 233 Command Descriptions Arguments <NR1> defines the number of measurements you want to include. Examples SWLoss:STOPafter? Might return 15, indicating that the oscilloscope will take fifteen measurements and stop. Related Commands SWLoss:ACQuire SWLoss:TOFFEND (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries a level on the first falling edge of the current waveform that occurs after the turn-off start point (SWLoss:TOFF- START).
  • Page 234 Command Descriptions Related Commands SWLoss:TOFFSTART SWLoss:TONSTART SWLoss:TONEND SWLoss:LEVELS SWLoss:TONEND (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries a level on the first falling edge of the voltage waveform. The Turn-On loss measurement is calculated by integrating the math waveform between the turn-on start (SWLoss:TONSTART) and turn-on end (SWLoss:TONEND) points.
  • Page 235 Command Descriptions SWLoss:TOFFSTART (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries a level on the rising edge of the voltage waveform. The Turn-Off loss measurement is calculated by integrating the math waveform between the turn-off start (SWLoss:TOFFSTART) and turn-off end (SWLoss:TOFFEND) points.
  • Page 236 Command Descriptions The Turn-On loss measurement is calculated by integrating the math waveform between the turn-on start (SWLoss:TONSTART) and turn-on end (SWLoss:TONEND) points. Group Power Measurement Syntax SWLoss:TONSTART <NR1> SWLoss:TONSTART? Arguments <NR1> in percent. Default value is 90. Examples SWLoss:TONSTART? Might return 80, indicating that Switching Loss Turn-on Start is set to 80%.
  • Page 237 Command Descriptions SWLoss:UNITs? Arguments WATTS sets the measurement units to Watts. JOULES sets the measurement units to Joules. Examples SWLoss:UNITs? Might return WATTS, indicating that the current measurement units are Watts. NOTE. If the units are Watts, the trigger type must be Edge and the trigger source must be a channel specified by SWLoss:SOURCES.
  • Page 238 Command Descriptions Returns SWLoss:VALue:CONDUCTION? Might return 6.0166666667E-2. SWLoss:VALue:TOTAL? (Query Only) (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the sum of the Turn-On, Turn-Off, and Conduction switching losses. This command returns an immediate-measurement value that does not depend of the current oscilloscope menu. Group Power Measurement Syntax...
  • Page 239 Command Descriptions Group Power Measurement Syntax SWLoss:VALue:TURNOFF? Returns <NR3> Examples Syntax SWLoss:VALue:TURNOFF? Might return SWLoss:VALue:TURNON? (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Returns the power loss of the device under test when the device is transitioning between its off and on state. You must enter the saturation voltage of the device under test using the SWLoss:VSAT command.
  • Page 240 Command Descriptions SWLoss:VSAT (TPS2000 Series with TPS2PWR1 Power Analysis Module Only) Sets or queries the saturation voltage for the device under test. Group Power Measurement Syntax SWLoss:VSAT <NR3> SWLoss:VSAT? Arguments <NR3> specifies the saturation voltage. Examples SWLoss:VSAT? Might return 4.800000667572E0, indicating that the saturation voltage is set to 4.80 volts.
  • Page 241 Command Descriptions Arguments <QString> is a time in the form “hh:mm:ss”, based on a 24-hour clock (00:00:00 through 23:59:59). Examples TIMe “14:45:00” Sets the time to 2:45 pm. Related Commands DATE *TRG (Set Only) (Trigger) Executes commands that are defined by *DDT. Group Miscellaneous Syntax...
  • Page 242 Command Descriptions Syntax TRIGger FORCe TRIGger? Arguments FORCe creates a trigger event. If TRIGger:STATE is REAdy, the acquisition will complete; otherwise this command will be ignored. This is equivalent to selecting FORCE TRIG on the front panel. Examples TRIGger FORCe Forces a trigger event to occur.
  • Page 243 Command Descriptions Arguments SETLevel sets the main trigger level to half way between the MIN and MAX amplitudes of the trigger source input. This is equivalent to pressing the front-panel SET LEVEL TO 50% button. If the oscilloscope acquisition state is STOP and you send TRIGger:MAIn SETLevel, the oscilloscope ignores the command and generates event 221 (Settings conflict).
  • Page 244 Command Descriptions Group Trigger Syntax TRIGger:MAIn:EDGE:COUPling { AC | DC | HFRej | LFRej | NOISErej } TRIGger:MAIn:EDGE:COUPling? Arguments AC selects AC trigger coupling. DC selects DC coupling. HFRej coupling removes the high-frequency components of the DC signal. LFRej coupling removes the low-frequency components of the AC signal.
  • Page 245 Command Descriptions Arguments FALL specifies to trigger on the falling or negative edge of a signal. RISe specifies to trigger on the rising or positive edge of a signal. Examples TRIGger:MAIn:EDGE:SLOpe RISE Sets the main edge trigger to occur on the rising slope. TRIGger:MAIn:EDGE:SOUrce Sets or queries the source for the edge trigger.
  • Page 246 Command Descriptions Examples TRIGger:MAIn:EDGE:SOUrce CH1 Specifies channel 1 as the edge trigger source. TRIGger:MAIn:EDGE:SOUrce? Might return CH2 for the edge trigger source. TRIGger:MAIn:FREQuency? (Query Only) (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the edge or pulse width trigger frequency. This is the same as the readout in the lower right corner of the screen.
  • Page 247 Command Descriptions TRIGger:MAIn:HOLDOff? (Query Only) Returns the trigger holdoff value. Group Trigger Syntax TRIGger:MAIn:HOLDOff? Returns Main trigger holdoff value 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>...
  • Page 248 Command Descriptions TRIGger:MAIn:LEVel Sets the oscilloscope edge (all models) and pulse width (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 series only) trigger level. This command is equivalent to adjusting the front-panel TRIGGER LEVEL knob. NOTE. When the edge trigger source is set to AC LINE, the oscilloscope ignores the set form of the command and generates event 221 (Settings conflict).
  • Page 249 Command Descriptions Group Trigger Syntax TRIGger:MAIn:MODe { AUTO | NORMal } TRIGger:MAIn:MODe? Arguments AUTO generates a trigger if a trigger is not detected within a specific time period. AUTO also enables scan mode for sweep speeds of 100 ms/div and slower. NORMal waits for a valid trigger event.
  • Page 250 Command Descriptions Examples TRIGger:MAIn:PULse? Might return the following string: :TRIGGER:MAIN:PULSE:SOURCE CH1;WIDTH:POLARITY POS- ITIVE;WHEN EQUAL;WIDTH 1.0E-3 TRIGger:MAIn:PULse:SOUrce (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the source for the pulse trigger. This is equivalent to setting the Source option in the Trigger menu. Group Trigger Syntax...
  • Page 251 Command Descriptions TRIGger:MAIn:PULse:WIDth? (Query Only) (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Returns the pulse trigger width settings. Group Trigger Syntax TRIGger:MAIn:PULse:WIDth? Examples TRIGger:MAIn:PULse:WIDth? Might return the following string: :TRIGGER:MAIN:PULSE:WIDTH:POLARITY POSITIVE;WHEN EQUAL;WIDTH 1.0E-3 TRIGger:MAIn:PULse:WIDth:POLarity (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the polarity for the pulse trigger.
  • Page 252 Command Descriptions Arguments Positive polarity specifics pulses with a rising leading edge. Negative polarity specifies pulses with a falling leading edge. TRIGger:MAIn:PULse:WIDth:WHEN (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the trigger conditions for the pulse trigger. This is equivalent to setting the When option in the Pulse Trigger menu.
  • Page 253 Command Descriptions TRIGger:MAIn:PULse:WIDth:WIDth (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the width for the pulse trigger. This is equivalent to setting the Width option by using the Pulse Trigger menu and the TRIGGER knob. Group Trigger Syntax TRIGger:MAIn:PULse:WIDth:WIDth <NR3>...
  • Page 254 VIDeo specifies that a trigger occurs when a specified signal is found and is controlled by the TRIGger:MAIn:VIDeo commands. PULse specifies that a trigger occurs when the specified signal meets the pulse width criteria that is controlled by the TRIGger: MAIn:PULse commands (not available with TDS200 series oscilloscopes). Examples TRIGger:MAIn:TYPe? Might return VIDEO, indicating that the main trigger type is a video trigger.
  • Page 255 Command Descriptions TRIGger:MAIn:VIDeo:LINE (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only) Sets or queries the line number for the video trigger when TRIGger:MAIn:VIDeo:SYNC is set to LINENUM. This is equivalent to selecting a line number in the Trigger/Video menu. Group Trigger Syntax TRIGger:MAIn:VIDeo:LINE <NR1>...
  • Page 256 Command Descriptions Syntax TDS210 and TDS220 models with firmware below V2.00 and a TDS2CMA communications module: TRIGger:MAIn:VIDeo:POLarity { INVERTed | NORMal } All other oscilloscope, firmware version, and module combinations: TRIGger:MAIn:VIDeo:POLarity { INVert | NORMal } TRIGger:MAIn:VIDeo:POLarity? Arguments INVERTed or INVert specifies a positive sync pulse. NORMal specifies a negative sync pulse.
  • Page 257 Command Descriptions EXT5 specifies the external input, attenuated by a factor of 5 (not available with TDS224 oscilloscopes). EXT10 specifies the external input attenuated by a factor of 10 (TPS2000 series only). Examples TRIGger:MAIn:VIDeo:SOUrce CH1 Selects channel 1 as the source for the main video trigger. TRIGger:MAIn:VIDeo:STANDard (TDS1000, TDS2000, TDS1000B, TDS2000B, and TPS2000 Series Only)
  • Page 258 Command Descriptions 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. Group Trigger Syntax TRIGger:MAIn:VIDeo:SYNC { FIELD | LINE | ODD | EVEN | LINENum } TRIGger:MAIn:VIDeo:SYNC? Arguments FIELD specifies that triggering occur on the vertical sync pulse.
  • Page 259 Command Descriptions TRIGger:STATE? (Query Only) Returns the current state of the triggering system. NOTE. Accurate real time reporting of the trigger state within any single waveform acquisition is limited by several factors, including horizontal sweep speed, and communications and task latencies. To check for the completion of a single sequence acquisition, use the *OPC? query.
  • Page 260 Command Descriptions Related Commands *OPC? *TST? (Query Only) (Self-Test) Tests the GPIB interface and always returns a 0. Group Miscellaneous Syntax *TST? Returns UNLock (Set Only) Unlocks the front panel. This command is equivalent to LOCk NONe. NOTE. If the oscilloscope is in the Remote With Lockout State (RWLS), the UNLock command has no effect.
  • Page 261 Command Descriptions 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. Keywords can be both headers and arguments.
  • Page 262 Command Descriptions *WAI (Set Only) *WAI (wait) prevents the oscilloscope from executing further commands or queries until all pending operations finish. This command lets you synchronize the operation of the oscilloscope with your application program. Refer to Synchronization Methods on page 3- - 10 for more information.
  • Page 263 Command Descriptions Arguments | CH1 | CH2 | CH3 | CH4 | specifies channel 1 through 4 as the waveform analysis source. NOTE. The “CH3 and CH4” options are only valid for instruments with four channels. MATH specifies the math waveform as the analysis source. Examples WAVEFORMANALYSIS:SOUrce CH2 Specifies Channel 2 as the waveform analysis source.
  • Page 264 Command Descriptions WFMPre? (Query Only) Returns waveform transmission and formatting settings 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). Group Waveform Syntax...
  • Page 265 Command Descriptions WFMPre:BIT_Nr? Arguments <NR1> is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8 and DATa:WIDth * 8. Examples WFMPre:BIT_Nr? Might return 8, indicating that there are 8 bits per waveform point. Related Commands DATa:WIDth WFMPre:BN_Fmt Sets or queries the format of binary data for the waveform to be transferred.
  • Page 266 Command Descriptions WFMPre:BN_Fmt? Returns either RI or RP as the current waveform data format. Related Commands DATa:ENCdg WFMPre:BYT_Nr Sets or queries the data width for the waveform to be transferred. This command is equivalent to DATa:WIDth. Changing WFMPre:BYT_Nr also changes WFMPre:BIT_Nr and DATa:WIDth. Group Waveform Syntax...
  • Page 267 Command Descriptions 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 WFMPre:BYT_Or { LSB | MSB } WFMPre:BYT_Or?
  • Page 268 Command Descriptions 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. WFMPre:ENCdg? Might return BIN, indicating that the waveform data is in binary format.
  • Page 269 Command Descriptions Group Waveform Syntax WFMPre:NR_Pt? Examples WFMPre:NR_Pt? Returns <NR1>, which is the number of data points. If DATa:WIDth is 2, then there are <NR1>*2 bytes in the curve. Related Commands DATa:ENCdg, DATa:SOUrce, DATa:STARt, DATa:STOP WFMPre:PT_Fmt The set form of this command sets the format (Y or ENV) of the reference waveform specified by the DATa:DESTination command.
  • Page 270 Command Descriptions = XZEro + XINcr (n - - PT_OFf) For Y format, the magnitude (usually voltage, relative to ground) (absolute coordinate) of a point can be calculated: = YZEro + YMUIty (y - - YOFf) ENV specifies that the oscilloscope transmit the waveform as minimum and maximum point pairs.
  • Page 271 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. NOTE. Use the WFMPre:XINcr, WFMPre:XUNit, and WFMPre:XZEro queries to determine the trigger position.
  • Page 272 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 (TDS200 series with a TDS2MM measurement module, TDS1000, TDS2000, TDS1000B, TDS2000B, and TDS2000 series only) this might return: :WFMPRE:WFID “Math, DC coupling, 1.0E1 dB/div,...
  • Page 273 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 274 Command Descriptions Syntax WFMPre:XUNit <qstring> WFMPre:XUNit? 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 275 Command Descriptions Arguments <NR3> is the position, in XUNits, of the first waveform sample. 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 –...
  • Page 276 Command Descriptions An example of unknown vertical scaling is a math waveform of CH1+CH2 where CH1 vertical scaling is different from CH2 vertical scaling. In this case, WFMPre:YUNit? returns U. (Does not apply to the TPS2000 series.) WFMPre:YOFf YOFf is a value, expressed in digitizer levels, used to convert waveform record values to YUNit values using the following formula (where dl is digitizer levels): value_in_YUNits =...
  • Page 277 Command Descriptions 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 278 Command Descriptions AA for amps*amps VV for volts*volts Returns Returns <QString> returns the following: Volts for volts U for unknown units (divisions) dB for decibels ? for unknown mask waveforms units For the TDS1000B, TDS2000B, and TPS2000 series, <QString> can return the following: A for amps VA for volts*amps...
  • Page 279 Command Descriptions execution error with event code 2244 (waveform requested is not active). NOTE. For the TDS210 or TDS220 oscilloscope (firmware below V 2.00) with a TDS2CMA communications module, the set form is ignored. The query always returns zero. Group Waveform Syntax WFMPre:YZEro <NR3>...
  • Page 280 Command Descriptions Table 2- 31: Additional WFMPre commands (Cont.) Command Argument Description WFMPre:ZUNit <QString> Z-axis units WFMPre:ZZEro <NR3> Z-axis origin offset WFMPre:<wfm>? (Query Only) Returns the waveform formatting data for the waveform specified by <wfm>, if that waveform is active or displayed. If that waveform is not active or displayed, the query fails and the oscilloscope generates event message 420 (Query unterminated) and 2244 (waveform requested is not active).
  • Page 281 Command Descriptions Returns the number of points that are in the transmitted waveform record. The number of points depends on DATa:STARt, DATa:STOP, and whether DATa:SOUrce is YT or FFT. NR_Pt is at most 2500 for YT and 1024 for FFT. NR_Pt is always at least one. When the DATa:SOUrce is not displayed, the oscilloscope will generate an error and return event code 2244.
  • Page 282 Command Descriptions Otherwise, the set form of this command is ignored. WFMPre:<wfm>:WFId? (Query Only) Same as WFMPre:WFId?, except that <wfm> specifies the source waveform instead of DATa:SOUrce. WFMPre:<wfm>:XINcr Same as WFMPre:XINcr, except that <wfm> specifies the source/destination waveform instead of DATa:SOUrce and DATa:DESTINATION.
  • Page 283 Command Descriptions For set commands, if <wfm> is not a reference waveform, the oscilloscope generates error 2241. WFMPre:<wfm>:YOFf Same as WFMPre:YOFf, except that <wfm> specifies the source/ destination waveform instead of DATa:SOUrce and DATa:DES- TINATION. For set commands, if <wfm> is not a reference waveform, the oscilloscope generates error 2241.
  • Page 284 Command Descriptions TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer 2- 264...
  • Page 285 Status and Events...
  • Page 287 Status and Events The oscilloscope provides a status and event reporting system for the GPIB, RS-232, and USB 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 288: 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 289: 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--30 on page 2--170 for a list of commands that generate an Operation Complete message.
  • Page 290 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 or USB host. MSS (Master Status Summary), obtained from *STB?. Summarizes the ESB and MAV bits in the SBR.

  • Page 291: 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 292 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 293 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 294 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 295: 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 296 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 297: Figure 3- - 7: Command Processing Without Using

    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 298 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 299 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 300 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 301 Status and Events MEASUREMENT:IMMED:VALUE? This technique requires less bus traffic than did looping on BUSY?. Service Request Method (GPIB and USB 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 302 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 303 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 304 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 –...
  • Page 305 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...
  • Page 306 Status and Events Table 3- 5: Execution error messages – EXE bit 4 (Cont.) Code Message 2201 Measurement error, Zero period 2202 Measurement error, No period found 2203 Measurement error, No period, second waveform 2204 Measurement error, Low signal amplitude 2205 Measurement error, Low amplitude, second waveform 2206...
  • Page 307 Status and Events Table 3- 5: Execution error messages – EXE bit 4 (Cont.) Code Message 2225 Measurement error, No waveform to measure 2226 Null Waveform 2227 Positive and Negative Clipping 2228 Measurement error, Positive Clipping 2229 Measurement error, Negative Clipping 2230 Measurement error, High Ref <...
  • Page 308 Status and Events Table 3- - 6 lists the device errors that can occur during oscilloscope operation. These errors may indicate that the oscilloscope needs repair. Table 3- 6: Device error messages – DDE bit 3 Code Message Device-specific error System error Memory error Calibration memory lost...
  • Page 309 Status and Events Table 3- 7: System event messages (Cont.) Code Message Query INTERRUPTED (QYE bit 2 set) Query UNTERMINATED (QYE bit 2 set) Query DEADLOCKED (QYE bit 2 set) Query UNTERMINATED after indefinite response (QYE bit 2 set), normally caused by using a query that returns arbitrary data in a concatenated command Table 3- - 8 lists warning messages that do not interrupt the flow of command execution.
  • Page 310 Status and Events Table 3- 8: Execution warning messages – EXE Bit 4 (Cont.) Code Message Measurement warning, Uncertain edge Measurement warning, Invalid in minmax Measurement warning, Need 3 edges Measurement warning, Clipping positive/negative Measurement warning, Clipping positive Measurement warning, Clipping negative Table 3- - 9 lists internal errors that indicate an internal fault in the oscilloscope.
  • Page 311 Programming Examples...
  • Page 313 Programming Examples The following series of commands and queries illustrate many of the most common commands and techniques. Table 2- - 1 on page 2- - 1 lists oscilloscopes, extension modules, and the communication protocol you can use with them. To use these commands and queries over USB, you will need to use a program or routines that interface to the USBTMC driver on your PC.
  • Page 314 Programming Example > rem ”Start a single sequence acquisition.” > acquire:stopafter sequence > acquire:state on > rem ”Wait for the acquisition to complete.” > rem ”Note: your controller program time-out must be set long enough to handle the wait.” > *opc? >...
  • Page 315 Appendices...
  • Page 317 Appendix A: ASCII Code Chart ” & ’ Continued on next page TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer A- 1...
  • Page 318 Appendix A: ASCII Code Chart < > (RUBOUT) octal ASCII character decimal TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer A- 2...
  • Page 319 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 320 Appendix B: Factory Setup :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;MATH 0;REFA 0;REFB 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;...
  • Page 321 Appendix B: Factory Setup TPS2000 Series Oscilloscopes Items enclosed in < > brackets are present only when the TPS2PWR1 Power Application Module software key is installed. This is a typical response for 2 channel models. :HEADER 1;:VERBOSE 1; :DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1;START 1;STOP 2500;WIDTH 1;...
  • Page 322 Appendix B: Factory Setup :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;SOURCE1 CH1;<SOURCE2 CH2;> :MATH:DEFINE ”CH1 - CH2”;VERTICAL:POSITION 0.0E0;SCALE 2.0E0; :MATH:FFT:HORIZONTAL:POSITION 5.0E1;SCALE 1.0E0; :MATH:FFT:VERTICAL:POSITION 0.0E0;SCALE 1.0E0; :HARDCOPY:BUTTON PRINTS;FORMAT EPSON;PORT CENTRONICS;LAYOUT PORTRAIT;INKSAVER ON;...
  • Page 323 Appendix B: Factory Setup TDS1000 and TDS2000 Series Oscilloscopes Items enclosed in < > angle brackets are present only when the TDS2MEM module is installed. Responses for channel 3 and 4 apply only to 4-channel models. :HEADER 1;(:VERBOSE 1;) :DATA:ENCDG RIBINARY;DESTINATION REFA;SOURCE CH1;START 1;STOP 2500;WIDTH 1;...
  • Page 324 Appendix B: Factory Setup :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; :MATH:DEFINE ”CH1 - CH2”;FFT:HORIZONTAL:POSITION 5.0E1;SCALE 1.0E0;...
  • Page 325 Appendix B: Factory Setup :ACQUIRE:MODE SAMPLE;NUMAVG 16;STATE 1; STOPAFTER RUNSTOP; :CH1:PROBE 10;SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH OFF;<INVERT OFF;> :CH2:PROBE 10;SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH OFF;<INVERT OFF;> :HORIZONTAL:VIEW MAIN; MAIN:SCALE 5.0E-4;POSITION 0.0E0; :HORIZONTAL:DELAY:SCALE 5.0E-5;POSITION 0.0E0; :TRIGGER:MAIN:MODE AUTO;TYPE EDGE; HOLDOFF:VALUE 5.0E-7; :TRIGGER:MAIN:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE; :TRIGGER:MAIN:VIDEO:SOURCE CH1;SYNC LINE;POLARITY NORMAL;...
  • Page 326 Appendix B: Factory Setup 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; START 1;STOP 2500;WIDTH 1; (:LOCK NONE;) :DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 0; CONTRAST 50; :ACQUIRE:MODE SAMPLE;NUMAVG 16;STATE 1;STOPAFTER RUNSTOP;...
  • Page 327 Appendix B: Factory Setup :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:IMMED:TYPE PERIOD;SOURCE CH1; :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) TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer...
  • Page 328 Appendix B: Factory Setup TDS200, TDS1000/2000, TDS1000B/2000B, TPS2000 Programmer B- 10...
  • Page 329 Glossary and Index...
  • Page 331 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 332 Glossary IEEE Acronym for the Institute of Electrical and Electronics Engineers. RS-232 A serial, full-duplex, asynchronous communication port that follows ANSI/EIA/TIA-562-1989[1], ANSI/EIA/ TIA-574-1990[2], and CCITT V.24-1989[3] standards. 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).
  • Page 333 Index Abbreviating, commands, 2- - 6 *CAL?, 2- - 58 ACQUIRE?, 2- - 45 CALIBRATE:ABORT, 2- - 59 ACQUIRE:MODE, 2- - 46 CALIBRATE:CONTINUE, 2- - 60 ACQUIRE:NUMACQ?, 2- - 47 CALIBRATE:FACTory, 2- - 60 ACQUIRE:NUMAVG, 2- - 48 CALIBRATE:INTERNAL, 2- - 61 ACQUIRE:STATE, 2- - 49 CALIBRATE:STATUS?, 2- - 62 ACQUIRE:STOPAFTER, 2- - 50...
  • Page 334 Index *CLS, 2- - 71 status and error, 2- - 33 Command trigger, 2- - 34 abbreviating, 2- - 6 vertical, 2- - 36 argument, 2- - 3 waveform, 2- - 37 block argument, 2- - 13 Command mnemonic BUSY?, 3- - 13 CH<x>, 2- - 9 common, 2- - 25, 2- - 33 channel, 2- - 9...
  • Page 335 Index CURSOR:SELECT:SOURCE, 2- - 77 CURSOR:VBARS?, 2- - 78 DATA, 2- - 85 CURSOR:VBARS:DELTA?, DATA:DESTINATION, 2- - 86 2- - 78 DATA:ENCDG, 2- - 87 CURSOR:VBARS:HDELTA?, DATA:SOURCE, 2- - 89 2- - 79 DATA:START, 2- - 90 CURSOR:VBARS:HPOS<x>?, DATA:STOP, 2- - 91 2- - 80 DATA:TARGET, 2- - 92 CURSOR:VBARS:POSI-...
  • Page 336 Index FILESYSTEM:MKDIR, 2- - 113 FILESYSTEM:RENAME, 2- - 114 Entering commands, 2- - 6 FILESYSTEM:RMDIR, 2- - 115 Entering incorrect numeric argu- FILESYSTEM?, 2- - 108 ments, 2- - 11 FILESYSTEM:CWD, 2- - 109 EOM (end of message), 2- - 8 FILESYSTEM:DELETE, 2- - 110 Error message, programming FILESYSTEM:DIR?, 2- - 110...
  • Page 337 Index HARMONICS:PERCENT?, 2- - 126 HORIZONTAL:DELAY:POSI- TION, 2- - 135, 2- - 137, 2- - 139 HARMONICS:PHASE?, 2- - 126 HORIZONTAL:DELAY:SCALE, HARMONICS:RMS?, 2- - 127 2- - 136 HARMONICS:SAVE?, 2- - 127 HORIZONTAL:DELAY:SECDIV, HARMONICS:SELECT, 2- - 128 2- - 137 HARMONICS:SETUP?, 2- - 129 HORIZONTAL:MAIN?, 2- - 137 HARMONICS:SHOW, 2- - 130...
  • Page 338 Index Math commands MEASUREMENT:IMMED: SOURCE1, 2- - 157 MATH?, 2- - 146 MEASUREMENT:IMMED: MATH:DEFINE, 2- - 147 TYPE, 2- - 158 MATH:FFT:HORIZON- TAL:POSITION, 2- - 150 MEASUREMENT:IMMED: MATH:FFT:HORIZON- UNITS?, 2- - 161 TAL:SCALE, 2- - 151 MEASUREMENT:IMMED: VALUE?, 2- - 162 MATH:FFT:VERTICAL:POSI- MEASUREMENT:MEAS<x>?, TION, 2- - 152...
  • Page 339 Index Message command, 2- - 2 *OPC, 2- - 169, 3- - 14 command terminator, 2- - 8 Operation complete command, handling, 3- - 1 2- - 169 table of program messages, 3- - 17 Operation complete wait, 2- - 242 Miscellaneous command group, 2- - 25 Output queue, 3- - 6...
  • Page 340 Index Power and Battery- - Related com- SWLOSS:AVERAGE:TURN- mands OFF?, 2- - 203 POWER?, 2- - 176 SWLOSS:AVERAGE:TUR- POWER:AC:PRESENT?, 2- - 176 NON?, 2- - 204 POWER:BATTERIES:TIME?, SWLOSS:ENABLE, 2- - 205 2- - 178 SWLOSS:LEVELS, 2- - 206 POWER:BATTERY<x>:GAS- SWLOSS:LOG:CONDUC- GAUGE?, 2- - 177 TION?, 2- - 206 POWER:BATTERY<x>:STA-...
  • Page 341 Index Power-on status clear command, SRER, 2- - 181, 2- - 198, 3- - 5 2- - 181 REM, 2- - 184 POWERANALYSIS:SOURCES, Reset 2- - 180 command, 2- - 190 Preamble, waveform, 2- - 43 to factory settings, 2- - 107 Programming, examples, 4- - 1 RS-232 command group, 2- - 32 Programming examples, 4- - 1...
  • Page 342 Index Save setting command, 2- - 191 ALLEV?, 2- - 51 SAVE:IMAGE, 2- - 192 BUSY?, 2- - 57 SAVE:IMAGE:FILEFORMAT, *CLS, 2- - 71 2- - 193 DESE, 2- - 94, 3- - 5 SAVE:SETUP, 2- - 194 *ESE, 2- - 103, 3- - 5 SAVE:WAVEFORM, 2- - 195 *ESR?, 2- - 104, 3- - 2 SBR register, 2- - 199, 3- - 3...
  • Page 343 Index SWLOSS:TOFFEND, 2- - 213 RECALL:SETUP, 2- - 182 SWLOSS:TOFFSTART, 2- - 215 RECALL:WAVEFORM, 2- - 183 SWLOSS:TONEND, 2- - 214 SAVE:IMAGE, 2- - 192 SWLOSS:TONSTART?, 2- - 215 SAVE:IMAGE:FILEFORMAT, 2- - 193 SWLOSS:UNITS, 2- - 216 SAVE:SETUP, 2- - 194 SWLOSS:VALUE:CONDUC- TION?, 2- - 217 SAVE:WAVEFORM, 2- - 195...
  • Page 344 Index WFMPRE:YZERO, 2- - 258 WHEN , 2- - 232 Tek Std. Codes and Formats 1989, WIDTH , 2- - 233 2- - 25, 2- - 33 TRIGGER:MAIN:TYPE, 2- - 233 Terminator, command message, TRIGGER:MAIN:VID- 2- - 8 EO:FIELD, 2- - 234 TIME, 2- - 220 TRIGGER:MAIN:VIDEO:LINE Time base, manual trigger simula-...
  • Page 345 Index TRIGGER:MAIN:VIDEO:LINE , Waveform, command mnemonic, 2- - 235 2- - 10 TRIGGER:MAIN:VIDEO:PO- Waveform command group, 2- - 37 LARITY, 2- - 235 Waveform commands TRIGGER:MAIN:VID- CURVE, 2- - 84 EO:SOURCE, 2- - 236, 2- - 238 DATA, 2- - 85 TRIGGER:MAIN:VIDEO:STAN- DATA:DESTINATION, 2- - 86 DARD , 2- - 237...
  • Page 346 Index WFMPRE:BYT_NR, 2- - 246 WFMPRE:<wfm>:WFLD?, 2- - 262 WFMPRE:BYT_OR, 2- - 247 WFMPRE:<wfm>:XINCR, 2- - 262 WFMPRE:ENCDG, 2- - 247 WFMPRE:<wfm>:XUNIT, 2- - 262 WFMPRE:NR_PT?, 2- - 248 WFMPRE:<wfm>:XZERO, 2- - 262 WFMPRE:PT_FMT, 2- - 249 WFMPRE:<wfm>:YMULT, 2- - 262 WFMPRE:PT_OFF, 2- - 251 WFMPRE:<wfm>:YOFF, 2- - 263 WFMPRE:WFID, 2- - 251...

This manual is also suitable for:

Tds1000 seriesTds2000 seriesTds1000b seriesTds2000b seriesTps2000 seriesTds1001 ... Show all

Table of Contents