Page 1
TBS1000B/EDU, TBS1000, TDS2000C/TDS1000C-EDU, TDS2000B/TDS1000B, TDS2000/TDS1000, TDS200 and TPS2000B/TPS2000 Series Digital Oscilloscopes Programmer *P077044403* 077-0444-03...
Page 3
TBS1000B/EDU, TBS1000, TDS2000C/TDS1000C-EDU, TDS2000B/TDS1000B, TDS2000/TDS1000, TDS200 and TPS2000B/TPS2000 Series Digital Oscilloscopes Programmer Revision A 20170113 www.tek.com 077-0444-03...
RS-232, the General Purpose Interface Bus (GPIB), or Universal Serial Bus (USB) standards, to remotely control and operate your oscilloscope. This document supports the following products: TBS1000B/EDU Series instructions, any version TBS1000 Series instruments, any version TPS2000 and TPS2000B Series instruments, any version.
Preface Related Documents Each series of oscilloscopes has a different set of documentation. TBS1000B/EDU Series Language TBS user manual part number Manuals English 077-0886-XX French 077-0887-XX Italian 077-0888-XX German 077-0889-XX Spanish 077-0890-XX Japanese 077-0891-XX Portuguese 077-0892-XX Simplified Chinese 077-0893-XX Traditional Chinese...
Page 9
Preface Language TPS user manual part number TPS2000 Series TPS2000B Series Italian 071-1443-XX 071-2724-XX 071-1444-XX 071-2725-XX German 071-1445-XX 071-2726-XX Spanish Japanese 071-1446-XX 071-2727-XX Portuguese 071-1447-XX 071-2728-XX 071-1448-XX 071-2729-XX Simplified Chinese Traditional Chinese 071-1449-XX 071-2730-XX Korean 071-1450-XX 071-2731-XX Russian 071-1451-XX 071-2732-XX For information on the TPS2PWR1 Power Analysis Application, refer to the TPS2PWR1 Power Analysis Application User Manual, an optional accessory available in eleven languages.
Page 10
Preface TDS1000, TDS2000, For general operation, refer to the user manual for your product. For information on the TDS2CMA Communications module, refer to the TDS1000 and TDS2000 TDS1000C-EDU, and Series Digital Storage Oscilloscope User Manual. TDS2000C Series manuals Language User manual part number TDS1000/TDS2000 TDS1000B/TDS2000B TDS1000C-EDU/TDS2000C English...
Service Manuals (English For information on how to service your oscilloscope, refer to the appropriate manual from the following optional accessories: Only) TBS1000B/EDU Series Digital Storage Oscilloscopes Service Manual (077-0897-XX) TBS1000 Series Digital Storage Oscilloscopes Service Manual (077-0772-XX) TDS2000C and TDS1000C-EDU Series Digital Storage Oscilloscopes Service...
Page 12
Preface viii TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Page 15
Refer to your oscilloscope user manual for information on how to install, test, and configure your oscilloscope and module. NOTE. The firmware for the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS1000B, TDS2000B, TPS2000B, and TPS2000 Series oscilloscopes includes communications, math, and storage memory functions.
Page 16
RS-232 is included in the oscilloscope firmware. NOTE. If you use GPIB with the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, or TDS1000B Series, you can set a unique GPIB address for the oscilloscope through the UTILITY ► Options ► GPIB Setup option.
Model or option GPIB RS-232 TDS2CM, TDS2CMA, TDS2CMAX TDS2MM TDS2MEM TDS1000 or TDS2000 TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS1000B, or TDS2000B TPS2000B, TPS2000 Function available with a TDS2CM, TDS2CMA, or TDS2CMAX module. Function available with a TDS2MEM module. Function available with a TEK-USB-488 adapter.
Command Syntax Table 2-2: BNF notation (cont.) Symbol Meaning Optional; can be omitted . . . Previous element(s) may be repeated Comment Command and Query Structure Commands consist of set commands and query commands (usually simply called commands and queries). Commands change oscilloscope settings or perform a specific action.
Page 21
Command Syntax The following figure shows the five command message elements. 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.
Command Syntax Table 2-4: Comparison of Header Off and Header On responses Query Header Off response Header On response ACQuire:NUMAVg ACQUIRE:NUMAVG 64 CHx1:COUPling CH1:COUPLING DC Clearing the Output Queue To clear the output queue and reset the oscilloscope to accept a new command or query, send a Device Clear (DCL) from a GPIB host.
Page 23
Command Syntax TRIGger:MODe NORMal;:ACQuire:NUMAVg 16 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;...
Command Syntax HORizontal:MAIn:POSition 0;MAIn:SCAle 1E-13 (levels of mnemonics are different; either remove the second occurrence of MAIn:, or put HORizontal: in front of MAIN:SCAle) Message Terminators This manual uses the term <EOM> (End of message) to represent a message terminator. GPIB End of Message (EOM) Terminators.
Commands can specify which measurement to set or query as a mnemonic in the header. The oscilloscope can display up to four (TDS200) or five (TBS1000, Mnemonics TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000) or six (TBS1000B/EDU) automated measurements. Symbol Meaning MEAS<x>...
Page 26
Command Syntax Numeric Arguments Many oscilloscope commands require numeric arguments. Table 2-5: Types of numeric arguments Symbol Meaning <NR1> Signed integer value <NR2> Floating point value without an exponent <NR3> Floating point value with an exponent The syntax shown is the data format that the oscilloscope returns in response to a query.
Page 27
Command Syntax Follow these rules when you use quoted strings: 1. A quoted string can include any character defined in the 7-bit ASCII character set. (See page A-1, ASCII Code Chart.). 2. Use the same type of quote character to open and close the string: "this is a valid string"...
Page 28
Command Syntax Figure 2-2: Block argument example <NZDig> specifies the number of <Dig> elements that follow. Taken together, the <Dig> elements form a decimal integer that specifies how many <DChar> elements follow. #0 means that the <Block> is an indefinite length block. The <terminator> ends the block.
This section lists the commands organized by functional group. The Command Descriptions section lists all commands alphabetically. 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,...
Return diagnostic test sequence results ERRLOG:FIRST? Returns first entry from error log ERRLOG:NEXT? Returns next entry from error log Counter Commands (TBS1000B/EDU models only) Counter commands provide control over the oscilloscope counter feature. Table 2-10: Counter commands Header Description COUNTERFreq?
Command Groups Table 2-11: Cursor commands (cont.) Header Description CURSor:HBArs:POSITION<x> Set or query the position of a horizontal bar cursor CURSor:HBArs:UNIts? Query vertical scale units CURSor:SELect:SOUrce Select waveform Return vertical bar settings CURSor:VBArs? CURSor:VBArs:DELTa? Return horizontal distance between cursors CURSor:VBArs:HDELTa? Return horizontal distance between cursors.
Page 32
Command Groups Table 2-13: Display commands Command Description Return display settings DISplay? DISplay:BACKLight Sets the backlight value (TBS1000B/EDU models only) DISplay:BRIGHTness Set or query the LCD display brightness DISplay:CONTRast Set or query the LCD display contrast DISplay:FORMat Set or query the YT or XY display...
File system commands perform file management tasks on the CompactFlash (CF) card of TPS2000 and TPS2000B oscilloscopes, and TDS models with a TDS2MEM module; and on USB flash drives of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B oscilloscopes. Table 2-15: File System commands...
Page 34
File System Conventions Use the following conventions when specifying file paths and file names: The default folder (directory) for non-TBS1000B/EDU models is A:\. The default folder (directory) for TBS1000B/EDU models is /usb0/. File and folder names have a maximum of 11 characters; eight characters, followed by a period, followed by up to three characters.
Horizontal commands control the time bases of the oscilloscope. You can set the position and time per division of both the main and window time bases. You can substitute SECdiv for SCAle in all appropriate horizontal commands. This provides program compatibility with previous Tektronix digitizing oscilloscopes. Table 2-17: Horizontal commands Command...
Command Groups Table 2-17: Horizontal commands (cont.) Command Description HORizontal:DELay:SCAle Set or query the window time base time/division NOTE. This command is not applicable to TBS1000B/EDU models. HORizontal:DELay:SECdiv Same as HORizontal:DELay:SCAle NOTE. This command is not applicable to TBS1000B/EDU models. HORizontal:MAIn?
Page 37
Command Groups Table 2-18: Limit test commands (cont.) Command Description LIMit:RESUlt:FAIL? Return the number of fail cases LIMit:RESUlt:PASS? Return the number of pass cases LIMit:RESUlt:TOTAL? Return the number of total cases tested LIMit:SAVEIMAge Set or return whether the oscilloscope should save the screen image to a file on a limit test failure event LIMit:SAVEWFM...
Query the definition for the math waveform MATH:DEFINE Set or query the math waveform definition MATH:FFT? Return all math FFT parameters. NOTE. This command is not applicable to TBS1000B/EDU models. MATH:FFT:HORizontal:POSition Set or query the FFT horizontal display position NOTE. This command is not applicable to TBS1000B/EDU models.
Page 39
Table 2-19: Math commands (cont.) Command Description MATH:FFT:VERtical:SCAle Set or query the FFT vertical zoom factor NOTE. This command is not applicable to TBS1000B/EDU models. MATH:VERtical? Return all math vertical waveform parameters MATH:VERtical:POSition Set or query the math waveform display...
MEAS<x>, where <x> can be 1, 2, 3, or 4 (or 5 for TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000) (or 6 for the TBS1000B/EDU). The best method for taking measurements over the computer interface is to use the MEASUREMENT:IMMED commands and queries.
Several commands and queries are common to all 488.2-1987 devices on the 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.
The PictBridge commands let you control the format of the hard copy on the PictBridge compatible printer. NOTE. The HARDCopy:BUTTON, HARDCopy:INKSaver, and HARDCopy:LAYOUT commands apply to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes. 2-24 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Command Groups Table 2-22: PictBridge commands Command Description PICTBridge:DEF Set the next six options to default PICTBridge:PAPERSIZE Set or query the paper size PICTBridge:IMAGESIZE Set or query the image size PICTBridge:PAPERTYPE Set or query the paper type PICTBridge:PRINTQUAL Set or query the print quality PICTBridge:DATEPRINT Set or query the date print PICTBridge:IDPRINT...
Page 44
Command Groups Table 2-24: Power Measurement commands (TPS2000B/TPS2000 with TPS2PWR1 only) (cont.) Command Description HARmonics:HRMS? Return the frequency of the selected harmonic HARmonics:PERCent? Return the amplitude of the selected harmonic as a percent of the fundamental HARmonics:PHAse? Return the phase of the selected harmonic, in degrees, relative to the fundamental HARmonics:RMS? Return the amplitude of the harmonics...
Page 45
Command Groups Table 2-24: Power Measurement commands (TPS2000B/TPS2000 with TPS2PWR1 only) (cont.) Command Description SWLoss:LEVELS Return oscilloscope Switching Loss Measurement settings to factory default (SWLoss:TONSTART, SWLoss:TONEND, SWLoss:TOFFSTART, SWLoss:TOFFEND only) SWLoss:LOG:CONDUCTION? Return the Conduction Loss for a switching loss measurement SWLoss:LOG:INDEX Set or query which measurement to return for a SWLoss:LOG command SWLoss:LOG:TOTAL?
Command Groups Table 2-24: Power Measurement commands (TPS2000B/TPS2000 with TPS2PWR1 only) (cont.) Command Description SWLoss:VALue:TURNOFF? Return the power loss of the device under test when the device is transitioning between its on and off state SWLoss:VALue:TURNON? Return the power loss of the device under test when the device is transitioning between its off and on state display SWLoss:VSAT...
Command Groups Table 2-26: Save and Recall commands Command Description Recall setting *RCL RECAll:SETUp Recall saved oscilloscope setting RECAll:WAVEForm Recall saved waveform *SAV Save oscilloscope setting SAVe:IMAge Save screen image to file SAVe:IMAge:FILEFormat Set screen image file format SAVe:SETUp Save oscilloscope setting SAVe:WAVEform Save waveform Status and Error Commands...
Command Groups Trend Plot Commands (TBS1000B models only) Table 2-28: Trend plot commands Command Description TRENDPLOT? Returns all trend plot parameters (TBS1000B models only) TRENDPLOT:STATE Returns the running state of the trend plot (TBS1000B models only) TRENDPLOT:TIME Queries the elapsed time (TbS1000B models only) TRENDPLOT:TP<x>:AVG? Queries the current statistical average value...
Page 49
Set or query the edge trigger coupling TRIGger:MAIn:EDGE:SLOpe Set or query the edge trigger slope TRIGger:MAIn:EDGE:SOUrce Set or query the edge trigger source TRIGger:MAIn:FREQuency? Return trigger frequency value (TBS1000B/EDU,TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS10000, TPS2000B, and TPS2000 only) TRIGger:MAIn:HOLDOff? Return trigger holdoff value TRIGger:MAIn:HOLDOff:VALue...
Set or query the channel bandwidth CH<x>:COUPling Set or query the channel coupling CH<x>:CURRENTPRObe Set or query the scale settings for current probes (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 only) CH<x>:INVert Set or query the channel invert CH<x>:POSition...
Page 51
Command Groups waveform. One data value usually represents one data point in the waveform record. When working with peak-detect waveforms, each data value is either the min or max of a min/max pair. Before you can transfer waveform data, you must specify the data format and waveform locations.
Page 52
Set or query the vertical position WFMPre:YUNit Set or query the vertical units WFMPre:YZEro Set or query the waveform conversion factor (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, TPS2000, and TDS200 with TDS2MM module only. Waveform Data Formats Internally, the oscilloscope uses one 8-bit data byte to represent each waveform data point, regardless of the acquisition mode.
Page 53
Command Groups CURVE<space>-110,-109,-110,-110,-109,-107,-109,-107, -106,-105,-103,-100,-97,-90,-84,-80 Binary data can be represented by signed integer or positive integer values. The range of the values depends on the byte width specified. Table 2-32: Binary data ranges Byte width Signed integer range Positive integer range -128 to 127 0 to 255 -32,768 to 32,767...
first data point in the waveform record. 5. Use the WFMPre? command to transfer waveform preamble information. 6. Use the CURVe command to transfer waveform data. Zoom Commands (TBS1000B/EDU models only) These commands support the zoom feature. 2-36 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Page 55
Sets or queries the zoom factor of a particular zoom box (TBS1000B models only) ZOOM:HORizontal:POSition Sets or queries the horizontal position of a particular zoom box (TBS1000B/EDU models only) ZOOM:HORizontal:SCAle? Queries the zoom window current time scale (TBS1000B/EDU models only)
Page 56
Command Groups 2-38 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
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: No query form exists for commands identified as "No Query Form" A question mark (?) appended to the command and "Query Only"...
Page 58
Command Descriptions 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. Waveforms are the displayed data point values taken from acquisition intervals. Each acquisition interval represents a time duration that is determined by the horizontal scale (time per division).
Page 59
ACQuire:NUMACq to zero. TDS200: changing the vertical position does not reset the value TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, 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 60
Command Descriptions Syntax ACQuire:NUMAVg <NR1> ACQuire:NUMAVg? Arguments is the number of waveform acquisitions. Correct values are 4, 16, 64, <NR1> and 128. Examples specifies that an averaged waveform will show the result of ACQUIRE:NUMAVG 16 combining 16 separately acquired waveforms. ? might return , indicating that there are 64 acquisitions ACQUIRE:NUMAVG...
Page 61
Command Descriptions ACQuire:STOPAfter Tells the oscilloscope when to stop taking acquisitions. Group Acquisition Syntax ACQuire:STOPAfter { RUNSTop | SEQuence} ACQuire:STOPAfter? Arguments specifies that the run and stop states should be determined by pressing RUNSTop the front-panel RUN/STOP button or issuing the ACQuire:STATE command. specifies "single sequence"...
Page 62
ALLEV 2225,"MEASUREMENT ERROR, NO WAVEFORM TO MEASURE; ",420,"QUERY UNTERMINATED; " AUTORange (No Query Form) Returns current settings. AUTORange Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Miscellaneous Syntax AUTORange Examples...
Page 63
AUTORange:SETTings Controls the parameters that the Autorange function can adjust. It is equivalent to the option buttons in the Autorange menu. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Miscellaneous...
Page 64
Service Diag menu. To access the menu, refer to the your product service manual. Conditions This command applies to the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only. It is not applicable to TBS1000B/EDU models. Group Miscellaneous...
Page 65
If the current menu is not the Autoset menu, or if the view is not valid for the detected waveform, the set command causes the oscilloscope to generate error 221 (Settings conflict). Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only. Group...
Page 66
Command Descriptions Examples will display video signals synchronized on even fields AUTOSET:VIEW EVEN when operated in autoset mode. BUSY? (Query Only) Returns the status of the oscilloscope. This command allows you to synchronize the operation of the oscilloscope with your application program. (See page 3-7, Synchronization Methods.) Certain oscilloscope operations can affect the response.
Page 67
Command Descriptions Syntax *CAL? Related Commands CALibrate:INTERNAL Returns 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 performs a self-calibration and might return 0 to indicate that it completed *CAL? successfully.
Page 68
Command Descriptions Syntax CALibrate:CONTINUE Examples performs the next step in the factory calibration operation. CALIBRATE:CONTINUE CALibrate:FACtory (No Query Form) NOTE. You should only use this command in a qualified service environment. For more information about the factory calibration sequence, refer to the service manual for your oscilloscope.
Page 69
Command Descriptions Syntax CALibrate:INTERNAL Related Commands *CAL? Examples performs an internal self-calibration. CALIBRATE:INTERNAL CALibrate:STATUS? (Query Only) Returns the status of the last calibration operation performed (either self- or factory-calibration) since power on. Group Calibration and Diagnostic Syntax CALibrate:STATUS? Returns indicates that the oscilloscope completed the last calibration operation PASS without detecting any errors.
Page 70
70 MHz, 100 MHz, or 200 MHz (depending on the oscilloscope model). There are exceptions: For TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series: At vertical scales from 2.00 to 4.99 mV/div (sensitivity at the BNC; that is, after the probe factor is removed), the full bandwidth is 20 MHz.
Page 71
You can issue this command when CH<x>:YUNit <QString> is set to V. However, this command only affects the readouts when CH<x>:YUNit <QString> is set to A. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Vertical Syntax CH<x>:CURRENTPRObe {0.2 | 1 | 2 | 5 | 10 | 50 | 100 | 1000}...
Page 72
Command Descriptions Arguments sets the specified oscilloscope channel to 0.2X attenuation. sets the specified oscilloscope channel to 1X attenuation. sets the specified oscilloscope channel to 2X attenuation. sets the specified oscilloscope channel to 5X attenuation. sets the specified oscilloscope channel to 10X attenuation. sets the specified oscilloscope channel to 50X attenuation.
Page 73
Command Descriptions Examples inverts the signal on channel 1. CH1:INVERT ON might return , indicating that channel 2 is not inverted. CH2:INVERT? CH<x>:POSition Sets or queries the vertical position 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 74
Arguments sets the specified oscilloscope channel to 1X attenuation. sets the specified oscilloscope channel to 10X attenuation. sets the specified oscilloscope channel to 20X attenuation. (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only) sets the specified oscilloscope channel to 50X attenuation. (TBS1000B/EDU,...
Page 75
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. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group...
Page 76
Command Descriptions Syntax CH<x>:YUNit <QString> CH<x>:YUNit? Arguments is either "V" for volts or "A" for amps. This is equivalent to setting <QString> the probe to Voltage or Current in the probe front-panel menu. This command is case insensitive. Examples might return , indicating that the channel 2 units CH2:YUNIT CH2:YUNIT "V"...
Page 77
Command Descriptions Syntax COUNTERFreq? COUNTERFreq:CH1Level Sets or queries the CH1 trigger level value. Group Counter Syntax COUNTERFreq:CH1Level <x> COUNTERFreq:CH1Level? COUNTERFreq:CH1State Sets or queries the CH1 counter frequency to be on or off. Group Counter Syntax COUNTERFreq:CH1State { OFF | ON | 1 | 0 } COUNTERFreq:CH1State? Examples turns off the CHQ counter frequency feature.
Page 78
Command Descriptions Syntax COUNTERFreq:CH2Level <x> COUNTERFreq:CH2Level? COUNTERFreq:CH2State Sets or queries the CH2 counter frequency to be on or off. Group Counter Syntax COUNTERFreq:CH2State { OFF | ON | 1 | 0 } COUNTERFreq:CH2State? Examples turns on the CHQ counter frequency feature. COUNTERFreq:CH2State ON COUNTERFreq:CH2Value? (Query Only) Returns the CH2 counter frequency value.
Page 79
Command Descriptions 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. Setting the function to anything other than OFF causes the Cursor menu to be displayed. NOTE.
Page 80
Command Descriptions CURSor:HBArs:DELTa? (Query Only) Returns the difference (in vertical units) between the two horizontal bar cursors in the oscilloscope display. NOTE. If Trigger View is active, this query returns 9.9E37 and generates event 221 (Settings conflict). Group Cursor Syntax CURSor:HBArs:DELTa? Returns <NR3>...
Page 81
(FFT only) indicates that Trigger View is active. This also generates event message UNKNOWN 221. (Settings conflict) indicates amperes as the unit of measure. (TBS1000B/EDU, TBS1000, AMPS TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only) indicates volts squared (V*V) as the unit of measure.
Page 82
Command Descriptions CURSor:SELect:SOUrce Sets or queries the waveform that is the source of the vertical and horizontal scale factors used in determining cursor values. This command is equivalent to setting the Source option in the Cursor menu. Group Cursor Syntax CURSor:SELect:SOUrce <wfm>...
Page 83
TDS3000 Series. NOTE. If Trigger View is active, this query returns 9.9E37 and generates event 221 (Settings conflict). Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Cursor Syntax...
Page 84
Command Descriptions Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Cursor Syntax CURSor:VBArs:HPOS<x>? Related Commands CURSor:HBArs:UNIts? Returns indicates the amplitude value at the selected position. <NR3> Examples might return , indicating the value of one vertical CURSOR:VBARS:HPOS1? 1.37...
Page 85
Command Descriptions might return , indicating the first vertical CURSOR:VBARS:POSITION1? 1.00E-6 bar cursor is at 1 μs. CURSor:VBArs:SLOPE? (Query 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.
Page 86
CURSor:VBArs:VDELTa? (Query Only) Returns the vertical (amplitude) difference between the two vertical bar cursors. The units are specified by the CURSor:HBArs:UNits query. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Cursor...
Page 87
Command Descriptions Refer to Waveform Commands for a description of the waveform transfer process. (See page 2-32.) Group Waveform Syntax CURVe { <Block> | <asc curve> } CURVe? Related Commands DATa Arguments is the waveform data in binary format. The waveform is formatted as: <Block>...
Page 88
Command Descriptions Examples reinitializes the waveform data settings to their factory defaults: DATA INIT DESTINATION = REFA (=TARGET) ENCDG = RIBINARY SOUrce = CH1 START = 1 STOP = 2500 WIDTH = 1 ? might return the following string: DATA DATA:ENCDG RPBINARY;DESTINATION REFA;...
Page 89
Command Descriptions Syntax DATa:ENCdg { ASCIi | RIBinary | RPBinary | SRIbinary | SRPbinary } DATa:ENCdg? Related Commands WFMPre:ENCdg, WFMPre:BN_Fmt Arguments specifies the ASCII representation of signed integer (RIBinary) data. If ASCIi this is the value at power-on, the WFMPre values for BN_Fmt, BYT_Or, and ENCdg are set as RP, MSB, and ASC respectively.
Page 90
<wfm> oscilloscope to the external device. Allowable values are CH<x>, MATH, and REF<x>. For TBS1000B/EDU models, FFT is also permitted. Examples specifies that reference waveform REFB will be transferred DATA:SOURCE REFB in the next CURVe? query.
Page 91
Sets or queries the location for storing waveform data transferred from an external device to the oscilloscope when executing the CURVe command. This command is equivalent to the DATa:DESTination command and is included here for compatibility with older Tektronix oscilloscopes. Group Waveform...
Page 92
Command Descriptions DATa:WIDth Sets the number of bytes per waveform data point to be transferred when executing the CURVe command. (Changing DATa:WIDth may change the following WFMPre parameters: BIT_Nr, BYT_Nr, YMULt, YOFf, and YZEro.) Group Waveform Syntax DATa:WIDth <NR1> DATa:WIDth? Related Commands CURVe, WFMPre:BIT_Nr...
Page 94
Sets or queries the oscilloscope date value. The oscilloscope uses these values to time stamp files saved to the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or to the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only), as well as show the time and date on the oscilloscope display.
Page 95
Command Descriptions Arguments is a date in the form "yyyy-mm-dd". <QString> Examples sets the date to May 6th, 2010. DATE "2010-05-06" *DDT (No Query Form) Lets you specify a command or a list of commands to execute when the oscilloscope receives a *TRG command, or the GET GPIB interface message, or the USBTMC TRIGGER message.
Page 96
Command Descriptions Related Commands *CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE Arguments is an integer value in the range from 0 to 255. The binary bits of DESER <NR1> 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 97
Group Display Syntax DISplay? Returns The current display settings Examples might return DISPLAY? DISPLAY:FORMAT YT;STYLE VECTORS; PERSISTENCE OFF;CONTRAST 50; INVERT OFF DISplay:BACKLight Sets the backlight value. Conditions TBS1000B/EDU models only. Group Display TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-79...
Page 98
DISplay:CONTRast Sets or queries the contrast of the LCD display. This command is equivalent to setting the Contrast option in the Display menu. The TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, and TDS2000B Series do not support command and the display contrast feature.
Page 99
Display Style option in the Utility Options menu for the TDS1000B and TDS1000 Series. The TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS2000, TPS2000B, 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.
Page 100
Command Descriptions Group Display Syntax DISplay:INVert { ON | OFF} DISplay:INVert? Arguments chooses a default black-on-white display. chooses a white-on-black display. Examples might return OFF. DISPLAY:INVERT DISplay:PERSistence Sets the length of time that data points are displayed. Group Display Syntax DISplay:PERSistence { 1 | 2 | 5 | INF | OFF } DISplay:PERSistence? Arguments...
Page 101
Command Descriptions Group Display Syntax DISplay:STYle { DOTs | VECtors } DISplay:STYle? Arguments displays individual data points. DOTs connects adjacent data points. VECtors Examples sets the display to connect adjacent data points. DISPLAY:STYLE VEC might return indicating that the display shows individual DISPLAY:STYLE DOTS waveform data points.
Page 102
Command Descriptions *ESE (No Query Form) 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). (See page 3-1, Status and Events.) Group Status and Error Syntax *ESE <NR1>...
Page 103
Command Descriptions Returns Contents of the Standard Event Status Register. Examples might return the value , showing that the SESR contains binary *ESR? 11010101. EVENT? (Query Only) Returns from the Event Queue an event code that provides information about the results of the last *ESR? read.
Page 104
Command Descriptions <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> and <Command>...
Page 105
Command Descriptions Syntax FACtory Setting the oscilloscope to factory default has the following impact on the programming interface: Clears the Event Status Enable Register Clears the Service Request Enable Register Sets the Device Event Status Enable Register to 255 Sets the Power On Status Clear Flag to TRUE Enables all Command Headers (HEADer ON) Sets the macro defined by *DDT to a "zero-length field"...
Page 106
The root <folder path> folder is A:\ for non-TBS1000B/EDU models and is /usb0/ for TBS1000B/EDU models. If there is no CompactFlash card or USB flash drive installed in the oscilloscope, the query returns a null string.
Page 107
file name of the <file path> file to delete. The root directory is “A:\” for non-TBS1000B/EDU models and is “/usb0/” for TBS1000B/EDU models. You cannot use an asterisk (*) wild card character to delete multiple files.
Page 108
TPS2000B/TPS2000 Series only), or the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B and TDS1000B Series only) to format. Valid non-TBS1000B/EDU drive values are "A:" and "a:". The valid TBS1000B/EDU drive value is "/usb0/". Using any other drive value returns an error.
Page 109
(TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2MEM, TPS2000B, and TPS2000 Series only. Group File system...
Page 110
FILESystem:REName (No Query Form) Assigns a new name to a file or folder on the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). You can also move a file or folder by specifying the new name in a different folder.
Page 111
(TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2MEM, TPS2000B, and TPS2000 Series only. Group File system Syntax FILESystem:RMDir <folder path>...
Page 112
2ND-RUN in the folder /usb0/PROD-TST. deletes the folder VID-EVAL in the current FILESYSTEM:RMDIR "VID-EVAL" working folder. FFT? (Query Only) Returns all FFT parameters. Conditions TBS1000B/EDU models only. Group Syntax FFT? FFT:HORizontal:POSition Sets or queries the FFT horizontal display position. Conditions TBS1000B/EDU models only.
Page 113
Command Descriptions FFT:SOURce Sets or queries the FFT source. Conditions TBS1000B/EDU models only. Group Syntax FFT:SOURce { CH1 | CH2 } FFT:SOURce? FFT:SRCWFM Sets or queries the FFT source waveform display state. Conditions TBS1000B/EDU models only. Group Syntax FFT:SRCWFM { ON | OFF }...
Page 114
TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series, you can only set the port to USB and the query will always return USB). The TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes provide PictBridge printer support through a USB Device port on the rear of the oscilloscope. PictBridge Commands(See page 2-24, PictBridge Commands (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Only).)
Page 115
Sets or returns the current PRINT front-panel button function. NOTE. This command does not affect the HARDCopy STARt command. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2MEM, , TPS2000B, and TPS2000 Series only. Group Hard copy...
Page 116
(waveforms, screen image, settings) to files in a new subfolder in the current CompactFlash card folder (TDS2MEM and TPS2000B/TPS2000 Series only), or in the current USB flash drive folder (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). sets the PRINT button to save the screen image to a file on the SAVESImage CompactFlash card or on the USB flash drive.
Page 117
Command Descriptions Arguments (non-TBS1000B/EDU Series only) sets the hard copy output format to Microsoft Windows Bitmap format. (TDS1000, TDS2000, TPS2000, and TPS2000B Series only) sets the BUBBLEJet hard copy output format to Canon Bubblejet format. (TDS200, TDS1000, TDS2000, TPS2000, and TPS2000B Series only) DESKjet sets the hard copy output format to HP DeskJet format.
Page 118
TDS1000B, TDS2000, TPS2000B, and TPS2000 Ink Saver feature to on or off. This command is equivalent to setting the Ink Saver option in the UTILITY > Options > Printer Setup menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TPS2000B, and TPS2000 oscilloscopes.
Page 119
Command Descriptions Only TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes are compatible with PictBridge printers. When printing to a PictBridge printer, the printer determines the orientation and will override the argument. Group Hard copy Syntax HARDCopy:LAYout { LANdscape | PORTRait }...
Page 120
Device port on the back of a TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, or TDS1000B Series oscilloscope only. Examples might return RS232 as the selected hard copy output port.
Page 121
Command Descriptions Syntax HARmonics:ENABle { ON | OFF } HARmonics:ENABle? Arguments causes the oscilloscope to display the harmonics menu and turn on Harmonics analysis. causes the oscilloscope to display the CH1 menu. Examples causes the oscilloscope to display the harmonics menu. HARMONICS:ENABLE ON ? might return , indicating that the harmonics menu...
Page 122
Command Descriptions HARmonics:PERCent? (Query Only) Returns the amplitude of the selected harmonic as a percent of the fundamental. Group Power Measurement Syntax HARmonics:PERCent? Examples might return , indicating that the amplitude of the HARMONICS:PERCENT? selected harmonic as a percent of the fundamental frequency is 5.0%. HARmonics:PHAse? (Query Only) Returns the phase of the selected harmonic, in degrees, relative to the fundamental.
Page 123
Command Descriptions The following data is included in the file: Harmonics, 1 through 50 Magnitude Percent of fundamental Frequency Phase angle NOTE. You can view the contents of the saved file on your personal computer. You cannot recall saved harmonics files to the oscilloscope. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only.
Page 124
Command Descriptions Arguments specifies the harmonic from 1 to 50. <NR1> Examples instructs the oscilloscope to select the first harmonic. HARMONICS:SELECT 1 ? might return , indicating that the third harmonic is HARMONICS:SELECT selected. HARmonics:SETUp Sets or queries the operating mode of harmonics measurements. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only.
Page 125
Command Descriptions Arguments displays both odd and even harmonics. displays odd harmonics only. displays even harmonics only. EVEN Examples instructs the oscilloscope to display all harmonics. HARMONICS:SHOW ALL ? might return , indicating that HARMONICS:SHOW HARMONICS:SHOW ODD instrument displays only the odd harmonics. HARmonics:SOUrce Sets the source in the power menu.
Page 126
, indicating that the HARMONICS:THDR? 1.1094271493299E1 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. Group Miscellaneous Syntax HEADer Sets and queries the Response Header Enable State that causes the oscilloscope to either include or omit headers on query responses.
Page 127
Returns all settings for the window time base. The commands HORizontal:DELay:SECdiv and HORizontal:DELay:SCAle are equivalent, so only the values for HORizontal:DELay:SCAle are returned. Conditions This command is NOT applicable to TBS1000B/EDU models. TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-109...
Page 128
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. Conditions This command is NOT applicable to TBS1000B/EDU models. Group Horizontal Syntax HORizontal:DELay:POSition <NR3>...
Page 129
HORIZONTAL:DELAY:SCALE 1.0E-3 scale is 1 ms per division. 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. Conditions This command is NOT applicable to TBS1000B/EDU models. Group...
Page 130
Command Descriptions Returns All settings for the main time base. Examples might return HORIZONTAL:MAIN? HORIZONTAL:MAIN:POSITION 0.0E0;SCALE 5.0E-4 HORizontal:MAIn:POSition Sets or queries the main time base horizontal position. This command is equivalent to adjusting the Horizontal Position when Main is selected from the Horizontal menu.
Page 131
-1.0E-3 position is 1 ms after the center graticule. HORizontal:RECOrdlength? (Query Only) Returns the number of acquisition data points. For TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TDS200, TPS2000B, 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.
Page 132
Specifies whether the horizontal display uses the Main, Window Zone, or Window view. This is equivalent to setting the View in the Horizontal menu. Conditions This command is NOT applicable to TBS1000B/EDU models. 2-114 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Page 133
HORIZONTAL:VIEW MAIN 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 134
Returns the oscilloscope identification in the following format for TPS2000B/TPS2000 oscilloscopes: ID TEK/<model number>,CF:91.1CT FV:v<oscilloscope firmware version number> TPS2XXXV:v<module firmware version number> Returns the oscilloscope identification in the following format for TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes: ID TEK/<model number>,CF:91.1CT FV:v<oscilloscope firmware version number> Examples might return the following response with a TDS2CMA installed: TEK/TDS 220,CF:91.1CT,FV:V1.00 TDS2CM:CMV:V1.00...
Page 135
Returns the oscilloscope identification in the following format for TPS2000B/TPS2000 oscilloscopes: TEKTRONIX,<model number>,CF:91.1CT FV:v<oscilloscope firmware version number> TPS2XXXV:v<module firmware version number> Returns the oscilloscope identification in the following format for TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes: TEKTRONIX/<model number>,<serial number>, CF:91.1CT FV:v<oscilloscope firmware version number> Examples...
Page 136
Command Descriptions Syntax LANGuage { ENGLish | FRENch | GERMan | ITALian | SPANish | JAPAnese | PORTUguese | KOREan | TRADitionalchinese | SIMPlifiedchinese } LANGuage? Arguments Specifies the language used to display oscilloscope information on the screen. Examples specifies that the oscilloscope displays information in French. LANGUAGE FRENch ? might return LANGUAGE...
Page 137
Command Descriptions Arguments REF<x> is a reference waveform, where <x> is 1, 2, 3, or 4. Examples LIMIT:COMPARE REF1 specifies REF1 as the template waveform against which to compare waveforms acquired on the specified channel. LIMIT:COMPARE might return: , indicating that waveforms acquired will be compared to the REF4 limit test template waveform stored in REF4.
Page 138
Command Descriptions Examples LIMIT:RESULT:PASS? might return: , indicating that 25 test cases were detected as passing. LIMit:RESUlt:TOTAL? (Query Only) Returns the number of total cases tested. Conditions TBS1000B, TBS1000 and TDS2000C Series models only. Group Limit Test Syntax LIMit:RESUlt:TOTAL? Related Commands LIMit:RESUlt:FAIL?, LIMit:RESUlt:PASS? Examples...
Page 139
Command Descriptions ON or <NR1> ≠ 0 turns on the function to save waveform image data to the flash drive for limit testing. Examples LIMIT:SAVEIMAGE turns on the function to save waveform image data to the flash drive for limit testing.
Page 140
Command Descriptions Group Limit Test Syntax LIMit:SOUrce { CH<x> | MATH } LIMit:SOUrce? Related Commands LIMit:TEMPLate:SOUrce Arguments CH<x> specifies that the source channel for the waveform currently being compared to the test template. specifies the source channel as the math waveform. MATH Examples MATH...
Page 141
Command Descriptions Conditions TBS1000B, TBS1000 and TDS2000C Series models only. Group Limit Test Syntax LIMit:STOPAfter:MODe { MANual | WAVEform | VIOLation | TIMe } LIMit:STOPAfter:MODe? Related Commands LIMit:STOPAfter:TIMe, LIMit:STOPAfter:VIOLation, LIMit:STOPAfter: WAVEform Arguments MANual causes the test to stop after an operator manually stops it. WAVEform causes the test to stop after the oscilloscope tests a specified number of waveforms.
Page 142
Command Descriptions Examples LIMIT:STOPAFTER:TIME sets the limit test to run for 10 seconds. LIMit:STOPAfter:VIOLation Sets or returns the limit test stop after violation setting. The test will automatically stop after it detects the specified number of violations. Conditions TBS1000B, TBS1000 and TDS2000C Series models only. Group Limit Test Syntax...
Page 143
Command Descriptions Examples 1000 LIMIT:STOPAFTER:WAVEFORM sets the limit test to run until it has tested 1000 waveforms. LIMit:TEMPLate (No Query Form) Uses the values specified by LIMit:TEMPLate:SOUrce, LIMit:TEMPLate:TOLerance:HORizontal, and LIMit:TEMPLate:TOLerance:VERTical to create a limit test template and store the template in the reference waveform memory location specified in LIMit:TEMPLate:DESTination.
Page 144
Command Descriptions Syntax LIMit:TEMPLate:DESTination REF<x> LIMit:TEMPLate:DESTination? Related Commands LIMit:TEMPLate, LIMit:TEMPLate:SOUrce, LIMit:TEMPLate:TOLerance: HORizontal, LIMit:TEMPLate:TOLerance:VERTical Arguments REF<x> specifies the reference waveform destination in which the template waveform is to be stored. Examples LIMIT:TEMPLATE:DESTINATION REF2 specifies that the template waveform referred to with the LIMit:TEMPLate APPLY command is stored as the REF2 waveform.
Page 145
Command Descriptions LIMit:TEMPLate:SAVESECSource (No Query Form) Save the second template source data information temporarily for applying the template. It will not save to REFA. Conditions TBS1000B models only. Group Limit Test Syntax LIMit:TEMPLate:SAVESECSource LIMit:TEMPLate:SAVESOUrce (No Query Form) Saves the template source data for single waveform templates. Conditions TBS1000B models only Group...
Page 146
Command Descriptions Arguments CH<x> specifies that the template waveform source is the waveform currently being acquired using the specified channel. specifies the template waveform source channel as the math waveform. MATH Examples LIMIT:TEMPLATE:SOURCE CH2 specifies that the template waveform for limit tests is the waveform currently acquired using channel 2.
Page 147
Command Descriptions LIMit:TEMPLate:TOLerance:VERTical Sets or returns the amount, in units of vertical divisions, by which the source waveform is varied vertically when creating the destination template waveform. Conditions TBS1000B, TBS1000 and TDS2000C Series models. Group Limit Test Syntax LIMit:TEMPLate:TOLerance:VERTical <NR3> LIMit:TEMPLate:TOLerance:VERTical? Related Commands LIMit:TEMPLate, LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce,...
Page 148
Command Descriptions *LRN? (Query Only) This is identical to the SET? query. Miscellaneous Group Miscellaneous Syntax *LRN? MATH? (Query Only) Returns the definition for the math waveform. Group Math Syntax MATH? Returns Definition for the math waveform. Examples might return the following for an FFT waveform: MATH? MATH:DEFINE "FFT(CH1,HANNING)";VERTICAL:POSITION 0.0E0;SCALE...
Page 149
You can use this FFT example with TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series oscilloscopes, as well as a TDS200 Series oscilloscope with a TDS2MM measurement module. It is not applicable for TBS1000B/EDU models. TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer 2-131...
Page 150
TDS200 oscilloscope with a TDS2MM measurement module. This command is NOT applicable for the TBS1000B Returns the current MATH:FFT display settings. Conditions This command is not applicable for the TBS1000B/EDU. Group Math Syntax MATH:FFT? Examples...
Page 151
TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement module. Sets or queries the FFT math waveform horizontal zoom factor. Conditions This command is not applicable for the TBS1000B/EDU Group Math Syntax MATH:FFT:HORizontal:SCAle <NR3>...
Page 152
TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 oscilloscopes, as well as a TDS200 oscilloscope with a TDS2MM measurement module. Sets or queries the FFT math waveform vertical position. Conditions This command is not applicable for the TBS1000B/EDU. Group Math Syntax MATH:FFT:VERtical:POSition <NR3>...
Page 153
, indicating the math waveform position and scale. 5.0E-1 MATH:VERtical:POSition Sets or returns the math waveform display position. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group Math Syntax MATH:VERtical:POSition <NR3>...
Page 154
This command typically rounds down to an achievable value. If the value input is below the minimum value, then the command will round up. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only. Group...
Page 155
Command Descriptions CH2; MEASUREMENT:MEAS4:TYPE MEAN;UNITS "V";SOURCE CH2; :MEASUREMENT:IMMED:TYPE CRMS;UNITS "V";SOURCE CH1 MEASUrement:CLEARSNAPSHOT (No Query Form) Clears the existing snapshop results and removes the snapshot window. Conditions TBS1000B/EDU models only. Group Measurement Syntax MEASUrement:CLEARSNAPSHOT MEASUrement:GATing Sets or returns the measurement gating.
Page 156
The value of <x> can vary from 1 through 4 for 4-channel instruments or 1 through 2 for 2-channel instruments. specifies the measurement source channel as the math waveform. MATH (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series only) Examples specifies channel 1 as the immediate MEASUREMENT:IMMED:SOURCE CH1 measurement source.
Page 157
Root Mean Square voltage of the first complete cycle in the CRMs waveform. (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU Series) CURSORRms is the true Root Mean Square (RMS) value of the selected waveform data, between the start point and the end point.
Page 158
Command Descriptions (TBS1000, TDS2000C, TDS1000C-EDU Series) (not applicable for DELay TBS1000B/EDU models) is the delay from one waveform's edge event to another. (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, FALL TDS1000B, TDS2000, TDS1000, TDS200 Series with a TDS2MM measurement module, TPS2000B, and TPS2000 Series only) is the fall time between 90% and 10% of the first falling edge of the waveform.
Page 159
(TBS1000B/EDU Series only) is the between the mid reference (default DELAYFF 50%) amplitude point of the two different falling waveforms. (TBS1000B/EDU Series only) is the high value less the low value AMplitude measured over the entire waveform or gated region.
Page 160
This value is measured over the entire waveform or gated region. (TBS1000B/EDU Series only) is the ratio of the negative pulse width to NDUty the signal period expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.
Page 161
Syntax MEASUrement:IMMed:UNIts? Returns returns "V" for volts, "s" for seconds, or "Hz" for Hertz. <QString> For the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series, <QString> can also return the following: A for amps VA for volt-amperes AA for amperes*amperes VV for volts*volts You can also use this command for undefined math waveforms.
Page 162
<x>. Where <x> identifies the measurement, 1 through 4 for the TDS200 Series, and 1 through 5 for the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series, and 1 through 6 for the TBS1000B/EDU Series. Measurement Group Syntax MEASUrement:MEAS<x>?
Page 163
4 for the TDS200 Series, and 1 through 5 for the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series, and 1 through 6 for the TBS1000B/EDU Series. This is equivalent to selecting the measurement type in the MEASURE menu.
Page 164
(TBS1000, TDS2000C, TDS1000C-EDU Series) (not applicable for DELay TBS1000B/EDU models) is the delay from one waveform's edge event to another. (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, FALL TDS1000B, TDS2000, TDS1000, TDS200 Series with a TDS2MM measurement module, TPS2000B, and TPS2000 Series only) is the fall time between 90% and 10% of the first falling edge of the waveform.
Page 165
(TBS1000B/EDU Series only) is the between the mid reference (default DELAYFF 50%) amplitude point of the two different falling waveforms. (TBS1000B/EDU Series only) is the high value less the low value AMplitude measured over the entire waveform or gated region.
Page 166
This value is measured over the entire waveform or gated region. (TBS1000B/EDU Series only) is the ratio of the negative pulse width to NDUty the signal period expressed as a percentage. The duty cycle is measured on the first cycle in the waveform or gated region.
Page 167
MEASUrement:MEAS<x>:TYPe. Where <x> identifies the measurement, 1 through 4 for the TDS200 Series, and 1 through 5 for the TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series, and 1 through 6 for the TBS1000B/EDU Series. Group Measurement Syntax MEASUrement:MEAS<x>:UNIts?
Page 168
(no waveform to measure). Group Measurement Syntax MEASUrement:MEAS<x>:VALue? Returns <NR3> Examples might return if measurement number MEASUREMENT:MEAS3:VALUE 28.75E6 three is frequency. MEASUrement:SNAPSHOT (No Query Form) Sets the measurement snapshot feature. Conditions TBS1000B/EDU models only. 2-150 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Page 169
Command Descriptions Measurement Group Syntax MEASUrement:SNAPSHOT MEASUrement:SNAPSOUrce Sets or returns the snapshot source. Conditions TBS1000B/EDU models only. Group Measurement Syntax MEASUrement:SNAPSOUrce { CH1 | CH2 | MATH } MEASUrement:SNAPSOUrce? *OPC Generates the operation complete message in the Standard Event Status Register (SESR) when all pending commands that generate an OPC message are complete.
Page 170
This command is equivalent to setting all the options to default in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes.
Page 171
This command is equivalent to setting the ID Print option in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes.
Page 172
This command is equivalent to setting the Paper Size option in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only. Group PictBridge Syntax...
Page 173
Sets the type of paper from those available on the compatible printer. This command is equivalent to setting the Paper Type option in the UTILITY > Options > Printer Setup > PRINT Button > Prints menu of TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B oscilloscopes.
Page 174
Command Descriptions prints a low quality hard copy. DRAFT Examples ? might return as the quality of the print. PICTBRIDGE:PRINTQUAL DRAFT POWer? (Query Only) Returns the current POWer measurement settings. Group Power and Battery-Related Syntax POWer? Examples might return the following: POWER? POWER:AC:PRESENT 1;:POWER:BATTERY1:GASGAUGE 0 ;STATUS...
Page 175
Command Descriptions Group Power and Battery-Related Syntax POWer:BATTERY<x>:GASgauge? Returns , a number between 0 and 100, indicates the charge remaining in the <NR1> battery. 0 indicates the battery is fully discharged. 100 indicates the battery is fully charged. Examples might return , specifying that battery 1 is POWER:BATTERY1:GASGAUGE? 60% charged.
Page 176
Command Descriptions Syntax POWer:BATTERIES:TIME? Returns specifies the operating time remaining for both batteries in minutes. <NR1> Examples might return , specifying that the battery or POWER:BATTERIES:TIME? batteries installed can provide about 10 minutes of power to the oscilloscope. POWer:BUTTONLIGHT Turns the lights on the front-panel buttons of the TPS2000 Series and TPS2000B Series on and off.
Page 177
Command Descriptions Arguments selects Channel 1 and Channel 2 as the power analysis source. CH1CH2 selects Channel 3 and Channel 4 as the power analysis source. CH3CH4 NOTE. The "CH3CH4" argument is only valid for instruments with four channels. Examples specifies Channel 1 and Channel 2 as the POWERANALYSIS:SOURCES CH1CH2 power analysis source.
Page 178
Restores a stored or factory front-panel setup of the oscilloscope from internal nonvolatile memory, or from a file on the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only).
Page 179
TDS1000B Series only). RECAll:WAVEForm (No Query Form) Recalls a stored waveform from the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or from the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only) into a reference location. Conditions...
Page 180
Command Descriptions Examples loads the waveform RECALL:WAVEFORM "A:\TST-PRD\TST-01.CSV", REFC file TST-01.CSV into reference memory RefC. Then use SELect:REFC to display this waveform. REM (No Query Form) Specifies a comment. This line is ignored by the oscilloscope. Group Miscellaneous Syntax REM <QString> Arguments is a string that can have a maximum of 80 characters.
Page 181
Command Descriptions Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and TPS2000 Series only. Group RS-232 Syntax RS232:BAUd <NR1> RS232:BAUd? Arguments which can be 300, 600, 1200, 2400, 4800, 9600, or 19200. <NR1> Examples sets the transmission rate to 9600 baud. RS232:BAUD 9600 RS232:HARDFlagging Sets or queries the state of RS232 hard flagging.
Page 182
Command Descriptions RS232:PARity 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. When parity is none, the oscilloscope performs no input parity error checks and generates no output parity.
Page 183
Command Descriptions Conditions This command applies to the TDS2000, TDS1000, TDS200, TPS2000B, and TPS2000 Series only. Group RS-232 Syntax RS232:SOFTFlagging { ON | OFF | <NR1> } RS232:SOFTFlagging? Arguments ≠ 0 activates soft flagging and deactivates hard flagging. <NR1> = 0 deactivates soft flagging. <NR1>...
Page 184
Command Descriptions Examples sets the carriage return as the EOL RS232:TRANSMIT:TERMINATOR CR terminator. *RST (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.
Page 185
2. *SAV 2 SAVe:IMAge (No Query Form) Saves the screen image to a file on the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). Conditions...
Page 186
(TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only) sets the screen image file format to JPEG bitmap (uses a lossy file compression algorithm). (non-TBS1000B/EDU Series only) sets the screen image file format to DOS Paintbrush format. 2-168 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Page 187
Command Descriptions (non-TBS1000B/EDU Series only) sets the screen image file format to Windows color image file format (*.RLE). Use RLE for faster transfer rates and smaller resulting files. Many programs that recognize .BMP files also recognize .RLE files. (non-TBS1000B/EDU Series only) sets the screen image file format to TIFF Tagged Image File Format.
Page 188
CH<y> (one of the allowable channels) or MATH. This is the waveform <wfm> that will be saved. For TBS1000B/EDU models, <wfm> can be FFT. For TDS2MEM module and TPS2000B/TPS2000 Series, <wfm> can also be a reference waveform location (for example REF4) if the destination is <file path>.
Page 189
CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or on the USB flash drive (TBS1000, TDS200C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only). For TBS1000B/EDU models: saves the channel SAVE:WAVEFORM CH1, "/usb0/PROD-TST/FRQTST03.CSV" 1 waveform data to the file FRQTST03.CSV in the folder /usb0/PROD-TST on the USB flash drive.
Page 190
, indicating whether the REFA waveform SELECT:REFA? is displayed. SELect:FFT Sets or queries the FFT display state. Conditions TBS1000B/EDU models only. Group Syntax SELect:FFT SELect:FFT? SET? (Query Only) Returns most oscilloscope settings. You can send these responses back to the oscilloscope to return the oscilloscope to the state it was in when you sent SET.
Page 191
Command Descriptions Returns Most oscilloscope settings. See Appendix B: Factory Setup. Examples might return a partial string like the following: SET? ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE; NUMAVG 16;:HEADER 1;:VERBOSE 1;:DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 500.0E-3;CONTRAST 50;:LOCK NONE;:HARDCOPY:FORMAT EPSON;PORT RS232;LAYOUT PORTRAIT; *SRE (No Query Form) (Service Request Enable) sets and queries the bits in the Service Request Enable Register (SRER).
Page 192
Command Descriptions Related Commands *CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, FACtory Returns <NR1> Examples might return the value 96, showing that the SBR contains the binary *STB? value 01100000. SWLoss? Returns the current Switching Loss measurement settings. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only.
Page 193
Command Descriptions instructs the oscilloscope to continuously acquire waveforms and CONTINUOUS display measurements. Examples might return , indicating that SWLOSS:ACQUIRE SWLOSS:ACQUIRE CONTINUOUS the oscilloscope is continuously taking switching loss measurements. SWLoss:AVErage:CONDUCTION? (Query Only) Returns the power loss of the device under test when the device is conducting in its on state.
Page 194
Command Descriptions Power Measurement Group Syntax SWLoss:AVErage:N? Returns <NR1> Examples might return , indicating that the oscilloscope used SWLOSS:AVERAGE:N? 185 measurements to calculate the average. SWLoss:AVErage:TOTAL? (Query 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.
Page 195
Command Descriptions NOTE. This command returns error 221 (settings conflict) if the Switching Loss menu is not active. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only. Group Power Measurement Syntax SWLoss:AVErage:TURNOFF? Returns <NR3> Examples might return SWLOSS:AVERAGE:TURNOFF? 1.3790115628E-2...
Page 196
Command Descriptions SWLoss:ENABLe Sets or queries the switching loss menu, on or off. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only. Group Power Measurement Syntax SWLoss:ENABLe { ON | OFF } SWLoss:ENABLe? Arguments enables the switching loss menu. disables the switching loss menu.
Page 197
Command Descriptions SWLoss:LOG:CONDUCTION? (Query Only) Returns the Conduction Loss for the switching loss measurement specified by the SWLoss:LOG:INDEX command. NOTE. The oscilloscope generates error 221 if the SWLoss:LOG:INDEX? 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 198
Command Descriptions Arguments The default value is 1. <NR1> Examples ? might return SWLOSS:LOG:INDEX SWLoss:LOG:TOTAL? (Query 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:INDEX? 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 199
Command Descriptions Power Measurement Group Syntax SWLoss:LOG:TURNOFF? Returns <NR3> Examples might return SWLOSS:LOG:TURNOFF? 1.3477193192E-2 SWLoss:LOG:TURNON? (Query 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:INDEX? 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 200
Command Descriptions Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only. Group Power Measurement Syntax SWLoss:SAVE <filename> SWLoss:SAVE? Arguments specifies the file name and full path to save switching loss <filename> measurement data. Examples specifies the file name and path to save SWLOSS:SAVE "A:\Data2.CSV"...
Page 201
Command Descriptions SWLoss:STOPAfter Sets or queries the number of measurements used for Switching Loss measurement. Conditions This command applies to the TPS2000B/TPS2000 Series with TPS2PWR1 Power Analysis Module only. Group Power Measurement Syntax SWLoss:STOPAfter <NR1> SWLoss:STOPAfter? Related Commands SWLoss:ACQuire Arguments defines the number of measurements you want to include.
Page 202
Command Descriptions Arguments in percent. Default value is 10. <NR1> Examples ? might return , indicating that Switching Loss Turn-off SWLOSS:TOFFEND End is set to 10%. SWLoss:TONEND 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 203
Command Descriptions Syntax SWLoss:TOFFSTART <NR1> SWLoss:TOFFSTART? Arguments in percent. Default value is 10. <NR1> Examples ? might return , indicating that Switching Loss Turn-on SWLOSS:TOFFSTART End is set to 10%. SWLoss:TONSTART Sets or queries a level on the 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 204
Command Descriptions Syntax SWLoss:UNITs { WATTS | JOULES } SWLoss:UNITs? Arguments sets the measurement units to Watts. WATTS sets the measurement units to Joules. JOULES Examples ? might return , indicating that the current measurement SWLOSS:UNITS WATTS units are Watts. NOTE.
Page 205
Command Descriptions Power Measurement Group Syntax SWLoss:VALue:TOTAL? Returns <NR3> Examples might return -5.74759710834346E2 SWLOSS:VALUE:TOTAL? SWLoss:VALue:TURNOFF? (Query Only) Returns the power loss of the device under test when the device is transitioning between its on and off state. You must enter the saturation voltage of the device under test using the SWLoss:VSAT command.
Page 206
Sets or queries the oscilloscope time value. The oscilloscope uses the time and date values to time stamp files saved to the CompactFlash card (TDS2MEM and TPS2000B/TPS2000 Series only), or to the USB flash drive (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, and TDS1000B Series only), as well as show the time and date on the oscilloscope display.
Page 207
Command Descriptions Syntax TIMe <QString> TIMe? Arguments is a time in the form "hh:mm:ss", based on a 24-hour clock (00:00:00 <QString> through 23:59:59). Examples sets the time to 2:45 pm. TIME "14:45:00" TRENDPLOT? (Query Only) Returns all the trend plot parameters. Conditions TBS1000B models only.
Page 208
Command Descriptions Syntax TRENDPLOT:TIME? TRENDPLOT:TP<x>:AVG? (Query Only) Queries the current statistical average value. Returns the average value of all acquisred measured value corresponding to the channel x, which is either 1 or 2. Conditions TBS1000B models only. Group Trend plot Syntax TRENDPLOT:TP<x>:AVG? TRENDPLOT:TP<x>:MAX? (Query Only)
Page 209
Command Descriptions TRENDPLOT:TP<x>:SCALE? (Query Only) Queries the current per div scale. Conditions TBS1000B models only. Group Trend plot Syntax TRENDPLOT:TP<x>:SCALE? TRENDPLOT:TP<x>:SCALEMAX? (Query Only) Queries the maximum value to plot of the display in the current range. Conditions TBS1000B models only. Group Trend plot Syntax...
Page 210
Command Descriptions Group Trend plot Syntax TRENDPLOT:TP<x>:SOURCE { CH1 | CH2 | MATH | CH1CH2 | CH2CH1 | CH1MATH | MATHCH1 | CH2MATH | MATHCH2 } TRENDPLOT:TP<x>:SOURCE? TRENDPLOT:TP<x>:TYPe Sets or returns the trend plot type. z is 1 or 2. Conditions TBS1000B models only.
Page 211
Command Descriptions Syntax TRIGger FORCe TRIGger? Arguments creates a trigger event. If TRIGger:STATE is REAdy, the acquisition FORCe will complete; otherwise this command will be ignored. This is equivalent to selectingFORCE TRIGon the front panel. Examples forces a trigger event to occur. TRIGGER FORCE ? might return the following string: TRIGGER...
Page 212
Command Descriptions Syntax TRIGger:MAIn:EDGE? Returns Trigger coupling, source, and slope settings for the main edge trigger Examples might return TRIGGER:MAIN:EDGE? SOURCE CH1;COUPLING DC;SLOPE RISE TRIGger:MAIn:EDGE:COUPling Sets or queries the type of coupling for the edge trigger. This is equivalent to setting the Coupling option in the Trigger menu.
Page 213
Command Descriptions Arguments specifies to trigger on the falling or negative edge of a signal. FALL specifies to trigger on the rising or positive edge of a signal. RISe Examples sets the main edge trigger to occur on the TRIGGER:MAIN:EDGE:SLOPE RISE rising slope.
Page 214
Command Descriptions If the trigger type is video, the query returns 9.9e37 and generates event 221 (Settings conflict). Group Trigger Syntax TRIGger:MAIn:FREQuency? Returns Edge or pulse width trigger frequency Examples might return TRIGGER:MAIN:FREQUENCY? TRIGGER:MAIN:FREQUENCY 1.0E3 TRIGger:MAIn:HOLDOff? (Query Only) Returns the trigger holdoff value. Group Trigger Syntax...
Page 215
10 s. TRIGGER:MAIN:HOLDOFF:VALUE 10 TRIGger:MAIn:LEVel Sets the oscilloscope edge (all models) and pulse width (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only) trigger level. This command is equivalent to adjusting the front-panel TRIGGER LEVEL knob.
Page 216
Sets or queries the source for the pulse trigger. This is equivalent to setting the Source option in the Trigger menu. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only.
Page 217
Sets or queries the polarity for the pulse trigger. This is equivalent to setting the Polarity option in the Pulse Trigger menu. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only.
Page 218
Command Descriptions Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only. Group Trigger Syntax TRIGger:MAIn:PULse:WIDth:WHEN { EQual | NOTEqual | INside | OUTside } TRIGger:MAIn:PULse:WIDth:WHEN? Arguments triggers on the trailing edge of pulses of the specified width.
Page 219
Command Descriptions TRIGger:MAIn:TYPe Sets or queries the type of oscilloscope trigger. This is equivalent to setting the Type option in the Trigger menu. Group Trigger Syntax TRIGger:MAIn:TYPe { EDGE | VIDeo | PULse } TRIGger:MAIn:TYPe? Arguments is a normal trigger. A trigger event occurs when a signal passes through EDGE a specified voltage level in the specified direction and is controlled by the TRIGger:MAIn:EDGE commands.
Page 220
Command Descriptions Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only. Group Trigger Syntax TRIGger:MAIn:VIDeo:LINE <NR1> TRIGger:MAIn:VIDeo:LINE? Arguments specifies the line number. The minimum is 1. The maximum is 525 for <NR1>...
Page 221
TRIGger:MAIn:VIDeo:STANDard Sets or queries the video trigger standard. This is equivalent to selecting the Standard option in the Trigger/Video menu. Conditions This command applies to the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only. Group...
Page 222
FIELD specifies that triggering occur on the horizontal sync pulse. LINE specifies triggering on odd fields (TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, TPS2000B, and TPS2000 Series only.). specifies triggering on even fields (TBS1000B/EDU, TBS1000, TDS2000C,...
Page 223
Command Descriptions Returns indicates that the oscilloscope is acquiring pretrigger information. All ARMED triggers are ignored when TRIGger:STATE is ARMed. indicates that all pretrigger information has been acquired and the READY oscilloscope is ready to accept a trigger. indicates that the oscilloscope has seen a trigger and is acquiring the TRIGGER posttrigger information.
Page 224
Command Descriptions Arguments specifies all front-panel buttons. Examples unlocks all front-panel buttons and knobs so they can be used. UNLOCK ALL VERBose Sets and queries the Verbose state that controls the length of keywords on query responses. Keywords can be both headers and arguments. This command does not affect IEEE Std 488.2-1987 Common Commands (those starting with an asterisk).
Page 225
Command Descriptions Related Commands BUSY?, *OPC Examples prevents the oscilloscope from executing any further commands or queries *WAI until all pending commands that generate an OPC message are complete. WAVEFORMANALYSIS:SOUrce Sets or queries the Waveform Analysis source. This command is equivalent to setting the Sources option in the Waveform Analysis menu.
Page 226
Command Descriptions Syntax WAVFrm? Related Commands CURVe, DATa:SOUrce, WFMPre? Returns See WFMPre? and CURVe? commands. 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).
Page 227
Command Descriptions Table 2-36: Additional commands for compatibility (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 228
Command Descriptions Group Waveform Syntax WFMPre:BIT_Nr <NR1> WFMPre:BIT_Nr? Arguments is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8 and <NR1> DATa:WIDth * 8. Examples might return , indicating that there are 8 bits per waveform WFMPRE:BIT_NR point. WFMPre:BN_Fmt Sets or queries the format of binary data for the waveform to be transferred.
Page 229
Command Descriptions Arguments is an integer in the range of 1 to 2 that sets the number of bytes per point. <NR1> Examples specifies that there are 2 bytes per waveform data point. WFMPRE:BYT_NR 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.
Page 230
Command Descriptions Examples specifies that the waveform data is in ASCII format. WFMPRE:ENCDG ASC ? might return , indicating that the waveform data is in binary WFMPRE:ENCDG format. WFMPre:NR_Pt? (Query Only) Returns the number of points that are in the transmitted waveform record, as specified by DATa:SOUrce.
Page 231
Command Descriptions Syntax WFMPre:<wfm>:NR_Pt? Related Commands DATa:SOUrce, DATa:STARt Examples WFMPre:CH1: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. 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 232
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 233
TDS2000, and TDS1000 Series and TDS200 Series with a TDS2MM measurement module only). might return: WFMPRE:WFID? WFMPRE:WFID "Math, DC coupling, 1.0E1 dB/div, 2.52525253E4 Hz/div, 1024 points, Sample mode" For TBS1000B/EDU. might return: WFMPRE:WFID? "FFT, DC coupling, 1.0E1 dB/div, 2.52525253E4 Hz/div, 1024 points, Sample mode" WFMPre:<wfm>:WFId? Same as WFMPre:WFId, except that <wfm>...
Page 234
Command Descriptions the DATa:DESTination command. The oscilloscope uses this value to calculate the seconds/division or Hertz/division units shown in the status bar and cursor readouts when displaying a reference waveform. The query form returns the interval between samples of the waveform specified by the DATa:SOUrce command, if that waveform is active or displayed.
Page 235
Command Descriptions NOTE. For TDS200 oscilloscopes used with a TDS2CMA communications module, the set form is ignored. Waveform commands:WFMPRE:XUNIT WFMPRE:XUNIT The query form returns the horizontal units for the waveform specified by DATa:SOURce. If the waveform specified by DATa:SOURce is not displayed, the query generates event message 2244.
Page 236
Returns A query result of zero has special meaning. A zero indicates the waveform has unknown vertical scaling. This is possible in the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TDS2000, TDS1000, or TDS200 Series. The TPS2000B/TPS2000 Series will never return zero.
Page 237
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 TPS2000B/TPS2000 Series.) WFMPre:<wfm>:YMUlt Same as WFMPre:YMUlt, except that <wfm> specifies the source/destination waveform instead of DATa:SOUrce and DATa:DESTINATION.
Page 238
Syntax WFMPre:YUNit <Qstring> WFMPre:YUNit? Arguments is "Volts", "U", or "dB". <Qstring> The TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series have the following additional arguments: "A" for amperes "VA" for volt × amperes "AA" for amperes × amperes "VV"...
Page 239
Volts for unknown units (divisions) for decibels for unknown mask waveforms units For the TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, TDS1000B, TPS2000B, and TPS2000 Series, the query can return the following additional values: for amperes for volt × amperes for amperes ×...
Page 240
WFMPre:YZEro <NR3> WFMPre:YZEro? Arguments is a value, expressed in YUNits. <NR3> ZOOM? (Query Only) Returns all zoom parameters. Conditions TBS1000B/EDU models only. Zoom Group Syntax ZOOM? ZOOM:FACtor Sets or queries the zoom factor of a particular zoom box. Conditions TBS1000B/EDU models only.
Page 241
Command Descriptions ZOOM:HORizontal:POSition Sets or returns the horizontal position of a particular zoom box. Conditions TBS1000B/EDU models only. Group Zoom Syntax ZOOM:HORizontal:POSition <NR3> ZOOM:HORizontal:POSition? Arguments NR3 is 1 to 100. It is the percent of the upper window that is to the left of the screen center.
Page 242
Command Descriptions ZOOM:STATE Sets or queries the zoom on/off state. Conditions TBS1000B/EDU models only. Group Zoom Syntax ZOOM:STATE { ON | OFF } ZOOM:STATE? 2-224 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
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 246
Status and Events Table 3-1: SESR bit functions Function 7 (MSB) Shows that the oscilloscope was powered on. Power On. On completion, the diagnostic self tests also set this bit. Indicates that an application event has User Request. occurred. *See note. Shows that an error occurred while Command Error.
Page 247
Status and Events Table 3-2: SBR bit functions (cont.) Function Shows that output is available Message Available. in the Output Queue. ———— Not used. ———— Not used. ———— Not used. 1–0 Enable Registers DESER, ESER, and SRER allow you to select which events are reported to the Status Registers and the Event Queue.
Status and Events Use the *SRE command to set the SRER. Use the *SRE? query to read the register. The RQS bit remains set to one until either the Status Byte Register is read with a Serial Poll or the MSS bit changes back to a zero. Figure 3-5: The Service Request Enable Register (SRER) *PSC Command The *PSC command controls the Enable Registers contents at power-on.
Status and Events Event Queue The Event Queue stores detailed information on up to 20 events. If than 20 events stack up in the Event Queue, the 20th event is replaced by event code 350, "Queue Overflow." Read the Event Queue with the EVENT? query (which returns only the event number), with the EVMSG? query (which returns the event number and a text description of the event), or with the ALLEV? query (which returns all the event numbers with a description of the event).
Page 250
Status and Events Figure 3-6: Status and Event Handling Process When an event occurs, a signal is sent to the DESER (1). If that type of event is enabled in the DESER (that is, if the bit for that event type is set to 1), the appropriate bit in the SESR is set to one, and the event is recorded in the Event Queue (2).
Status and Events Synchronization Methods Overview Although most commands are completed almost immediately after being received by the oscilloscope, some commands start a process that requires time. For example, once a single sequence acquisition command is executed, depending upon the applied signals and trigger settings, it may take an extended period of time before the acquisition is complete.
Page 252
Status and Events /** Set up conditional acquisition **/ ACQUIRE:STATE OFF SELECT:CH1 ON HORIZONTAL:RECORDLENGTH 1000 ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /** Acquire waveform data **/ ACQUIRE:STATE ON /** Set up the measurement parameters **/ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT: IMMED:SOURCE CH /** Take amplitude measurement **/ MEASUREMENT: MEAS1:VALUE? The acquisition of the waveform requires extended processing time.
Page 253
Status and Events /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Acquire waveform data */ ACQUIRE:STATE ON /* Set up the measurement parameters */ MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 /* Wait until the acquisition is complete before taking the measurement*/ *WAI /* Take amplitude measurement */...
Page 254
Status and Events many commands to the input buffer. The controller is still tied up though, and the repeated BUSY? query will result in bus traffic. Using the *OPC Command If the corresponding status registers are enabled, the *OPC command sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete.
Page 255
Status and Events The same command sequence using the *OPC command for synchronization looks like this /* Set up conditional acquisition */ ACQUIRE:STATE OFF SELECT:CH1 ON ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE /* Enable the status registers */ DESE 1 *ESE 1 *SRE 32 /* Acquire waveform data */ ACQUIRE:STATE ON...
Page 256
Status and Events /* Take amplitude measurement */ MEASUREMENT:IMMED:VALUE? This is the simplest approach. It requires no status handling or loops. However, you must set the controller time-out for longer than the acquisition operation. Messages The information contained in the topic tabs above covers all the programming interface messages the oscilloscope generates in response to commands and queries.
Page 257
Status and Events Table 3-5: Command error messages (CME bit 5) (cont.) Code Message Undefined header Numeric data error Invalid character in numeric Exponent too large Too many digits Suffix error Invalid suffix Suffix too long Character data error Invalid character data Character data too long String data error Invalid string data...
Page 258
Status and Events Table 3-6: Execution error messages (EXE bit 4) (cont.) Code Message File name error Media protected File name too long Hardcopy error Hardcopy device not responding Hardcopy is busy Hardcopy aborted Hardcopy configuration error Program error Insufficient network printer information Network printer not responding Network printer server not responding Program run time error...
Page 259
Status and Events Table 3-6: Execution error messages (EXE bit 4) (cont.) Code Message 2224 Measurement error, WAIT calculating 2225 Measurement error, No waveform to measure 2226 Measurement error, Null Waveform 2227 Measurement error, Positive and Negative Clipping 2228 Measurement error, Positive Clipping 2229 Measurement error, Negative Clipping 2230...
Page 260
Status and Events Device Error The following table lists the device errors that can occur during oscilloscope operation. These errors may indicate that the oscilloscope needs repair. Table 3-7: Device error messages (DDE bit 3) Code Message System error Memory error PUD memory lost Save/recall memory lost System Event...
Page 261
Status and Events Table 3-9: Execution warning messages (EXE bit 4) (cont.) Code Message Measurement warning, Low resolution Measurement warning, Uncertain edge Measurement warning, Invalid in minmax Measurement warning, Need 3 edges Measurement warning, Clipping positive/negative Measurement warning, Clipping positive Measurement warning, Clipping negative Table 3-10: Execution warning messages (EXE bit 4) Code...
Page 262
Status and Events 3-18 TBS1000/B/EDU, TDS2000/B/C, TDS1000/B/C-EDU, TDS200, TPS2000/B Series Programmer...
Programming Examples The following series of commands and queries illustrate many of the most common commands and techniques. To use these commands and queries over USB, you must use a program or routines that interface to the USBTMC driver on your PC. You can also use the PC Communications software that came on the CD with your oscilloscope to get the same data without having to write programs.
Page 266
Programming Examples > REM "Use the oscilloscope built-in measurements to measure the waveform you acquired." > MEASU:IMMED:TYPE MEAN > MEASU:IMMED:VALUE? :MEASUREMENT:IMMED:VALUE 2.4631931782E0 > REM "Be sure to use the *esr? query to check for measurement errors." > MEASU:IMMED:TYPE FREQ > MEASU:IMMED:VALUE? :MEASUREMENT:IMMED:VALUE 9.9E37 >...
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.
Appendix B: Factory Setup <:SWLOSS:ACQUIRE CONTINUOUS;ENABLE OFF;SOURCES CH1CH2;STOPAFTER 50;TONSTART 90;TONEND 10;TOFFSTART 10;TOFFEND 10;VSAT 1.0E0;UNITS WATTS> TPS2000B 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;...
Appendix C: Reserved Words *CAL BANdwidth FINE *CLS BATTERIES DCLIne FIRST *DDT BAUd FLAg *ESE DEFINE FORCe *ESR BIT_Nr DEFLT FORMat *IDN DEFault FREESpace *LRN BN_Fmt DELay FRENch *OPC BOTH DELEte FREQuency *PSC BRIGHTness DELTa FREquency *RCL BUBBLEJet DELay FUNCtion *RST BUSY DESE...
Page 282
Appendix C: Reserved Words TONEND KOREan PAPERSIZE RUNSTop TONSTART PAPERTYPE SAMple TOTAL PARity SAVESAll TRADitionalchinese SAVESImage TRANsmit LANGuage PEAKdetect SAVE TRIGger LANdscape PERCent SAVEIMAge TRUEPOWER LASERJet PERIod SAVEWFM TURNOFF LAYout PERSistence SCAle TURNON SECOnds LETTER PFPHASE TYPe LEVELS PHAse SECdiv UNIts LEVel PHOTO...
Page 285
For USB, the end-of-message terminator is the EOM bit in a USBTMC message. GPIB Address When communicating with a TBS1000B/EDU, TBS1000, TDS2000C, TDS1000C-EDU, TDS2000B, or TDS1000B Series oscilloscope using a TEK-USB-488 adapter, you can set a unique GPIB address for the oscilloscope in the UTILITY"...
Page 286
Glossary Any device requesting service returns a status byte with bit 6 set and then unasserts the SRQ line (GPIB only). Devices not requiring service return a status byte with bit 6 cleared. An acronym for Universal Serial Bus. USBTMC An acronym for USB Test and Measurement Class.
Need help?
Do you have a question about the TBS1000B/EDU and is the answer not in the manual?
Questions and answers