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.
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. Specifications and price change privileges reserved. TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Table of Contents Preface Related Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Overview of the Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communication Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing a Communication Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connector Locations . . . . . . . . . . . . . . . .
Table of Contents Status and Events Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Handling Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Synchronization Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Messages . . . . . . .
Table of Contents List of Figures Figure 1--1: Common message elements . . . . . . . . . . . . . . . . . . . . . . . Figure 1--2: Functional groupings and an alphabetical list of commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 1--3: Service Requests (SRQs) provide for event (interrupt) driven programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 1--4: Communication module connectors . . . . . . . . . . . . . . .
Table of Contents List of Tables iv Table 1--1: Communication modules . . . . . . . . . . . . . . . . . . . . . . . . . . Table 1--2: Ethernet Network Settings side menu . . . . . . . . . . . . . . . Table 1--3: Ethernet Printer Settings side menu . . . . . . . . . . . . . . . . Table 1--4: RS-232 adapter cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 1--5: RS-232 default settings . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 1--6: RS-232 troubleshooting . . . . . . .
Table of Contents Table 2--28: Waveform commands . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 2--29: Commands that affect BUSY? response . . . . . . . . . . . . Table 2--30: Offset Ranges using a 1x Probe . . . . . . . . . . . . . . . . . . . Table 2--31: CURVE query error conditions . . . . . . . . . . . . . . . . . . . Table 2--32: CURVE command error conditions . . . . . . . . . . . . . . . . Table 2--33: DATa and WFMPre parameter settings . . . . . . . . . . . .
Table of Contents vi TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
Preface This manual documents the commands for remotely controlling your oscilloscope. With this information, you can write computer programs to perform functions, such as setting the front--panel controls, taking measurements, performing statistical calculations, or exporting data for use in other programs. Related Manuals The following documents are available for download from the Manuals Finder Web site at www.tektronix.com: TDS3000C Series Digital Phosphor Oscilloscopes User Manual.
Preface viii TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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).
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.
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. Your program requests status and event reports as the Controller.
Getting Started Communication Modules Communication modules let you communicate with, or remotely control, your TDS3000, TDS3000B, and TDS3000C Series oscilloscopes. Table 1--1 lists the available communication modules. Figure 1--4 shows the connector configuration for each module. Table 1- 1: Communication modules Communication module 1- 4 Description TDS3EM This communication module adds Ethernet 10baseT local area network (LAN) and RS-232 ports to your TDS3000 Series oscilloscope.
Getting Started Ethernet RS-232 TDS3EM GPIB RS-232 TDS3GM VGA RS-232 TDS3VM GPIB VGA 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 RX TX CLSN LINK: Indicates Ethernet connection when lit. TX: On when oscilloscope is transmitting data. RX: On when oscilloscope is receiving data.
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. To install one of the optional communication modules, follow these steps: 1. Turn the oscilloscope power off. 2.
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. Power input Parallel printer port TDS3000/TDS3000B Communication Module Ethernet port TDS3000B/TDS3000C External trigger TDS3000B/TDS3000C DC power output TDS3000/TDS3000B +14.
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 Administrator To connect the oscilloscope to the network, you need to obtain information from your network administrator.
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. Figure 1--9 shows the Ethernet Change Instrument Settings screen. Table 1--2 describes the Ethernet Network Settings fields.
Getting Started Figure 1- 9: The Change Instrument Settings screen Table 1- 2: Ethernet Network Settings side menu 1- 10 Side Field/value Description Change Instrument Settings Ethernet Address: The factory-set Ethernet address for this module or instrument. This field cannot be edited. Instrument Name: An alphanumeric label assigned to the oscilloscope for easier network reference.
Getting Started Table 1- 2: Ethernet Network Settings side menu (Cont.) Side Field/value Description Change Instrument Settings (cont.) Instrument IP Address: A unique Internet Protocol (IP) address that identifies the oscilloscope. You must enter an IP address in order for the oscilloscope to communicate with the network. Obtain an instrument IP address from your network administrator.
Getting Started Table 1- 2: Ethernet Network Settings side menu (Cont.) Side Field/value Description Debug On 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). Off Test Connection Pushing this button tests the oscilloscope connection to the Ethernet.
Getting Started Setting the Oscilloscope Ethernet Parameters You need to set two types of Ethernet parameters for the oscilloscope; the oscilloscope IP address and one or more remote printer addresses. The oscilloscope IP address uniquely identifies the oscilloscope to other devices on the network, and is required for the oscilloscope to communicate over the network. The remote printer addresses enable you to send hard copy printouts to a specified network printer.
Getting Started NOTE. If the DHCP/BOOTP server assigns a dynamic IP address, then the value in the Instrument IP Address field may be different each time you power on the oscilloscope. This is not a problem if you are mostly sending hard copy to a network printer. However, if you intend to remotely control the oscilloscope, a static IP address is more convenient, as the oscilloscope IP address does not change, making it easier for remote devices to access the oscilloscope.
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. Push the OK Accept side button to apply the field settings. Push the MENU OFF button to exit from the menu without applying any changes. 10.
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. 9. Push the OK Accept side button to apply the field settings. Push the MENU OFF button to exit from the Add Printer menu without applying any changes.
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. H The network printer is powered on and is online. 17.
Getting Started Ethernet, VISA, and TekVisa The VISA standard, developed by the VXI plug & play Systems Alliance, provides a common Input/Output (I/O) library for software developers so that software from different vendors can run on the same platform. 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. NOTE.
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.
Getting Started Setting the GPIB Parameters You need to set the GPIB parameters of the oscilloscope to match the configuration 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. Push the System screen button and select the I/O System. See Figure 1--13. Figure 1- 13: Selecting the System: I/O menu 3. Push the GPIB screen button. 4.
Getting Started Setting Up RS-232 Remote Communications All TDS3000, TDS3000B, and TDS3000C Series communication modules have a 9-pin D-type shell RS-232 connector, as shown in Figure 1--4 on page 1--5. The RS-232 interface provides a point-to-point connection between the oscilloscope and equipment such as a computer or terminal. This section tells how to connect and set up the oscilloscope for communication over the RS-232 interface.
Getting Started Follow these guidelines when connecting the oscilloscope to another RS-232 device: Setting the RS-232 Parameters 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. H Connect the chassis ground of the oscilloscope to the chassis ground of the external device. To set the RS-232 parameters, do the following steps from the oscilloscope front panel.
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. H Set RS-232 Parameters to Default Values — sets default values for RS-232 parameters (for a list of default settings see Table 1--5 on page 1--23). H EOL — sets the end of line terminator sent by the oscilloscope.
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). Processing Break Signals.
Getting Started RS-232 Troubleshooting If the oscilloscope and the personal computer or printer have trouble communicating, 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. Refer to Table 1--4 on page 1--21 for information about RS-232 cables. 2.
Getting Started Table 1- 6: RS-232 troubleshooting (Cont.) Symptom Possible causes The oscilloscope RS-232 debug menu displays CTS: Low, and the oscilloscope is using hard flagging. Verify that the RS-232 cable is the recommended cable. Some cables may be wired without the CTS or RTS lines which are used by hard flagging. Verify that the personal computer program is using CTS/RTS hard flagging. After the personal computer program sends a BREAK, the first message fails.
Getting Started Table 1- 7: Comparison of GPIB and RS-232 interfaces (Cont.) Operating attribute GPIB RS-232 Timing Asynchronous Asynchronous Transmission path length (max) ≤ 2 meters between devices; ≤ 20 meters total cabling for GPIB system ≤ 15 meters Speed 200kBytes/sec 3.
Getting Started 1- 28 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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.
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. Table 2- 2: Command Message Elements Symbol Meaning The basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) character.
Command Syntax Commands Commands have the structure: [:][[]...] A command header consists of one or more mnemonics arranged in a hierarchical or tree structure. The first mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree.
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: Abbreviating Commands H You can enter commands in upper or lower case. H You can precede any command with white space characters.
Command Syntax 2. If concatenated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands ACQuire:MODe ENVelope and ACQuire:NUMAVg 8 into a single command: ACQuire:MODe ENVelope; NUMAVg 8 The longer version works equally well: ACQuire:MODe ENVelope;:ACQuire:NUMAVg 8 3.
Command Syntax Here are some invalid concatenations: Message Terminators 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.
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 mnemonics 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. In the command descriptions, this list of choices is abbreviated as CH.
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 Can be CH, MATH or REF Argument Types The argument of a command may be in one of several forms. The individual descriptions of each command tell which argument types to use with that command. Numeric Arguments Many oscilloscope commands require numeric arguments.
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 Quoted string of ASCII text Follow these rules when you use quoted strings: 1. A quoted string can include any character defined in the 7-bit ASCII character set. (See Appendix A: Character Charts on page A--3). 2.
Command Syntax Block Arguments Several oscilloscope commands use a block argument form: Symbol Meaning A nonzero digit character, in the range 1-- 9 A digit character, in the range 0-- 9 A character with the hex equivalent of 00 through FF hexadecimal (0 through 255 decimal) A block of data bytes, defined as: ::= { #[...][...] | #0[...] } specifies the number of elements that follow.
Command Groups This section lists TDS3000, TDS3000B, and TDS3000C Series GPIB commands in two ways. It first presents them by functional groups. It then lists them alphabetically. 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.
Command Groups Table 2- 4: Acquisition commands (cont.) Header Description WAVEAlert:STATE (TDS3000B and TDS3000C Series) Sets or returns the WaveAlert testing mode WAVEAlert:STOPOnviolation (TDS3000B and TDS3000C Series) Sets or returns the Stop on Violation mode WAVEAlert:TYPe (TDS3000B and TDS3000C Series) Sets or returns the WaveAlert Highlight Anomaly mode Alias Commands Alias commands let you define your own commands as a sequence of standard 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.
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 DIAg:STATE EXECute Executes all the diagnostics tests that have been selected Cursor Commands Cursor commands provide control over cursor (caliper) display and readout.
Command Groups Table 2- 7: Cursor commands (cont.
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 commands.
Command Groups 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 and TDS3000C Series oscilloscopes, or in TDS3000 Series oscilloscopes equipped with an optional TDS3EM Ethernet communications module.
Command Groups File System Commands File system commands help you manage the oscilloscopes memory storage device. Table 2--10 lists these commands.
Command Groups Hard Copy Commands Hard copy commands let you control the format of hard copy output and the initiation and termination of hard copies. Table 2--12 lists these commands.
Command Groups Table 2- 13: Horizontal commands (cont.
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. When it finds such a waveform, it can generate a hard copy, emit a beep, save the waveform to memory, stop and wait for your input, or any combination of these actions.
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.
Command Groups Table 2- 16: Mask commands (cont.
Command Groups Table 2- 16: Mask commands (cont.
Command Groups Table 2- 16: Mask commands (cont.
Command Groups Table 2- 17: Available TDS3TMT ITU-T G.703 mask standards Standard Description CLOCKCoax Clock interface coaxial pair 2.048 Mb/s CLOCKSymmetrical Clock interface symmetric pair 2.048 Mb/s DS0Contra DS-0 data contra-directional 64 kb/s DS0Double DS-0 double 64 kb/s DS0Single DS-0 single 64 kb/s DS0Timing DS-0 timing 64 kb/s DS1Rate Old DS1 rate 1.544 Mb/s G703DS1 G.703 DS1 1.544 Mb/s DS2RATECoax DS2 rate coaxial pair 6.
Command Groups Math Commands Math commands provide access to math function definition. This table also includes TDS3AAM Advanced Analysis application module remote command syntax.
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, where can be 1, 2, 3, or 4. In addition to the four displayed measurements, the measurement commands let you specify a fifth measurement, IMMed. The immediate measurement has no front-panel equivalent.
Command Groups Table 2- 20: Measurement commands (cont.
Command Groups Table 2- 20: Measurement commands (cont.
Command Groups Table 2- 21: Miscellaneous commands (cont.
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.
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. IEEE Std 488.2--1987 defines these commands and queries. They begin with an asterisk (*).
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.
Command Groups Table 2- 25: Trigger commands (cont.
Command Groups Table 2- 25: Trigger commands (cont.
Command Groups Table 2- 25: Trigger commands (cont.
Command Groups Vertical Commands Vertical commands control the display of channels and of main and reference waveforms. Table 2--26 lists these commands. The SELect: 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.
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. When working with peak detect or envelope waveforms, each data value is either the min or max of a min/max pair. Before you transfer waveform data, you must specify the data format, record length, and waveform source.
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 1 - 128 to 127 0 to 255 2 - 32,768 to 32,767 0 to 65,535 The defined binary formats also specify the order in which the bytes are transferred. The four binary formats are RIBinary, RPBinary, SRIbinary, and SRPbinary.
Command Groups locations. You can specify the reference memory location with the DATa:DESTination 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. Refer to the WFMPre commands starting on page 2--314 for more information about the waveform preamble.
Command Groups Table 2- 28: Waveform commands 2- 42 Header Description CURVe Transfers waveform data to or from the oscilloscope DATa Sets or returns the format and location of the waveform data that is transferred with the CURVe command DATa:DESTination Sets or returns the destination for waveforms sent to oscilloscope DATa:ENCdg Sets or returns the waveform data encoding method DATa:SOUrce Sets or returns the source of CURVe? data DATa:STARt Sets or returns the starting point in waveform t
Command Groups Table 2- 28: Waveform commands (cont.
Command Groups 2- 44 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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. Commands that are query only are labeled with the words “(Query Only)” next to the command. This manual shows the minimal command headers, mnemonics, and arguments in upper case.
Command Descriptions Syntax Arguments ACQuire:MODe { SAMple | PEAKdetect | AVErage | ENVelope } 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. SAMple is the default mode.
Command Descriptions Examples Related Commands ACQUIRE:NUMACQ? might return 350, indicating that 350 acquisitions took place since an ACQUIRE:STATE RUN command was executed. 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.
Command Descriptions Syntax ACQuire:NUMEnv { | INFInite } ACQuire:NUMEnv? Arguments ¸ 0 is the number of waveform acquisitions, from 2 to 512 (must be a 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. INFInite or = 0 or 999999999 specifies continuous enveloping. NOTE.
Command Descriptions Arguments OFF or STOP or = 0 stops acquisitions. ON or RUN or ¸ 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. It also resets the number of acquisitions. Examples ACQUIRE:STATE RUN starts acquisition of waveform data and resets the number of acquisitions count (NUMACQ) to zero.
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. ACQUIRE:STOPAFTER? might return SEQUENCE. Related Commands ACQuire:MODe, ACQuire:STATE ALIas Turns command aliases on or off.
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 Examples [,...] ALIAS:CATALOG? might return the string ”SETUP1”,”TESTMENU1”,”DEFAULT”, showing there are 3 aliases named SETUP1, TESTMENU1, and DEFAULT. ALIas:DEFINE Assigns a sequence of program messages to an alias label.
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” that sets up the oscilloscope.using information in setup 5.
Command Descriptions ALIas:DELEte:NAMe (Set Only) Removes a specified alias. This command is identical to ALIas:DELEte. Group Alias Syntax ALIas:DELEte:NAMe Arguments Examples is the name of the alias to remove. Using ALIas:DELEte:NAMe without specifying an alias causes an execution error. must be an existing alias. ALIAS:DELETE:NAME ”STARTUP” deletes the alias named STARTUP. ALIas:STATE Turns aliases on or off. This command is identical to the ALIas command.
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. This command is similar to repeatedly sending *EVMsg? queries to the instrument.
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. The video waveform must be NTSC, PAL, or SECAMcompliant, with a horizontal scan rate from 15 kHz to 20 kHz.
Command Descriptions Returns = 0 means that the oscilloscope is not busy processing an execution-timeintensive command. Execution-time-intensive commands are listed in Table 2--29. = 1 means that the oscilloscope is busy processing one of the commands listed in Table 2--29.
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 *CAL? Returns = 0 indicates that the calibration did not complete successfully.
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.
Command Descriptions CALibrate:FACtory:NOTIfy:HOURs Sets or returns hours when calibration is due. Group Calibration and Diagnostic Syntax CALibrate:FACtory:NOTIfy:HOURs { INFInite | } CALibrate:FACtory:NOTIfy:HOURs? Arguments = 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. INFInite = disables the calibration due notifier display feature.
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 CALibrate:FACtory:CONTInue command will repeat the factory calibration step that just finished.
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.
Command Descriptions Syntax Examples Related Commands CALibrate:INTERNal CALIBRATE:INTERNAL performs an internal self-calibration (SPC). 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. The oscilloscope state is saved before SPC execution and restored afterwards. Pass/fail status is saved in nonvolatile memory.
Command Descriptions Examples Related Commands CALIBRATE:INTERNAL:STATUS? might return :CALIBRATE:INTERNAL:STATUS UNCAL+ if non-volatile memory has failed. CALibrate:INTERNal:STARt CH? (Query Only) Returns the vertical parameters of the specified channel. Because CH:SCAle and CH:VOLts are identical, only CH:SCAle is returned. Group Vertical Syntax CH? Examples CH1? might return the string :CH1:SCALE 10.0E-3;POSITION 0.0E0; OFFSET 0.0E0;COUPLING DC;BANDWIDTH FULL;DESKEW 0.
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:COUPling Sets or queries the input attenuator coupling setting of the specified channel. This is equivalent to setting Coupling in the Vertical menu. Group Vertical Syntax CH:COUPling { AC | DC | GND } CH:COUPling? Arguments specifies the input channel. Valid values are 1, 2, 3, and 4.
Command Descriptions CH: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. Group Vertical Syntax CH:DESKew CH:DESKew? Arguments specifies the input channel. Valid values are 1, 2, 3, and 4.
Command Descriptions CH:IMPedance Sets or returns the channel probe impedance. Group Vertical Syntax CH:IMPedance { FIFty | MEG } CH:IMPedance? Arguments 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Ω impedance. Examples CH1:IMPEDANCE? might return MEG. CH:INVert Sets or returns the specified channel signal invert setting.
Command Descriptions CH: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. Group Vertical Syntax CH:OFFSet CH:OFFSet? Arguments specifies the input channel. Valid values are 1, 2, 3, and 4. is the specified offset value, typically in volts.
Command Descriptions CH: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 CH:POSition CH:POSition? Arguments specifies the input channel. Valid values are 1, 2, 3, and 4. is the desired position, in divisions from the center graticule.
Command Descriptions Arguments specifies the input channel. Valid values are 1, 2, 3, and 4. 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. Examples CH4:PROBE? might return 1.0E-1 for a 10x probe. CH:SCAle Sets or queries the vertical gain of the specified channel.
Command Descriptions CH:VOLts Sets or queries the vertical gain of the specified channel. This command is identical to the CH:SCAle command and is included for compatibility purposes. Only CH:SCAle is returned in response to a CH? query. Group Vertical Syntax CH:VOLts CH:VOLts? Arguments specifies the input channel. Valid values are 1, 2, 3, and 4. is the gain, in user units per division.
Command Descriptions Arguments specifies the input channel. Valid values are 1, 2, 3, and 4. is either “V” for volts or “A” for amps as the units. Examples CH: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. Group Display Syntax CLEARMenu Examples CLEARMENU clears the menu from the display. *CLS (Set Only) Clears the oscilloscope status data structures.
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. CURSor? (Query Only) Returns all current cursor settings for the active cursor.
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.
Command Descriptions Arguments CURSORX specifies the X-axis cursor of the specified graticule cursor, where n = 1 for the reference cursor, and n = 2 for the delta cursor. CURSORY specifies the Y-axis cursor of the specified graticule cursor, where n = 1 for the reference cursor, and n = 2 for the delta cursor. Examples CURSOR:GRATICULE:SELECT CURSOR2X selects the graticule delta X-axis cursor as the active cursor.
Command Descriptions Arguments specifies which graticule cursor, where x = 1 for the reference cursor and x = 2 for the delta cursor 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. Group Cursor Syntax CURSor:HBArs? Examples CURSOR:HBARS? might return :CURSOR:HBARS:POSITION1 0.0E0;POSITION2 0.0E0;DELTA 0.
Command Descriptions CURSor:HBArs:POSITION Sets or queries the position of the specified horizontal bar cursor relative to ground. Group Cursor Syntax CURSor:HBArs:POSITION CURSor:HBArs:POSITION? Arguments specifies the cursor. Valid values are 1 and 2. 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.
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.
Command Descriptions 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 Related Commands CURSOR:HBARS:USE FIVEdivs sets the H Bar measurement scale so that 5 screen major divisions equals 100%.
Command Descriptions Examples Related Commands CURSOR:VBARS:HDELTA? might return :CURSOR:VBARS:HDELTA 1.088000000E-3, indicating the time between the vertical bar cursors is 1.088 milliseconds. CURSor:VBArs:UNIts CURSor:VBArs:HPOS? (Query Only) Returns the horizontal value of the specified vertical bar ticks. Group Cursor Syntax CURSor:VBArs:HPOS? Arguments specifies the cursor. Valid values are 1 and 2. Returns indicates the value of one of the tics.
Command Descriptions Arguments specifies the cursor. Valid values are 1 and 2. specifies the cursor position in the units specified by the CURSor: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.
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 CURSor:VBArs:UNIts? Arguments Examples is either ”s” for seconds, ”Hz” for Hertz, ”%” for percent, or ”degrees” as the unit of measure. CURSOR:VBARS:UNITS ”s” sets the units for the vertical bar cursors to seconds.
Command Descriptions Examples Related Commands 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 %. 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. Group Cursor Syntax CURSor:VBArs:VDELTa? Returns indicates the horizontal difference between the two vertical bar cursors.
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 CURSor:WAVEform:SELect { CURSOR1 | CURSOR2 } CURSor:WAVEform:SELect? Arguments CURSOR1 sets the XY waveform reference cursor as the active cursor.
Command Descriptions CURSor:XY:PRODUCT? (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? Arguments Examples Related Commands specifies the XY cursor, where x = 1 for the reference cursor and x = 2 for the delta cursor. CURSOR:XY:PRODUCT1? might return CURSOR:XY:PRODUCT1 2.23E2.
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 Related Commands CURSOR:XY:RATDELTA? might return CURSOR:XY:RATDELta -6.13E-1. CURSor:XY:READOUT, DISplay:XY:MODe CURSor:XY:RATIO? (Query Only) (Available with TDS3AAM) Returns the cursor ratio value for the specified XY cursor.
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 Related Commands CURSOR:XY:RDELTA? might return CURSOR:XY:RDELTA 6.915E0. CURSor:XY:READOUT, DISplay:XY:MODe CURSor:XY:READOUT (Available with TDS3AAM) Sets or returns the XY cursor readout type.
Command Descriptions CURSor:XY:RECTX? (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? Arguments Examples Related Commands , where x = 1 for the reference cursor and x = 2 for the delta cursor.. CURSOR:XY:RECTX2? might return CURSOR:XY:RECTX2 1.
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 Related Commands CURSOR:XY:THDELTA? might return CURSOR:XY:THDELTA -3.
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 Related Commands CURSOR:XY:XDELTA? might return CURSOR:XY:XDELTA 5.
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.
Command Descriptions Group Related Commands Syntax Waveform DATa, WFMPre? CURVe { | } CURVe? Arguments is the waveform data in binary format. The waveform is formatted as: # where is the number of y bytes. For example, if = 500, then = 3. is the number of bytes to transfer. If width is 1 then all bytes on the bus are single data points. If width is 2 then all bytes on the bus are 2-byte pairs. Use the DATa:WIDth command to set the width.
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 Examples Related Commands INIT initializes the waveform data parameters to their factory defaults.
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. Setting the DATa:ENCdg value causes the corresponding WFMPre values to be updated and vice versa.
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.
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. This command allows for the transfer of partial waveforms to and from the oscilloscope.
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.
Command Descriptions 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 DATa:TARget? Arguments Examples Related Commands specifies reference memory location 1 (REF1) through 4 (REF4). DATA:TARGET? might return DATA:TARGET REF2.
Command Descriptions DATE Sets or returns the date that the oscilloscope can display. Group Miscellaneous Syntax DATE DATE? Arguments Examples Related Commands 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. There must a dash (--) after the yyyy and after the mm. DATE ”2000-01-20” specifies that the date is set to January 20th, 2000.
Command Descriptions Examples Related Commands *DDT #231AUTOSET EXECUTE;:SELECT:REF1 ON performs autoset and selects REF1. 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. For a more detailed discussion of the use of these registers, see page 3--1.
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. ONFAIL causes looping on a specific test group as long as a FAIL status is returned from the test.
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.
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. The pass/fail status will be returned by the DIAg:RESUlt:FLAg? query, and the internal log will be returned by the DIAg:RESUlt:LOG? query.
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 | } DISplay:CLOCk? Arguments or = 0 removes the clock from the display. or ¸ 0 displays the clock on the display. Examples DISPLAY:CLOCK ON sets the display to show the time and date.
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; there is no intensity modulation.
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 CROSSHair specifies a frame and cross hairs only. FRAme specifies just a frame. FULl specifies a frame, a grid, and cross hairs.
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. This command is equivalent to adjusting the WAVEFORM INTENSITY knob.
Command Descriptions Syntax DISplay:PERSistence { | INFInite | AUTO | MINImum } DISplay:PERSistence? Arguments 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. AUTO specifies that the waveform persistence is controlled by the front panel WAVEFORM INTENSITY knob. MINImum specifies that the waveform persistence is set to the minimum value of 0.0E0.
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 | } DISplay:PICture:AUTOContrast? Arguments or = 0 disables picture autocontrast mode. or ¸ 0 enables picture autocontrast mode.
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 DISplay:PICture:CONTRAst? Arguments Examples Related Commands sets the picture contrast value from 0 to 100. DISplay:PICture:AUTOContrast must be OFF in order to set the contrast value.
Command Descriptions Examples Related Commands DISPLAY:PICTURE:STATE? might return DISPLAY:PICTURE:STATE ON, indicating that the video picture mode is enabled. 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.
Command Descriptions Arguments ON or NR1 ≥ 1 enables the vectorscope display mode. 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. Note that this does not actually turn on the vectorscope display type, but just sets the type value.
Command Descriptions Arguments ONEHundred or NR1 ≥ 1 sets the vectorscope display mode to 100% colorbars. 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.
Command Descriptions Table 2- 35: XY format pairs X-Axis source Y-Axis source Ch1 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; there is no intensity modulation. Gated XYZ is useful for showing constellation diagrams.
Command Descriptions OFF sets the Y Channel to off or none which turns off or prevents the CH1 versus CH 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. DISPLAY:XY:YCHANNEL? might return :DISPLAY:XY:YCHANNEL CH2 indicating that channel 2 will be the Y channel in Triggered XY mode.
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 Examples specifies which channel to use as the Z channel source. DISPLAY:XY:ZCHANNEL CH2 sets oscilloscope channel 2 as the Z channel source in gated XYZ mode. DISplay:XY:ZLEVel Specifies the Z channel threshold level to enable XY gating in gated XYZ mode.
Command Descriptions Syntax *ESE *ESE? Arguments 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. NOTE. Setting the DESER and the ESER to the same value allows only those codes to be entered into the Event Queue and summarized on the ESB bit (bit 5) of the Status Byte Register. Use the DESE command to set the DESER.
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 | } ETHERnet:DCHPBOOTP? Arguments ON or nr1 ≥ 1 enables the oscilloscope to search the network for a DCHP or BOOTP server in order to automatically assign a dynamic IP address to the oscilloscope. NOTE.
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 ETHERnet:DOMainname? Arguments Example is the network domain name, enclosed in quotes. ETHERNET:DOMAINNAME ”Alpha1.Mycorp.
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 ETHERnet:GATEWay? Arguments Example is a standard IP address value, enclosed in quotes. 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.
Command Descriptions Syntax ETHERnet:IPADDress ETHERnet:IPADDress? Arguments Examples is a standard IP address value, enclosed in quotes. 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.
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; the new settings replace the existing printer settings. Examples ETHERNET:NETPRINTER:ADD ”QMSprt;prtserva1;128.121.33.21” adds a printer to the oscilloscope printer list.
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 | } ETHERnet:NETPRInter:DELWarn? Arguments OFF turns off delete warning ON turns on delete warning nr1 is an integer number where nr1 = 0 turns off delete warning, and nr1 ≠ 0 turns on delete warning.
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.
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.
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. TRYING the ETHERnet:PING:EXECUTE command is still trying to connect to the network.
Command Descriptions Group Related Commands Syntax Syntax Examples Status and Error ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB? EVENT? 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. A more detailed discussion of event handling begins on page 3--1.
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 Related Commands EVQTY? might return :EVQTY 3 as the number of event codes in the Event Queue. ALLEv?, EVENT?, EVMsg? FACtory (Set Only) Resets the oscilloscope to its factory default settings (see Appendix D).
Command Descriptions Examples Related Commands FILESYTEM? might return :FILESYSTEM:CWD “fd0:/”;DELWARN 1;OVERWRITE 1, (Confirm Delete on, Overwrite Lock on). 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. Also, you can use wild card characters (*.*) to copy multiple files with one command.
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 oscilloscope menus.
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. No deletion warning message is returned via the remote interface.
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 Arguments Examples is a quoted string that defines the drive to format. FILESYSTEM:FORMAT “fd0:” formats the media on drive fd0:. FILESystem:FREESpace (Query Only) Returns the amount of freespace (in bytes) on the storage drive.
Command Descriptions Arguments is a quoted string that defines the directory. Input the directory using the form //. and one or more s are optional. If you do not specify them, the oscilloscope will create the directory in the current directory. stands for a directory name of up to 8 characters and can be followed by a period (“.”) and a 3-character extension.
Command Descriptions FILESystem:PRInt (Set Only) Prints a named file to the named port. Group File system Syntax FILESystem:PRInt ,{ GPIb | RS232 | CENtronics | ETHERnet} Arguments is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the oscilloscope will print the file in the current directory.
Command Descriptions is a quoted string that defines the new name of the file. Input the file path using the form //. and one or more s are optional. If you do not specify them, the oscilloscope will place the newly named file in the current directory. The current directory refers to the name of a directory as returned by the FILESystem:CWD query. Examples FILESYSTEM:RENAME “TEK00000.SET”,“MYSET.SET” gives the file named TEK00000.
Command Descriptions FPAnel:PRESS (Set only) Duplicates the action of pressing a specified front-panel button. Group Miscellaneous Syntax FPAnel:PRESS { ACQuire | AUTOSet | BMENU | BTRIG | CH | CLEARMenu | COARSE | CURSor | DELay | DISplay | FORCETRIG | HARDCopy | MATH | MEASUrement | OFF | QUICKmenu | REF | RMENU | RUNSTop | SAVERecall | SELect | SETTo50 | SINGLESEQ | TRIGger | UTILITY | VERTical | ZOOm } Arguments Most of the argument names associate directly with their front panel button.
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 ] , } 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.
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. NOTE. Use the *WAI command between HARDCopy STARt commands to ensure that the first hard copy is complete before starting another. Examples HARDCOPY ABORT stops any hard copy output that is in process.
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. HARDCopy:FILEName file names are not checked for syntactical correctness until HARDCOPY START is received.
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 TDS3PRT sets the hard copy file format to the TDS3PRT plug-in thermal printer format. (TDS3000B series only.
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. BJC80 sets the hard copy file format to Canon BJC-50, BJC-80 color printer format. (TDS3000B Series and TDS3000C Series only.) PNG sets the hard copy file format to Portable Network Graphics format.
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. PORTRait specifies that the bottom of the hard copy is along the short side of the page. This is the standard format.
Command Descriptions HARDCopy:PORT Sets or returns where to send the hard copy data on the next hard copy command (i.e. HARDCOPY START command). This is equivalent to setting Port in the UTILITY > Hard Copy menu. Group Related Commands Syntax Hard copy HARDCopy HARDCopy:PORT { CENtronics | FILE | GPIb | RS232 | ETHERnet } HARDCopy:PORT? Arguments CENtronics specifies that the hard copy is sent out the Centronics port. (TDS3000 Series and TDS3000B Series only.
Command Descriptions Syntax HARDCopy:PREVIEW { | ON | OFF } HARDCopy:PREVIEW? Arguments ON or ¸ 0 sets the display screen to simulate hard copy output. OFF or = 0 turns off the simulation of hard copy output. Examples HARDCOPY:PREVIEW ON will change the display to simulate hard copy output with the current format, layout, palette, and inksaver options. HDR This command is identical to the HEADer query and is included for compatibility with older Tektronix instruments.
Command Descriptions Arguments ON or ¸ 0 sets the Response Header Enable State to true. This causes the oscilloscope to include headers on applicable query responses. You can then use the query response as a command. OFF or = 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. Examples HEADER OFF causes the oscilloscope to omit headers from query responses.
Command Descriptions Syntax HORizontal:DELay:STATE { ON | OFF } HORizontal:DELay:STATE? Arguments ON or ¸ 0 sets the delay on so that the acquisition is positioned relative to the delay time. OFF or = 0 sets the delay off so that the acquisition is positioned relative to the trigger position. Examples HORIZONTAL:DELAY:STATE ON sets the delay state to on. HORizontal:DELay:TIMe Sets or returns the delay time between the trigger and the center of the screen.
Command Descriptions HORizontal:MAIn:SCAle Sets the time per division for the main time base. The specified scale value is rounded to a valid scale setting. Group Horizontal Syntax HORizontal:MAIn:SCAle HORizontal:MAIn:SCAle? Arguments Examples Related Commands is the time per division. The range is 10 s to 1, 2, or 4 ns (depending on model), in a 1--2--4 sequence. HORIZONTAL:MAIN:SCALE 2E-6 sets the main scale to 2 s per division.
Command Descriptions HORizontal:RECORDLength Sets the number of data points that are acquired for each record. Group Horizontal Syntax HORizontal:RECORDLength HORizontal:RECORDLength? Arguments Examples is the record length in points. Valid values are 500 and 10000. 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.
Command Descriptions HORizontal:SCAle Sets the time per division for the main time base and 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:SCAle HORizontal:SCAle? HORizontal:SECdiv Sets the time per division for the main time base and is identical to the HORizontal:MAIn:SCAle command. It is included here for compatibility purposes.
Command Descriptions ID? (Query Only) Returns information about the oscilloscope, including the model number, options, application modules, and firmware version. Group Status and Error Syntax ID? Returns The instrument id in the following format: TEK/,CF:91.1CT,FV:
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.
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 | } ITU601:EDH:COUNt? Arguments OFF or = 0 disables the EDH error count function. ON or = 1 enables the EDH error count function. Examples ITU601:EDH:COUNT ON Enables the EDH error count function.
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). ITU601:INPUT:FORMat (TDS3000B and TDS3000C Series with TDS3SDI Only) Sets or returns the TDS3SDI 601 digital video input signal format.
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. Group TDS3SDI Syntax ITU601:INPUT:SIGnalstrength? Examples ITU601:INPUT:SIGNALSTRENGTH? might return the response ITU601:INPUT:SIGNALSTRENGTH 1.
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. RGB sets the TDS3SDI module to output RGB color signal information.
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.
Command Descriptions LIMit:COMPARE:CH (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 { NONe | REF } LIMit:COMPARE:CH? Arguments Ch is a channel, where is 1, 2, 3, or 4. NONe turns off limit testing for the specified channel.
Command Descriptions Syntax LIMit:HARDCopy { OFF | ON | } LIMit:HARDCopy? Arguments ON or ¸ 0 turns on the hard copy operation when any waveform data exceeds the limits set by the limit test. OFF or = 0 turns off the hard copy operation. Examples LIMit:HARDCopy ON specifies that the hard copy operation occurs when any waveform data exceeds the limits specified in the limit test.
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 LIMit:STATE { OFF | ON | } LIMit:STATE? Arguments OFF or = 0 turns off limit testing. ON or ¸ 0 turns on limit testing.
Command Descriptions Syntax Arguments LIMit:STOPOnviolation { OFF | ON } LIMit:STOPOnviolation? OFF = 0 turns off the stop on violation. ON ¸ 0 turns on the stop on violation. Examples Related Commands LIMIT:STOPOnviolation? might return OFF that indicates the stop on violation is turned off.
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 LIMit:TEMPLate:DESTination? Arguments REF specifies the reference waveform destination in which the template waveform is to be stored.
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.
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 LIMit:TEMPLate:TOLerance:VERTical? Arguments is the amount, in vertical divisions, by which the source waveform is varied vertically when creating the test waveform. The range is 0 to 5 divisions.
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 ALL disables all front-panel controls. NONe enables all front-panel controls. This is equivalent to the UNLock ALL command. NOTE.
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 Related Commands Syntax Miscellaneous HEADer, SET?, VERBose *LRN? NOTE. The *LRN? query always returns a string including command headers, regardless of the setting of the HEADer command. This is because the returned string is intended to be sent back to the oscilloscope as a command string.
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 MASK:AUTOFit { | OFF } MASK:AUTOFit? Arguments is an integer number from 0 to 10, where 0 turns the autofit function off, and 1-10 turns the autofit function on and defines the autofit radius.
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.
Command Descriptions MASK:COUNt:CH: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:HITS? Arguments Examples is an integer in the range of 1 to 4 that sets which scope channel to query for mask hits. MASK:COUNT:CH2:HITS? might return 138.
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:HITS? MASK:COUNt:MASK:CH:HITS? (Query Only) (Requires TDS3TMT) Returns the number of hits for channel in mask segment . A mask segment is one of the polygons that make up a mask.
Command Descriptions MASK:COUNt:MASK:HITS? (Query Only) (Requires TDS3TMT) Returns the number of hits for all channels in the specified mask segment. Group Mask Syntax MASK:COUNt:MASK:HITS? Arguments Examples Related Commands is the mask segment number, with a valid range of 1-8. MASK:COUNT:MASK1:HITS? might return 124.
Command Descriptions MASK:COUNt:TESTS? (Query Only) (Requires TDS3TMT) Returns the number of pass/fail tests that have occurred when MASK:TESt:REPeat is turned on. Group Mask Syntax MASK:COUNt:TESTS? Examples MASK:COUNT:TESTS? might return 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 oscilloscopes.
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? might return 560.
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. MASK:DISplay is set to ON if MASK:TESt:STATE, MASK:COUNt:STATE, or MASK:STOPOnviolation are set to ON.
Command Descriptions Arguments OFF turns off mask lock to waveform. ON turns on mask lock to waveform. 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. MASK:MARGIN:VERTical (Requires TDS3TMT) Sets or returns the User mask’s vertical margin percentage.
Command Descriptions MASK:MASK DELEte (Requires TDS3TMT) Deletes the specified mask segment from the User mask, whether or not the User mask is the current mask.
Command Descriptions MASK:MASK: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 coordinates. Group Mask Syntax MASK:MASK:NR_Pt? Arguments Examples is an integer number that specifies a mask segment number in the currentlydisplayed mask.
Command Descriptions Arguments specifies the mask segment number in the current mask (query form), or the User mask (set form). 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.
Command Descriptions MASK:MASK: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.
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.
Command Descriptions Arguments Examples Related Commands is a floating point number that sets the mask drawing timing resolution. MASK:MASKPRE:HSCALE 40e-9 sets the nominal timing resolution used to draw the current standard’s pulse shape to 40 nanoseconds per division. MASK:MASKPRE:HTRIGPOS MASK:MASKPRE:HTRIGPOS (Requires TDS3TMT) Sets or returns the nominal trigger position (pulse leading edge) used to draw the mask as a fraction of the display width.
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. The set form of this command only affects the User mask, regardless of the current (displayed) mask.
Command Descriptions Examples Related Commands MASK:MASKPRE:PRESAMPBITS 4 sets the User mask number of bits before the trigger pulse to 4. 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.
Command Descriptions Arguments OFF disables serial triggering. ON enables serial triggering. is an integer number where NR1 = 0 turns off serial triggering, and NR1 ≠ 0 turns on serial triggering. Examples Related Commands MASK:MASKPRE:SERIALTRIG 1 turns on serial triggering for the User mask.
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.
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.
Command Descriptions Examples Related Commands MASK:MASKPRE:WIDTH 648e-9 sets the User mask nominal bit width to 648 nanoseconds (1.544 Mbits/second). 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 MASK:POLarity {BOTh | NEGAtive | POSITIVe } MASK:POLarity? Arguments BOTh sets the pass/fail test to test both positive and negative waveforms.
Command Descriptions MASK:STANdard (Requires TDS3TMT) Set or returns the currently-displayed mask. To turn mask display off, set the standard to NONe.
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’ or ‘Failed.
Command Descriptions Arguments OFF turns off pass/fail beep on failure. ON turns on pass/fail beep on failure. 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. MASK:TESt:DELay (Requires TDS3TMT) Sets or returns the amount of time, in seconds, to wait after starting pass/fail testing to evaluate waveforms.
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. Group Mask Syntax MASK:TESt:HARDCopy { OFF | ON | } MASK:TESt:HARDCopy? Arguments OFF turns off generate hard copy on failure.
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.’ Set the file save format to Internal File Format to minimize file size. NOTE.
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.
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 MASK:TESt:THReshold? Arguments Examples is an integer number that sets the maximum number of tested waveforms that can fail during each pass/fail test before the test fails.
Command Descriptions MASK:USER:MASK 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 DELEte Arguments Examples is an integer number that specifies the User mask segment number to delete from the User mask. MASK:USER:MASK3 DELETE deletes mask segment three from the User mask.
Command Descriptions MASK:USER:MASK: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 MASK:USER:MASK:POINTS , [, , ] MASK:USER:MASK:POINTS? Arguments is an integer that specifies the User mask segment number.
Command Descriptions Arguments is an integer number that specifies the User mask segment number. is a floating point number that defines a normalized User mask point. Examples MASK:USER:MASK:POINTSNORM? might return -0.77, 1.05, -0.5, -0.9, 0.5, 1.0, 1.16, 0.5 MASK:USER:MASK:POINTSPcnt (Requires TDS3TMT) Sets or returns the points in the specified User mask segment, in percentage coordinates.
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.
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; POSITION 5.0E1;UNITS ”?”;:MATH:VAR1 0.0E0;VAR2 0.0E0;SPECTRAL: MAG DB;WINDOW HANNING.
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. The syntax of this command depends on the value of the MATH:TYPe command, as well as which application module is installed in the instrument.
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. scaling is an optional argument that sets the FFT waveform vertical scale type. Valid choices are: LOGrms and LINearrms.
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.
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 MATH:HORizontal:SCAle? Arguments Examples is the math horizontal scale in seconds. MATH:HORIZONTAL:SCALE? might return :MATH:HORIZONTAL:SCALE 2.0E-4 indicating that the math horizontal scale is 200 s. MATH:HORizontal:UNITs Sets or returns the math waveform horizontal measurement unit value.
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.
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 Related Commands MATH:TYPE FFT sets the math waveform mode to FFT.
Command Descriptions Group Math Syntax MATH:VERTical:POSition MATH:VERTical:POSition? Arguments Examples is the math vertical position in divisions from center screen. 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.
Command Descriptions MATH:VERTical:UNITs Sets or returns the math waveform vertical measurement unit value. Group Math Syntax MATH:HORizontal:UNITs MATH:HORizontal:UNITs? Arguments Examples is a text label to apply to vertical units when the vertical unit is “?” (unknown unit value). MATH:VERTICAL:UNITS? might return :MATH:VERTICAL:UNITS ”joules” indicating that the math vertical unit label for unknown values is joules.
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;:MEASUREMENT:MEAS1:STATE 0;:MEASUREMENT:MEAS2:TYPE PERIOD;UNITS ”s”;COUNT 0;MINIMUM 0.0E0;MAXIMUM 0.0EO;MEAN 0.0E0;STDDEV 0.
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.
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 MEASUrement:IMMed:DATa? , Arguments is the measurement result.
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 MEASUrement:IMMed:SOURCE2 command to specify the delay “to” waveform.
Command Descriptions Arguments specifies which waveform to use, where = 1 is the “from” waveform, and = 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. MEASUREMENT:IMMED:DELAY:EDGE1? returns either RISE or FALL.
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 Information on how measurements are derived:. AMPlitude is the high value minus the low value.
Command Descriptions NOVershoot is the negative overshoot, expressed as: NOVershoot = 100 × − Minimum) Ꮛ(LowAmplitude Ꮠ 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. PERIod is the time, in seconds, it takes for one complete signal cycle to happen. PHAse is the phase difference from the selected waveform to the designated waveform.
Command Descriptions MEASUrement:IMMed:UNIts? (Query Only) Returns the units for the immediate measurement. Group Measurement Syntax MEASUrement:IMMed:UNIts? Returns Examples Related Commands 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 ” ” for non-dimensional units.
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.
Command Descriptions MEASUrement:INDICators:NUMVERT? (Query Only) Returns the number of vertical measurement indicators currently being displayed. 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.
Command Descriptions MEASUrement:INDICators:VERT? (Query Only) Returns the value of the specified vertical measurement indicator from the trigger point, where 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 MEASUrement:INDICators:VERT? Examples MEASUREMENT:INDICATORS:VERT2? might return :MEASUREMENT:INDICATORS:VERT2 -3.
Command Descriptions Syntax Returns Examples MEASUrement:MEAS:COUNt? MEASUREMENT:MEAS1:COUNT? might return: :MEASU:MEAS1:COUN 3.247000000E+3 MEASUrement:MEAS:DATa? (Query Only) Returns the measurement result and qualifier for the measurement specified by . Returns both the measurement result and the status of the result. Group Measurement Syntax MEASUrement:MEAS:DATa? , Arguments is the measurement result.
Command Descriptions Examples MEASUREMENT:MEAS3:DELAY? might return :MEASUREMENT:MEAS3:DELAY:EDGE1 RISE; EDGE2 RISE;DIRECTION FORWARDS. MEASUrement:MEAS: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:SOURCE2. This command is equivalent to setting the direction in the Delay Edges and Direction side menu items.
Command Descriptions Syntax MEASUrement:MEAS:DELay:EDGE1 { FALL | RISe } MEASUrement:MEAS: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.
Command Descriptions MEASUrement:MEAS:MAXimum? (Query Only) (Requires TDSAAM) Returns the maximum value found for the specified measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS:MAXimum? Returns Examples MEASUREMENT:MEAS1:MAXIMUM? might return: :MEASU:MEAS3:MAX 4.18E-9 MEASUrement:MEAS:MEAN? (Query Only) (Requires TDSAAM) Returns the mean value accumulated for the specified measurement since the last statistical reset.
Command Descriptions MEASUrement:MEAS:MINImum? (Query Only) (Requires TDSAAM) Returns the minimum value found for the specified measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS:MINImum? Returns Examples MEASUREMENT:MEAS1:MIN? might return: :MEASU:MEAS1:MINI 1.75E-9 MEASUrement:MEAS:SOURCE[1] Sets or returns the source for all single channel measurements. SOUrce is equivalent to SOURCE1.
Command Descriptions MEASUrement:MEAS: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 MEASUrement:MEAS:SOURCE2 { CH | MATH | REF } MEASUrement:MEAS:SOURCE2? Arguments CH is an input channel. MATH is the math waveform. REF is a reference waveform.
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:STDdev? (Query Only) (Requires TDSAAM) Returns the standard deviation of values accumulated for this measurement since the last statistical reset. Group Measurement Syntax MEASUrement:MEAS:STDdev? Returns Examples MEASUREMENT:MEAS1:STDDEV? might return: :MEASU:MEAS1:STD 21.
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. CMEan is the arithmetic mean over one cycle. CRMs is the true Root Mean Square voltage over one cycle. DELay is the delay from one waveform’s edge event to another.
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: POVershoot = 100 × − High) Ꮛ(Maximum Ꮠ Amplitude PWIdth is the distance (time) between MidRef (usually 50%) amplitude points of a positive pulse. RISe is the time that it takes for the leading edge of a pulse to rise from a low reference value to a high reference value of its final value.
Command Descriptions MEASUrement:MEAS:VALue? (Query Only) Returns the value that has been calculated for the measurement specified by . NOTE. This value is a display value and is updated on the oscilloscope screen approximately every 1/3 second. Group Measurement Syntax MEASUrement:MEAS:VALue? Examples Related Commands MEASUREMENT:MEAS1:VALUE? might return MEASUREMENT:MEAS1:VALUE 3.742E-6, indicating the measurement value displayed at the time the command was executed.
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.
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 MEASUrement:REFLevel:ABSolute:LOW? Arguments Examples is the low reference level, in volts. The default is 0.0 V.
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: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:MID2 MEASUrement:REFLevel:ABSolute:MID2? Arguments is the mid reference level, in volts. The default is 0.0 V.
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.
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. This command is equivalent to setting the relevant Reference Levels in the MEASURE menu.
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.
Command Descriptions MEASUrement:STATIstics:WEIghting (Requires TDSAAM) Controls the responsiveness of mean and standard deviation to waveform changes. Group Measurement Syntax MEASUrement:STATIstics:WEIghting MEASUrement:STATIstics:WEIghting? Arguments Examples is the time constant for the mean and standard deviation statistical accumulations. MEASUREMENT:STATISTICS:WEIGHTING 4 sets the weighting to 4. MESSage:BOX Defines the size and position of the message window.
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.
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. For example, to tab to pixel 13, send TAB (\t or \x09), NUL (decimal 0), and CR (decimal 13).
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. H Bit 3 If set, the background color is set to the default background color. H Bit 2 undefined H Bit 1 undefined H Bit 0 undefined The ESC (escape) character followed by the @ character turns inverse video on or off and can be embedded in the message string.
Command Descriptions An alternate way to enter certain characters is with a backslash followed by a single character (following “standard” Unix) as follows: H n newline (carriage return and linefeed) H \ backslash (\\ is required to get a backslash character) H j Japanese character encoding, the next two characters make one hexadecimal JIS value as explained later H t horizontal tab; the next 2 characters specify the pixel column to tab to as explained earlier H u Unicode encoding, the next t
Command Descriptions Examples MESSAGE:SHOW ”Hello world” displays “Hello world” in the upper left corner of the box (you can define the box size with the MESSAGE BOX command). MESSAGE:SHOW ”Hello a@worlda@ ... hello” displays “Hello world ... hello” in the upper left corner of the box and the word “world” is displayed in inverse video. In this example, a stands for the escape character. The escape character may appear differently for you depending on your controller program.
Command Descriptions MESSage:STATE Controls the display of the message window. Group Display Syntax MESSage:STATE { OFF | ON | } MESSage:STATE? Arguments or = 0 removes the message window from the display. or ¸ 0 displays the message window and its contents on the display. Related Commands MESSage:BOX, MESSage:SHOW NEWpass (No Query Form) Changes the password that enables access to password protected data.
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.
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 successfully 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.
Command Descriptions *PSC Sets and queries the power-on status flag that controls the automatic power-on handling of the DESER, SRER, and ESER registers. When *PSC is true, the DESER register is set to 255 and the SRER and ESER registers are set to 0 at power-on. When *PSC is false, the current values in the DESER, SRER, and ESER registers are preserved in nonvolatile memory when power is shut off and are restored at power-on. For a complete discussion of the use of these registers, see page 3--1.
Command Descriptions Arguments = 0 indicates the oscilloscope is being powered by battery. = 1 indicates the oscilloscope is being powered by AC. Examples Related Commands POWER:AC:PRESENT? might return :POWER:AC:PRESENT 1. 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.
Command Descriptions Arguments Examples Related Commands 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 POWER:BATTERY:GASGAUGE? might return :POWER:BATTERY:GASGAUGE 15. POWer:BATTERY:PRESENT? POWer:BATTery:PRESENt? (Query Only) Indicates if there is a battery in the instrument.
Command Descriptions Arguments = 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. Examples POWER:SHUTDOWN 5 Instrument will power off after the oscilloscope has been idle for 5 minutes. *PUD Sets or returns a string of Protected User Data.
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. (The settings are stored using the *SAV command.) This command is equivalent to RECAll:SETUp and performs the same function as the Recall Saved Setup item in the SAVE/RECALL menu.
Command Descriptions Arguments Examples Related Commands 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. RECAll:MASK ”fd0:\custome2.msk” loads the file custome2.msk from the floppy drive into the User mask. SAVe:MASK RECAll:SETUp (No Query Form) Restores a stored or factory front-panel setup of the oscilloscope.
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) Recalls a stored waveform into a reference location.
Command Descriptions REF: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:DATE? Examples REF4:DATE? might return “09-10-99” in the form mm-dd-yy. REF: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.
Command Descriptions Syntax REF:HORizontal:SCAle REF:HORizontal:SCAle? Arguments Examples 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. REF1:HORIZONTAL:SCALE? might return REF1:HORIZONTAL:SCALE 4.0E-4 REF:LABEL Sets or returns the specified reference waveform label.
Command Descriptions REF:VERTical:POSition Sets the reference waveform vertical display position in vertical divisions; equivalent to adjusting the Vertical POSITION knob when REF is the selected waveform. Group Waveform Syntax REF:VERTical:POSition REF:VERTical:POSition? Arguments Examples is the reference waveform’s display vertical position. REF2:VERTICAL:POSITION 1.0 sets the vertical position for the Ref2 waveform to +1 division.
Command Descriptions REM (No Query Form) Specifies a comment. This line is ignored by the instrument. Group Miscellaneous Syntax REM Arguments Examples is a string that can have a maximum of 255 characters. REM ”This is a comment” is ignored by the instrument. *RST (No Query Form) *RST returns the instrument settings to the factory defaults (see Appendix D: Factory Initialization Settings).
Command Descriptions RS232? (Query Only) Returns the RS232 settings. Group RS232 Syntax RS232? Arguments Examples None RS232? might return: :RS232:BAUD 38400;TRANSMIT:TERMINATOR LF;HARDFLAGGING: ON. RS232:BAUd Sets or returns RS-232 interface transmission speed. Group RS232 Syntax RS232:BAUd RS232:BAUd? Arguments Examples is a rate of 1200, 2400, 4800, 9600, 19200, or 38400 baud. RS232:BAUD 9600 sets the transmission rate to 9600 baud.
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. When CTS is not asserted, the oscilloscope stops transmitting data. On input, it asserts RTS until the receive queue is full. Then it unasserts RTS to stop transmission from an external printer.
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.
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. Group Save and Recall Syntax *SAV Arguments Examples Related Commands is a value in the range from 1 to 10 and specifies a location.
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 { | } Arguments is a value in the range from 1 to 10 and specifies a location. Any settings that have been stored previously at this location will be overwritten.
Command Descriptions Arguments is CH, MATH, or REF, and is the waveform that will be saved. REF is the location where the waveform will be stored. is a quoted string that defines the file name and path. Input the file path using the form //. and one or more s are optional. If you do not specify them, the oscilloscope will write the file to the current directory. stands for a filename of up to 8 characters followed by a period (“.
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). MATHCad specifies the MathCad format. MathCad format files should have a .DAT extension.
Command Descriptions SELect:CONTROl Sets or queries the waveform that is currently affected by the cursor and vertical commands. Group Vertical Syntax SELect:CONTROl SELect:CONTROl? Arguments Returns is CH, MATH, or REF, and will be the selected waveform. NONE if all waveforms are off. NONE is ignored on input. CH, MATH, or REF if it is the waveform affected by the cursor and vertical commands.
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. You can use this string to return the oscilloscope to the state it was in when you made the SET? query. This command is identical to the *LRN? command.
Command Descriptions SETUp:DATE? (Query Only) Sets or returns the date when the specified instrument setup was saved. Group Waveform Syntax SETUp:DATE? Examples SETUP4:DATE? might return SETUP4:DATE ”04-18-01”. SETUp:LABEL Sets or returns the specified instrument setup label. See the MESSage:SHOW command for information on how to enter non-English characters.
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 *SRE? Arguments Examples is a value in the range from 0 to 255. The binary bits of the SRER are set according to this value. Using an out-of-range value causes an execution error. The power-on default for SRER is 0 if *PSC is 1.
Command Descriptions Examples Related Commands *STB? might return the value 96, showing that the SBR contains the binary value 01100000. *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. Group Miscellaneous Syntax SYStem { APPS | CALibrate | CONFIG | DIAg | HARDCopy | IO } SYStem? Arguments Examples The arguments correspond to the UTILITY menu System menu items.
Command Descriptions TIMe Sets or queries the current time Group Miscellaneous Syntax TIMe TIMe? Arguments Examples Related Commands 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. There must be a colon after the hh and after the mm. Use two digits for each of the hh, mm, and ss. TIME ”01:24:00” sets the time to 01:24 AM.
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.
Command Descriptions Arguments ALTernating sets the trigger source to alternate between each displayed input channel. CH sets the trigger source to the specified input channel, where is 1, 2, 3, or 4. EXT sets the 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 trigger source to the reduced external trigger with a signal input range of --8 V to +8 V.
Command Descriptions Examples Related Commands TRIGger:A:COMMunication:STANdard E2 sets the A trigger parameters to those required to test E2 waveforms. 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 Sets or queries the type of coupling for the A edge trigger.
Command Descriptions TRIGger:A:EDGe:SLOpe Selects a rising or falling slope for the A edge trigger. This is equivalent to setting Slope in the Trigger menu. Group Trigger Syntax TRIGger:A:EDGe:SLOpe { FALL | RISe } TRIGger:A:EDGe:SLOpe? Arguments FALL specifies to trigger on the falling or negative edge of a signal. RISE specifies to trigger on the rising or positive edge of a signal. Examples TRIGGER:A:EDGE:SLOPE RISE sets the A edge trigger to occur on the rising slope.
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. TRIGGER:A:EDGE:SOURCE? might return :TRIGGER:A:EDGE:SOURCE CH2 for the A edge trigger source. TRIGger:A:HOLdoff? (Query Only) Returns the A trigger holdoff time.
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 TRIGger:A:HOLdoff:VALue? Arguments Examples from 0 to 100 and is a percent of the holdoff range. TRIGGER:A:HOLDOFF:VALUE 50 to set the holdoff value to 50% of record. TRIGger:A:LEVel Sets the A trigger level.
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.
Command Descriptions Syntax TRIGger:A:LOGIc:INPUT:LOGICLevel { HIGH | LOW } TRIGger:A:LOGIc:INPUT:LOGICLevel? Arguments 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. LOW sets the input logic level to low.
Command Descriptions TRIGger:A:LOGIc:INPUT:SOUrce Sets or returns the input signal source for the pattern trigger, which requires two input signal sources.
Command Descriptions 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. TRIGger:A:LOGIc:PATtern:DELTATime Sets or returns the pattern trigger time value.
Command Descriptions Syntax TRIGger:A:LOGIc:PATtern:FUNCtion { AND | NANd | NOR | OR } TRIGger:A:LOGIc:PATtern:FUNCtion? Arguments Examples AND, NANd, NOR, OR set the Boolean logic operation to apply to the logic pattern trigger inputs. 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.
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 TRIGger:A:LOGIc:STATE:WHEn { TRUe | FALSe } TRIGger:A:LOGIc:STATE:WHEn? Arguments TRUe triggers the oscilloscope if the state signal is true when the clock signal slope is true.
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;:TRIGGER: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.
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.
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 TRIGger:A:PULse:RUNT:THReshold:BOTh { TTL | ECL } Arguments TTL sets the upper (high) threshold value to 2.
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 TRIGger:A:PULse:RUNT:THReshold:LOW? Arguments Examples is a floating point value with exponent that sets the runt pulse low threshold voltage value. TRIGGER:A:PULSE:RUNT:THRESHOLD:LOW -700.
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. TRIGger:A:PULse:RUNT:WIDth Sets or returns the runt pulse width time period value.
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).
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.
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 TRIGger:A:PULse:SLEWRate:THReshold:HIGH? Arguments Examples is a floating point value with exponent that sets the slew rate trigger signal high threshold voltage value. TRIGGER:A:PULSE:SLEWRATE:THRESHOLD:HIGH 4.1E0 sets the slew rate high threshold voltage value to 4.1 volts.
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:SLEWRate:THReshold commands.
Command Descriptions Syntax TRIGger:A:PULse:SOUrce { EXT | EXT10 | VERTical | CH | LINE | ALTernating } TRIGger:A:PULse:SOUrce? Arguments 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-channel 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.
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.
Command Descriptions Arguments 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. Examples TRIGGER:A:PULSE:WIDTH:WIDTH? might return TRIGGER:A:PULSE:WIDTH:WHEN MORETHAN;WIDTH 0.0000011880. TRIGger:A:SETLevel (Set Only) Sets the trigger level to 50%.
Command Descriptions Arguments COMMunication sets the A trigger parameters for communications (mask) testing. TDS3TMT only. EDGe sets the oscilloscope to trigger when a signal passes through a single specified voltage level in a specified direction (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.
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.
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. FIELD1 specifies interlaced video field 1. Same as odd. FIELD2 specifies interlaced video field 2. Same as even.
Command Descriptions Table 2- 40: HDTV formats (cont.) Examples 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 TRIGGER:A:VIDEO:HDTV:FORMAT? might return TRIGGER:A:VIDEO:HDTV:FORMAT 1080I60.
Command Descriptions Syntax TRIGger:A:VIDeo:LINE TRIGger:A:VIDeo:LINE? Arguments is an integer number that sets the video line number on which to trigger.
Command Descriptions Arguments RATE1 sets the video line scan rate range to 15-20 kHz. This is the standard broadcast rate. RATE2 sets the video line scan rate range to 20-25 kHz. RATE3 sets the video line scan rate range to 25-35 kHz. RATE4 sets the video line scan rate range to 35-50 kHz. RATE5 sets the video line scan rate range to 50-65 kHz. Examples TRIGGER:A:VIDEO:SCAN RATE2 sets the video line scan range to 20-25 kHz. TRIGger:A:VIDeo:SOUrce Sets or queries the source for the A video trigger.
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. TRIGger:A:VIDeo:STANdard Sets or queries the video trigger standard.
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 Examples SETLevel sets the B trigger voltage level to 50% of the source peak-to-peak signal. TRIGGER:B? might return :TRIGGER:B:STATE 0;BY TIME;EVENTS:COUNT 1;: TRIGGER:B:TIME 1.32E-8;LEVEL 1.
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.
Command Descriptions TRIGger:B:EDGe:SLOpe Selects a rising or falling slope for the B edge trigger. This is equivalent to setting Slope in the Trigger menu. Group Trigger Syntax TRIGger:B:EDGe:SLOpe { FALL | RISe } TRIGger:B:EDGe:SLOpe? Arguments FALL specifies to trigger on the falling or negative edge of a signal. RISE specifies to trigger on the rising or positive edge of a signal. Examples TRIGGER:B:EDGE:SLOPE RISE sets the B edge trigger to occur on the rising slope.
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? Examples TRIGGER:B:EVENTS? might return 14 indicating the B trigger occurs on the 14th occurance of a B trigger event, after the A trigger occurs.
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 | } TRIGger:B:LEVel? Arguments ECL specifies a preset ECL level of --1.3 V. TTL specifies a preset TTL level of 1.4 V. is the B trigger level, in volts. Examples TRIGGER:B:LEVEL? might return 1.4, indicating that the B edge trigger is set to 1.4 V. TRIGGER:B:LEVEL 0.
Command Descriptions TRIGger:B:STATE Sets the B trigger level state to on or off. Group Trigger Syntax TRIGger:B:STATE { | ON | OFF } Arguments 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 Sets or queries the B trigger delay time when TRIG:B:BY is set to Time. Group Trigger Syntax TRIGger:B:TIMe TRIGger:B:TIMe? Arguments Examples is the B trigger delay time, in seconds.
Command Descriptions Syntax TRIGger:B:TYPe { EDGE } TRIGger:B:TYPe? Arguments Examples EDGE is a normal trigger. A B trigger event occurs when a signal passes through a specified voltage level in a specified direction and is controlled by the TRIGger:B:EDGE commands. TRIGGER:B:TYPE? returns :TRIGGER:B:TYPE EDGE indicating that the B trigger type is a edge trigger.
Command Descriptions Arguments Examples 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. 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.
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.
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. READY indicates that all pretrigger information has been acquired and the oscilloscope is ready to accept a trigger.
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 Related Commands *TRG immediately executes all commands that have been defined by *DDT. Alias commands, *DDT *TST? (Query Only) (Self-Test) Tests the GPIB interface and returns a 0. Group Miscellaneous Syntax *TST? Returns and is always 0.
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. Group Miscellaneous Syntax UNLock ALL Arguments Related Commands ALL specifies all front-panel buttons and knobs.
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. This command allows you to synchronize the operation of the oscilloscope with your application program. Synchronization methods are described on page 3--7.
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 | } WAVEAlert:BEEP? Arguments OFF or = 0 turns off the beep when a new waveform is significantly different. ON or ¸ 0 turns on the beep. Returns Examples Either 0 or 1 corresponding to beep OFF or ON.
Command Descriptions Arguments ON or ¸ 0 turns on the hardcopy operation for the waveform when a new waveform is significantly different. OFF or = 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. WAVEALERT:HARDCOPY? returns either 0 or 1, indicating whether the hardcopy operation occurs when a new waveform data varies significantly from previous waveforms.
Command Descriptions WAVEAlert:SENSitivity (TDS3000B Series and TDS3000C Series) Sets or returns the WaveAlert anomaly detection sensitivity parameter. Group Acquisition Syntax WAVEAlert:SENSitivity { } WAVEAlert:SENSitivity? Arguments 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%.
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. ON or 1 turns on the stop on violation mode.
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).
Command Descriptions Arguments is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8 and DATa:WIDth * 8. Examples Related Commands WFMPRE:BIT_NR? might return 8, indicating that there are 8 bits per waveform point. DATa:WIDth, WFMPre:BYT_Nr WFMPre:BN_Fmt Sets or queries the format of binary data for the waveform to be transferred. Changing the value of WFMPre:BN_Fmt also changes the value of DATa:ENCdg.
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 WFMPre:BYT_Nr? Arguments Examples Related Commands is an integer in the range of 1 to 2 that sets the number of bytes per point. WFMPRE:BYT_NR 2 specifies that there are 2 bytes per waveform data point.
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. Changing WFMPre:ENCdg also changes DATa:ENCdg.
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. The number of points is the greater of the absolute value of (DATa:STOP -- DATA:STARt) +1, or the record length of the source waveform specified by DATA:SOUrce.
Command Descriptions Arguments Y specifies a normal waveform where one ASCII or binary data point is transmitted for each point in the waveform record. Only y values are explicitly transmitted. Absolute coordinates are given by: X n = XZEro + XINcr (n–PT_Off) Y n = YZEro + YMUlt (y n − YOFf) ENV specifies that the oscilloscope transmit the waveform as minimum and maximum point pairs. Peak detect and envelope waveforms use an ENV format. Only y values are explicitly transmitted.
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). Group Waveform Syntax WFMPre:WFId? Arguments Examples None. WFMPRE:WFId? YT waveform: :WFMPRE:WFID ”Ch1, DC coupling, 1.0E-1 V/div, 4.
Command Descriptions Syntax WFMPre:XINcr WFMPre:XINcr? Arguments Related Commands is the sampling interval in seconds or Hertz per point. WFMPre::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” or “Hz”, event 224 (illegal parameter value) is generated.
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 command. 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. 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). NOTE.
Command Descriptions Syntax WFMPre:YMUlt WFMPre:YMUlt? Arguments Related Commands is the vertical scale factor, in YUNits (usually volts) per data point level. WFMPre:YUNit WFMPre:YOFf YOFf specifies the vertical position of a waveform.
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:YUNit that is inconsistent (for example, seconds with dB or Hertz with volts). The oscilloscope will not warn you of this condition. The oscilloscope uses WFMPre:XUNit to determine if the waveform is YT or FFT.
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 The set form of this command stores a value for the reference waveform specified by the DATa:DESTination command.
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.
Command Descriptions Returns The format of the response is: :WFMPre::WFID ;PT_FMT { ENV | Y }; NR_Pt ;XINcr ;PT_Off ;XZEro ;XUNit ; YMUlt ;YZEro ;YOFf ;YUNit Example Related Commands 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.
Command Descriptions Examples Related Commands WFMPre::NR_Pt? returns the number of waveform points in the next CURVE query. DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt WFMPre::PT_Fmt Same as WFMPre:PT_Fmt, with the exception that specifies the source/destination waveform instead of DATA:SOURCE and DATA:DESTINATION. WFMPre::PT_Off Same as WFMPre:PT_Off, with the exception that specifies the source/destination waveform instead of DATA:SOURCE and DATA:DESTINATION.
Command Descriptions WFMPre::YMUlt Same as WFMPre:YMUlt, with the exception that specifies the source/destination waveform instead of DATA:SOURCE and DATA:DESTINATION. WFMPre::YOFf Same as WFMPre:YOFf, with the exception that specifies the source/ destination waveform instead of DATA:SOURCE and DATA:DESTINATION. WFMPre::YUNit Same as WFMPre:YUNit, with the exception that specifies the source/ destination waveform instead of DATA:SOURCE and DATA:DESTINATION.
Command Descriptions ZOOm:HORizontal:SCAle Sets or queries the horizontal scale when in zoom. Group Horizontal Syntax ZOOm:HORizontal:SCAle ZOOm:HORizontal:SCAle? Arguments Examples is the horizontal scale in seconds. ZOOm:HORizontal:SCAle might return :ZOOM:HORIZONTAL:SCALE 1.0E0 ZOOm:STATE Sets or queries the zoom state mode. Group Horizontal Syntax ZOOm:STATE { < NR1> | ON | OFF } ZOOm:STATE? Arguments or < NR1> = 0 turns off zoom. or < NR1> = 1 turns on zoom.
Status and Events TDS3000B and TDS3000C Series oscilloscopes provide a status and event 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. This section describes these registers and components. It also explains how the event handling system operates.
Status and Events Table 3- 1: SESR bit functions Bit Function 7 (MSB) PON (Power On). Shows that the oscilloscope was powered on. 6 URQ (User Request). Not used. 5 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. 4 EXE (Execution Error). Shows that an error occurred while the oscilloscope was executing a command or query.
Status and Events Table 3- 2: SBR bit functions Enable Registers Bit Function 7 (MSB) Not used. 6 RQS (Request Service), obtained from a serial poll. Shows that the oscilloscope requests service from the GPIB controller. 6 MSS (Master Status Summary), obtained from *STB? query. Summarizes the ESB and MAV bits in the SBR. 5 ESB (Event Status Bit). Shows that status is enabled and present in the SESR. 4 MAV (Message Available). Shows that output is available in the Output Queue. 3-0 Not used.
Status and Events 7 6 5 4 3 2 1 0 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. Use the *SRE command to set the SRER. Use the *SRE? query to read it.
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 . The controller must read a query response before it sends the next command (or query) or it will lose responses to earlier queries. WARNING.
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.
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). Synchronization Methods Although most remote interface commands are completed almost immediately after being received by the oscilloscope, some commands start a process that requires more time.
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.
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.
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. Use the *OPC command to guarantee all previous commands have been processed and are applied to all dependent waveform operations. Serial Poll Method (GPIB only).
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” ACQUIRE:STATE ON REM “Set up the measurement parameters” MEASUREMENT:IMMED:TYPE AMPLITUDE MEASUREMENT:IMMED:SOURCE CH1 REM “Wait until the acquisition is complete before taking the measurement”
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.
Status and Events Table 3- 4: Command error messages - CME Bit 5 (Cont.
Status and Events Table 3- 4: Command error messages - CME Bit 5 (Cont.) Code Message 181 Invalid outside alias definition 183 Invalid inside alias definition 184 Command in alias requires more/fewer parameters Table 3--5 lists the execution errors that are detected during execution of a command.
Status and Events Table 3- 5: Execution error messages - EXE Bit 4 (Cont.
Status and Events Table 3- 5: Execution error messages - EXE Bit 4 (Cont.
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 2301 Cursor error, Off-screen 2302 Cursor error, cursors are off 2303 Cursor error, Cursor source waveform is off Table 3--6 lists the device errors that can occur during oscilloscope operation.
Status and Events Table 3--7 lists the system event messages. These messages are generated whenever certain system conditions occur.
Status and Events Table 3- 8: Execution warning messages - EXE Bit 4 (Cont.) Code Message 545 Measurement warning, Invalid in minmax 546 Measurement warning, Need 3 edges 547 Measurement warning, Clipping positive/negative 548 Measurement warning, Clipping positive 549 Measurement warning, Clipping negative Table 3--9 shows internal errors that indicate an internal fault in the oscilloscope.
Status and Events 3- 20 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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.
Appendix A: Character Charts Table A- 1: Character Set (Cont.
Appendix A: Character Charts Table A- 2: ASCII & GPIB Code Chart 0 B7 B6 0 0 0 B5 BITS B4 B3 B2 B1 0 NUL 1 0 10 GTL 21 SOH 1 2 0 0 1 0 2 3 4 2 ETX 5 13 SDC 24 4 14 PPC 25 5 15 EOT ENQ 6 0 1 1 0 6 7 ACK 8 BEL BS 11 1 0 0 1 9 6 A HT 17 GET 30 8 18 TCT 31 9 B LF 10 C 11 D FF 12 E 13 F 19 1A 1B 1C 1D SO 14 1E 18 15 ADDRESSED COMMANDS 1F SP ! 22 ” 43 DC3 19 23 DCL 44 20 24 PPU 45 DC4 NAK 21 25 # $ % 46 SYN 22 26 47
Appendix A: Character Charts KEY A- 4 octal 5 hex 5 PPC ENQ 5 GPIB code (with ATN asserted) ASCII character decimal Tektronix REF: ANSI STD X3.4-1977 IEEE STD 488.
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.
Appendix A: Reserved Words ENCdg ENET ENETADDress ENGLish ENTire ENVelope EPSColor EPSMono EPSOn EQual ERRLOG ERROR ERRORChecking ETHERnet EVEN EVENT EVENTS EVMsg EVQty EXECute EXT EXT10 EXTERnal F525 F625 FACTACQ FACTTRIG FACTVERT FACtory FAIL FAILURES FAILUre FALL FALSe FASTERthan FCALUPtime FFT FIELD FIELD1 FIELD2 FIFty FILE FILEFormat FILEName FILESystem FIRST FIVEdivs B- 2 FLAg FLOPPYdisk FORCETRIG FORCe FORMat FORWards FPAnel FRAme FREESpace FRENch FREQuency FULl FUNCtion G703DS1 G703DS3 GASgauge G
Appendix A: Reserved Words PCXColor PDUTy PEAKdetect PERCent PERIod PERSistence PHAse PICture PING PK2pk PNG POINTS POINTSNorm POINTSPcnt POLARCoord POLarity PORT PORTRait PORTUguese POSITION1 POSITION2 POSITIVe POSition POVershoot POWer PPORT PRESAMPBITS PRESENt PRESET PRESS PREVIEW PREVious PRInt PRODDELta PRODUCT PRODUCT1 PRODUCT2 PROGressive PRObe PT_Fmt PT_Off PULse PWIdth QUICKmenu RADIUS1 RADIUS2 RATDELta RATE1 RATE2 RATE3 RATE32MBIT RATE4 RATE5 TATIO RATIO1 RATIO2 RSELta READ READOUT REBOOT RECAll
Appendix A: Reserved Words VERT3 VERT4 VERTPOS VERTSCALE VERTical VFields VGA VIDeo VIOLATIONS VLines VOFFSet B- 4 VOLts VPOS VSCAle WAVEAlert WAVEform WAVEFORMS WAVFrm WEIghting WFId WFMPre WHEn WIDth WINdow WRITE XDELta XINcr XMUlt XOFf XPOSITION1 XPOSITION2 XUNit XY XZEro Y YC YCHannel YDELta YEARs YMUlt YOFf YPBPR YPOSITION1 YPOSOTION2 YREF YT YUNit YZEro ZCHannel ZLEVel ZMUlt ZOFf ZOOm ZUNit ZZEro TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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. Some of the listings describe subsets that the oscilloscope does not support. H SH1 (Source Handshake).
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. Interface Messages Table C--1 shows the standard interface messages supported by the TDS3000, TDS3000B, and TDS3000C Series oscilloscopes.
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.
Appendix D: Factory Initialization Settings Table D- 1: Factory initialization settings (Cont.
Appendix D: Factory Initialization Settings Table D- 1: Factory initialization settings (Cont.
Appendix D: Factory Initialization Settings D- 4 TDS3000, TDS3000B, and TDS3000C Series Programmer Manual
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. Backus-Naur Form (BNF) A standard notation system for command syntax diagrams. The syntax diagrams in this manual use BNF notation.
Glossary GPIB Acronym for General Purpose Interface Bus, the common name for the communications interface system defined in IEEE Std 488. IEEE Acronym for the Institute for Electrical and Electronic Engineers. JIS Japanese Industrial Standard is an encoding scheme which assigns a unique hexadecimal value to each Japanese character. QuickBASIC A computer language (distributed by Microsoft) that is based on the Beginner’s All-Purpose Symbolic Instruction Code.
Index A B Abbreviating, command, 2-- 4 ACQUIRE?, 2-- 45 ACQUIRE:MODE, 2-- 45 ACQUIRE:NUMACQ?, 2-- 46 ACQUIRE:NUMAVG, 2-- 47 ACQUIRE:NUMENV, 2-- 47 ACQUIRE:STATE, 2-- 48 ACQUIRE:STOPAFTER, 2-- 49 Acquisition command group, 2-- 11 Acquisition commands ACQUIRE?, 2-- 45 ACQUIRE:MODE, 2-- 45 ACQUIRE:NUMACQ?, 2-- 46 ACQUIRE:NUMAVG, 2-- 47 ACQUIRE:NUMENV, 2-- 47 ACQUIRE:STATE, 2-- 48 ACQUIRE:STOPAFTER, 2-- 49 AUTOSET, 2-- 54 WAVEALERT:BEEP, 2-- 310 WAVEALERT:HARDCOPY, 2-- 310 WAVEALERT:SAVEWFM, 2-- 311 WAVEALERT
Index CH:ID?, 2-- 65 CH:IMPEDANCE, 2-- 66 CH:INVERT, 2-- 66 CH:OFFSET, 2-- 67 CH:POSITION, 2-- 68 CH:PROBE, 2-- 68 CH:SCALE, 2-- 69 CH:VOLTS, 2-- 70 CH:YUNIT, 2-- 70 Channel, command mnemonic, 2-- 7 checking RS-232 command status, 1-- 24 CH, command mnemonic, 2-- 7 Clear Status, 2-- 71 CLEARMENU, 2-- 71 *CLS, 2-- 71 Command Abbreviating, 2-- 4 Argument, 2-- 2 Block argument, 2-- 10 Common, 2-- 30, 2-- 33 Concatenating, 2-- 4 Header, 2-- 2 Message, 2-- 2 Mnemonic, 2-- 2 Query,
Index CURSOR:VBARS:USE, 2-- 81 CURSOR:VBARS:VDELTA?, 2-- 82 CURSOR:WAVEFORM?, 2-- 82 CURSOR:WAVEFORM:SELECT, 2-- 83 CURSOR:XY:PRODDELTA?, 2-- 83 CURSOR:XY:PRODUCT?, 2-- 84 CURSOR:XY:RADIUS?, 2-- 84 CURSOR:XY:RATDELTA?, 2-- 85 CURSOR:XY:RATIO?, 2-- 85 CURSOR:XY:RDELTA?, 2-- 86 CURSOR:XY:READOUT, 2-- 86 CURSOR:XY:RECTX?, 2-- 87 CURSOR:XY:RECTY?, 2-- 87 CURSOR:XY:THDELTA?, 2-- 88 CURSOR:XY:THETA?, 2-- 88 CURSOR:XY:XDELTA?, 2-- 89 CURSOR:XY:YDELTA?, 2-- 89 Cursor position, command mnemonic, 2
Index MESSAGE:BOX, 2-- 233 MESSAGE:CLEAR, 2-- 234 MESSAGE:SHOW, 2-- 234 MESSAGE:STATE, 2-- 239 DISPLAY?, 2-- 102 DISPLAY:CLOCK, 2-- 103 DISPLAY:COLOR:PALETTE:REGULAR, 2-- 103 DISPLAY:FORMAT, 2-- 104 DISPLAY:GRATICULE, 2-- 105 DISPLAY:INTENSITY:BACKLIGHT, 2-- 106 DISPLAY:INTENSITY:WAVEFORM, 2-- 106 DISPLAY:PERSISTENCE, 2-- 106 DISPLAY:PERSISTENCE:CLEAR, 2-- 107 DISPLAY:PICTURE:AUTOCONTRAST, 2-- 108 DISPLAY:PICTURE:BRIGHTNESS, 2-- 108 DISPLAY:PICTURE:CONTRAST, 2-- 109 DISPLAY:PICTURE:STATE, 2-- 109 DISPLAY:S
Index File system command group, 2-- 18 File system commands FILESYSTEM:COPY, 2-- 128 FILESYSTEM:CWD, 2-- 129 FILESYSTEM:DELETE, 2-- 129 FILESYSTEM:DELWARN, 2-- 130 FILESYSTEM:DIR?, 2-- 130 FILESYSTEM:FORMAT, 2-- 131 FILESYSTEM:FREESPACE, 2-- 131 FILESYSTEM:MKDIR, 2-- 131 FILESYSTEM:OVERWRITE, 2-- 132 FILESYSTEM:PRINT, 2-- 133 FILESYSTEM:RENAME, 2-- 133 FILESYSTEM:RMDIR, 2-- 134 FILESYSTEM?, 2-- 127 FILESYSTEM:COPY, 2-- 128 FILESYSTEM:CWD, 2-- 129 FILESYSTEM:DELETE, 2-- 129 FILESYSTEM:DELWARN, 2-- 130 FILE
Index I LIMIT:TEMPLATE:TOLERANCE: VERTICAL, 2-- 162 LIMIT:TEMPLATE:TOLERANCE:HORIZONTAL, 2-- 161 LLO, C-- 2 Local lock out, C-- 2 LOCK, 2-- 163 Logic trigger, 2-- 272, 2-- 289 *LRN?, 2-- 164 ID?, 2-- 149 *IDN?, 2-- 149 IEEE, Glossary-- 2 IEEE Std 488.
Index MASK:STOPONVIOLATION, 2-- 186 MASK:TEST:BEEP:COMPLETION, 2-- 187 MASK:TEST:BEEP:FAILURE, 2-- 187 MASK:TEST:DELAY, 2-- 188 MASK:TEST:HARDCOPY, 2-- 188 MASK:TEST:REPEAT, 2-- 189 MASK:TEST:SAVEWFM, 2-- 190 MASK:TEST:STATE, 2-- 191 MASK:TEST:STATUS?, 2-- 191 MASK:TEST:THRESHOLD, 2-- 192 MASK:TEST:WAVEFORM, 2-- 192 MASK:USER:MASK DELETE, 2-- 193 MASK:USER:MASK:NR_PT?, 2-- 193 MASK:USER:MASK:POINTS, 2-- 194 MASK:USER:MASK:POINTSNORM, 2-- 194 MASK:USER:MASK:POINTSPCNT, 2-- 195 MASK:USER:MASKP
Index MEASUREMENT:IMMED:DELAY?, 2-- 208 MEASUREMENT:IMMED:DELAY:DIRECTION, 2-- 209 MEASUREMENT:IMMED:DELAY:EDGE, 2-- 209 MEASUREMENT:IMMED:SOURCE, 2-- 210 MEASUREMENT:IMMED:SOURCE1, 2-- 210 MEASUREMENT:IMMED:TYPE, 2-- 211 MEASUREMENT:IMMED:UNITS?, 2-- 213 MEASUREMENT:IMMED:VALUE?, 2-- 213 MEASUREMENT:INDICATORS?, 2-- 214 MEASUREMENT:INDICATORS:HORZ?, 2-- 214 MEASUREMENT:INDICATORS:NUMHORZ?, 2-- 214 MEASUREMENT:INDICATORS:NUMVERT?, 2-- 215 MEASUREMENT:INDICATORS:STATE, 2-- 215 MEASUREMENT:INDICATOR
Index MEASUREMENT:REFLEVEL?, 2-- 227 MEASUREMENT:REFLEVEL:ABSOLUTE:HIGH, 2-- 227 MEASUREMENT:REFLEVEL:ABSOLUTE:LOW, 2-- 228 MEASUREMENT:REFLEVEL:ABSOLUTE:MID, 2-- 228 MEASUREMENT:REFLEVEL:ABSOLUTE:MID2, 2-- 229 MEASUREMENT:REFLEVEL:METHOD, 2-- 229 MEASUREMENT:REFLEVEL:PERCENT:HIGH, 2-- 230 MEASUREMENT:REFLEVEL:PERCENT:LOW, 2-- 230 MEASUREMENT:REFLEVEL:PERCENT:MID, 2-- 231 MEASUREMENT:REFLEVEL:PERCENT:MID2, 2-- 231 MEASUREMENT:SNAPSHOT, 2-- 232 MEASUREMENT:STATISTICS:MODE, 2-- 232 MEASUREMENT:STATISTICS:WEI
Index Queue Event, 3-- 5 Output, 3-- 5 QuickBASIC, Glossary-- 2 QuickC, Glossary-- 2 Quoted string, command argument, 2-- 9 R *RCL, 2-- 246 Real-time sampling, Glossary-- 1 rear-panel connectors, 1-- 7 REBOOT, 2-- 246 Recall setting command, 2-- 246 RECALL:MASK, 2-- 246 RECALL:SETUP, 2-- 247 RECALL:WAVEFORM, 2-- 248 REF:DATE?, 2-- 249 REF:LABEL, 2-- 250 REF:VERTICAL:POSITION, 2-- 251 REF:VERTICAL:SCALE, 2-- 251 REFHORIZONTAL:POSITION, 2-- 249 REFHORIZONTAL:SCALE, 2-- 249 REFTIME?, 2--
Index Setting Command query, 2-- 164 Query, 2-- 164 Recall command, 2-- 246 RS-232 parameters, 1-- 22 Save command, 2-- 256 setting the user interface language, 2-- 154 Setup, communication module install, 1-- 6 SETUP:DATE?, 2-- 262 SETUP:LABEL, 2-- 262 SETUP:TIME?, 2-- 262 Slewrate trigger, 2-- 278 SPD, C-- 2 SPE, C-- 2 *SRE command, 2-- 263, 3-- 4 SRER register, 2-- 242, 2-- 263, 3-- 4 SRQ, 1-- 3 Status, 3-- 1 Status and error command group, 2-- 33 Status and error commands ALLEV?, 2-- 54 BUSY?,
Index TRIGGER:A:PULSE:CLASS, 2-- 278 TRIGGER:A:PULSE:RUNT?, 2-- 279 TRIGGER:A:PULSE:RUNT:POLARITY, 2-- 279 TRIGGER:A:PULSE:RUNT:THRESHOLD?, 2-- 279 TRIGGER:A:PULSE:RUNT:THRESHOLD:BOTH, 2-- 280 TRIGGER:A:PULSE:RUNT:THRESHOLD:HIGH, 2-- 280 TRIGGER:A:PULSE:RUNT:THRESHOLD:LOW, 2-- 281 TRIGGER:A:PULSE:RUNT:WHEN, 2-- 281 TRIGGER:A:PULSE:RUNT:WIDTH, 2-- 282 TRIGGER:A:PULSE:SLEWRATE?, 2-- 282 TRIGGER:A:PULSE:SLEWRATE:DELTATIME, 2-- 283 TRIGGER:A:PULSE:SLEWRATE:POLARITY, 2-- 283 TRIGGER:A:PULSE:SLEWRATE:SLEWRATE, 2
Index TRIGGER:A:PULSE:SLEWRATE:SLEWRATE, 2-- 284 TRIGGER:A:PULSE:SLEWRATE:THRESHOLD:BOTH, 2-- 284 TRIGGER:A:PULSE:SLEWRATE:THRESHOLD:HIGH, 2-- 285 TRIGGER:A:PULSE:SLEWRATE:THRESHOLD:LOW, 2-- 285 TRIGGER:A:PULSE:SLEWRATE:WHEN, 2-- 286 TRIGGER:A:PULSE:SOURCE, 2-- 286 TRIGGER:A:PULSE:WIDTH:POLARITY, 2-- 287 TRIGGER:A:PULSE:WIDTH:WHEN, 2-- 288 TRIGGER:A:PULSE:WIDTH:WIDTH, 2-- 288 TRIGGER:A:SETLEVEL, 2-- 289 TRIGGER:A:TYPE, 2-- 289 TRIGGER:A:VIDEO?, 2-- 290 TRIGGER:A:VIDEO:CUSTOM:FORMAT, 2-- 290 TRIGGER:A:VIDEO
Index REF:DATE?, 2-- 249 REF:HORIZONTAL:POSITION, 2-- 249 REF:LABEL, 2-- 250 REF:TIME?, 2-- 250 REF:VERTICAL:POSITION, 2-- 251 REF:VERTICAL:SCALE, 2-- 251 REFHORIZONTAL:SCALE, 2-- 249 SETUP:DATE?, 2-- 262 SETUP:LABEL, 2-- 262 SETUP:TIME?, 2-- 262 WAVFRM?, 2-- 309 WFMPRE?, 2-- 314 WFMPRE:?, 2-- 326 WFMPRE::PT_FMT, 2-- 328 WFMPRE::PT_OFF, 2-- 328 WFMPRE::WFID?, 2-- 328 WFMPRE::XINCR, 2-- 328 WFMPRE::XUNIT, 2-- 328 WFMPRE::XZERO, 2-- 328 WFMPRE: