Page 1 Programmer Manual TDS3000, TDS3000B, and TDS3000C Series Digital Phosphor Oscilloscopes 071-0381-03 For the TDS3000C series, this document applies to firmware version 4.00 and above. For the TDS3000 and the TDS3000B series, this document applies to firmware version 3.00 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. Information in this publication supercedes that in all previously published material.
Page 3 Table of Contents Preface Related Manuals ..........Getting Started Overview of the Manual .
Page 4 Table of Contents Status and Events Registers ............3- - 1 Queues .
Page 5: Table Of Contents
Table of Contents List of Figures Figure 1- -1: Common message elements ..... . . 1- -2 Figure 1- -2: Functional groupings and an alphabetical list of commands .
Page 6 Table of Contents List of Tables Table 1- -1: Communication modules ......1- -4 Table 1- -2: Ethernet Network Settings side menu .
Page 7 Table of Contents Table 2- -28: Waveform commands ......2- -42 Table 2- -29: Commands that affect BUSY? response .
Page 8 Table of Contents TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 9: Related Manuals
TDS3000C Series Digital Phosphor Oscilloscopes Technical Reference. Oscilloscope specifications and a performance verification procedure. TekVISA Programmer Manual. Description of TekVISA, the Tektronix implementation of the VISA Application Programming Interface (API). TekVISA is industry- -compliant software for writing interoperable oscilloscope drivers in a variety of Application Development Environments (ADEs).
Page 10 Preface viii TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 11: Overview Of The Manual 1
Getting Started You can write computer programs that remotely set the oscilloscope front panel controls or that take measurements and read those measurements for further analysis or storage. To get you started with programming the oscilloscope, this section includes the following: H Overview of the Manual summarizes the type of programming information contained in each major section of this manual (page 1- -2).
Page 12: Figure 1- 1: Common Message Elements
Getting Started Overview of the Manual The information contained in each major section of this manual is described below. Syntax and Commands The Syntax and Commands chapter describes the structure and content of the messages your program sends to the oscilloscope. Figure 1- -1 shows a syntax diagram and command parts as described in the Command Syntax subsection.
Page 13: Figure 1- 3: Service Requests (Srqs) Provide For Event (Interrupt) Driven Programs
Getting Started Status and Events Your program may request information from the oscilloscope. The oscilloscope provides information in the form of status and error messages. Figure 1- -3 on page 1- -3 illustrates the basic operation of this system. The Status and Events chapter starting on page 3- -1 describes how to use service requests (SRQs) and various event messages in your programs.
Page 14: Table 1- 1: Communication Modules
TDS3EM This communication module adds Ethernet 10baseT local area network (LAN) and RS-232 ports to your TDS3000 Series oscilloscope. You can use the Ethernet port for remote programming or printing to a LAN printer. Communication modules are user-installable. All TDS3000B Series and TDS3000C oscilloscopes have a built-in Ethernet port.
Page 15: Figure 1- 4: Communication Module Connectors
GPIB RS-232 TDS3GV Figure 1- 4: Communication module connectors The TDS3EM Ethernet Communication Module (TDS3000 Series only) has a set of four status LEDs. Figure 1- -5 identifies each LED and describes its purpose. LINK CLSN LINK: Indicates Ethernet connection when lit.
Page 16: Figure 1- 6: Communication Module Mounting Location
Getting Started Installing a Communication Module CAUTION. To avoid damage to the oscilloscope or communication module, observe all ESD precautions described in the User manual. NOTE. Do not install a TDS3EM module into a TDS3000B Series or TDS3000C Series oscilloscope. Installing the TDS3EM module will cause both the built-in Ethernet port and the module’s Ethernet port to stop functioning.
Page 17: Figure 1- 7: Communication Module Location
Getting Started Connector Locations Figure 1- -7 shows the location of the installed communication module, as well as the rear-panel connectors. The built-in Ethernet port and External trigger are only available with the TDS3000B and TDS3000C Series models. Ethernet port Parallel printer port TDS3000B/TDS3000C Power input...
Page 18: Setting Up Ethernet Remote Communications 1
Getting Started Setting Up Ethernet Remote Communications The following sections describe how to set up the Ethernet communications for network hard copy printing and remote programmability. The Ethernet port requires a straight-through 10BaseT cable with RJ-45 connector. No transceiver is necessary. Contacting Your Network To connect the oscilloscope to the network, you need to obtain information from Administrator...
Page 19: Figure 1- 8: The Ethernet Network Settings Menu
Getting Started The Ethernet Menus Push the UTILITY button, then push the System bottom button to select I/O. The oscilloscope displays the I/O menu, as shown in Figure 1- -8, which contains the Ethernet Network Settings and Ethernet Printer Settings bottom buttons. Figure 1- 8: The Ethernet Network Settings menu Ethernet Network Settings Menu.
Page 20: Figure 1- 9: The Change Instrument Settings Screen
Getting Started Figure 1- 9: The Change Instrument Settings screen Table 1- 2: Ethernet Network Settings side menu Side Field/value Description Change Instrument Ethernet Address: The factory-set Ethernet address for this Settings module or instrument. This field cannot be edited. Instrument Name: An alphanumeric label assigned to the oscilloscope for easier network reference.
Page 21: Getting Started
Getting Started Table 1- 2: Ethernet Network Settings side menu (Cont.) Side Field/value Description Change Instrument Instrument IP A unique Internet Protocol (IP) address that Settings (cont.) Address: identifies the oscilloscope. You must enter an IP address in order for the oscilloscope to communicate with the network.
Page 22: Table 1- 3: Ethernet Printer Settings Side Menu
Getting Started Table 1- 2: Ethernet Network Settings side menu (Cont.) Side Field/value Description Debug Helps in debugging network communications problems by displaying the last 30 characters transmitted and received by the oscilloscope. Only displays information when receiving and responding to remote commands or software such as WaveStar for Oscilloscopes (TDS3000 Series, TDS3000B Series only).
Page 23 Plug&Play concept. The following procedure assumes you have installed the TDS3EM Communica- tion Module and cable into a TDS3000 Series oscilloscope. For TDS3000B and TDS3000C series oscilloscopes, a RJ-45 connector, with 10BaseT cable attached to the oscilloscope Ethernet port, is required.
Page 24 1- -8. The following procedure presumes that you have installed the TDS3EM Communication Module and cable into a TDS3000 Series oscilloscope. TDS3000B and TDS3000C series oscilloscopes simply require an RJ-45 connector with 10BaseT cable attached to the oscilloscope Ethernet port.
Page 25 Getting Started H The Back Space button deletes the character to the left of the cursor position in the field. H The Delete button deletes the character at the cursor position in the field. H The Clear button deletes all characters from the current field. 9.
Page 26: Figure 1- 10: The Ethernet Printer Settings Window
Getting Started Figure 1- 10: The Ethernet Printer Settings window H The Back Space button deletes the character to the left of the cursor position in the field. H The Delete button deletes the character at the cursor position in the field. H The Clear button deletes all characters from the current field.
Page 27 Getting Started 16. Test the network printer by pressing the hard copy button. The printer should print the current screen. If the printer does not print the screen, check the following: H Hard copy port is set to Ethernet. H Hard copy file format is compatible with the network printer. H The printer IP and server information you entered is correct.
Page 28: Setting Up Gpib Remote Communications 1
All applications that communicate with the Ethernet must use a VISA. A Tektronix version of VISA, referred to in this document as TekVisa, is available for download from the www.tek.com Web site.
Page 29: Figure 1- 11: How To Stack Gpib Connectors
Getting Started GPIB connectors Figure 1- 11: How to stack GPIB connectors GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device GPIB Device Figure 1- 12: Typical GPIB network configurations Appendix C: Interface Specifications gives more information on the GPIB configuration of the oscilloscope.
Page 30: Figure 1- 13: Selecting The System: I/O Menu
Getting Started Setting the GPIB You need to set the GPIB parameters of the oscilloscope to match the configura- Parameters tion of the bus. Once you have set these parameters, you can control the oscilloscope through the GPIB interface. 1. Push the UTILITY menu button. 2.
Page 31: Figure 1- 14: The Rs-232 Connector Pin Assignments
PC/AT COM port. Table 1- -4 lists cables you can use to connect the oscilloscope to other devices. Table 1- 4: RS-232 adapter cables Tektronix part number Cable type 012-1379-00 9-pin female to 9-pin female,...
Page 32: Figure 1- 15: Rs-232 Parameter Settings
Getting Started Follow these guidelines when connecting the oscilloscope to another RS-232 device: H Do not connect the output line of one DTE device to the output line of another DTE device. H Connect the signal ground of the oscilloscope to the signal ground of the external device.
Page 33: Table 1- 5: Rs-232 Default Settings
Getting Started You can set the following parameters: H Baud Rate — sets the data transmission rate. You can set rates of 1200, 2400, 4800, 9600, 19200, or 38400 baud. H Hard Flagging — sets hard flagging (RTS/CTS) on or off. Flagging controls the flow of data between devices.
Page 34 Getting Started Transferring Binary Data. When using the RS-232 port to transfer binary data to the oscilloscope, note the following points: H Using RTS/CTS (hard) flagging guarantees no data loss. H All eight bits of binary data contain meaningful information. To make sure that all eight bits are received or transmitted, configure the RS-232 device that is connected to the oscilloscope to receive and transmit eight-bit characters (set the RS-232 word length to eight bits).
Page 35: Table 1- 6: Rs-232 Troubleshooting
Getting Started RS-232 Troubleshooting If the oscilloscope and the personal computer or printer have trouble communi- cating, use the following steps to correct the problem: 1. Verify that you are using the correct RS-232 cable. Determine whether your configuration requires a null-modem connection (where transmit/receive and control lines are switched) or a straight-through RS-232 connection.
Page 36: Table 1- 7: Comparison Of Gpib And Rs-232 Interfaces
Getting Started Table 1- 6: RS-232 troubleshooting (Cont.) Symptom Possible causes The oscilloscope RS-232 debug menu Verify that the RS-232 cable is the recommended displays CTS: Low, and the oscillo- cable. Some cables may be wired without the CTS or scope is using hard flagging.
Page 37 Getting Started Table 1- 7: Comparison of GPIB and RS-232 interfaces (Cont.) Operating attribute GPIB RS-232 Timing Asynchronous Asynchronous ≤ 2 meters between devices; ≤ 15 meters Transmission path length ≤ 20 meters total cabling for (max) GPIB system Speed 200kBytes/sec 3.8k Bytes/sec System environment...
Page 38 Getting Started 1- 28 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 39: Table 2- 1: Bnf Symbols And Meanings
Command Syntax You can control the oscilloscope through the GPIB interface using commands and queries. This section describes the syntax these commands and queries use. It also describes the conventions the oscilloscope uses to process them. The next section, entitled Command Groups, lists the commands and queries themselves. You transmit commands to the oscilloscope using the enhanced American Standard Code for Information Interchange (ASCII) character encoding.
Page 40: Figure 2- 1: Command Message Elements
Command Syntax A command message is a command or query name followed by any information the oscilloscope needs to execute the command or query. Command messages may contain five element types, defined in Table 2- -2 and shown in the example in Figure 2- -1.
Page 41: Table 2- 3: Comparison Of Header Off And On Responses
Command Syntax Commands Commands have the structure: [:]<Header>[<Space><Argument>[<Comma><Argument>]...] A command header consists of one or more mnemonics arranged in a hierarchi- cal or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level.
Page 42: Clearing The Oscilloscope Output Queue 2
Command Syntax Clearing the Oscilloscope Output Queue You can clear the Output Queue and reset the oscilloscope to accept a new command or query by using the Device Clear (DCL) GPIB interface command. Command Entry The following rules apply: H You can enter commands in upper or lower case. H You can precede any command with white space characters.
Page 43 Command Syntax 2. If concatenated commands have headers that differ by only the last mnemon- ic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands ACQuire:MODe ENVelope and ACQuire:NUMAVg 8 into a single command: ACQuire:MODe ENVelope;...
Page 44 Command Syntax Here are some invalid concatenations: H DISPlay:GRAticule FULL;ACQuire:NUMAVg 8 (no colon before ACQuire) H DISPlay:GRAticule FULL;:DOTSONLY OFF (extra colon before DOTsonly — could use DISPlay:DOTsonly OFF instead) H DISPlay:GRAticule FULL;:*TRG (colon before a star (*) command) H MATH:HORizontal:SCAle 1.0e-1;HORizontal:POSition 5.0e1 (levels of mnemonics are different—either remove the second use of HORizontal: or place :MATH in from of HORizontal:POSition) Message Terminators...
Page 45: Constructed Mnemonics 2
Command Syntax Constructed Mnemonics Some header mnemonics specify one of a range of mnemonics. For example, a channel mnemonic can be either CH1, CH2, CH3, or CH4. You use these mnemon- ics in the command just as you do any other mnemonic. For example, there is a CH1:VOLts command, and there is also a CH2:VOLts command.
Page 46: Argument Types 2
Command Syntax Waveform Mnemonics In some commands, you can specify a waveform regardless of whether it is a channel waveform, a math waveform, or a reference waveform. Specify such a waveform as follows: Symbol Meaning <wfm> Can be CH<x>, MATH or REF<x> Argument Types The argument of a command may be in one of several forms.
Page 47 Command Syntax Quoted String Arguments Some commands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (’) or double quote (”). For example: ”this is a quoted string” Symbol Meaning <QString>...
Page 48: Figure 2- 2: Block Argument Example
Command Syntax Block Arguments Several oscilloscope commands use a block argument form: Symbol Meaning <NZDig> A nonzero digit character, in the range 1- - 9 <Dig> A digit character, in the range 0- - 9 <DChar> A character with the hex equivalent of 00 through FF hexadecimal (0 through 255 decimal) A block of data bytes, defined as: <Block>...
Page 49: Table 2- 4: Acquisition Commands
The functional group list starts below. The alphabetical list provides more detail on each command and starts on page 2- -45. The GPIB and RS-232 interfaces conform to Tektronix standard codes and formats except where noted. The GPIB interface also conforms to IEEE Std 488.2-1987 except where noted.
Page 50: Table 2- 5: Alias Commands
Command Groups Table 2- 4: Acquisition commands (cont.) Header Description WAVEAlert:STATE Sets or returns the WaveAlert testing mode (TDS3000B and TDS3000C Series) WAVEAlert:STOPOnviolation Sets or returns the Stop on Violation mode (TDS3000B and TDS3000C Series) WAVEAlert:TYPe Sets or returns the WaveAlert Highlight (TDS3000B and TDS3000C Series) Anomaly mode Alias Commands...
Page 51: Table 2- 6: Calibration And Diagnostic Commands
Command Groups Calibration and Diagnostic Commands Calibration and Diagnostic commands let you start the self-calibration and diagnostic routines that are built into the oscilloscope. The diagnostic test operation includes selecting the test sequence, executing the sequence, and viewing the results. Table 2- -6 lists these commands. Table 2- 6: Calibration and diagnostic commands Header Description...
Page 52: Table 2- 7: Cursor Commands
Command Groups Table 2- 6: Calibration and diagnostic commands (cont.) Header Description DIAg:RESUlt:FLAg? Returns the PASS or FAIL status from the last FAIL diagnostic test sequence results DIAg:RESUlt:LOG? Return diagnostic test sequence results DIAg:SELect:ALL Diagnostics will be run on all subsystems Executes all the diagnostics tests that have DIAg:STATE EXECute been selected...
Page 53 Command Groups Table 2- 7: Cursor commands (cont.) Header Description CURSor:VBArs:HDELTa? Returns the horizontal difference between the two vertical bar cursors CURSor:VBArs:HPOS<x>? Returns the value of vertical bar ticks CURSor:VBArs:POSITION<x> Sets the horizontal position for both vertical bars CURSor:VBArs:SELect Sets which vertical cursor is active (selected) CURSor:VBArs:UNIts Sets or returns measurement units for the vertical cursors...
Page 54: Table 2- 8: Display Commands
Command Groups Display Commands Display commands let you change the graticule style, change the displayed intensities, display messages, and clear the menu. Table 2- -8 lists these com- mands. Table 2- 8: Display commands Header Description CLEARMenu Clear menus from display DISplay? Returns display settings DISplay:CLOCk...
Page 55: Table 2- 9: Ethernet Commands
Ethernet commands let you remotely set oscilloscope ethernet settings. Table 2- -9 lists these commands. Ethernet commands are available only in the TDS3000B oscilloscopes, or in TDS3000 Series oscilloscopes equipped and TDS3000C Series with an optional TDS3EM Ethernet communications module.
Page 56: Table 2- 10: File System Commands
Command Groups File System Commands File system commands help you manage the oscilloscopes memory storage device. Table 2- -10 lists these commands. Table 2- 10: File system commands Header Description FILESystem? Returns results of queries Copies file to new file FILESystem:COPy FILESystem:CWD Sets or returns the current directory...
Page 57: Table 2- 12: Hard Copy Commands
Table 2- -13 lists these commands. You may substitute SECdiv for SCAle in the horizontal commands. This provides program compatibility with earlier models of Tektronix oscilloscopes. Table 2- 13: Horizontal commands Header...
Page 58: Table 2- 14: Itu601 Commands
Command Groups Table 2- 13: Horizontal commands (cont.) Header Description HORizontal:SCAle Same as HORizontal:MAIn:SCAle HORizontal:SECdiv Same as HORizontal:MAIn:SCAle HORizontal:TRIGger:POSition Time base trigger position ZOOm:HORizontal:POSition Values are 0 to 100, in percent of record ZOOm:HORizontal:SCAle Sets or returns the horizontal scale when in zoom ZOOm:STATE Activates the zoom function...
Page 59: Table 2- 15: Limit Test Commands
Command Groups Limit Test Commands (Requires TDS3LIM) The Limit Test commands let you automatically compare each incoming waveform against a template waveform. You set an envelope of limits around a waveform and let the oscilloscope find the waveforms that fall outside those limits.
Page 60: Table 2- 16: Mask Commands
Command Groups Mask Commands (TDS3000B Series and TDS3000C Series with TDS3TMT) The Mask Test commands let you automatically compare each incoming waveform against a template telecommunications mask. When the oscilloscope find the waveforms that fall outside the mask limits, it can generate a hard copy, emit a beep, stop and wait for your input, or any combination of these actions.
Page 61 Command Groups Table 2- 16: Mask commands (cont.) Header Description MASK:LOCk Sets or returns the mask lock to waveform mode MASK:MARGIN:HORizontal Sets or returns the User mask’s horizontal margin percentage MASK:MARGIN:VERTical Sets or returns the User mask’s vertical margin percentage MASK:MASK<m>...
Page 62 Command Groups Table 2- 16: Mask commands (cont.) Header Description MASK:MASKPRE:VOFFSet Sets or returns the nominal vertical offset, in volts, used to vertically offset the input channels MASK:MASKPRE:VPOS Sets or returns the nominal vertical position, in divisions, used to vertically position the input channels MASK:MASKPRE:VSCAle Sets or returns the nominal vertical scale, in...
Page 63 Command Groups Table 2- 16: Mask commands (cont.) Header Description MASK:USER:MASK<m>:POINTS Sets or returns the X-Y user coordinates of all points in the specified User mask segment MASK:USER:MASK<m>:POINTSNorm Sets or returns the normalized coordinate points of the specified User mask segment MASK:USER:MASK<m>:POINTSPcnt Sets or returns the points in the specified User mask segment, in percentage coordinates...
Page 64: Table 2- 17: Available Tds3Tmt Itu-T G.703 Mask Standards
Command Groups Table 2- 17: Available TDS3TMT ITU-T G.703 mask standards Standard Description Clock interface coaxial pair 2.048 Mb/s CLOCKCoax Clock interface symmetric pair 2.048 Mb/s CLOCKSymmetrical DS0Contra DS-0 data contra-directional 64 kb/s DS0Double DS-0 double 64 kb/s DS-0 single 64 kb/s DS0Single DS0Timing DS-0 timing 64 kb/s...
Page 65: Table 2- 19: Math Commands
Command Groups Math Commands Math commands provide access to math function definition. This table also includes TDS3AAM Advanced Analysis application module remote command syntax. Table 2- 19: Math commands Header Description MATH? Returns definition for the math waveform MATH:DEFINE Sets or returns the math waveform definition for the active math operation (as set by MATH:TYPe) MATH:HORizontal:POSition<NR3>...
Page 66: Table 2- 20: Measurement Commands
Command Groups Measurement Commands Measurement commands control the automated measurement system. Table 2- -20 on page 2- -28 lists these commands. Up to four automated measurements can be displayed on the screen. In the commands, these four measurement readouts are named MEAS<x>, where <x> can be 1, 2, 3, or 4.
Page 67 Command Groups Table 2- 20: Measurement commands (cont.) Header Description MEASUrement:IMMed:VALue? Returns measurement result MEASUrement:INDICators? Returns all measurement indicator parameters MEASUrement:INDICators:HORZ<x>? Returns the position of the specified horizontal measurement indicator Sets and returns state of visible measurement MEASUrement:INDICators:STATE indicators MEASUrement:INDICators:NUMHORZ? Returns the horizontal measurement indicators MEASUrement:INDICators:NUMVERT? Returns the vertical measurement indicators...
Page 68: Table 2- 21: Miscellaneous Commands
Command Groups Table 2- 20: Measurement commands (cont.) Header Description MEASUrement:METHod Method for calculating reference levels MEASUrement:REFLevel? Returns reference levels MEASUrement:REFLevel:ABSolute:HIGH Sets or returns the high reference level MEASUrement:REFLevel:ABSolute:LOW Sets or returns the low reference level MEASUrement:REFLevel:ABSolute:MID Sets or returns the mid reference level MEASUrement:REFLevel:ABSolute:MID2 Sets or returns the mid2 reference level Specifies reference level used for calculation MEASUrement:REFLevel:METHod...
Page 69 Command Groups Table 2- 21: Miscellaneous commands (cont.) Header Description Same as HEADer HEADer Returns command header with query LANGuage Selects language LOCk Locks front panel (local lockout) *LRN? Returns instrument settings NEWpass Changes password for User Protected Data Access to change User Protected Data PASSWord POWER:AC:PRESENt? Returns a 1 the instrument is powered by AC...
Page 70: Rs-232 Commands
Command Groups RS-232 Commands RS-232 commands allow you to use the serial communications port available with a communication module. Table 2- -22 lists these commands. Table 2- 22: RS-232 commands Header Description RS232? Returns RS-232 parameters Sets baud rate RS232:BAUd RS232:HARDFlagging Sets hard flagging RS232:PRESET...
Page 71: Table 2- 24: Status And Error Commands
Command Groups Status and Error Commands Table 2- -24 lists the status and error commands the oscilloscope supports. These commands let you determine the status of the oscilloscope and control events. Several commands and queries used with the oscilloscope are common to all devices on the GPIB bus.
Page 72: Table 2- 25: Trigger Commands
Command Groups Trigger Commands Trigger commands control all aspects of oscilloscope triggering. Table 2- -25 lists these commands. There are two triggers, A and B. Where appropriate, the command set has parallel constructions for each trigger. You can set the A or B triggers to edge mode. Edge triggering lets you display a waveform at or near the point where the signal passes through a voltage level of your choosing.
Page 73 Command Groups Table 2- 25: Trigger commands (cont.) Header Description TRIGger:A:LOGIc:INPUT<x>: Sets or returns the signal source for the SOUrce specified logic trigger input TRIGger:A:LOGIc:INPUT<x>: Sets or returns the logic trigger threshold THReshold setting of the specified input TRIGger:A:LOGIc:PATtern: Sets or returns the pattern trigger time period DELTATime value TRIGger:A:LOGIc:PATtern:...
Page 74 Command Groups Table 2- 25: Trigger commands (cont.) Header Description TRIGger:A:PULse:SLEWRate: Sets both slew rate threshold voltage values THReshold:BOTH TRIGger:A:PULse:SLEWRate: Sets or returns the slew rate high threshold THReshold:HIGH voltage value TRIGger:A:PULse:SLEWRate: Sets or returns the slew rate low threshold THReshold:LOW voltage value TRIGger:A:PULse:SLEWRate:...
Page 75 Command Groups Table 2- 25: Trigger commands (cont.) Header Description TRIGger:B:BY Sets the B trigger to delay by time or events TRIGger:B:EDGe? Returns the trigger coupling, source, and the slope of the B trigger TRIGger:B:EDGe:COUPling Sets the B trigger coupling B trigger slope TRIGger:B:EDGe:SLOpe TRIGger:B:EDGe:SOUrce...
Page 76: Table 2- 26: Vertical Commands
The SELect:<wfm> command also selects the waveform many commands in other command groups use. You may replace VOLts for SCAle in the vertical commands. This provides program compatibility with earlier models of Tektronix oscilloscopes. Table 2- 26: Vertical commands Header Description CH<x>?
Page 77: Waveform Commands 2
Command Groups Waveform Commands Waveform commands let you transfer waveform data points to and from the oscilloscope. Waveform data points are a collection of values that define a waveform. One data value usually represents one data point in the waveform record.
Page 78: Table 2- 27: Binary Data Ranges
Command Groups values range from 0 to 255. When the byte width is two, the signed integer data ranges from - -32768 to 32767, and positive integer values range from 0 to 65,535. Table 2- 27: Binary data ranges Byte width Signed integer range Positive integer range - - 128 to 127...
Page 79 Command Groups locations. You can specify the reference memory location with the DATa:DESTi- nation command. Waveform Preamble Each waveform that you transfer has an associated waveform preamble that contains information such as the horizontal scale, the vertical scale, and other settings in place when the waveform was created.
Page 80: Table 2- -28: Waveform Commands 2
Command Groups Table 2- 28: Waveform commands Header Description Transfers waveform data to or from the CURVe oscilloscope DATa Sets or returns the format and location of the waveform data that is transferred with the CURVe command Sets or returns the destination for waveforms DATa:DESTination sent to oscilloscope DATa:ENCdg...
Page 81 Command Groups Table 2- 28: Waveform commands (cont.) Header Description WFMPre:NR_Pt Sets or returns the the number of points in the curve transfer to/from the oscilloscope WFMPre:PT_Fmt Sets or returns the format of curve points WFMPre:PT_Off? Query trigger offset Query curve identifier WFMPre:WFId? WFMPre:XINcr Sets or returns the horizontal sampling interval...
Page 82 Command Groups 2- 44 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 83: Command Descriptions 2
Command Descriptions You can use commands to either set instrument features or query instrument values. You can use some commands to do both, some to only set, and some to only query. Commands that are set only are labeled with the words “(Set Only)” next to the command.
Page 84 Command Descriptions Syntax ACQuire:MODe { SAMple | PEAKdetect | AVErage | ENVelope } Arguments SAMple specifies that the displayed data point value is simply the first sampled value that was taken during the acquisition interval. In sample mode, all waveform data has 9 bits of precision. You can request 16 bit data with a CURVe? query, but the lower-order 7 bits of data will be zero.
Page 85 Command Descriptions Examples ACQUIRE:NUMACQ? might return 350, indicating that 350 acquisitions took place since an AC- QUIRE:STATE RUN command was executed. Related Commands ACQuire:STATE ACQuire:NUMAVg Sets the number of waveform acquisitions that make up an averaged waveform. This is equivalent to setting the Average count in the Acquisition Mode menu. Group Acquisition Syntax...
Page 86 Command Descriptions Syntax ACQuire:NUMEnv { <NR1> | INFInite } ACQuire:NUMEnv? <NR1> ¸ 0 is the number of waveform acquisitions, from 2 to 512 (must be a Arguments power of two). The envelope will restart after the specified number of envelopes have been acquired or when the ACQuire:STATE RUN command is sent.
Page 87 Command Descriptions Arguments OFF or STOP or <NR1> = 0 stops acquisitions. ON or RUN or <NR1> ¸ 0 starts acquisition and display of waveforms. If the command was issued in the middle of an acquisition sequence (for instance averaging or enveloping), RUN restarts the sequence, discarding any data accumulated prior to the STOP.
Page 88 Command Descriptions NOTE. If you set the acquisition system to single sequence, envelope mode, and set the number of envelopes to infinity, the oscilloscope will envelope a maximum of 513 acquisitions. Examples ACQUIRE:STOPAFTER RUNSTop sets the oscilloscope to stop acquisition when the user presses the front-panel RUN/STOP button.
Page 89 Command Descriptions ALIas:CATALOG? (Query Only) Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string ””. Group Alias Syntax ALIas:CATALOG? Returns <QString>[,<QString>...] Examples ALIAS:CATALOG? might return the string ”SETUP1”,”TESTMENU1”,”DEFAULT”, showing there are 3 aliases named SETUP1, TESTMENU1, and DEFAULT.
Page 90 Command Descriptions NOTE. Attempting to give two aliases the same name causes an execution error. To give a new alias the name of an existing alias, you must first delete the existing alias. Examples ALIAS:DEFINE ”ST1”,”:RECALL:SETUP 5;:AUTOSET EXECUTE; :SELECT:CH1 ON” defines an alias named “ST1”...
Page 91 Command Descriptions ALIas:DELEte:NAMe (Set Only) Removes a specified alias. This command is identical to ALIas:DELEte. Group Alias Syntax ALIas:DELEte:NAMe <QString> Arguments <QString> is the name of the alias to remove. Using ALIas:DELEte:NAMe without specifying an alias causes an execution error. <QString> must be an existing alias.
Page 92: Registers 3
Command Descriptions ALLEv? (Query Only) Causes the oscilloscope to return all events and their messages, and removes the returned events from the Event Queue. The messages are separated by commas. Use the *ESR? query to enable the events to be returned. For a complete discussion of the use of these registers, see page 3- -1.
Page 93: Synchronization Methods 3
Command Descriptions Arguments EXECute sets the oscilloscope to automatically provide a stable display of the active edge- -triggered waveform. UNDO restores the oscilloscope settings to those present prior to the autoset execution. VIDeo Sets the oscilloscope to display a broadcast-standard video waveform triggered on all lines.
Page 94: Table 2- -29: Commands That Affect Busy? Response 2
Command Descriptions Returns <NR1> = 0 means that the oscilloscope is not busy processing an execution-time- intensive command. Execution-time-intensive commands are listed in Table 2- -29. <NR1> = 1 means that the oscilloscope is busy processing one of the commands listed in Table 2- -29.
Page 95 Command Descriptions *CAL? (Query Only) Runs an internal self-calibration and returns the oscilloscope calibration status. NOTE. Disconnect or otherwise removeall input signals prior to starting self-calibration. The self-calibration can take several minutes to complete. No other commands are executed until calibration is complete. Group Calibration and Diagnostic Syntax...
Page 96 Command Descriptions CALibrate:FACtory:CONTInue (Set Only) Instructs the instrument to execute the current factory calibration step. The calibration step number is incremented on completion of this step, independent of the step pass/fail status. Follow this command with CALibrate: FACtory:STEPstatus? to determine execution status. Use CALibrate:| FACtory:PREVious (followed by a CALibrate:FACtory:CONTinue) to repeat a factory calibration step that failed.
Page 97 Command Descriptions CALibrate:FACtory:NOTIfy:HOURs Sets or returns hours when calibration is due. Group Calibration and Diagnostic Syntax CALibrate:FACtory:NOTIfy:HOURs { INFInite | <NR1> } CALibrate:FACtory:NOTIfy:HOURs? Arguments <NR1> = is the number of hours, 500 to 10000, before the instrument displays a notifier saying that calibration is due. Numbers entered are rounded to the nearest valid number.
Page 98 Command Descriptions Examples CALIBRATE:FACTORY:NOTIFY:YEARS 1.5e0 sets the calibration due time to 1.5 years. CALIBRATE:FACTORY:NOTIFY:YEARS? might return :CALIBRATE:FACTORY:NOTIFY:YEARS 1.5E0 indicating that the calibration due notifier will be displayed 1.5 years after the last calibration. CALibrate:FACtory:PREVious (Set Only) This command backs up the calibration steps one step so that the next CALi- brate:FACtory:CONTInue command will repeat the factory calibration step that just finished.
Page 99 Command Descriptions Examples CALIBRATE:FACTORY:START initializes the factory calibration sequence. CALibrate:FACtory:STATUS? (Query Only) Returns the factory calibration status value saved in non-volatile memory. Group Calibration and Diagnostic Syntax CALibrate:FACtory:STATUS? Examples CALIBRATE:FACTORY:STATUS? might return :CALIBRATE:FACTORY:STATUS PASS indicating that factory calibration passed. CALibrate:FACtory:STEPstatus? (Query Only) Returns pass during oscilloscope power on without regard to actual calibration status.
Page 100 Command Descriptions Syntax CALibrate:INTERNal Examples CALIBRATE:INTERNAL performs an internal self-calibration (SPC). Related Commands CALibrate:INTERNal:STARt CALibrate:INTERNal:STARt (Set Only) Performs a signal path compensation (SPC). The calibration algorithm takes a few minutes to complete. No other command is executed until calibration is complete.
Page 101 Command Descriptions Examples CALIBRATE:INTERNAL:STATUS? might return :CALIBRATE:INTERNAL:STATUS UNCAL+ if non-volatile memory has failed. Related Commands CALibrate:INTERNal:STARt CH<x>? (Query Only) Returns the vertical parameters of the specified channel. Because CH<x>:SCAle and CH<x>:VOLts are identical, only CH<x>:SCAle is returned. Group Vertical Syntax CH<x>? Examples CH1?
Page 102 Command Descriptions Examples CH2:BANDWIDTH TWENTY sets the bandwidth of channel 2 to 20 MHz. CH1:BANDWIDTH? might return FULL, which indicates that there is no bandwidth limiting on channel 1. CH<x>:COUPling Sets or queries the input attenuator coupling setting of the specified channel. This is equivalent to setting Coupling in the Vertical menu.
Page 103 Command Descriptions CH<x>:DESKew Sets or queries the horizontal deskew time for this channel. This is equivalent to setting Deskew in the VERTICAL > Probe Setup menu and entering a value with the general purpose knob. Deskew lets you compensate for time delay differences between input channels caused by signals coming in on cables of different length.
Page 104 Command Descriptions CH<x>:IMPedance Sets or returns the channel probe impedance. Group Vertical Syntax CH<x>:IMPedance { FIFty | MEG } CH<x>:IMPedance? Arguments <x> specifies the input channel. Valid values are 1, 2, 3, and 4. FIFty sets the specified channel to 50 Ω impedance. MEG sets the specified channel to 1 MΩ...
Page 105: Table 2- -30: Offset Ranges Using A 1X Probe 2
Command Descriptions CH<x>:OFFSet Sets or queries the offset, typically in volts, that is subtracted from the specified input channel before it is acquired. The greater the offset, the lower on the display the waveform appears. This is equivalent to setting Offset in the Vertical menu.
Page 106 Command Descriptions CH<x>:POSition Sets or queries the vertical position of the specified channel. The position value is applied to the signal before digitization. This is equivalent to setting Position in the Vertical menu or adjusting the front-panel Vertical POSITION knob. Group Vertical Syntax...
Page 107 Command Descriptions Arguments <x> specifies the input channel. Valid values are 1, 2, 3, and 4. <NR3> is the gain factor (output/input) of the probe. If the attached probe has only one legal gain value gain, attempting to set the gain to another value results in a Hardware Configuration error.
Page 108 Command Descriptions CH<x>:VOLts Sets or queries the vertical gain of the specified channel. This command is identical to the CH<x>:SCAle command and is included for compatibility purposes. Only CH<x>:SCAle is returned in response to a CH<x>? query. Group Vertical Syntax CH<x>:VOLts <NR3>...
Page 109 Command Descriptions Arguments <x> specifies the input channel. Valid values are 1, 2, 3, and 4. <Qstring> is either “V” for volts or “A” for amps as the units. Examples CH<x>:YUNIT? might return:CH4:YUNIT “V”. CLEARMenu (Set Only) Clears the current menu from the display. This command is equivalent to pressing the MENU OFF button on the front panel.
Page 110 Command Descriptions MAV. (A complete discussion of these registers and bits, and of event handling in general, begins on page 3- -1.) *CLS can suppress a Service Request that is to be generated by an *OPC. This will happen if a hardcopy output or single sequence acquisition operation is still being processed when the *CLS command is executed.
Page 111 Command Descriptions WAVEform specifies waveform XY cursors. GRATicule specifies graticule XYcursors. TDS3AAM only. Examples CURSOR:FUNCTION VBARS selects vertical bar type cursors. CURSor:GRATicule? (Query Only) (Available with TDS3AAM) Returns the current settings for the XY graticule cursors, where XPOSITION1 and YPOSITION1 refers to the reference cursor, and XPOSITION2 and YPOSITION2 refers to the delta cursor.
Page 112 Command Descriptions Arguments CURSOR<n>X specifies the X-axis cursor of the specified graticule cursor, where n = 1 for the reference cursor, and n = 2 for the delta cursor. CURSOR<n>Y specifies the Y-axis cursor of the specified graticule cursor, where n = 1 for the reference cursor, and n = 2 for the delta cursor.
Page 113 Command Descriptions Arguments <x> specifies which graticule cursor, where x = 1 for the reference cursor and x = 2 for the delta cursor <NR3> is the Y cursor position value. Examples CURSOR:GRATICULE:YPOSITION1? might return CURSor:GRAticule:YPOSITION1 2.04E0 CURSor:HBArs? (Query Only) Returns the current settings for the horizontal bar cursors.
Page 114 Command Descriptions CURSor:HBArs:POSITION<x> Sets or queries the position of the specified horizontal bar cursor relative to ground. Group Cursor Syntax CURSor:HBArs:POSITION<x> <NR3> CURSor:HBArs:POSITION<x>? Arguments <x> specifies the cursor. Valid values are 1 and 2. <NR3> specifies the cursor position relative to ground, typically in volts. Examples CURSOR:HBARS:POSITION1 2.0E+1 positions horizontal cursor 2 at 20.0 units, typically volts, relative to ground.
Page 115 Command Descriptions Examples CURSOR:HBARS:SELECT CURSOR1 selects the first horizontal bar cursor as the active cursor. CURSOR:HBARS:SELECT? returns :CURSOR:HBARS:SELECT CURSOR1 when the first cursor is the active cursor. CURSor:HBArs:UNIts Sets or queries the measurement units for the horizontal bar cursors. Group Cursor Syntax CURSor:HBArs:UNIts <QString>...
Page 116 Command Descriptions <FIVEdivs> sets H Bar measurement scale so that 5 screen major divisions is 100%, where 0% is - -2.5 divisions and 100% is +2.5 divisions from the center horizontal graticule. Examples CURSOR:HBARS:USE FIVEdivs sets the H Bar measurement scale so that 5 screen major divisions equals 100%. Related Commands CURSor:HBArs:UNIts CURSor:MODe...
Page 117 Command Descriptions Examples CURSOR:VBARS:HDELTA? might return :CURSOR:VBARS:HDELTA 1.088000000E-3, indicating the time between the vertical bar cursors is 1.088 milliseconds. Related Commands CURSor:VBArs:UNIts CURSor:VBArs:HPOS<x>? (Query Only) Returns the horizontal value of the specified vertical bar ticks. Group Cursor Syntax CURSor:VBArs:HPOS<x>? Arguments <x>...
Page 118 Command Descriptions Arguments <x> specifies the cursor. Valid values are 1 and 2. <NR3> specifies the cursor position in the units specified by the CUR- Sor:VBArs:UNIts command. The position is relative to the trigger position. Examples CURSOR:VBARS:POSITION2 9.00E-6 positions vertical bar cursor 2 at 9 s from the trigger. CURSOR:VBARS:POSITION1? might return :CURSOR:VBARS:POSITION1 1.00E-6, indicating that vertical bar cursor 1 is at 1 s.
Page 119 Command Descriptions CURSor:VBArs:UNIts Sets or returns the units for the vertical bar cursors. This command is equivalent to setting Time Units in the CURSOR menu. Group Cursor Syntax CURSor:VBArs:UNIts <QString> CURSor:VBArs:UNIts? Arguments <QString> is either ”s” for seconds, ”Hz” for Hertz, ”%” for percent, or ”degrees”...
Page 120 Command Descriptions Examples CURSOR:VBARS:USE CURRENT sets the V Bar measurement scale to use the current cursor positions as 0% and 100% of scale if units are set to %. Related Commands CURSor:VBArs:UNIts CURSor:VBArs:VDELTa? (Query Only) Returns the vertical difference between the two vertical bar cursor ticks. The units are specified by the CURSor:HBArs:UNIts query.
Page 121 Command Descriptions CURSor:WAVEform:SELect Selects (makes active) or returns the specified XY display waveform cursor. This command is equivalent to pressing the SELECT button on the front panel when the XY Waveform cursors are active. Use the CURSor:VBArs commands to position the XY waveform cursors. Group Cursor Syntax...
Page 122 Command Descriptions CURSor:XY:PRODUCT<x>? (Query Only) (Available with TDS3AAM) Returns the value of the product readout for the specified XY cursor. XY display mode, XY cursors, and Product readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:PRODUCT<x>? Arguments <x>...
Page 123 Command Descriptions CURSor:XY:RATDELta? (Query Only) (Available with TDS3AAM) Returns the XY cursor ratio delta value. XY display mode, XY cursors, and Ratio readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:RATDELta? Examples CURSOR:XY:RATDELTA? might return CURSOR:XY:RATDELta -6.13E-1. Related Commands CURSor:XY:READOUT, DISplay:XY:MODe CURSor:XY:RATIO<x>? (Query Only)
Page 124 Command Descriptions CURSor:XY:RDELta? (Query Only) (Available with TDS3AAM) Returns the XY cursor radius delta value for the polar readout. XY display mode, XY cursors, and Polar readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:RDELta? Examples CURSOR:XY:RDELTA? might return CURSOR:XY:RDELTA 6.915E0.
Page 125 Command Descriptions CURSor:XY:RECTX<x>? (Query Only) Returns the XY cursor X-axis rectangular coordinate value for the specified cursor. XY display mode, XY cursors, and Rectangular readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:RECTX<x>? Arguments <x>, where x = 1 for the reference cursor and x = 2 for the delta cursor.. Examples CURSOR:XY:RECTX2? might return CURSOR:XY:RECTX2 1.72E0...
Page 126 Command Descriptions CURSor:XY:THDELta? (Query Only) (Available with TDS3AAM) Returns the XY cursor polar readout delta theta value. XY display mode, XY cursors, and Polar readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:THDELta? Examples CURSOR:XY:THDELTA? might return CURSOR:XY:THDELTA -3.176E1 Related Commands CURSor:XY:READOUT, DISplay:XY:MODe CURSor:XY:THETA<x>? (Query Only)
Page 127 Command Descriptions CURSor:XY:XDELta? (Query Only) (Available with TDS3AAM) Returns the difference (delta) between the X-axis values of the two XY cursors. XY display mode, XY cursors, and Rectangular readout must be enabled prior to executing this command. Group Cursor Syntax CURSor:XY:XDEta? Examples CURSOR:XY:XDELTA?
Page 128: Table 2- -31: Curve Query Error Conditions 2
Command Descriptions CURVe Transfers waveform data to and from the oscilloscope in binary or ASCII format. Formatted and interpreted according to the most recently received or transmitted preamble. Error conditions are shown in Table 2- -32. Table 2- 31: CURVE query error conditions DATA:SOURCE CURVE? error A channel which has been turned on...
Page 129 Command Descriptions Group Waveform Related Commands DATa, WFMPre? Syntax CURVe { <Block> | <asc curve> } CURVe? Arguments <Block> is the waveform data in binary format. The waveform is formatted as: #<x><yyy><data> where <x> is the number of y bytes. For example, if <yyy> = 500, then <x>...
Page 130 Command Descriptions DATa Sets or returns the format and location of the waveform data that is transferred with the CURVe command. Since DATa:DESTination and DATa:TARget are equivalent, only DATa:DESTination is returned by the DATa? query. Group Waveform Syntax DATa { INIT } DATa? Arguments INIT initializes the waveform data parameters to their factory defaults.
Page 131 Command Descriptions Examples DATA:DESTINATION REF3 stores incoming waveform data in reference memory 3. DATA:DESTINATION? might return REF2 as the reference memory location that is currently selected. DATa:ENCdg Sets or returns the format of the waveform data. This command is equivalent to setting WFMPre:ENCdg, WFMPre:BN_Fmt, and WFMPre:BYT_Or as shown in Table 2- -33.
Page 132: Table 2- -33: Data And Wfmpre Parameter Settings 2
Command Descriptions SRPbinary is the same as RPBinary except that the byte order is swapped, meaning that the least significant byte is transferred first. This format is useful when transferring data to IBM compatible PCs. Table 2- 33: DATa and WFMPre parameter settings WFMPre settings :ENCdg :BN_Fmt...
Page 133 Command Descriptions Examples DATA:SOURCE REF2 specifies that reference waveform two will be transferred in the next CURVE? query. DATA:SOURCE? might return CH1, indicating that channel 1 is the source for the waveform data that is transferred using a CURVE? query. DATa:STARt Sets or returns the starting data point for waveform transfer.
Page 134 Command Descriptions DATa:STOP Sets or returns the last data point that will be transferred when using the CURVe? query. This allows the transfer of partial waveforms to the controller. When using the CURVe command, the oscilloscope will stop reading data when there is no more data to read or when the specified record length has been reached so this command will be ignored.
Page 135 DATa:TARget Sets or returns the location for storing waveform data transferred to the instrument using the CURVe command. This command is equivalent to the DATa:DESTINATION command and is included for compatibility with older Tektronix instruments. Group Waveform Syntax DATa:TARget REF<x>...
Page 136 Command Descriptions DATE Sets or returns the date that the oscilloscope can display. Group Miscellaneous Syntax DATE <QString> DATE? Arguments <QString> is a date in the form “yyyy-mm-dd”. where mm refers to a two-digit month number from 01 to 12, dd refers to a two-digit day number in the month., and yyyy refers to a four-digit year number.
Page 137 Command Descriptions Examples *DDT #231AUTOSET EXECUTE;:SELECT:REF1 ON performs autoset and selects REF1. Related Commands ALlas:DEFINE, *TRG DESE Sets or returns the bits in the Device Event Status Enable Register (DESER). The DESER is the mask that determines whether events are reported to the Standard Event Status Register (SESR), and entered into the Event Queue.
Page 138 Command Descriptions DIAg:LOOP:OPTion Sets the diagnostic loop option. Group Calibration and Diagnostic Syntax DIAg:LOOP:OPTion {ALWAYS|FAIL|ONFAIL|ONCE} DIAg:LOOP:OPTion? Arguments ALWAYS continues looping until diagnostics are stopped via the front panel or by an instrument command. FAIL causes looping until the first diagnostic failure or until diagnostics are stopped.
Page 139 Command Descriptions DIAg:RESUlt:FLAg? (Query Only) Returns the pass/fail status from the last diagnostic test sequence execution. The DIAg:RESUlt:LOG? query can be used to determine which test(s) has failed. Group Calibration and Diagnostic Syntax DIAg:RESUlt:FLAg? Returns PASS indicating that all of the selected diagnostic tests have passed. FAIl indicating that at least one of the selected diagnostic tests has failed.
Page 140 Command Descriptions DIAg:STATE EXECute (Set Only) Executes the diagnostic tests that have been specified with the DIAg:SELect command. When the test sequence has completed, any of the modules or module interfaces that failed diagnostics are displayed on the screen and stored in an internal log file.
Page 141 Command Descriptions ENCE 500.0E-3;GRATICULE FULL;TRIGT 1;INTENSITY:OVERALL 85; WAVEFORM 70;TEXT 60;CONTRAST 150 DISplay:CLOCk Controls the display of the date and time. This is equivalent to setting Display Date/Time in the UTILITY menu. Group Display Syntax DISplay:CLOCk { OFF | ON | <NR1> } DISplay:CLOCk? Arguments <OFF>...
Page 142: Table 2- -34: Xy Format Pairs 2
Command Descriptions Related Commands HARDCopy:PALEtte DISplay:FORMat Sets or returns the display format. This command is equivalent to setting XY Display in the DISPLAY menu. Group Display Syntax DISplay:FORMat { GATEDxyz | XY | YT | VECtorscope } DISplay:FORMat? Arguments GATEDxyz displays XY signals only when the Z (gating) channel is true. Gated XYZ is similar to analog oscilloscope modulated XYZ mode except that the displayed XY signal is either on or off;...
Page 143 Command Descriptions DISplay:GRAticule Selects the type of graticule that is displayed. The TDS3VID and TDS3SDI application modules add IRE, mV, and PAL graticules to the standard graticule command, as well as a vectorscope display mode. Group Display Syntax DISplay:GRAticule { CROSSHair | FRAme | FULl | GRId | IRE | MV | VECtorscope | PAL } DISplay:GRAticule? Arguments...
Page 144 Command Descriptions DISplay:INTENSITy:BACKLight Sets or returns the backlight intensity for the display. This is equivalent to setting Backlight Intensity in the DISPLAY menu. Group Display Syntax DISplay:INTENSITy:BACKLight { HIGH | MEDium | LOW } DISplay:INTENSITy:BACKLight? Examples DISPLAY:INTENSITY:BACKLIGHT? might return :DISPLAY:INTENSITY:BACKLIGHT HIGH DISplay:INTENSITy:WAVEform Sets the intensity of the waveforms.
Page 145 Command Descriptions Syntax DISplay:PERSistence { <NR3> | INFInite | AUTO | MINImum } DISplay:PERSistence? Arguments <NR3> specifies the time, in seconds, that waveform points are displayed on the screen. INFInite displays waveform points until a control change resets the acquisition system.
Page 146 Command Descriptions DISplay:PICture:AUTOContrast (Requires TDS3VID or TDS3SDI) Sets or returns the video picture mode autocontrast setting. Group Display Syntax DISplay:PICture:AUTOContrast { OFF | ON | <NR1> } DISplay:PICture:AUTOContrast? Arguments <OFF> or <NR1> = 0 disables picture autocontrast mode. <ON> or <NR1> ¸ 0 enables picture autocontrast mode. Examples DISPLAY:PICTURE:AUTOCONTRAST? might return DISPLAY:PICTURE:AUTOCONTRAST ON, indicating that the video...
Page 147 Command Descriptions Related Commands DISplay:PICture:AUTOContrast, DISplay:PICture:CONTRAst, DISplay:PICture:STATE DISplay:PICture:CONTRAst (Requires TDS3VID or TDS3SDI) Sets or returns the video picture mode contrast setting. Group Display Syntax DISplay:PICture:CONTRAst <NR1> DISplay:PICture:CONTRAst? Arguments <NR1> sets the picture contrast value from 0 to 100. DISplay:PICture:AUTOCon- trast must be OFF in order to set the contrast value. Examples DISPLAY:PICTURE:CONTRAST? might return DISPLAY:PICTURE:CONTRAST 45, indicating that the video picture...
Page 148 Command Descriptions Examples DISPLAY:PICTURE:STATE? might return DISPLAY:PICTURE:STATE ON, indicating that the video picture mode is enabled. Related Commands DISplay:PICture:BRIghtness, DISplay:PICture:CONTRAst, DISplay:PICture:AUTOContrast DISplay:STYle:DOTsonly Selects waveform display style to dots only for XY & YT modes. This command is equivalent to setting Dots Only in the Waveform Display menu. Group Display Syntax...
Page 149 Command Descriptions ON or NR1 ≥ 1 enables the vectorscope display mode. Arguments OFF or NR1 ≤ 0 disables the vectorscope display mode. Examples DISPLAY:VECTORSCOPE:STATE? might return :DISPLAY:VECTORSCOPE:STATE 0 indicating that the vectorscope display mode is disabled (off). DISplay:VECtorscope:TY_SETTING (Requires TDS3VID or TDS3SDI) Sets or returns the video vectorscope display type setting state.
Page 150 Command Descriptions ONEHundred or NR1 ≥ 1 sets the vectorscope display mode to 100% colorbars. Arguments SEVENTYFive or NR1 ≤ 0 sets the vectorscope display mode to 75% colorbars. Examples DISPLAY:VECTORSCOPE:TYPE? might return :DISPLAY:VECTORSCOPE:TYPE 1 indicating that the vectorscope display mode is set to 100%. Display:XY? (Query Only) Returns all XY and Gated XYZ parameters.
Page 151: Table 2- -35: Xy Format Pairs 2
Command Descriptions Table 2- 35: XY format pairs X-Axis source Y-Axis source Ch2, Ch3, or Ch4 Ref1 Ref2, Ref3, or Ref4 GATEdxyz displays XY signals only when the Z (gating) channel is true. Gated XYZ is similar to analog oscilloscope modulated XYZ mode except that the displayed XY signal is either on or off;...
Page 152 Command Descriptions OFF sets the Y Channel to off or none which turns off or prevents the CH1 versus CH <x> waveform from being displayed in Triggered XY or prevents it from coming on if Triggered XY is turned on later. Examples DISPLAY:XY:YCHANNEL CH2 sets channel 2 to be displayed with channel 1 in Triggered XY mode.
Page 153 Command Descriptions either on or off; there is no intensity modulation. Gated XYZ is useful for showing constellation diagrams. Group Display Syntax DISplay:XY:ZCHannel { ? | CH2 | CH3 | CH4 } DISplay:XY:ZCHannel? Arguments <CH2 - CH4> specifies which channel to use as the Z channel source. Examples DISPLAY:XY:ZCHANNEL CH2 sets oscilloscope channel 2 as the Z channel source in gated XYZ mode.
Page 154 Command Descriptions Syntax *ESE <NR1> *ESE? Arguments <NR1> is a value in the range from 0 through 255. The binary bits of the ESER are set according to this value. The power-on default for ESER is 0 if *PSC is 1. If *PSC is 0, the ESER maintains its value through a power cycle.
Page 155 Command Descriptions ETHERnet:DCHPBOOTP (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the network initialization search for a DCHP/BOOTP server. Group Ethernet Syntax ETHERnet:DCHPBOOTP { OFF | ON | <nr1> } ETHERnet:DCHPBOOTP? ON or nr1 ≥ 1 enables the oscilloscope to search the network for a DCHP or Arguments BOOTP server in order to automatically assign a dynamic IP address to the oscilloscope.
Page 156 Command Descriptions Example ETHERNET:DNS:IPADDRESS ”128.196.12.122” sets the DNS IP address that the oscilloscope uses to communicate with the network. ETHERnet:DOMainname (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the network domain name. Group Ethernet Syntax ETHERnet:DOMainname <QString> ETHERnet:DOMainname? Arguments <QString>...
Page 157 Command Descriptions ETHERnet:GATEWay (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the remote interface gateway IP address. Group Ethernet Syntax ETHERnet:GATEWay <QString> ETHERnet:GATEWay? Arguments <QString> is a standard IP address value, enclosed in quotes. Example ETHERNET:GATEWAY ”128.143.16.1” sets the gateway IP address. ETHERnet:HTTPPORT (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the remote interface HTTP port value.
Page 158 Command Descriptions Syntax ETHERnet:IPADDress <QString> ETHERnet:IPADDress? Arguments <QString> is a standard IP address value, enclosed in quotes. Examples ETHERNET:IPADDRESS ”123.103.78.90” sets the oscilloscope’s IP address. ETHERnet:NAME (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the network name assigned to the oscilloscope. Group Ethernet Syntax...
Page 159 Command Descriptions the server name or server IP address is required. If you do not use all three fields, the missing field delimiter must still be used. NOTE. If DNS services are not available, all these fields must be filled in. Adding a printer that already exists in the list is equivalent to doing a rename printer operation;...
Page 160 Command Descriptions ETHERnet:NETPRInter:DELWarn (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Sets or returns the oscilloscope on-screen printer delete warning message. No deletion warning message is sent over the network. Group Ethernet Syntax ETHERnet:NETPRInter:DELWarn { OFF | ON | <nr1> } ETHERnet:NETPRInter:DELWarn? Arguments OFF turns off delete warning...
Page 161 Command Descriptions Examples ETHERNET:NETPRINTER:RENAME ”QMSprt;prtserva1;128.121.33.21”, ”QMScolor;prtserva1;128.121.33.21” renames the network printer name from QMSprt to QMScolor. ETHERnet:NETPRInter:SELect:ALLInfo? (Query Only) (TDS3000B Series, TDS3000C Series, and TDS3EM Only) Returns a composite string that contains the active (selected) network printer name, printer server name, and print server IP address. Group Ethernet Syntax...
Page 162 Command Descriptions ETHERnet:PASSWord (Set Only) (TDS3000B Series, TDS3000C Series, and TDS3EM Only) This command sets the Ethernet access password. Group Ethernet Syntax ETHERnet:PASSWord ”old”,”new” Arguments old is the current password, enclosed in quotes. If there is no current password, enter a null character (two quotes with no character between). new is a new password, enclosed in quotes.
Page 163 Command Descriptions Group Ethernet Syntax ETHERnet:PING:STATUS? { NEVER | OK | NORESPONSE | TRYING } Arguments NEVER if ETHERnet:PING:EXECUTE command has never been sent during this power-on session. OK if the most recent ETHERnet:PING:EXECUTE command was successfully sent. NORESPONSE if the ETHERnet:PING:EXECUTE command failed to find the oscilloscope on the network.
Page 164 Command Descriptions Group Status and Error Related Commands Syntax ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB? Syntax EVENT Examples EVENT? might return the response :EVENT 110, showing that there was an error in a command header. EVMsg? (Query Only) Returns from the Event Queue a single event code associated with the results of the last *ESR? read, and returns the event code along with an explanatory message.
Page 165 Command Descriptions EVQty? (Query Only) Returns the number of event codes that are in the Event Queue. This is useful when using the ALLEv? query since it lets you know exactly how many events will be returned. Group Status and Error Syntax EVQty? Examples...
Page 166 Command Descriptions Examples FILESYTEM? might return :FILESYSTEM:CWD “fd0:/”;DELWARN 1;OVERWRITE 1, (Confirm Delete on, Overwrite Lock on). Related Commands FILESsystem:CWD?, FILESystem:DELWarn, FILESystem:OVERWrite FILESystem:COPy (Set Only) Copies a named file or files to a new file. The new file may be in a totally separate directory than the old file.
Page 167 Command Descriptions FILESYSTEM:COPY “YOURDIR”,“fd0:/MYDIR” copies the files in the YOURDIR directory in the current directory to the MYDIR directory on the fd0: drive. FILESystem:CWD Sets or returns the current working directory (CWD) path. This remote interface working directory is not the same as the working directory used by the oscillo- scope menus.
Page 168 Command Descriptions The current directory refers to the name of a directory as returned by the FILESystem:CWD query. Examples FILESYSTEM:DELETE “NOT_MINE.SET” deletes the file named NOT_MINE.SET in the current directory. FILESYSTEM:DELETE “*.*” deletes all the files in the current directory. FILESystem:DELWarn Turns on or off the file-delete warning message.
Page 169 Command Descriptions Examples FILESYSTEM:DIR? returns a list of files and directories in the current directory. FILESystem:FORMat (Set Only) Formats a named drive. Group File system Syntax FILESystem:FORMat <drive name> Arguments <drive name> is a quoted string that defines the drive to format. Examples FILESYSTEM:FORMAT “fd0:”...
Page 170 Command Descriptions Arguments <directory path> is a quoted string that defines the directory. Input the directory using the form <drive>/<dir>/<directory name>. <drive> and one or more <dir>s are optional. If you do not specify them, the oscilloscope will create the directory in the current directory. <directory name> stands for a directory name of up to 8 characters and can be followed by a period (“.”) and a 3-character extension.
Page 171 Command Descriptions FILESystem:PRInt (Set Only) Prints a named file to the named port. Group File system Syntax FILESystem:PRInt <filepath>,{ GPIb | RS232 | CENtronics | ETHERnet} Arguments <file path> is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.
Page 172 Command Descriptions <new file path> is a quoted string that defines the new name of the file. Input the file path using the form <drive>/<dir>/<filename>. <drive> and one or more <dir>s are optional. If you do not specify them, the oscilloscope will place the newly named file in the current directory.
Page 173: Table 2- -36: Fpanel:press Arguments 2
Command Descriptions FPAnel:PRESS (Set only) Duplicates the action of pressing a specified front-panel button. Group Miscellaneous Syntax FPAnel:PRESS { ACQuire | AUTOSet | BMENU<x> | BTRIG | CH<x> | CLEARMenu | COARSE | CURSor | DELay | DISplay | FORCETRIG | HARDCopy | MATH | MEASUrement | OFF | QUICKmenu | REF | RMENU<x>...
Page 174 Command Descriptions FPAnel:TURN (Set only) Duplicates the action of turning a specified front-panel control knob. Group Miscellaneous Syntax FPAnel:TURN { [ GPKNOB | HORZPOS | HORZSCALE | INTENSITY | TRIGLEVEL | VERTPOS | VERTSCALE ] , <n> } Arguments Most of the argument names associate directly with their front panel knob. For example, GPKNOB is for the general purpose knob, HORZSCALE is for the horizontal scale knob, and so on.
Page 175 Command Descriptions Syntax HARDCopy { ABOrt | CLEARSpool | STARt } HARDCopy? Arguments ABOrt terminates the hard copy output in process. CLEARSpool is equivalent to ABOrt. STARt initiates a screen copy that can be stored in a file or redirected to a printing device.
Page 176 Command Descriptions Examples HARDCOPY:COMPRESSION ON enables hard copy file compression. HARDCopy:FILEName Specifies the file that hard copy data is written to on the next HARDCOPY START command. To do multiple hard copies using the HARDCOPY START command you must change the HARDCopy:FILEName before each HARDCOPY START or the same file will be overwritten each time.
Page 177 Command Descriptions HARDCopy:FORMat Selects the output data format for hardcopies. This is equivalent to setting Format in the UTILITY/Hard Copy menu. Group Hard copy Syntax HARDCopy:FORMat { TDS3PRT | BMP | BMPColor | DESKJET | DESKJETC | EPSColor | EPSMono | EPSOn | INTERLeaf | LASERJet | PCX | PCXcolor | RLE | THInkjet | TIFf | DPU3445 | BJC80 | PNG} HARDCopy:FORMat? Arguments...
Page 178 Command Descriptions THInkjet sets the hard copy file format to HP monochrome ink-jet printer format. (TDS3000B Series and TDS3000C Series only.) TIFf sets the hard copy file format to tag image file format. DPU3445 sets the hard copy file format to Seiko DPU-3445 thermal printer format.
Page 179 Command Descriptions HARDCopy:LAYout Selects the printing orientation. This is equivalent to setting Layout in the UTILITY > System:Hard Copy > Options menu. Group Hard copy Syntax HARDCopy:LAYout { LANdscape | PORTRait } HARDCopy:LAYout? Arguments LANDscape specifies that the bottom of the hard copy is along the long side of the page.
Page 180 HARDCopy:PORT? Arguments CENtronics specifies that the hard copy is sent out the Centronics port. (TDS3000 Series and TDS3000B Series only.) FILE specifies that the hard copy is stored in the file named in the HARDCOPY:FILENAME command. GPIb specifies that the hard copy is sent out the GPIB port (available with optional TDS3GM and TDS3GV communication modules).
Page 181 HARDCOPY:PREVIEW ON will change the display to simulate hard copy output with the current format, layout, palette, and inksaver options. This command is identical to the HEADer query and is included for compatibili- ty with older Tektronix instruments. Group Miscellaneous Syntax HDR { <NR1>...
Page 182 Command Descriptions ON or <NR1> ¸ 0 sets the Response Header Enable State to true. This causes the Arguments oscilloscope to include headers on applicable query responses. You can then use the query response as a command. OFF or <NR1> = 0 sets the Response Header Enable State to false. This causes the oscilloscope to omit headers on query responses so that only the argument is returned.
Page 183 Command Descriptions Syntax HORizontal:DELay:STATE { ON | OFF } HORizontal:DELay:STATE? ON or <NR1> ¸ 0 sets the delay on so that the acquisition is positioned relative to Arguments the delay time. OFF or <NR1> = 0 sets the delay off so that the acquisition is positioned relative to the trigger position.
Page 184 HORizontal:DELay:TIMe, HORizontal:MAIn:SECdiv HORizontal:MAIn:SECdiv Sets the time per division for the 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. Group Horizontal Syntax HORizontal:MAIn:SECdiv <NR3>...
Page 185 Command Descriptions HORizontal:RECORDLength Sets the number of data points that are acquired for each record. Group Horizontal Syntax HORizontal:RECORDLength <NR1> HORizontal:RECORDLength? Arguments <NR1> is the record length in points. Valid values are 500 and 10000. Examples HORIZONTAL:RECORDLENGTH 500 specifies that 500 data points will be acquired for each record. HORIZONTAL:RECORDLENGTH? might return 10000 as the number of data points per record.
Page 186 Command Descriptions HORizontal:SCAle Sets the time per division for the main time base and is identical to the HORi- zontal:MAIn:SCAle command. It is provided to maintain program compatibility with some older models of Tektronix oscilloscopes. Group Horizontal Syntax HORizontal:SCAle <NR3>...
Page 187 Examples might return ID TEK/TDS 3054,CF:91.1CT,FV:v1.00 TDS3GM:v1.00 TDS3FFT:v1.00 TDS3TRG:v1.00 TDS3VID:v1.00 *IDN? (Query Only) Returns the same oscilloscope information as the ID? command except the data is formatted according to Tektronix Codes & Formats. Group Status and Error Syntax *IDN? Returns The instrument id in the following format: TEKTRONIX,<model number>,0,CF:91.1CT FV:<firmware version number>...
Page 188 Command Descriptions ITU601:AUTOSet (Set Only) (TDS3000B and TDS3000C Series with TDS3SDI Only) Executes the TDS3SDI autoset function to automatically acquire and display the 601 digital video signal in the specified format. Group TDS3SDI Syntax ITU601:AUTOSet { ALLFields | ALLLines | RGB | YC | YPBPR } Arguments ALLFields sets the oscilloscope to display the 601 digital video signal as a composite signal on channel 1, triggered on all fields.
Page 189 Command Descriptions ITU601:EDH:COUNt (TDS3000B and TDS3000C Series with TDS3SDI Only) Sets or returns the state of the TDS3SDI EDH error counter. Group TDS3SDI Syntax ITU601:EDH:COUNt { OFF | ON | <NR1> } ITU601:EDH:COUNt? Arguments OFF or <NR1> = 0 disables the EDH error count function. ON or <NR1>...
Page 190 Command Descriptions ITU601:EDH:NUMERRors? (Query Only) (TDS3000B and TDS3000C Series with TDS3SDI Only) Returns the number of errors stored in the TDS3SDI EDH error counter. Group TDS3SDI Syntax ITU601:EDH:NUMERRors? Examples ITU601:EDH:NUMERRORS? might return the response ITU601:EDH:NUMERRORS 0, indication that the EDH error counter value is zero (no errors).
Page 191 Command Descriptions ITU601:INPUT:SIGnalstrength? (Query Only) (TDS3000B and TDS3000C Series with TDS3SDI Only) Returns the value of the TDS3SDI input signal strength parameter. The signal strenght value is an integer in the range of 0 to 5, where 0 = no signal present and 5 = maximum signal strength.
Page 192 Command Descriptions ITU601:OUTput:FORMat (TDS3000B and TDS3000C Series with TDS3SDI Only) Sets or returns the TDS3SDI video signal output display format. Group TDS3SDI Syntax ITU601:OUTput:FORMat { OFF | GBR | RGB | YC | YPBPR } ITU601:OUTput:FORMat? Arguments OFF sets the TDS3SDI module to turn off its signal output. GBR sets the TDS3SDI module to output GBR color signal information.
Page 193 Command Descriptions LIMit? (Query Only) (Requires TDS3LIM) Returns all limit testing parameters. Group Limit Test Syntax LIMit? Examples LIMIT? might return: :LIMIT:BEEP OFF; COMPARE:CH1 REF1;CH2 NONE;CH3 NONE;CH4 NONE; :LIMIT:HARDCOPY OFF;SAVEWFM OFF;STATE OFF;STOPONVIOLATION OFF;TEMPLATE:DESTINATION REF1;SOURCE CH1;TOLERANCE:HORIZONTAL 4.0E-2;VERTICAL 4.0E-2. LIMit:BEEP (Requires TDS3LIM) Sets or returns the TDS3LIM beep on error setting.
Page 194 Command Descriptions LIMit:COMPARE:CH<x> (Requires TDS3LIM) Sets or returns the template against which to compare the waveform acquired through the specified channel. The template can be a waveform saved in any of the reference locations REF1 through REF4, or none. Group Limit Test Syntax LIMit:COMPARE:CH<x>...
Page 195 Command Descriptions Syntax LIMit:HARDCopy { OFF | ON | <NR1> } LIMit:HARDCopy? ON or <NR1> ¸ 0 turns on the hard copy operation when any waveform data Arguments exceeds the limits set by the limit test. OFF or <NR1> = 0 turns off the hard copy operation. Examples LIMit:HARDCopy ON specifies that the hard copy operation occurs when any waveform data exceeds...
Page 196 Command Descriptions LIMIT:STATE? returns either 0 or 1, indicating whether save waveform to disk or flash drive is in effect. Related Commands SAVEWFM, SAVe:WAVEform:FILEFormat LIMit:STATE (Requires TDS3LIM) Turns limit testing on or off, or returns whether limit testing is in effect. Group Limit Test Syntax...
Page 197 Command Descriptions Syntax LIMit:STOPOnviolation { OFF | ON } LIMit:STOPOnviolation? Arguments OFF = 0 turns off the stop on violation. ON ¸ 0 turns on the stop on violation. Examples LIMIT:STOPOnviolation? might return OFF that indicates the stop on violation is turned off. Related Commands MASK:STOPOnviolation LIMit:TEMPLate (Set Only)
Page 198 Command Descriptions LIMit:TEMPLate:DESTination (Requires TDS3LIM) Sets or returns the destination reference waveform that the LIMit:TEMPLate STORe command will use. Group Limit Test Syntax LIMit:TEMPLate:DESTination REF<x> LIMit:TEMPLate:DESTination? 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...
Page 199 Command Descriptions Examples LIMIT:TEMPLATE:SOURCE CH2 specifies that the template waveform for limit tests is the waveform currently acquired using channel 2. LIMIT:TEMPLATE:SOURCE? might return CH2, specifying that the template waveform source for limit tests is the waveform currently stored as the channel 2 waveform. Related Commands LIMit:COMPARE:CH<x>, LIMit:TEMPLate, LIMit:TEMPLate:DESTination LIMit:TEMPLate:TOLerance:HORizontal...
Page 200 Command Descriptions LIMit:TEMPLate:TOLerance:VERTical (Requires TDS3LIM) Sets or returns the amount, in units of vertical divisions, by which the source waveform is varied vertically when creating the destination waveform. Group Limit Test Syntax LIMit:TEMPLate:TOLerance:VERTical <NR3> LIMit:TEMPLate:TOLerance:VERTical? Arguments <NR3> is the amount, in vertical divisions, by which the source waveform is varied vertically when creating the test waveform.
Page 201 Command Descriptions LOCk Sets or returns the front panel lock state. This command lets you disable all front-panel buttons and knobs to prevent manual instrument setting changes while remotely controlling the oscilloscope. There is no front-panel equivalent. Group Miscellaneous Syntax LOCk { ALL | NONe } LOCk? Arguments...
Page 202 Command Descriptions *LRN? (Query Only) Returns a string listing the oscilloscope settings. You can use this string to return the oscilloscope to the state it was in when you made the *LRN? query. Group Miscellaneous Related Commands HEADer, SET?, VERBose Syntax *LRN? NOTE.
Page 203 Command Descriptions MASK:AUTOFit (Requires TDS3TMT) Sets or returns the autofit radius setting used for waveform positioning. Autofit does a incremental waveform position redraw to attempt to fit the waveform to a mask. MASK:DISplay must be On to enable Autofit functionality. Group Mask Syntax...
Page 204 Command Descriptions MASK:COPy:SOUrce (Requires TDS3TMT) Sets or returns the mask standard to copy to the User mask when the MASK:COPy:USER command is executed. Group Mask Syntax MASK:COPy:SOUrce { CLOCKCoax | CLOCKSymmetrical | DS0Contra |DS0Double | DS0Single | DS0Timing | DS1C | DS1Rate | DS2 | DS2RATECoax | DS2RATESymmetrical | DS3Rate | E1Coax | E1Symmetrical | E2 | E3 | G703DS1 | G703DS3 | NONe | RATE32Mbit | STS1Pulse }...
Page 205 Command Descriptions MASK:COUNt:CH<x>:HITS? (Query Only) (Requires TDS3TMT) Returns the total hits on all mask segments for the specified channel. Hit counting must be turned on (MASK:COUNt:STATE and MASK:DISplay to ON). Group Mask Syntax MASK:COUNt:CH<x>:HITS? Arguments <x> is an integer in the range of 1 to 4 that sets which scope channel to query for mask hits.
Page 206 Command Descriptions MASK:COUNt:HITS? (Query Only) (Requires TDS3TMT) Returns the total number of mask hits for all channels on all mask segments. Group Mask Syntax MASK:COUNt:HITS? Examples MASK:COUNT:HITS? might return 564. Related Commands MASK:COUNt:FAILURES? MASK:COUNt:CH<c>:HITS? MASK:COUNt:MASK<m>:CH<x>:HITS? (Query Only) (Requires TDS3TMT) Returns the number of hits for channel <x> in mask segment <m>. A mask segment is one of the polygons that make up a mask.
Page 207 Command Descriptions MASK:COUNt:MASK<m>:HITS? (Query Only) (Requires TDS3TMT) Returns the number of hits for all channels in the specified mask segment. Group Mask Syntax MASK:COUNt:MASK<m>:HITS? Arguments <m> is the mask segment number, with a valid range of 1-8. Examples MASK:COUNT:MASK1:HITS? might return 124. Related Commands MASK:COUNt:CH<x>:HITS?, MASK:COUNt:FAILURES?, MASK:COUNt:HITS? MASK:COUNt:MASK<m>:CH<x>:HITS?
Page 208 50. Related Commands MASK:COUNt:FAILURES? MASK:COUNt:TOTal? (Query Only) (Requires TDS3TMT) Returns the sum of all hits in all mask segments.This command is the same as MASK:COUNt:HITS? and is kept for compatibility with other Tektronix oscillo- scopes. Group Mask Syntax MASK:COUNt:TOTal?
Page 209 Command Descriptions MASK:COUNt:VIOLATIONS? (Query Only) (Requires TDS3TMT) Returns the number of test violations which have occurred in the current pass/fail test. A test violation occurs when any part of a channel waveform falls within any mask segment. Group Mask Syntax MASK:COUNt:VIOLATIONS? Examples MASK:COUNT:VIOLATIONS?
Page 210 Command Descriptions MASK:DISplay (Requires TDS3TMT) Sets or returns the mask violation detection and display status. Enabling detection and display causes waveform points which violate the mask to be displayed in an intensified color so that mask violation points are clearly visible on the display.
Page 211 Command Descriptions Arguments OFF turns off mask lock to waveform. ON turns on mask lock to waveform. <NR1> is an integer number where NR1 = 0 turns off mask lock to waveform, and NR1 ≠ 0 turns on mask lock to waveform. Examples MASK:LOCk OFF turns off mask lock to waveform.
Page 212 Command Descriptions MASK:MASK<m> DELEte (Requires TDS3TMT) Deletes the specified mask segment from the User mask, whether or not the User mask is the current mask. Group Mask Syntax MASK:MASK<m> DELEte Arguments <m> is an integer number that specifies the User mask segment number to delete from the User mask Examples MASK:MASK2 DELETE...
Page 213 Command Descriptions MASK:MASK<m>:NR_Pt? (Query Only) (Requires TDS3TMT) Returns the number of points that make up the specified mask segment of the currently-displayed mask. Each mask point consists of an X-Y pair of coordi- nates. Group Mask Syntax MASK:MASK<m>:NR_Pt? Arguments <m> is an integer number that specifies a mask segment number in the currently- displayed mask.
Page 214 Command Descriptions Arguments <m> specifies the mask segment number in the current mask (query form), or the User mask (set form). <NR3> refers to the coordinates of one of the vertices in the mask. Each pair of numbers is the horizontal and vertical coordinates of a mask segment vertex. The pairs must be listed in a counterclockwise order.
Page 215 Command Descriptions MASK:MASK<m>:POINTSPcnt (Requires TDS3TMT) Sets or returns the points in the specified mask segment, in graticule percentage coordinates. Each point is defined as an X-Y pair, where the first value in the pair is the X coordinate, and the second value in the pair is the Y coordinate. Values are screen-based percentages where 0.0, 0.0 is the upper-left corner of the graticule, and 100.0, 100.0 is the lower-right corner of the graticule.
Page 216 Command Descriptions MASK:MASKPRE:AMPlitude (Requires TDS3TMT) Sets or returns the current mask’s nominal pulse amplitude in volts. The query form of this command returns the nominal pulse amplitude of the displayed mask. The set form of this command only affects the User mask, regardless of the current (displayed) mask.
Page 217 Command Descriptions Arguments <NR3> is a floating point number that sets the mask drawing timing resolution. Examples MASK:MASKPRE:HSCALE 40e-9 sets the nominal timing resolution used to draw the current standard’s pulse shape to 40 nanoseconds per division. Related Commands MASK:MASKPRE:HTRIGPOS MASK:MASKPRE:HTRIGPOS (Requires TDS3TMT) Sets or returns the nominal trigger position (pulse leading edge) used to draw the...
Page 218 Command Descriptions MASK:MASKPRE:PATTERNBITS (Requires TDS3TMT) Sets or returns the number of bits used for serial trigger for the current standard. For example, DS1 requires six bits; four leading zeros, a one, and a trailing zero. The query form of this command returns the serial bit value of the displayed mask.
Page 219 Command Descriptions Examples MASK:MASKPRE:PRESAMPBITS 4 sets the User mask number of bits before the trigger pulse to 4. Related Commands MASK:MASKPRE:PATTERNBITS MASK:MASKPRE:SERIALTRIG MASK:MASKPRE:RECOrdlength (Requires TDS3TMT) Sets or returns the nominal record length for pulse mask testing. The query form of this command returns the record length value of the displayed mask. The set form of this command only affects the User mask, regardless of the current (displayed) mask.
Page 220 Command Descriptions Arguments OFF disables serial triggering. ON enables serial triggering. <NR1> is an integer number where NR1 = 0 turns off serial triggering, and NR1 ≠ 0 turns on serial triggering. Examples MASK:MASKPRE:SERIALTRIG 1 turns on serial triggering for the User mask. Related Commands MASK:MASKPRE:PATTERNBITS?, MASK:MASKPRE:PRESAMPBITS MASK:MASKPRE:TRIGTOSAMP...
Page 221 Command Descriptions MASK:MASKPRE:VOFFSet (Requires TDS3TMT) Sets or returns the nominal vertical offset, in volts, used to vertiaclly offset the input channels. The query form of this command returns the offset value of the displayed mask. The set form of this command only affects the User mask, regardless of the current (displayed) mask.
Page 222 Command Descriptions Related Commands MASK:MASKPRE:VOFFSet, MASK:MASKPRE:VPOS, MASK:MASKPRE:VSCAle MASK:MASKPRE:VSCAle (Requires TDS3TMT) Sets or returns the nominal vertical scale, in volts per division, used to vertically scale the input channels. The query form of this command returns the vertical scale value of the displayed mask. The set form of this command only affects the User mask, regardless of the current (displayed) mask.
Page 223 Command Descriptions Examples MASK:MASKPRE:WIDTH 648e-9 sets the User mask nominal bit width to 648 nanoseconds (1.544 Mbits/second). Related Commands MASK:MASKPRE:TRIGTOSAMP MASK:POLarity (Requires TDS3TMT) Sets or returns the input waveform polarity for the pass/fail test. This command only applies when MASK:TESt:STATE is on. Group Mask Syntax...
Page 224 Command Descriptions MASK:STANdard (Requires TDS3TMT) Set or returns the currently-displayed mask. To turn mask display off, set the standard to NONe. Group Mask Syntax MASK:STANdard { CLOCKCoax | CLOCKSymmetrical | DS0Contra | DS0Double | DS0Single | DS0Timing | DS1C | DS1Rate | DS2 | DS2RATECoax | DS2RATESymmetrical | DS3Rate | E1Coax | E1Symmetrical | E2 | E3 | G703DS1 | G703DS3 | NONe | RATE32Mbit | STS1Pulse| USERMask }...
Page 225 Command Descriptions Examples MASK:STOPONVIOLATION ON sets the oscilloscope to stop waveform acquisition on the first occurance of a waveform violation. MASK:TESt:BEEP:COMPLetion (Requires TDS3TMT) Sets or returns the beep on pass/fail test completion mode. When enabled, this command causes the oscilloscope to emit a tone when the mask pass/fail test status changes to either ‘Passed’...
Page 226 Command Descriptions Arguments OFF turns off pass/fail beep on failure. ON turns on pass/fail beep on failure. <NR1> is an integer number where NR1 = 0 turns off pass/fail beep on failure, and NR1 ≠ 0 turns on pass/fail beep on failure. Examples MASK:TEST:BEEP:FAILURE OFF turns off pass/fail beep on failure.
Page 227 Command Descriptions NOTE. The oscilloscope generates a hard copy only on the first violation that causes the pass/fail test to fail. To generate a hard copy file for every violation occurrence, set MASK:TESt:REPeat to ON and set MASK:TESt:WAVEform to 1. Use this technique only when the expected number of violations is small and the violation occurs intermittently.
Page 228 Command Descriptions Examples MASK:TEST:REPEAT ON causes the oscilloscope to continuously repeat the pass/fail test. MASK:TESt:SAVEWFM (Requires TDS3TMT) Sets or returns the save waveform to file on failure setting. When enabled, this command copies waveform data from all active channels to files when the pass/fail test status changes to ‘Failing.’...
Page 229 Command Descriptions MASK:TESt:STATE (Requires TDS3TMT) Sets or returns the state of mask pass/fail testing. When enabled, this command resets the pass/fail status information and starts pass/fail mask testing. This command also generates an ”Operation Complete” message when pass/fail testing completes. Refer to the BUSY? and *OPC commands in this manual for information on synchronizing a controller with pass/fail testing.
Page 230 Command Descriptions MASK:TESt:THReshold (Requires TDS3TMT) Sets or returns the maximum number of tested waveforms that are allowed to fail during each pass/fail test before the pass/fail test status changes from PASSING to FAILING. Group Mask Syntax MASK:TESt:THReshold <NR1> MASK:TESt:THReshold? Arguments <NR1>...
Page 231 Command Descriptions MASK:USER:MASK<m> DELEte (Requires TDS3TMT) Deletes the specified mask segment from the User mask, whether or not the User mask is the current mask. Group Mask Syntax MASK:USER:MASK<m> DELEte Arguments <m> is an integer number that specifies the User mask segment number to delete from the User mask.
Page 232 Command Descriptions MASK:USER:MASK<m>:POINTS (Requires TDS3TMT) Sets or returns the X-Y user coordinates of all points in the specified User mask segment. The set form defines new points in the User mask, replacing any existing points in the specified User mask segment. Group Mask Syntax...
Page 233 Command Descriptions Arguments <m> is an integer number that specifies the User mask segment number. <NR3> is a floating point number that defines a normalized User mask point. Examples MASK:USER:MASK<m>:POINTSNORM? might return -0.77, 1.05, -0.5, -0.9, 0.5, 1.0, 1.16, 0.5 MASK:USER:MASK<m>:POINTSPcnt (Requires TDS3TMT) Sets or returns the points in the specified User mask segment, in percentage...
Page 234 Command Descriptions MASK:USER:MASKPRE Commands (Requires TDS3TMT) The following commands have the same arguments and functionality as the MASK:MASKPRE commands, except that the MASK:USER:MASKPRE commands only set or return values for the User mask, regardless of the currently-displayed mask standard. Refer to the corresponding MASK:MASKPRE command for command descriptions, syntax and argument information, and examples.
Page 235 Command Descriptions MATH? (Query Only) Returns the definition of the math waveform. The returned data depends on the setting of the MATH:TYPE command Group Math Syntax MATH? Examples When the math type is Dual, MATH? might return MATH:TYPE DUAL;DEFINE ”CH1+CH2”;VERTICAL:SCALE 2.0E-1; POSITION 0.0E0;UNITS ”?”;:MATH:HORIZONTAL:SCALE 4.0E-4;...
Page 236 Command Descriptions MATH:DEFINE Sets or returns the current math function as a text string. For TDS3AAM, this command sets or returns the math FFT parameters. For the TDS3AAM, this command also sets or returns the advanced math parameters. This is equivalent to setting the math parameters in the Math menu.
Page 237: Table 2- -37: Advanced Math Expression Elements 2
Command Descriptions window is an optional argument that sets the FFT window algorithm to apply to the source signal. Valid choices are RECTangular, HAMming, HANning, and BLAckmanharris. Each window is a trade-off between frequency resolution and magnitude accuracy. What you want to measure, and your source signal characteristics, help determine which window to use.
Page 238 Command Descriptions Examples MATH:TYPE DUAL;:MATH:DEFINE ”CH2*REF4” sets the math type to Dual and displays a Dual math waveform that is the product of the channel 1 waveform and the REF4 waveform. MATH:TYPE FFT;:MATH:DEFINE ”FFT( CH1 )” sets the math type to FFT and displays an FFT waveform of the channel 1 waveform, using the current FFT scale and window settings.
Page 239 Command Descriptions horizontal scale of a dual math waveform with a channel source waveform is set through the HORizontal:SCAle command. Group Math Syntax MATH:HORizontal:SCAle <NR3> MATH:HORizontal:SCAle? Arguments <NR3> is the math horizontal scale in seconds. Examples MATH:HORIZONTAL:SCALE? might return :MATH:HORIZONTAL:SCALE 2.0E-4 indicating that the math horizontal scale is 200 s.
Page 240 Command Descriptions MATH:SPECTral:MAG? Arguments DB sets the FFT vertical scale to dBV RMS. LINEAR sets the FFT vertical scale to linear RMS. Examples MATH:SPECTRAL:MAG? might return :MATH:SPECTral:MAG dB indicating the the FFT vertical scale is set to dB. MATH:SPECTral:WINdow Sets or returns the FFT math waveform window algorithm setting. Group Math Syntax...
Page 241 Command Descriptions MATH:TYPe? Arguments ADVanced sets the math waveform mode to advanced math. TDS3AAM only. DPO sets the math waveform mode to DPO math. TDS3AAM only. DUAL sets the math waveform mode to dual waveform math. FFT sets the math waveform mode to FFT math. (TDS3AAM and TDS3FFT, available on TDS3000B Series and TDS3000C Series oscilloscopes.) Examples MATH:TYPE FFT...
Page 242 Command Descriptions Group Math Syntax MATH:VERTical:POSition <NR3> MATH:VERTical:POSition? Arguments <NR3> is the math vertical position in divisions from center screen. Examples MATH:VERTICAL:POSITION? might return :MATH:VERTICAL:POSITION -3.0E0 indicating the the math waveform is 3 division below center screen. MATH:VERTical:SCAle Sets the vertical display scale. This command is equivalent to changing the Vertical SCALE knob that controls the waveform zoom factors.
Page 243: Table 2- -38: Math1: Commands 2
MATH1 Commands The MATH1 commands listed in Table 2- -38 are the same as their associated MATH commands, and are for compatibility with other Tektronix instruments. Refer to the equivalent MATH command for syntax and function information. Group...
Page 244 Command Descriptions MEASUrement? (Query Only) Returns all measurement values for the last-acquired waveform. Group Measurement Syntax MEASUrement? Example MEASUREMENT? might return :MEASUREMENT:MEAS1:TYPE FREQUENCY;UNITS ”s” COUNT 0;MINIMUM 0. 0.0E0;MAXIMUM 0.0E0;MEAN 0.0E0;STDDEV 0.0E0;SOURCE1 CH1;SOURCE2 CH2;DELAY:DIRECTION FORWARDS;EDGE1 RISE1;EDGE2 RISE;:MEASURE- MENT:MEAS1:STATE 0;:MEASUREMENT:MEAS2:TYPE PERIOD;UNITS ”s”;COUNT 0;MINIMUM 0.0E0;MAXIMUM 0.0EO;MEAN 0.0E0;STDDEV 0.0E0;SOURCE1 CH1;SOURCE2 CH2;DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS2:STATE 0;:MEASUREMENT:MEAS3:TYPE PE-...
Page 245 Command Descriptions MEASUrement:GATing Sets or returns measurement gating. Group Measurement Syntax MEASUrement:GATing { SCREen | CURSor | OFF } MEASUrement:GATing? Arguments OFF turns off measurement gating. SCREen limits measurements to the portion of the waveform displayed on the screen. CURSor limits measurements to the portion of the waveform between the vertical bar cursors, even if they are off screen.
Page 246 Command Descriptions MEASUrement:IMMed:DATa? (Query Only) Returns the measurement result and qualifier for the immediate measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is taken on the source specified by a MEASUrement:IMMed:SOURCE command. Returns both the measurement result and the status of the result. Group Measurement Syntax...
Page 247 Command Descriptions MEASUrement:IMMed:DELay:DIREction Sets or returns the starting point and direction that determines the delay “to” edge when taking an immediate delay measurement. Use the MEASUre- ment:IMMed:SOURCE2 command to specify the delay “to” waveform. Group Measurement Syntax MEASUrement:IMMed:DELay:DIREction {BACKWards | FORWards} MEASUrement:IMMed:DELay:DIREction? Arguments BACKWards means that the search starts at the end of the waveform and looks for...
Page 248 Command Descriptions Arguments <x> specifies which waveform to use, where <x> = 1 is the “from” waveform, and <x> = 2 is the “to” waveform. FALL specifies the falling edge. RISe specifies the rising edge. Examples MEASUREMENT:IMMED:DELAY:EDGE1 RISE specifies that the “from” waveform rising edge be used for the immediate delay measurement.
Page 249 Command Descriptions MEASUrement:IMMed:TYPe Specifies the immediate measurement. Group Measurement Syntax MEASUrement:IMMed:TYPe { AMPlitude | AREa | BURst | CARea | CMEan | CRMs | DELAY | FALL | FREQuency | HIGH | LOW | MAXimum | MEAN | MINImum | NDUty | NOVershoot | NWIdth | PDUty | PERIod | PHASE | PK2pk | POVershoot | PWIdth | RISe | RMS } MEASUrement:IMMed:TYPe? Arguments...
Page 250 Command Descriptions NOVershoot is the negative overshoot, expressed as: (Low − Minimum) NOVershoot = 100 × Amplitude NWIdth is the distance (time) between MidRef (usually 50%) amplitude points of a negative pulse. PDUty is the ratio of the positive pulse width to the signal period expressed as a percentage.
Page 251 Command Descriptions MEASUrement:IMMed:UNIts? (Query Only) Returns the units for the immediate measurement. Group Measurement Syntax MEASUrement:IMMed:UNIts? Returns <QString> returns ”V” for volts, ”s” for seconds, ”Hz” for hertz, ”%” for percent, ”A” for amps, ”W” for watts, for ohms, ”dB” for decibels, ”?” for unknown, and ”...
Page 252 Command Descriptions MEASUrement:INDICators? (Query Only) Returns all measurement indicator parameters. Group Measurement Syntax MEASUrement:INDICators? Examples MEASUREMENT:INDICATORS? might return :MEASUREMENT:INDICATORS:STATE MEAS1;NUMHORZ 0;NUMVERT 4;HORZ1 7.5E0;HORZ2 -3.400000095367E0;HORZ3 0.0E0;HORZ4 0.0E0;VERT1 -6.351123E-6;VERT2 -3.179753E-6;VERT3 -6.40943E-6;VERT4 -6.403E-6 MEASUrement:INDICators:HORZ<x>? (Query Only) Returns the position of the specified horizontal measurement indicator <x>, where <x>...
Page 253 Command Descriptions MEASUrement:INDICators:NUMVERT? (Query Only) Returns the number of vertical measurement indicators currently being dis- played. Group Measurement Syntax MEASUrement:INDICators:NUMVERT? Examples MEASUREMENT:INDICATORS:NUMVERT? might return :MEASUREMENT:INDICATORS:NUMVERT 2 indicating that there are currently 2 vertical lines drawn on the graticule showing where the measurement specified by MEASUrement:INDICators:STATE is being performed.
Page 254 Command Descriptions MEASUrement:INDICators:VERT<x>? (Query Only) Returns the value of the specified vertical measurement indicator <x> from the trigger point, where <x> can be 1, 2, 3, or 4. A negative value means that the indicator is positioned earlier in the waveform record than the trigger point. Group Measurement Syntax...
Page 255 Command Descriptions Syntax MEASUrement:MEAS<x>:COUNt? Returns <NR3> Examples MEASUREMENT:MEAS1:COUNT? might return: :MEASU:MEAS1:COUN 3.247000000E+3 MEASUrement:MEAS<x>:DATa? (Query Only) Returns the measurement result and qualifier for the measurement specified by <x>. Returns both the measurement result and the status of the result. Group Measurement Syntax MEASUrement:MEAS<x>:DATa? <NR3>, <NR1>...
Page 256 Command Descriptions Examples MEASUREMENT:MEAS3:DELAY? might return :MEASUREMENT:MEAS3:DELAY:EDGE1 RISE; EDGE2 RISE;DIRECTION FORWARDS. MEASUrement:MEAS<x>:DELay:DIREction (Requires TDSAAM) Sets or returns the starting point and direction that determines the delay “to” edge when taking a delay measurement. The waveform is specified by MEASUrement:MEAS<X>:SOURCE2. This command is equivalent to setting the direction in the Delay Edges and Direction side menu items.
Page 257 Command Descriptions Syntax MEASUrement:MEAS<x>:DELay:EDGE1 { FALL | RISe } MEASUrement:MEAS<x>:DELay:EDGE1? Arguments FALL specifies the falling edge. RISe specifies the rising edge. Examples MEASUREMENT:MEAS3:DELAY:EDGE1 RISE specifies that the rising edge be used for measurement 3. MEASUREMENT:MEAS1:DELAY:EDGE1? returns either RISE or FALL for measurement 1. MEASUrement:MEAS<x>:DELay:EDGE2 Sets or returns the slope of the edge that is used for the delay “to”...
Page 258 Command Descriptions MEASUrement:MEAS<x>:MAXimum? (Query Only) (Requires TDSAAM) Returns the maximum value found for the specified measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<x>:MAXimum? Returns <NR3> Examples MEASUREMENT:MEAS1:MAXIMUM? might return: :MEASU:MEAS3:MAX 4.18E-9 MEASUrement:MEAS<x>:MEAN? (Query Only) (Requires TDSAAM) Returns the mean value accumulated for the specified measurement since the last statistical reset.
Page 259 Command Descriptions MEASUrement:MEAS<x>:MINImum? (Query Only) (Requires TDSAAM) Returns the minimum value found for the specified measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS<x>:MINImum? Returns <NR3> Examples MEASUREMENT:MEAS1:MIN? might return: :MEASU:MEAS1:MINI 1.75E-9 MEASUrement:MEAS<x>:SOURCE[1] Sets or returns the source for all single channel measurements. SOUrce is equivalent to SOURCE1.
Page 260 Command Descriptions MEASUrement:MEAS<x>:SOURCE2 Sets or returns the source to measure “to” when taking a delay measurement or phase measurement. This is equivalent to setting the source in the Delay from Selected Wfm side menu or the Phase from Selected Wfm side menu. Group Measurement Syntax...
Page 261 Command Descriptions Examples MEASUREMENT:MEAS1:STATE ON turns measurement defined as MEAS1 on. MEASUREMENT:MEAS4:STATE? returns either 0 or 1, indicating the state of MEAS4. MEASUrement:MEAS<x>:STDdev? (Query Only) (Requires TDSAAM) Returns the standard deviation of values accumulated for this measurement since the last statistical reset. Group Measurement Syntax...
Page 262 Command Descriptions AREa is the area between the curve and ground over the active waveform the high value minus the low value. TDS3AAM only. BURst is the time from the first MidRef crossing to the last MidRef crossing. CARea (cycle area) is the area between the curve and ground over one cycle. TDS3AAM only.
Page 263 Command Descriptions PK2pk is the absolute difference between the maximum and minimum amplitude. It can be used with both general purpose and histogram measurements. POVershoot is the positive overshoot, expressed as: (Maximum − High) POVershoot = 100 × Amplitude PWIdth is the distance (time) between MidRef (usually 50%) amplitude points of a positive pulse.
Page 264 Command Descriptions MEASUrement:MEAS<x>:VALue? (Query Only) Returns the value that has been calculated for the measurement specified by <x>. NOTE. This value is a display value and is updated on the oscilloscope screen approximately every 1/3 second. Group Measurement Syntax MEASUrement:MEAS<x>:VALue? Examples MEASUREMENT:MEAS1:VALUE? might return MEASUREMENT:MEAS1:VALUE 3.742E-6, indicating the measure-...
Page 265 Command Descriptions Examples MEASUREMENT:METHOD HISTOGRAM specifies that the high and low reference levels are set statistically. MEASUREMENT:METHOD? returns :MEASUREMENT:METHOD MINMAX when the reference levels are set to MIN and MAX. MEASUrement:REFLevel? (Query Only) Returns the reference level method and the reference levels in absolute and percent terms.
Page 266 Command Descriptions MEASUrement:REFLevel:ABSolute:LOW Sets or returns the low reference level, and is the 0% reference level when MEASUrement:REFLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the MEASURE menu. Group Measurement Syntax MEASUrement:REFLevel:ABSolute:LOW <NR3> MEASUrement:REFLevel:ABSolute:LOW? Arguments <NR3>...
Page 267 Command Descriptions MEASUrement:REFLevel:ABSolute:MID2 Sets or returns the mid2 reference level for the “to” waveform when taking a delay measurement, and is the 50% reference level when MEASUrement:RE- FLevel:METHod is set to ABSolute. This command is equivalent to setting the Reference Levels in the MEASURE menu. Group Measurement Syntax...
Page 268 Command Descriptions Examples MEASUREMENT:REFLEVEL:METHOD ABSOLUTE specifies that explicit user-defined values are used for the reference levels. MEASUREMENT:REFLEVEL:METHOD? returns either ABSolute or PERCENT, indicating the reference levels used. MEASUrement:REFLevel:PERCent:HIGH Sets or returns the percent, where 100% is equal to HIGH, that is used to calculate the high reference level when MEASUrement:REFLevel:METHod is set to PERCent.
Page 269 Command Descriptions Examples MEASUREMENT:REFLEVEL:PERCENT:LOW? might return :MEASUREMENT:REFLEVEL:PERCENT:LOW 1.5E1, meaning that the low reference level is 15% of HIGH. MEASUrement:REFLevel:PERCent:MID Sets or returns the percent, where 100% is equal to HIGH, that is used to calculate the mid reference level when MEASUrement:REFLevel:METHod is set to PERCent.
Page 270 Command Descriptions Examples MEASUREMENT:REFLEVEL:PERCENT:MID2 40 specifies that the mid reference level is set to 40% of HIGH. MEASUrement:SNAPShot (Set Only) Displays the measurement snapshot list on the oscilloscope screen, which is a list of the immediate values of all available measurements for the active signal. Group Measurement Syntax...
Page 271 Command Descriptions MEASUrement:STATIstics:WEIghting (Requires TDSAAM) Controls the responsiveness of mean and standard deviation to waveform changes. Group Measurement Syntax MEASUrement:STATIstics:WEIghting <NR1> MEASUrement:STATIstics:WEIghting? Arguments <NR1> is the time constant for the mean and standard deviation statistical accumulations. Examples MEASUREMENT:STATISTICS:WEIGHTING 4 sets the weighting to 4. MESSage:BOX Defines the size and position of the message window.
Page 272 Command Descriptions MESSage:CLEAR Removes the message text from the message window. Group Display Syntax MESSage:CLEAR Examples MESSAGE:CLEAR removes the message from the message box. MESSage:SHOW Clears the contents of the message window and displays the new message in the window. Group Display Syntax...
Page 273 Command Descriptions You can send a tab by transmitting a tab character (\t or \x09) followed by two characters representing the most significant eight bits followed by the least significant eight bits of a 16-bit number. The number specifies the pixel column relative to the left margin of the message area.
Page 274 Command Descriptions H Index 10 Tek Blue H Index 11 Bright Blue H Index 12 undefined H Index 13 Blue H Index 14 undefined H Index 15 Dark Blue H Bit 4 If set, the foreground color is set to the default foreground color.
Page 275 Command Descriptions An alternate way to enter certain characters is with a backslash followed by a single character (following “standard” Unix) as follows: newline (carriage return and linefeed) backslash (\\ is required to get a backslash character) Japanese character encoding, the next two characters make one hexadecimal JIS value as explained later horizontal tab;...
Page 276 \u8017\n\n\033*\205\n\033%\206’ displays the message as shown below. “Color” and “A few examples follow” are displayed in green, yellow, cyan, red, and magenta respectively; Tek and Tektronix are also in Tektronix’ colors. 2- 238 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 277 Command Descriptions MESSage:STATE Controls the display of the message window. Group Display Syntax MESSage:STATE { OFF | ON | <NR1> } MESSage:STATE? Arguments <OFF> or <NR1> = 0 removes the message window from the display. <ON> or <NR1> ¸ 0 displays the message window and its contents on the display. Related Commands MESSage:BOX, MESSage:SHOW NEWpass (No Query Form)
Page 278: Table 2- -39: Commands That Generate An Operation Complete Message 2
Command Descriptions *OPC Generates the operation complete message in the Standard Event Status Register (SESR) when all pending operations finish. The *OPC? query places the ASCII character “1” into the output queue when all pending operations are finished. The *OPC? response is not available to read until all pending operations finish. For a complete discussion of the use of these registers and the output queue, see page 3- -1.
Page 279 Command Descriptions PASSWord (No Query Form) Enables the *PUD and NEWpass set commands. Sending PASSWord without any arguments disables these same commands. Once the password is successful- ly entered, the *PUD and NEWpass commands are enabled until the oscilloscope is powered off, or until the FACtory command, the PASSWord command with no arguments, or the *RST command is issued.
Page 280 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.
Page 281 Command Descriptions Arguments <NR1> = 0 indicates the oscilloscope is being powered by battery. <NR1> = 1 indicates the oscilloscope is being powered by AC. Examples POWER:AC:PRESENT? might return :POWER:AC:PRESENT 1. Related Commands POWer:BATTery:PRESENt? POWer:BACKLight Sets or returns the idle time that must elapse before the backlight is turned off. When the oscilloscope is running on AC power, idle time is ignored.
Page 282 Command Descriptions Arguments <NR1> is a value with a range from 0 to 15 that indicates the remaining charge in the battery; 0 means the battery is fully discharged and 15 means the battery is fully charged Examples POWER:BATTERY:GASGAUGE? might return :POWER:BATTERY:GASGAUGE 15. Related Commands POWer:BATTERY:PRESENT? POWer:BATTery:PRESENt? (Query Only)
Page 283 Command Descriptions Arguments <NR1> = the number of minutes of idle time before the oscilloscope is powered off. 999999999 is used for infinity, but any value greater than 15 (max timeout) will be rounded to infinity. INFinite disables the timer meaning the oscilloscope will not power off automatically.
Page 284 Command Descriptions REBOOT (No Query Form) Reboots (restarts) the oscilloscope firmware. This is the equivalent of power cycling the oscilloscope. Group Miscellaneous Syntax REBOOT *RCL (No Query Form) Restores the state of the oscilloscope from a copy of its settings stored in memory.
Page 285 Command Descriptions Arguments <QString> is the path and file name, enclosed in quotes, of the mask file to load from the disk or flash drive into the User mask. Examples RECAll:MASK ”fd0:\custome2.msk” loads the file custome2.msk from the floppy drive into the User mask. Related Commands SAVe:MASK <QString>...
Page 286 Command Descriptions Examples RECALL:SETUP FACTORY recalls (and makes current) the front panel setup to the factory defaults. RECALL:SETUP 1 recalls the front panel setup from setup1. RECALL:SETUP “TEK00000.SET” recalls the front panel setup from the file TEK00000.SET in the current directory. Related Commands DELEte:SETUp, FACtory, *RCL, *RST, *SAV, SAVe:SETUp RECAll:WAVEform (No Query Form)
Page 287 Command Descriptions REF<x>:DATE? (Query Only) Returns reference waveform save date. Saving a waveform to a reference waveform will create a new save date. Group Waveform Syntax REF<x>:DATE? Examples REF4:DATE? might return “09-10-99” in the form mm-dd-yy. REF<x>:HORizontal:POSition Sets reference waveform horizontal display position from 0.0 to 100.0. The horizontal display position for a reference waveform is the same for zoom on and off.
Page 288 Command Descriptions Syntax REF<x>:HORizontal:SCAle <NR3> REF<x>:HORizontal:SCAle? Arguments <NR3> is the time per division. The range is from acquired time/div to (acquired time/div/200) for 10,000 point reference waveforms, and to (acquired time/ div/10) for 500 point reference waveforms. Examples REF1:HORIZONTAL:SCALE? might return REF1:HORIZONTAL:SCALE 4.0E-4 REF<x>:LABEL Sets or returns the specified reference waveform label.
Page 289 Command Descriptions REF<x>:VERTical:POSition Sets the reference waveform vertical display position in vertical divisions; equivalent to adjusting the Vertical POSITION knob when REF<x> is the selected waveform. Group Waveform Syntax REF<x>:VERTical:POSition <NR3> REF<x>:VERTical:POSition? Arguments <NR3> is the reference waveform’s display vertical position. Examples REF2:VERTICAL:POSITION 1.0 sets the vertical position for the Ref2 waveform to +1 division.
Page 290 Command Descriptions REM (No Query Form) Specifies a comment. This line is ignored by the instrument. Group Miscellaneous Syntax REM <QString> Arguments <QString> is a string that can have a maximum of 255 characters. Examples REM ”This is a comment” is ignored by the instrument.
Page 291 Command Descriptions RS232? (Query Only) Returns the RS232 settings. Group RS232 Syntax RS232? Arguments None Examples RS232? might return: :RS232:BAUD 38400;TRANSMIT:TERMINATOR LF;HARDFLAGGING: RS232:BAUd Sets or returns RS-232 interface transmission speed. Group RS232 Syntax RS232:BAUd <NR1> RS232:BAUd? Arguments <NR1> is a rate of 1200, 2400, 4800, 9600, 19200, or 38400 baud. Examples RS232:BAUD 9600 sets the transmission rate to 9600 baud.
Page 292 Command Descriptions RS232:HARDFlagging Sets or returns the input and output hard flagging over the RS-232 port. It uses the RTS (Request To Send) and CTS (Clear To Send) lines to control data transmission. On output, the oscilloscope transmits data only when CTS is asserted.
Page 293 Command Descriptions Related Commands RS232?, RS232: BAUd, RS232: HARDFlagging RS232:TRANsmit:TERMinator Sets or returns 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 294 Command Descriptions *SAV (Set Only) (Save) stores the state of the oscilloscope into a specified internal setup location. You can later use the *RCL command to restore the oscilloscope to this saved state. This is equivalent to selecting the Save Current Setup menu item in the SAVE/RECALL menu.
Page 295 Command Descriptions SAVe:SETUp (Set Only) Saves the current front-panel setup into the specified internal setup location or file. This is equivalent to selecting the Save Current Setup menu item in the SAVE/RECALL menu. Group Save and Recall Syntax SAVe:SETUp { <NR1> | <file path> } Arguments <NR1>...
Page 296 Command Descriptions Arguments <wfm> is CH<x>, MATH<x>, or REF<x>, and is the waveform that will be saved. REF<x> is the location where the waveform will be stored. <file path> is a quoted string that defines the file name and path. Input the file path using the form <drive>/<dir>/<filename>.
Page 297 Command Descriptions SPREADSheet specifies the spreadsheet format. Spreadsheet format files should have a .CSV extension. Each waveform data point consists of two floating point values, an X (typically time) value and a Y (typically amplitude) value. Each XY pair is separated by carriage return (0x0D) and line feed (0x0A) characters. Each value except the last one in the file is followed by a comma (0x2C).
Page 298 Command Descriptions SELect:CONTROl Sets or queries the waveform that is currently affected by the cursor and vertical commands. Group Vertical Syntax SELect:CONTROl <wfm> SELect:CONTROl? Arguments <wfm> is CH<x>, MATH<x>, or REF<x>, and will be the selected waveform. Returns NONE if all waveforms are off. NONE is ignored on input. CH<x>, MATH<x>, or REF<x>...
Page 299 Command Descriptions Examples SELECT:CH2 ON turns the channel 2 display on and selects channel 2. SELECT:REF1? might return REF1 1 indicating that the REF1 waveform is being displayed. SET? (Query Only) Returns a string listing the oscilloscope settings, except for configuration information for the calibration values.
Page 300 Command Descriptions SETUp<x>:DATE? (Query Only) Sets or returns the date when the specified instrument setup was saved. Group Waveform Syntax SETUp<x>:DATE? Examples SETUP4:DATE? might return SETUP4:DATE ”04-18-01”. SETUp<x>:LABEL Sets or returns the specified instrument setup label. See the MESSage:SHOW command for information on how to enter non-English characters. Group Waveform Syntax...
Page 301 Command Descriptions *SRE (Service Request Enable) sets and queries the bits in the Service Request Enable Register (SRER). For a complete discussion of the use of these registers, see page 3- -1. Group Status and Error Syntax *SRE <NR1> *SRE? Arguments <NR1>...
Page 302 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 SYStem Sets or returns the UTILITY menu’s System menu setting. This command does not display the System menu when executed.
Page 303 Command Descriptions TIMe Sets or queries the current time Group Miscellaneous Syntax TIMe <QString> TIMe? Arguments <QString> is a time in the form “hh:mm:ss”. hh refers to the hour number from 01 to 24. mm refers to the minute number from 00 to 59. ss refers to the seconds number from 00 to 59.
Page 304 Command Descriptions Examples TRIGGER FORCe forces a trigger event to occur. TRIGGER? might return :TRIGGER:A:MODE AUTO;TYPE EDGE;HOLDOFF:VALUE 2.508E-7;:TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE;:TRIGGER:A:VIDEO:STANDARD NTSC;SOURCE CH1;FIELD ALLLINES;:TRIGGER:A:LEVEL 2.6E-1;:TRIGGER:B:STATE 0;BY TIME;EVENTS:COUNT 1;:TRIGGER:B:TIME 1.32E-8;TYPE EDGE;LEVEL 0.0E0;EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE TRIGger:A? (Query Only) Returns the current A trigger parameters. Group Trigger Syntax...
Page 305 TDS3000 Series instruments. EXT10 sets the trigger source to the reduced external trigger with a signal input range of - -8 V to +8 V. EXT10 is not available in 4-channel TDS3000 Series instruments. LINE sets the trigger source to the AC line frequency.
Page 306 Command Descriptions Examples TRIGger:A:COMMunication:STANdard E2 sets the A trigger parameters to those required to test E2 waveforms. Related Commands TRIGger:MAIn:COMMunication:STANdard TRIGger:A:EDGe? (Query Only) Returns the trigger coupling, source, and slope for the A edge trigger. Group Trigger Syntax TRIGger:A:EDGe? Examples TRIGGER:A:EDGE? might return :TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC;SLOPE RISE TRIGger:A:EDGe:COUPling...
Page 307 TDS3000 Series instruments. EXT10 sets the trigger source to the reduced external trigger with a signal input range of - -8 V to +8 V. EXT10 is not available in 4 channel TDS3000 Series instruments. VERTical sets the trigger source to the lowest numbered displayed channel.
Page 308 Command Descriptions LINE sets the trigger source to the AC line frequency. NOTE. LINE is not available when the instrument is operating on battery power. ALTernating sets the trigger source to alternate between each displayed input channel. Examples TRIGGER:A:EDGE:SOURCE LINE specifies the AC line voltage as the A edge trigger source.
Page 309 Command Descriptions TRIGger:A:HOLdoff:VALue Sets or queries the A trigger holdoff time as a percent of record. This is equivalent to setting Holdoff (% of record) in the Mode & Holdoff side menu. Group Trigger Syntax TRIGger:A:HOLdoff:VALue <NR3> TRIGger:A:HOLdoff:VALue? Arguments <NR3> from 0 to 100 and is a percent of the holdoff range. Examples TRIGGER:A:HOLDOFF:VALUE 50 to set the holdoff value to 50% of record.
Page 310 Command Descriptions TRIGger:A:LOGIc? (Query Only) Returns the current logic trigger parameters. Group Trigger Syntax TRIGger:A:LOGIc? Examples TRIGGER:A:LOGIC? might return :TRIGGER:A:LOGIC:INPUT1:SOURCE CH1;LOGICLEVEL LOW;SLOPE RISE;THRESHOLD 1.4000000000;:TRIGGER:A:LOGIC:CLASS PATTERN;PATTERN:FUNCTION AND;DELTATIME 0.0000003168;WHEN TRUE;:TRIGGER:A:LOGIC:STATE:WHEN TRUE TRIGger:A:LOGIc:CLAss Sets or returns the logic trigger class value. This command is equivalent to selecting Class in the Trigger menu when the Type is set to Logic.
Page 311 Command Descriptions Syntax TRIGger:A:LOGIc:INPUT<x>:LOGICLevel { HIGH | LOW } TRIGger:A:LOGIc:INPUT<x>:LOGICLevel? Arguments <x> sets the logic trigger input source. Valid values are 1 and 2 HIGH sets the input logic level to high. Defining a signal as high-true means that signal levels above (more positive than) the threshold level are true, and signal levels below (more negative than) the threshold level are false.
Page 312 CH<x> sets the oscilloscope logic trigger input signal source to the specified channel, where <x> is 1, 2, 3, or 4. EXT, EXT10 sets the external trigger channel to the specified input. EXT and EXT10 are not available in TDS3000 Series 4-channel instruments. Examples TRIGGER:A:LOGIC:INPUT1:SOURCE EXT sets the logic input 1 source to the external trigger input.
Page 313 Command Descriptions <NR3> is a floating point value with exponent that sets the threshold voltage value for the specified logic trigger input. ECL sets the threshold voltage value of the specified input to - -1.3 V. TTL sets the threshold voltage value of the specified input to 1.4 V. Examples TRIGGER:A:LOGIC:INPUT2:THRESHOLD -1.5E0 sets the threshold voltage of input 2 to - -1.5 V.
Page 314 Command Descriptions Syntax TRIGger:A:LOGIc:PATtern:FUNCtion { AND | NANd | NOR | OR } TRIGger:A:LOGIc:PATtern:FUNCtion? Arguments AND, NANd, NOR, OR set the Boolean logic operation to apply to the logic pattern trigger inputs. Examples TRIGGER:A:LOGIC:PATTERN:FUNCTION NAND sets the pattern trigger logic function to NAND. TRIGger:A:LOGIc:PATtern:WHEn Sets or returns the pattern logic condition on which to trigger the oscilloscope.
Page 315 Command Descriptions Examples TRIGGER:A:LOGIC:PATTERN:WHEN LESSTHAN sets the oscilloscope to trigger when the pattern is true for a time period less than the pattern trigger delta time setting. TRIGger:A:LOGIc:STATE:WHEn Sets or returns the state condition on which to trigger the oscilloscope. Group Trigger Syntax...
Page 316 Command Descriptions TRIGger:A:PULse? (Query Only) Returns the pulse trigger parameters. Group Trigger Syntax TRIGger:A:PULse? Examples TRIGGER:A:PULSE? might return TRIGGER:A:PULSE:CLASS WIDTH;SOURCE CH3;POLARITY EITHER;WIDTH:WHEN MORETHAN;WIDTH 0.0000011880;:TRIG- GER:A:PULSE:RUNT:THRESHOLD:HIGH 0.8000000000;LOW 2.0000000000;:TRIGGER:A:PULSE:RUNT:WHEN LESSTHAN;WIDTH 0.0000011880;:TRIGGER:A:PULSE:SLEWRATE:DELTATIME 0.0000011880;THRESHOLD:HIGH 0.8000000000;LOW 2.0000000000; :TRIGGER:A:PULSE:SLEWRATE:WHEN FASTERTHAN. TRIGger:A:PULse:CLAss Sets or returns the pulse trigger class value. This command is equivalent to selecting Class in the Trigger menu when the trigger Type is set to Pulse.
Page 317 Command Descriptions TRIGger:A:PULse:RUNT? (Query Only) Returns the runt pulse trigger settings. Group Trigger Syntax TRIGger:A:PULse:RUNT? Examples TRIGGER:A:PULSE:RUNT? might return :TRIGGER:A:PULSE:RUNT:THRESHOLD:HIGH 2.8000000000;LOW 0.7000000000;:TRIGGER:A:PULSE:RUNT:WHEN LESSTHAN;WIDTH 0.0000011880. TRIGger:A:PULse:RUNT:POLarity Sets or returns the runt-pulse logic trigger signal polarity value. Group Trigger Syntax TRIGger:A:RUNT:PULse:POLarity { EITher | POSITIVe | NEGAtive } TRIGger:A:RUNT:PULse:POLarity? Arguments EITher sets the oscilloscope to trigger on either POSITIVe or NEGAtive polarity...
Page 318 Command Descriptions Examples TRIGGER:A:PULSE:RUNT:THRESHOLD? might return :TRIGGER:A:PULSE:RUNT:THRESHOLD:HIGH 2.00E+0;LOW 800.0E-3. TRIGger:A:PULse:RUNT:THReshold:BOTh Sets the value of both runt pulse signal thresholds. This command is equivalent to setting Set to TTL or Set to ECL in the Runt Trigger menu’s Thresholds side menu item. Group Trigger Syntax...
Page 319 Command Descriptions TRIGger:A:PULse:RUNT:THReshold:LOW Sets or returns the runt pulse signal low threshold voltage value. This command is equivalent to setting the threshold in the runt pulse Thresholds side menu. Group Trigger Syntax TRIGger:A:PULse:RUNT:THReshold:LOW <NR3> TRIGger:A:PULse:RUNT:THReshold:LOW? Arguments <NR3> is a floating point value with exponent that sets the runt pulse low threshold voltage value.
Page 320 Command Descriptions NOTEQual triggers the oscilloscope when the runt pulse width is true for a time period greater than or less than (not equal to) the time period specified in TRIGger:A:PULse:RUNT:WIDth, within a ±5% tolerance. Examples TRIGGER:A:PULSE:RUNT:WHEN MORETHAN sets the runt trigger to occur when the oscilloscope detects a runt pulse wider than the specified width.
Page 321 Command Descriptions TRIGger:A:PULse:SLEWRate:DELTATime Sets or returns the time component of the slew rate value. The oscilloscope uses the delta time value and the threshold voltage values to calculate the target slew rate ((high threshold voltage - - low threshold voltage) ÷ delta time). Group Trigger Syntax...
Page 322 Command Descriptions NEGAtive sets the oscilloscope to trigger only on negative-polarity slew rate signals. Examples TRIGGER:A:PULSE:SLEWRate:POLARITY NEGATIVE specifies that the oscilloscope only trigger on negative-polarity pulses or slew rates. TRIGger:A:PULse:SLEWRate:SLEWRate Sets or returns the slew rate value in volts per second. Group Trigger Syntax...
Page 323 Command Descriptions TRIGger:A:PULse:SLEWRate:THReshold:HIGH Sets or returns the slew rate source signal high threshold voltage value. Group Trigger Syntax TRIGger:A:PULse:SLEWRate:THReshold:HIGH <NR3> TRIGger:A:PULse:SLEWRate:THReshold:HIGH? Arguments <NR3> is a floating point value with exponent that sets the slew rate trigger signal high threshold voltage value. Examples TRIGGER:A:PULSE:SLEWRATE:THRESHOLD:HIGH 4.1E0 sets the slew rate high threshold voltage value to 4.1 volts.
Page 324 Command Descriptions TRIGger:A:PULse:SLEWRate:WHEn Sets or returns the slew rate condition on which to trigger the oscilloscope.The condition is based on the slew rate calculated from the values set by the TRIGger:A:PULse:SLEWRate:DELTATime and TRIGger:A:PULse:SLEW- Rate:THReshold commands. Group Trigger Syntax TRIGger:A:PULse:SLEWRate:WHEn { FASTERThan | SLOWERthan | EQual | NOTEQual } TRIGger:A:PULse:SLEWRate:WHEn? Arguments...
Page 325 EXT sets the pulse trigger source to the regular external trigger input connector with a signal input range of - -0.8 V to +0.8 V. EXT is not available in four-chan- nel TDS3000 Series instruments. EXT10 sets the pulse trigger source to the reduced external trigger with a signal input range of - -8 V to +8 V.
Page 326 Command Descriptions Examples TRIGGER:A:PULSE:WIDTH:POLARITY NEGATIVE specifies that the oscilloscope only trigger on negative-polarity pulse signals. TRIGger:A:PULse:WIDth:WHEn Sets or returns the pulse width condition on which to trigger the oscilloscope. This is equivalent to selecting the condition in the Pulse Width Trigger When side menu.
Page 327 Command Descriptions Arguments <NR3> is a floating point value with exponent that sets the pulse width trigger time value. This argument has a range of 39.6E- -9 (39.6 ns) to 10.0E0 (10 s), in increments of 13.2 ns. Values that are not an increment of 13.2 ns are rounded to the nearest correct value.
Page 328 (edge triggering). LOGIc sets the oscilloscope to trigger when when the logic condition on two channels is true. (TDS3000 Series with TDS3TRG, TDS3000B Series, TDS3000C Series.) PULse sets the oscilloscope to trigger when a signal meets a specified pulse width condition.
Page 329 Command Descriptions TRIGger:A:VIDeo:CUSTom:FORMat? Arguments INTERLAced specifies that the video signal is interlaced. PROGressive specifies that the video signal is progressive. Examples TRIGGER:A:VIDEO:CUSTOM:FORMAT? might return TRIGGER:A:VIDEO:CUSTOM:FORMAT INTERLACED. TRIGger:A:VIDeo:CUSTom:SCAN (Requires TDS3VID or TDS3SDI) Sets or queries the custom video signal scan rate on which to trigger. Group Trigger Syntax...
Page 330: Table 2- -40: Hdtv Formats 2
Command Descriptions Syntax TRIGger:A:VIDeo:FIELD { ODD | EVEN | ALLFields | ALLLines | FIELD1 | FIELD2 | NUMERic } TRIGger:A:VIDeo:FIELD? Arguments ODD specifies to trigger on interlaced video odd fields. EVEN specifies to trigger on interlaced video even fields. ALLFields specifies to trigger on the interlaced video odd fields. ALLLines specifies all video lines.
Page 331 Command Descriptions Table 2- 40: HDTV formats (cont.) HDTV format Description 1080P25 1125 lines (1080 active), 1920 x 1080 pixel, progressive, 25 fps 1080SF24 1125 Lines (1080 active), 1920 x 1080 pixel, progressive (sF), 24 fps 720P60 750 lines (720 active), 1280 x 720 pixel, progressive, 60 fps 480P60 525 lines (480 active), 640 or 704 x 480 pixel, progressive, 60 fps...
Page 332: Table 2- -41: Video Trigger Line Range Values 2
Command Descriptions Syntax TRIGger:A:VIDeo:LINE <NR1> TRIGger:A:VIDeo:LINE? Arguments <NR1> is an integer number that sets the video line number on which to trigger. The following table lists the valid choices depending on the active video standard: Table 2- 41: Video trigger line range values Video standard Valid line range...
Page 333 EXT sets the video trigger source to the regular external trigger input connector with a signal input range of - -0.8 V to +0.8 V. EXT is not available in 4 channel TDS3000 Series instruments. EXT10 sets the video trigger source to the reduced external trigger with a signal input range of - -8 V to +8 V.
Page 334 Command Descriptions LINE sets the video trigger source to the AC line frequency. NOTE. LINE is not available when the instrument is operating on battery power. ALTernating sets the video trigger source to sequentially trigger on each displayed input channel. Examples TRIGGER:A:VIDEO:SOURCE CH1 selects channel 1 as the source for the A video trigger.
Page 335 Command Descriptions TRIGger:A:VIDeo:SYStem This command is the same as TRIGger:A:VIDeo:STANdard, and is for compatibility with other Tektronix instruments. TRIGger:B Sets or returns the current B trigger parameters. Group Trigger Syntax TRIGger:B SETLevel TRIGger:B? Arguments SETLevel sets the B trigger voltage level to 50% of the source peak-to-peak signal.
Page 336 Command Descriptions TRIGger:B:EDGe? (Query Only) Returns the trigger coupling, source, and slope for the B edge trigger. Group Trigger Syntax TRIGger:B:EDGe? Examples TRIGGER:B:EDGE? might return SOURCE CH1;COUPLING DC;SLOPE RISE TRIGger:B:EDGe:COUPling Sets or queries the type of coupling for the B edge trigger. This is equivalent to setting Coupling in the Trigger menu.
Page 337 - -0.8 V to +0.8 V. EXT is not available in 4-channel TDS3000 Series instruments. EXT10 sets the B trigger source to the reduced external trigger with a signal input range of - -8 V to +8 V. EXT10 is not available in 4-channel TDS3000 Series instruments. 2- 299...
Page 338 Command Descriptions Examples TRIGGER:B:EDGE:SOURCE LINE specifies the AC line voltage as the B edge trigger source. TRIGGER:B:EDGE:SOURCE? might return CH2 for the B edge trigger source. TRIGger:B:EVENTS? (Query Only) Returns the current delayed trigger event parameter. Group Trigger Syntax TRIGger:B:EVENTS? <NR1> Examples TRIGGER:B:EVENTS? might return 14 indicating the B trigger occurs on the 14th occurance of a...
Page 339 Command Descriptions TRIGger:B:LEVel Sets the B trigger level. This command is equivalent to adjusting the front-panel TRIGGER LEVEL knob when the B trigger state is on. Group Trigger Syntax TRIGger:B:LEVel { ECL | TTL | <NR3> } TRIGger:B:LEVel? Arguments ECL specifies a preset ECL level of - -1.3 V. TTL specifies a preset TTL level of 1.4 V.
Page 340 Command Descriptions TRIGger:B:STATE Sets the B trigger level state to on or off. Group Trigger Syntax TRIGger:B:STATE { <NR1> | ON | OFF } Arguments <NR1> 0 = off and 1 = on. Examples TRIGGER:B:STATE 0 sets B trigger state to off. TRIGGER:B:STATE? might return :TRIGGER:B:STATE 0 TRIGger:B:TIMe...
Page 341: Table 2- -42: Trigger:delay Commands 2
:TRIGGER:B:TYPE EDGE indicating that the B trigger type is a edge trigger. TRIGger:DELay Commands The TRIGger:DELay commands listed in Table 2- -42 have the same function and syntax as the equivalent TRIGger:B commands, and are for compatibility with other Tektronix instruments. Table 2- 42: TRIGger:DELay commands TRIGger:DELay TRIGger:DELay:BY TRIGger:DELay:EDGE:COUPling...
Page 342 Command Descriptions Arguments <NR1> is the gain factor of the probe. TDS3014B/C, TDS3024B, TDS3034B/C, TDS3044B, TDS3054B/C, TDS3064B only, these oscilloscopes do not automatically detect the probe factor of a probe connected to the external trigger connector. Examples TRIGGER:EXTERNAL:PROBE? might return TRIGGER:EXTERNAL:PROBE 1.0E1 for a 10x probe. TRIGger:EXTERnal:YUNit (TDS3014B/C, TDS3034B/C, TDS3054B/C Only) Sets or returns the external trigger vertical (Y) units value.
Page 343: Table 2- -43: Trigger:main Commands 2
Command Descriptions TRIGger:MAIn Commands The TRIGger:MAIn commands listed in Table 2- -43 have the same syntax and function as the equivalent TRIGger:A commands, and are for compatibility with other Tektronix instruments. Table 2- 43: TRIGger:MAIn commands TRIGger:MAIn TRIGger:MAIn:COMMunication:SOUrce TRIGger:MAIn:COMMunication:STANdard TRIGger:MAIn:EDGe:COUPling...
Page 344 Command Descriptions TRIGger:STATE? (Query Only) Returns the current state of the triggering system. Group Trigger Syntax TRIGger:STATE? Returns AUTO indicates that the oscilloscope is in auto mode and acquires data even in the absence of a trigger. ARMED indicates that the oscilloscope is acquiring pretrigger information. All triggers are ignored when TRIGger:STATE is ARMed.
Page 345 Command Descriptions *TRG (Set Only) (Trigger) executes commands that are defined by *DDT. The Group Execute Trigger (GET) interface message has the same effect as the *TRG command. Group Miscellaneous Syntax *TRG Examples *TRG immediately executes all commands that have been defined by *DDT. Related Commands Alias commands, *DDT *TST? (Query Only)
Page 346 Command Descriptions 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. For more information see the ANSI-IEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions.
Page 347 Command Descriptions Examples VERBOSE ON sets the Verbose State true. VERBOSE? might return the value 1, showing that the Verbose State is true. Related Commands HEADer, *LRN?, SET? *WAI (Set Only) (Wait) Prevents the oscilloscope from executing further commands or queries until all pending operations finish.
Page 348 Command Descriptions WAVEAlert:BEEP (TDS3000B Series and TDS3000C Series) The beep sounds when a new waveform data varies significantly from the accumulated (DPO) display of previous waveforms. Group Acquisition Syntax WAVEAlert:BEEP { OFF | ON | <NR1> } WAVEAlert:BEEP? Arguments OFF or <NR1> = 0 turns off the beep when a new waveform is significantly different.
Page 349 Command Descriptions ON or <NR1> ¸ 0 turns on the hardcopy operation for the waveform when a new Arguments waveform is significantly different. OFF or <NR1> = 0 turns off the hardcopy operation. Examples WAVEALERT:HARDCOPY ON specifies that the hardcopy operation occurs when a new waveform data varies significantly from previous waveforms.
Page 350 Command Descriptions WAVEAlert:SENSitivity (TDS3000B Series and TDS3000C Series) Sets or returns the WaveAlert anomaly detection sensitivity parameter. Group Acquisition Syntax WAVEAlert:SENSitivity { <NR1> } WAVEAlert:SENSitivity? Arguments <NR1> sets the anomaly sensitivity percentage value, and ranges from 1 to 100. Examples WAVEALERT:SENSITIVITY? might return WAVEALERT:SENSITIVITY 6.0E1, indicating that sensitivity is set to 60%.
Page 351 Command Descriptions WAVEAlert:STOPOnviolation (TDS3000B Series and TDS3000C Series) Sets or returns the WaveAlert stop on violation setting. When enabled, this command stops waveform acquisitions on the first occurance of a WaveAlert waveform anomaly. Group Acquisition Syntax WAVEAlert:STOPOnviolation { OFF | ON } WAVEAlert:STOPOnviolation? Arguments OFF or 0 turns off the stop on violation mode.
Page 352 Command Descriptions WFMPre? (Query Only) Returns waveform transmission and formatting parameters for the waveform specified by the DATa:SOUrce command. If the waveform specified by the DATa:SOUrce command is not displayed, the oscilloscope returns only the waveform transmission parameters (BYT_Nr, BIT_Nr, ENCdg, BN_Fmt, BYT_Or) Group Waveform Syntax...
Page 353 Command Descriptions Arguments 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:BYT_Nr WFMPre:BN_Fmt Sets or queries the format of binary data for the waveform to be transferred.
Page 354 Command Descriptions 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 WFMPre:BYT_Nr <NR1> WFMPre:BYT_Nr? Arguments <NR1> is an integer in the range of 1 to 2 that sets the number of bytes per point. Examples WFMPRE:BYT_NR 2 specifies that there are 2 bytes per waveform data point.
Page 355 Command Descriptions Examples WFMPRE:BYT_OR MSB specifies that the most significant byte in the waveform data is transferred first. WFMPRE:BYT_OR? returns either MSB or LSB depending on which data byte is transferred first. Related Commands DATa:ENCdg, WFMPre:BN_Fmt, WFMPre:ENCdg WFMPre:ENCdg Sets or queries the type of encoding for waveform data transferred with the CURVe command.
Page 356 Command Descriptions WFMPre:NR_Pt The set form of this command sets the record length of the reference waveform specified by DATA:DESTination. Allowable record lengths are 500 and 10000. The query form of this command returns the number of points that will be returned by the next CURVe query.
Page 357 The set form of this command is ignored. The query form always returns a 0, if the waveform specified by DATA:SOUrce is on or displayed. If the waveform is not displayed, the query form generates an error and returns event code 2244. This command is listed for compatibility with other Tektronix oscilloscopes. Group Waveform...
Page 358 Command Descriptions WFMPre:WFId? (Query Only) Returns a descriptive string from the waveform specified in the DATa:SOUrce command, if that waveform is on or displayed. If that waveform is not on or displayed, the query fails and the oscilloscope generates an execution error with event code 2244 (waveform requested is not on).
Page 359 Command Descriptions Syntax WFMPre:XINcr <NR3> WFMPre:XINcr? Arguments <NR3> is the sampling interval in seconds per point. or Hertz Related Commands WFMPre:<wfm>:XINcr WFMPre:XUNit The set form of this command is only valid for reference waveforms. The only valid units are “s” and “Hz”. If an attempt is made to set the XUNit to something other than “s”...
Page 360 Command Descriptions 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 com- mand. The query form returns the position of the first sample of the waveform specified by the DATa:SOUrce command, if that waveform is on or displayed.
Page 361 Command Descriptions Syntax WFMPre:YMUlt <NR3> WFMPre:YMUlt? Arguments <NR3> is the vertical scale factor, in YUNits (usually volts) per data point level. Related Commands WFMPre:YUNit WFMPre:YOFf YOFf specifies the vertical position of a waveform. YOFf is a value, expressed in waveform data point levels, used to convert waveform record values to YUNit values using the following formula (where dl is data levels;...
Page 362 Command Descriptions WFMPre:YUNit The set form of this command sets the vertical units for the reference waveform specified by DATa:DESTination. NOTE. It is possible to set a combination of WFMPre:XUNit and WFMPre:YU- Nit that is inconsistent (for example, seconds with dB or Hertz with volts). The oscilloscope will not warn you of this condition.
Page 363 Command Descriptions WFMPre:YZEro YZEro specifies the vertical offset of a waveform. YZEro is a value, expressed in YUNits, used to convert waveform record values to YUNit values using the following formula (where dl is data levels; curve_in_dl is a data point from CURVe?): value_in_units = ((curve_in_dl - - YOFF_in_dl) * YMULT) + YZERO_in_units...
Page 364: Table 2- -44: Additional Wfmpre Commands 2
Command Descriptions WFMPre—Additional Commands for Compatibility Table 2- -44 lists additional WFMPre commands. The oscilloscope ignores the set form of these commands, and the query form generates event messages 100 and 420. The commands are included for compatibility purposes only. Table 2- 44: Additional WFMPre commands Command Argument...
Page 365 Command Descriptions Returns The format of the response is: :WFMPre: :WFID <Qstring>;PT_FMT { ENV | Y }; < > NR_Pt <NR1>;XINcr <NR3>;PT_Off <NR1>;XZEro <NR3>;XUNit <QString>; YMUlt <NR3>;YZEro <NR3>;YOFf <NR3>;YUNit <QString> Example WFMPRE:CH1? might return :WFMPRE:CH1:WFID ”Ch1, DC coupling, 1.0E-1 V/div, 4.0E-4 s/div, 10000 points, Sample mode”;PT_FMT Y;NR_PT 200;XINCR 4.0E-7;PT_OFF 0;XZERO -4.0E-4;XUNIT ”s”;YMULT 4.0E-3;YZERO 0.0E0;YOFF 5.6E1;YU- NIT ”V”...
Page 366 Command Descriptions Examples WFMPre:<wfm>:NR_Pt? returns the number of waveform points in the next CURVE query. Related Commands DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt WFMPre:<wfm>:PT_Fmt Same as WFMPre:PT_Fmt, with the exception that <wfm> specifies the source/destination waveform instead of DATA:SOURCE and DATA:DESTINA- TION. WFMPre:<wfm>:PT_Off Same as WFMPre:PT_Off, with the exception that <wfm>...
Page 367 Command Descriptions WFMPre:<wfm>:YMUlt Same as WFMPre:YMUlt, with the exception that <wfm> specifies the source/destination waveform instead of DATA:SOURCE and DATA:DESTINA- TION. WFMPre:<wfm>:YOFf Same as WFMPre:YOFf, with the exception that <wfm> specifies the source/ destination waveform instead of DATA:SOURCE and DATA:DESTINATION. WFMPre:<wfm>:YUNit Same as WFMPre:YUNit, with the exception that <wfm>...
Page 368 Command Descriptions ZOOm:HORizontal:SCAle Sets or queries the horizontal scale when in zoom. Group Horizontal Syntax ZOOm:HORizontal:SCAle <NR3> ZOOm:HORizontal:SCAle? Arguments <NR3> is the horizontal scale in seconds. Examples ZOOm:HORizontal:SCAle might return :ZOOM:HORIZONTAL:SCALE 1.0E0 ZOOm:STATE Sets or queries the zoom state mode. Group Horizontal Syntax...
Page 369: Figure 3- 1: The Standard Event Status Register (Sesr)
Status and Events oscilloscopes provide a status and event TDS3000B and TDS3000C Series reporting system for GPIB and RS-232 interfaces. This system informs you of significant events that occur within the oscilloscope. The oscilloscope status handling system consists of five 8-bit registers and two queues.
Page 370: Figure 3- 2: The Status Byte Register (Sbr)
Status and Events Table 3- 1: SESR bit functions Function 7 (MSB) PON (Power On). Shows that the oscilloscope was powered on. URQ (User Request). Not used. CME (Command Error). Shows that an error occurred while the oscilloscope was parsing a command or query. Command error messages are listed in Table 3- - 4 on page 3- - 12.
Page 371: Figure 3- 3: The Device Event Status Enable Register (Deser)
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 oscillo- scope requests service from the GPIB controller. MSS (Master Status Summary), obtained from *STB? query. Summarizes the ESB and MAV bits in the SBR.
Page 372: Figure 3- 4: The Event Status Enable Register (Eser)
Status and Events PON URQ CME EXE DDE QYE RQC OPC Figure 3- 4: The Event Status Enable Register (ESER) The Service Request Enable Register (SRER) — is shown in Figure 3- -5. It controls which bits in the SBR generate a Service Request (GPIB only) and are summarized by the Master Status Summary (MSS) bit.
Page 373 Status and Events Queues The oscilloscope status and event reporting system contains two queues: the Output Queue and the Event Queue. The Output Queue The oscilloscope stores query responses in the Output Queue. It empties this queue each time it receives a new command or query message after an <EOM>. The controller must read a query response before it sends the next command (or query) or it will lose responses to earlier queries.
Page 374: Figure 3- 6: Status And Event Handling Process
Status and Events Event Handling Sequence Figure 3- -6, on page 3- -6, shows how to use the status and event handling system. In the explanation that follows, numbers in parentheses refer to numbers in Figure 3- -6. Device Event Status Enable Register (DESER) PON URQ CME EXE DDE QYE RQC OPC Read using DESE?
Page 375 Status and Events When output is sent to the Output Queue, the MAV bit in the SBR is set to one (5). When a bit in the SBR is set to one and the corresponding bit in the SRER is enabled (6), the MSS bit in the SBR is set to one and a service request (GPIB only) is generated (7).
Page 376: Figure 3- 7: Command Processing Without Using Synchronization
Status and Events ACQUIRE:STATE ON Acquiring Waveform Data MEASUREMENT:IMMED:VALUE? Processing Time Figure 3- 7: Command processing without using synchronization To ensure the oscilloscope completes waveform acquisition before taking the measurement on the acquired data, you can synchronize the program. Figure 3- -8 shows the desired processing sequence.
Page 377 Status and Events REM “Take amplitude measurement on acquired data” MEASUREMENT:IMMED:VALUE? Though *WAI is one of the easiest ways to achieve synchronization, it is also the most costly. The processing time of the oscilloscope is slowed since it is processing a single command at a time. This time could be spent doing other tasks.
Page 378 Status and Events 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. You achieve synchronization by using this command with either a serial poll or service request handler.
Page 379 Status and Events The same command sequence using the *OPC command for synchronization looks like this: REM “Set up single-sequence acquisition” SELECT:CH1 ON HORIZONTAL:RECORDLENGTH 500 ACQUIRE:MODE SAMPLE ACQUIRE:STOPAFTER SEQUENCE REM “Enable the status registers” DESE 1 *ESE 1 *SRE 32 REM “Acquire waveform data”...
Page 380 Status and Events REM “Take amplitude measurement on acquired data” 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 Tables 3- -3 through 3- -9 list all the programming interface messages the oscilloscope generates in response to commands and queries.
Page 381 Status and Events Table 3- 4: Command error messages - CME Bit 5 (Cont.) Code Message GET not allowed Invalid program data separator Parameter not allowed Missing parameter Command header error Header separator error Program mnemonic too long Undefined header Query not allowed Numeric data error Invalid character in number...
Page 382 Status and Events Table 3- 4: Command error messages - CME Bit 5 (Cont.) Code Message Invalid outside alias definition Invalid inside alias definition Command in alias requires more/fewer parameters Table 3- -5 lists the execution errors that are detected during execution of a command.
Page 383 Status and Events Table 3- 5: Execution error messages - EXE Bit 4 (Cont.) Code Message File name error Media protected Expression error Math error in expression Hard copy error Hard copy device not responding Hard copy is busy Hard copy is aborted Hard copy configuration error Network printer name not found Network printer list full...
Page 384 Status and Events Table 3- 5: Execution error messages - EXE Bit 4 (Cont.) Code Message 2216 Measurement error, No crossing, target waveform 2217 Measurement error, Constant waveform 2218 Measurement error, Unused 2219 Measurement error, No valid edge - - No arm sample 2220 Measurement error, No valid edge - - No arm cross 2221...
Page 385 Status and Events Table 3- 5: Execution error messages - EXE Bit 4 (Cont.) Code Message 2276 Alias expansion error 2277 Alias redefinition not allowed 2278 Alias header not found 2279 Alias label too long 2280 Alias table full 2285 TekSecureR Pass 2286 TekSecureR Fail...
Page 386 Status and Events Table 3- -7 lists the system event messages. These messages are generated whenever certain system conditions occur. Table 3- 7: System event messages Code Message Query event Power on (PON bit 7 set) Operation complete (OPC bit 0 set) User request (URQ bit 6 set) Power fail (DDE bit 3 set) Request control...
Page 387 Status and Events Table 3- 8: Execution warning messages - EXE Bit 4 (Cont.) Code Message 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 shows internal errors that indicate an internal fault in the oscilloscope. Table 3- 9: Internal warning messages Code Message...
Page 388 Status and Events 3- 20 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 389 Appendix A: Character Charts The MESSage:SHOW, *PUD, SETUP:LABEL, and REF:LABEL commands can display the characters in Table A- -1 and the Chinese, Japanese, Korean, and Russian characters shown in the CHARSETS directory on the disk that accompanied this manual. Table A- 1: Character Set space ‘...
Page 390 Appendix A: Character Charts Table A- 1: Character Set (Cont.) À à Á Ñ á ñ Â Ò â ò Ã Ó ã ó Ä Ô ä ô Õ õ Ö ö Ç ç È è É Ù é ù Ê...
Page 391 Appendix A: Character Charts Table A- 2: ASCII & GPIB Code Chart BITS NUMBERS CONTROL SYMBOLS UPPER CASE LOWER CASE B4 B3 B2 B1 LA16 TA16 SA16 0 0 0 0 LA17 TA17 SA17 0 0 0 1 LA18 TA18 SA18 ”...
Page 392 Appendix A: Character Charts Tektronix octal GPIB code (with ATN asserted) REF: ANSI STD X3.4-1977 ASCII character IEEE STD 488.1-1987 decimal ISO STD 646-2973 A- 4 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 393 Appendix B: Reserved Words The following is a list of the reserved words of the digitizing oscilloscope. Do not use these words for aliases. Capital letters identify the required minimum spelling. Hint: Use the full spelling for the most robust code as the minimum spelling rules may change over time and from model to model.
Page 394 Appendix A: Reserved Words ENCdg FLAg HORZ1 LIMit MSETup ENET FLOPPYdisk HORZ2 LINE ENETADDress FORCETRIG HORZ3 LINEAR NAME ENGLish FORCe HORZ4 LOCk NANd ENTire FORMat HORZPOS NDUty ENVelope FORWards HORZSCALE LOGICLevel NEGAtive EPSColor FPAnel HORizontal LOGIc NETPRInter EPSMono FRAme HOST LOOP NEWpass EPSOn...
Page 395 Appendix A: Reserved Words PCXColor RATE1 SNAPShot TDS3TMT PDUTy RATE2 SOUrce TDS3TRG PEAKdetect RATE3 RPBinary SOURCE1 TDS3UNK PERCent RATE32MBIT RS232 SPANish TDS3VID PERIod RATE4 SPCACQ TEKSecure PERSistence RATE5 RUNSTop SPCTRIG TEMPLate PHAse TATIO RUNT SPCUPtime TERMinator PICture RATIO1 RUSSian SPCVERT TESTS PING RATIO2...
Page 396 Appendix A: Reserved Words VERT3 VOLts WIDth XZEro YREF VERT4 VPOS WINdow VERTPOS VSCAle WRITE YUNit VERTSCALE WAVEAlert XDELta YCHannel YZEro VERTical WAVEform XINcr YDELta ZCHannel VFields WAVEFORMS XMUlt YEARs ZLEVel WAVFrm XOFf YMUlt ZMUlt VIDeo WEIghting XPOSITION1 YOFf ZOFf VIOLATIONS WFId XPOSITION2...
Page 397 Appendix C: Interface Specifications This appendix describes details of the GPIB remote interface of the oscilloscope. Normally, you will not need this information to use the oscilloscope, but the information is useful when connecting to controllers of unusual configuration. GPIB Function Subsets The oscilloscope supports many GPIB function subsets, as listed below.
Page 398 Appendix C: Interface Specifications H DT1 (Device Trigger). When acting as a listener, the oscilloscope responds to the GET (Group Execute Trigger) interface message. H C0 (Controller). The oscilloscope cannot control other devices. H E2 (Electrical). The oscilloscope uses tristate buffers to provide optimal high-speed data transfer.
Page 399 Appendix D: Factory Initialization Settings The factory initialization settings provide you a known state for the oscilloscope. Factory initialization sets values as shown in Table D- -1. Table D- 1: Factory initialization settings Control Changed by Factory Init to Acquire horizontal resolution Normal (10,000 points) Acquire mode Sample...
Page 400 Appendix D: Factory Initialization Settings Table D- 1: Factory initialization settings (Cont.) Control Changed by Factory Init to Edge trigger source Channel 1 Horizontal delay Horizontal delay time 0 ns Horizontal trigger position Horizontal time/doiv 400 s/div Horizontal zoom Horizontal zoom position Horizontal zoom time/div 400 s/div Measure gating...
Page 401 Appendix D: Factory Initialization Settings Table D- 1: Factory initialization settings (Cont.) Control Changed by Factory Init to XY display XY Ch1 (x) Versus Ch 2 XY Ref1 (x) Versus D- 3 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 402 Appendix D: Factory Initialization Settings D- 4 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual...
Page 403 Glossary ASCII Acronym for the American Standard Code for Information Interchange. Controllers transmit commands to the 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 404 ANSI/EIA/TIA- -562- -1989[1], ANSI/EIA/TIA- -574- -1990[2], and CCITT V.24- -1989[3] standards. TekSecure A Tektronix custom command that initializes both waveform and setup memories. This overwrites any previously stored data. Unicode Unicode Standard is a uniform encoding scheme for written characters and text.
Page 405 Index Abbreviating, command, 2- - 4 Backus-Naur Form, 2- - 1 ACQUIRE?, 2- - 45 Definition of, Glossary- - 1 ACQUIRE:MODE, 2- - 45 BELL, 2- - 55 ACQUIRE:NUMACQ?, 2- - 46 Block, command argument, 2- - 10 ACQUIRE:NUMAVG, 2- - 47 BNF, Glossary- - 1 ACQUIRE:NUMENV, 2- - 47 BNF (Backus Naur form), 2- - 1...
Page 406 Index CH<x>:ID?, 2- - 65 Trigger, 2- - 34 CH<x>:IMPEDANCE, 2- - 66 Vertical, 2- - 38 CH<x>:INVERT, 2- - 66 Waveform, 2- - 39 CH<x>:OFFSET, 2- - 67 Command Groups, 1- - 2 CH<x>:POSITION, 2- - 68 Command mnemonic CH<x>:PROBE, 2- - 68 Channel, 2- - 7 CH<x>:SCALE, 2- - 69...
Page 407 Index CURSOR:VBARS:USE, 2- - 81 CURVE, 2- - 90 CURSOR:VBARS:VDELTA?, 2- - 82 CURSOR:WAVEFORM?, 2- - 82 CURSOR:WAVEFORM:SELECT, 2- - 83 CURSOR:XY:PRODDELTA?, 2- - 83 DATA, 2- - 92 CURSOR:XY:PRODUCT<x>?, 2- - 84 DATA:DESTINATION, 2- - 92 CURSOR:XY:RADIUS<x>?, 2- - 84 DATA:ENCDG, 2- - 93 CURSOR:XY:RATDELTA?, 2- - 85 DATA:SOURCE, 2- - 94...
Page 408 Index MESSAGE:BOX, 2- - 233 Ethernet command group, 2- - 17 MESSAGE:CLEAR, 2- - 234 Ethernet commands MESSAGE:SHOW, 2- - 234 ETHERNET:DCHPBOOTP, 2- - 117 MESSAGE:STATE, 2- - 239 ETHERNET:DNS:IPADDRESS, 2- - 117 DISPLAY?, 2- - 102 ETHERNET:DOMAINNAME, 2- - 118 DISPLAY:CLOCK, 2- - 103 ETHERNET:ENETADDRESS?, 2- - 118 DISPLAY:COLOR:PALETTE:REGULAR, 2- - 103...
Page 409 Index File system command group, 2- - 18 Hard copy commands File system commands HARDCOPY, 2- - 136 FILESYSTEM:COPY, 2- - 128 HARDCOPY:COMPRESSION, 2- - 137 FILESYSTEM:CWD, 2- - 129 HARDCOPY:FILENAME, 2- - 138 FILESYSTEM:DELETE, 2- - 129 HARDCOPY:FORMAT, 2- - 139 FILESYSTEM:DELWARN, 2- - 130 HARDCOPY:INKSAVER, 2- - 140 FILESYSTEM:DIR?, 2- - 130...
Page 410 Index LIMIT:TEMPLATE:TOLERANCE: VERTICAL, 2- - 162 ID?, 2- - 149 LIMIT:TEMPLATE:TOLERANCE:HORIZONTAL, *IDN?, 2- - 149 2- - 161 IEEE, Glossary- - 2 LLO, C- - 2 IEEE Std 488.2 1987, 2- - 30, 2- - 33 Local lock out, C- - 2 Interface message, C- - 2 LOCK, 2- - 163 Logic trigger, 2- - 272, 2- - 289...
Page 411 Index MASK:STOPONVIOLATION, 2- - 186 MASK:STOPONVIOLATION, 2- - 186 MASK:TEST:BEEP:COMPLETION, 2- - 187 MASK:TEST:BEEP:COMPLETION, 2- - 187 MASK:TEST:BEEP:FAILURE, 2- - 187 MASK:TEST:BEEP:FAILURE, 2- - 187 MASK:TEST:DELAY, 2- - 188 MASK:TEST:DELAY, 2- - 188 MASK:TEST:HARDCOPY, 2- - 188 MASK:TEST:HARDCOPY, 2- - 188 MASK:TEST:REPEAT, 2- - 189 MASK:TEST:REPEAT, 2- - 189 MASK:TEST:SAVEWFM, 2- - 190...
Page 412 Index MEASUREMENT:IMMED:DELAY?, 2- - 208 MEASUREMENT:REFLEVEL:PERCENT:HIGH, MEASUREMENT:IMMED:DELAY:DIRECTION, 2- - 230 2- - 209 MEASUREMENT:REFLEVEL:PERCENT:LOW, MEASUREMENT:IMMED:DELAY:EDGE<x>, 2- - 230 2- - 209 MEASUREMENT:REFLEVEL:PERCENT:MID, MEASUREMENT:IMMED:SOURCE<x>, 2- - 210 2- - 231 MEASUREMENT:IMMED:SOURCE1, 2- - 210 MEASUREMENT:REFLEVEL:PERCENT:MID2, MEASUREMENT:IMMED:TYPE, 2- - 211 2- - 231 MEASUREMENT:IMMED:UNITS?, 2- - 213 MEASUREMENT:SNAPSHOT, 2- - 232 MEASUREMENT:IMMED:VALUE?, 2- - 213...
Page 413 Index MEASUREMENT:REFLEVEL?, 2- - 227 REBOOT, 2- - 246 MEASUREMENT:REFLEVEL:ABSOLUTE:HIGH, REM, 2- - 252 2- - 227 SET?, 2- - 261 SYSTEM, 2- - 264 MEASUREMENT:REFLEVEL:ABSOLUTE:LOW, TEKSECURE, 2- - 264 2- - 228 TIME, 2- - 265 MEASUREMENT:REFLEVEL:ABSOLUTE:MID, *TRG, 2- - 307 2- - 228 UNLOCK, 2- - 308 MEASUREMENT:REFLEVEL:ABSOLUTE:MID2,...
Page 414 Index Queue conventions, 1- - 23 Event, 3- - 5 errors, 1- - 24 Output, 3- - 5 Setting parameters of, 1- - 22 QuickBASIC, Glossary- - 2 transferring binary data, 1- - 24 QuickC, Glossary- - 2 troubleshooting, 1- - 25 Quoted string, command argument, 2- - 9 RS232?, 2- - 253 RS232:BAUD, 2- - 253...
Page 415 Index Setting TDS3LIM commands, 2- - 21 Command query, 2- - 164 TDS3SDI commands, 2- - 20 Query, 2- - 164 ITU601:AUTOSET, 2- - 150 Recall command, 2- - 246 ITU601:EDH RESET, 2- - 150 RS-232 parameters, 1- - 22 ITU601:EDH:COUNT, 2- - 151 Save command, 2- - 256 ITU601:EDH:DETECT?, 2- - 151...
Page 416 Index TRIGGER:A:PULSE:CLASS, 2- - 278 TRIGGER:B:SETLEVEL, 2- - 301 TRIGGER:A:PULSE:RUNT?, 2- - 279 TRIGGER:B:STATE, 2- - 302 TRIGGER:A:PULSE:RUNT:POLARITY, 2- - 279 TRIGGER:B:TIME, 2- - 302 TRIGGER:A:PULSE:RUNT:THRESHOLD?, 2- - 279 TRIGGER:B:TYPE, 2- - 302 TRIGGER:A:PULSE:RUNT:THRESHOLD:BOTH, TRIGGER:DELAY, 2- - 303 TRIGGER:EXTERNAL:PROBE, 2- - 303 2- - 280 TRIGGER:A:PULSE:RUNT:THRESHOLD:HIGH, TRIGGER:EXTERNAL:YUNIT, 2- - 304...
Page 417 Index TRIGGER:A:PULSE:SLEWRATE:SLEWRATE, Unlisten, C- - 2 UNLOCK, 2- - 308 2- - 284 TRIGGER:A:PULSE:SLEWRATE:THRESH- UNT, C- - 2 Untalk, C- - 2 OLD:BOTH, 2- - 284 TRIGGER:A:PULSE:SLEWRATE:THRESH- OLD:HIGH, 2- - 285 TRIGGER:A:PULSE:SLEWRATE:THRESH- OLD:LOW, 2- - 285 VERBOSE, 2- - 308 TRIGGER:A:PULSE:SLEWRATE:WHEN, 2- - 286 Vertical command group, 2- - 38 TRIGGER:A:PULSE:SOURCE, 2- - 286...
Page 418 Index REF<x>:DATE?, 2- - 249 WFMPRE:ZZERO, 2- - 326 REF<x>:HORIZONTAL:POSITION, 2- - 249 WAVFRM?, 2- - 309 REF<x>:LABEL, 2- - 250 <wfm>, command mnemonic, 2- - 8 REF<x>:TIME?, 2- - 250 WFMPRE?, 2- - 314 REF<x>:VERTICAL:POSITION, 2- - 251 WFMPRE:<wfm>?, 2- - 326 REF<x>:VERTICAL:SCALE, 2- - 251 WFMPRE:<wfm>:PT_FMT, 2- - 328 REF<x>HORIZONTAL:SCALE, 2- - 249...

This manual is also suitable for:

Tds3000c series Tds3000b series

Tektronix TDS3000 Series Program Manual

Quick Links

Related Manuals for Tektronix TDS3000 Series

Summary of Contents for Tektronix TDS3000 Series

This manual is also suitable for:

Table of Contents