Programming Manual TDS520

Programmer Manual
TDS Family Digitizing Oscilloscopes

(TDS 410, 420, 460, 520A, 524A, 540A, 544A,
620A, 640A, 644A, 684A, 744A, & 784A)
070-8709-06
Please check for change information

at the rear of this manual.
Seventh Edition: November 1994
Copyright E Tektronix, Inc. 1993, 1994. All rights reserved. Licensed software products are owned by Tektronix or its
suppliers and are protected by United States copyright laws and international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the
Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1) and (2) of the
Commercial Computer Software Restricted Rights clause at FAR 52.227-19, as applicable.
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, Inc., P.O. Box 500, Beaverton, Oregon, 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
WARRANTY
Tektronix warrants that this product will be free from defects in materials and workmanship for a period of three (3) years
from the date of shipment. If any such product proves defective during this warranty period, Tektronix, at its option, either
will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the
defective product.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period and make suitable arrangements for the performance of service. Customer shall be responsible for
packaging and shipping the defective product to the service center designated by Tektronix, with shipping charges prepaid.
Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
Tektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any
other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than Tektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; or c) to service a product that has been
modified or integrated with other products when the effect of such modification or integration increases the time or
difficulty of servicing the product.
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THIS PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESSED OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND
EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY. TEKTRONIX
AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
Table of Contents
Getting Started
Overview of the Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting Up Remote Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11
13
Syntax and Commands

Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command and Query Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clearing the TDS Family Oscilloscope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Constructed Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Argument Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
21
23
23
26
27
210
Command Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
211
Acquisition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alias Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Calibration and Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardcopy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Horizontal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Limit Test Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Measurement Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RS-232 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Save and Recall Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Error Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Vertical Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Waveform Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Zoom Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
211
212
212
213
213
214
216
216
217
218
219
221
222
222
223
224
231
232
237
Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
239
Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Handling Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Synchronization Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
35
36
37
312
Status and Events
Programming Examples
Compiling the Example Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDS Family Oscilloscope Programmer Manual
42
Table of Contents
Appendices
Appendix A: Character Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B: Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix C: Interface Specifications . . . . . . . . . . . . . . . . . . . . . . . . . .
A1
B1
C1
GPIB Function Subsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Interface Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C1
C2
Appendix D: Factory Initialization Settings . . . . . . . . . . . . . . . . . . . . .
D1
Glossary and Index
ii
Table of Contents
List of Figures
Figure 11: Common Message Elements . . . . . . . . . . . . . . . . . . . . . . .
Figure 12: Functional Groupings and an Alphabetical List of
Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 13: Service Requests (SRQs) Provide for Event (Interrupt)
Driven Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 14: The Disks That Accompany This Manual . . . . . . . . . . . .
Figure 15: GPIB Connector Location . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 16: How to Stack GPIB Connectors . . . . . . . . . . . . . . . . . . . .
Figure 17: Typical GPIB Network Configurations . . . . . . . . . . . . . .
Figure 18: Selecting the I/O System in the Main Menu . . . . . . . . . . .
Figure 19: Selecting the GPIB Address in the GPIB Configuration
Side Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11
Figure 21: Command Message Elements . . . . . . . . . . . . . . . . . . . . . .

Figure 22: Block Argument Example . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 23: Typical Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 24: Message Window Coordinates . . . . . . . . . . . . . . . . . . . . . .
Figure 25: LESSThan and MOREThan Arguments . . . . . . . . . . . . .
22
29
210
2193
2235
Figure 31: The Standard Event Status Register (SESR) . . . . . . . . . .

Figure 32: The Status Byte Register (SBR) . . . . . . . . . . . . . . . . . . . . .
Figure 33: The Device Event Status Enable Register (DESER) . . . .
Figure 34: The Event Status Enable Register (ESER) . . . . . . . . . . . .
Figure 35: The Service Request Enable Register (SRER) . . . . . . . . .
Figure 36: Status and Event Handling Process . . . . . . . . . . . . . . . . .
Figure 37: Command Processing Without Using Synchronization .
Figure 38: Processing Sequence With Synchronization . . . . . . . . . . .
32
32
33
34
34
36
38
38
Figure 41: Equipment Needed to Run the Example Programs . . . . .
41
12
12
13
13
14
15
15
16
iii
Table of Contents
List of Tables
iv
Table 21: BNF Symbols and Meanings . . . . . . . . . . . . . . . . . . . . . . . .

Table 22: Command Message Elements . . . . . . . . . . . . . . . . . . . . . . .
Table 23: Comparison of Header Off and On Responses . . . . . . . . .
Table 24: Acquisition Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 25: Alias Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 26: Application Menu Commands . . . . . . . . . . . . . . . . . . . . . .
Table 27: Calibration and Diagnostic Commands . . . . . . . . . . . . . .
Table 28: Cursor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 29: Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 210: File System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 211: Hardcopy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 212: Horizontal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 213: Limit Test Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 214: Measurement Commands . . . . . . . . . . . . . . . . . . . . . . . . .
Table 215: Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . .
Table 216: RS-232 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 217: Save and Recall Commands . . . . . . . . . . . . . . . . . . . . . . .
Table 218: Status and Error Commands . . . . . . . . . . . . . . . . . . . . . .
Table 219: Trigger Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 220: Vertical Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 221: Waveform Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 222: Zoom Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 223: Commands that Affect BUSY? Response . . . . . . . . . . . .
Table 224: Offset Ranges for the TDS 4XX, 54XA, 6XXA,
& 7XXA (All Channels) and the TDS 520A & 524A
(Channel 1 & Channel 2) using a 1x Probe . . . . . . . . . . . . . . . . . .
Table 225: Offset Ranges for the TDS 520A & 524A
(Aux 1 & Aux 2) using a 1x Probe . . . . . . . . . . . . . . . . . . . . . . . . .
Table 226: DATa and WFMPre Parameter Settings . . . . . . . . . . . . .
Table 227: XY Format Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 228: Commands that Generate an Operation Complete
Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 229: Additional WFMPre Commands . . . . . . . . . . . . . . . . . . .
21
22
23
211
212
212
213
213
214
216
217
217
218
219
221
222
222
223
224
231
235
237
260
2197
2291
Table 31: SESR Bit Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 32: SBR Bit Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
33
264
264
287
2109
Table of Contents
Table 33: No Event Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 34: Command Error Messages CME Bit 5 . . . . . . . . . . . . . .
Table 35: Execution Error Messages EXE Bit 4 . . . . . . . . . . . . . . .
Table 36: Device Error Messages DDE Bit 3 . . . . . . . . . . . . . . . . .
Table 37: System Event Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 38: Execution Warning Messages EXE Bit 4 . . . . . . . . . . . .
Table 39: Internal Warning Messages . . . . . . . . . . . . . . . . . . . . . . . .
312
312
314
317
317
318
319
Table A1: The TDS Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table A2: ASCII & GPIB Code Chart . . . . . . . . . . . . . . . . . . . . . . . .
Table C1: TDS Family Oscilloscope Standard Interface Message . .
Table D1: Factory Initialization Settings . . . . . . . . . . . . . . . . . . . . . .
A1
A2
C2
D1
Table of Contents
vi
Preface
This programmer manual covers the TDS 410, 420, 460, 520A, 524A, 540A,
544A, 620A, 640A, 644A, 684A, 744A, & 784A. It also covers Advanced DSP
Math (optional on the TDS420, 460, 520A, 540A, 620A, & 640A), the
RS-232/Centronics Interface (optional on the TDS 410, 420, 460, 520A, 540A,
620A, & 640A), and the Option 05 Video Trigger. This manual provides
information on operating your oscilloscope using the General Purpose Interface
Bus (GPIB) interface.
Related Manuals
Table i lists other documentation for the TDS 410, 420, 460, 520A, 524A, 540A,
544A, 620A, 640A, 644A, 684A, 744A, & 784A digitizing oscilloscopes.


vii
Preface
Table i:Other Documentation(Cont.)

Manual
viii
Tek Part Number

Getting Started
You can write computer programs that remotely set the oscilloscope front panel
controls or take measurements and read those measurements for further analysis
or storage.
To help you get started with programmng 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.
Setting Up Remote Communications describes how to physically connect

the oscilloscope to a controller and set the appropriate front panel controls.
Overview of the Manual

The information contained in each major section of this manual is described
below.
Syntax and Commands
The Syntax and Commands section (Section 2) describes the structure and
content of the messages your program sends to the digitizing oscilloscope.
Figure 11 shows a syntax diagram and command parts as described in the
Command Syntax subsection.
Comma
Header
Command Parts

Mnemonics

Space
Arguments
Syntax Diagram

Figure 11: Common Message Elements

Section 2 also describes the effect of each command and provides examples of
how you might use it. The Command Groups subsection provides a list by
functional area. The Command Descriptions subsection arranges commands
alphabetically (Figure 12).
11
Getting Started
ACQuire:NUMACq? (Query Only)
Application Menu Commands

Zoom
A
A
A
A
A
A
A
Zoom
ACQuire:MODe
Acquisition Commands
ACQuire? (Query Only)
ACQuire:MODe
ACQuire:NUMACq?
ACQuire:NUMAVg
ACQuire:NUMEnv
ACQuire:REPEt
ACQuire:STATE
ACQuire:STOPAfter
Syntax: . . .
Group: . . .
Alias Commands
A
A
A
A
A
A
A
Examples: . . .
Commands Grouped in Functional Areas
Commands Listed Alphabetically
and
Figure 12: Functional Groupings and an Alphabetical List of Commands
Status and Events
The program may request information from the oscilloscope. The oscilloscope
provides information in the form of status and error messages. Figure 13
illustrates the basic operation of this system.
The Status and Events section (Section 3) starting on page 31 describes how to
use service requests (SRQs) and various event messages in your programs.
Your program requests
status and event reports.
Controller
TDS sends status and event reports.

Digitizing Oscilloscope (Rear Panel)
GPIB Cable
Figure 13: Service Requests (SRQs) Provide for Event (Interrupt) Driven Programs
12
The Programming Examples section (Section 4) starting on page 41 describes

some example digitizing oscilloscope programs and how to compile them. The
disks that come with this manual (Figure 14) have an executable and a
Microsoft QuickBASIC 4.5 and a Microsoft QuickC 2.5 source code version of
each program.
Getting Started
TDS Example
Programs
TDS Example
Programs
Figure 14: The Disks That Accompany This Manual
Setting Up Remote Communications

Even the best instrument control program will not do much if the instrument is
not connected to the controller.
The digitizing oscilloscope has a 24-pin GPIB connector on its rear panel, as
shown in Figure 15. This connector has a D-type shell and conforms to IEEE
Std 488.11987.
Attach an IEEE Std 488.11987 GPIB cable (available from Tektronix as part
number 012099100) to this connector.
GPIB Connector Port
Figure 15: GPIB Connector Location
13
Getting Started
If needed, you can stack GPIB connectors as shown in Figure 16.
Figure 16: How to Stack GPIB Connectors
GPIB Requirements
14
Observe these rules when you use your digitizing oscilloscope with a GPIB
network:
H
Assign a unique device address to each device on the bus. No two devices
can share the same device address.
Do not connect more than 15 devices to any one bus.
Connect one device for every 2 meters (6 feet) of cable used.
Do not use more than 20 meters (65 feet) of cable to connect devices to a
bus.
Turn on at least two-thirds of the devices on the network while using the
network.
Connect the devices on the network in a star or linear configuration as shown

in Figure 17. Do not use loop or parallel configurations.
Getting Started
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
Figure 17: Typical GPIB Network Configurations

Appendix C: Interface Specifications gives more information on the GPIB
configuration of the digitizing oscilloscope.
Setting the GPIB

Parameters
You need to set the GPIB parameters of the digitizing oscilloscope to match the
configuration of the bus. Once you have set these parameters, you can control the
digitizing oscilloscope through the GPIB interface.
1. Press the UTILITY (SHIFT DISPLAY) button to display the Utility menu.
2. Press the System button in the main menu until it highlights the I/O
selection in the pop-up menu. See Figure 18.
Figure 18: Selecting the I/O System in the Main Menu
15
Getting Started
3. Press the Port button in the main menu until it highlights the GPIB
selection in the pop-up menu. See Figure 19.
4. Press the Configure button in the main menu to display the GPIB Configuration side menu. See Figure 19.
5. Press the Talk/Listen Address side menu button, and set the GPIB address
using either the general purpose knob or, if available, the keypad.
Figure 19: Selecting the GPIB Address in the GPIB Configuration Side Menu
The digitizing oscilloscope is set up for bidirectional communication with your
controller. If you wish to isolate the digitizing oscilloscope from the bus:
H
Press the Off Bus side menu button. This disables all communication with
the controller.
If you wish to enter a special mode of operation to communicate directly with

non-488.2 hard copy devices:
H
16
Press the Hardcopy side menu button to have the digitizing oscilloscope
send hard copy information only when you press the HARDCOPY button
(and accept a HARDCOPY ABORT command).
Command Syntax
You can control the digitizing 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 digitizing oscilloscope uses to
process them. The next section, entitled Command Groups, lists the commands
and queries themselves.
You transmit commands to the digitizing oscilloscope using the enhanced
American Standard Code for Information Interchange (ASCII) character
encoding. Appendix A: Character Charts on page A2 contains a chart of the
ASCII character set.
This manual describes commands and queries using Backus-Naur Form (BNF)
notation and syntax diagrams.
This manual uses the following BNF symbols:
Table 21: BNF Symbols and Meanings
Symbol
Meaning

Defined element

Is defined as
Exclusive OR

Group; one element is required

Optional; can be omitted

Previous element(s) may be repeated

Comment
Command and Query Structure

Commands consist of set commands and query commands (usually simply called
commands and queries). Commands modify instrument settings or tell the
digitizing oscilloscope to perform a specific action. Queries cause the digitizing
oscilloscope to return data and information about its status.
Most commands have both a set form and a query form. The query form of the
command differs from the set form by its question mark on the end. For
example, the set command
has a query form
.
Not all commands have both a set and a query form. Some commands have set
only and some have query only.
21
Command Syntax
A command message is a command or query name followed by any information

the digitizing oscilloscope needs to execute the command or query. Command
messages may contain five element types, defined in Table 22 and shown in the
example in Figure 21.
Table 22: Command Message Elements
Symbol
Meaning
<Header>
The basic command name. If the header ends with a question

mark, the command is a query. The header may begin with a
colon (:) character. If the command is concatenated with other
commands, the beginning colon is required. Never use the
beginning colon with command headers beginning with a star
(*).
<Mnemonic>
A header subfunction. Some command headers have only one

mnemonic. If a command header has multiple mnemonics, a
colon (:) character always separates them from each other.
<Argument>
A quantity, quality, restriction, or limit associated with the

header. Some commands have no argument while others have
multiple arguments. A <Space> separates arguments from the
header. A <Comma> separates arguments from each other.
<Comma>
A single comma between arguments of multiple-argument

commands. It may optionally have white space characters
before and after the comma.
<Space>
A white space character between command header and

argument. It may optionally consist of multiple white space
characters.
Comma
Header
Command Parts
SAVe:WAVEform
Mnemonics
CH1,REF3
Space
Arguments
Syntax Diagram
SAVe
WAVEform
<Space>
<wfm>
<Comma>
REF
<x>
Figure 21: Command Message Elements
Commands
Commands have the structure:

H
22
[:]<Header>[<Space><Argument>[<Comma><Argument>]...]
Command Syntax
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.
Queries
Queries have the structure:

H
[:]<Header>?
[:]<Header>?[<Space><Argument>[<Comma><Argument>]...]
You can specify a query command at any level within the command tree unless
otherwise noted. These branch queries return information about all the mnemonics below the specified branch or level. For example, MEASUre
ment:MEAS<x>:DELay:DIRection? returns the starting point and direction of
the edge of a delayed measurement, while MEASUrement:MEAS<x>:DELay?
returns the current settings of all delayed measurement parameters, and
MEASUrement:MEAS<x>? returns all the measurement parameters for the
specified measurement.
Headers in Query
Responses
You can control whether the digitizing oscilloscope returns headers as part of the
query response. Use the HEADer command to control this feature. If header is on,
the query response returns command headers and formats itself as a valid set
command. When header is off, the response includes only the values. This may
make it easier to parse and extract the information from the response. Table 23
shows the difference in responses.
Table 23: Comparison of Header Off and On Responses
Query
Header Off Response
Header On Response
APPMenu:TITLe?
"Test Setup"
:APPMENU:TITLE "Test
Setup"
ACQuire:NUMAVg?
100
:ACQUIRE:NUMAVG 100
Clearing the TDS Family Oscilloscope

You can clear the Output Queue and reset the digitizing oscilloscope to accept a
new command or query by using the Device Clear (DCL) GPIB command.
Command Entry
H
You can enter commands in upper or lower case.
23
Command Syntax
Abbreviating Commands
You can precede any command with white space characters. White space
characters include any combination of the ASCII control characters 00
through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32
decimal).
The digitizing oscilloscope ignores commands consisting of any combination of white space characters and line feeds.
You can abbreviate many digitizing oscilloscope commands. Each command

listing in the Commands section shows the minimum acceptable abbreviations in
capitals. For example, you can enter the command $"% simply as
or !$.
NOTE. Keep in mind that abbreviation rules change over time as new TDS
models get introduced. Thus, for the most robust code, use the full spelling.
Avoid using the command abbreviations.
If you use the
" command to have command headers included as part of
query responses, you can further control whether the returned headers are
abbreviated or are full-length. The # command lets you control this.
Concatenating Commands
You can concatenate any combination of set commands and queries using a
semicolon (;). The digitizing oscilloscope executes concatenated commands in
the order received.
When concatenating commands and queries, you must follow these rules:
1. Separate completely different headers by a semicolon and by the beginning
colon on all commands but the first. For example, the commands &
"
and $" would be concatenated into a
single command:
"
$"
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 $"

and $" into a single command:
$"

The longer version works equally well:
$"
$"
3. Never precede a star (*) command with a colon:
$"

24
Command Syntax
Any commands that follow will be processed as if the star command was not
there so
ACQuire:MODe ENVelope;*TRG;NUMAVg 10
will set the acquisition mode to envelope and set the number of acquisitions
for averaging to 10.
4. When you concatenate queries, the responses to all the queries are concatenated into a single response message. For example, if the display intensity
for text is 80% and for the waveform it is 90%, the concatenated query
DISplay:INTENsity:TEXt?;WAVEform?
will return either :DISPLAY:INTENSITY:TEXT 80;:DISPLAY:INTENSI
TY:WAVEFORM 90 if header is on or 80;90 if header is off.
5. Set commands and queries may be concatenated in the same message. For
example,
ACQuire:MODe NORMal;NUMAVg?;STATE?
is a valid message that sets the acquisition mode to normal. The message
then queries the number of acquisitions for averaging and the acquisition
state. Concatenated commands and queries are executed in the order
received.
Here are some invalid concatenations:
Message Terminators
DISPlay:INTENsity:TEXt 80;ACQuire:NUMAVg 10
(no colon before ACQuire)
DISPlay:INTENsity:TEXt 80;:WAVEform 90
(extra colon before WAVEform could use DISPlay:INTENsity:WAVEform
instead)
DISPlay:INTENsity:TEXt 80;:*TRG
(colon before a star (*) command)
APPMenu:LABel:BOTTOM1 "foo";LABel:BOTTOM2 "fee"

(levels of the mnemonics are different either remove the second use of
LABel: or place :APPMenu: in front of LABel:BOTTOM2)
This manual uses <EOM> (End of message) to represent a message terminator.

Symbol
Meaning
<EOM>
Message terminator
25
Command Syntax
The end-of-message terminator may be the END message (EOI asserted

concurrently with the last data byte), the ASCII code for line feed (LF) sent as
the last data byte, or both. The digitizing oscilloscope always terminates
messages with LF and EOI. It allows white space before the terminator. For
example, it allows CR LF.
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<x>.
Application Menu
Mnemonics
Cursor Position
Mnemonics
Measurement Specifier
Mnemonics
26
When the application menu is displayed, commands may specify which menu
button to use.
Symbol
Meaning
BOTTOM<x>
A main menu button selector; <x> is 1, 2, 3, 4, 5, 6, or 7.

Main menu buttons are located along the bottom of the display
and are numbered left to right, starting with 1.
RIGHT<x>
A side menu button selector; <x> is 1, 2, 3, 4, or 5. Side menu

buttons are located along the right side of the display and are
numbered top to bottom, starting with 1.
When cursors are displayed, commands may specify which cursor of the pair to
use.
Symbol
Meaning
POSITION<x>
A cursor selector; <x> is either 1 or 2.
Commands can specify which measurement to set or query as a mnemonic in the

header. Up to four automated measurements may be displayed with each
displayed waveform. The displayed measurements are specified in this way:
Symbol
Meaning
MEAS<x>
A measurement specifier; <x> is either 1 [top], 2, 3, or

4[bottom].
Command Syntax
Channel Mnemonics
Commands specify the channel to use as a mnemonic in the header.

Symbol
Meaning

A channel specifier; is either , , , or .

For the TDS 410, which has only two channels, is either
or .
For the TDS 520A, 524A, & 620A, and represent the
front-panel inputs labeled AUX 1 and AUX 2 respectively.
Math Waveform
Mnemonics
Reference Waveform
Mnemonics
Waveform Mnemonics
Commands can specify the mathematical waveform to use as a mnemonic in the

header.
Symbol
Meaning

A math waveform specifier; is , , or .
Commands can specify the reference waveform to use as a mnemonic in the

header.
Symbol
Meaning

A reference waveform specifier; is either , , , or .
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 , or

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 digitizing oscilloscope commands require numeric arguments. The syntax

shows the format that the digitizing oscilloscope returns in response to a query.
27
Command Syntax
This is also the preferred format when sending the command to the digitizing
oscilloscope though any of the formats will be accepted. This manual represents
these arguments as follows:
Symbol
Meaning
<NR1>
Signed integer value
<NR2>
Floating point value without an exponent
<NR3>
Floating point value with an exponent
Most numeric arguments will be automatically forced to a valid setting, either by

rounding or truncating, when an invalid number is input unless otherwise noted
in the command description.
Quoted String Arguments
Some commands accept or return data in the form of a quoted string, which is
simply a group of ASCII characters enclosed by a single quote (') or double
quote ("). For example:
"this is a quoted string"
Symbol
Meaning
<QString>
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 A2).
2. Use the same type of quote character to open and close the string:
"this is a valid string"
3. You can mix quotation marks within a string as long as you follow the
previous rule:
"this is an 'acceptable' string"
4. You can include a quote character within a string simply by repeating the
quote. For example,
"here is a "" mark"
5. Strings can have upper or lower case characters.
6. If you use a GPIB network, you cannot terminate a quoted string with the
END message before the closing delimiter.
28
Command Syntax
7. A carriage return or line feed imbedded in a quoted string does not terminate
the string, but is treated as just another character in the string.
8. The maximum length of a quoted string returned from a query is 1000
characters.
Here are some invalid strings:
Block Arguments
"Invalid string argument'

(quotes are not of the same type)
"test<EOI>"
(termination character is embedded in the string)
Several digitizing oscilloscope commands use a block argument form:

Symbol
Meaning
<NZDig>
A nonzero digit character, in the range 19
<Dig>
A digit character, in the range 09
<DChar>
A character with the hex equivalent of 00 through FF

hexadecimal (0 through 255 decimal)
<Block>
A block of data bytes, defined as:

<Block> ::=
{ #<NZDig><Dig>[<Dig>...][<DChar>...]
| #0[<DChar>...]<terminator> }
<NZDig> specifies the number of <Dig> elements that follow. Taken together, the
<Dig> elements form a decimal integer that specifies how many <DChar>
elements follow.
Figure 22 provides a diagram of block argument use.
Block Argument
ALIas:DEFINE SETUp1",#231AUTOSet EXECute;:SELect:REF1 ON
Specifies Data Length

Block Header
Specifies Number of
Length Digits that Follow
Figure 22: Block Argument Example
29
Command Syntax
Syntax Diagrams
The syntax diagrams in this manual use the following symbols and notation:
H
Circles and ovals contain literal elements. You must send most elements
exactly as shown. The command mnemonics are shown in both upper and
lower case to distinguish between complete and abbreviated spellings. These
elements are not case sensitive. You can omit the lower case portion of the
mnemonic.
Boxes contain the defined elements described earlier in this section, such as
or
.
Elements are connected by arrows that show the allowed paths through the
diagram and, thus, the orders in which you can send the elements. Parallel
paths show that you must take one and only one of the paths. A path around
a group of elements shows that those elements are optional. Loops show
elements that you can repeat.
Figure 23 shows the structure of a few typical syntax diagrams.
Figure 23: Typical Syntax Diagrams
210
Command Groups
This section lists TDS Family Oscilloscope 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 239.
The TDS Family Oscilloscope GPIB interface conforms to Tektronix standard
codes and formats and IEEE Std 488.21987 except where noted.
Acquisition Commands
Acquisition commands affect waveform acquisition. These commands control
mode, averaging, enveloping, and single-waveform acquisition. (Persistence
controls are in the Display Commands section on page 214.) Table 24 lists
these commands.
Table 24: Acquisition Commands
Header
Description
ACQuire?
Return acquisition parameters
ACQuire:AUTOSAve
(TDS 7XXA & some 6XXA)
Save waveforms to reference memory
ACQuire:MODe
Acquisition mode
ACQuire:NUMACq?
Return # of acquisitions obtained
ACQuire:NUMAVg
Number of acquisitions for average
ACQuire:NUMEnv
Number of acquisitions for envelope
ACQuire:REPEt
(TDS 4XX, 5XXA, & 7XXA)
Repetitive acquisition mode
ACQuire:STATE
Start or stop acquisition system
ACQuire:STOPAfter
Acquisition control
211
Command Groups
Alias Commands
Alias commands let you define your own commands as a sequence of standard
commands. This is useful when you use the same commands each time you
perform a certain task, such as setting up measurements. Table 25 lists these
commands.
Table 25: Alias Commands
Header
Description

Turn the alias state on and off

Return a list of aliases

Create a new alias

Remove an alias

Remove all aliases

Remove a named alias

Turn the alias state on and off
Application Menu Commands

Application menu commands let you define special-purpose menus. You can
define labels for the main and side menus as well as a side menu title. You can
display an Application menu by either pressing the front-panel APPLICATION
button or sending the APPMenu ACTivate command. Table 26 lists these
commands.
When the digitizing oscilloscope displays an Application menu and a user
presses a front-panel button, the oscilloscope generates an event that tells the
controller which button the user pressed. You can also set up the event reporting
system so that it generates a Service Request when a user presses a menu button.
Table 26: Application Menu Commands
212
Header
Description

Display the application menu

Return or remove all application menu button

labels

Label for a bottom menu button

Label for a side menu button

Create a title for the application menu
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 27 lists these commands.
Table 27: Calibration and Diagnostic Commands
Header
Description

Perform an internal self-calibration

Return diagnostic tests status

Return diagnostic test sequence results

%%!
Acquisition system diagnostic test sequence

%
Diagnostic test sequence for Acquisition,

Processor, Display, and Front panel

%
Processor diagnostic test sequence

% "'
Display system diagnostic test sequence

%
Front panel diagnostic test sequence

Control of diagnostic tests
Cursor Commands
Cursor commands provide control over cursor (caliper) display and readout.
Table 28 lists these commands.
Table 28: Cursor Commands
Header
Description
!#
Return cursor settings
!#%!
Cursors on or off; select cursor type
!# #$
Return H bar settings
!# #$

Return distance between H bars
!# #$&
Position a horizontal cursor
!# #$
%
Set which cursor the knob controls
!# #$%$
Set H bar units
!#
Set cursor tracking mode
!##
Positions paired cursors. Also, returns settings
213
Command Groups
Table 28: Cursor Commands (Cont.)

Header
Description
"$ $

Return horizontal distance between 1st and

2nd paired cursors.
"$ $
Return horizontal position of 1st paired cursor
"$ $
Return horizontal position of 2nd paired cursor
"$ $
Return vbar position of the1st paired cursor
"$ $
Return vbar position of the 2nd paired cursor
"$ $&
Select active paired cursor
"$ $ &%
Set paired cursor units
"$ $

Return vertical distance between 1st and 2nd

paired cursors
"$$%
Position vertical bar cursors
"$$%

Return horizontal distance between cursors
"$$% (
Position a vertical cursor
"$$%&
Set which cursor the knob controls
"$$% &%
Set vertical cursors to seconds, frequency, or

to lines (with option 05 video on the TDS
5XXA, 6XXA, & 7XXA)
Display Commands
Display commands let you change the graticule style, change the displayed
intensities, display messages, and clear the menu. Table 29 lists these commands.
Table 29: Display Commands
214
Header
Description
!'
Clear menus from display
#)
Return display settings
#)
Control the display of the date/time stamp
#) $ %&

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Control collision contrast
#) $&
!&%
(TDS 524A, 544A, 644A, 684A, & 7XXA)
Sets color for math or ref waveform to the

color of the waveform content
Command Groups
Table 29: Display Commands (Cont.)

Header
Description
#)$&
(TDS 524A, 544A, 644A, 684A, & 7XXA)
Set color for math or ref waveform to specific

color index
#)$
&&
%&!
(TDS 524A, 544A, 644A, 684A, & 7XXA)
Set current persistence palette to a preset

persistence palette
#)$
&&
'$
(TDS 524A, 544A, 644A, 684A, & 7XXA)
Set current palette to a preset palette
#)$
&&

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Reset all palettes to their factory default

settings
#)$
&&
#&& !

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Reset a selected palette to its factory default

settings
#)$
&&
#&& ! & !
(TDS 524A, 544A, 644A, 684A, & 7XXA)
Set the color of a selected item on a selected

palette
#) $
Displayed data interpolation
#)&
YT or XY display
#)&'
Graticule style
#) &('
%&!
(TDS 7XXA)
InstaVu persistence type variable or infinite
#) &('
(TDS 7XXA)
InstaVu waveform dots or vector style
#) &('#$%%&
(TDS 7XXA)
InstaVu variable persistence decay time
#)
)
Return intensity settings
#)
)%&
(TDS 4XX, 520A, 540A, 620A, & 640A)
Waveform intensified zone brightness
#)
)

(TDS 4XX, 520A, 540A, 620A, & 640A)
Main brightness
#)
)
&
Text brightness
#)
)
"$
Waveform brightness
#)
Normal or InstaVu display mode
#)
%&!
Variable persistence decay time
#)
Waveform dots, vector, infinite persistence, or

variable persistence
#) $
Control the display of the trigger bar/s on

screen
#)
Control the display of the trigger indicator on

screen
215
Command Groups
Table 29: Display Commands (Cont.)

Header
Description
MESSage
Remove text from the message window
MESSage:BOX
Set size and location of message window
MESSage:SHOw
Remove and display text in the message

window
MESSage:STATE
Control display of message window
File System Commands

File system commands help you use the built-in 3.5 inch floppy disk drive
(available with the File System). Table 210 lists these commands.
Table 210: File System Commands
Header
Description
FILESystem:COPy
Copy file to new file
FILESystem:CWD
Set directory path
FILESystem:DELEte
Delete named file
FILESystem:DELWarn
Set front-panel delete warning
FILESystem:DIR
Make directory
FILESystem:FORMat
Format named drive
FILESystem:FREESpace
Return free space on current drive
FILESystem:MKDir
Make new directory
FILESystem:OVERWrite
Set file-overwrite protection
FILESystem:PRInt
Print file to port
FILESystem:REName
Assign new name to file
FILESystem:RMDir
Delete named directory
Hardcopy Commands
Hardcopy commands let you control the format of hardcopy output and the
initiation and termination of hardcopies. Table 211 lists these commands.
216
Command Groups
Table 211: Hardcopy Commands

Header
Description
HARDCopy
Start or terminate hardcopy
HARDCopy:FILEName
(File System only)
Select file to send hardcopy data to
HARDCopy:FORMat
Hardcopy output format
HARDCopy:LAYout
Hardcopy orientation
HARDCopy:PALEtte
(TDS 524A, 544A, 644A, 684A, 7XXA)
Select palette to use when making hardcopy
HARDCopy:PORT
Hardcopy port for output
Horizontal Commands
Horizontal commands control the time bases of the digitizing oscilloscope. You
can set the time per division (or time per point) of both the main and delay time
bases. You can also set the record lengths. Table 212 lists these commands.
You may substitute SECdiv for SCAle in the horizontal commands. This
provides program compatibility with earlier models of Tektronix digitizing
oscilloscopes.
Table 212: Horizontal Commands
Header
Description
HORizontal?
Return horizontal settings
HORizontal:DELay?
Return delay time base settings
HORizontal:DELay:MODe
Delay time base mode
HORizontal:DELay:SCAle
Delay time base time per division
HORizontal:DELay:SECdiv
Same as HORizontal:DELay:SCAle
HORizontal:DELay:TIMe
Delay time
HORizontal:DELay:TIMe?
Return delay time parameters
HORizontal:DELay:TIMe:RUNSAfter
Time to wait in delay-runs-after-main mode
HORizontal:DELay:TIMe:TRIGAfter
Time to wait in delay-runs-after-trigger mode
HORizontal:FASTframe:COUNt
(TDS 5XXA & 7XXA only)
Select FastFrame count
HORizontal:FASTframe:LENgth
Select length of each FastFrame frame
HORizontal:FASTframe:POSition
Select FastFrame frame to display
217
Command Groups
Table 212: Horizontal Commands (Cont.)

Header
Description
( $
"
Setup FastFrame acquisition
( $
$ #"
(TDS 5XXA, 6XXA, & 7XXA)
Setup waveform compress
( $
Return main time per division
( $
Main time base time per division
( $ %
Same as HORizontal:MAIn:SCAle
( $
Turn delay time base on or off
( $$
Portion of waveform to display
( $ "$
Number of points in waveform record
( $
( $ %
( $ "
Return trigger position
( $ "$
Main time base trigger position
Limit Test Commands

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 digitizing oscilloscope find the waveforms that fall outside
those limits. When it finds such a waveform, it can generate a hardcopy, ring a
bell, stop and wait for your input, or any combination of these actions. Table
213 lists these commands.
Table 213: Limit Test Commands
218
Header
Description
$
Ring bell when limit exceeded
$!"&
Template to compare waveform to
$!"&
Template to compare math waveform to
$ !'
Make hardcopy when limit exceeded
$
Turn limit testing on or off
$ $
Template to compare waveform to
$ $ $
Reference storage for template waveform
Command Groups
Table 213: Limit Test Commands (Cont.)

Header
Description
''%
Template waveform source
''%"
+#"'
Tested waveform horizontal tolerance
''%"
Tested waveform vertical tolerance
Measurement Commands
Measurement commands control the automated measurement system. Table 214
lists these commands.
Up to four automated measurements can be displayed on the screen. In the
commands, these four measurement readouts are named ), where ) can
be , , , or .
In addition to the four displayed measurements, the measurement commands let
you specify a fifth measurement, . The immediate measurement has no
front-panel equivalent. Immediate measurements are never displayed. Because
they are computed only when needed, immediate measurements slow the
waveform update rate less than displayed measurements.
Whether you use displayed or immediate measurements, you use the (
query to obtain measurement results.
Measurement commands can set and query measurement parameters. You can
assign some parameters, such as waveform sources, differently for each
measurement readout. Other parameters, such as reference levels, have only one
value, which applies to all measurements.
Table 214: Measurement Commands
Header
Description
%!"'
Return all measurement parameters
%!"'
$&#'
Take down measurement snapshot
%!"'
Set or query measurement gating
%!"'
Return immediate measurement parameters
%!"'*
Return info on immediate delay measurement
%!"'*
'#"
Search direction to use for delay measurements
%!"'*
Which waveform edge to use for delay

measurements
219
Command Groups
Table 214: Measurement Commands (Cont.)
220
Header
Description
("%"&*"!.

measurements
("%"&*"!

Channel to take measurement from
("%"&*"!

Second channel to take measurement from

(delay or to channel)
("%"&*"!"
The measurement to be taken
("%"&*"!*)
Return measurement units
("%"&*"!+"
Return measurement result
("%"&*-
Return parameters on measurement
("%"&*-.
Return delay measurement parameters
("%"&*-.

" *#'&
Search direction to use for delay measurements
("%"&*-.

measurements
("%"&*-.

measurements
("%"&*-

Channel to take measurement from
("%"&*-

Second channel to take measurement from

(delay or to channel)
("%"&*-
Turn measurement display on or off
("%"&*-"
The measurement to be taken
("%"&*-*)
Return units to use for measurement
("%"&*-+"
Return measurement result
("%"&*'!
Method for calculating reference levels
("%"&* ","$
Return reference levels
("%"&* ","$ '$+*"
The top level for risetime (90% level)
("%"&* ","$ '$+*"
The low level for risetime (10% level)
("%"&* ","$ '$+*"
Mid level for measurements
("%"&* ","$ '$+*"
Mid level for delay measurements
("%"&* ","$'!
Method to assign and

levels: either % or absolute volts
("%"&* ","$
"&*
The top level for risetime (90% level)
("%"&* ","$
"&*
The low level for risetime (10% level)
("%"&* ","$
"&*
Mid level for measurements
Command Groups
Table 214: Measurement Commands (Cont.)

Header
Description
$ !&
( !&
Mid level for delay measurements
$ !&"&
Display measurement snapshot
Miscellaneous Commands
Miscellaneous commands do not fit into other categories. Table 215 lists these
commands.
Several commands and queries are common to all 488.21987 devices on the
GPIB bus. The 488.21987 standard defines them. They begin with a star ()
character.
Table 215: Miscellaneous Commands
Header
Description
&
Automatic instrument setup

Audio alert

Set date

Define group execute trigger (GET)
&"$)
Reset to factory default

Same as HEADer
$
Return command header with query

Identification

Learn device setting

Lock front panel (local lockout)
#%%
Change password for User Protected Data
"$
Access to change User Protected Data

No action; remark only

Same as *LRN?
'$
Initialize waveforms and setups

Set time

Perform Group Execute Trigger (GET)

Self-test
221
Command Groups
Table 215: Miscellaneous Commands (Cont.)

Header
Description
!
Unlock front panel (local lockout)

!"
Return full command name or minimum

spellings with query
RS-232 Commands
RS-232 commands allow you to utilize the serial communications port (available
with the RS-232/Centronics Hardcopy Interface). Table 216 lists these
commands.
Table 216: RS-232 Commands
Header
Description

Return RS-232 parameters

Set baud rate

Set hard flagging
#%
Set parity

Set soft flagging
#"
Set # of stop bits
Save and Recall Commands

Save and Recall commands allow you to store and retrieve internal waveforms
and settings. When you save a setting, you save all the settings of the
digitizing oscilloscope. When you then recall a setting, the digitizing
oscilloscope restores itself to the state it was in when you originally saved that
setting. Table 217 lists these commands.
Table 217: Save and Recall Commands
222
Header
Description
#
Return number of allocated and unallocated

data points
#

Return number of allocated data points
#

Return number of unallocated data points
#

$
Specify the number of allocated data points
Command Groups
Table 217: (Cont.)Save and Recall Commands

Header
Description
DELEte:SETUp
Delete stored setup
DELEte:WAVEFORM
Delete stored waveform
*RCL
Recall setting
RECAll:SETUp
Recall saved instrument setting
RECAll:WAVEFORM
(File System only)
Recall saved waveform
*SAV
Save setting
SAVe:SETUp
Save instrument setting
SAVe:WAVEFORM
Save waveform
SAVe:WAVEFORM:FILEFormat
(TDS 7XXA only)
Specifies the file format for saved waveforms
Status and Error Commands

Table 218 lists the status and error commands the digitizing oscilloscope
supports. These commands let you determine the status of the digitizing
oscilloscope and control events.
Several commands and queries used with the digitizing oscilloscope are common
to all devices on the GPIB bus. IEEE Std 488.21987 defines these commands
and queries. They begin with an asterisk (*).
Table 218: Status and Error Commands
Header
Description
ALLEv?
Return all events
BUSY?
Return scope status
*CLS
Clear status
DESE
Device event status enable
*ESE
Event status enable
*ESR?
Return standard event status register
EVENT?
Return event code
EVMsg?
Return event code and message
EVQty?
Return number of events in queue
ID?
Identification
*OPC
Operation complete
223
Command Groups
Table 218: Status and Error Commands (Cont.)

Header
Description
*OPT?
Return installed options
*PSC
Power-on status clear
*PUD
Query or set User Protected Data
*RST
Reset
*SRE
Service request enable
*STB?
Read status byte
*WAI
Wait to continue
Trigger Commands
Trigger commands control all aspects of digitizing oscilloscope triggering. Table
219 lists these commands.
There are two triggers, main and delayed. Where appropriate, the command set
has parallel constructions for each trigger.
You can set the main or delayed 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.
You can also set TDS 5XXA, 6XXA, and 7XXA main triggers to pulse and logic
modes. Pulse triggering lets the oscilloscope trigger whenever it detects a pulse
of a certain width or height. Logic triggering lets you logically combine the
signals on one or more channels. The digitizing oscilloscope then triggers when
it detects a certain combination of signal levels.
Table 219: Trigger Commands
224
Header
Description
TRIGger
Force trigger event; Return parameters
TRIGger:DELay
Delay trigger level to 50%
TRIGger:DELay:BY
Delay by time or events
TRIGger:DELay:EDGE?
Return delay trigger parameters
TRIGger:DELay:EDGE:COUPling
Delay trigger coupling
TRIGger:DELay:EDGE:SLOpe
Delay trigger slope
TRIGger:DELay:EDGE:SOUrce
Delay trigger source
TRIGger:DELay:EVENTS?
Return delay trigger event parameters
Command Groups
Table 219: Trigger Commands (Cont.)

Header
Description
'
,

)
Delay by events count
'
,
"
Delay trigger level
'
,
Time for delay by time
'
,
Delay trigger, edge
'$
Main trigger level to 50%
'$

Return main edge trigger parameters
'$

"!$
Main trigger coupling
'$

&
Main trigger slope
'$

'
Main trigger source
'$ %
Return main trigger holdoff value
'$ %"

(TDS 684A & 7XXA)
Return main trigger holdoff value in seconds
'$ %

(TDS 684A & 7XXA)
Main trigger holdoff default
'$ %

(TDS 684A & 7XXA)
Main trigger holdoff time
'$ %*

(Not in TDS 684A & 7XXA)
Main trigger holdoff value
'$
"
Main trigger level
'$

Returns main logic trigger parameters
'$((

Logic trigger input usage
'$)!%$

Logic trigger input combining
'$*)

Return main logic trigger input settings
'$*) +

Logic trigger expected channel state
'$)'$

*)
Logic trigger expected for channel 4 pattern

class
'$)'$

$
Main logic pattern trigger condition
'$)'$

$:
!#!)
Maximum time the selected pattern may be

true and still generate main logic pattern
trigger
225
Command Groups
226
Header
Description
TRIGger:MAIn:LOGIc:PATtern
:WHEn:MORELimit
Minimum time the selected pattern may be

true and still generate main logic pattern
trigger
TRIGger:MAIn:LOGIc:SETHold:
CLOCk:EDGE
(TDS 684A & 7XXA)
Clock edge polarity for setup and hold violation

triggering
CLOCk:LEVel
(TDS 684A & 7XXA)
Setup/Hold clock voltage trigger level.
CLOCk:SOUrce
(TDS 684A & 7XXA)
Setup/Hold clock input source
DATa:LEVel
(TDS 684A & 7XXA)
Setup/Hold data level
DATa:SOUrce
(TDS 684A & 7XXA)
Setup/Hold data input data channel
HOLDTime
(TDS 684A & 7XXA)
Setup/Hold trigger hold time
SETTime
(TDS 684A & 7XXA)
Setup/Hold trigger set time
TRIGger:MAIn:LOGIc:STATE:INPut:
CH4
Logic trigger expected for channel 4 state

class
TRIGger:MAIn:LOGIc:STATE:WHEn
When the logic trigger occurs (on true or false)
TRIGger:MAIn:LOGIc:THReshold?
Return main logic thresholds
TRIGger:MAIn:LOGIc:THReshold:
CH<x>
Logic trigger thresholds
TRIGger:MAIn:LOGIc:WHEn
Logic trigger on combination true or false
TRIGger:MAIn:MODe
Main trigger mode
TRIGger:MAIn:PULse?
Returns pulse trigger parameters
TRIGger:MAIn:PULse:CLAss
Pulse trigger class
Command Groups

Header
Description
TRIGger:MAIn:PULse:GLItch?
Returns glitch trigger parameters
TRIGger:MAIn:PULse:GLItch:FILTer
Glitch filter on and off
TRIGger:MAIn:PULse:GLItch:
POLarity
Glitch filter positive, negative, or both
TRIGger:MAIn:PULse:GLItch:WIDth
Glitch trigger with differentiation between glitch

and valid pulse
TRIGger:MAIn:PULse:RUNT?
Return runt trigger parameters
TRIGger:MAIn:PULse:RUNT:POLarity
Runt trigger positive, negative, or both
TRIGger:MAIn:PULse:RUNT:THReshold?
Return runt trigger thresholds
TRIGger:MAIn:PULse:RUNT:
THReshold:BOTh
(TDS 684A & 7XXA)
Trigger level switching thresholds
THReshold:HIGH
Upper limit for runt pulse
THReshold:LOW
Lower limit for runt pulse
TRIGger:MAIn:PULse:RUNT:WHEn
(TDS 684A & 7XXA)
Runt pulse width type to check for
TRIGger:MAIn:PULse:RUNT:WIDth
(TDS 684A & 7XXA)
Minimum width for valid main pulse runt trigger
TRIGger:MAIn:PULse:SLEWRate:
DELTATime
(TDS 684A & 7XXA)
Slew rate trigger delta time
POLarity
(TDS 684A & 7XXA)
Slew rate trigger polarity
SLEWRate?
(TDS 684A & 7XXA)
Return slew rate value
THReshold:BOTh
(TDS 684A & 7XXA)
Upper and lower slew rate trigger thresholds
227
Command Groups
228
Header
Description
THReshold:HIGH
(TDS 684A & 7XXA)
Upper limit for slew rate pulse
THReshold:LOW
(TDS 684A & 7XXA)
Lower limit for slew rate pulse
TRIGger:MAIn:PULse:SLEWRate:WHEn
(TDS 684A & 7XXA)
Slewing signal type to check for
TRIGger:MAIn:PULse:SOUrce
Pulse trigger channel
TRIGger:MAIn:PULse:WIDth?
Return trigger pulse width parameters
TRIGger:MAIn:PULse:WIDth:HIGHLimit
Pulse trigger maximum pulse width
TRIGger:MAIn:PULse:WIDth:LOWLimit
Pulse trigger minimum pulse width
TRIGger:MAIn:PULse:WIDth:POLarity
Pulse trigger positive, negative, or both
TRIGger:MAIn:PULse:WIDth:WHEn
Pulse trigger when pulse detected or when not

detected
TRIGger:MAIn:TYPe
Set main trigger to edge, logic, pulse, or, with

option 5, video type
TRIGger:MAIn:VIDeo?
(TDS 5XXA, 6XXA, & 7XXA Option 05)
Return video trigger parameters
TRIGger:MAIn:VIDeo:BY
(TDS 4XX Option 05)
Set video trigger delay mode
TRIGger:MAIn:VIDeo:FIELD
(Option 05)
Set video trigger field
TRIGger:MAIn:VIDeo:FIELDType
Set video trigger field type
TRIGger:MAIn:VIDeo:FLEXformat?
(TDS 5XXA. 6XXA, & 7XXA Option 05)
Return FlexFormat parameters
TRIGger:MAIn:VIDeo:FLEXformat:
FIELDRATE
Set FlexFormat frames per second
FIELDS
Set FlexFormat video fields
Command Groups

Header
Description
LINES
Set FlexFormat lines in a frame
NEGSynchwidth
Set FlexFormat negative sync width
V1STArttime
Set time from positive (+) edge of tri-sync

pulse for the last line in the selected field to
the leading edge () of the first negative
vertical sync pulse
V1STOptime
Set time from positive edge of tri-sync pulse

for the last line in the selected field (t0) to
trailing edge (positive) of the first negative
vertical sync pulse
TRIGger:MAIn:VIDeo:
FLEXformat:V2STArttime
Set time from t0 to the leading edge (positive)

of the second vertical sync pulse
TRIGger:MAIn:VIDeo:
FLEXformat:V2STOptime
Set time from t0 to trailing edge (positive) of

the second negative vertical sync pulse
TRIGger:MAIn:VIDeo:HDTv
Select high definition TV format
TRIGger:MAIn:VIDeo:HOLdoff?
(TDS 4XX Option 5)
Return video trigger holdoff
TRIGger:MAIn:VIDeo:HOLdoff:VALue
(TDS 4XX Option 5)
Set video trigger holdoff value
TRIGger:MAIn:VIDeo:INTERLAce
(TDS 4XX Option 5)
Select video trigger interlace format
TRIGger:MAIn:VIDeo:LINE
Set video trigger delay in terms of a number of

lines
TRIGger:MAIn:VIDeo:LINES
(TDS 4XX Option 5)
Set video trigger delay in terms of a number of

lines
TRIGger:MAIn:VIDeo:NTSc
Select color or mono NTSC
TRIGger:MAIn:VIDeo:PAL
Select color or mono PAL
TRIGger:MAIn:VIDeo:SCAN
(TDS 4XX Option 5)
Set video trigger scan rate
TRIGger:MAIn:VIDeo:SOUrce
Option 05
Select video trigger source
229
Command Groups
230
Header
Description

Select video trigger standard

(Option 05)
Select video trigger sync polarity

(TDS 4XX Option 5)
Select video trigger class

(TDS 4XX Option 5)
Set video trigger delay time

Return trigger system status
Command Groups
Vertical Commands
Vertical commands control the display of channels and of main and reference
waveforms. Table 220 lists these commands.
The SELect:<wfm> command also selects the waveform many commands in
other command groups use.
You may replace VOLts for SCAle in the vertical commands. This provides
program compatibility with earlier models of Tektronix digitizing oscilloscopes.
Table 220: Vertical Commands
Header
Description
CH<x>?
Return vertical parameters
CH<x>:BANdwidth
Channel bandwidth
CH<x>:COUPling
Channel coupling
CH<x>:IMPedance
Channel impedance
CH<x>:OFFSet
Channel offset
CH<x>:POSition
Channel position
CH<x>:PRObe?
Return channel probe attenuation
CH<x>:SCAle
Channel volts per div
CH<x>:VOLts
Same as CH<x>:SCAle
MATH<x>?
Return math waveform definition
MATH<x>:DEFine
Define math waveform
MATH<x>:NUMAVg
(TDS 5XXA, 6XXA, & 7XXA,
some models require Option 2F)
Acquisition number at which to begin

exponential averaging
MATH<x>:PROCessing
(TDS 5XXA, 6XXA, & 7XXA,
some models require Option 2F)
Math waveform averaging on or off
SELect?
Return selected waveform
SELect:CONTROl
Front-panel channel selector
SELect:<wfm>
Set selected waveform
231
Command Groups
Waveform Commands
Waveform commands let you transfer waveform data points to and from the
digitizing 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 enveloped 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 locations.
Table 221 lists these commands.
Waveform Data Formats
Acquired waveform data uses either one or two 8-bit data bytes to represent each
data point. The number of bytes used depends on the acquisition mode specified
when you acquired the data. Data acquired in SAMple, ENVelope, or PEAKdetect mode uses one 8-bit byte per waveform data point. Data acquired in HIRes
or AVErage mode uses two 8-bit bytes per point. For more information on the
acquisition modes see the ACQuire: MODe command on page 240.
The DATa:WIDth command lets you specify the number of bytes per data point
when transferring data to and from the digitizing oscilloscope. If you specify two
bytes for data that uses only one, the least significant byte will be filled with
zeros. If you specify one byte for data that uses two, the least significant byte
will be ignored.
The digitizing oscilloscope can transfer waveform data in either ASCII or binary
format. You specify the format with the DATa:ENCdg command.
ASCII data is represented by signed integer values. The range of the values
depends on the byte width specified. One byte wide data ranges from 128 to
127. Two byte wide data ranges from 32768 to 32767.
Each data value requires two to seven characters. This includes one to five
characters to represent the value, another character, if the value is negative, to
represent a minus sign, and a comma to separate the data points.
An example ASCII waveform data string may look like this:

Use ASCII to obtain more human readable and easier to format output than
binary. However, it may require more bytes to send the same values with ASCII
than it does with binary. This may reduce transmission speeds.
Binary data can be represented by signed integer or positive integer values.
The range of the values depends on the byte width specified. When the byte
width is one, signed integer data ranges from 128 to 127, and positive integer
232
Command Groups
values range from 0 to 255. When the byte width is two, the values range from
32768 to 32767.
The defined binary formats also specify the order in which the bytes are
transferred. The four binary formats are RIBinary, RPBinary, SRIbinary, and
SRPbinary.
RIBinary is signed integer where the most significant byte is transferred first,
and RPBinary is positive integer where the most significant byte is transferred
first. SRIbinary and SRPbinary correspond to RIBinary and RPBinary respectively but use a swapped byte order where the least significant byte is transferred
first. The byte order is ignored when DATa:WIDth is set to 1.
Waveform Data/Record
Lengths
You can transfer multiple points for each waveform record. You can transfer a
portion of the waveform or you can transfer the entire record. The DATa:STARt
and DATa:STOP commands let you specify the first and last data points of the
waveform record.
When transferring data into the digitizing oscilloscope, you must specify the
location of the first data point within the waveform record. For example, when
you set DATa:STARt to 1, data points will be stored starting with the first point
in the record, and when you set DATa:STARt to 500, data will be stored starting
at the 500th point in the record. The digitizing oscilloscope will ignore
DATa:STOP when reading in data as it will stop reading data when it has no
more data to read or when it has reached the specified record length.
When transferring data from the digitizing oscilloscope, you must specify the
first and last data points in the waveform record. Setting DATa:STARt to 1 and
DATa:STOP to the record length will always return the entire waveform. You can
also use the vertical bar cursors to delimit the portion of the waveform that you
want to transfer. DATa:STARt and DATa:STOP can then be set to the current
cursor positions by sending the command DATa SNAp.
Waveform Data Locations

and Memory Allocation
The DATa:SOUrce command specifies the data location when transferring

waveforms from the digitizing oscilloscope. You can transfer out multiple
waveforms at one time by specifying more than one source.
You can transfer in to the digitizing oscilloscope only one waveform at a time.
Waveforms sent to the oscilloscope are always stored in one of the four reference
memory locations. You can specify the reference memory location with the
DATa:DESTination command. You must define the memory size for the
specified location before you store the data. The ALLOcate:
WAVEFORM:REF<x> command lets you specify the memory size for each
reference location.
233
Command Groups
Waveform Preamble
Scaling Waveform Data
Transferring Waveform
Data from the TDS Family
Oscilloscope
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 2284 for more information about the waveform
preamble.
Once you transfer the waveform data to the controller, you can convert the data
points into voltage values for analysis using information from the waveform
preamble. The program on the diskettes that come with this manual
shows how you can scale data.
You can transfer waveforms from the digitizing oscilloscope to an external
controller using the following sequence:
1. Select the waveform source(s) using the DATa:SOUrce command. If you
want to transfer multiple waveforms, select more than one source.
2. Specify the waveform data format using DATa:ENCdg.
3. Specify the number of bytes per data point using DATa:WIDth.
4. Specify the portion of the waveform that you want to transfer using
DATa:STARt and DATa:STOP.
5. Transfer waveform preamble information using WFMPRe? query.
6. Transfer waveform data from the digitizing oscilloscope using the CURVe?
query.
Transferring Waveform
Data to the TDS Family
Oscilloscope
You can transfer waveform data to one of the four reference memory locations in
the digitizing oscilloscope using the following sequence:
1. Specify waveform reference memory using DATa:DESTination.
2. Specify the memory size for the reference location specified in Step 1 using
the ALLOcate:WAVEFORM:REF<x> command.
3. Specify the waveform data format using DATa:ENCdg.
4. Specify the number of bytes per data point using DATa:WIDth.
5. Specify first data point in the waveform record using DATa:STARt.
6. Transfer waveform preamble information using WFMPRe:<wfm>.
7. Transfer waveform data to the digitizing oscilloscope using CURVe.
234
Command Groups
Table 221: Waveform Commands

Header
Description
CURVe
Transfer waveform data
DATa
Waveform data format and location
DATa:DESTination
Destination for waveforms sent to digitizing

oscilloscope
DATa:ENCdg
Waveform data encoding method
DATa:SOUrce
Source of CURVe? data
DATa:STARt
Starting point in waveform transfer
DATa:STOP
Ending point in waveform transfer
DATa:TARget
Same as DATa:DESTination
DATa:WIDth
Byte width of waveform points
WAVFrm?
Return waveform preamble and data
WAVPre?
Return waveform format data
WFMPre:BIT_Nr
Preamble bit width of waveform points.
WFMPre:BN_Fmt
Preamble binary encoding type
WFMPre:BYT_Nr
Preamble byte width of waveform points
WFMPre:BYT_Or
Preamble byte order of waveform points
WFMPre:CRVchk
Preamble checksum of waveform points
WFMPre:ENCdg
Preamble encoding method
WFMPre:NR_Pt
Number of points in the curve
WFMPre:PT_Fmt
Format of curve points
WFMPre:PT_Off
Trigger position
WFMPre:WFId
Curve identifier
WFMPre:XINcr
Horizontal sampling interval
WFMPre:XMUlt
Horizontal scale factor
WFMPre:XOFf
Horizontal offset
WFMPre:XUNit
Horizontal units
WFMPre:XZEro
Horizontal origin offset
WFMPre:YMUlt
Vertical scale factor
WFMPre:YOFf
Vertical offset
WFMPre:YUNit
Vertical units
WFMPre:YZEro
Offset voltage
WFMPre:ZMUlt
Z-axis scale factor
WFMPre:ZOFf
Z-axis offset
235
Command Groups
Table 221: Waveform Commands (Cont.)
236
Header
Description
WFMPre:ZUNit
Z-axis units
WFMPre:ZZEro
Z-axis origin offset
WFMPre:<wfm>:NR_Pt
Number of points in the curve
WFMPre:<wfm>:PT_Fmt
Format of curve points
WFMPre:<wfm>:PT_Off
Trigger position
WFMPre:<wfm>:WFId
Curve identifier
WFMPre:<wfm>:XINcr
Horizontal sampling interval
WFMPre:<wfm>:XUNit
Horizontal units
WFMPre:<wfm>:YMUlt
Vertical scale factor
WFMPre:<wfm>:YOFf
Vertical offset
WFMPre:<wfm>:YUNit
Vertical units
WFMPre:<wfm>:YZEro
Offset voltage
Command Groups
Zoom Commands
Zoom commands let you expand and position the waveform display horizontally
and vertically without changing the time base or vertical settings. Table 222
lists these commands.
Table 222: Zoom Commands
Header
Description
ZOOm
Reset zoom parameters to defaults
ZOOm:DUAl (TDS 7XXA)
Turn dual zoom mode on and off
ZOOm:DUAl:OFFSet (TDS 7XXA)
Adjust the requested horizontal offset between

the centers of the main and second zoom
boxes.
ZOOm:GRAticle (TDS 7XXA)
Select between the upper and lower graticule

for use by the zoom preview state.
ZOOm:HORizontal:LOCk
Horizontal zoom lock
ZOOm:HORizontal:POSition
Horizontal zoom position
ZOOm:HORizontal:SCAle
Horizontal zoom scale
ZOOm:STATE
Turn zoom mode on or off
ZOOm:VERTical:POSition
Vertical zoom position
ZOOm:VERTical:SCAle
Vertical zoom scale
237
Command Groups
238
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. This manual marks set only commands with the words No Query
Form included with the command name. It marks query only commands with a
question mark appended to the header, and includes the words Query Only in
the command name.
This manual spells out headers, mnemonics, and arguments with the minimal
spelling shown in upper case. For example, to use the abbreviated form of the
ACQuire:MODe command just type ACQ:MOD.
ACQuire? (Query Only)

Returns all the current acquisition parameters.
Group
Acquisition
Syntax

Examples

might return the string

for the current acquisition parameters.
ACQuire:AUTOSAve
TDS 7XXA & Some 6XXA Only
Saves waveforms in reference memory when acquisition completes. This is
equivalent to setting Autosave Single Seq in the Acquire menu and the
corresponding side menu Off or On items.
When you start a Single Sequence with Autosave set to ON, the oscilloscope
nulls out all existing reference waveforms. At the end of Single Sequence, the
oscilloscope saves all displayed live channels to reference waveform memory. It
saves references in the order Ch1 > Ref1, Ch2 > Ref2, Ch3 > Ref3, Ch4 >
Ref4. The exact number of references saved may depend on the record length
used.
239
Group
Acquisition
Syntax
ACQuire:AUTOSAve { OFF | ON | <NR1> }

ACQuire:AUTOSAve?
OFF
<Space>
ON
<NR1>
ACQuire
Arguments
AUTOSAve
OFF or <NR1> = 0 turns repetitive mode off.

ON or <NR1> 0 turns repetitive mode on.
Examples
ACQUIRE:AUTOSAVE 1
turns autosave mode on.
ACQUIRE:AUTOSAVE OFF
turns autosave mode off.
ACQUIRE:AUTOSAVE?
might return 1, indicating that autosave mode is on.
ACQuire:MODe
Sets or queries the acquisition mode of the digitizing oscilloscope. This affects
all live waveforms. This command is equivalent to setting Mode in the Acquire
menu.
Waveforms are the displayed data point values taken from acquisition intervals.
Each acquisition interval represents a time duration set by the horizontal scale
(time per division). The digitizing oscilloscope sampling system always samples
at the maximum rate, and so an acquisition interval may include more than one
sample.
The acquisition mode, which you set using this ACQuire:MODe command,
determines how the final value of the acquisition interval is generated from the
many data samples.
Group
240
Acquisition
Related Commands
Syntax
ACQuire:NUMAVg, ACQuire:NUMENv, CURVe?, DATa:WIDth

For the TDS 4XX, 5XXA & 7XXA:
ACQuire:MODe { SAMple | PEAKdetect | HIRes | AVErage |
ENVelope }
For the TDS 6XXA:
ACQuire:MODe { SAMple | AVErage | ENVelope }
For all TDS:
ACQuire:MODe?
For the TDS 4XX, 5XXA, & 7XXA:
SAMple
PEAKdetect
<Space>
HIRes
AVErage
ACQuire
ENVelope
MODe
For the TDS 6XXA:

SAMple
<Space>
AVErage
ENVelope
ACQuire
Arguments
MODe
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 8 bits of precision. You can request 16 bit data with a
CURVe? query, but the lower-order 8 bits of data will be zero. SAMple is the
default mode.
PEAKdetect (for the TDS 4XX, 5XXA, & 7XXA) specifies the display of the
high-low range of the samples taken from a single waveform acquisition. The
high-low range is displayed as a vertical column that extends from the highest to
the lowest value sampled during the acquisition interval. PEAKdetect mode can
reveal the presence of aliasing or short spikes.
241
HIRes (for the TDS 4XX, 5XXA, & 7XXA) specifies Hi Res mode, where the
displayed data point value is the average of all the samples taken during the
acquisition interval. This is a form of averaging, where the average comes from a
single waveform acquisition. The number of samples taken during the acquisition interval determines the number of data values that compose the average.
AVErage specifies averaging mode, where the resulting waveform shows an
average of SAMple data points from several separate waveform acquisitions. The
number of waveform acquisitions that go into making up the average waveform
is set or queried using the ACQuire:NUMAVg command.
ENVelope specifies envelope mode, where the resulting waveform shows the
PEAKdetect range of data points from several separate waveform acquisitions.
The number of waveform acquisitions that go into making up the envelope
waveform is set or queried using the ACQuire:NUMENv command.
Examples
ACQUIRE:MODE ENVELOPE
sets the acquisition mode to display a waveform that is an envelope of many
individual waveform acquisitions.
ACQUIRE:MODE?
might return ENVELOPE.
ACQuire:NUMACq? (Query Only)

Indicates the number of acquisitions that have taken place since starting
acquisition. This value is reset to zero when any Acquisition, Horizontal, or
Vertical arguments that affect the waveform are modified. The maximum number
of acquisitions that can be counted is 2301. Counting stops when this number is
reached. This is the same value that is displayed in the upper center of the screen
when the acquisition system is stopped.
Group
Related Commands
Syntax
Acquisition
ACQuire:STATE
ACQuire:NUMACq?
ACQuire
Related Commands
242
NUMACq
<NR1>
Examples
ACQUIRE:NUMACQ?
might return 350, indicating that 350 acquisitions took place since an ACQUIRE:STATE RUN command was executed.
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 side
menu.
Group
Related Commands
Syntax
Acquisition
ACQuire:MODe
ACQuire:NUMAVg <NR1>
ACQuire:NUMAVg?
<Space>
ACQuire
<NR1>
NUMAVg
?
Arguments
Examples
<NR1> is the number of waveform acquisitions, from 2 to 10,000.

ACQUIRE:NUMAVG 10
specifies that an averaged waveform will show the result of combining 10
separately acquired waveforms.
ACQUIRE:NUMAVG?
might return 75, indicating that there are 75 acquisitions specified for averaging.
ACQuire:NUMEnv
Sets the number of waveform acquisitions that make up an envelope waveform.
This is equivalent to setting the Envelope count in the Acquisition Mode side
menu.
Group
Related Commands
Acquisition
ACQuire:MODe
243
Syntax

Arguments
0 is the number of waveform acquisitions, from 1 to 2000. The

envelope will restart after the specified number of envelopes have been acquired
or when the ACQuire:STATE RUN command is sent.
or = 0 specifies continuous enveloping.
NOTE. If you set the acquisition system to single sequence, envelope mode, and
set the number of envelopes to infinity, the digitizing oscilloscope will envelope a
maximum of 2001 acquisitions.
Examples

specifies that an enveloped waveform will show the result of combining 10
separately acquired waveforms.

might return , indicating that acquisitions are acquired infinitely for enveloped
waveforms.
ACQuire:REPEt
TDS 4XX, 5XXA, & 7XXA Only
Controls repetitive signal acquisition. This is equivalent to setting Repetitive
Signal in the Acquire menu. When the digitizing oscilloscope is in real-time
operation, this setting has no effect.
The ACQuire:REPEt command specifies the behavior of the acquisition system
during equivalent-time (ET) operation. When repetitive mode is on, the
acquisition system will continue to acquire waveform data until the waveform
record is filled with acquired data. When repetitive mode is off and you specify
single acquisition operation, only some of the waveform data points will be set
with acquired data, and the displayed waveform shows interpolated values for
the unsampled data points.
244
Group
Related Commands
Syntax
Acquisition
ACQuire:STATE, ACQuire:STOPAfter
ACQuire:REPEt { OFF | ON | <NR1> }
ACQuire:REPEt?
OFF
ON
<Space>
<NR1>
ACQuire
Arguments
REPEt
OFF or <NR1> = 0 turns repetitive mode off.

ON or <NR1> 0 turns repetitive mode on.
Examples
ACQUIRE:REPET 1
turns repetitive mode on.
ACQUIRE:REPET OFF
turns repetitive mode off.
ACQUIRE:REPET?
might return 1, indicating that repetitive signal acquisition mode is on.
ACQuire:STATE
Starts or stops acquisitions. This is the equivalent of pressing the front-panel
RUN/STOP button. If ACQuire:STOPAfter is set to SEQuence, other signal
events may also stop acquisition.
Group
Related Commands
Syntax
Acquisition
ACQuire:NUMACq?, ACQuire:REPEt, ACQuire:STOPAfter
ACQuire:STATE { OFF | ON | RUN | STOP | <NR1> }
ACQuire:STATE?
245

!
Arguments

or or = 0 stops acquisitions.

or 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), restarts the sequence, discarding any data
accumulated prior to the . It also resets the number of acquisitions.
Examples

starts acquisition of waveform data and resets the number of acquisitions count
(NUMACQ) to zero.

returns either or , depending on whether the acquisition system is running.
ACQuire:STOPAfter
Tells the digitizing oscilloscope when to stop taking acquisitions. This is
equivalent to setting Stop After in the Acquire menu.
Group
Related Commands
Syntax
Acquisition
ACQuire:MODe, ACQuire:STATE, ACQuire:REPEt
! " #
! # $
!

!

!

246
Arguments
RUNSTop specifies that the run and stop state should be determined by the user
pressing the front-panel RUN/STOP button.
SEQuence specifies single sequence operation, where the digitizing oscilloscope stops after it has acquired enough waveforms to satisfy the conditions of
the acquisition mode. For example, if the acquisition mode is set to sample, and
the horizontal scale is set to a speed that allows real-time operation, then the
digitizing oscilloscope will stop after digitizing a waveform from a single trigger
event. However, if the acquisition mode is set to average 100 waveforms, then
the digitizing oscilloscope will stop only after all 100 waveforms have been
acquired. The ACQuire: STATE command and the front-panel RUN/STOP
button will also stop acquisition when the digitizing oscilloscope is in single
sequence mode.
LIMit specifies the digitizing oscilloscope stops after the limit test condition is
met.
NOTE. If you set the acquisition system to single sequence, envelope mode, and
set the number of envelopes to infinity, the digitizing oscilloscope will envelope a
maximum of 2001 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.
ALIas
Turns command aliases on or off. This command is identical to the
ALIas:STATE command.
Group
Alias
Syntax
ALIas { OFF | ON | <NR1> }

ALIas?
247
OFF
ON
<Space>
<NR1>
ALIas
Arguments
OFF or <NR1> = 0 turns alias expansion off. If a defined alias label is sent when
ALIas is OFF, an execution error (110, Command header error) will be
generated.
ON or <NR1> 0 turns alias expansion on. When a defined alias is received, the
specified command sequence is substituted for the alias and executed.
Examples
ALIAS ON
turns the alias feature on.
ALIAS?
returns 1 when aliases are on.
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?
ALIas
Returns
Examples
CATalog
<QString>[,<QString>...]
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. These messages are
then substituted for the alias whenever it is received as a command or query
248
provided ALIas:STATE has been turned ON. The ALIas:DEFIne? query returns
the definition of a selected alias.
Up to 10 aliases can be defined at one time. Aliases can be recursive. That is,
aliases can include other aliases with up to 10 levels of recursion.
Group
Alias
Syntax
ALIas:DEFIne <QString><Comma>{ <QString> | <Block> }

ALIas:DEFIne? <QString>
<Space>
ALIas
Arguments
DEFIne
<QString>
<Comma>
<Space>
<QString>
<Block>
<QString>
The first <QString> is the alias label. This label cannot be a command name.
Labels must start with a letter, and can contain only letters, numbers, and
underscores; other characters are not allowed. The label must be 12 characters.
The second <QString> or <Block> is a complete sequence of program messages.
The messages can contain only valid commands that must be separated by
semicolons and must follow all rules for concatenating commands (see page
24). The sequence must be 80 characters.
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 digitizing oscilloscope.
ALIAS:DEFINE? "ST1"
might return :ALIAS:DEFINE "ST1",#239:RECALL:SETUP 5;:AUTOSET
EXECUTE;:SELECT:CH1 ON
249
ALIas:DELEte (No Query Form)

Removes a specified alias. This command is identical to ALIas:DELEte:NAMe.
Group
Alias
Syntax
ALIas:DELEte <QString>
ALIas
Arguments
Examples
DELEte
<QString>
<Space>
<QString> is the name of the alias you want to remove. Using ALIas:DELEte
without specifying an alias causes an execution error. <QString> must be a
previously defined alias.
ALIAS:DELETE "SETUP1"
deletes the alias named SETUP1.
ALIas:DELEte:ALL (No Query Form)

Deletes all existing aliases.
Group
Alias
Syntax
ALIas:DELEte:ALL
ALIas
Examples
DELEte
ALL
ALIAS:DELETE:ALL
deletes all aliases.
ALIas:DELEte:NAMe (No Query Form)

Removes a specified alias. This command is identical to ALIas:DELEte.
250
Group
Alias
Syntax
ALIas:DELEte:NAMe <QString>

Arguments
Examples
!

!
! is the name of the alias to remove. Using ALIas:DELEte:NAMe

without specifying an alias causes an execution error. ! must be a
previously defined alias.

deletes the alias named STARTUP.
ALIas:STATE
Turns aliases on or off. This command is identical to the ALIas command.
Group
Alias
Syntax
" # # $

Arguments

or = 0 turns alias expansion off. If a defined alias is sent when

ALIas:STATE is OFF, a command error (102) will be generated.
or 0 turns alias expansion on. When a defined alias is received, the
specified command sequence is substituted for the alias and executed.
Examples

turns the command alias feature off.

returns when alias mode is off.
ALLEv? (Query Only)

Causes the digitizing oscilloscope to return all events and their messages, and
removes the returned events from the Event Queue. The messages are separated
251
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 31. This command is
similar to repeatedly sending *EVMsg? queries to the instrument.
Group
Related Commands
Syntax
Status and error

*CLS, DESE, *ESE, *ESR?, EVENT?, EVMsg?, EVQTY, *SRE, *STB?
ALLEv?
ALLEv
Returns
The event code and message in the following format:

<Event Code><Comma><QString>[<Comma><Event Code><Comma>
<QString>...]
<QString>::= <Message>;[<Command>]
<Command> is the command that caused the error and may be returned when a
command error is detected by the digitizing oscilloscope. As much of the
command will be returned as possible without exceeding the 60 character limit
of the <Message> and <Command> strings combined. The command string is
right-justified.
Examples
ALLEV?
might return the string :ALLEV 2225,"Measurement error, No waveform to
measure; ",420,"Query UNTERMINATED; ".
ALLOcate? (Query Only)

Returns the number of data points allocated for all four reference memory
locations.
Group
Save and Recall
Syntax
ALLOcate?
ALLOcate
252
Examples
ALLOCATE?
might return :ALLOCATE:WAVEFORM:REF1 50000;REF2 0;REF3 0; REF4 0;,
indicating that all 50000 data points are allocated to reference memory location 1.
ALLOcate:WAVEform? (Query Only)

Returns the number of data points allocated for all four reference memory
locations.
Group
Save and Recall
Syntax
ALLOcate:WAVEform?
ALLOcate
Examples
WAVEform
ALLOCATE?
might return :ALLOCATE:WAVEFORM:REF1 500;REF2 500;REF3 500; REF4 0;,
indicating that 500 data points are allocated to each of the first three reference
memory locations.
ALLOcate:WAVEform:FREE? (Query Only)

Returns the approximate number of data points that have not been allocated.
Group
Save and Recall
Syntax
ALLOcate:WAVEform:FREE?
ALLOcate
Returns
Examples
WAVEform
FREE
<NR1> is the approximate number of data points available.

ALLOCATE:WAVEFORM:FREE?
might return 520 indicating that there are approximately 500 data points
available for allocation. The extra 20 are used for administration purposes.
253
ALLOcate:WAVEform:REF<x>
Sets or queries the number of waveform data points for the specified reference
location. If an attempt is made to allocate memory when it is not available, an
execution error is generated and the memory is not allocated.
Group
Save and Recall
Syntax
ALLOcate:WAVEform:REF<x> <NR1>
ALLOcate:WAVEform:REF<x>?
<Space>
ALLOcate
WAVEform
REF
<NR1>
<x>
?
Arguments
<NR1> = 0 is returned when the reference location is empty.

<NR1> 0 specifies the number of data points. For the TDS 4XX, 5XXA, &
7XXA, they can be 500, 1000, 2500, 5000, or 15000. The TDS 7XXA also
provides a standard 50000 for all 4 references and, with Option 1M, 75000 for
up to 3 references, 100000 or 130000 for up to 2 references, or 250000 for 1
reference. No complete references are stored for 500000 data points. The TDS
4XX Option 1M allows 30000 or 60000. The TDS 5XXA allow 50000 with
Option 1M. The TDS 620A, 640A, & 644A offers 500, 1000, or 2000 samples.
The TDS 684A provides 500, 1000, 2500, 5000, and 15000. In the TDS 5XXA
and 6XXA, all invalid values less than the maximum will be forced to the next
highest valid value, and those higher than the maximum will be forced to the
maximum. For example, 15002 points on a TDS 544A with option 1M will
allocate 50000 points of data for the reference.
Examples
ALLOCATE:WAVEFORM:REF2 1000
reserves 1,000 data points for REF2.
ALLOCATE:WAVEFORM:REF1?
might return 500
APPMenu
Displays the user-definable Application menu, and the query returns the current
Application menu labels and title. This is equivalent to pressing the front-panel
APPLICATION button.
254
Group
Related Commands
Syntax
Application Menu
CLEARMenu, *ESR, EVENT?
APPMenu ACTivate
APPMenu?
APPMenu
Arguments
ACTivate
<Space>
?
ACTivate displays the Application menu. Use the CLEARMenu command to

deactivate the Application menu.
Once the Application menu is activated, whenever a front-panel menu button is
pressed an event is generated that tells which button was pressed. See page 317
for event codes.
Menu button presses will also generate Service Requests when the URQ bit is
enabled in DESER and ESER and the ESB bit is enabled in SRER. See page 31
for a complete discussion of the use of these registers.
Examples
APPMENU ACTIVATE
displays the application menu.
APPMenu:LABel
Removes all user-defined Application menu button labels from the display. The
APPMenu:LABel? query returns all the current label settings.
Group
Application Menu
Syntax
APPMenu:LABel CLEar
APPMenu:LABel?
<Space>
APPMenu
CLEar
LABel
?
255
Arguments
Examples
CLEar removes the main and side menu button labels from the display. Front-panel bezel button presses will continue to generate events.
APPMENU:LABEL CLEAR
clears the user-defined menu labels from the display.
APPMenu:LABel:BOTTOM<x>
Defines a label for the main menu button that is specified by <x>. Main menu
buttons are located along the bottom of the display, and are numbered from 1 to
7 starting with the left-most button.
Group
Application Menu
Syntax
APPMenu:LABel:BOTTOM<x> <QString>
APPMenu:LABel:BOTTOM<x>?
<Space>
APPMenu
LABel
Arguments
BOTTOM
<x>
<QString>
?
<QString> is the menu button label and can include any of the characters shown
in the TDS Character Chart in Appendix A. The maximum length of the label is
1000 characters. The TDS displays the label in the area above the specified main
menu button.
The TDS displays the label on a single line and centers it, both vertically and
horizontally, within the label area. You can embed a line feed character in the
string to position the label on multiple lines. You can also use white space tab
characters to position the label within a line.
You can send a tab by transmitting a tab character (decimal 9) 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 label area. For example, to tab to pixel 13, send
TAB (decimal 9), NUL (decimal 0), and CR (decimal 13).
The ESC @ character turns reverse video on and off, and can be embedded in the
label string. The first ESC @ character displays all text following the ESC @ in
reverse video until another ESC @ character is found in the string.
256
NOTE. The use of any undocumented codes may produce unpredictable results.
The label area is 45 pixels high and 90 pixels wide. The length of the label that
fits in the label area depends on the contents of the label, because the width of
characters varies. The label area is about 10 characters wide and 3 lines high. For
a complete list of character widths in pixels, see Table A1 on page A1.
If the label exceeds the limits of the label area, either horizontally or vertically,
the portion of the label that exceeds the limits will not be displayed. Note: the
label itself is not altered. The entire label can be returned as a query response
regardless of what is displayed.
Examples

assigns the label SETUP1 to the third main menu button.
APPMenu:LABel:RIGHT<x>
Defines a label for the side menu button that is specified by <x>. Side menu
buttons are located on the right side of the display, and are numbered from 1 to 5
starting with the top-most button.
Group
Application Menu
Syntax
#
$ "!
#
$

#

Arguments

$
"!

"! is the menu button label and can include any of the characters shown
in the TDS Character Chart in Appendix A. The maximum length of the label is
1000 characters. The label is displayed in the area to the left of the specified side
menu button. Refer to the APPMenu:LABel:BOTTOM<x> command on page
256 for more information on defining menu labels.
257
Examples
&

displays the label TEST ON next to the top side menu button.
APPMenu:TITLe
Sets or queries the user-defined application menu title. The title is displayed
above the side menu.
Group
Related Commands
Syntax
Application Menu
APPMenu, APPMenu:LABel
% $"
%
!
%
Arguments

$"

$" is the side menu title and can include any of the characters shown in
the TDS Character Chart in Appendix A. The maximum length of the title is
1000 characters. The APPMenu:LABel:BOTTOM<x> command on page 256
provides information on defining menu labels.
Examples

%#$ %
displays the title Custom Menu on the screen.

might return #$ $%! for the current application menu title.
AUTOSet (No Query Form)

Causes the digitizing oscilloscope to adjust its vertical, horizontal, and trigger
controls to provide a stable display of the selected waveform. This is equivalent
to pressing the front-panel AUTOSET button. For a detailed description of the
258
autoset function, see Autoset in the Reference section of the User Manual for
your instrument.
Group
Miscellaneous
Syntax

Arguments

autosets the displayed waveform.
BELl (No Query Form)

Beeps the audio indicator of the digitizing oscilloscope.
Group
Miscellaneous
Syntax

Examples

rings the bell.
BUSY? (Query Only)

Returns the status of the digitizing oscilloscope. This command allows you to
synchronize the operation of the digitizing oscilloscope with your application
program. Synchronization methods are described on page 37.
Group
Related Commands
Syntax
Status and error

*OPC, *WAI

259

Returns

= 0 means that the digitizing oscilloscope is not busy processing a
command whose execution time is extensive. These commands are listed in
Table 223.

= 1 means that the digitizing oscilloscope is busy processing one of the
commands listed in Table 223.
Table 223: Commands that Affect BUSY? Response
Examples
Operation
Command
Single sequence acquisition
ACQuire:STATE ON or
ACQuire:STATE RUN
(when ACQuire:STOPAfter is set to SEQuence)
Hardcopy output
HARDCopy STARt

might return , indicating that the instrument is busy.
*CAL? (Query Only)

Instructs the digitizing oscilloscope to perform an internal self-calibration and
return its calibration status.
NOTE. The self-calibration can take several minutes to respond. No other
commands will be executed until calibration is complete.
Group
Calibration and Diagnostic
Syntax

Returns

= 0 indicates that the calibration completed without any errors detected.

0 indicates that the calibration did not complete successfully.
260
Examples
*CAL?
performs an internal self-calibration and might return 0 to indicate that the
calibration was successful.
CH<x>? (Query Only)

Returns the vertical parameters. Because CH<x>:SCAle and CH<x>:VOLts are
identical, only CH<x>:SCAle is returned.
Group
Vertical
Syntax
CH<x>?
CH
Examples
<x>
CH1?
might return the string :CH1:SCALE 10.0E-3;POSITION 0.0E+0;
OFFSET 0.0E+0;COUPLING DC;IMPEDANCE MEG;BANDWIDTH FULL for channel 1.
CH<x>:BANdwidth
Sets or queries the bandwidth setting of the specified channel. This is equivalent
to setting Bandwidth in the Vertical menu.
Group
Vertical
Syntax
CH<x>:BANdwidth { TWEnty | HUNdred (All TDS except 684A & 7XXA) |

TWOfifty (TDS 684A & 7XXA) | FULl }
CH<x>:BANdwidth?
TWEnty
HUNdred
<Space>
TWOfifty
FULl
CH
<X>
BANdwidth
261
Arguments
"%' sets the channel bandwidth to 20 MHz.

$ sets the channel bandwidth to 100 MHz (All TDS except 684A &
7XXA).
%' sets the channel bandwidth to 250 MHz (TDS 684A & 7XXA only).
! sets the channel bandwidth to the full bandwidth of the digitizing oscilloscope.
Examples

sets the bandwidth of channel 2 to 20 MHz.

might return , which indicates that there is no bandwidth limiting on
channel 1.
CH<x>:COUPling
Sets or queries the input attenuator coupling setting of the specified channel.
This is equivalent to setting Coupling in the Vertical menu.
Group
Related Commands
Syntax
Vertical
CH<x>:IMPedance
&
! " (
)
) *
&
! "

#

&
Arguments
! "

sets the specified channel to AC coupling.

sets the specified channel to DC coupling.
sets the specified channel to ground. Only a flat ground-level waveform will
be displayed.
262
Examples

establishes AC coupling on channel 1.

might return
, indicating that channel 3 is set to DC coupling.
CH<x>:IMPedance
Sets or queries the impedance setting at the specified input channel. This is
equivalent to setting the Impedance in the Ch<x> Coupling Impedance side
menu.
TDS 684A and 7XXA only: When you attach an active 50 W probe to an input
channel of the TDS 684A or 7XXA, the oscilloscope reduces the maximum
vertical scale from 10 V to 1 V per division. For example, an active 10X probe
would provide 10 V per division and a passive 10X probe would provide 100 V
per division.
Group
Related Commands
Syntax
Vertical
CH<x>:COUPling
! " #

Arguments

sets the specified channel to 50 W impedance.

sets the specified channel to 1 MW impedance.
Examples

establishes 50 W impedance on channel 1.

might return , indicating that channel 3 is set to 1 MW impedance.
263
CH<x>:OFFSet
Sets or queries the offset, 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
Related Commands
Syntax
Vertical
CH<x>:POSition
CH<x>:OFFSet <NR3>
CH<x>:OFFSet?
<Space>
CH
<x>
<NR3>
OFFSet
?
Arguments
<NR3> is the desired offset in volts. The range is dependent on the scale and the
probe attenuation factor. The offset ranges are shown below.
Table 224: Offset Ranges for the TDS 4XX, 54XA, 6XXA, & 7XXA (All Channels)
and the TDS 520A & 524A (Channel 1 & Channel 2) using a 1x Probe
CH<x>:SCAle
OFFSet Range
1 mV/div 99.5 mV/div
1 V
100 mV/div 995 mV/div
10 V
1 V/div 10 V/div
100 V
Table 225: Offset Ranges for the TDS 520A & 524A (Aux 1 & Aux 2) using a 1x
Probe
Examples
264
CH<x>:SCAle
OFFSet Range
50 mV/div & 100 mV/div
.5 V
500 mV/div & 1 V/div
5.0 V
5 V/div & 10 V/div
50 V
CH1:OFFSET 0.5E+00
lowers the channel 1 displayed waveform by 0.5 volts.
CH1:OFFSET?
might return 500.0E-3, indicating that the current channel 1 offset is 0.5 volts.
CH<x>:POSition
Sets or queries the vertical position of the specified channel. The position value
is applied to the signal before digitization. This is equivalent to setting Position
in the Vertical menu or adjusting the front-panel Vertical Position knob.
Group
Related Commands
Syntax
Vertical
CH<x>:OFFSet
CH<x>:POSition <NR3>
CH<x>:POSition?
<Space>
CH
<x>
<NR3>
POSition
?
Arguments
<NR3> is the desired position, in divisions from the center graticule. The range is
5 divisions.
Examples
CH2:POSITION 1.3E+00
positions the channel 2 input signal 1.3 divisions above the center of the display.
CH1:POSITION?
might return -1.3E+00, indicating that the current position of channel 1 is at
1.3 divisions.
CH<x>:PRObe? (Query Only)

Returns the attenuation factor of the probe that is attached to the specified
channel.
Group
Vertical
Syntax
CH<x>:PRObe?
265
CH
Returns
Examples
<x>
PRObe
<NR3>
CH4:PROBE?
might return 100.0E-3 for a 10x probe.
CH<x>:SCAle
Sets or queries the vertical gain of the specified channel. This is equivalent to
setting Fine Scale in the Vertical menu or adjusting the front-panel Vertical
SCALE knob.
Group
Related Commands
Syntax
Vertical
CH1:VOLts
CH<x>:SCAle <NR3>
CH<x>:SCAle?
<Space>
<x>
CH
<NR3>
SCAle
?
Arguments
Examples
<NR3> is the gain, in volts per division. The range is 100 mV per division to
1 mV per division when using a 1x probe.
CH4:SCALE 100E-03
sets the channel 4 gain to 100 mV per division.
CH2:SCALE?
might return 1.00E+0, indicating that the current V per division setting of
channel 2 is 1 V per division.
CH<x>:VOLts
Sets or queries the vertical gain of the specified channel. This command is
identical to the CH<x>:SCAle command and is included for compatibility
purposes. Only CH<x>:SCAle is returned in response to a CH<x>? query.
266
Group
Related Commands
Syntax
Vertical
CH1:SCAle
CH<x>:VOLts <NR3>
CH<x>:VOLts?
<Space>
CH
<x>
<NR3>
VOLts
?
Examples
CH4:VOLTS 100E-03
sets the channel 4 gain to 100 mV per division.
CH2:VOLTS?
might return 1.00E+0, indicating that the current V per division setting of
channel 2 is 1 V per division.
CLEARMenu (No Query Form)

Clears the current menu from the display. This command is equivalent to
pressing the CLEAR MENU button on the front panel.
Group
Display
Syntax
CLEARMenu
CLEARMenu
Examples
CLEARMENU
clears the menu from the display.
*CLS (No Query Form)

Clears the digitizing oscilloscope status data structures.
Group
Status and Error
267
Related Commands
Syntax
DESE, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB?

*CLS
*CLS
The *CLS command clears the following:

H
the Event Queue
the Standard Event Status Register (SESR)
the Status Byte Register (except the MAV bit; see below)
If the *CLS command immediately follows an <EOI>, the Output Queue and
MAV bit (Status Byte Register bit 4) are also cleared. MAV indicates information is in the output queue. The device clear (DCL) GPIB control message will
clear the output queue and thus MAV. *CLS does not clear the output queue or
MAV. (A complete discussion of these registers and bits, and of event handling
in general, begins on page 31.)
*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.
Group
Cursor
Syntax
CURSor?
CURSor
Examples
268
CURSOR?
might return :CURSOR:FUNCTION OFF;VBARS:UNITS SECONDS;
POSITION1 500.0E-6;POSITION2 4.50E-3;SELECT CURSOR1;
:CURSOR:HBARS:POSITION1 3.20E+0;POSITION2 -3.20E+0;
SELECT CURSOR1 as the current cursor settings.
CURSor:FUNCtion
Selects and displays the cursor type. Cursors are attached to the selected
waveform. This command is equivalent to setting Function in the Cursor menu.
Group
Related Commands
Syntax
Cursor
SELect:CONTROl
CURSor:FUNCtion { HBArs | OFF | VBArs | PAIred }
CURSor:FUNCtion?
HBArs
OFF
<Space>
VBArs
PAIred
CURSor
Arguments
FUNCtion
HBArs specifies horizontal bar cursors that measure volts.

OFF removes the cursors from the display.
VBArs specifies vertical bar cursors that measure time.
PAIred specifies paired cursors that measure both time and volts.
Examples
CURSOR:FUNCtion VBARS
selects vertical bar type cursors.
CURSor:HBArs? (Query Only)

Returns the current settings for the horizontal bar cursors.
Group
Cursor
Syntax
CURSor:HBArs?
269
CURSor
Examples
HBArs
CURSOR:HBARS?
might return :CURSOR:HBARS:POSITION1 0;POSITION2 0;SELECT CURSOR1.
CURSor:HBArs:DELTa? (Query Only)

Returns the voltage difference between the two horizontal bar cursors.
Group
Cursor
Syntax
CURSor:HBArs:DELTa?
CURSor
Returns
Examples
HBArs
DELTa
<NR3>
CURSOR:HBARS:DELTA?
might return 5.08E+0 for the voltage difference between the two cursors.
CURSor:HBArs:POSITION<x>
Positions a horizontal bar cursor.
Group
Cursor
Syntax
CURSor:HBArs:POSITION<x> <NR3>
CURSor:HBArs:POSITION<x>?
<Space>
CURSor
HBArs
POSITION
<NR3>
<x>
?
Arguments
Examples
270
<NR3> specifies the cursor position relative to ground, in volts.

CURSOR:HBARS:POSITION1 25.0E-3
positions one of the horizontal cursors at 25.0 mV.
CURSOR:HBARS:POSITION2?
might return -64.0E-3, indicating that one of the horizontal bar cursors is at
64.0 mV.
CURSor:HBArs:SELect
Selects which horizontal bar cursor is active for front-panel control. The active
cursor will be displayed as a solid horizontal line and can be moved using the
front-panel general purpose knob when the cursor menu is active. The unselected
cursor will be displayed as a dashed horizontal line. This command is equivalent
to pressing the SELECT button (TOGGLE on the TDS 4XX) on the front panel
when the Cursor menu is displayed.
Group
Cursor
Syntax
CURSor:HBArs:SELect { CURSOR1 | CURSOR2 }

CURSor:HBArs:SELect?
<Space>
CURSOR1
CURSOR2
CURSor
HBArs
Arguments
SELect
CURSOR1 selects the first horizontal bar cursor.

CURSOR2 selects the second horizontal bar cursor.
Examples
CURSOR:HBARS:SELECT CURSOR1
selects the first horizontal bar cursor as the active cursor.
CURSOR:HBARS:SELECT?
returns CURSOR1 when the first cursor is the active cursor.
CURSor:HBArs:UNIts
TDS 5XXA, 6XXA, & 7XXA Only
Sets or queries the units for the horizontal bar cursors. This is equivalent to
setting Amplitude in the Cursor menu.
271
Group
Cursor
Syntax
CURSor:HBArs:UNIts { BASe | IRE }

CURSor:HBArs:UNIts?
BASe
<Space>
IRE
CURSor
HBArs
Arguments
UNIts
BASe specifies base as the unit of measure.

IRE specifies IRE as the unit of measure. These units are typically used with
video signals.
Examples
CURSOR:HBARS:UNITS BASE
sets the units for the horizontal bar cursors to base.
CURSOR:HBARS:UNITS?
returns IRE when the horizontal bar cursor units are IRE.
CURSor:MODe
Selects whether the two cursors move together in unison or separately.
Group
Related Commands
Syntax
Cursor
CURSor:FUNCtion
CURSor:MODe { TRACk | INDependent }
CURSor:MODe?
<Space>
CURSor
Arguments
272
MODe
TRACk
INDependent
?
TRACk ties the two cursors together as you move the general purpose knob.
INDependent frees the two cursors to move separately.
Examples
CURSOR:MODE TRACK
specifies that the cursors positions move in unison.
CURSOR:MODE?
might return :TRACK showing the two cursors move in unison.
CURSor:PAIred
Positions the paired cursors. Also, returns the current paired cursor settings.
Group
Related Commands
Syntax
Cursor
DATa:STARt, DATa:STOP
CURSor:PAIred SNAp
CURSor:PAIred?
<Space>
CURSor
SNAp
PAIred
?
Arguments
Examples
SNAp positions the paired cursors at DATa:STARt and DATa:STOP.

CURSOR:PAIRED SNAP
specifies the positions of the cursors are at the current DATA:START and
DATA:STOP values.
CURSOR:PAIRED?
might return :CURSOR:PAIRED:UNITS BASE;POSITION1 -2.00E-3;POSITION2
2.00E-3;SELECT CURSOR2.
CURSor:PAIred:HDELTA (Query Only)

Queries the hbar (voltage) distance between the first and second paired cursor.
This is the absolute value of the vertical position of the first cursor minus the
vertical position of the second cursor.
Group
Cursor
273
Related Commands
Syntax
CURSor:FUNCtion
CURSor:PAIred:HDELTA?
CURSor
Examples
PAIred
HDELTA
CURSOR:PAIRED:HDELTA?
might return 5.08E+0 for the voltage difference between the two cursors.
CURSor:PAIred:HPOS1 (Query Only)

Queries the horizontal bar (voltage) position of the first paired cursor.
Group
Related Commands
Syntax
Cursor
CURSor:FUNCtion
CURSor:PAIred:HPOS1?
CURSor
Examples
PAIred
HPOS1
CURSOR:PAIRED:HPOS1?
might return -64.0E-3, indicating that the first cursor is at 64.0 mV.
CURSor:PAIred:HPOS2 (Query Only)

Queries the horizontal bar (voltage) position of the second paired cursor.
Group
Related Commands
Syntax
Cursor
CURSor:FUNCtion
CURSor:PAIred:HPOS2?
CURSor
274
PAIred
HPOS2
Examples
CURSOR:PAIRED:HPOS2?
might return -64.0E-3, indicating the second cursor is at 64.0 mV.
CURSor:PAIred:POSITION1
Sets or queries the vertical bar (time) position of the first paired cursor.
Group
Related Commands
Syntax
Cursor
CURSor:FUNCtion
CURSor:PAIred:POSITION1 <NR3>
CURSor:PAIred:POSITION1?
<Space>
CURSor
PAIred
<NR3>
POSITION1
?
Arguments
<NR3> specifies the position of the first paired cursor.

The position can appear in units of seconds, 1/seconds (hertz), or video line
numbers (with option 05).
Examples
CURSOR:PAIRED:POSITION1 9.00E-6
specifies the first paired cursor is at 9 ms.
CURSOR:POSITION1?
might return 1.00E-6, indicating that the first paired cursor is at 1 ms.
CURSor:PAIred:POSITION2
Sets or queries the vertical bar (time) position of the second paired cursor.
Group
Related Commands
Syntax
Cursor
CURSor:FUNCtion
CURSor:PAIred:POSITION2 <NR3>
275
CURSor:PAIred:POSITION2?
<Space>
CURSor
PAIred
<NR3>
POSITION2
?
Arguments
<NR3> specifies the position of the second paired cursor.

Examples
CURSOR:POSITION2?
might return 1.00E-6, indicating that the second paired cursor is at 1 ms.
CURSor:PAIred:SELect
Selects the active paired cursor. The active cursor appears as a solid vertical line.
The unselected cursor appears as a dashed vertical line. This command is
equivalent to pressing the SELECT button (TOGGLE on the TDS 4XX) on the
front panel when the Cursor menu is displayed.
Group
Cursor
Syntax
CURSor:PAIred:SELect { CURSOR1 | CURSOR2 }

CURSor:PAIred:SELect?
<Space>
CURSor
Arguments
PAIred
CURSOR1
CURSOR2
SELect
CURSOR1 specifies the first paired cursor.

CURSOR2 specifies the second paired cursor.
Examples
276
CURSOR:PAIRED:SELECT CURSOR2
selects the second paired cursor as the active cursor.
CURSOR:PAIRED:SELECT?
returns CURSOR1 when the first paired cursor is the active cursor.
CURSor:PAIred:UNIts
Sets or queries the units for the paired cursors. This is equivalent to setting
Amplitude in the Cursor menu.
Group
Cursor
Syntax
CURSor:PAIred:UNIts { BASe | IRE }

CURSor:PAIred:UNIts?
<Space>
BASe
IRE
CURSor
PAIred
Arguments
UNIts
BASe specifies base as the unit of measure.

IRE specifies IRE as the unit of measure. These units are typically used with
video signals.
Examples
CURSOR:PAIRED:UNITS BASE
sets the units for the paired cursors to base.
CURSOR:PAIRED:UNITS?
returns IRE when the paired cursor units are IRE.
CURSor:PAIred:VDELTA (Query Only)

Queries the vbar (time) distance between paired cursors. It returns the absolute
value of the first cursor less the second cursor horizontal positions.
Group
Cursor
277
Related Commands
Syntax
CURSor:FUNCtion
CURSor:PAIred:VDELTA?
CURSor
Examples
PAIred
VDELTA
CURSOR:PAIRED:VDELTA?
might return 1.064E+00, indicating that the time between the paired cursors is
1.064 seconds.
CURSor:VBArs
Positions the vertical bar cursors and the CURSor:VBArs? query returns the
current vertical bar cursor settings for horizontal position, delta, cursor selection,
and units.
Group
Related Commands
Syntax
Cursor
DATa:STARt, DATa:STOP, MEASUrement:GATing
CURSor:VBArs SNAp
CURSor:VBArs?
<Space>
CURSor
Arguments
Examples
VBArs
SNAp
?
SNAp positions the vertical bar cursors at DATa:STARt and DATa:STOP.

CURSOR:VBARS SNAP
specifies that the cursors positions are the same as the current DATA:START and
DATA:STOP values.
CURSOR:VBARS?
might return :CURSOR:VBARS:UNITS SECONDS;POSITION1 1.00E-6;POSI
TION2 9.00E-6;SELECT CURSOR2.
278
CURSor:VBArs:DELTa? (Query Only)

Returns the time or frequency between the two vertical bar cursors. The units,
seconds or Hertz, are specified by the CURSor:VBArs:UNIts command.
Group
Cursor
Related Commands
CURSor:VBArs:UNIts
Syntax
CURSor:VBArs:DELTa?
CURSor
Returns
Examples
VBArs
DELTa
<NR3>
CURSOR:VBARS:DELTa?
might return 1.064E+00, indicating that the time between the vertical bar cursors
is 1.064 seconds.
CURSor:VBArs:POSITION<x>
Positions a vertical bar cursor for both vertical bar and paired cursors. The
CURSor:VBArs:UNIts command specifies units.
Group
Related Commands
Syntax
Cursor
CURSor:VBArs:UNIts
CURSor:VBArs:POSITION<x> <NR3>
CURSor:VBArs:POSITION<x>?
279
<Space>
CURSor
VBArs
POSITION
<NR3>
<x>
?
<NR3> specifies the cursor position in the units specified by the CURSor:VBArs:UNIts command. The position is relative to the trigger position.
Arguments
CURSOR:VBARS:POSITION2 9.00E-6
positions one of the vertical bar cursors at 9 ms.
Examples
CURSOR:VBARS:POSITION1?
might return 1.00E-6, indicating a vertical bar cursors is at 1 ms.
CURSor:VBArs:SELect
Selects which vertical bar cursor is active. The active cursor will be displayed as
a solid vertical line and can be moved using the front-panel general purpose knob
when the cursor menu is active. The unselected cursor will be displayed as a
dashed vertical line. This command is equivalent to pressing the SELECT
button (TOGGLE on the TDS 4XX) on the front panel when the Cursor menu is
displayed.
Group
Cursor
Syntax
CURSor:VBArs:SELect { CURSOR1 | CURSOR2 }

CURSor:VBArs:SELect?
<Space>
CURSor
Arguments
VBArs
SELect
CURSOR1
CURSOR2
?
CURSOR1 specifies the first vertical bar cursor.

CURSOR2 specifies the second vertical bar cursor.
Examples
CURSOR:VBARS:SELECT CURSOR2
selects the second vertical bar cursor as the active cursor.
CURSOR:VBARS:SELECT?
returns CURSOR1 when the first vertical bar cursor is the active cursor.
280
CURSor:VBArs:UNIts
Sets or queries the units for the vertical bar cursors. This is equivalent to setting
Time Units in the Cursor menu.
Group
Related Commands
Syntax
Cursor
CURSor:VBArs:DELTa?, CURSor:VBArs:POSITION<x>
CURSor:VBArs:UNIts { SECOnds | HERtz | LINE (with option 05) }
CURSor:VBArs:UNIts?
SECOnds
<Space>
CURSor
Arguments
VBArs
UNIts
HERtz
LINE
?
SEConds specifies seconds as the unit of measure.

HERtz specifies hertz as the unit of measure.
LINE specifies line as the unit of measure. Use this only if you have option 05
video trigger installed. If you do not have option 05, use of this argument will
generate an error message.
Examples
CURSOR:VBARS:UNITS SECONDS
sets the units for the vertical bar cursors to seconds.
CURSOR:VBARS:UNITS?
returns HERTZ when the vertical bar cursor units are hertz.
281
CURVe
Transfers waveform data to and from the digitizing oscilloscope in binary or
ASCII format. Each waveform that is transferred has an associated waveform
preamble which contains information such as data format and scale. Refer to the
WFMPre command starting on page 2284 for information about the waveform
preamble. The data format is specified by the DATa:ENCdg and DATa:WIDTH
commands.
The CURVe? query transfers data from the instrument. The data source is
specified by the DATa:SOUrce command. If more than one source is specified, a
comma separated list of data blocks is returned. The first and last data points that
are transferred are specified by the DATa:STARt and DATa:STOP commands.
The CURVe command transfers waveform data to the instrument. The data is
stored in the reference memory location specified by DATa:DESTination starting
with the data point specified by DATa:STARt. Only one waveform can be
transferred at a time. The waveform will only be displayed if the reference is
displayed.
A description of the waveform transfer process starts on page 232.
Group
Related Commands
Syntax
Waveform
DATa, WFMPre
* + # %"& ,

!
# %"&

Arguments
282
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 $ command to set the width. <data>
is the curve data. <newline> is a single byte newline character at the end of the
data. See the
or examples in the accompanying disk for
more specifics.
is the waveform data in ASCII format. The format for ASCII data
is where each represents a data point.
Examples

might return, for ASCII data:

283
DATa
Sets or queries the format and location of the waveform data that is transferred
with the CURVe command. Since DATa:DESTination and DATa:TARget are
equivalent, only DATa:DESTination is returned by the DATa? query.
Group
Related Commands
Syntax
Waveform
CURVE, WAVFrm
DATa { INIT | SNAp }
DATa?
<Space>
DATa
Arguments
INIT
SNAp
?
INIT initializes the waveform data parameters to their factory defaults.

SNAp sets DATa:STARt and DATa:STOP to match the current vertical bar cursor
positions.
Examples
DATA SNAP
assigns the current position of the vertical bar cursors to DATA:START and
DATA:STOP.
DATA?
might return the string :DATA:ENCDG RPBINARY;DESTINATION REF4; SOURCE
REF4;START 1;STOP 500;WIDTH 2
DATa:DESTination
Sets or queries the reference memory location for storing waveform data that is
transferred into the digitizing oscilloscope by the CURVe command. This
command is identical to the DATa:TARget command.
Group
284
Waveform
Syntax
DATa:DESTination REF<x>
DATa:DESTination?
<Space>
DATa
REF
<x>
DESTination
?
Arguments
Examples
REF<x> (REF1, REF2, REF3 or REF4) is the reference memory location where the
waveform will be stored.
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 queries 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 226. Setting the DATa:ENCdg value causes the corresponding
WFMPre values to be updated and vice versa.
Group
Related Commands
Syntax
Waveform
WFMPre:ENCdg, WFMPre:BN.FMT, WFMPre:BYT_Or
DATa:ENCdg { ASCIi | RIBinary | RPBinary | SRIbinary | SRPbinary}
DATa:ENCdg?
285

Arguments

specifies the ASCII representation of signed integer (
) data. If
this is the value at power-on, the WFMPre values for BN_Fmt, BYT_Or, and
ENCdg are set as RP, MSB, and ASC respectively.

specifies signed integer data-point representation with the most
significant byte transferred first. This format results in the fastest data transfer
rate when DATa:WIDth is set to 2.
The range is 128 to 127 when DATa:WIDth is 1. Zero is center screen. The
range is 32768 to 32767 when DATa:WIDth is 2. The upper limit is one
division above the top of the screen and the lower limit is one division below the
bottom of the screen.
specifies positive integer data-point representation with the most
significant byte transferred first.
The range is 0 to 255 when DATa:WIDth is 1. 127 is center screen. The range is
0 to 65,535 when DATa:WIDth is 2. The upper limit is one division above the
top of the screen and the lower limit is one division below the bottom of the
screen.

is the same as
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.
is the same as 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.
286
Table 226: DATa and WFMPre Parameter Settings

WFMPre Settings
Examples
DATa N g Setting
DATa:ENCdg
e i g
:ENCdg
:BN_Fmt
:BYT_Or
ASCIi
ASC
N/A
N/A
RIBinary
BIN
RI
MSB
RPBinary
BIN
RP
MSB
SRIbinary
BIN
RI
LSB
SRIbinary
BIN
RP
LSB
DATA:ENCDG RPBINARY
sets the data encoding format to be positive integer where the most significant
byte is transferred first.
DATA:ENCDG?
might return SRPBINARY for the format of the waveform data.
DATa:SOUrce
Sets or queries the location of the waveform data that is transferred from the
instrument by the CURVe? query. The source data is always transferred in a
predefined order regardless of the order they are specified using this command.
The predefined order is CH1 through CH4, MATH1 through MATH3, then
REF1 through REF4.
Group
Waveform
Syntax
DATa:SOUrce <wfm>[<Comma><wfm>]...
DATa:SOUrce?
<Space>
DATa
Arguments
SOUrce
<wfm>
<Comma>
<wfm>
<wfm> is the location of the waveform data that will be transferred from the
digitizing oscilloscope to the controller.
287
Examples
DATA:SOURCE REF2, CH2, MATH1, CH1

specifies that four waveforms will be transferred in the next CURVE? query. The
order that the data will be transferred is CH1, CH2, MATH1, and then REF2.
DATA:SOURCE?
might return REF3, indicating the source for the waveform data that is transferred
using a CURVE? query.
DATa:STARt
Sets or queries the starting data point for waveform transfer. This command
allows for the transfer of partial waveforms to and from the digitizing oscilloscope.
Group
Related Commands
Syntax
Waveform
CURVe?, DATa SNAp, DATa:STOP
DATa:STARt <NR1>
DATa:STARt?
<Space>
DATa
<NR1>
STARt
?
Arguments
Examples
<NR1> ranges from 1 to the record length, and is the first data point that will be
transferred. Data will be transferred from <NR1> to DATa:STOP or the record
length, whichever is less. If <NR1> is greater than the record length then no data
will be transferred. When DATa:STOP is less than DATa:STARt, the values will
be swapped internally for the CURVe? query.
DATA:START 10
specifies that the waveform transfer will begin with data point 10.
DATA:START?
might return 214 as the first waveform data point that will be transferred.
DATa:STOP
Sets or queries the last data point that will be transferred when using the
CURVe? query. This allows the transfer of partial waveforms to the controller.
288
When using the CURVe command, the digitizing 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.
Group
Related Commands
Syntax
Waveform
CURVe?, DATa SNAp

Arguments
ranges from 1 to the record length, and is the last data point that will be
transferred. If is greater than the record length then data will be transferred
up to the record length. If both DATa:STARt and DATa:STOP are greater than
the record length, an execution error will be executed. When DATa:STOP is less
than DATa:STARt, the values will be swapped internally for the CURVe? query.
If you always want to transfer complete waveforms, just set DATa:STARt to 1
and DATa:STOP to the maximum record length.
Examples

specifies that the waveform transfer will stop at data point 15000.

might return as the last data point that will be transferred.
DATa:TARget
Sets or queries 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
Related Commands
Waveform
CURVe
289
Syntax

DATa:WIDth
Sets the number of bytes per data point in the waveform transferred using the
CURVe command.
Group
Related Commands
Syntax
Waveform
CURVe, WFMPre:BIT_Nr, WFMPre:BYT_Nr

Arguments
= 1 specifies that there is 1 byte (8 bits) per point. This format is useful
when the acquisition mode is set to SAMple, ENVelope, or PEAKdetect (one
byte per point). If used for AVErage or HIRes (two bytes per point), the low
order byte is not transmitted.
= 2 specifies that there are 2 bytes (16 bits) per point. This format is
useful for AVErage and HIRes (two bytes per point) waveforms. If used for
ENVelope, PEAKdetect, or SAMple (one byte per point), the least significant
byte is always zero.
Examples
290

sets the data width to 1 byte per data point for CURVe data.
DATE
Sets or queries the date that the digitizing oscilloscope can display.
Group
Related Commands
Syntax
Miscellaneous
DISplay: CLOCk, TIMe
DATE <QString>
DATE?
<Space>
DATE
Arguments
Examples
<QString>
?
<QString> is a date in the form yyyy-mm-dd".

mm refers to a two-digit month number from 01 to 12.
dd refers to a two-digit day number in the month.
yyyy refers to a four-digit year number.
There must a dash () after the yyyy and after the mm.
DATE "1993-01-24"
specifies that the date is set to January 24th, 1993.
*DDT
Allows the user to specify a command or a list of commands that are executed
when the instrument receives a *TRG command or the GET GPIB interface
message. This is just a special alias that *TRG uses.
Group
Related Commands
Syntax
Miscellaneous
ALIAS:DEFINE, *TRG, Get GPIB interface message
*DDT { <Block> | <QString> }
*DDT?
291
<Block>
<Space>
<QString>
*DDT
Arguments
<Block> or <QString> is a complete sequence of program messages. The

messages can contain only valid commands that must be separated by semicolons and must follow all rules for concatenating commands (see page 24). The
sequence must be 80 characters. <Block> format is always returned as a query
response.
Examples
*DDT #0ACQUIRE:STATE RUN;BELL<EOI>

specifies that the acquisition system will be started and the bell rings each time a
*TRG command is sent.
DELEte:SETUp (No Query Form)

Removes stored setups from memory and initializes the location with the factory
default setup.
NOTE. The setup information cannot be recovered once it has been deleted.
Group
Related Commands
Syntax
Save and Recall

*RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp, TEKSecure
DELEte:SETUp { <NR1> | ALL }
DELEte
Arguments
SETUp
<Space>
<NR1>
ALL
<NR1> is a value in the range 1 to 10, and specifies a setup storage location.
Using an out-of-range value causes an execution error.
ALL specifies all the stored setups.
292
Examples
DELETE:SETUP ALL
removes all stored setups. All ten storage locations are initialized to the factory
default setup.
DELEte:WAVEform (No Query Form)

Deletes one or all of the stored reference waveforms from memory. The memory
allocated for the reference location is then available for reallocation. Memory
must be reallocated for the deleted references before any waveform data can be
stored in the reference location.
NOTE. The waveform data is not actually cleared from the reference location.
Group
Related Commands
Syntax
DELEte
Save and Recall

RECAll:WAVEform, SAVe:WAVEform, TEKSecure
DELEte:WAVEform { REF<x> | ALL }
WAVEform
Arguments
<Space>
REF
<x>
ALL
REF<x> (REF1, REF2, REF3 or REF4) specifies one of the reference memory
locations.
ALL specifies all the stored waveforms.
Examples
DELETE:WAVEFORM ALL
removes all the waveforms stored in reference memory.
DELETE:WAVEFORM REF2
removes the waveform stored at REF2.
DESE
Sets and queries 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 31.
293
Group
Related Commands
Syntax
Status and Error

*CLS, *ESE, *ESR?, EVENT?, EVMsg?, *SRE, *STB?

Arguments
is a value in the range from 0 to 255. The binary bits of the DESER are
set according to this value. For example, sets the DESER to the binary
value 11010001 (that is, the most significant bit in the register is set to 1, the
next most significant bit to 1, the next bit to 0, etc.).
The power-on default for DESER is all bits set if is 1. If is 0, the
DESER 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 command to set the ESER. A discussion
of event handling begins on page 31.
Examples

sets the DESER to binary 11010001, which enables the PON, URQ, EXE, and
OPC bits.

might return the string , showing that the DESER contains the binary
value 10111010.
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
294
Related Commands
DIAg:RESUlt:LOG?
Syntax
DIAg:RESUlt:FLAg?
DIAg
Returns
RESUlt
FLAg
PASS indicating that all of the selected diagnostic tests have passed.
FAIl indicating that at least one of the selected diagnostic tests has failed.
Examples
DIAG:RESULT:FLAG?
returns either PASS or FAIl.
DIAg:RESUlt:LOG? (Query Only)

Returns the internal results log from the last diagnostic test sequence execution.
The list contains all modules and module interfaces that were tested along with
the pass/fail status of each.
Group
Related Commands
Syntax

DIAg:RESUlt:FLAg?
DIAg:RESUlt:LOG?
DIAg
Returns
RESUlt
LOG
<QString> in the following format:

<Status>,<Module name>[,<Status>,<Module name>...]
Examples
DIAG:RESULT:LOG?
might return :DIAG:RESULT:LOG "pass--Processor,pass--Display,
pass--FP/Proc Interface,FAIL--Front Panel"
295
DIAg:SELect:ACQUISition (No Query Form)

Selects the acquisition system test sequence that will be run when the
DIAg:STATE EXECUte command is sent. This command is equivalent to setting
Area in the Utility menu when System is set to Diag/Err.

Group
Syntax

Arguments

selects functional, memory, and register tests.
DIAg:SELect:ALL (No Query Form)

Specifies that all system test sequences will be run when the DIAg:STATE
EXECUte command is sent. This command is equivalent to setting Area in the
Utility menu when System is set to Diag/Err.

Group
Syntax

Arguments

selects functional, memory, and register tests for the acquisition, processor
and display systems, and self diagnostics for the front panel.
DIAg:SELect:CPU (No Query Form)

Selects the processor system test sequence that will be run when the
DIAg:STATE EXECUte command is sent. This command is equivalent to setting
Area in the Utility menu when System is set to Diag/Err.
296
Group
Syntax


Arguments

DIAg:SELect:DISplay (No Query Form)

Selects the display system test sequence that will be run when the DIAg:STATE

Group
Syntax

Arguments

DIAg:SELect:FPAnel (No Query Form)

Selects the front-panel test sequence that will be run when the DIAg:STATE

Group
Syntax

Arguments

selects self diagnostic tests.
297
DIAg:STATE (No Query Form)

Executes the diagnostic tests that have been specified with the DIAg:SELect
commands.
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. This
command is equivalent to running Extended Diagnostics by selecting Execute in
the Utility menu when System is set to Diag/Err.
NOTE. The DIAg:STATE EXECute command can take 30 seconds or more to
respond. This command performs a warm boot and does not return control to the
instrument controller until diagnostics are complete.
Group
Syntax

Arguments

runs the diagnostic test sequences specified by the DIAg:SELect

commands. When complete, the digitizing oscilloscope will return to the state it
was in just prior to the test. If the PON event was enabled before running the
tests, a Service Request will be generated. When the Service Request has been
received, the pass/fail status of the tests can be returned by executing the
DIAg:RESUlt:FLAg? query.
The DIAg:STATE EXECute command clears the following:
H
the Event Queue
the Input Queue
the Status Registers (SESR and SBR)
To enable a power-on event to generate a Service Request, send the following

commands before running diagnostics:
298
DESE 128
*ESE 128
*SRE 32
Examples
*PSC 0
DIAg:STATE EXECUTE
executes all the diagnostic tests that have been selected.
DISplay? (Query Only)

Returns the current display settings.
Group
Display
Syntax
DISplay?
DISplay
Examples
DISPLAY?
might return :DISPLAY:FORMAT YT;STYLE VECTORS;FILTER SINX;PERSIST
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 the
Display Date/Time in the Readout Options side menu. The query form returns
an ON (1) or an OFF (0).
Group
Display
Syntax
DISplay:CLOCk { OFF | ON | <NR1> }

DISplay:CLOCk?
OFF
<Space>
DISplay
CLOCk
ON
<NR1>
?
299
Arguments
<OFF> or <NR1> = 0 removes the clock from the display.

<ON> or <NR1> 0 displays the clock on the display.
Examples
DISPLAY:CLOCK ON
sets the display to show time and date.
DISPLAY:CLOCK?
might return 1 indicating that the display shows time and date.
DISplay:COLOr:CONTRast
TDS 5X4A, 6X4A, & 7XXA Only
Turns on or off the collision contrast option. The TDS will display overlapping
lines in a special collision color when this item is turned on. This is equivalent to
selecting Options from the main Color menu and toggling Collision Contrast in
the resulting side menu to ON or OFF.
Group
Display
Syntax
DISplay:COLOr:CONTRast { OFF | ON | <NR1> }

DISplay:COLOr:CONTRast?
OFF
<Space>
ON
<NR1>
DISplay
COLOr
Arguments
CONTRast
<OFF> or <NR1> = 0 turns off collision contrast.

<ON> or <NR1> 0 turns on collision contrast.
Examples
2100
DISPLAY:COLOR:CONTRAST ON
turns on the contrast option.
DISplay:COLOr:MAP:<item name>: BYCONTents

Determines if the color for a math or reference waveform is set to the color
assigned to the waveform contents (the constituent waveform) or to a specific
color index. This is equivalent to pressing Map Math Colors or Map Reference
Colors on the Color main menu and Color Matches Contents (to select the on
state) or Color (to select the off state) on the resulting side menu.
Group
Display
Syntax
DISplay:COLOr:MAP:{ MATH1 | MATH2 | MATH3 | REF1 | REF2 | REF3 |

REF4 }:BYCONTents { OFF | ON | <NR1> }
REF4 }:BYCONTents?
DISplay
COLOr
MAP
MATH1
MATH2
MATH3
REF1
OFF
REF2
<Space>
REF3
REF4
Arguments
ON
<NR1>
BYCONTents
<OFF> or <NR1> = 0 means set the color by index (NOT by contents).

<ON> or <NR1> 0 means set the color by contents (NOT by index).
Examples
DISPLAY:COLOR:MAP:MATH1:BYCONTENTS ON
sets the display of math waveform # 1 to the color of the waveform used to
define math waveform # 1. If two waveforms were used to defined math
waveform # 1, then the color of the first mentioned waveform is used.
DISPLAY:COLOR:MAP:MATH1:BYCONTENTS?
might return ON.
2101
DISplay:COLOr:MAP:<item name>: TO
Defines the color index to use if setting the color for a math or reference
waveform to the color assigned to a specific index. This is similar, but not
identical, to pressing Map Math Colors or Map Reference Colors on the Color
main menu, pressing Color on the resulting side menu, and entering an index
with the general purpose knob or the keypad. The difference is that, when you
press Color on the front panel, you not only select a color index but also state
that you wish to select by index rather than by contents. In contrast, when you
use this command you only select the index to use. To state you want to select by
index, use the DISplay:COLOr:MAP:...:BYCONTents command with the OFF
argument.
Group
Display
Syntax

REF4 }:TO { CH1 | CH2 | CH3 | CH4 | MATH | REF }
DISplay:COLOr:MAP:TO?
DISplay
COLOr
MAP
MATH1
CH1
MATH2
CH2
MATH3
CH3
REF1
CH4
REF2
MATH
REF3
REF4
Examples
<Space>
:
TO
REF
?
DISPLAY:COLOR:MAP:MATH1:TO CH3
sets the color of math waveform # 1 to that assigned to channel 3. Note: this
assumes that Color Matches Contents is set of OFF.
DISPLAY:COLOR:MAP:MATH1:TO?
might return CH3.
2102
DISplay:COLOr:PALEtte:PERSistence
Sets the current persistence palette to one of the preset persistence palettes. This
is equivalent to selecting Palette from the main Color menu, Persistence
Palettes from the resulting side menu, and Temperature, Spectral, or Gray
Scale from the next side menu.
Group
Display
Syntax
%!
##
"# &

!#$! ')
! '
" (
%!
##
"#?
%
!

##

!#$!

!

"#

"
Examples

sets temperature palette as the current persistence palette.
DISplay:COLOr:PALEtte:REGular
Sets the current palette to one of the preset palettes. This is equivalent to
selecting Palette from the main Color menu and Normal, Bold, Hardcopy, or
Monochrome from the resulting side menu.
Group
Display
Syntax
%!
##
$! & ' ' % ' (
%!
##
$!?
2103

"

!

"

Examples

sets the current palette to the hardcopy palette.
DISplay:COLOr:PALEtte:RESETALL (No Query Form)

Restores all palettes to their factory default setting. This is equivalent to
selecting Restore Colors from the main Color menu and Reset All Palettes to
Factory from the resulting side menu.
Group
Display
Syntax
"
"
Examples

resets the palette to the factory default setting.
DISplay:COLOr:PALEtte:<palette name>:RESET (No Query Form)

Restores the given palette to its factory defaults. This is useful if you have edited
the colors in a palette. This is equivalent to selecting Restore Colors from the
main Color menu and Reset Current Palette to Factory from the resulting side
menu.
2104
Group
Display
Syntax
"
# $ $ " $ %

NORMal
BOLd
DISplay
COLOr
PALEtte
HARDCopy
RESET
MONo
Examples
DISPLAY:COLOR:PALETTE:HARDCOPY:RESET
resets the hardcopy palette to its initial, factory-default settings.
DISplay:COLOr:PALEtte:<palette name>:<item name>

Sets the color of a selected item in a selected palette.
Group
Display
Syntax
DISplay:COLOr:PALEtte:{ NORMal | MONo | BOLd | HARDCopy }:

{ BACKGround | CH1 | CH2 | CH3 | CH4 | MATH | REF | TEXt |
SCROLLTEXT | ZONe | COLLision | GRAticule | SCROLLBAR }
{ <NR1>,<NR1>,<NR1> }
DISplay:COLOr:PALEtte:{ NORMal | MONo | BOLd | HARDCopy }:
{ BACKGround | CH1 | CH2 | CH3 | CH4 | MATH | REF | TEXt |
SCROLLTEXT | ZONe | COLLision | GRAticule | SCROLLBAR }?
2105
BACKGround
DISplay
COLOr
CH1
CH2
PALEtte
<NR1>
CH3
NORMal
CH4
<NR1>
MONo
MATH
BOLd
HARDCopy
REF
<Space>
<NR1>
TEXt
SCROLLTEXT
ZONe
COLLision
GRAticule
SCROLLBAR
Arguments
BACKGround specifies the display background color.

CH1 specifies the channel 1 waveform and associated text color.
MATH specifies the default math waveforms and associated text color.
REF specifies the default reference waveforms and associated text color.
TEXt specifies the text color in all menus and all readouts not associated with a
waveform.
SCROLLTEXT specifies text in the scroll bar. For example, this covers the scroll
bars used in the file system.
ZONe specifies the color of the intensified zone on the waveform when the time
base is intensified and the color of the real samples when the display style is
Intensified Samples.
COLLision specifies the color of the areas where waveforms overlap each other.
You can turn collision marking on or off with the Items, Waveforms, Options,
Collision Contrast menu item.
GRAticule specifies the color of the graticule. Use the Settings, Display,
Graticule option to select the graticule type.
2106
SCROLLBAR specifies the color of the scrollbar. For example, you will find a
scrollbar in various file system menus.
<NR1>, <NR1>, <NR1> specifies the desired colors in terms of hue, lightness
and saturation values.
Hue is the wavelength of light reflected from the surface. It varies continuously
along the color spectrum as produced by a rainbow. Values range from 0 to 359.
Sample values are: 0 = blue, 60 = magenta, 120 = red, 180 = yellow, 240 =
green, 360 = cyan.
Lightness refers to the amount of light reflected from the surface. It varies from
black, to the nominal color, to white. Values range from 0 to100. A value of 0
results in black. A value of 50 provides the nominal color. A value of 100 results
in white.
Saturation is the intensity of color. Completely desaturated color is gray.
Completely saturated color of any hue is that color at its most intense. Values
range from 0 to 100. A value of 100 provides a pure color. A value of 0 provides
gray.
Examples
DISPLAY:COLOr:PALEtte:HARDCOPY:CH1 120,50,100
sets the CH1 color of the hardcopy palette to 120 hue, 50 lightness, and
100 saturation. This provides a pure red.
DISplay:FILTer
Sets or queries the type of interpolation to use for the display when the DISplay:STYle is VECtors. This command is equivalent to setting Filter in the
Display menu.
Group
Related Commands
Syntax
Display
DISplay:STYle
DISplay:FILTer { LINEAr | SINX }
DISplay:FILTer?
2107
<Space>
DISplay
Arguments
FILTer
LINEAr
SINX
?
LINEAr specifies linear interpolation where acquired points are connected with
straight lines.
SINX specifies sin(x)/x interpolation where acquired points are fit to a curve.
Examples
DISPLAY:FILTER LINEAR
sets the interpolation filter type to linear.
DISPLAY:FILTER?
returns either LINEAR or SINX, indicating the type of interpolation filter.
DISplay:FORMat
Sets or queries the display format. This command is equivalent to setting
Format in the Display menu.
Group
Display
Syntax
DISplay:FORMat { XY | YT }
DISplay:FORMat?
<Space>
DISplay
Arguments
2108
FORMat
XY
YT
?
XY displays the voltage of one waveform against the voltage of another. The
sources that make up an XY waveform are predefined and are listed in
Table 227. Displaying one source causes its corresponding source to be
displayed.
Table 227: XY Format Pairs

X-Axis Source
Y-Axis Source
Ch 1
Ch 2
Ch 3 (or AUX 1)
(All models except TDS 410)
Ch 4 (or AUX 2)
(All models except TDS 410)
Ref 1
Ref 2
Ref 3
Ref 4
YT sets the display to a voltage versus time format and is the normal mode.
Examples
DISPLAY:FORMAT YT
selects a voltage versus time format for the display.
DISPLAY:FORMAT?
might return XY for the display format.
DISplay:GRAticule
Selects the type of graticule that will be displayed. This command is equivalent
to setting Graticule in the Display menu.
Group
Display
Syntax
DISplay:GRAticule { CROSSHair | FRAme | FULl | GRId | NTSc | PAL}

DISplay:GRAticule?
CROSSHair
FRAme
FULl
GRId
<Space>
NTSc
PAL
DISplay
Arguments
GRAticule
CROSSHair specifies a frame and cross hairs.

FRAme specifies just a frame.
2109
FULl specifies a frame, a grid, and cross hairs.

GRId specifies a frame and a grid.
NTSc specifies a special NTSC frame.
PAL specifies a special PAL frame.
Examples
DISPLAY:GRATICULE GRID
sets the graticule type to display a frame and a grid.
DISPLAY:GRATICULE?
returns FULL when all graticule elements (grid, frame, and cross hairs) are
selected.
DISplay:INStavu:PERSistence
TDS 7XXA Only
Selects the persistence mode to use with InstaVu.
Group
Display
Syntax
DISplay:INStavu:PERSistence { INFPersist | VARpersist }

DISplay:INStavu:PERSistence?
<Space>
DISplay
Arguments
INStavu
PERSistence
INFPersist
VARpersist
?
INFPersist accumulates data points on the display indefinitely.

VARpersist leaves acquired data points on the display for a period of time
specified by DISplay:INStavu:VARpersist.
Examples
2110
DISPLAY:INSTAVU:PERSISTENCE?
might return INFPERSIST indicating the infinite persistence mode is on.
DISplay:INStavu:STYle
TDS 7XXA Only
Selects how the data is displayed with InstaVu.
Group
Display
Syntax
DISplay:INStavu:STYle { DOTs | VECtors }

DISplay:INStavu:STYle?
<Space>
DOTs
VECtors
DISplay
Arguments
INStavu
STYle
DOTs displays individual data points.

VECtors connects adjacent data points. Old points are immediately replaced by
new ones.
Examples
DISPLAY:INSTAVU:STYLE?
might return DOTS indicating that the display shows individual waveform data
points.
DISplay:INStavu:VARpersist
TDS 7XXA Only
Sets the length of time that data points are displayed when DISplay:INStavu:PERSistence is set to VARpersist. This affects the display only.
Group
Related Commands
Syntax
Display
DISplay:INStavu:PERistence
DISplay:INStavu:VARpersist <NR3>
DISplay:INStavu:VARpersist?
2111
<Space>
DISplay
<NR3>
VARpersist
INStavu
Arguments
Examples
<NR3> specifies the length, in seconds, that the waveform points are displayed on
the screen. The range is 250 ms to 10 s.
DISPLAY:INSTAVU:VARPERSIST 3
specifies that the waveform points are displayed on the screen for 3 seconds
before they disappear.
DISplay:INTENSITy? (Query Only)

Returns the current intensity settings for different parts of the display.
Group
Display
Syntax
DISplay:INTENSITy?
DISplay
Examples
INTENSITy
DISPLAY:INTENSITY?
might return :DISPLAY:INTENSITY:WAVEFORM 70;TEXT 60
or :DISPLAY:INTENSITY:OVERALL 85;WAVEFORM 70;TEXT 60;CONTRAST 175
DISplay:INTENSITy:CONTRast
TDS 4X0, 5X0A & 6X0A Only
Sets the intensity of the intensified zone on a waveform. This command is
equivalent to setting Contrast in the Display Intensity side menu.
The command has no effect on limit test templates or intensified samples. They
are displayed at a fixed contrast ratio.
Group
Related Commands
Syntax
2112
Display
HORizontal:MODe
DISplay:INTENSITy:CONTRast <NR1>
DISplay:INTENSITy:CONTRast?
<Space>
DISplay
INTENSITy
<NR1>
CONTRast
?
Arguments
Examples
<NR1> ranges from 100 to 250 percent.

DISPLAY:INTENSITY:CONTRAST 140
sets the intensity of the intensified portion of a waveform.
DISplay:INTENSITy:OVERAll
TDS 4X0, 5X0A, & 6X0A Only
Sets the intensity of the entire display. This command is equivalent to setting
Overall in the Display Intensity side menu.
Group
Display
Syntax
DISplay:INTENSITy:OVERAll <NR1>
DISplay:INTENSITy:OVERAll?
<Space>
DISplay
INTENSITy
<NR1>
OVERAll
?
Arguments
Examples
<NR1> ranges from 20 to 100 percent.

DISPLAY:INTENSITY:OVERALL 50
sets the intensity of the display to the middle of the range.
DISPLAY:INTENSITY:OVERALL?
might return 75 as the overall display intensity.
2113
DISplay:INTENSITy:TEXt
Sets the intensity of the text and the graticule. This command is equivalent to
setting Text/Grat in the Display Intensity side menu.
Group
Display
Syntax
!$ $#
!$ $#

!
!$
$

#

Arguments
Examples
ranges from 20 to 100 percent.

sets the intensity of the text to the brightest level.
DISplay:INTENSITy:WAVEform
Sets the intensity of the waveforms. This command is equivalent to setting
Waveform in the Display Intensity side menu.
Group
Display
Syntax
!$ $ "
!$ $ "

!
!$
$

"

Arguments
Examples
2114
ranges from 20 to 100 percent.

might return as the intensity of the waveform.
DISplay:MODe
TDS 7XXA Only
Selects whether or not to turn on InstaVu.
Group
Display
Syntax
DISplay:MODe { INStavu | NORMal }

DISplay:MODe?
INStavu
<Space>
NORMal
DISplay
Arguments
MODe
INSTavu turns on InstaVu. This mode can help view infrequent deviations in a
signal. It only uses a 500 point record length, no averaging, and no enveloping.
When you turn on InstaVu, the TDS turns off any active zoom, autosave, limit
test, waveform math, FastFrame, and XY display. The TDS reactivates these
features when you turn off InstaVu.
NORMal turns on the normal (nonInstaVu mode).
Examples
DISPLAY:MODE INSTAVU
turns on InstaVu.
DISPLAY:MODE?
might return INSTAVU indicating that the InstaVu mode is on.
DISplay:PERSistence
Sets the length of time that data points are displayed when DISplay:STYle is set
to VARpersist. This affects the display only and is equivalent to setting Variable
Persistence in the Display Style side menu.
Group
Related Commands
Display
DISplay:STYle
2115
Syntax
"
!
"
!

"

!

Arguments
Examples
specifies the length, in seconds, that the waveform points are displayed on
the screen. The range is 250 ms to 10 s.

specifies that the waveform points are displayed on the screen for 3 seconds
before they fade.
DISplay:STYle
Selects how the data is displayed. This command is equivalent to setting Style in
the Display menu.
Group
Related Commands
Syntax
Display
DISplay:PERSistence
" # $ ! $
$ ! $

! %
"

!

!

!
"
Arguments

displays individual data points.

! accumulates data points on the display indefinitely. The display is
reset when the style or acquisition is reset.
2116
!!" leaves acquired data points on the display for a period of time
specified by DISplay:PERSistence.

" ! connects adjacent data points. Old points are immediately replaced by
new ones.

causes the display to show acquired (non-interpolated) samples
with brighter or different colored dots than the rest of the waveform.
Examples

sets the display to indefinitely accumulate data points on the screen.

might return indicating that the display shows individual waveform data
points.
DISplay:TRIGBar
Controls the display of the trigger bar indicator/s. The bar indicates where the
trigger will occur, in voltage.
The digitizing oscilloscope will only display the bar if the trigger source is also
displayed. If both a main and a delayed trigger are displayed, then two bars will
appear. One will accompany each source. If a logic trigger is selected, then
multiple bars may appear. If a runt pulse trigger is selected, then two bars may
appear. One will show the upper threshold and one the lower threshold.
Group
Display
Syntax
# $ % " % &

#

"

#
Arguments

removes the trigger bar indicator from the display.

" displays a short arrow at the right side of the graticule for each displayed
trigger signal.
2117
LONG displays a horizontal line in the center of the graticule for each displayed
trigger signal.
Examples
DISPLAY:TRIGBAR LONG
sets the display to show long trigger bar indicator (or indicators).
DISplay:TRIGT
Controls the display of the trigger indicator. This is equivalent to setting the
Display T @ Trigger Point in the Readout Options side menu. The query
form returns an ON (1) or an OFF (0).
Group
Display
Syntax
DISplay:TRIGT { ON | OFF | <NR1> }

DISplay:TRIGT?
ON
<Space>
OFF
<NR1>
DISplay
Arguments
TRIGT
<OFF> or <NR1> = 0 removes the trigger indicator from the display.

<ON> or <NR1> 0 displays a trigger indicator on each of the displayed
waveforms. The trigger indicator is in reverse video for the selected waveform.
Examples
DISPLAY:TRIGT ON
sets the display to show trigger indicators.
DISPLAY:TRIGT?
might return 1 indicating that the display shows trigger indicators.
*ESE
Sets and queries the bits in the Event Status Enable Register (ESER). The ESER
prevents events from being reported to the Status Byte Register (STB). For a
more detailed discussion of the use of these registers, see page 31.
2118
Group
Related Commands
Syntax
Status and Error

*CLS, DESE, *ESR?, EVENT?, EVMsg? *SRE, *STB?

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 is 1. If 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 command to set the DESER. A
discussion of event handling begins on page 31.
Examples

sets the ESER to binary 11010001, which enables the PON, URQ, EXE, and
OPC bits.

might return the string , showing that the ESER contains the binary
value 10111010.
*ESR? (Query Only)

Returns the contents of the Standard Event Status Register (SESR). *ESR? also
clears the SESR (since reading the SESR clears it). For a more detailed
discussion of the use of these registers, see page 31.
Group
Related Commands
Status and Error

ALLEv?, *CLS, DESE, *ESE, EVENT?, EVMsg?, *SRE, *STB?
2119
Syntax

Examples

might return the value , showing that the SESR contains binary 11010101.
EVENT? (Query Only)

Returns from the Event Queue an event code that provides information about the
results of the last *ESR? read. EVENT? also removes the returned value from
the Event Queue. A discussion of event handling begins on page 31.
Group
Related Commands
Syntax
Status and Error

ALLEv?, *CLS, DESE, *ESE, *ESR?, EVMsg?, *SRE, *STB?

Examples

might return the response , showing that there was an error in a
command header.
EVMsg? (Query Only)

Removes from the Event Queue a single event code associated with the results of
the last *ESR? read, and returns the event code along with an explanatory
message. A more detailed discussion of event handling begins on page 31.
Group
Related Commands
Syntax
2120
Status and Error

ALLEv?, *CLS, DESE, *ESE, *ESR?, EVENT?, *SRE, *STB?

EVMsg
Returns
The event code and message in the following format:

<Event Code><Comma><QString>[<Event Code><Comma><QString>...]
<QString>::= <Message>;[<Command>]
where <Command> is the command that caused the error and may be returned
when a command error is detected by the digitizing oscilloscope. As much of the
command will be returned as possible without exceeding the 60 character limit
of the <Message> and <Command> strings combined. The command string is
right-justified.
Examples
EVMSG?
might return the message :EVMSG 110,"Command header error".
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
Related Commands
Syntax
Status and Error

ALLEv?, EVENT?, EVMsg?
EVQty?
EVQty
Returns
Examples
<NR1>
EVQTY?
might return 3 as the number of event codes in the Event Queue.
2121
FACtory (No Query Form)

Resets the digitizing oscilloscope to its factory default settings. This command is
equivalent to selecting Recall Factory Setup in the Waveform Save/Recall
menu.
Group
Related Commands
Syntax
Miscellaneous
*PSC, *RCL, RECAll:SETUp, *RST, *SAV, SAVe:SETUp

Setting the digitizing oscilloscope to factory default includes:

H
Clears the Event Status Enable Register.
Clears the Service Request Enable Register.
Sets the Device Event Status Enable Register to 255.
Sets the Power On Status Clear Flag to TRUE
Purges all defined aliases.
Enables all Command Headers (HEADer ON).
Sets the macro defined by *DDT to a zero-length field.
Clears the pending operation flag and associated operations.
The FACtory command does not alter the following:
2122
The state of the GPIB (IEEE Std 488.1-1987) interface.
The selected GPIB address.
Calibration data that affects device specifications.
Protected user data.
Stored settings.
The current password (if implemented).
FILESystem:COPy (No query form)

File System 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.
FILESystem
Group
File system
Syntax
FILESystem:COPy { <source file path>,<destination file path> |

<source directory path>,<destination file path> | <source
directory path>,<destination directory path> }
Arguments
COPy
<Space>
<source file
path>
<destination
file path>
<source
directory path>
<destination
file path>
<source
directory path>
<destination
directory path>
<file path> is a quoted string that defines the file name and path. Input the file
path using the form <drive>/<dir>/<filename>. <drive> and one or more
<dir>s are optional. If you do not specify them, the TDS will copy the file in the
current directory. <filename> stands for a filename of up to 8 characters and can
be followed by a period (.) and a 3-character extension. You can also use the
inclusive filename *.* in the source file path to copy all files.
<directory path> is a quoted string that defines the directory. Input the
directory using the form <drive>/<dir>/<directory name>. <drive> and one
or more <dir>s are optional. If you do not specify them, the TDS will copy the
directory in the current directory. <directory name> stands for a directory name
of up to 8 characters and can be followed by a period (.) and a 3-character
extension.
Examples
FILESYSTEM:COPY TEK00001.SET",fd0:/TEK00001.SET"
copies the file named TEK00001.SET on the current drive to a file named
TEK00001.SET on the drive fd0: in the root directory.
FILESYSTEM:COPY fd0:/YOURDIR/TEK00001.SET",fd0:/MYDIR"
copies the file named TEK00001.SET on the fd0: drive and the YOURDIR
directory to the MYDIR directory on the same drive.
2123
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
File System Only
Sets or returns the current working directory (CWD) path.
Group
File system
Syntax
FILESystem:CWD <directory path>

FILESystem:CWD?
<Space>
FILESystem
<directory path>
CWD
?
Arguments
Examples
<directory path> is a quoted string that defines the directory name and path.
FILESYSTEM:CWD fd0:/MYDIR"
will define fd0:/MYDIR as the current directory.
FILESYSTEM:CWD?
might return fd0:/MYDIR if that is the current directory.
FILESystem:DELEte (No query form)

File System Only
Deletes a named file.
2124
Group
File system
Syntax
FILESystem:DELEte <file path>
FILESystem
Arguments
Examples
DELEte
<Space>
<file path>
<dir>s are optional. If you do not specify them, the TDS will delete the file in
the current directory. <filename> stands for a filename of up to 8 characters and
can be followed by a period (.) and a 3-character extension. You can also use
the inclusive filename *.* to delete all files.
FILESYSTEM:DELETE NOT-MINE.SET"
deletes the file named NOT-MINE.SET on the default drive and directory.
FILESYSTEM:DELETE *.*"
deletes all the files in the default directory on the default drive.
FILESystem:DELWarn
File System Only
Turns on or off the front panel file delete warning. No warning is returned via the
GPIB.
Group
File system
Syntax
FILESystem:DELWarn { ON | OFF | <NR1> }

FILESystem:DELWarn?
ON
<Space>
OFF
<NR1>
FILESystem
Arguments
DELWarn
ON or <NR1> 0 turns on the front panel delete warning.

OFF or <NR1> = 0 turns off the front panel delete warning.
Examples
FILESYSTEM:DELWARN OFF
disables the front panel delete warning.
FILESYSTEM:DELWARN?
might return 0 indicating the front panel warning is disabled.
2125
FILESystem:DIR (Query only)

File System Only
Returns a list of quoted strings. Each string contains the name of a file or
directory in the current directory.
Group
File system
Syntax

!

!
Examples

returns a list of files and directories in the default directory.
FILESystem:FORMat (No query form)

File System Only
Formats a named drive.
Group
File system
Syntax

!

!
Arguments
Examples

is a quoted string that defines the disk drive to format.
refers to the floppy-disk drive built into the digitizing oscilloscope.

"
formats the media on drive fd0:.
FILESystem:FREESpace (Query only)

File System Only
Returns the amount of freespace (in bytes) on the current drive.
2126
Group
File system
Syntax
&#$ !
&#$
Examples
!
!
might return as the amount of freespace available if the drive was full.
FILESystem:MKDir (No query form)

File System Only
Make a new directory.
Group
File system
Syntax
&#$" "$ "& !$
&#$
Arguments
Examples
"
!
"$ "& !$
"$ "& !$ 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 TDS 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-char
extension.
'

creates the directory named
on the current drive.
FILESystem:OVERWrite
File System Only
Turns on or off the file overwrite protection. Turning on file overwrite protection
prevents writing over existing files.
Group
File system
2127
Syntax
FILESystem:OVERWrite { ON | OFF | <NR1> }

FILESystem:OVERWrite?
ON
<Space>
OFF
<NR1>
FILESystem
Arguments
OVERWrite
ON or <NR1> 0 turns on the file overwrite protection.

OFF or <NR1> = 0 turns off the file overwrite protection.
Examples
FILESYSTEM:OVERWRITE OFF
lets you overwrite existing files.
FILESYSTEM:OVERWRITE?
might return 0 indicating you cannot overwrite existing files.
FILESystem:PRInt (No query form)

File System Only
Prints a named file to the named port.
Group
File system
Syntax
FILESystem:PRInt <filepath>,{ GPIb | RS232 | CENtronics }

GPIb
FILESystem
PRInt
<file path>
CENtronics
RS232
Arguments
<dir>s are optional. If you do not specify them, the TDS will print the file in the
current directory. <filename> stands for a filename of up to 8 characters and can
be followed by a period (.) and a 3-character extension.
GPIb specifies that the hardcopy is sent out the GPIB port.
2128
CENtronics specifies that the hardcopy is sent out the Centronics port (Option
13 RS232/Centronics Hardcopy Interface only).
RS232 specifies that the hardcopy is sent out the RS232 port (Option 13
RS232/Centronics Hardcopy Interface only).
Examples
FILESYSTEM:PRINT TEK00000.IBM",CENTRONICS
sends the file named TEK00000.IBM out the Centronics port.
FILESystem:REName (No query form)

File System Only
Assigns a new name to a file.
Group
File system
Syntax
FILESystem:REName <old file path>,<new file path>
FILESystem
Arguments
REName
<Space>
<old file path>
<new file path>
<old file path> is a quoted string that defines the file to rename. Input the file
<dir>s are optional. If you do not specify them, the TDS will look for the
filename in the current directory.
<new file path> is a quoted string that defines the new name of the file. Input
the file path using the form <drive>/<dir>/<filename>. <drive> and one or
more <dir>s are optional. If you do not specify them, the TDS will place the
newly named file in the current directory.
Examples
FILESYSTEM:RENAME TEK00000.SET",MYSETTING.SET"
gives the file named TEK00000.SET the new name of MYSETTING.SET. The file
remains on the current directory.
FILESystem:RMDir (No query form)

File System Only
Deletes a named directory.
Group
File system
2129
Syntax
(%&
Arguments
Examples
(%& $ $&"$( #&

#
$
$&"$( #&
$&"$( #& 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 TDS will delete 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.
,

deletes the directory named
in the current directory.
HARDCopy
Sends a copy of the screen display followed by an EOI to the port specified by
HARDCopy:PORT. The format and layout of the output is specified with the
HARDCopy:FORMat and HARDCopy:LAYout commands. This command is
equivalent to pressing the front-panel HARDCOPY button.
The HARDCopy? query returns format, layout, and port information.
NOTE. This command is NOT IEEE Std 488.2-1987 compatible.
Group
Hardcopy
Syntax

"#( ) $& *
#"" * & +

"#(
$&
#

"#(
#""
&

Arguments
2130
$& terminates the hardcopy output in process.
NOTE. DCL does NOT clear the output queue once a hardcopy is in process. The
only way to abort the hardcopy process is to send the HARDCopy ABOrt
command. The output queue can then be cleared using DCL.
CLEARSpool clears the printer output spooler.
STARt initiates a screen copy that is sent to the controller where it 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 hardcopy is complete before starting another.
Examples
HARDCOPY ABORT
stops any hardcopy output that is in process.
HARDCopy:FILEName
File System Only
Selects the file to send the hardcopy data to on the next hardcopy command
(HARDCOPY START). This is equivalent to setting the target file name in the
Hardcopy menu.
Group
Related Commands
Syntax
Hardcopy
HARDCopy
HARDCopy:FILEName <file path>
HARDCopy:FILEName?
<Space>
HARDCopy
<file path>
FILEName
?
<file path> specifies that the hardcopy is sent to the named file. <file path>
is a quoted string that defines the file name and path. Input the file path using the
form <drive>/<dir>/<filename>.<drive> and one or more <dir>s are
optional. If you do not specify them, the TDS will write the file to the current
2131
directory. <filename> stands for a filename of up to 8 characters followed by a

period (.) and any 3-character extension.
You can automatically create different names for files. You do this by using the
question mark (?) as a special wildcard character. These stand for numbers the
TDS will insert sequentially in the filename. For example, if you placed two
question marks at the end of the filename then the oscilloscope would append 00
to the first file created, 01 to the next, and 02 to the next. This helps you
automatically create different names for files. It is particularly useful in
automated testing situations.
Examples
HARDCOPY:FILENAME TEK.IBM"
selects TEK.IBM as the selected file name.
HARDCOPY:FILENAME?
might return TEK.IBM as the selected file name.
HARDCOPY:FILENAME TEK??.IBM"
selects TEK as the selected file name with a numeric, two-digit suffix. The TDS
might return TEK00.IBM as the first file, TEK01.IBM as the second.
HARDCopy:FORMat
Selects the output data format for hardcopies. This is equivalent to setting
Format in the Hardcopy menu.
Group
Hardcopy
Syntax
HARDCopy:FORMat { BMP | BMPCOLOR (TDS 5XXA, 6XXA, & 7XXA series

only) | DESKJet | DPU411 | DPU412 | EPSCOLImg (TDS 5XXA, 6XXA,
744 series only) | EPSColor | EPSImage | EPSMono | EPSOn | HPGl |
INTERLeaf | LASERJet | PCX | PCXCOLOR (TDS 5XXA, 6XXA, & 7XXA
series only) | RLE (TDS 5XXA, 6XXA, & 7XXA series only) | THInkjet |
TIFf }
HARDCopy:FORMat?
2132

!,

'#
)&)+
'#!
)()
(
&
!"
!,

* !

(%$!,
"
)*-
,
On monochrome instruments (TDS 5X0A & 6X0A series only), the following
formats are mapped to a monochrome near equivalent:

!
!
!
!

For example: if and are sent

to the oscilloscope, is returned.
Examples

sets the hardcopy output format to HPGL.

might return as the final hardcopy output format.
2133
HARDCopy:LAYout
Selects the printing orientation. This is equivalent to setting Layout in the
Hardcopy menu.
Group
Hardcopy
Syntax
HARDCopy:LAYout { LANdscape | PORTRait }

HARDCopy:LAYout?
<Space>
LANdscape
PORTRait
HARDCopy
Arguments
LAYout
LANDscape specifies that the bottom of the hardcopy is along the longest side of
the page.
PORTRait specifies that the bottom of the hardcopy is along the short side of the
page. This is the standard format.
Examples
HARDCOPY:LAYOUT?
might return PORTRAIT as the hardcopy page-layout format.
HARDCopy:PALEtte
Selects whether to create the hardcopy using the current color palette (as set in
the Display menu and seen on the screen) or the hardcopy palette. For color
hardcopies, the default hardcopy palette may be most appropriate, since it has a
white background and requires less ink for printing onto white paper. For
monochrome hardcopies, the TDS ignores the palette and prints black (or the
default color) objects on a blank background.
Group
Related Commands
Syntax
2134
Hardcopy
HARDCopy
HARDCopy:PALEtte { CURRent | HARDCopy }
HARDCopy:PALEtte
CURRent
<Space>
HARDCopy
Examples
HARDCopy
PALEtte
HARDCOPY:PALETTE HARDCOPY
would print each copy made using the hardcopy palette.
HARDCopy:PORT
Selects where to send the hardcopy data on the next hardcopy command (i.e.
HARDCOPY START command). This is equivalent to setting Port in the
Hardcopy menu.
Group
Related Commands
Syntax
Hardcopy
HARDCopy, LIMit:HARDCopy
HARDCopy:PORT { CENtronics | FILE (File System only) | GPIb |
RS232 }
HARDCopy:PORT?
CENtronics
FILE
<Space>
HARDCopy
GPIb
RS232
PORT
?
CENtronics specifies that the hardcopy is sent out the Centronics port (available
with the RS232/Centronics Hardcopy Interface).
FILE specifies that the hardcopy is stored in the file named in the HARDCOPY:FILENAME command.
GPIb specifies that the hardcopy is sent out the GPIB port.
RS232 specifies that the hardcopy is sent out the RS232 port (Option 13
RS232/Centronics Hardcopy Interface only).
2135
Examples
HARDCOPY:PORT?
might return GPIB as the selected hardcopy output port.
HDR
This command is identical to the HEADer query and is included for compatibility with older Tektronix instruments.
Group
Miscellaneous
Syntax
HDR { <NR1> | OFF | ON }

HDR?
<NR1>
<Space>
HDR
OFF
ON
?
HEADer
Sets and queries the Response Header Enable State that causes the digitizing
oscilloscope to either include or omit headers on query responses. This command
does not affect IEEE Std 488.2-1987 Common Commands (those starting with
an asterisk); they never return headers.
Group
Related Commands
Syntax
Miscellaneous
VERBose
HEADer { <NR1> | OFF | ON }
HEADer?
2136
<NR1>
<Space>
OFF
ON
HEADer
Arguments
ON or <NR1> 0 sets the Response Header Enable State to true. This causes the
digitizing oscilloscope to include headers on applicable query responses. You can
then use the query response as a command.
OFF or <NR1> = 0 sets the Response Header Enable State to false. This causes the
digitizing oscilloscope to omit headers on query responses, so that only the
argument is returned.
Examples
HEADER OFF
causes the digitizing oscilloscope to omit headers from query responses.
HEADER?
might return the value 1, showing that the Response Header Enable State is true.
HORizontal? (Query Only)

Returns all settings for the horizontal commands. The commands HORizontal:MAIn:SCAle, HORizontal:MAIn:SECdiv, HORizontal:SCAle, and HORizontal:SECdiv are equivalent so HORizontal:MAIn:SCAle is the only value that
is returned.
Group
Horizontal
Syntax
HORizontal?
HORizontal
Examples
HORIZONTAL?
might return the string :HORIZONTAL:MODE MAIN;RECORDLENGTH 500;
POSITION 5.0E+0;TRIGGER:POSITION 50;:HORIZONTAL:MAIN:SCALE
1.0E-6;:HORIZONTAL:DELAY:MODE RUNSAFTER;SCALE 1.0E-6;TIME:
16.0E-9
2137
HORizontal:DELay? (Query Only)

Returns all horizontal delayed time base parameters. The commands HORizontal:DELay:SECdiv and HORizontal:DELay:SCAle are identical so only
HORizontal:DELay:SCAle will be returned.
Group
Related Commands
Syntax
Horizontal
HORizontal?, HORizontal:DELay:MODe?, HORizontal:DELay:SCAle?,
HORizontal:DELay:SECdiv?, HORizontal:DELay:TIMe?
HORizontal:DELay?
HORizontal
Examples
DELay
HORIZONTAL:DELAY?
might return the delay parameters :HORIZONTAL:DELAY:MODE RUNSAF
TER;SCALE 1.0E-6;TIME: 16.0E-9
Selects the mode for the delayed time base. This is equivalent to setting Time
Base in the Horizontal menu.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:MODe { RUNSAfter | TRIGAfter }
HORizontal:DELay:MODe?
<Space>
HORizontal
Arguments
2138
DELay
MODe
RUNSAfter
TRIGAfter
?
RUNSAfter specifies that the delayed time base runs a user-specified amount of
delay time after the main trigger event.
TRIGAfter specifies that the delayed time base is triggerable after the main time
base triggers.
Examples
HORIZONTAL:DELAY:MODE?
returns either RUNSAFTER or TRIGAFTER, indicating the delayed time base mode.
HORizontal:DELay:SCAle
Sets the time per division for the delayed time base. This is equivalent to setting
Delayed Scale in the Horizontal Scale side menu.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:SCAle <NR3>
HORizontal:DELay:SCAle?
<Space>
HORizontal
DELay
<NR3>
SCAle
?
Arguments
Examples
<NR3> is the time per division. The range is 10 s (5 s on the TDS 620A, 640A,
and 644A and 20 s on the TDS 4XX) to 500 ps (1 ns on the TDS 4XX and 200
ps on the TDS 784A) in a 125 sequence. Values that are not in a 125
sequence (12.55 on the TDS 620A, 640A, & 644A) will be set to the closest
valid value. If the delayed time base scale is set slower than the main time base
scale, both the main and delayed time base scales will be set to the delay scale
value.
HORIZONTAL:DELAY:SCALE 2.0E-6
sets the delay scale to 2 ms per division.
HORIZONTAL:DELAY:SCALE 9.0E-6
sets the delay scale to 10 ms per division. Since 9 ms is not a valid value within
the 125 sequence (12.55 on the TDS 620A, 640A, & 644A), it is automatically set to the closest valid value.
HORIZONTAL:DELAY:SCALE?
might return 1.0E-3, indicating that the delay time is 1 ms per division.
2139
This command is identical to the HORizontal:DELay:SCAle command. It is
provided to maintain program compatibility with some older models of
Tektronix digitizing oscilloscopes.
Group
Horizontal
Syntax
HORizontal:DELay:SECdiv <NR3>
HORizontal:DELay:SECdiv?
<Space>
HORizontal
DELay
<NR3>
SECdiv
?
Sets or queries the delay time to wait after the main trigger before the delayed
time base begins. This is equivalent to setting Delayed Runs After Main in the
Time Base side menu of the Horizontal menu.
Group
Related Commands
Syntax
HORizontal
Arguments
Examples
2140
Horizontal
HORizontal:DELay:TIMe <NR3>
DELay
TIMe
<Space>
<NR3>
<NR3> is the time, in seconds, between the main trigger and the delayed trigger.
The range on the TDS 5XXA, 6XXA, & 7XXA is from 16 ns to 250 seconds
with a resolution of 4 ns. The range on the TDS 4XX is from 10 ns to 20 seconds
with a resolution of 10 ns.
HORIZONTAL:DELAY:TIME 2.0E-3
sets the delay time between the main and delayed time base to 2 ms.
HORizontal:DELay:TIMe? (Query Only)

Returns the delay time parameters.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:TIMe:RUNSAfter?, HORizontal:DELay:TIMe:TRIGAfter?
HORizontal:DELay:TIMe?
HORizontal
Examples
DELay
TIMe
HORIZONTAL:DELAY:TIME?
might return :HORIZONTAL:DELAY:TIME:16.0E-9 for the delay time.
HORizontal:DELay:TIMe:RUNSAfter
Sets or queries the delay time to wait after the main trigger before the delayed
time base begins. This is equivalent to setting Delayed Runs After Main in the
Time Base side menu of the Horizontal menu.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:TIMe:RUNSAfter <NR3>
HORizontal:DELay:TIMe:RUNSAfter?
HORizontal
DELay
TIMe
:
<Space>
<NR3>
RUNSAfter
?
Arguments
<NR3> is the time, in seconds, between the main trigger and the delayed trigger.
The range is from 16 ns (10 ns on the TDS 4XX) to 250 seconds (20 s on the
TDS 4XX) with a resolution of 4 ns.
2141
Examples
HORIZONTAL:DELAY:TIME:RUNSAFTER 2.0E-3
sets the delay time between the main and delayed time base to 2 ms.
HORizontal:DELay:TIMe:TRIGAfter
Sets the delay time to wait in the trigger after delay mode. This is the time that
must pass before a delayed trigger is accepted. This command is equivalent to
setting Delay by Time time in the Delayed Trigger menu.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:TIMe:TRIGAfter <NR3>
HORizontal:DELay:TIMe:TRIGAfter?
HORizontal
DELay
TIMe
:
<Space>
<NR3>
TRIGAfter
?
Arguments
Examples
<NR3> is the delay time, in seconds. The range is from 16 ns (60 ns on the TDS
4XX) to 250 seconds (20 s on the TDS 4XX) with a resolution of 4 ns 10 ns
down to 110 ns on the TDS 4XX).
HORIZONTAL:DELAY:TIME:TRIGAFTER 4.0E-6
sets the delay time to 4 ms.
HORIZONTAL:DELAY:TIME:TRIGAFTER?
might return 1.000E-3, indicating that the delay time is 1 ms.
HORizontal:FASTframe:COUNt
TDS 5XXA & 7XXA Only
Sets or queries FastFrame frame count. This is equivalent to setting FastFrame
Setup in the Horizontal menu and the Frame Count menu item in the side
menu. FastFrame, also known as memory segmentation, captures a series of
triggered acquisitions with minimal, intervening, time.
2142
Group
Horizontal
Syntax
HORizontal:FASTframe:COUNt <NR1>
HORizontal:FASTframe:COUNt?
<Space>
HORizontal
FASTframe
<NR1>
COUNt
?
Arguments
Examples
<NR1> indicates the number of frames to acquire.

HORIZONTAL:FASTFRAME:COUNT 2
Sets up FastFrame mode to acquire two frames (segments) of data.
HORizontal:FASTframe:LENgth
Setup length of each FastFrame frame. This is equivalent to setting FastFrame
Setup in the Horizontal menu and the Frame Length menu item in the side
menu. FastFrame, also known as memory segmentation, lets users capture a
series of triggered acquisitions with minimal, intervening, time between them.
Group
Horizontal
Syntax
HORizontal:FASTframe:LENgth <NR1>
HORizontal:FASTframe:LENgth?
<Space>
HORizontal
FASTframe
<NR1>
LENgth
?
Arguments
Examples
<NR1> indicates the frame (segment) length.

HORIZONTAL:FASTFRAME:LENGTH 250
Sets up the FastFrame mode to acquire frames of 250 samples each.
2143
HORizontal:FASTframe:POSition
Display the selected FastFrame frame. This is equivalent to selecting Horiz Pos
in the Horizontal menu, selecting the Frame menu item in the side menu, and
entering a value with the keypad or the general purpose knob. FastFrame, also
known as memory segmentation, lets users capture a series of triggered
acquisitions with minimal, intervening, time between them.
Group
Horizontal
Syntax
&$ "$

&$ "$

&$
"

$

Arguments
indicates the selected frame to display.
Examples

Selects the 25th FastFrame frame to display.
HORizontal:FASTframe:STATE
Setup FastFrame acquisition. This is equivalent to setting FastFrame Setup in
the Horizontal menu and the FastFrame menu item in the side menu. FastFrame, also known as memory segmentation, lets users capture a series of
triggered acquisitions with minimal time between them.
The digitizing oscilloscope in FastFrame mode is ready to accept a continuous
burst of triggers 400 ms after the controller sends the !%"#$$ "%
command.
Group
Horizontal
Syntax
&$ "
' ( ( )
&$ "

2144
<NR1>
OFF
<Space>
HORizontal
FASTframe
STATE
ON
?
Arguments
<NR1> indicates OFF if its a 0 or ON if its a 1 (or any other nonzero value).
ON means turn on FastFrame.
OFF means turn off FastFrame.
The query form only returns 0 or 1.
Examples
HORIZONTAL:FASTFRAME:STATE ON
turns on FastFrame.
HORizontal:FITtoscreen
Setup horizontal waveform compress operation. This is equivalent to setting
Record Length in the Horizontal menu and the Fit to screen menu item in the
side menu. Waveform compress lets you fit a captured waveform to the visible
screen. It provides the same functionality as if you were in zoom mode and
changed the time per division until the waveform fit the screen.
Group
Horizontal
Syntax
HORizontal:FITtoscreen { <NR1> | OFF | ON }

HORizontal:FITtoscreen?
<NR1>
OFF
<Space>
HORizontal
FITtoscreen
ON
?
Arguments
<NR1> indicates OFF if its a 0. It indicates ON if its a non-zero value.

ON means turn on waveform compress.
OFF means turn off waveform compress.
2145
Examples
HORIZONTAL:FITTOSCREEN ON
turns on waveform compress.
HORizontal:MAIn? (Query Only)

Returns the time per division of the main time base. The commands HORizontal:MAIn:SECdiv and HORizontal:MAIn:SCAle are identical so only HORizontal:MAIn:SCAle will be returned.
Group
Related Commands
Syntax
Horizontal
HORizontal:SCAle, HORizontal:SECdiv, HORizontal:MAIn:SECdiv
HORizontal:MAIn?
HORizontal
Examples
MAIn
HORIZONTAL:MAIN?
might return :HORIZONTAL:MAIN:SCALE 1.0E-6.
HORizontal:MAIn:SCAle
Sets the time per division for the main time base. This command is equivalent to
setting Main Scale in the Horizontal Scale side menu.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:SCAle, HORizontal:DELay:SECdiv, HORizontal:MAIn:SECdiv
HORizontal:MAIn:SCAle <NR3>
HORizontal:MAIn:SCAle?
<Space>
HORizontal
MAIn
<NR3>
SCAle
?
2146
Arguments
Examples
<NR3> is the time per division. For the TDS 6XXA series (except the 684A), the
range is 5 s to 500 ps in a 12.55 sequence). For the TDS 5XXA series, 684A,
and 7XXA, the range is 10 s to 500 ps (or 200 ps on the TDS 784A), in a 125
sequence. For the TDS 4XX series, the range is 20 s to 1 ns.
HORIZONTAL:MAIN:SCALE 2E-6
sets the main scale to 2 ms per division.
HORizontal:MAIn:SECdiv
Sets the time per division for the main time base. This command is identical to
the HORizontal:MAIn:SCAle command. It is provided to maintain program
compatibility with some older models of Tektronix digitizing oscilloscopes.
Group
Related Commands
Syntax
Horizontal
HORizontal:DELay:SCAle, HORizontal:DELay:SECdiv, HORizontal:MAIn:SCAle
HORizontal:MAIn:SECdiv <NR3>
HORizontal:MAIn:SECdiv?
<Space>
HORizontal
MAIn
<NR3>
SECdiv
?
HORizontal:MODe
Selects whether the horizontal display uses the main or delayed time base or
both. This command is equivalent to setting Time Base in the Horizontal menu.
Group
Related Commands
Syntax
Horizontal
DISplay:INTENSITy:CONTRast
HORizontal:MODe { DELAYEd | INTENSIFied | MAIn }
HORizontal:MODe?
2147
DELAYEd
<Space>
INTENSIFied
MAIn
HORizontal
Arguments
MODe
DELAYEd means that the selected waveform is horizontally scaled relative to the
delayed time base.
INTENSIFied uses both the main and delay scales to display the waveform. The
portion of the waveform that would be displayed in DELAYEd mode is
intensified. The level of intensity is set by the DISplay:INTENSITy:CONTRast
command.
MAIn means that the waveform is horizontally scaled relative to the main time
base.
Examples
HORIZONTAL:MODE DELAYED
uses the delayed horizontal scale to display the waveform.
HORIZONTAL:MODE?
might return INTENSIFIED, indicating that the waveform is displayed using both
the main and delayed time base scale.
2148
HORizontal:POSition
Positions the waveform horizontally on the display. This is used for both main
and delayed time bases. This command is equivalent to adjusting the front-panel
Horizontal Position knob or setting the position in the Horizontal Position side
menu.
Group
Horizontal
Syntax
#""
#""

#"

"

Arguments
is from 0 to 100, and is the percent of the waveform that is displayed left
of the center graticule.
Examples

sets the horizontal position of the waveform such that 10% of the waveform is to
the left of screen center.
HORizontal:RECOrdlength
Sets the number of data points that are acquired for each record. This is
equivalent to setting Record Length in the Horizontal menu.
Group
Horizontal
Syntax
#"
!"
#"
!"

#"

!"

Arguments
For the TDS 4XX, is 500, 1000, 2500, 5000, or 15000.
For the TDS 5XXA, is 500, 1000, 2500, 5000, or 15000.
2149
For the TDS 620A, 640A, and 644A, <NR1> is 500, 1000, or 2000.
For the TDS 684A, <NR1> is 500, 1000, 2500, 5000 or 15000.
If you have the TDS 4XX option 1M, <NR1> can also be 30000 or 60000.
If you have the TDS 5XXA option 1M, <NR1> can also be 50000.
For the TDS 7XXA, <NR1> is 500, 1000, 2500, 5000, 15000, or 50000.
If you have the TDS 7XXA option 1M, <NR1> can also be 75000, 100000,
130000, 250000, or 500000.
Examples
HORIZONTAL:RECORDLENGTH 2500
specifies that 2500 data points will be acquired for each record.
HORIZONTAL:RECORDLENGTH?
might return 15000 as the number of data points per record.
HORizontal:SCAle
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.
Group
Horizontal
Syntax
HORizontal:SCAle <NR3>
HORizontal:SCAle?
<Space>
HORizontal
<NR3>
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.
Group
Horizontal
Syntax
HORizontal:SECdiv <NR3>
HORizontal:SECdiv?
2150
<Space>
HORizontal
<NR3>
SECdiv
?
HORizontal:TRIGger? (Query Only)

Returns the horizontal trigger parameter.
Group
Horizontal
Syntax
HORizontal:TRIGger?
HORizontal
Examples
TRIGger
HORIZONTAL:TRIGGER?
might return :HORIZONTAL:TRIGGER:POSITION 50.
HORizontal:TRIGger:POSition
Sets or queries the position of the trigger. This is equivalent to setting Trigger
Position in the Horizontal menu.
Group
Horizontal
Syntax
HORizontal:TRIGger:POSition <NR1>
HORizontal:TRIGger:POSition?
<Space>
HORizontal
TRIGger
<NR1>
POSition
?
Arguments
Examples
<NR1> is from 0 to 100 %, (20% to 80% in the TDS 620A, 640A, & 644A) and
is the amount of pretrigger information in the waveform.
HORIZONTAL:TRIGGER:POSITION?
might return 50.
2151
ID? (Query Only)

Returns identifying information about the instrument and its firmware.
Group
Related Commands
Syntax
Status and Error

*IDN?
ID?
ID
Returns
The instrument id in the following format:

TEK/<model number>,CF:92.1CT,FV:<firmware version number>
Examples
ID?
might return TEK/TDS 544A,CF:92.1CT,FV:3.0
*IDN? (Query Only)

Returns the digitizing oscilloscope identification code.
Group
Related Commands
Syntax
Miscellaneous
ID
*IDN?
*IDN
Returns
The instrument id in the following format:

TEKTRONIX,<model number>,0,CF:92.1CT FV:<firmware version
number>
Examples
2152
*IDN?
might return the response
TEKTRONIX,TDS 544A,0,CF:92.1CT FV:2.0
LIMit:BELl
Rings the bell when the waveform data exceeds the limits set in the limit test, if
the limit state is on.
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>, LIMit:STATE

Arguments

or = 0 turns off ringing the bell when any waveform data exceeds the
limits set by the limit test.
or 0 turns on ringing the bell.
Examples

specifies that the bell is to ring when any waveform data exceeds the limits
specified in the limit test.

returns either or , indicating whether the bell is to ring when any waveform
data exceeds the limits specified in the limit test.
LIMit:COMPARE:CH<x>
Sets or queries 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
2153
Related Commands
Syntax
CURve, LIMit:COMPARE:MATH<x>, LIMit:TEMPLate, LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce, WFMPre

Arguments

is a reference waveform.

specifies that no template testing is to be done for the specified channel.
Examples

specifies REF1 as the template waveform against which to compare waveforms
acquired using CH1.

might return

, indicating that waveforms acquired
using CH2 will be compared to the template waveform stored in REF4.
LIMit:COMPARE:MATH<x>
Sets or queries the template against which to compare a math waveform. The
template can be a waveform saved in any of the reference locations REF1
through REF4, or none.
Group
Related Commands
Syntax
Limit Test
CURve,LIMit:TEMPLate, LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce, WFMPre

2154

Arguments


specifies that no template testing is to be done for the specified channel.
is a math waveform.
Examples

specifies REF1 as the template waveform against which to compare waveforms
acquired using CH1.

might return

, indicating that waveforms acquired
using CH2 will be compared to the template waveform stored in REF4.
LIMit:HARDCopy
Executes a hardcopy operation on the waveform when any waveform data
exceeds the limits set in the limit test, if the limit state is on. The hardcopy
operation uses the port, and prints in the format and layout, specified using the
HARDCopy commands.
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>, LIMit:STATE, HARDCopy

! " " #


2155
Arguments
or 0 turns on the hardcopy operation for the waveform when any
waveform data exceeds the limits set by the limit test.
or = 0 turns off the hardcopy operation.
Examples

specifies that the hardcopy operation occurs for the waveform when any
waveform data exceeds the limits specified in the limit test.

returns either or , indicating whether the hardcopy operation occurs for the
waveform when any waveform data exceeds the limits specified in the limit test.
LIMit:STATE
Turns limit testing on or off, or queries whether limit testing is in effect.
Group
Related Commands
Syntax
Limit Test
CURve, LIMit:BELl, LIMit:COMPARE:CH<x>, LIMit:HARDCopy, LIMit:TEMPLate, WFMPre

Arguments

or = 0 turns off limit testing.

or 0 turns on limit testing.
Examples

specifies that limit testing of waveforms is in effect.

returns either or , indicating whether limit testing of waveforms is in effect.
2156
LIMit:TEMPLate (No Query Form)

Sets 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
Related Commands
Syntax
Limit Test
LIMit:TEMPLate:DESTination, LIMit:TEMPLate:SOUrce, LIMit:TEMPLate:TOLerance

Arguments
creates a template with the specified source waveform and tolerances, and
stores it in the destination reference waveform to be used in limit testing
comparisons.
Examples

creates a template with the specified source waveform and tolerances, and stores
it in the destination reference waveform to be used in limit testing comparisons.
LIMit:TEMPLate:DESTination
Sets or queries the destination reference waveform in which to store the template
waveform to use in limit tests. The LIMit:TEMPLate STORe command must be
executed for this to take effect.
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>, LIMit:TEMPLate, LIMit:TEMPLate:SOUrce

2157

Arguments

specifies the reference waveform destination in which the template
waveform is to be stored.
Examples

specifies that the template waveform referred to with the LIMit:TEMPLate
STORe command is stored as the REF2 waveform.
LIMit:TEMPLate:SOUrce
Sets or queries the channel, math waveform, or reference waveform to use as the
source of the template waveform for limit tests. The LIMit:TEMPLate STORe
command must be executed for this to take effect.
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>, LIMit:TEMPLate, LIMit:TEMPLate:DESTination

! !

"

Arguments

specifies that the template waveform is the waveform currently being
acquired using the specified channel.
specifies that the template waveform is the waveform currently stored
as the specified math waveform.

specifies that the template waveform is the waveform currently stored as
the specified reference waveform.
2158
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 MATH3, specifying that the template waveform for limit tests is the
waveform currently stored as the MATH3 waveform.
LIMit:TEMPLate:TOLerance:HORizontal
Sets or queries the amount by which the tested waveform can vary, in units of
horizontal divisions, when comparing the current waveform to the template
waveform for limit tests. The LIMit:TEMPLate STORe command must be
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>
LIMit:TEMPLate:TOLerance:HORizontal <NR3>
LIMit:TEMPLate:TOLerance:HORizontal?
LIMit
TEMPLate
TOLerance
HORizontal
<Space>
<NR3>
?
Arguments
<NR3> is the amount, in horizontal divisions, by which the current waveform is

allowed to deviate from the template waveform without exceeding the limits set
in the limit test. The range is 0 to 5 divisions.
Examples
LIMIT:TEMPLate:TOLerance:HORizontal 1.0
specifies that the current waveform is deemed to be close enough to the template
waveform if it is within 1.0 horizontal division.
LIMIT:TEMPLate:TOLerance:HORizontal?
might return 1.0, specifying that the current waveform is close enough to the
template waveform if it is within 1.0 horizontal division.
2159
LIMit:TEMPLate:TOLerance:VERTical
Sets or queries the amount by which the tested waveform can vary, in units of
vertical divisions, when comparing the current waveform to the template
waveform for limit tests. The LIMit:TEMPLate STORe command must be
Group
Related Commands
Syntax
Limit Test
LIMit:COMPARE:CH<x>
LIMit:TEMPLate:TOLerance:VERTical <NR3>
LIMit:TEMPLate:TOLerance:VERTical?
LIMit
TEMPLate
TOLerance
VERTical
<Space>
<NR3>
?
Arguments
<NR3> is the amount, in vertical divisions, by which the current waveform is

allowed to deviate from the template waveform without exceeding the limits set
in the limit test. The range is 0 to 5 divisions.
Examples
LIMIT:TEMPLate:TOLerance:VERTical 1.0
specifies that the current waveform is close enough to the template waveform if
it is within 1.0 vertical division from the template waveform.
LIMIT:TEMPLate:TOLerance:VERTical?
might return 1.0, specifying that the current waveform is close enough to the
template waveform if it is within 1.0 vertical division.
LOCk
Enables and disables all front panel buttons and knobs. There is no front-panel
equivalent.
Group
Related Commands
2160
Miscellaneous
UNLock, Remote Enable Group, Local Lockout Group
Syntax

Arguments

disables all front panel controls.

enables all front panel controls. This is equivalent to the UNLock ALL
command.
NOTE. If the digitizing oscilloscope is in the Remote With Lockout State (RWLS),
the LOCk NONe command has no effect. For more information see the ANSIIEEE Std. 488.1-1987 Standard Digital Interface for Programmable Instrumentation, section 2.8.3 on RL State Descriptions.
Examples

locks the front panel controls.

returns

when the front panel controls are enabled by this command.
*LRN? (Query Only)

Returns a string listing the digitizing oscilloscope settings, except for configuration information for the calibration values. You can use this string to return the
digitizing oscilloscope to the state it was in when you made the *LRN? query.
Group
Related Commands
Syntax
Miscellaneous
HEADer, SET?, VERBose

2161
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 digitizing oscilloscope as a command
string. The VERBose command can still be used normally to specify whether the
returned headers should be abbreviated.
Examples
*LRN?
a partial response might look like this:
:ACQUIRE:STATE 1;MODE SAMPLE;NUMENV 10;NUMAVG 16;
REPET 1;STOPAFTER RUNSTOP;:DIAG:LOOP:OPTION ONCE;
COUNT 1;:DIAG:STATE HALT;:HEADER 1;:VERBOSE 1;
:CURSOR:FUNCTION OFF;VBARS:UNITS SECONDS;
POSITION1 1.00E-6;POSITION2 9.00E-6;SELECT CURSOR1;
MATH<x>? (Query Only)

Returns the definition for the math waveform specified by <x>.
Group
Vertical
Syntax
MATH<x>?
MATH
<x>
MATH<x>:DEFINE
Allows the user to define new waveforms using mathematical expressions. This
is equivalent to selecting Change Math waveform definition in the Math<x>
side menu.
Group
Vertical
Syntax
MATH<x>:DEFINE <QString>
MATH<x>:DEFINE?
2162
Space
MATH<x>
<QString>
DEFINE
?
Arguments
<QString> contains the mathematical expression. The expression can include

any amount of white space. Expressions can be either single or dual waveform
expressions. <src> and <function> elements are case independent.
The format for a single waveform expression is:
<function>(<source> [, <window>, <scaling>, <phase
suppression>])
The format for a dual waveform expression is:
<source><operator><source>
where:
<function> ::= INV | DIF | FFT | INT
H
INVert (for invert): inverts the defined waveform.
DIFferentiate (available with Advanced DSP Math only): takes the

derivative of the selected waveform.
FFT (available with Advanced DSP Math only): provides an FFT of the
selected waveform. It uses the format: FFT(<source>, <window>,
<scaling>, <phase suppression>) where the window, scaling, and phase
suppression arguments in the parentheses are optional. You can specify these
arguments in any order.
<source> refers to a signal channel. Valid choices are: CH1, CH2, CH3, CH4,
REF1, REF2, REF3, or REF4.
(The TDS 410 does not include CH3 and CH4.)
<window> refers to an FFT window. Valid choices are: RECTangular,
HAMming, HANning, or BLAckmanharris.
<scaling> provides vertical scaling. Valid choices are: LOGrms, LINearrms,
DEGreesphase, or RADiansphase.
<Phase suppression> is of the range: 100 dB to 100 dB.
INTegrate (available on instruments with the Option 2F Advanced DSP

Math only): takes the integral of the selected waveform.
<operator> ::= { + | - | * | / }
<source> ::= { CH<x> | REF<x> }
2163
Examples
MATH2:DEFINE "Ch1 + cH2"

adds channel 1 and channel 2, and stores the result in MATH2.
MATH1:DEFINE "INV( ref4 )"
inverts the waveform stored in reference memory location 4 storing the result in
MATH1.
MATH1:DEFINE "FFT( CH1 )"
takes an FFT on the waveform from channel 1 and stores the result in MATH1.
MATH1:DEFINE "FFT( CH1, HAMM, LINEARRMS, 20 )"
takes an FFT from channel1, using the HAMMING algorithm, with linear rms
scaling, and 20 dB phase suppression. The result is stored in MATH1.
MATH1:DEFINE?
might return "Ch2*Ref2" as the expression that defines MATH1.
MATH<x>:NUMAVg
TDS 5XXA, 6XXA, & 7XXA Only,
some models require Option 2F
Allows the user to declare at what acquisition number the averaging algorithm
will begin exponential averaging. Prior to that acquisition number, the algorithm
uses stable averaging. This is equivalent to selecting Average in the Math<x>
side menu and entering a value with the general purpose knob or the keypad.
Group
Vertical
Syntax
MATH<x>:NUMAVg <NR1>
MATH<x>:NUMAVg?
<Space>
MATH<x>
Arguments
Examples
2164
NUMAVg
<NR1>
?
< NR1 > specifies the number of times to successively average the math
waveform before completing an acquisition.
MATH2:NUMAVG 10
Successively averages math waveform 2 by 10 times.

might return 10 indicating 10 math 2 waveforms are successively averaged
before a single acquisition occurs.
MATH<x>:PROCessing
TDS 5XXA, 6XXA, & 7XXA Only,
some models require Option 2F
Allows the user to turn on or off averaging for the math waveform specified by
<x>. This is equivalent to selecting No Extended Process or Average in the
Math<x> side menu.
Math averaging allows the digitizing oscilloscope to successively average any
acquisition-related math waveform. This can help reduce noise in a math
waveform.
Group
Vertical
Syntax
!
" #
$
!

!
Arguments

turns off waveform averaging.

turns on waveform averaging.
Examples

ensures that waveform averaging is not in use on math waveform 1.

turns on waveform averaging on math waveform 1.
MEASUrement? (Query Only)

Returns all measurement parameters.
2165
Group
Measurement
Syntax
MEASUrement?
MEASUrement
Examples
MEASUREMENT?
might return :MEASUREMENT:MEAS1:STATE 0;TYPE PERIOD;UNITS
"s";SOURCE1 CH1;SOURCE2 CH1;DELAY:EDGE1 RISE;EDGE2 RISE;DIRECTION
FORWARDS;:MEASUREMENT:MEAS2:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1
CH1;SOURCE2 CH1;DELAY:EDGE1 RISE;EDGE2 RISE;DIRECTION FORWARDS;
:MEASUREMENT:MEAS3:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1
:MEASUREMENT:MEAS4:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1
:MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2
CH1;DELAY:EDGE1 RISE;EDGE2 RISE;DIRECTION FORWARDS;:MEASUREMENT:
METHOD HISTOGRAM;REFLEVEL:METHOD PERCENT;ABSOLUTE:HIGH 0.0E+0;LOW
0.0E+0;MID 0.0E+0;MID2 0.0E+0;:MEASUREMENT:REFLEVEL:PERCENT:HIGH
90.0E+0;LOW 10.0E+0;MID 50.0E+0;MID2 50.0E+0
MEASUrement:CLEARSNapshot
Removes the measurement snapshot display.
Group
Measurement
Syntax
MEASUrement:CLEARSNapshot
MEASUrement
Examples
CLEARSNapshot
MEASUREMENT:CLEARSNAPSHOT
MEASUrement:GATing
Sets or queries measurement gating.
Group
2166
Measurement
Related Commands
Syntax
CURSor:VBArs
MEASUrement:GATing { ON | OFF | <NR1> }
MEASUrement:GATing?
ON
<Space>
OFF
<NR1>
MEASUrement
Arguments
GATing
ON (or 1) turns on measurement gating.

OFF (or 0) turns off measurement gating.
Examples
MEASUREMENT:GATING ON
MEASUREMENT:GATING?
might return MEASUREMENT:GATING 1
showing gating is turned on.
It might also return MEASUREMENT:GATING 0
showing gating is turned off.
MEASUrement:IMMed? (Query Only)

Returns all immediate measurement setup parameters.
Group
Measurement
Syntax
MEASUrement:IMMed?
MEASUrement
Examples
IMMed
MEASUREMENT:IMMED?
might return :MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1
CH1;SOURCE2 CH1;DELAY:EDGE1 RISE;EDGE2 RISE; DIRECTION FORWARDS
2167
MEASUrement:IMMed:DELay? (Query Only)

Returns information about the immediate delay measurement.
Group
Measurement
Syntax
%!"' (
%!"'
Examples

(

might return

MEASUrement:IMMed:DELay:DIREction
Sets or queries 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.
Group
Measurement
Syntax
%!"' ( ' #" )

%& * %&+
%!"' ( ' #"
%!"'

(
' #"
$
%&
%&

Arguments
%& means that the search starts at the end of the waveform and looks for
the last rising or falling edge in the waveform. The slope of the edge is specified
by MEASUrement:IMMed:DELay:EDGE2.
%& means that the search starts at the beginning of the waveform and
looks for the first rising or falling edge in the waveform. The slope of the edge is
specified by MEASUrement:IMMed:DELay:EDGE2.
2168
Examples
MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS
starts searching from the beginning of the waveform record.
MEASUREMENT:IMMED:DELAY:DIRECTION?
returns either BACKWARDS or FORWARDS.
MEASUrement:IMMed:DELay:EDGE1
Sets or queries the slope of the edge that is used for the delay from waveform
when taking an immediate delay measurement. The waveform is specified by
MEASUrement:IMMed:SOURCE1.
Group
Related Commands
Syntax
Measurement
MEASUrement:IMMed:SOURCE1
MEASUrement:IMMed:DELay:EDGE1 { FALL | RISe }
MEASUrement:IMMed:DELay:EDGE1?
MEASUrement
IMMed
DELay
EDGE1
<Space>
FALL
RISe
?
Arguments
FALL specifies the falling edge.

RISe specifies the rising edge.
Examples
MEASUREMENT:IMMED:DELAY:EDGE1 RISE
specifies that the rising edge be used for the immediate delay measurement.
MEASUREMENT:IMMED:DELAY:EDGE1?
returns either RISE or FALL.
2169
MEASUrement:IMMed:DELay:EDGE2
Sets or queries the slope of the edge that is used for the delay to waveform
when taking an immediate delay measurement. The waveform is specified by
MEASUrement:IMMed:SOURCE2.
Group
Related Commands
Syntax
Measurement
MEASUrement:IMMed:DELay:EDGE2 { FALL | RISe }
MEASUrement:IMMed:DELay:EDGE2?
MEASUrement
IMMed
DELay
EDGE2
<Space>
FALL
RISe
?
Arguments
FALL specifies the falling edge.

RISe specifies the rising edge.
Examples
MEASUREMENT:IMMED:DELAY:EDGE2 RISE
specifies that the rising edge be used for the immediate delay measurement.
MEASUREMENT:IMMED:DELAY:EDGE2?
returns FALL showing that the falling or negative edge of the waveform is used
for the immediate delay measurement.
MEASUrement:IMMed:SOURCE[1]
Sets or queries the source for all single channel immediate measurements and
specifies the source to measure from when taking an immediate delay
measurement or phase measurement.
Group
2170
Measurement
Syntax
" ! # ! # ! $

!

Arguments
! is an input channel.

! is a math waveform.
! is a reference waveform.
Examples

specifies MATH1 as the immediate measurement source.
Specifies the source to measure to when taking an immediate delay measurement or phase measurement.
Group
Measurement
Syntax
" ! # ! # ! $

!

Arguments

! is an input channel.

! is a math waveform.
! is a reference waveform.
2171
Examples

sets the waveform in reference memory location 3 as the delay to source when
making delay measurements.

might return .
MEASUrement:IMMed:TYPe
Specifies the immediate measurement.
Group
Measurement
Syntax
+"'"(-"!" 0 &$-.!" 1 1 ,- 1 " 1 (

1 , 1
/ 1 1 ."( / 1 1 1 $'.' 1 1
'.' 1
-/ 1 "+,#))- 1 !-# 1
-/ 1 )! 1 ," 1
*% 1 "+,#))- 1 !-# 1 " 1 2
+"'"(-"!"
2172
%#,- !

+,
!

'
+

.

-!'.

#&-&
)!

&-&
,.
!*+"((,
,"
,.

(
+!
)$
!*+"((,
,"
!

*!&!',
Arguments
!
!

%#,- ! is the high value minus the low value.

is the area between the curve and ground over the entire waveform.
+, is the time from the first MidRef crossing to the last MidRef crossing.
! (cycle area) is the area between the curve and ground over one cycle.

' is the arithmetic mean over one cycle.
+ is the true Root Mean Square voltage over one cycle.

. is the time between the MidRef crossings of two different waveforms.
2173
FALL is the time that it takes for the falling edge of a pulse to fall from a HighRef
value to a LowRef value of its final value.
FREQuency is the reciprocal of the period measured in hertz.
HIGH is the 100% reference level.
LOW is the 0% reference level.
MAXimum is the highest amplitude (voltage).
MEAN is the arithmetic mean over the entire waveform.
MINImum is the lowest amplitude (voltage).
NDUty is the ratio of the negative pulse width to the signal period expressed as a
percentage.
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.
PK2pk is the absolute difference between the maximum and minimum amplitude.
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.
RMS is the true Root Mean Square voltage.
2174
Examples

defines the immediate measurement to be a frequency measurement.
MEASUrement:IMMed:UNIts? (Query Only)

Returns the units for the immediate measurement.
Group
Measurement
Related Commands
MEASUrement:IMMed:TYPe
Syntax
! ##"
! #
Returns
Examples

#"
#! returns for volts, " for seconds, % for hertz, for
volts2,or for percent.

might return ", indicating that the units for the immediate measurement are
seconds.
MEASUrement:IMMed:VALue? (Query Only)

Immediately executes the immediate measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is taken on the source(s)
specified by a MEASUrement:IMMed:SOURCE command.
Group
Measurement
Syntax
! # $
! #
Returns

$

2175
MEASUrement:MEAS<x>? (Query Only)

Returns all measurement parameters for the displayed measurement specified by
<x>.
Group
Measurement
Syntax
MEASUrement:MEAS<x>?
MEASUrement
Examples
MEAS
<x>
MEASUREMENT:MEAS3?
might return :MEASUREMENT:MEAS3:STATE 0;TYPE PERIOD;
UNITS "s";SOURCE1 CH1;SOURCE2 CH2;DELAY:EDGE1 RISE;
EDGE2 RISE;DIRECTION FORWARDS.
MEASUrement:MEAS<x>:DELay? (Query Only)

Returns the delay measurement parameters for the measurement specified by
<x>.
MEASUrement
Group
Measurement
Syntax
MEASUrement:MEAS<x>:DELay?
Examples
MEAS
<x>
DELay
MEASUREMENT:MEAS3:DELAY?
might return :MEASUREMENT:MEAS3:DELAY:EDGE1 RISE;
EDGE2 RISE;DIRECTION FORWARDS.
MEASUrement:MEAS<x>:DELay:DIREction
Sets or queries the starting point and direction that determines the delay to
edge when taking a delay measurement. The waveform is specified by
MEASUrement:MEAS<X>:SOURCE2. This command is equivalent to setting
the direction in the Delay Edges & Direction side menu.
Group
2176
Measurement
Syntax
$ !&'(&"! )

$% * $% +
$ !&'(&"!
$ !&

'
(
#
Arguments
&"!

$%
$%

$% means that the search starts at the end of the waveform and looks for
the last rising or falling edge in the waveform. The slope of the edge is specified
by MEASUrement:MEAS<x>:DELay:EDGE2.
$% means that the search starts at the beginning of the waveform and
looks for the first rising or falling edge in the waveform. The slope of the edge is
specified by MEASUrement:MEAS<x>:DELay:EDGE2.
Examples

starts searching from the end of the waveform record.

might return for the search direction.
MEASUrement:MEAS<x>:DELay:EDGE1
Sets or queries the slope of the edge that is used for the delay from waveform
when taking a delay measurement. The waveform is specified by
MEASUrement:MEAS<x>:SOURCE1. This command is equivalent to selecting
the edges in the Delay Edges & Direction side menu.
Group
Measurement
Syntax
$ !&'( ) * +

$ !&'(
2177

Arguments
specifies the falling edge.

specifies the rising edge.
Examples

specifies that the rising edge be used for measurement 3.

returns either or for measurement 1.
MEASUrement:MEAS<x>:DELay:EDGE2
Sets or queries the slope of the edge that is used for the delay to waveform
when taking a delay measurement. The waveform is specified by
MEASUrement:MEAS<x>:SOURCE2. This command is equivalent to selecting
the edges in the Delay Edges & Direction side menu.
Group
Measurement
Syntax

! " #

Arguments
specifies the falling edge.

specifies the rising edge.
2178
Examples

specifies that the rising edge be used for the second delay measurement.

might return showing that the falling or negative edge of the waveform is
used for the second measurement.
MEASUrement:MEAS<x>:SOURCE[1]
Sets or queries the source for all single channel measurements and specifies the
source to measure from when taking a delay measurement or phase measurement.
Group
Measurement
Syntax
!"# $ # % # % #&

!"#
!"

#

Arguments

#

# is an input channel.

# is a math waveform.
# is a reference waveform.
Examples

specifies MATH1 as the measurement 2 source.
2179
MEASUrement:MEAS<x>:SOURCE2
Sets or queries 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

Arguments
is an input channel.

is a math waveform.
Examples

sets channel 1 as the delay to source when making delay measurements.

might return .
MEASUrement:MEAS<x>:STATE
Controls the measurement system. The source specified by MEASUrement:MEAS<x>:SOURCE1 must be selected for the measurement to be
displayed. The source can be selected using the SELect:CH<x> command.
Group
2180
Measurement
Syntax
MEASUrement:MEAS<x>:STATE { OFF | ON | <NR1> }

MEASUrement:MEAS<x>:STATE?
OFF
<Space>
ON
<NR1>
MEASUrement
Arguments
MEAS
<x>
STATE
OFF or <NR1> = 0 turns measurements off. You can also turn the state off by
deselecting the source.
ON or <NR1> 0 turns measurements on.
Examples
MEASUREMENT:MEAS1:STATE ON
turns measurement defined as MEAS1 on.
MEASUREMENT:MEAS4:STATE?
returns either 0 or 1, indicating the state of MEAS4.
MEASUrement:MEAS<x>:TYPe
Sets or queries the measurement type for the measurement specified by
MEAS<x>. This is equivalent to selecting the measurement in the Select
Measurement side menu.
Group
Measurement
Syntax
MEASUrement:MEAS<x>: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:MEAS<x>:TYPe?
2181
%#,- !

+,
!

'
+

/

-!'/

#&-&
)!

&-&
,/
!*+"((,
,"
,/

(
+!
)$
!*+"((,
,"
!

*!&!',
Arguments

.
!

%#,- ! is the high value minus the low value or .

is the area between the curve and ground over the entire waveform.
+, is the time from the first MidRef crossing to the last MidRef crossing.
! (cycle area) is the area between the curve and ground over one cycle.

' is the arithmetic mean over one cycle.
+ is the true Root Mean Square voltage over one cycle.

/ is the time between the MidRef crossings of two different waveforms.
2182
FALL is the time that it takes for the falling edge of a pulse to fall from a HighRef
value to a LowRef value of its final value.
FREQuency is the reciprocal of the period measured in hertz.
HIGH is the 100% reference level.
LOW is the 0% reference level.
MAXimum is the highest amplitude (voltage).
MEAN is the arithmetic mean over the entire waveform.
MINImum is the lowest amplitude (voltage).
NDUty is the ratio of the negative pulse width to the signal period expressed as a
percentage.
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.
PK2pk is the absolute difference between the maximum and minimum amplitude.
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.
RMS is the true Root Mean Square voltage.
2183
Examples

specifies MEAS3 to calculate the Root Mean Square voltage.
MEASUrement:MEAS<x>:UNIts? (Query Only)

Returns the units for the measurement specified by MEASUrement:MEAS<x>:TYPe.
Group
Measurement
Syntax

"

Returns
Examples

"

returns for volts, for seconds, for hertz, for
volts2, or for percent.

might return , indicating the units for Measurement 3 are percent.
MEASUrement:MEAS<x>:VALue? (Query Only)

Returns the value that has been calculated for the measurement specified by <x>.
NOTE. This value is a display value and will be updated perhaps every 1/3
second. If you are acquiring a long acquisition record, the TDS may take longer
than this to update.

Group
Measurement
Syntax

" !
Returns
2184

"
!

MEASUrement:METHod
Sets or queries the method used to calculate the 0% and 100% reference level.
This is equivalent to setting the High-Low Setup in the Measure menu.
Group
Measurement
Syntax
MEASUrement:METHod { HIStogram | MINMax }

MEASUrement:METHod?
<Space>
MEASUrement
Arguments
METHod
HIStogram
MINMax
?
HIStogram sets the high and low waveform levels statistically using a histogram
algorithm.
MINMax sets the high and low waveform levels to MAX and MIN, respectively.
Examples
MEASUREMENT:METHOD HISTOGRAM
specifies that the high and low reference levels are set statistically.
MEASUREMENT:METHOD?
returns MINMAX when the reference levels are set to MIN and MAX.
MEASUrement:REFLevel? (Query Only)

Returns the reference levels.
Group
Measurement
Syntax
MEASUrement:REFLevel?
MEASUrement
REFLevel
2185
MEASUrement:REFLevel:ABSolute:HIGH
Sets or queries the high reference level, and is the 100% 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:HIGH <NR3>
MEASUrement:REFLevel:ABSolute:HIGH?
MEASUrement
REFLevel
ABSolute
HIGH
<Space>
<NR3>
?
Arguments
Examples
<NR3> is the high reference level, in volts. The default is 0.0 V.

MEASUREMENT:REFLEVEL:ABSOLUTE:HIGH 1.71
sets the high reference level to 1.71 V.
MEASUrement:REFLevel:ABSolute:LOW
Sets or queries the low reference level, and is the 0% reference level when
Group
Measurement
Syntax
MEASUrement:REFLevel:ABSolute:LOW <NR3>
MEASUrement:REFLevel:ABSolute:LOW?
2186
MEASUrement
REFLevel
ABSolute
LOW
<Space>
<NR3>
?
Arguments
Examples
<NR3> is the low reference level, in volts. The default is 0.0 V.

MEASUREMENT:REFLEVEL:ABSOLUTE:LOW?
might return 0.0E+0 as the low reference level.
MEASUrement:REFLevel:ABSolute:MID
Sets or queries the mid reference level, and is the 50% reference level when
Group
Measurement
Syntax
MEASUrement:REFLevel:ABSolute:MID <NR3>
MEASUrement:REFLevel:ABSolute:MID?
MEASUrement
REFLevel
ABSolute
MID
<Space>
<NR3>
?
Arguments
Examples
<NR3> is the mid reference level, in volts. The default is 0.0 V.

MEASUREMENT:REFLEVEL:ABSOLUTE:MID .71
sets the mid reference level to .71 volts.
2187
MEASUrement:REFLevel:ABSolute:MID2
Sets or queries the mid 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 <NR3>
MEASUrement:REFLevel:ABSolute:MID2?
MEASUrement
REFLevel
ABSolute
MID2
<Space>
<NR3>
?
Arguments
<NR3> is the mid reference level, in volts. The default is 0.0 V.
Examples
MEASUREMENT:REFLEVEL:ABSOLUTE:MID2 0.5
sets the mid reference level for the delay waveform to 0.5 volts.
MEASUrement:REFLevel:METHod
Specifies which reference levels are used for measurement calculations. This
command is equivalent to setting the levels in the Reference Levels side menu.
Group
Measurement
Syntax
MEASUrement:REFLevel:METHod { ABSolute | PERCent }

MEASUrement:REFLevel:METHod?
<Space>
MEASUrement
2188
REFLevel
METHod
ABSolute
PERCent
?
Arguments

"&% specifies that the reference levels are set explicitly using the
MEASUrement:REFLevel:ABSolute commands. This method is useful when
precise values are required. For instance, when designing to published interface
specifications such as RS-232-C.
!% specifies that the reference levels are calculated as a percent relative to
HIGH and LOW. The percentages are defined using the MEASUrement:REFLevel:PERCent commands.
Examples

"&%
specifies that explicit user-defined values are used for the reference levels.

returns either
"&% or , indicating the reference levels used.
MEASUrement:REFLevel:PERCent:HIGH
Sets or queries 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. This command is equivalent to setting the Reference Levels in
the Measure menu.
Group
Measurement
Syntax
$ !% ' !%

$ !% ' !%
$ !%
'
!%

#

Arguments
Examples
ranges from 0 to 100 percent, and is the high reference level. The default
is 90%.

specifies that the high reference level is set to 95% of HIGH.
2189
MEASUrement:REFLevel:PERCent:LOW
calculate the low reference level when MEASUrement:REFLevel:METHod is set
to PERCent. This command is equivalent to setting the Reference Levels in the
Measure menu.
Group
Measurement
Syntax

!

!

!

Arguments
Examples
ranges from 0 to 100 percent, and is the low reference level. The default is
10%.

might return 15, meaning that the low reference level is 15% of HIGH.
MEASUrement:REFLevel:PERCent:MID
calculate the mid reference level when MEASUrement:REFLevel:METHod is
set to PERCent. This command is equivalent to setting the Reference Levels in
the Measure menu.
Group
Measurement
Syntax

!

!

2190
MEASUrement
REFLevel
PERCent
MID
<Space>
<NR3>
?
Arguments
Examples
<NR3> ranges from 0 to 100 percent, and is the mid reference level. The default is
50%.
MEASUREMENT:REFLEVEL:PERCENT:MID 60
specifies that the mid reference level is set to 60% of HIGH.
MEASUrement:REFLevel:PERCent:MID2
calculate the mid reference level for the second waveform specified when taking
a delay measurement. This command is equivalent to setting the Reference
Levels in the Measure menu.
Group
Measurement
Syntax
MEASUrement:REFLevel:PERCent:MID2 <NR3>
MEASUrement:REFLevel:PERCent:MID2?
MEASUrement
REFLevel
PERCent
MID2
<Space>
<NR3>
?
Arguments
Examples
<NR3> ranges from 0 to 100 percent, and is the mid reference level. The default is
50%.
MEASUREMENT:REFLEVEL:PERCENT:MID2 40
specifies that the mid reference level is set to 40% of HIGH.
2191
MEASUrement:SNAPShot
Displays the measurement snapshot.
Group
Measurement
Syntax
MEASUrement:SNAPShot
MEASUrement
Examples
SNAPShot
MEASUREMENT:SNAPSHOT
MESSage
Clears the message window and the MESSage? query returns the current
message parameters.
Group
Display
Syntax
MESSage CLEar
MESSage?
MESSage
Arguments
Examples
CLEar
<Space>
?
CLEar removes the message from the message window. This is equivalent to
sending MESSage SHOW "".
MESSAGE CLEAR
clears the message from the window.
MESSage:BOX
Defines the size and position of the message window. This command does not
display the window unless MESSage:STATE is ON.
Group
2192
Display
Syntax

Arguments

and = 0 to 640, and are pixel positions along the horizontal axis.
defines the left and defines the right side of the window.
and = 0 to 480, and are pixel positions along the vertical axis.
defines the top and defines the bottom of the window. The reserved height
of all characters is 15 pixels so the window must be at least that high to fully
display characters. For a complete list of character widths in pixels, see Table
A1 on page A1. Shorter windows clip characters.
640
524
474
424
374
324
274
224
174
124
74
0
24
Figure 3-1 shows the coordinate system relative to the screen.
0
34
84
134
184
234
284
334
384
434
480
Figure 24: Message Window Coordinates
2193
MESSage:SHOW
Clears the contents of the message window and displays the new message in the
window.
Group
Display
Syntax

Arguments

is the message and can include any of the characters shown in the
TDS Character Chart in Appendix A. The maximum length of the message is
1000 characters.
The message is left-justified, and is displayed on a single line starting with the
top most line in the window. A line feed character can be embedded in the string
to position the message on multiple lines. You can also use white space and tab
characters to position the message within a line.
You can send a tab by transmitting a tab character (decimal 9) 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 label area. For example, to tab to pixel 13, send
TAB (decimal 9), NUL (decimal 0), and CR (decimal 13).
The ESC character followed by the @ character turns inverse video on or off and
can be embedded in the message string. The first ESC character followed by a @
character displays all the text that follows in inverse video until another ESC
character followed by a @ character is found in the string.
NOTE. The use of any escape codes other than what is described above may
produce unpredictable results.
The label area is the height and width you have set using the MESSage:Box
command. The length of the label that fits in the label area depends on the
contents of the label because the width of characters varies. For a complete list of
character widths in pixels, see Table A1 on page A1.
If the message exceeds the limits of the window, either horizontally or vertically,
the portion of the message that exceeds the limits will not be displayed. The
2194
message string itself is not altered. The entire message can be returned as a query
response regardless of what is displayed in the window.
Examples

displays Hello world in the upper left corner of the box (you can define the
box size with the MESSAGE BOX command).

a a
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
GPIB talker-listener program.
MESSage:STATE
Controls the display of the message window.
Group
Display
Syntax

! " " #

Arguments

or = 0 removes the message window from the screen.

or 0 displays the message window and its contents on the screen.
The size of the window is defined by MESSage:BOX.
NEWpass (No Query Form)

Changes the password that enables access to password protected data. The
PASSWord command must be successfully executed before using this command
or an execution error will be generated.
Group
Miscellaneous
2195
Related Commands
Syntax
PASSWord, *PUD

Arguments
Examples

is the new password. The password can include up to 10 characters.

creates a new password for accessing the user protected data.
*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
31.
Group
Related Commands
Syntax
Status and Error

BUSY?, *WAI

The *OPC command allows you to synchronize the operation of the digitizing
oscilloscope with your application program. Synchronization methods are
described starting on page 37.
2196
Table 228: Commands that Generate an Operation Complete Message

Operation
Command
Automatic scope adjustment
AUTOSet EXECute
Internal self-calibration
*CAL
Single sequence acquisition
ACQuire:STATE ON or
ACQuire:STATE RUN
(when ACQuire:STOPAfter is set to
SEQuence)
Hardcopy output
HARDCopy STARt
*OPT? (Query Only)

Returns a list of options installed in your digitizing oscilloscope.
Group
Status and Error
Syntax
*OPT?
*OPT?
Examples
OPT?
Might return: 13:Rs232/cent,1M:extended record length,
2F:math pack,05:video trigger,0,CD:color display.
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 digitizing
oscilloscope is powered off, or until the FACtory command, the PASSWord
command with no arguments, or the *RST command is issued.
To change the password, you must first enter the valid password with the
PASSWord command and then change to your new password with the NEWpass
command. Remember that the password is case sensitive.
Group
Miscellaneous
2197
Related Commands
Syntax
NEWpass, *PUD

Arguments
Examples

is the password and can include up to 10 characters. The factory

default password is XYZZYand is always valid.

Enables the *PUB and NEWpass set commands.

Disables the *PUD and NEWpass set commands. You can still use the query
version of *PUD.
*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 31.
Group
Related Commands
Syntax
Status and Error

DESE, *ESE, FACtory, *RST, *SRE

2198
Arguments
<NR1> = 0 sets the power-on status clear flag to false, disables the power-on clear
and allows the digitizing oscilloscope to possibly assert SRQ after power-on.
<NR1> 0 sets the power-on status clear flag true. Sending *PSC 1 therefore
enables the power-on status clear and prevents any SRQ assertion after poweron. Using an out-of-range value causes an execution warning.
Examples
*PSC 0
sets the power-on status clear flag to false.
*PSC?
might return the value 1, showing that the power-on status clear flag is set to
true.
*PUD
Sets or queries a string of Protected User Data. This data is protected by the
PASSWord command. You can modify it only by first entering the correct
password. The password is not necessary to query the data.
Group
Related Commands
Syntax
Miscellaneous
PASSWord
*PUD <Block>
*PUD?
<Space>
<Block>
*PUD
?
Arguments
Examples
<Block> is a string containing up to 100 characters.

*PUD #229This instrument belongs to me
stores the string This instrument belongs to me in the user protected data area.
*PUD?
might return #221Property of Company X.
2199
*RCL (No Query Form)

Restores the state of the digitizing 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 front-panel Save/Recall Setup menu.
Group
Related Commands
Syntax
Save and Recall

DELEte:SETUp, FACtory, *LRN?, RECAll:SETUp, *RST, *SAV, SAVe:SETUp

Arguments
is a value in the range from 1 to 10, and specifies a setup storage location.
Using an out-of-range value causes an execution error (222, Data out of range).
Examples

restores the digitizing oscilloscope from a copy of the settings stored in memory
location 3.
RECAll:SETUp (No Query Form)

Restores a stored or factory front-panel setup of the digitizing oscilloscope. This
command is equivalent to selecting Recall Saved Setup or Recall Factory
Setup or Recall Current Setup in the Save/Recall Setup menu.
Group
Related Commands
Syntax
Save and Recall

DELEte:SETUp, FACtory, *RCL, *RST, *SAV, SAVe:SETUp

2200
Arguments
FACtory selects the factory setup.

<NR1> is a value in the range from 1 to 10 and specifies a setup storage location.
Using an out-of-range value causes an execution error (222, Data out of range).
<file path> (available on instruments with the Option 1F File System) is the
location in mass storage memory where the setup will be recalled from.
<dir>s are optional. If you do not specify them, the TDS will read the file from
the default directory. <filename> stands for a filename of up to 8 characters
followed by a period (.) and any 3-character extension. Do not use wild card
characters.
Examples
RECALL:SETUP FACTORY
recalls (and makes current) the front panel setup to its 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 default directory
and on the default drive.
RECAll:WAVEform (No Query Form)

Recalls a stored waveform into a reference location. This command is equivalent
to selecting Recall File in the Save/Recall Waveform menu.
RECAll
Group
Save and Recall
Syntax
RECAll:WAVEform <file path>,REF<x>
Arguments
WAVEform
<Space>
<file path>
REF
<x>
REF<x> is the location in internal reference memory where the waveform is

recalled from.
<dir>s are optional. If you do not specify them, the TDS will recall the
waveform from the default directory. <filename> stands for a filename of up to
2201
8 characters followed by a period (.) and any 3-character extension. Do not use
wild card characters.
Examples
RECALL:WAVEFORM TEK00000.WFM",REF1
recalls the waveform stored in the file named TEK00000.WFM to reference
location 1.
REM (No Query Form)

Specifies a comment. This line is ignored by the instrument.
Group
Miscellaneous
Syntax
REM <QString>
REM
Arguments
Examples
<Space>
<QString>
<QString> is a string that can have a maximum of 80 characters.

REM "This is a comment"
is ignored by the instrument.
*RST (No Query Form)

(Reset) returns the digitizing oscilloscope to a known set of instrument settings,
but does not purge any aliases or stored settings.
Group
Related Commands
Syntax
Status and Error

FACtory, *PSC, *RCL, RECAll:SETUp, *SAV, SAVe:SETUp
*RST
*RST
*RST returns the instrument settings to the factory defaults (see Appendix D:
Factory Initialization Settings).
2202
The *RST command does not alter the following:

H
The state of the IEEE Std 488.11987 interface.
The selected IEEE Std 488.11987 address of the digitizing oscilloscope.
Calibration data that affect device specifications.
The Output Queue.
The Service Request Enable Register setting.
The Standard Event Status Enable Register setting.
The Power-on status clear flag setting.
Alias definitions.
Stored settings.
The *PUD? response.
RS232:BAUd
RS-232/Centronics Hardcopy Interface Only
Sets or queries RS-232-C interface transmission speed.
Group
RS232
Syntax

Arguments
Examples

where
can be 300, 600, 1200, 2400, 4800, 9600 or 19200.

sets the transmission rate to 9600 baud.
2203
RS232:HARDFlagging
Sets or queries the input and output hard flagging over the RS-232 port. It uses
the RFR (Ready For Receive) 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 RFR until the receive queue is full. Then it unasserts RFR to stop
transmission from an external printer. CTS remains unasserted until the receive
queue is not full. At that time, CTS is asserted again to restart transmission.
Group
RS232
Syntax
RS232:HARDFlagging { ON | OFF | <NR1> }

RS232:HARDFlagging?
ON
<Space>
OFF
<NR1>
RS232
Arguments
HARDFlagging
<ON> or <NR1> 0 turn on hardflagging.

<OFF> or <NR1> = 0 turn off hardflagging.
Examples
RS232:HARDFLAGGING ON
turns on hard flagging.
RS232:PARity
Sets or queries the parity used for all RS-232-C data transfers. Parity adds a bit
to the character sequence. When parity is odd or even, the digitizing oscilloscope
generates the selected parity on output and checks all input against the selected
parity. When parity is none, the digitizing oscilloscope performs no input parity
error checks and generates no output parity.
Group
2204
RS232
Syntax

!
! "

Arguments

indicates the parity bit is sent with even parity and bytes received are
expected to have even parity.

indicates the parity bit is sent with odd parity and bytes received are
expected to have odd parity.
indicates that no parity bit is sent and none are expected.
Examples

sets the parity to even.
RS232:SOFTFlagging
Sets or queries the input and output soft flagging over the RS-232 port. It stops
transmitting data any time it receives an XOFF (DC3) character. It sends an
XOFF character when its 512 byte input buffer has 80 free bytes. The digitizing
oscilloscope begins transmitting data again when it receives an XON (DC1)
character. It sends XON when its input buffer has 100 free bytes.
Group
RS232
Syntax

! ! "


2205
Arguments
ON or <NR1> 0turn on softflagging.

OFF or <NR1> = 0 turn off softflagging.
Examples
RS232:SOFTFLAGGING ON
turns on soft flagging.
RS232:STOPBits
Sets or queries the number of transmission stop bits sent with each character to
identify the end of data for that character.
Group
RS232
Syntax
RS232:STOPBits <NR1>
RS232:STOPBits?
<Space>
:
RS232
Arguments
Examples
STOPBits
<NR1>
?
<NR1> is 1 or 2.
RS232:STOPBITS 1 sets the number of stop bits to 1.
RS232? (Query Only)

Queries the RS232 settings.
Group
RS232
Syntax
RS232?
RS232
2206
Arguments
Examples
None
RS232? queries for RS232 settings.
It might return:
RS232 BAUD: 9600, SOFTFLAGGING: OFF, HARDFLAGGING: ON, PARITY:
NONE, STOPBITS: 1
*SAV (No Query Form)

(Save) stores the state of the digitizing oscilloscope into a specified memory
location. You can later use the *RCL command to restore the digitizing
oscilloscope to this saved state. This is equivalent to selecting the Save Current
Setup in the Save/Recall Setup menu.
Group
Related Commands
Syntax
Save and Recall

DELEte:SETUp, FACtory, *RCL, RECAll:SETUp, SAVe:SETUp
*SAV <NR1>
*SAV
Arguments
Examples
<Space>
<NR1>
<NR1> is a value in the range from 1 to 10 and specifies a location. Using an

out-of-range value causes an execution error. Any settings that have been stored
previously at this location will be overwritten.
*SAV 2
saves the current settings in memory location 2.
SAVe:SETUp (No Query Form)

Saves the current front-panel setup into the specified memory location or file.
This is equivalent to selecting the Save Current Setup in the Save/Recall Setup
menu.
Group
Save and Recall
2207
Related Commands
Syntax
DELEte:SETUp, RECAll:SETUp, *RCL, *SAV

SAVe:SETUp { <NR1> | <file path> }
<NR1>
SAVe
Arguments
SETUp
<Space>
<file path>
<NR1> is a value in the range from 1 to 10 and specifies a location. Using an

out-of-range value causes an execution error. Any settings that have been stored
previously at this location will be overwritten.
<file path> (available on instruments with the Option 1F File System) is a
quoted string that defines the file name and path. Input the file path using the
form <drive>/<dir>/<filename>. <drive> and one or more <dir>s are
optional. If you do not specify them, the TDS will write the file to the default
directory. <filename> stands for a filename of up to 8 characters followed by a
period (.) and the 3-char extension SET. The TDS will generate an error if
you use any other extension for saving a setup.
Examples
SAVE:SETUP 5
saves the current front-panel setup in memory location 5.
SAVE:SETUP TEK00000.SET
saves the current front-panel setup to the file TEK00000.SET in the default
directory and on the default drive.
SAVe:WAVEform (No Query Form)

Stores a waveform in one of four reference memory locations or a mass storage
file (on instruments with the Option 1F File System). This command is
equivalent to selecting either the Save Waveform or the Save to File Waveform
item in the Save/Recall Waveform menu.
Group
Related Commands
Syntax
2208
Save and Recall

DELEte:WAVEFORM, SAVE:WAVEform:FILEFormat
SAVe:WAVEform <wfm>,{ REF<x> | <file path> }
REF
SAVe
WAVEform
Arguments
<Space>
<wfm>
<x>
<file path>
<wfm> is CH<x>, MATH<x>, or REF<x>, and is the waveform that will be

saved.
REF<x> is the location where the waveform will be stored.
<file path> (on instruments with the Option 1F File System) is a quoted string
that defines the file name and path. Input the file path using the form
<drive>/<dir>/<filename>. <drive> and one or more <dir>s are optional. If
you do not specify them, the digitizing oscilloscope will write the file to the
default directory. <filename> stands for a filename of up to 8 characters
followed by a period (.) and the proper 3-character extension. Internal format
waveforms use the WFM extension. The TDS 7XXA can also use a CSV
extension for spreadsheet format files or a DAT extension for MathCad format
files. The digitizing oscilloscope will generate an error if you use any other
extension for saving a waveform.
Examples
SAVE:WAVEFORM MATH2,REF1
saves the math 2 waveform in reference memory location 2.
SAVE:WAVEFORM MATH1,TEK00000.WFM
saves the math1 waveform to the file TEK00000.WFM in the default directory and
on the default drive.
SAVe:WAVEform:FILEFormat
TDS 7XXA Only
Specifies the file format for saved waveforms.
Group
Related Commands
Syntax
Save and Recall

SAVE:WAVEFORM
SAVe:WAVEform:FILEFormat{ INTERNal | SPREADSheet | MATHCad }
SAVe:WAVEform:FILEFormat?
2209
INTERNal
<Space>
SAVe
WAVEFORM
Arguments
FILEFormat
SPREADSheet
MATHCad
?
INTERNal specifies the internal format. Internal format files have a .wav
extension.
SPREADSheet specifies the spreadsheet format. Spreadsheet format files have a
.CSV extension.
MATHCad specifies the MathCad format. MathCad format files have a .DAT
extension.
Examples
SAVE:WAVEFORM:FILEFORMAT SPREADSHEET
specifies the waveform, when saved, will be stored in a spreadsheetcompatible
format.
SELect? (Query Only)

Returns the selected waveform and the display status of all waveforms.
Group
Vertical
Syntax
SELect?
SELect
Examples
2210
SELECT?
might return :SELECT:CH1 1;CH2 0;CH3 0;CH4 0;MATH1 0;
MATH2 0;MATH3 0;REF1 0;REF2 0;REF3 0;REF4 0;SELECT CH1
SELect:<wfm>
Controls the display and selection of waveforms. There can be up to eleven
waveforms displayed at one time, but only one waveform can be selected at a
time. The selected waveform is the waveform that was most recently turned on.
This command is equivalent to pressing a front-panel CH or MORE button.
<wfm> can be CH<x>, MATH<x>, or REF<x>.
Group
Vertical
Syntax

Arguments

or = 0 turns off the display of the specified waveform.

or 0 turns on the display of the specified waveform. The waveform
also becomes the selected waveform.
Examples

turns the channel 2 display on and selects channel 2.

returns either or , indicating whether the REF1 waveform is selected.
SELect:CONTROl
Sets or queries the waveform that is currently affected by the cursor and vertical
commands.
Group
Vertical
Syntax

2211
<Space>
:
SELect
<wfm>
CONTROl
?
Arguments
Examples
<wfm> is CH<x>, MATH<x>, or REF<x>, and is the selected waveform.

SELECT:CONTROL?
might return CH1 as the selected waveform.
SET? (Query Only)

Returns a string listing the digitizing oscilloscope settings, except for configuration information for the calibration values. You can use this string to return the
digitizing oscilloscope to the state it was in when you made the SET? query.
This command is identical to the *LRN? command.
Group
Related Commands
Syntax
Miscellaneous
HEADer, *LRN?, VERBose
SET?
SET
NOTE. The SET? query always returns a string with command headers,
regardless of the setting of the HEADer command. This is because the returned
string is intended to be able to be sent back to the digitizing oscilloscope as a
command string. The VERBose command can still be used to specify whether the
returned headers should be abbreviated or full length.
Examples
2212
SET?
a partial return string may look like this:
:ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE;NUMENV 10;NUMAVG
16;REPET 1;:APPMENU:TITLE "Application Menu";LABEL:BOTTOM1
"";BOTTOM2 "";BOTTOM3 "";BOTTOM4 "";BOTTOM5 "";BOTTOM6 "";BOTTOM7
"";RIGHT1 "";RIGHT2 ""; RIGHT3 "";RIGHT4 "";RIGHT5 "";:HEADER
1;:VERBOSE 1;:ALIAS:STATE 0;:DISPLAY:FORMAT YT;STYLE VECTORS;
FILTER SINX;PERSISTENCE 500.0E-3;GRATICULE FULL;TRIGT 1;INTENSI
TY:OVERALL 85;WAVEFORM 75;TEXT 60;CONTRAST 150;:MESSAGE:SHOW
"hello";STATE 1;BOX 74,84,475,135;:LOCK NONE; :HARDCOPY:FORMAT

EPSIMAGE;PORT GPIB;LAYOUT PORTRAIT;
*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 31.
Group
Related Commands
Syntax
Status and Error

*CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *PSC, *STB?
*SRE <NR1>
*SRE?
<Space>
<NR1>
*SRE
?
Arguments
Examples
<NR1> 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. If *PSC is 0, the SRER
maintains its value through a power cycle.
*SRE 48
sets the bits in the SRER to 00110000 binary.
*SRE?
might return a value of 32, showing that the bits in the SRER have the binary
value 00100000.
*STB? (Query Only)

(Read Status Byte) query returns the contents of the Status Byte Register (SBR)
using the Master Summary Status (MSS) bit. For a complete discussion of the
use of these registers, see page 31.
Group
Status and Error
2213
Related Commands
Syntax
*CLS, DESE, *ESE, *ESR?, EVENT?, EVMSg?, FACtory, *SRE

Returns
Examples

might return the value , showing that the SBR contains the binary value
01100000.
TEKSecure
Initializes both waveform and setup memories. This overwrites any previously
stored data.
TEKSecure writes zeros in all waveform reference memory, regardless of
selected record length, and puts all setups in the factory init state.
TEKSecure then verifies that the waveform and setup memory are in the desired
state. It displays a pass or a fail notifier on completion.
Group
Miscellaneous
Syntax

TIMe
Sets or queries the time that the digitizing oscilloscope can display.
Group
Related Commands
2214
Miscellaneous
DATE, DISplay: CLOCk
Syntax
TIMe <QString>
TIMe?
<Space>
<QString>
TIMe
Arguments
Examples
<QString> is a date in the form hh:mm:ss".

hh refers to the hour number from 1 to 24.
mm refers to the minute number in the hour from 0 to 59.
ss refers to the seconds number in the minute from 0 to 59.
There must be a colon after the hh and after the mm.
TIME "01:24:00"
specifies that the time is set to 01:24 AM.
TRIGger
Forces a trigger event to occur, and the TRIGger query returns the current trigger
parameters.
Group
Trigger
Syntax
TRIGger FORCe
TRIGger?
<Space>
FORCe
TRIGger
?
Arguments
Examples
FORCe creates a trigger event. If TRIGger:STATE is REAdy, the acquisition will

complete, otherwise this command will be ignored. This is equivalent to pressing
the front-panel FORCE TRIGGER button.
TRIGGER FORCe
forces a trigger event to occur.
TRIGGER?
might return :TRIGGER:MAIN:MODE AUTO;TYPE EDGE;LEVEL -480.0E-3;
HOLDOFF:VALUE 0;:TRIGGER:MAIN:EDGE:SOURCE CH1;COUPLING DC;SLOPE
2215
RISE;:TRIGGER:MAIN:LOGIC:CLASS PATTERN;FUNCTION AND;WHEN

TRUE;THRESHOLD:CH1 1.40E+0;CH2 1.200E+0;CH3 1.200E+0;CH4
1.200E+0;:TRIGGER:MAIN:LOGIC:INPUT:CH1 HIGH;CH2 X;CH3 X;
:TRIGGER:MAIN:LOGIC:PATTERN:INPUT:CH4 X;:TRIGGER:MAIN:LOGIC:
STATE:INPUT:CH4 RISE;:TRIGGER:MAIN:PULSE:CLASS GLITCH;SOURCE CH1;
GLITCH:WIDTH 2.0E-9;FILTER ACCEPT;POLARITY POSITIVE;:TRIGGER:
MAIN:PULSE:RUNT:POLARITY POSITIVE;THRESHOLD:HIGH 2.00E+0;LOW
800.0E-3;:TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT 2.0E-9;HIGHLIMIT
2.0E-9;WHEN WITHIN;POLARITY POSITIVE;:TRIGGER:DELAY:TYPE
EDGE;LEVEL -480.0E-3;BY TIME; EDGE:SOURCE CH1;SLOPE RISE;COUPLING
DC;:TRIGGER:DELAY:TIME 16.0E-9;EVENTS:COUNT 2
TRIGger:DELay
Sets the delayed trigger level and returns the current delayed trigger parameters.
Group
Trigger
Syntax
TRIGger:DELay SETLevel
TRIGger:DELay?
<Space>
TRIGger
SETLevel
DELay
?
Arguments
Examples
SETLevel sets the delayed trigger level to half way between the MIN and MAX
amplitudes of the trigger source input. This is equivalent to selecting Set to 50%
in the Delayed Edge Level side menu.
TRIGGER:DELAY SETLEVEL
sets the delayed trigger level to 50% of MAX and MIN.
TRIGGER:DELAY?
might return :TRIGGER:DELAY:TYPE EDGE;LEVEL 0.0E+0;BY
TIME;EDGE:SOURCE CH1;SLOPE RISE;COUPLING DC;:TRIGGER:DELAY:TIME
16.0E-9;EVENTS:COUNT 2
2216
TRIGger:DELay:BY
Selects whether the delayed trigger occurs after a specified number of events or a
specified period of time after the main trigger. This is equivalent to setting Delay
by in the Delayed Trig menu.
Group
Related Commands
Syntax
Trigger
TRIGger:DELay:EVENTS:COUNt, TRIGger:DELay:TIMe
TRIGger:DELay:BY
{ EVENTS | EVENTSTime | TIMe }
TRIGger:DELay:BY
{ EVENTS | TIMe | EVENTSTime (TDS 5XXA, 6XXA, & 7XXA only) |
RUNSAfter (TDS 5XXA, 6XXA, & 7XXA only)}
TRIGger:DELay:BY?
EVENTS
TIMe
<Space>
TRIGger
DELay
Arguments
BY
EVENTSTime
RUNSAfter
?
EVENTS sets the delayed trigger to occur after a set number of trigger events after
the main trigger. The number of events is specified by
TRIGger:DELay:EVENTS:COUNt.
TIMe sets the delayed trigger to be ready to occur a set time after the main trigger
event. The time period is specified by TRIGger:DELay:TIMe.
EVENTSTime (TDS 5XXA, 6XXA, & 7XXA only) sets a specified time after a
specified number of delay trigger trigger events after the main trigger event.
For example in examining a pulse train, you might use the main trigger to detect
the start of the train, then use the delay by events to go to the position of interest
within the pulse train, and then use the time delay to wait a specified time period
before starting the data acquisition.
RUNSAfter (TDS 5XXA, 6XXA, & 7XXA only) looks for a main trigger, then
waits a user-specified time, then starts acquiring data.
2217
Examples

might return .
TRIGger:DELay:EDGE? (Query Only)

Returns the coupling, slope, and source for the delayed trigger.
Group
Trigger
Syntax
%&
%
Examples
&

might return

TRIGger:DELay:EDGE:COUPling
Selects the type of coupling for the delayed trigger. This command is equivalent
to selecting Coupling in the Delayed Trig menu.
Group
Trigger
Syntax
%&
" # '
(not on the TDS 684A & 7XXA) (
( ! (not on the TDS 684A & 7XXA) ( ! (not on the TDS 684A &
7XXA) ( % % (TDS 684A & 7XXA only) ( %! )
%&
" #
%
&
" #
!
$
!
% %
%!

2218
Arguments
selects AC trigger coupling (not on TDS 684A & 7XXA).

selects DC trigger coupling.

coupling removes the high frequency components of the DC signal
(not on the TDS 684A & 7XXA).

coupling removes the low frequency components of the AC signal
(not on the TDS 684A & 7XXA).
coupling sets the delayed trigger coupling to match the setting on
the main trigger (TDS 684A & 7XXA only).
selects DC low sensitivity.
Examples

sets the delay trigger to DC coupling.

might return
for the delayed trigger coupling.
TRIGger:DELay:EDGE:SLOpe
Selects either a rising or falling edge for the delayed trigger. This command is
equivalent to selecting Slope in the Delayed Trig menu.
Group
Trigger
Syntax
! " #

$
!

!

Arguments
specifies to trigger on the falling or negative edge of a signal.

specifies to trigger on the rising or positive edge of a signal.
2219
Examples

might return
, indicating that the delayed trigger occurs on the rising edge.
TRIGger:DELay:EDGE:SOUrce
Selects the source for the delayed trigger. This command is equivalent to
selecting Source in the Delayed Trig menu.
Group
Trigger
Syntax

"

# " (not available on TDS 520A &
524A) $ ! %

"

"

"

!

Arguments
" specifies an external trigger using the Auxiliary Trigger Input
connector that is located on the rear panel of the instrument. The TDS 520A &
524A do not have an Auxiliary Trigger input and so do not support this
argument.
! specifies one of the input channels.
Examples

selects channel 1 as the input source for the delayed trigger.
TRIGger:DELay:EVENTS? (Query Only)

Returns the current delayed trigger event parameter.
2220
Group
Trigger
Syntax

"

TRIGger
Examples
DELay
EVENTS
TRIGGER:DELAY:EVENTS?
might return :TRIGGER:DELAY:EVENTS:COUNT 2
TRIGger:DELay:EVENTS:COUNt
Sets or queries the number of events that must occur before the delayed trigger
occurs when TRIGger:DELay:BY is set to EVENTS. This is equivalent to
setting the Delay by Events count in the Delayed Edge Delay side menu.
Group
Trigger
Syntax
TRIGger:DELay:EVENTS:COUNt <NR1>
TRIGger:DELay:EVENTS:COUNt?
<Space>
TRIGger
DELay
EVENTS
<NR1>
COUNt
?
Arguments
<NR1> is the number of delayed edge trigger events. The range is 2 to 10E7.
Examples
TRIGGER:DELAY:EVENTS:COUNT 4
specifies that the delayed trigger will occur four trigger events after the main
trigger.
TRIGGER:DELAY:EVENTS:COUNT?
might return 2, indicating that 2 events must occur after the main trigger before
the delayed trigger can occur.
TRIGger:DELay:LEVel
Selects the level of the delayed trigger. This command is equivalent to setting
LEVel in the Delayed Trig menu.
Group
Trigger
Syntax
TRIGger:DELay:LEVel { ECL | TTL | <NR3> }

TRIGger:DELay:LEVel?
2221
ECL
<Space>
TTL
<NR3>
TRIGger
DELay
LEVel
ECL specifies a preset ECL level of 1.3 V.
Arguments
TTL specifies a preset TTL level of 1.4 V.

<NR3> is the delayed trigger level, in volts.
TRIGGER:DELAY:LEVEL 2E-3
sets the delayed trigger level to 2 mV.
Examples
TRIGger:DELay:TIMe
Sets or queries the delay time when HORizontal:DELay:MODe is set to
TRIGAfter. This command is identical to the HORizontal:DELay:TIMe:TRIGAfter command, and is equivalent to setting the Delay by Time value in the
Delayed Edge Delay side menu.
When HORizontal:DELay:MODe is set to RUNSAfter, the delay time is set by
the HORizontal:DELay:TIMe:RUNSAfter command.
Group
Related Commands
Syntax
Trigger
HORizontal:DELay:MODe, HORizontal:DELay:TIMe:RUNSAfter, HORizontal:DELay:TIMe:TRIGAfter
TRIGger:DELay:TIMe <NR3>
TRIGger:DELay:TIMe?
<Space>
TRIGger
DELay
<NR3>
TIMe
?
Arguments
Examples
2222
<NR3> is the delay time, in seconds.

TRIGGER:DELAY:TIME 4E-6
sets the delay time to 4 ms.
TRIGger:DELay:TYPe
Sets or queries the type of delayed trigger.
Group
Trigger
Syntax
TRIGger:DELay:TYPe EDGE
TRIGger:DELay:TYPe?
<Space>
TRIGger
DELay
EDGE
TYPe
?
Arguments
Examples
EDGE is a normal trigger. A trigger event occurs when a signal passes through a
specified voltage level in a specified direction. Use the TRIGger:DELay:LEVel
and TRIGger:DELay:EDGE:SLOpe commands to set the voltage level and
direction respectively.
TRIGGER:DELAY:TYPE?
always returns EDGE as the type of delayed trigger.
TRIGger:MAIn
Sets the main trigger level and returns the current main trigger parameters.
Group
Trigger
Syntax
TRIGger:MAIn SETLevel
TRIGger:MAIn?
<Space>
TRIGger
SETLevel
MAIn
?
Arguments
SETLevel sets the main trigger level to half way between the MIN and MAX
amplitudes of the trigger source input. This is equivalent to pressing the
front-panel SET LEVel TO 50% button.
2223
Examples

sets the main trigger level mid way between MAX and MIN.
TRIGger:MAIn:EDGE? (Query Only)

Returns the trigger coupling, source, and slope for the main edge trigger.
Group
Trigger
Syntax
#!

#
Examples
!

might return

TRIGger:MAIn:EDGE:COUPling
Sets or queries the type of coupling for the main edge trigger. This is equivalent
to setting Coupling in the Trigger menu.
Group
Trigger
Syntax
#!
! $ %
% % % # &
#!
!
#
!
!

"

#

Arguments
selects AC trigger coupling.
selects DC trigger coupling.

coupling removes the high frequency components of the DC signal.
2224
LFRej coupling removes the low frequency components of the AC signal.

NOISErej selects DC low sensitivity. It requires added signal amplitude for more
stable, less false triggering.
TRIGGER:MAIN:EDGE:COUPLING DC
sets the main edge trigger coupling to DC.
Examples
TRIGger:MAIn:EDGE:SLOpe
Selects a rising or falling slope for the main edge trigger. This is equivalent to
setting Slope in the Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:EDGE:SLOpe { FALL | RISE }

TRIGger:MAIn:EDGE:SLOpe?
TRIGger
MAIn
EDGE
SLOpe
<Space>
FALL
RISE
?
Arguments
FALL specifies to trigger on the falling or negative edge of a signal.

RISE specifies to trigger on the rising or positive edge of a signal.
Examples
TRIGGER:MAIN:EDGE:SLOPE RISE
sets the main edge trigger to occur on the rising slope.
TRIGger:MAIn:EDGE:SOUrce
Sets or queries the source for the main edge trigger. This is equivalent to setting
Source in the Trigger menu.
Group
Trigger
2225
Syntax
TRIGger:MAIn:EDGE:SOUrce { AUXiliary (not available on TDS 520A &

TDS 524A) | CH<x> | LINE }
TRIGger:MAIn:EDGE:SOUrce?
TRIGger
MAIn
EDGE
SOUrce
AUXiliary
<x>
CH
<Space>
LINE
?
Arguments
CH<x> specifies one of the input channels.

LINE specifies AC line voltage.
Examples
TRIGGER:MAIN:EDGE:SOURCE LINE
specifies the AC line voltage as the main edge trigger source.
TRIGGER:MAIN:EDGE:SOURCE?
might return CH2 for the main edge trigger source.
TRIGger:MAIn:HOLdoff? (Query Only)

For TDS 684A and 7XXA, returns the main trigger holdoff default (TIMe or
DEFAult) and main trigger holdoff time. For other TDS (4XX, 5XXA, 620A,
640A, 644A) returns the main trigger holdoff value.
Group
Trigger
Syntax
TRIGger:MAIn:HOLdoff?
TRIGger
Examples
MAIn
HOLdoff
TRIGGER:MAIN:HOLDOFF?
for the TDS 684A and 7XXA, might return
:TRIGGER:MAIN:HOLDOFF:TIME 250.0E-9;BY DEFAULT
or, for other TDS 4XX, 5XXA, and 6XXA, might return
:TRIGGER:MAIN:HOLDOFF:VALUE 0.
2226
TRIGger:MAIn:HOLdoff:ACTUal? (Query Only)

TDS 684A and 7XXA Only
Returns the main trigger holdoff value in seconds. This is equivalent to selecting
Mode & Holdoff from the main Trigger menu and viewing the value in the side
menu Holdoff Default or Holdoff Time items (whichever is highlighted).
Group
Trigger
Syntax
"

"

might return 4E6 showing the holdoff time is set to 4 ms.
Examples
TRIGger:MAIn:HOLdoff:BY
TDS 684A & 7XXA Only
Sets or queries the main trigger holdoff default. This is equivalent to selecting
Mode & Holdoff from the main Trigger menu, then setting Default Holdoff or
Holdoff (Time) in the resulting side menu.
Group
Trigger
Syntax
" % &

$# '
"
"

!

Arguments

$#

enables the user to set the holdoff time.

$# automatically calculates a holdoff time to use. This time is typically
equivalent to the greater of screen (5 divisions) of time or 250 ns. The
maximum value is 12 seconds. For example, if the oscilloscope is set to
2227
1 msec/division then the default holdoff will be 1 msec/division 25 divs =

25 msec.

set the holdoff to the by time setting. This enables the user to set the holdoff
time.
Examples
TRIGger:MAIn:HOLdoff:TIMe
Sets or queries the main trigger holdoff time. This is equivalent to setting
Holdoff Time in the Mode & Holdoff side menu.
Group
Trigger
Syntax
"

"
"

!

Arguments
Examples
holdoff time in seconds. The range is 250 ns to 12.0 seconds.

sets the holdoff time to be 10 seconds.
TRIGger:MAIn:HOLdoff:VALue
Not in TDS 684A & 7XXA
Sets or queries the main trigger holdoff value. This is equivalent to setting
Holdoff in the Mode & Holdoff side menu.
Group
2228
Trigger
$ !" %
Syntax
$ !" %

#
$
!
"

%
is from 0 to 100, and is a percent of the holdoff range.
Arguments

set the holdoff value to be 10% of the holdoff range.
Examples
TRIGger:MAIn:LEVel
Sets the main trigger level. This command is equivalent to adjusting the
front-panel TRIGGER MAIN LEVEL knob.
Group
Trigger
Syntax
$ ! &

' ' (
$ !

#

$
Arguments
!

specifies a preset ECL level of 1.3 V.
specifies a preset TTL level of 1.4 V.
is the main trigger level, in volts.
Examples

might return , indicating that the main edge trigger is set to 1.4 V.
2229
TRIGger:MAIn:LOGIc? (Query Only)

Returns all main logic trigger parameters.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc?
TRIGger
MAIn
LOGIc
TRIGGER:MAIN:LOGIC?
might return :TRIGGER:MAIN:LOGIC:CLASS PATTERN;
FUNCTION AND;WHEN TRUE;THRESHOLD:CH1 0;CH2 0;CH3 0;
CH4 0;:TRIGGER:MAIN:LOGIC:INPUT:CH1 HIGH;CH2 X;
CH3 X;:TRIGGER:MAIN:LOGIC:PATTERN:INPUT:CH4 X;
:TRIGGER:MAIN:LOGIC:STATE:INPUT:CH4 RISE
Examples
TRIGger:MAIn:LOGIc:CLAss
Sets or queries the type of main logic trigger. This command is equivalent to
selecting Class in the Trigger menu when the Type is set to Logic.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:CLAss { PATtern | STATE

SETHold (TDS 684A & 7XXA only)}
TRIGger:MAIn:LOGIc:CLAss?
TRIGger
MAIn
LOGIc
CLAss
PATtern
<Space>
STATE
SETHold
?
2230
Arguments
"! means that the instrument triggers when the specified logical combinations of channels 1, 2, 3, and 4 are met.
means that the instrument triggers when the specified conditions of
channels 1, 2, and 3 are met after the channel 4 condition is met.
means the oscilloscope will trigger on the setup and hold violations
between a data source and a clock source (TDS 684A & 7XXA only).
Examples

might return .
TRIGger:MAIn:LOGIc:FUNCtion
Sets or queries the logical combination of the input channels for the main logic
trigger.
When TRIGger:MAIn:LOGIc:CLAss is PATtern, this command applies to
channels 1, 2, 3, and 4. When TRIGger:MAIn:LOGIc:CLAss is STATE, only
channels 1, 2, and 3 are logically combined. This command is equivalent to
selecting the function in the Logic Pattern Function side menu.
Group
Trigger
Syntax
!
" # $ $ $ %
!
"

!

Arguments

"
specifies that the instrument will trigger if all the conditions are true.
specifies that the instrument will trigger if any of the conditions are false.
specifies that the instrument will trigger if all of the conditions are false.
specifies that the instrument will trigger if any of the conditions are true.
2231

sets the logical combination of channels to be true when none of the conditions
are true.
Examples

might return
.
TRIGger:MAIn:LOGIc:INPut? (Query Only)

Returns the main logic trigger input for all channels.

Group
Trigger
Syntax

"!

Examples

"!

might return

TRIGger:MAIn:LOGIc:INPut:CH<x>
Sets or queries the main logic trigger input for the specified channel. The
channel is specified by <x> and is 1, 2, or 3. This is equivalent to setting the
inputs in the Logic Pattern Inputs side menu.
Group
Related Commands
Syntax
Trigger

"!# $ % % &

"!#
2232

!
"
specifies logic high.
Arguments
specifies logic low.

specifies a do not care state.

sets the main logic trigger input to logic low for channel 2.
Examples
TRIGger:MAIn:LOGIc:PATtern:INPut:CH4
Sets or queries the main logic trigger input for channel 4. These are the inputs
used when TRIGger:MAIn:LOGIc:CLAss is set to PATtern. This is equivalent to
setting the channel 4 input in the Logic Pattern Inputs side menu.
Group
Trigger
Related Commands
! # $ $ %
Syntax
!

Arguments
!
specifies logic high.

specifies logic low.
specifies a do not care state.
2233
Examples

sets the main logic trigger input to logic low for channel 4 when the logic class is
set to #" .

might return , indicating that the logic input for channel 4 is do not care.
TRIGger:MAIn:LOGIc:PATtern:WHEn
Sets or queries a condition for generating a main logic pattern trigger.
Group
Trigger
Syntax
" #" $ %

% %
&
" #"
"

#"

!
Arguments

specifies the trigger to occur when the pattern becomes true.
specifies the trigger to occur when the pattern becomes false.
specifies trigger to occur if the specific pattern is true less than the
LESSLimit. (see Figure 25 and " '
#" #) Trigger is evaluated at the true-false transition.
specifies trigger to occur if the specific pattern is true longer than the
more limit. (see Figure 25 and " #" '
#) Trigger is evaluated at the true-false transition.
2234
MORELimit
to
LESSLimit
Specified Pattern
Result
Figure 25: LESSThan and MOREThan Arguments
TRIGger:MAIn:LOGIc:PATtern:WHEn:LESSLimit
Sets or queries the maximum time the selected pattern may be true and still
generate a main logic pattern trigger.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:PATtern:WHEn:LESSLimit <NR3>
TRIGger:MAIn: LOGIc: PATtern: WHEn: LESSLimit?
TRIGger
MAIn
LOGIc
PATtern
<Space>
Arguments
WHEn
LESSLimit
<NR3>
?
<NR3> time to hold pattern true.
TRIGger:MAIn:LOGIc:PATtern:WHEn:MORELimit
Sets or queries the minimum time the selected pattern may be true and still
generate a main logic pattern trigger.
Group
Trigger
2235
%"&%"

"
!&
Syntax
%" &%"

"
!&
%
"

"
&%"

!&
$

time to hold pattern true.
Arguments
TRIGger:MAIn:LOGIc:SETHold:CLOCk:EDGE
TDS 684A & 7XXA only
Sets or queries the clock edge polarity for setup and hold violation triggering.
This is equivalent to selecting Define Clock from the main Trigger menu and
Polarity in the resulting side menu.
Group
Trigger
Syntax
%"

#

' ( )
%"
#

%
"

$

#
Arguments

specifies falling edge.

specifies rising edge.
Examples
2236

specifies the polarity as the rising edge.
TRIGger:MAIn:LOGIc:SETHold:CLOCk:LEVel
Sets or queries the main logic setup/hold clock voltage trigger level. This is
equivalent to selecting Levels from the main Trigger menu and Clock Level in
the resulting side menu.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:SETHold:CLOCk:LEVel { ECL | TTL | <NR3> }

TRIGger:MAIn:LOGIc:SETHold:CLOCk:LEVel?
TRIGger
MAIn
LOGIc
ECL
<Space>
TTL
<NR3>
SETHold
Arguments
CLOCk
LEVel
ECL specifies a preset ECL level of 1.3 V.

TTL specifies a preset TTL level of 1.4 V.
<NR3> is the main trigger level, in volts.
Examples
TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:LEVEL 1.4
sets the main logic trigger setup/hold clock level to 1.4 volts.
TRIGger:MAIn:LOGIc:SETHold:CLOCk:SOUrce
Sets or queries the source for the clock for the main logic trigger setup/hold
input. The channel is specified by <x> and is 1, 2, 3, or 4. This is equivalent to
to selecting Define Clock from the main Trigger menu and CH1, CH2, CH3, or
CH4 in the resulting side menu.
Group
Related Commands
Trigger
2237
$! " $ %
Syntax
$! " $

$
!

"
#

$

% specifies one of the input channels (CH1, CH2, CH3, or CH4).
Arguments

selects Channel 2 as the clock source for the main logic trigger setup/hold.
Examples
TRIGger:MAIn:LOGIc:SETHold:DATa:LEVel
Sets or queries the main logic set/hold data level. This is equivalent to to
selecting Levels from the main Trigger menu and Data Level in the resulting
side menu.
Group
Trigger
Syntax
$! "

& ' ' (
$! "

$
!

#

"
Arguments

specifies a preset ECL level of 1.3 V.

specifies a preset TTL level of 1.4 V.
is the main trigger level, in volts.
2238
TRIGGER:MAIN:LOGIC:SETHOLD:DATA:LEVEL 1.4
sets the main logic setup/hold data level to 1.4 volts.
Examples
TRIGger:MAIn:LOGIc:SETHold:DATa:SOUrce
Sets or queries the data channel for the main logic trigger set/hold input. The
channel is specified by <x> and is 1, 2, 3, or 4. This is equivalent to to selecting
Data Source from the main Trigger menu and CH1, CH2, CH3, or CH4 in the
resulting side menu.
Group
Trigger
Related Commands
TRIGger:MAIn:LOGIc:SETHold:DATa:SOUrce CH<x>
Syntax
TRIGger:MAIn:LOGIc:SETHold:DATa:SOUrce?
TRIGger
MAIn
LOGIc
SETHold
<Space>
:
DATa
CH
<X>
SOUrce
?
Arguments
Examples
CH<x> specifies one of the input channels (CH1, CH2, CH3, or CH4)
TRIGGER:MAIN:LOGIC:SETHOLD:DATA:SOURCE CH2
selects Channel 2 as the source for the main logic trigger set/hold.
TRIGger:MAIn:LOGIc:SETHold:HOLDTime
Sets or queries the main logic trigger hold time. This is equivalent to to selecting
Setup/Hold Times from the main Trigger menu and Hold Time in the resulting
side menu.
Group
Trigger
2239
TRIGger:MAIn:LOGIc:SETHold:HOLDTime <NR3>
Syntax
TRIGger:MAIn:LOGIc:SETHold:HOLDTime?
TRIGger
MAIn
LOGIc
SETHold
HOLDTime
<Space>
<NR3>
?
<NR3> specifies the hold time setting in seconds. Positive values for hold time
occur after the clock edge. Negative values occur before the clock edge.
Arguments
TRIGGER:MAIN:LOGIC:SETHOLD:HOLDTIME 200 E-12

sets the main logic trigger sethold holdtime to 200 nanoseconds.
Examples
TRIGger:MAIn:LOGIc:SETHold:SETTime
Sets or queries the main logic trigger set time. This is equivalent to to selecting
Setup/Hold Times from the main Trigger menu and Setup Time in the resulting
side menu.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:SETHold:SETTime <NR3>
TRIGger:MAIn:LOGIc:SETHold:SETTime?
TRIGger
MAIn
LOGIc
SETHold
<Space>
SETTime
<NR3>
?
Arguments
Examples
2240
<NR3> specifies the setup time setting in seconds. Positive values occur before
the clock edge. Negative values occur after the clock edge.
TRIGGER:MAIN:LOGIC:SETHOLD:SETTIME 600 E-12
sets the main logic trigger sethold time to 600 nanoseconds.
TRIGger:MAIn:LOGIc:STATE:INPut:CH4
Sets or queries the main logic trigger input for channel 4. This input is used
when TRIGger:MAIn:LOGIc:CLAss is set to STATE. This is equivalent to
setting the channel 4 input in the Logic Pattern Inputs side menu.
Group
Trigger
Syntax
!

" #

Arguments

specifies falling edge.

specifies rising edge.
Examples

specifies that the main logic trigger input for channel 4 is the rising edge when
the logic class is set to .
TRIGger:MAIn:LOGIc:STATE:WHEn
Sets or queries the main logic state trigger.
Group
Trigger
Syntax
! "

#

2241
TRIGger
MAIn
LOGIc
STATE
<Space>
WHEn
TRUe
FALSe
?
TRUe specifies the trigger to occur when the condition is met on the fourth
channel and the pattern of the first three channels are at the desired states.
Arguments
FALSe
TRIGger:MAIn:LOGIc:THReshold? (Query Only)

Returns the main logic trigger threshold voltage for all channels.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:THReshold?
MAIn
Examples
LOGIc
THReshold
TRIGGER:MAIN:LOGIC:THRESHOLD?
might return :TRIGGER:MAIN:LOGIC:THRESHOLD:CH1 0;CH2 0;
CH3 0;CH4 0
TRIGger:MAIn:LOGIc:THReshold:CH<x>
Sets or queries the main logic trigger threshold voltage for the channel specified
by <x>. This is equivalent to setting the thresholds in the Logic State Threshold
and Logic Pattern Threshold side menus.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:THReshold:CH<x> <NR3>
TRIGger:MAIn:LOGIc:THReshold:CH<x>?
2242
TRIGger
MAIn
LOGIc
THReshold
<Space>
CH
<NR3>
<x>
?
Arguments
Examples
<NR3> specifies the threshold voltage.

TRIGGER:MAIN:LOGIC:THRESHOLD:CH1 .5
sets the main logic trigger threshold for channel 1 to .5 volts.
TRIGger:MAIn:LOGIc:WHEn
Specifies whether the main logic trigger occurs when the specified state goes true
or false when TRIGger:MAIn:LOGIc:CLAss is set to PATtern. This is equivalent
to selecting Trigger When in the Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:LOGIc:WHEn { FALSe | TRUe }

TRIGger:MAIn:LOGIc:WHEn?
<Space>
TRIGger
MAIn
Examples
LOGIc
FALSe
WHEn
TRUe
?
TRIGGER:MAIN:LOGIC:WHEN TRUE
specifies that the main logic trigger when the logic pattern is true.
TRIGger:MAIn:MODe
Sets or queries the main trigger mode. This command is equivalent to selecting
Mode & Holdoff in the Trigger menu.
Group
Trigger
2243
TRIGger:MAIn:MODe { AUTO | NORMal }
Syntax
TRIGger:MAIn:MODe?
AUTO
<Space>
TRIGger
MAIn
Arguments
NORMal
MODe
AUTO generates a trigger if a trigger is not detected within a specific time period.
NORMal waits for a valid trigger event.
Examples
TRIGGER:MAIN:MODE AUTO
specifies that a trigger event is automatically generated.
TRIGger:MAIn:PULse? (Query Only)

Returns the main pulse trigger parameters.
Group
Trigger
Syntax
TRIGger:MAIn:PULse?
TRIGger
Examples
2244
MAIn
PULse
TRIGGER:MAIN:PULSE?
might return :TRIGGER:MAIN:PULSE:CLASS GLITCH;SOURCE CH1;
GLITCH:WIDTH 2.0E-9;FILTER ACCEPT;POLARITY POSITIVE;:TRIGGER:
MAIN:PULSE:RUNT:POLARITY POSITIVE;THRESHOLD:HIGH 2.00E+0;LOW
800.0E-3;:TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT 2.0E-9;HIGHLIMIT
2.0E-9;WHEN WITHIN;POLARITY POSITIVE as the current main pulse trigger
parameters.
TRIGger:MAIn:PULse:CLAss
Sets or queries the type of pulse to trigger on. This command is equivalent to
selecting Class in the Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:CLAss { GLItch | RUNT | WIDth |

SLEWRate (TDS 684A & 7XXA only)}
TRIGger:MAIn:PULse:CLAss?
TRIGger
MAIn
PULse
GLItch
RUNT
<Space>
WIDth
SLEWRate
CLAss
Arguments
GLItch triggers when a pulse is found that is of the specified polarity and width.
These are set with the commands TRIGger:MAIn:PULse:GLItch:POLarity and
TRIGger:MAIn:PULse:GLItch:WIDth.
RUNT triggers when a pulse crosses the first preset voltage threshold but does not
cross the second preset threshold before recrossing the first. The thresholds are
set with the TRIGger:MAIn:PULse:RUNT:THReshold:LOW and TRIGger:MAIn:PULse:RUNT:THReshold:HIGH commands. The crossing can be
either positive or negative as specified by TRIGger:MAIn:PULse: RUNT:POLarity.
WIDth triggers when a pulse is found that has the specified polarity and is either
inside or outside the limits as specified by TRIGger:MAIn:PULse: WIDth:LOWLimit and TRIGger:MAIn:PULse:WIDth:HIGHLimit. The polarity is selected
using the TRIGger:MAIn:PULse:WIDth:POLarity command.
SLEwrate triggers when the slew rate of the source violates the specified
conditions (TDS 684A & 7XXA only).
Examples
TRIGGER:MAIN:PULSE:CLASS WIDTH
specifies a width pulse for the main trigger.
2245
TRIGger:MAIn:PULse:GLItch? (Query Only)

Returns the current main glitch pulse trigger parameters.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:GLItch?
MAIn
Examples
PULse
GLItch
TRIGGER:MAIN:PULSE:GLITCH?
might return :TRIGGER:MAIN:PULSE:CLASS GLITCH;SOURCE CH1;
GLITCH:WIDTH 2.0E-9;FILTER ACCEPT;POLARITY POSITIVE.
TRIGger:MAIn:PULse:GLItch:FILTer
Controls glitch detection. This command is equivalent to selecting Filter in the
Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:GLItch:FILTer { ACCept | REJect }

TRIGger:MAIn:PULse:GLItch:FILTer?
TRIGger
MAIn
GLItch
Arguments
PULse
<Space>
FILTer
ACCept
REJect
?
ACCept specifies that the digitizing oscilloscope will trigger only on pulses that
are narrower than the specified width when the main trigger type is set to pulse
glitch. The width is specified using TRIGger:MAIn:PULse:GLItch:WIDth
command.
REJect specifies that the digitizing oscilloscope will trigger only on pulses that
are wider than the specified width when the main trigger type is set to pulse
2246
glitch. The width is specified using TRIGger:MAIn:PULse:GLItch:WIDth

command.
Examples

returns either #& or
&, indicating whether glitches are filtered.
TRIGger:MAIn:PULse:GLItch:POLarity
Sets or queries the polarity for the main pulse glitch trigger. This command is
equivalent to selecting Polarity & Width in the Trigger menu.
Group
Trigger
Syntax
$"%& $!&( )

$ *
&!' *
+
$"%& $!&(
$
"
%
$
#

&!'

&
Examples
$!&(

specifies that the polarity of the glitch can be either positive or negative.
TRIGger:MAIn:PULse:GLItch:WIDth
Sets or queries the width for the main pulse glitch trigger. This command is
equivalent to selecting Polarity & Width in the Trigger menu.
Group
Trigger
Syntax
$"%& &

$"%& &
2247
TRIGger
MAIn
PULse
GLItch
WIDth
<Space>
<NR3>
?
<NR3> is the width of the glitch, in seconds.
Arguments
TRIGGER:MAIN:PULSE:GLITCH:WIDTH 15E-6
sets the width of the glitch to 15 ms.
Examples
TRIGger:MAIn:PULse:RUNT? (Query Only)

Returns the current parameters for the main pulse runt trigger.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT?
MAIn
Examples
PULse
RUNT
TRIGGER:MAIN:PULSE:RUNT?
might return :TRIGGER:MAIN:PULSE:RUNT:POLARITY POSITIVE;THRESH
OLD:HIGH 2.00E+0;LOW 800.0E-3.
TRIGger:MAIn:PULse:RUNT:POLarity
Sets or queries the polarity for the main pulse runt trigger. This command is
equivalent to selecting Polarity in the Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT:POLarity { EITher | NEGAtive | POSITIVe }

TRIGger:MAIn:PULse:RUNT:POLarity?
2248
TRIGger
MAIn
PULse
:
EITher
NEGAtive
<Space>
POSITIVe
RUNT
Arguments
POLarity
NEGAtive indicates that the falling edge crosses the high threshold and the rising
edge recrosses the high threshold without either edge ever crossing the low
threshold.
POSITIVe indicates that the rising edge crosses the low threshold and the falling
edge recrosses the low threshold without either edge ever crossing the high
threshold.
EITher indicates either NEGAtive or POSITIVe polarity.
Examples
TRIGGER:MAIN:PULSE:RUNT:POLARITY NEGATIVE
specifies that the polarity of the main pulse runt trigger is negative.
TRIGger:MAIn:PULse:RUNT:THReshold? (Query Only)

Returns the upper and lower thresholds for the main pulse runt trigger.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT:THReshold?
Examples
MAIn
PULse
RUNT
THReshold
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD?
might return :TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:HIGH 2.00E+0;LOW
800.0E-3.
2249
TRIGger:MAIn:PULse:RUNT:THReshold:BOTh
Sets or queries the trigger level switching thresholds for the main pulse runt
trigger. This command is equivalent to setting Set to TTL or Set to ECL in the
Main Pulse Runt Trigger menus Thresholds side menu item.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT:THReshold:BOTh { TTL | ECL }
MAIn
PULse
Arguments
RUNT
BOTh
<Space>
THReshold
TTL
ECL
TTL sets the upper threshold to 1.8 V and the lower threshold to 0.8 V.
ECL sets the upper threshold to 1.1 V and the lower threshold to 1.5 V.
Examples
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:BOTH TTL
sets the threshold of the pulse runt trigger to the nominal TTL voltage levels.
TRIGger:MAIn:PULse:RUNT:THReshold:HIGH
TDS 5XXA 6XXA, & 7XXA Only
Sets or queries the upper limit for the main pulse runt trigger. This command is
equivalent to setting the threshold in the Pulse Runt Threshold side menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT:THReshold:HIGH <NR3>
TRIGger:MAIn:PULse:RUNT:THReshold:HIGH?
2250
TRIGger
MAIn
PULse
RUNT
<Space>
THReshold
<NR3>
HIGH
?
<NR3> is the threshold, in volts.
Arguments
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:HIGH 120E-3
sets the upper limit of the pulse runt trigger to 120 mV.
Examples
TRIGger:MAIn:PULse:RUNT:THReshold:LOW
Sets or queries the lower limit for the main pulse runt trigger. This command is
equivalent to setting the threshold in the Pulse Runt Threshold side menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:RUNT:THReshold:LOW <NR3>
TRIGger:MAIn:PULse:RUNT:THReshold:LOW?
TRIGger
MAIn
PULse
RUNT
<Space>
THReshold
<NR3>
LOW
?
Arguments
Examples

TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:LOW 50E-3
sets the lower limit of the pulse runt trigger to 50 mV.
2251
TRIGger:MAIn:PULse:RUNT:WHEn
Sets or queries the type of pulse width the trigger checks for when it uncovers a
runt. This is equivalent to to selecting Trigger When from the main Triggers
Pulse, Runt menu and Occurs or Wider Than in the resulting side menu.
Group
Trigger
Syntax

# " $
! %

Arguments

"

!

" specifies a trigger if a runt of any detectable width occurs.

! specifies a trigger if a runt of greater than the specified width occurs.
Examples

sets the runt trigger to occur when the oscilloscope detects a runt in a pulse wider
than the specified width.
TRIGger:MAIn:PULse:RUNT:WIDth
Sets or queries the minimum width for a valid main pulse runt trigger. This
command is equivalent to entering a value in the Trigger menus Wider Than
side menu.
Group
Trigger
Syntax
!

!
2252
TRIGger
MAIn
PULse
RUNT
<Space>
<NR3>
WIDth
?
<NR3> is the minimum width in seconds.
Arguments
TRIGGER:MAIN:PULSE:RUNT:WIDTH 15E-6
sets the minimum width of the pulse runt trigger to 15 ms.
Examples
TRIGger:MAIn:PULse:SLEWRate:DELTATime
Sets or queries the delta time used in calculating the slew rate trigger. This is
equivalent to to selecting Trigger When from the main Triggers Slew Rate
menu and Delta Time in the resulting side menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEWRate:DELTATime <NR3>
TRIGger:MAIn:PULse:SLEWRate:DELTATime?
TRIGger
MAIn
PULse
SLEWRate
<Space>
<NR3>
DELTATime
?
Arguments
Examples
<NR3> is the delta time in seconds.

TRIGGER:MAIN:PULSE:SLEWRATE:DELTATIME 15E-6
sets the slew rate triggers delta time to 15 ms.
2253
TRIGger:MAIn:PULse:SLEwrate:POLarity
Sets or queries the polarity for the main pulse slew rate trigger. This command is
equivalent to selecting Polarity in the Trigger menu with Type set to SlewRate.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEwrate:POLarity { EITher | NEGAtive |

POSITIVe }
TRIGger:MAIn:PULse:SLEwrate:POLarity?
TRIGger
MAIn
PULse
:
EITher
<Space>
NEGAtive
POSITIVe
SLEwrate
Arguments
POLarity
NEGAtive indicates that a pulse edge must traverse from the upper (most
positive) to lower (most negative) level for slew rate triggering to occur.
POSITIVe indicates that a pulse edge must traverse from the lower (most
negative) to higher (most positive) level for slew rate triggering to occur.
EITher indicates either NEGAtive or POSITIVe polarity.
Examples
TRIGGER:MAIN:PULSE:SLEwrate:POLARITY EITHER
specifies that the polarity of the slew rate can be either positive or negative.
TRIGger:MAIn:PULse:SLEwrate:SLEwrate? (Query Only)

Returns the slew rate value. This is the
((Upper Threshold Lower Threshold) / Delta Time)
The value is limited to the three most significant digits.
Group
2254
Trigger
TRIGger:MAIn:PULse:SLEwrate:SLEwrate?
Syntax
TRIGger
MAIn
PULse
SLEwrate
SLEwrate
TRIGGER:MAIN:PULSE:SLEWRATE:SLEWRATE?
Returns the slew rate. It is given as an appropriate amount of volts per second.
For example, 1.2E+6 would represent a slew rate of 1.2 megavolts/second.
Examples
TRIGger:MAIn:PULse:SLEwrate:THReshold:BOTh
Sets the upper and lower slew rate trigger thresholds. This is equivalent to to
selecting Thresholds from the main Triggers Slew Rate menu and entering a
value in the resulting side menus High Threshold or Low Threshold items.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEwrate:THReshold:BOTh { TTL | ECL }
MAIn
PULse
SLEwrate
THReshold
TTL
BOTh
ECL
Arguments
TTL sets the upper threshold to 1.8 V and the lower threshold to 0.8 V.
ECL sets the upper threshold to 1.1 V and the lower threshold to 1.5 V.
Examples
TRIGGER:MAIN:PULSE:SLEwrate:THRESHOLD:BOTH TTL
sets the trigger runt threshold to TTL.
TRIGger:MAIn:PULse:SLEwrate:THReshold:HIGH
Sets or queries the upper (most positive) limit of the two threshold levels that a
pulse edge must traverse for the slew rate trigger to occur. This command is
equivalent to setting the higher threshold in the Pulse Slew Rate Triggers
Thresholds side menu item.
2255
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEwrate:THReshold:HIGH <NR3>
TRIGger:MAIn:PULse:SLEwrate:THReshold:HIGH?
TRIGger
MAIn
PULse
SLEwrate
THReshold
<Space>
<NR3>
HIGH
?
Arguments
TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:HIGH 120E-3
sets the upper limit of the pulse slew rate trigger to 120 mV.
Examples
TRIGger:MAIn:PULse:SLEwrate:THReshold:LOW
Sets or queries the lower (most negative) limit of the two threshold levels that a
pulse edge must traverse for the slew rate trigger to occur. This command is
equivalent to setting the lower threshold in the Pulse Slew Rate Triggers
Thresholds side menu item.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEwrate:THReshold:LOW <NR3>
TRIGger:MAIn:PULse:SLEwrate:THReshold:LOW?
TRIGger
MAIn
PULse
SLEwrate
<Space>
THReshold
<NR3>
LOW
?
Arguments
2256
Examples
TRIGGER:MAIN:PULSE:SLEWRATE:THRESHOLD:LOW 50E-3
sets the lower limit of the pulse slew rate trigger to 50 mV.
TRIGger:MAIn:PULse:SLEwrate:WHEn
Sets or queries whether to check for a slewing signal that is faster or slower than
the specified delta time. This is equivalent to to selecting Trigger When from
the main Triggers Slew Rate menu and entering a value in the resulting side
menus Trig if Less Than or Trig if Greater Than items.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:SLEwrate:WHEN { FASTERthan | SLOWERthan }

TRIGger:MAIn:PULse:SLEwrate:WHEN?
TRIGger
MAIn
SLEwrate
Arguments
PULse
WHEN
<Space>
FASTERthan
SLOWERthan
?
FASTERthan sets the trigger to occur when the slew is faster than the set
volts/second rate.
SLOWERthan sets the trigger to occur when the slew is slower than the set
volts/second rate.
Examples
TRIGGER:MAIN:PULSE:SLEWRATE:WHEN FASTERTHAN
sets the slew rate trigger to work when the slew is faster than the set volts/second
rate.
TRIGger:MAIn:PULse:SOUrce
Sets or queries the source for the main pulse trigger. This is equivalent to
selecting the source in the Pulse Runt Source side menu.
Group
Trigger
2257
TRIGger:MAIn:PULse:SOUrce CH<x>
Syntax
TRIGger:MAIn:PULse:SOUrce?
TRIGger
MAIn
PULse
SOUrce
<Space>
CH
<X>
?
CH<x> specifies one of the input channels.
Arguments
TRIGGER:MAIN:PULSE:SOURCE CH2
selects Channel 2 as the source for the main pulse trigger.
Examples
TRIGger:MAIn:PULse:WIDth? (Query Only)

Returns the width parameters for the main pulse width trigger.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:PULse:WIDth?
MAIn
Examples
PULse
WIDth
TRIGGER:MAIN:PULSE:WIDTH?
might return :TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT 2.0E-9;HIGHLIMIT
2.0E-9;WHEN WITHIN;POLARITY POSITIVE as the current main pulse trigger
parameters.
TRIGger:MAIn:PULse:WIDth:HIGHLimit
Sets or queries the upper limit for the main pulse width trigger. This is equivalent to setting the Upper Limit in the Pulse Width Trig When side menu.
Group
2258
Trigger
TRIGger:MAIn:PULse:WIDth:HIGHLimit <NR3>
Syntax
TRIGger:MAIn:PULse:WIDth:HIGHLimit?
TRIGger
MAIn
PULse
WIDth
:
<Space>
<NR3>
HIGHLimit
?
<NR3> is the upper limit, in seconds.
Arguments
TRIGger:MAIn:PULse:WIDth:LOWLimit
Sets or queries the lower limit for the main pulse width trigger. This is equivalent to setting the Lower Limit in the Pulse Width Trig When side menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:WIDth:LOWLimit <NR3>
TRIGger:MAIn:PULse:WIDth:LOWLimit?
TRIGger
MAIn
PULse
WIDth
:
<Space>
<NR3>
LOWLimit
?
Arguments
<NR3> is the lower limit, in seconds.
TRIGger:MAIn:PULse:WIDth:POLarity
Sets or queries the polarity for the main pulse width trigger. This is equivalent to
selecting the polarity in the Pulse Width Polarity side menu.
Group
Trigger
2259
TRIGger:MAIn:PULse:WIDth:POLarity { NEGAtive | POSITIVe }
Syntax
TRIGger:MAIn:PULse:WIDth:POLarity?
TRIGger
MAIn
PULse
WIDth
POLarity
NEGAtive
<Space>
POSITIVe
?
NEGAtive specifies a negative pulse.
Arguments
POSITIVe specifies a positive pulse.
TRIGger:MAIn:PULse:WIDth:WHEn
Selects the condition when the trigger occurs. This is equivalent to selecting the
condition in the Pulse Width Trig When side menu.
Group
Trigger
Syntax
TRIGger:MAIn:PULse:WIDth:WHEn { OUTside | WIThin }

TRIGger:MAIn:PULse:WIDth:WHEn?
TRIGger
MAIn
PULse
WIDth
<Space>
WHEn
Arguments
OUTside
WIThin
?
OUTside specifies a trigger when the duration of the pulse is greater than the
high limit or less than the low limit specified. The high and low limits are
specified with the TRIGger:MAIn:PULse:WIDth:HIGHLimit and
TRIGger:MAIn:PULse:WIDth:LOWLimit commands respectively.
WIThin specifies a trigger when the duration of the pulse is within the high and
low limits. The high and low limits are specified with the
2260
TRIGger:MAIn:PULse:WIDth:HIGHLimit and
TRIGger:MAIn:PULse:WIDth:LOWLimit commands respectively.
TRIGGER:MAIN:PULSE:WIDTH:WHEN?
returns either OUTSIDE or WITHIN, indicating the conditions for generating a
pulse trigger.
Examples
TRIGger:MAIn:TYPe
Sets or queries the type of main trigger. This is equivalent to setting Type in the
Trigger menu.
Group
Trigger
Syntax
TRIGger:MAIn:TYPe { EDGE | LOGIc | PULse | VIDeo }

(Note: only the TDS 5XXA, 6XXA, & 7XXA use the LOGIc and PULse
arguments. Only digitizing oscilloscopes with option 5 use the VIDeo argument.)
TRIGger:MAIn:TYPe?
EDGE
LOGIc
<Space>
PULse
VIDeo
TRIGger
Arguments
MAIn
TYPe
EDGE is a normal trigger. A trigger event occurs when a signal passes through a
specified voltage level in a specified direction and is controlled by the TRIGger:MAIn:EDGE commands.
LOGIc (TDS 5XXA, 6XXA, & 7XXA only) specifies that a trigger occurs when
specified conditions are met and is controlled by the TRIGger:MAIn:LOGIc
commands.
PULse (TDS 5XXA, 6XXA, & 7XXA only) specifies that a trigger occurs when
a specified pulse is found and is controlled by the TRIGger:MAIn:PULse
commands.
VIDeo (option 05 only) specifies that a trigger occurs when a specified signal is
found and is controlled by the TRIGger:MAIn:VIDeo commands.
2261
TRIGGER:MAIN:TYPE?
might return PULSE indicating that the main trigger type is a pulse trigger.
Examples
TRIGger:MAIn:VIDeo? (Query Only)

TDS 5XXA, 6XXA, & 7XXA Option 5 Only
Returns the main video trigger parameters.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo?
TRIGger
MAIn
VIDeo
TRIGGER:MAIN:VIDEO?
might return: NTS;CH1;NEGA;NUMER;2;1;COLO;COLO;787;
59.94E+0;1050;2;890.0E-9;3.56E-6;15.00E-6;11.56E-6;
15.89E-6 as the current main video trigger parameters.
Examples
TRIGger:MAIn:VIDeo:BY
TDS 4XX Option 5 Only
Sets or queries the video trigger delay mode. This is equivalent to using the
Video TV Delay Mode side menu.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:BY { TIMe | LINES }

TRIGger:MAIn:VIDeo:BY?
TRIGger
MAIn
VIDeo
BY
<Space>
TIMe
LINES
?
2262
Arguments
TIMe specifies a delay by time.

LINES specifies a delay by a number of video lines.
Examples
TRIGGER:MAIN:VIDEO:BY TIME
specifies a delay by time.
Sets or queries the field the video trigger acts on. This is equivalent to using the
Video Scan Rate and Interlace side menu when Class is NOT set to Custom.
Group
Trigger
Syntax

"

"!

Arguments
FIELD1 specifies interlaced video field 1.

FIELD2 specifies interlaced video field 2.
FIELDEither specifies alternating both video field 1 and video field 2.
Examples
TRIGGER:MAIN:VIDEO:SCAN FIELD1
selects field 1.
Sets or queries the field the video trigger acts on. This is equivalent to pressing
Field in the video main menu, then Field in the side menu, and entering a value
with the keypad or general purpose knob.
2263
Group
Trigger
Syntax

specifies the video (color) field. For example, specifies interlaced video
field one and specifies interlaced video field two.
Arguments
PAL signals have 1 to 8 fields, HDTV signals have 1 or 2, and FlexFormat

supports 1 or 2.

selects field 1.
Examples
TRIGger:MAIn:VIDeo:FIELDType
Sets or queries the field the video trigger acts on. This is equivalent to pressing
Field in the video main menu and then Field, Odd, Even or All in the side
menu.
Group
Trigger
Syntax

!$
" "

" $#

2264
Arguments
NUMERic specifies a selected line in the selected field. If you send this
command when the mode is MONO or SECAM, the digitizing oscilloscope will
generate an SRQ.
ALL specifies a selected line in all fields.
EVEN specifies a selected line in even fields.
ODD specifies a selected line in odd fields.
TRIGGER:MAIN:VIDEO:FIELDTYPE ALL
selects a selected line in all fields.
Examples
TRIGger:MAIn:VIDeo:FLEXformat? (Query Only)

Returns the main flexible-format video trigger parameters.
TRIGger
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:FLEXformat?
MAIn
Examples
VIDeo
FLEXformat
TRIGGER:MAIN:VIDEO:FLEXFORMAT?
might return: 59.94E+0;1050;2;890.0E-9;3.56E-6;15.00E-6;11.56E-6;
15.89E-6 as the flexible-format video trigger parameters.
TRIGger:MAIn:VIDeo:FLEXformat:FIELDRATE
Sets or queries the flexible-format video frames per second (e.g. 59.94 frames
per second for 1050 and 50 for 1250). This is equivalent to selecting Setup from
the video main menu (with FlexFmt as the Standard), Field Rate from the side
menu, and entering a value with the keypad or the general purpose knob.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:FLEXformat:FIELDRATE <NR3>
TRIGger:MAIn:VIDeo:FLEXformat:FIELDRATE?
2265

!

Arguments
Examples
the field rate.

returns the specified field rate.
TRIGger:MAIn:VIDeo:FLEXformat:FIELDS
Sets or queries the flexible-format video fields. This is equivalent to pressing
Setup from the video main menu (with FlexFmt as the Standard), Fields from
the side menu, and entering the value with the keypad or the general purpose
knob.
Group
Trigger
Syntax

!

!

!

Arguments
Examples
the number of fields in the standard.

!

returns the number of fields in the format.
2266
TRIGger:MAIn:VIDeo:FLEXformat:LINES
Sets or queries the flexible-format video lines in a frame. This is equivalent to
pressing Setup from the video main menu (with FlexFmt as the Standard),
Lines from the side menu, and entering the value with the keypad or the general
purpose knob.
Group
Trigger
Syntax

!

!

!

Arguments
Examples
the frame lines.

returns the specified number of lines.
TRIGger:MAIn:VIDeo:FLEXformat:NEGSyncwidth
Sets or queries the flexible-format negative sync width. The HDTV horizontal
sync is a tri-level sync. The first of the two consecutive sync pulses used is
negative and the second is positive. The positive sync pulse starts on the rising
edge of the negative sync. The two pulses have the same width such that
specifying the negative pulse is only required. Setting the width is equivalent to
pressing Setup from the video main menu (with FlexFmt as the Standard),
Sync Width from the side menu, and entering the value with the keypad or the
general purpose knob.
Group
Trigger
2267
Syntax
'$
%%'#( *$)"(!
'$
%%'#( *$)"(!
'
$

%
%'#(
&

*$)"(!

Arguments
Examples
the negative sync width.

returns the specified flexible-format negative sync width.
TRIGger:MAIn:VIDeo:FLEXformat:V1STArttime
Sets or queries the time from the positive edge of the tri-sync pulse for the last
line in the selected field (t0) to the leading edge (negative) of the first negative
vertical sync pulse. This is equivalent to selecting Setup from the video main
menu (with FlexFmt as the Standard), pressing the V1 Start Time in the side
menu, and entering a value with the keypad or the general purpose knob.
Group
Trigger
Syntax
'$
%%'#('(("#
'$
%%'#('(("#
'
$

%
%'#(

&

'(("#

Arguments
2268
the v1 starttime.
Examples

returns the specified HDTV v1starttime.
TRIGger:MAIn:VIDeo:FLEXformat:V1STOptime
Sets or queries the time from t0 to the trailing edge (positive) of the first negative
vertical sync pulse. This is equivalent selecting Setup from the video main menu
(with FlexFmt as the Standard), pressing the V1 Stop Time in the side menu,
and entering a value with the keypad or the general purpose knob.
Group
Trigger
Syntax
"
"#!#
"
"#!#
"

"#

!

!#

Arguments
Examples
the v1 stoptime.

returns the specified v1stoptime.
TRIGger:MAIn:VIDeo:FLEXformat:V2STArttime
Sets or queries the time from the positive edge of the tri-sync pulse for the last
line in the selected field (t0) to the leading edge (positive) of the second vertical
sync pulse. Note: the second pulse may be a negative pulse or the negative
portion of a tri-sync pulse that is within the last line (usually located at the
line point). This is equivalent to selecting Setup from the video main menu
(with FlexFmt as the Standard), pressing the V2 Start Time in the side menu,
and entering a value with the keypad or the general purpose knob.
2269
Group
Trigger
Syntax
!

!"!""
!
!"!""
!

!"

!""

Arguments
Examples
the v2 starttime.

returns the specified v2 starttime.
TRIGger:MAIn:VIDeo:FLEXformat:V2STOptime
Sets or queries the time from t0 to the trailing edge (positive) of the second
negative vertical sync pulse. This is equivalent selecting Setup from the video
main menu (with FlexFmt as the Standard), pressing the V2 Stop Time in the
side menu, and entering a value with the keypad or the general purpose knob.
Group
Trigger
Syntax
!

!" "
!
!" "
!

!"

"

Arguments
2270
the v2 stoptime.
TRIGGER:MAIN:VIDEO:FLEXFORMAT:V2STOPTIME?
Examples
returns the specified v2 stoptime.
TRIGger:MAIn:VIDeo:HDTv
Sets or queries the high definition TV frame rate. This is equivalent to toggling
HDTV from the Video main-menu Standard pop-up, pressing Format, and then
selecting a frame rate from the side menu.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:HDTv <NR1>
TRIGger:MAIn:VIDeo:HDTv?
<Space>
TRIGger
MAIn
Arguments
Examples
VIDeo
HDTv
<NR1>
?
<NR1> specifies the frame rate. More precisely, 787 selects a 787/59.94/2:1
format. 1050 selects a 1050/59.94/2:1 format. 1125 selects a 1125/60/2:1 format.
1250 selects a 1250/50/2:1 format.
TRIGGER:MAIN:VIDEO:HDTV 787
specifies 787/59.94/2:1 format.
TRIGger:MAIn:VIDeo:HOLdoff? (Query Only)

Returns the video trigger holdoff value.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:HOLdoff?
2271
!

might return

.
Examples
TRIGger:MAIn:VIDeo:HOLdoff:VALue
Sets or queries the video trigger holdoff value. This is equivalent to setting
Holdoff in the Mode & Holdoff side menu of the video trigger menu.
Group
Trigger
Syntax
! "

! "
!

"

Arguments
Examples
is from 0 to 100, and is a percent of the holdoff range.

set the holdoff value to be 10% of the holdoff range.
TRIGger:MAIn:VIDeo:INTERLAce
Sets or queries the video trigger interlace format. This is equivalent to setting
Interlace in the Scan Rate and Interlace main menu of the video trigger menu
when Class is set to Custom.
Group
2272
Trigger

"
#
#
! #
$
Syntax

!

TRIGger:MAIn:VIDeo:LINE
Sets or queries the video trigger in terms of a number of lines. This is equivalent
to pressing the Line item in the video main menu, pressing Line in the side
menu (if needed), and entering a value with the keypad or the general purpose
knob. The minimum line number is the starting line in the field. For PAL, field 1
has line 2 as the minimum, and field 2 has line 315.
Group
Trigger
Syntax

Arguments
Examples
specifies a number of lines to delay by.

selects 5 lines for the desired delay period.
2273
TRIGger:MAIn:VIDeo:LINES
Sets or queries the video trigger delay in terms of a number of lines. This is
equivalent to entering data in the Delay by Lines item in the Video TV Delay
Mode side menu.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:LINES <NR3>
TRIGger:MAIn:VIDeo:LINES?
<Space>
TRIGger
MAIn
VIDeo
<NR3>
LINES
?
Arguments
Examples
<nr3> specifies a number of lines to delay by.

TRIGGER:MAIN:VIDEO:LINES 5
selects 5 lines for the desired delay period.
TRIGger:MAIn:VIDeo:NTSc
Sets or queries the NTSC mode selection. This is equivalent to choosing
525/NTSC in the video main-menu pop-up, Mode in the main menu, and a side
menu item (NTSC or Mono).
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:NTSc { MONo | COLOr }

TRIGger:MAIn:VIDeo:NTSc?
2274
TRIGger
MAIn
VIDeo
NTSc
<Space>
MONo
COLOr
?
Arguments
MONo specifies mode for noncolor signals.

COLOr specifies mode for color field triggering and enables numeric triggering.
TRIGGER:MAIN:VIDEO:NTSC MONO
specifies numeric fields are invalid.
Examples
TRIGger:MAIn:VIDeo:PAL
Sets or queries the PAL video trigger mode selection. This is equivalent to
toggling 625/PAL in the video main-menu pop-up, Mode in the main menu, and
a side menu item (PAL, Mono, or SECAM).
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:PAL { MONo | COLOr | SECAm }

TRIGger:MAIn:VIDeo:PAL?
TRIGger
MAIn
VIDeo
PAL
MONo
<Space>
COLOr
SECAm
?
Arguments
MONo specifies mode for non-color signals.

COLOr specifies mode for color field triggering and enables numeric triggering.
SECAm specifies mode for SECAM signals.
2275
TRIGGER:MAIN:VIDEO:PAL MONO
specifies non-color PAL signals.
Examples
TRIGger:MAIn:VIDeo:SCAN
Sets or queries the video trigger scan parameters. This is equivalent to using the
Video Scan Parameters side menu.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:SCAN { RATE1 | RATE2 | RATE3 | RATE4 }

TRIGger:MAIn:VIDeo:SCAN?
TRIGger
MAIn
VIDeo
RATE1
SCAN
RATE2
<Space>
RATE3
RATE4
?
Arguments
RATE1 specifies a 15 to 20 kHz video line rate.

Examples
TRIGGER:MAIN:VIDEO:SCAN RATE1
selects rate 1.
TRIGger:MAIn:VIDeo:SOUrce
Option 05 Only
Sets or queries the source for the main video trigger. This is equivalent to
selecting the Source in the video main menu and a desired channel from the side
menu.
Group
2276
Trigger
# !# &
Syntax
# !#
#

!
#
"
&

Arguments
CH<x> specifies one of the input channels (CH1, CH2, CH3, or CH4; or CH1,
CH2, AUX1, or AUX2 on the TDS 520A, 524A, & 620A).
Examples
TRIGGER:MAIN:VIDEO:SOURCE CH1
selects channel 1 as the source for the main video trigger.
TRIGger:MAIn:VIDeo:STANdard
Sets or queries the video trigger standard. This is equivalent to selecting the
standard in the video Standard pop-up (525/NTSC, 625/PAL, HDTV, or
FlexFmt).
Group
Trigger
Syntax
# !# ' ( ( % (

!#$)
# !#
#

!

"
%
!#$
#
Arguments
specifies the NTSC 525/59.94/2:1 standard.

specifies the PAL 625/59.94/2:1 standard.
2277
% allows selection of the following HDTV formats: 787/59.94/1:1,

1050/59.94/2:1, 1050/59.94/2:1, 1125/60/2:1, 1250/50/2:1.
!#$ allows the user to specify the video parameters. The default table is
1050/59.94/2:1.

selects the NTSC video format.
Examples
TRIGger:MAIn:VIDeo:SYNc
Option 05 Only
Sets or queries the video trigger sync polarity. This is equivalent to selecting
Sync Polarity from the video main menu and a side-menu item (Neg Sync or
Pos Sync).
Group
Trigger
Syntax
# ! & ' $% (

# !
#

!

"

$%

Arguments
specifies a positive going voltage.

$% specifies a negative going voltage.
Examples

selects a positive going voltage for the desired synchronization pulse.
TRIGger:MAIn:VIDeo:SYStem
Sets or queries the video trigger class. This is equivalent to selecting the class in
the Video Class side menu of the Video menu.
2278
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:SYStem { NTSc | PAL | SECAM | CUSTom }

TRIGger:MAIn:VIDeo:SYStem?
TRIGger
MAIn
VIDeo
NTSc
SYStem
PAL
<Space>
SECAM
CUSTom
?
Arguments
NTSc selects a condition that adheres to the National Television System

Committee standards. Specifically, it assumes a line rate of 525 lines per frame
and a frame rate of 30 Hz.
PAL selects a condition that adheres to the Phase Alternate Line standard.
Specifically, it assumes a line rate of 625 lines per frame and a frame rate of
25 Hz.
SECAM selects a condition that adheres to the SECAM standard.
CUSTom selects a condition that adheres to the frequency range of the video
signal as you have defined them from the available ranges.
Examples
TRIGGER:MAIN:SYSTEM NTSC
selects triggering to occur on an NTSC compatible signal.
TRIGger:MAIn:VIDeo:TIMe
Sets or queries the video trigger delay time. This is equivalent to entering the
time in the Delay by Time item of the Video TV Delay Mode side menu.
Group
Trigger
Syntax
TRIGger:MAIn:VIDeo:TIMe <NR3>
TRIGger:MAIn:VIDeo:TIMe?
2279
<Space>
TRIGger
MAIn
VIDeo
<NR3>
TIMe
?
Arguments
Examples
<NR3> specifies a delay time.

TRIGGER:MAIN:VIDEO:TIME 5E6
selects 5 ms for the desired delay time.
TRIGger:STATE? (Query Only)

Returns the current state of the triggering system.
Group
Trigger
Syntax
TRIGger:STATE?
TRIGger
Returns
STATE
ARMed indicates that the instrument is acquiring pretrigger information. All

triggers are ignored when TRIGger:STATE is ARMING.
AUTO indicates that the digitizing oscilloscope is in auto mode and acquires data
even in the absence of a trigger.
FASTframe (TDS 5XXA and 7XXA only) indicates that the instrument is in
FastFrame mode. This means normal trigger status monitoring is turned off. The
digitizing oscilloscope will not return armed, partial, ready, trigger, or auto while
in this state.
INStavu (TDS 7XXA only) indicates that the instrument is in InstaVu mode.
PARTial indicates that the main trigger has occurred and the digitizing oscilloscope is waiting for trigger(s) for the delay by events.
REAdy indicates that all pretrigger information has been acquired and the
digitizing oscilloscope is ready to accept a trigger.
SAVe indicates that the digitizing oscilloscope is in save mode and is not
acquiring data.
TRIGger indicates that the digitizing oscilloscope has seen a trigger and is
acquiring the posttrigger information.
2280
Examples

might return , indicating that pretrigger data is being acquired.
*TRG (No Query Form)

(Trigger) executes commands that are defined by *DDT.
The Group Execute Trigger (GET) interface message has the same effect as the
*TRG command.
Group
Related Commands
Syntax
Miscellaneous
Alias commands, *DDT

Examples

immediately executes all commands that have been defined by *DDT.
*TST? (Query Only)

(Self-Test) Tests the GPIB interface and returns a 0.
Group
Miscellaneous
Syntax

Returns
and is always 0.
2281
UNLock (No Query Form)

Unlocks the front panel. This command is equivalent to LOCk NONe.
NOTE. If the digitizing 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
Related Commands
Syntax
Miscellaneous
LOCk

Arguments

specifies all front-panel buttons and knobs.
VERBose
Sets and queries the Verbose State that controls the length of keywords on query
responses. Keywords can be both headers and arguments. This command does
not affect IEEE Std 488.2-1987 Common Commands (those starting with an
asterisk).
Group
Related Commands
Syntax
Miscellaneous
HEADer, *LRN?, SET?

2282

Arguments
or 0 sets the Verbose State true, which returns full-length keywords
for applicable setting queries.

or = 0 sets the Verbose State false, which returns minimum-length

keywords for applicable setting queries.
Examples

sets the Verbose State true.

might return the value , showing that the Verbose State is true.
*WAI (No Query Form)

(Wait) Prevents the digitizing oscilloscope from executing further commands or
queries until all pending operations finish. This command allows you to
synchronize the operation of the digitizing oscilloscope with your application
program. Synchronization methods are described on page 37.
Group
Related Commands
Syntax
Status and Error

BUSY?, *OPC

WAVFrm? (Query Only)

Returns WFMPre? and CURVe? data for the waveform or waveforms as
specified by the DATa:SOUrce command. This command is equivalent to
sending WFMPre?; CURVe?
Group
Waveform
2283
Related Commands
Syntax
CURVe?, DATa:SOUrce, WFMPre?

.+

.+
WFMPre? (Query Only)

Returns the waveform formatting data for the first ordered waveform as specified
by the DATa:SOUrce command. The channel and math waveforms selected by
the %#0#/-1.$& command must be displayed.
Group
Waveform
Related Commands
WAVFrm?
Syntax
.&
.&
Returns
The format of the response is:

". ". %( 3
4 5
"+0 3 4 5". 3 4 5
2'+ /0.),(" " 3 4 5
)0 0.),($. "'' )0 0.),(*0
' .- 2'+
/0.),(" "3 4 5
)00.),($. "'' )0 0.),(
*0 ' .- !
WFMPre:BIT_Nr
Returns the number of bits per binary waveform point for the first ordered
waveform as specified by the DATa:SOUrce command. The WFMPre:BIT_Nr
command is ignored on input.
Group
2284
Waveform
Related Commands
Syntax
DATa:WIDth, WFMPre:BYT_Nr
WFMPre:BIT_Nr <NR1>
WFMPre:BIT_Nr?
<Space>
WFMPre
<NR1>
BIT_Nr
?
Arguments
<NR1> is either 8 or 16, and is equivalent to WFMPre:BYT_Nr * 8.
Examples
WFMPRE:BIT_NR?
might return 8, indicating that there are 8 bits per waveform point.
WFMPre:BN_Fmt
Sets or queries the format of binary data for the first ordered waveform as
specified by the DATa:SOUrce command.
Group
Related Commands
Syntax
Waveform
DATa:ENCdg, WFMPre:BYT_Or, WFMPre:ENCdg
WFMPre:BN_Fmt { RI | RP }
WFMPre:BN_Fmt?
<Space>
WFMPre
Arguments
BN_Fmt
RI
RP
?
RI specifies signed integer data-point representation.

RP specifies positive integer data-point representation.
Examples
WFMPRE:BN_FMT RP
specifies that the binary waveform data are positive integer data-points.
2285
WFMPRE:BN_FMT?
returns either RI or RP as the current waveform data format.
WFMPre:BYT_Nr
Sets or queries the binary field data width for the first ordered waveform as
specified by the DATa:SOUrce command. This command is equivalent to the
DATa:WIDth command.
Group
Related Commands
Syntax
Waveform
DATa:WIDth, WFMPre:BIT_Nr
WFMPre:BYT_Nr <NR1>
WFMPre:BYT_Nr?
<Space>
WFMPre
<NR1>
BYT_Nr
?
Arguments
<NR1> is the number of bytes per point and can be 1 or 2.
Examples
WFMPRE:BYT_NR 2
specifies that there are 2 bytes per waveform data point.
WFMPre:BYT_Or
Selects which byte of binary waveform data is transmitted first during a
waveform data transfer when DATa:WIDth (or WFMPre:BYT_Nr) is set to 2.
Group
Related Commands
Syntax
Waveform
DATa:ENCdg, WFMPre:BN_Fmt, WFMPre:ENCdg
WFMPre:BYT_Or { LSB | MSB }
WFMPre:BYT_Or?
2286
<Space>
WFMPre
Arguments
BYT_Or
LSB
MSB
?
LSB selects the least significant byte to be transmitted first.

MSB selects the most significant bye to be transmitted first.
Examples
WFMPRE:BYT_OR MSB
specifies that the most significant byte in the waveform data will be transferred
first.
WFMPRE:BYT_OR?
returns either MSB or LSB depending on which data byte is transferred first.
WFMPre:ENCdg
Sets or queries the type of encoding for waveform data transferred with the
CURVe command.
Group
Related Commands
Syntax
Waveform
DATa:ENCdg, WFMPre:BYT_Or, WFMPre:BN_Fmt
WFMPre:ENCdg { ASC | BIN }
WFMPre:ENCdg?
<Space>
WFMPre
Arguments
ENCdg
ASC
BIN
?
ASC specifies ASCII curve data.

BIN specifies binary curve data.
2287
Examples

specifies that the waveform data is in ASCII format.

might return , indicating that the waveform data is in binary format.
WFMPre:PT_Fmt (No Query Form)

Selects the point format of the waveform data for the first ordered waveform as
specified by the DATa:SOUrce command.
Group
Waveform
Syntax

Arguments
!

specifies that the waveform is transmitted as maximum and minimum point

pairs. Only y values are explicitly transmitted. Absolute coordinates are given
by:
X n 0 XINcr (n PT_Off)
Y n max YZEro YMUlt (y n max YOFf)
Y n min YZEro YMUlt (y n min YOFf)
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:
Y n YZEro YMUlt (y n YOFf)
Examples
2288

sets the waveform data point format to enveloped.
WFMPre:PT_Off (No Query Form)

Specifies the trigger point within the waveform record for the reference
waveform specified by the DATa:DESTination command.
Group
Related Commands
Syntax
Waveform
HORizontal:TRIGger:POsition

Arguments
Examples

= 0 to the recordlength, and is the position of the trigger point relative to
DATa:STARt.

specifies that the trigger point is the first point in the waveform record.
WFMPre:XINcr (No Query Form)

Specifies the horizontal sampling interval for the reference waveform specified
by the DATa:DESTination command.
Group
Waveform
Syntax

Arguments

is the sampling interval in seconds per point.
WFMPre:YMUlt (No Query Form)

Specifies the vertical scale factor for the reference waveform specified by the
DATa:DESTination command.
Group
Waveform
2289
Syntax
WFMPre:YMUlt <NR3>
WFMPre
Arguments
YMUlt
<Space>
<NR3>
<NR3> is the vertical scale factor in YUNits (usually volts) per division.
WFMPre:YOFf (No Query Form)

Specifies the offset of the vertical component for the reference waveform
specified by the DATa:DESTination command.
Group
Waveform
Syntax
WFMPre:YOFf <NR3>
WFMPre
Arguments
YOFf
<Space>
<NR3>
<NR3> is the vertical offset in digitizing levels.
WFMPre:YZEro (No Query Form)

Specifies the offset voltage for the reference waveform specified by the
DATa:DESTination command.
Group
Waveform
Syntax
WFMPre:YZEro <NR3>
WFMPre
Arguments
2290
YZEro
<Space>
<NR3>
<NR3> is of the offset in YUNits (usually volts).
Table 229 lists additional WFMPre commands that are included for compatibility purposes.
NOTE. These commands do not support a query form and all information is
ignored.
Table 229: Additional WFMPre Commands
Command
Argument
Description
WFMPre:CRVchk
{CHKsmo|NONe}
Binary curve error check
WFMPre:NR_PT
<NR1>
Number of waveform points
WFMPre:WFId
<QString>
Waveform identifier
WFMPre:XUNit
<QString>
Horizontal units
WFMPre:XMUlt
<NR3>
Horizontal (X-axis) scale factor
WFMPre:XOFf
<NR3>
Horizontal (X-axis) offset
WFMPre:XZEro
<NR3>
Horizontal (X-axis) origin offset
WFMPre:YUNit
<QString>
Vertical units
WFMPre:ZMUlt
<NR3>
Z-axis scale factor
WFMPre:ZOFf
<NR3>
Z-axis offset
WFMPre:ZUNit
<QString>
Z-axis units
WFMPre:ZZEro
<NR3>
Z-axis origin offset
NOTE. When returning WFMPRE:<wfm> information from the oscilloscope,

<wfm> specifies the waveform source (CH<x>, MATH<x>, or REF<x>). The
source must also be set using the DAta:SOUrce command. When sending
WFMPRE:<wfm> information to the scope, the <wfm> specification is ignored
and the reference location specified by DATa:DESTination is used instead.
WFMPre:<wfm>? (Query Only)

Returns the waveform formatting data for first ordered waveform as specified by
the DATa:SOUrce command. Channel and math waveforms must be displayed
before they can be queried. Querying an invalid reference waveform generates an
execution error.
Group
Waveform
2291
WFMPre:<wfm>?
Syntax
WFMPre
Returns
<wfm>
The format of the response is:

<wfm>:WFID <Qstring>;NR_PT <NR1>;PT_FMT { ENV | Y };
XUNit <QString>;XINcr <NR3>;PT_Off <NR1>;YUNit <QString>;YMUlt
<NR3>;YOFf <NR3>;YZEro <NR3>
[;<wfm>:WFID <Qstring>;NR_PT <NR1>;
PT_FMT { ENV | Y };XUNit <QString>;XINcr <NR3>;
PT_Off <NR1>;YUNit <QString>;YMUlt <NR3>;YOFf <NR3>;
YZEro <NR3>...]
WFMPre:<wfm>:NR_Pt
Sets or queries the number of points that are in the transmitted waveform record.
This value is ignored on input.
Related Commands
DATa:DESTination
Group
Waveform
Syntax
WFMPre:<wfm>:NR_Pt <NR1>
WFMPre:<wfm>:NR_Pt?
<Space>
WFMPre
<wfm>
<NR1>
NR_Pt
?
Arguments
<NR1> is the number of data points. If DATa:WIDth is 2 then there are twice as
many bytes.
<NR1> = 0 means that the waveform record is of an unspecified length.
Examples
2292
WFMPRE:CH1:NR_Pt?
might return 5000 as the number of data points in the waveform record transferred from channel 1.
WFMPre:<wfm>:PT_Fmt
Selects the data point format for the first ordered waveform as selected by the
DATa:SOUrce command. On input <wfm> always defaults to the reference
location specified by DATa:DESTination regardless of what is sent.
Group
Related Commands
Syntax
Waveform
DATa:DESTination
WFMPre:<wfm>:PT_Fmt { ENV | Y }
WFMPre:<wfm>:PT_Fmt?
<Space>
WFMPre
Arguments
<wfm>
PT_Fmt
ENV
Y
?
ENV specifies that the waveform is transmitted as minimum and maximum point
pairs. Only y values are explicitly transmitted. Absolute coordinates are given
by:
Y n min YZEro YMUlt (y n min YOFf)
Y n max YZEro YMUlt (y n max YOFf)
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:
Y n YZEro YMUlt (y n YOFf)
Examples
WFMPRE:MATH1:PT_FMT?
might return ENV, indicating that the MATH1 waveform data format is enveloped.
2293
WFMPre:<wfm>:PT_Off
Returns the trigger point within the waveform record. On input <wfm> always
defaults to the reference location specified by DATa:DESTination regardless of
what is sent.
Group
Waveform
Syntax
WFMPre:<wfm>:PT_Off <NR1>
WFMPre:<wfm>:PT_Off?
<Space>
WFMPre
<wfm>
<NR1>
PT_Off
?
<NR1> = 0 to the recordlength, and is the position of the trigger point relative to
DATa:STARt when queried.
Arguments
WFMPRE:CH1:PT_OFF?
returns 0 indicating the trigger position within the waveform record.
Examples
WFMPre:<wfm>:WFId
Returns information about the waveform such as input coupling, volts per
division, time per division, acquisition mode, and record length.
The WFMPre:<wfm>:WFId command is ignored on input.
Group
Waveform
Syntax
WFMPre:<wfm>:WFId <QString>
WFMPre:<wfm>:WFId?
<Space>
WFMPre
<wfm>
<QString>
WFId
?
Arguments
2294
<QString> is the waveform identifier string.
WFMPre:<wfm>:XINcr
Sets or queries the horizontal sampling interval. On input <wfm> always
what is sent.
Group
Waveform
Syntax
!$ !

!$ !

!
$

!

is the sampling interval.
Arguments
WFMPre:<wfm>:XUNit
Returns the horizontal (X-axis) units of the waveform data at the time of
creation.
The WFMPre:<wfm>:XUNit command is ignored on input.
Group
Waveform
Syntax
!$# #!
!$#

!
$
#!
#

Arguments
Examples
#! is s for seconds and specifies the units.

might return ", indicating that the horizontal units for channel 1 are seconds.
2295
WFMPre:<wfm>:YMUlt
Sets or queries the vertical scale factor, in YUNit per unscaled data point value.
On input <wfm> always defaults to the reference location specified by
DATa:DESTination regardless of what is sent.
Group
Waveform
Syntax

is the scale factor, in YUNits (usually volts), per digitizing level.
Arguments
WFMPre:<wfm>:YOFf
Sets or queries the vertical position of the waveform. On input <wfm> always
what is sent.
Group
Waveform
Syntax

Arguments
2296
is the position in digitizing levels.
WFMPre:<wfm>:YUNit
Returns the vertical (Y-axis) units of the waveform data at the time of creation.
The WFMPre:<wfm>:YUNit command is ignored on input.
Group
Waveform
Syntax
$& % %$!

$& %
#
$
&
%$!
%

%$! is for volts or for volts2, and specifies the units.
Arguments

might return , meaning that the units for the vertical component of the
channel 2 waveform data are volts.
Examples
WFMPre:<wfm>:YZEro
Sets or queries the vertical (Y-axis) offset voltage. On input <wfm> always
what is sent.
Group
Waveform
Syntax
$&
$"
$&
$"
#
$
&

$"

Arguments
is the offset in YUNits (usually volts).
2297
ZOOm
Resets the zoom transforms to default values for all traces or live traces. The
ZOOm query returns the current vertical and horizontal positioning and scaling
of the display. This command is equivalent to selecting Reset All Factors or
Reset Live Factors in the TDS 7XXA Zoom Reset menu or selecting Reset
Zoom Factors in the Zoom menu of other TDS oscilloscopes.
Group
Zoom
Syntax
ZOOm { RESET | RESETLive (TDS 7XXA only) }

ZOOm?
RESET
<Space>
RESETLive
ZOOm
Arguments
RESET resets the zoom transforms to default values for all traces.
RESETLive (TDS 7XXA only) resets the zoom transforms to default values for
live traces.
Examples
ZOOM?
might return :ZOOM:STATE OFF;HORIZONTAL:SCALE 2.00E+0;POSITION
500.0E-3;LOCK LIVE;:ZOOM:VERTICAL:SCALE 2.0E+0;POSITION 0.0E+0.
ZOOm:DUAl
TDS 7XXA Only
Turns Dual Zoom mode on and off.
Group
Zoom
Syntax
ZOOm:DUAl { OFF | ON | <NR1> }

ZOOm:DUAl?
2298
OFF
ON
<Space>
<NR1>
ZOOm
Arguments
DUAl
OFF or <NR1> = 0 turns Dual Zoom mode off.

ON or <NR1> 0 turns Dual Zoom mode on.
Examples
ZOOM:DUAL ON
enables the Dual Zoom feature.
ZOOM:DUAL?
returns either 0 or 1 depending on the state of Dual Zoom mode.
ZOOm:DUAl:OFFSet
TDS 7XXA Only
Adjusts the requested horizontal offset between the centers of the main and
second zoom boxes.
Group
Zoom
Syntax
ZOOm:DUAl:OFFSet <NR3>
ZOOm:DUAl:OFFSet?
<Space>
ZOOm
DUAl
<NR3>
OFFSet
?
Arguments
Examples
<NR3> is the offset time in seconds.

ZOOM:DUAL:OFFSET 100.0E-6
adjusts the offset time in seconds between the centers of the main and second
zoom boxes.
2299
ZOOm:GRAticule
TDS 7XXA Only
Selects between the upper and lower graticule for use by the zoom preview state.
If you select the lower graticule, horizontal and vertical knob changes will affect
the underlying acquisition system. If you select the upper graticule, horizontal
and vertical knob changes will affect the zoom factors.
Group
Zoom
Syntax
ZOOm:GRAticule { LOWEr | UPPer }

ZOOm:GRAticule?
<Space>
ZOOm
Arguments
GRAticule
LOWEr
UPPer
?
LOWEr selects the lower graticule.

UPPer selects the upper graticule.
Examples
ZOOM:GRATICULE?
might return UPPER, indicating that the upper graticule is selected.
ZOOm:HORizontal:LOCk
Specifies the waveforms that the horizontal zoom parameters affect. This is
equivalent to setting Horizontal Lock in the Zoom side menu.
Group
Zoom
Syntax
ZOOm:HORizontal:LOCk { ALL | LIVe | NONe }

ZOOm:HORizontal:LOCk?
2300
ALL
<Space>
ZOOm
HORizontal
Arguments
LOCk
LIVe
NONe
?
LIVe specifies that all live (CH<x>) waveforms will be horizontally positioned
and scaled together.
NONe specifies that only the selected waveform is positioned and scaled using the
horizontal zoom parameters.
ALL specifies that all (CH<x>, Ref<x>, Math<x>) waveforms will be horizontally positioned and scaled together.
Examples
ZOOM:HORIZONTAL:LOCK LIVE
specifies that all live waveforms are positioned and scaled together.
ZOOM:HORIZONTAL:LOCK?
returns either ALL, LIVE, or NONE.
ZOOm:HORizontal:POSition
Sets or queries the horizontal position of zoomed waveforms. The setting of the
ZOOm:HORizontal:LOCk command determine the waveforms affected. For
example, if ZOOm:HORizontal:LOCk is set to LIVe then only live (as opposed
to reference and math) waveforms are affected.
Group
Zoom
Syntax
ZOOm:HORizontal:POSition <NR3>
ZOOm:HORizontal:POSition?
<Space>
ZOOm
HORizontal
<NR3>
POSition
?
Arguments
<NR3> is from 0 to 100, and is the percent of the waveform that is to the left of
screen center when the zoom factor is 1x or greater.
2301
It is the percent of the graticule to the right of the waveform center when the
zoom factor is less than 1. It can be less than 1 when using Fit to Screen.
ZOOM:HORIZONTAL:POSITION 50
centers the waveform on the display.
Examples
ZOOm:HORizontal:SCAle
Sets or queries the horizontal expansion factor. This command is equivalent to
using the front-panel Horizontal Scale knob when Zoom is on. It is also
equivalent to using Zoom Preview with the upper graticule selected in the
TDS 7XXA.
Group
Zoom
Syntax
ZOOm:HORizontal:SCAle <NR3>
ZOOm:HORizontal:SCAle?
<Space>
ZOOm
HORizontal
<NR3>
SCAle
?
Arguments
<NR3> is the amount of expansion in the horizontal direction.

It is less than 1 if there is horizontal compression.
It is more than 1 if there is horizontal expansion.
Examples
ZOOM:HORIZONTAL:SCALE?
might return 1.00E+0 as the horizontal scale factor.
ZOOm:STATE
Turns Zoom mode on and off. When Zoom mode is on, the horizontal and
vertical position and scale commands affect the waveform display, not the
acquisition. This is the only way to position and scale math and reference
waveforms. This command is equivalent to turning Zoom on and off in the
Zoom side menu.
2302
Group
Zoom
Syntax
ZOOm:STATE { <NR1> | OFF | ON | PREView (TDS 7XXA) }

ZOOm:STATE?
<NR1>
OFF
<Space>
ON
PREView
ZOOm
Arguments
STATE
OFF or <NR1> = 0 turns Zoom mode off.

ON or <NR1> 0 turns Zoom mode on. When InstaVu is in use, the state value
becomes a requested value, to be restored when InstaVu is switched off. Do not
use this condition if InstaVu is on. InstaVu overrides the zoom on state.
PREView (TDS 7XXA) sets ZOOM:STATE to preview. Also, it causes the
oscilloscope to display both the ZOOM:STATE OFF and ZOOM:STATE ON
traces simultaneously in dual, half-height graticules. Do not use this condition if
InstaVu is on. InstaVu overrides the zoom preview state.
Examples
ZOOM:STATE ON
enables the Zoom feature.
ZOOM:STATE?
returns either 0 or 1 (OFF, PREVIEW, or ON for the TDS 7XXA) depending on
the state of Zoom mode.
ZOOm:VERTical:POSition
Sets or queries the vertical position of waveforms.
Group
Zoom
Syntax
ZOOm:VERTical:POSition <NR3>
ZOOm:VERTical:POSition?
2303
<Space>
ZOOm
VERTical
<NR3>
POSition
?
<NR3> is the vertical position in divisions.
Arguments
Examples
ZOOM:VERTICAL:POSITION?
might return :ZOOM:VERTICAL:POSITION 0.0E+0
ZOOm:VERTical:SCAle
Sets or queries the vertical expansion and compression factor.
Group
Related Commands
Syntax
Zoom
ACQuire:MODe
ZOOm:VERTical:SCAle <NR3>
ZOOm:VERTical:SCAle?
<Space>
ZOOm
VERTical
<NR3>
SCAle
?
Arguments
Examples
2304
<NR3> is the amount of vertical expansion or compression.

ZOOM:VERTICAL:SCALE?
might return :ZOOM:VERTICAL:SCALE 2.0E+0
Status and Events

The digitizing oscilloscope provides a status and event reporting system for the
GPIB interface. This system informs you of certain significant events that occur
within the digitizing oscilloscope.
The digitizing 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.
Registers
The registers in the event handling system fall into two functional groups:
Status Registers
Status Registers contain information about the status of the digitizing

oscilloscope. They include the Standard Event Status Register (SESR) and
the Status Byte Register (SBR).
Enable Registers determine whether selected types of events are reported to

the Status Registers and the Event Queue. They include the Device Event
Status Enable Register (DESER), the Event Status Enable Register (ESER),
and the Service Request Enable Register (SRER).
The Standard Event Status Register (SESR) and the Status Byte Register (SBR)
record certain types of events that may occur while the digitizing oscilloscope is
in use. IEEE Std 488.21987 defines these registers.
Each bit in a Status Register records a particular type of event, such as an
execution error or service request. When an event of a given type occurs, the
digitizing oscilloscope sets the bit that represents that type of event to a value of
one. (You can disable bits so that they ignore events and remain at zero. See the
Enable Registers section on page 33.) Reading the status registers tells you
what types of events have occurred.
The Standard Event Status Register (SESR). The SESR, shown in Figure 31,
records eight types of events that can occur within the digitizing oscilloscope.
Use the *ESR? query to read the SESR register. Reading the register clears the
bits of the register so that the register can accumulate information about new
events.
31
Status and Events
7
6
5
4
3
2
1
0
PON URQ CME EXE DDE QYE RQC OPC
Figure 31: The Standard Event Status Register (SESR)
Table 31: SESR Bit Functions

Bit
Function
7 (MSB)
PON (Power On). Shows that the digitizing oscilloscope was powered on. The
completion of the diagnostic tests also sets this bit.
URQ (User Request). Shows that an Application menu button was pressed.
CME (Command Error). Shows that an error occurred while the digitizing
oscilloscope was parsing a command or query. Command error messages are
listed in Table 34 on page 312.
EXE (Execution Error). Shows that an error occurred while the digitizing
oscilloscope was executing a command or query. Execution error messages are
listed in Table 35 on page 314.
DDE (Device Error). Shows that a device error occurred. Device error
messages are listed in Table 36 on page 317.
QYE (Query Error). Shows that either an attempt was made to read the Output
Queue when no data was present or pending, or that data in the Output Queue
was lost.
RQC (Request Control). Not used.
0 (LSB)
OPC (Operation Complete). Shows that the operation is complete. This bit is
set when all pending operations complete following an command.
The Status Byte Register (SBR) shown in Figure 32, records whether output
is available in the Output Queue, whether the digitizing oscilloscope requests
service, and whether the SESR has recorded any events.
Use a Serial Poll or the *STB? query to read the contents of the SBR. The bits in
the SBR are set and cleared depending on the contents of the SESR, the Event
Status Enable Register (ESER), and the Output Queue. When you use a Serial
Poll to obtain the SBR, bit 6 is the RQS bit. When you use the *STB? query to
obtain the SBR, bit 6 is the MSS bit. Reading the SBR does not clear the bits.
6
RQS 5
4
3
ESB MAV
6
MSS
Figure 32: The Status Byte Register (SBR)
32
Status and Events
Table 32: SBR Bit Functions
Enable Registers
Bit
Function
7 (MSB)
Not used.
RQS (Request Service), obtained from a serial poll. Shows that the digitizing
oscilloscope requests service from the GPIB controller.
MSS (Master Status Summary), obtained from *STB? query. Summarizes the
ESB and MAV bits in the SBR.
ESB (Event Status Bit). Shows that status is enabled and present in the SESR.
MAV (Message Available). Shows that output is available in the Output Queue.
30
Not used.
DESER, ESER, and SRER allow you to select which events are reported to the
Status Registers and the Event Queue. Each Enable Register acts as a filter to a
Status Register (the DESER also acts as a filter to the Event Queue) and can
prevent information from being recorded in the register or queue.
Each bit in an Enable Register corresponds to a bit in the Status Register it
controls. In order for an event to be reported to its bit in the Status Register, the
corresponding bit in the Enable Register must be set to one. If the bit in the
Enable Register is set to zero, the event is not recorded.
Various commands set the bits in the Enable Registers. The Enable Registers and
the commands used to set them are described below.
The Device Event Status Enable Register (DESER) is shown in Figure 33. This
register controls which types of events are reported to the SESR and the Event
Queue. The bits in the DESER correspond to those in the SESR, as described
earlier.
Use the DESE command to enable and disable the bits in the DESER. Use the
DESE? query to read the DESER.
7
6
5
4
3
2
1
0
Figure 33: The Device Event Status Enable Register (DESER)

The Event Status Enable Register (ESER) is shown in Figure 34. It controls
which types of events are summarized by the Event Status Bit (ESB) in the SBR.
Use the *ESE command to set the bits in the ESER. Use the *ESE? query to
read it.
33
Status and Events
7
6
5
4
3
2
1
0
Figure 34: The Event Status Enable Register (ESER)

The Service Request Enable Register (SRER) is shown in Figure 35. It
controls which bits in the SBR generate a Service Request 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. The
RQS bit remains set to one until either the Status Byte Register is read with a
Serial Poll or the MSS bit changes back to a zero.
7
5
4
3
ESB MAV
Figure 35: The Service Request Enable Register (SRER)
The Enable Registers and

the *PSC Command
The *PSC command controls the Enable Registers contents at power-on.

Sending *PSC 1 sets the Enable Registers at power on as follows:
H
DESER 255 (equivalent to a DESe 255 command)
ESER 0 (equivalent to an *ESE 0 command)
SRER 0 (equivalent to an *SRE 0 command)
Sending *PSC 0 lets the Enable Registers maintain their values in non-volatile
memory through a power cycle.
NOTE. To enable the PON (Power On) event to generate a Service Request, send
*PSC 0, use the DESe and *ESE commands to enable PON in the DESER and
ESER, and use the *SRE command to enable bit 5 in the SRER. Subsequent
power-on cycles will generate a Service Request.
34
Status and Events
Queues
The digitizing oscilloscope status and event reporting system contains two
queues: the Output Queue and the Event Queue.
The Output Queue
The digitizing oscilloscope stores query responses in the Output Queue. It

empties this queue each time it receives a new command or query message after
an <EOM>. The controller must read a query response before it sends the next
command (or query) or it will lose responses to earlier queries.
WARNING. When a controller sends a query, an <EOM>, and a second query,
the digitizing scope normally clears the first response and outputs the second
while reporting a Query Error (QYE bit in the ESER) to indicate the lost
response. A fast controller, however, may receive a part or all of the first
response as well. To avoid this situation, the controller should always read the
response immediately after sending any terminated query message or send a
DCL (Device Clear) before sending the second query.
The Event Queue
The Event Queue stores detailed information on up to 20 events. If more than 20

events stack up in the Event Queue, the 20th event is replaced by event code
350, Too many events.
Read the Event Queue with the EVENT? query (which returns only the event
number), with the EVMSG? query (which returns the event number and a text
description of the event), or with the ALLEV? query (which returns all the event
numbers along with a description of the event). Reading an event removes it
from the queue.
Before reading an event from the Event Queue, you must use the *ESR? query to
read the summary of the event from the SESR. This makes the events summarized by the *ESR? read available to the EVENT? and EVMSG? queries, and
empties the SESR.
Reading the SESR erases any events that were summarized by previous *ESR?
reads but not read from the Event Queue. Events that follow an *ESR? read are
put in the Event Queue but are not available until *ESR? is used again.
35
Status and Events
Event Handling Sequence

Figure 36, on page 36, shows how to use the status and event handling
system. In the explanation that follows, numbers in parentheses refer to numbers
in Figure 36.
Device Event Status Enable Register

(DESER)
Read using DESE?
Write using DESE
7
6
5
4
3
2
1
0
2
Standard Event Status Register

(SESR)
Read using *ESR?
Cannot be written
7
6
5
4
3
2
1
0
3
Event Status Enable Register

(ESER)
Read using *ESE?
Write using *ESE
7
6
5
4
3
2
1
0
Status Byte Register

(SBR)
Read using *STB?

Cannot be written
6
RQS 5
4
3
ESB MAV
6
MSS
Event
Queue
Byte
Byte
Byte
Output
Queue
Service Request Enable Register

(SRER)
Read using *SRE?
Write using *SRE
Event
Event
Event
5
4
3
ESB MAV
Figure 36: Status and Event Handling Process

When an event occurs, a signal is sent to the DESER (1). If that type of event is
enabled in the DESER (that is, if the bit for that event type is set to 1), the
appropriate bit in the SESR is set to one, and the event is recorded in the Event
Queue (2). If the corresponding bit in the ESER is also enabled (3), then the ESB
bit in the SBR is set to one (4).
36
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 is
generated (7).
Synchronization Methods
Although most GPIB commands are completed almost immediately after being
received by the digitizing oscilloscope, some commands start a process that
requires more time. For example, once a HARDCOPY START command is
executed it may be a few seconds before the hardcopy operation is complete.
Rather than remain idle while the operation is in process, the digitizing
oscilloscope will continue processing other commands. This means that some
operations will not be completed in the order that they were sent.
Sometimes the result of an operation depends on the result of an earlier
operation. A first operation must complete before the next one gets processed.
The digitizing oscilloscope status and event reporting system provide ways to do
this.
For example, a typical application might involve acquiring a single-sequence
waveform and then taking a measurement on the acquired waveform. You could
use the following command sequence to do this:
/** Set up single-sequence acquisition **/

/** Acquire waveform data **/

/** Set up the measurement parameters **/

/** Take amplitude measurement on acquired data **/

The acquisition of the waveform requires extended processing time. It may not
finish before the digitizing oscilloscope takes an amplitude measurement (See
Figure 37). This can result in an incorrect amplitude value.
37
Status and Events

Acquiring Waveform Data

Processing Time
Figure 37: Command Processing Without Using Synchronization

To ensure the digitizing oscilloscope completes waveform acquisition before
taking the measurement on the acquired data, you can synchronize the program.
Figure 38 shows the desired processing sequence.

Acquiring Waveform Data

Processing Time
Figure 38: Processing Sequence With Synchronization

You can use four commands to synchronize the operation of the digitizing
oscilloscope with your application program: *WAI, BUSY?, *OPC, and *OPC?.
Using the *WAI Command
You can force commands to execute sequentially by using the *WAI command.
This command forces completion of the previous commands before processing
new ones.
The same command sequence using the *WAI command for synchronization
looks like this:
/* Set up single-sequence acquisition */

/* Acquire waveform data */

/* Set up the measurement parameters */

/* Wait until the acquisition is complete before taking the measurement */

38
Status and Events
/* Take amplitude measurement on acquired data */

Though *WAI is one of the easiest ways to achieve synchronization, it is also the
most costly. The processing time of the digitizing oscilloscope is slowed since it
is processing a single command at a time. This time could be spent doing other
tasks.
The controller can continue to write commands to the input buffer of the
digitizing oscilloscope, but the commands will not be processed by the digitizing
oscilloscope until all operations in process are complete. If the input buffer
becomes full, the controller will be unable to write more commands to the buffer.
This can cause a time-out.
Using the BUSY Query
The BUSY? query allows you to find out whether the digitizing oscilloscope is
busy processing a command that has an extended processing time such as
single-sequence acquisition.
The same command sequence using the BUSY? query for synchronization looks
like this:



!# "& #%%&!$

This sequence lets you create your own wait loop rather than using the *WAI
command. The BUSY? query helps you avoid time-outs caused by writing too
many commands to the input buffer. The controller is still tied up, though, and
the repeated BUSY? query will result in more bus traffic.
Using the *OPC Command
If the corresponding status registers are enabled, the *OPC command sets the
OPC bit in the Standard Event Status Register (SESR) when an operation is
complete. You achieve synchronization by using this command with either a
serial poll or service request handler.
39
Status and Events
Serial Poll Method. Enable the OPC bit in the Device Event Status Enable
Register (DESER) and the Event Status Enable Register (ESER) using the DESE
and *ESE commands. When the operation is complete, the OPC bit in the
Standard Event Status Register (SESR) will be enabled and the Event Status Bit
(ESB) in the Status Byte Register will be enabled.
The same command sequence using the *OPC command for synchronization
with serial polling looks like this:
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STOPAFTER SEQUENCE
/* Enable the status registers */
DESE 1
*ESE 1
*SRE 0
ACQUIRE:STATE ON
MEASUREMENT:IMMED:TYPE AMPLITUDE
MEASUREMENT:IMMED:SOURCE CH1
/* Wait until the acquisition is complete before taking the measurement. */
*OPC
While serial poll = 0, keep looping
MEASUREMENT:IMMED:VALUE?
This technique requires less bus traffic than did looping on BUSY?.
Service Request Method. Enable the OPC bit in the Device Event Status Enable
Register (DESER) and the Event Status Enable Register (ESER) using the DESE
and *ESE commands. You can also enable service requests by setting the ESB
bit in the Service Request Enable Register (SRER) using the *SRE command.
When the operation is complete, a Service Request will be generated.
The same command sequence using the *OPC command for synchronization
looks like this:
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
/* Enable the status registers */
DESE 1
310
Status and Events
*ESE 1
*SRE 32
ACQUIRE:STATE ON
*OPC
Program can now do different tasks such as talk to other
devices. The SRQ, when it comes, interrupts those tasks and
returns control to this task.
This technique is more efficient but requires more sophisticated programming.
Using the *OPC? Query
The *OPC? query places a 1 in the Output Queue once an operation is complete.
A timeout could occur if you try to read the output queue before there is any data
in it.
The same command sequence using the *OPC? query for synchronization looks
like this:
SELECT:CH1 ON
ACQUIRE:MODE SAMPLE
ACQUIRE:STATE ON
*OPC?
Wait for read from Output Queue.
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.
311
Status and Events
Messages
Tables 33 through 39 list all the programming interface messages the
digitizing oscilloscope generates in response to commands and queries.
For most messages, a secondary message from the digitizing oscilloscope gives
more detail about the cause of the error or the meaning of the message. This
message is part of the message string, and is separated from the main message by
a semicolon.
Each message is the result of an event. Each type of event sets a specific bit in
the SESR and is controlled by the equivalent bit in the DESER. Thus, each
message is associated with a specific SESR bit. In the message tables that follow,
the associated SESR bit is specified in the table title, with exceptions noted with
the error message text.
Table 33 shows the messages when the system has no events or status to report.
These have no associated SESR bit.
Table 33: No Event Messages
Code
Message
No events to report queue empty
No events to report new events pending *ESR?
Table 34 shows the error messages generated by improper command syntax.

Check that the command is properly formed and that it follows the rules in
Command Syntax starting on page 21.
Table 34: Command Error Messages CME Bit 5
312
Code
Message
100
Command error
101
Invalid character
102
Syntax error
103
Invalid separator
104
Data type error
105
GET not allowed
106
Invalid program data separator
108
Parameter not allowed
109
Missing parameter
110
Command header error
Status and Events
Table 34: Command Error Messages CME Bit 5 (Cont.)

Code
Message
111
Header separator error
112
Program mnemonic too long
113
Undefined header
118
Query not allowed
120
Numeric data error
121
Invalid character in number
123
Exponent too large
124
Too many digits
128
Numeric data not allowed
130
Suffix error
131
Invalid suffix
134
Suffix too long
138
Suffix not allowed
140
Character data error
141
Invalid character data
144
Character data too long
148
Character data not allowed
150
String data error
151
Invalid string data
152
String data too long
158
String data not allowed
160
Block data error
161
Invalid block data
168
Block data not allowed
170
Expression error
171
Invalid expression
178
Expression data not allowed
180
Alias error
181
Invalid outside alias definition
183
Invalid inside alias definition
184
Command in alias requires more/fewer parameters
313
Status and Events
Table 35 lists the execution errors that are detected during execution of a
command. In these error messages, you should read macro as alias.
Table 35: Execution Error Messages EXE Bit 4
314
Code
Message
200
Execution error
201
Invalid while in local
202
Settings lost due to rtl
210
Trigger error
211
Trigger ignored
212
Arm ignored
220
Parameter error
221
Settings conflict
222
Data out of range
223
Too much data
224
Illegal parameter value
230
Data corrupt or stale
240
Hardware error
241
Hardware missing
242
Hardware configuration error
243
Hardware I/O device error
250
Mass storage error
251
Missing mass storage
252
Missing media
253
Corrupt media
254
Media full
255
Directory full
256
File name not found
257
File name error
258
Media protected
260
Expression error
261
Math error in expression
2200
Measurement error, Measurement system error
2201
Measurement error, Zero period
2202
Measurement error, No period found
Status and Events
Table 35: Execution Error Messages EXE Bit 4 (Cont.)

Code
Message
2203
Measurement error, No period, second waveform
2204
Measurement error, Low signal amplitude
2205
Measurement error, Low amplitude, second waveform
2206
Measurement error, Invalid gate
2207
Measurement error, Measurement overflow
2208
Measurement error, Waveform does not cross Mid Ref
2209
Measurement error, No second Mid Ref crossing
2210
Measurement error, No Mid Ref crossing, second waveform
2211
Measurement error, No backwards Mid Ref crossing
2212
Measurement error, No negative crossing
2213
Measurement error, No positive crossing
2214
Measurement error, No crossing
2215
Measurement error, No crossing, second waveform
2216
Measurement error, No crossing, target waveform
2217
Measurement error, Constant waveform
2218
Measurement error, Unused
2219
Measurement error, No valid edge No arm sample
2220
Measurement error, No valid edge No arm cross
2221
Measurement error, No valid edge No trigger cross
2222
Measurement error, No valid edge No second cross
2223
Measurement error, Waveform mismatch
2224
Measurement error, WAIT calculating
2225
Measurement error, No waveform to measure
2226
Null Waveform
2227
Positive and Negative Clipping
2228
Measurement error, Positive Clipping
2229
Measurement error, Negative Clipping
2230
Measurement error, High Ref < Low Ref
2235
Math error, Invalid math description
2236
Math error, Reference waveform is invalid
2237
Math error, Out of acquisition memory
2240
Invalid password
2241
Waveform requested is invalid
315
Status and Events
Table 35: Execution Error Messages EXE Bit 4 (Cont.)
316
Code
Message
2242
Data start and stop > record length
2243
Waveform requested is not a data source
2244
Waveform requested is not turned on
2245
Saveref error, Selected channel is turned off
2246
Saveref error, Selected channel data invalid
2247
Saveref error, Out of reference memory
2248
Saveref error, Source reference data invalid
2249
Reference deletion error, Waveform in use for math
2260
Calibration error
2270
Alias error
2271
Alias syntax error
2272
Alias execution error
2273
Illegal alias label
2274
Alias parameter error
2275
Alias definition too long
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
2290
Limit error, Reference in use
2291
Limit error, Reference data invalid
2292
Limit error, Out of reference memory
2293
Limit error, Selected channel is turned off
2301
Cursor error, Off-screen
2302
Cursor error, cursors in different frames
2311
Group requested has not been selected or has been deleted
Status and Events
Table 36 lists the device errors that can occur during digitizing oscilloscope
operation. These errors may indicate that the oscilloscope needs repair.
Table 36: Device Error Messages DDE Bit 3
Code
Message
300
Device-specific error
310
System error
311
Memory error
312
PUD memory lost
313
Calibration memory lost
314
Save/recall memory lost
315
Configuration memory lost
350
Queue overflow (does not set DDE bit)
Table 37 lists the system event messages. These messages are generated
whenever certain system conditions occur.
Table 37: System Event Messages
Code
Message
400
Query event
401
Power on (PON bit 7 set)
402
Operation complete (OPC bit 0 set)
403
User request (URQ bit 6 set)
404
Power fail (DDE bit 3 set)
405
Request control
410
Query INTERRUPTED (QYE bit 2 set)
420
Query UNTERMINATED (QYE bit 2 set)
430
Query DEADLOCKED (QYE bit 2 set)
440
Query UNTERMINATED after indefinite response (QYE bit 2 set)
450
Right menu button #1 pushed (URQ bit 6 set)
451
452
453
454
460
Bottom menu button #1 pushed (URQ bit 6 set)
317
Status and Events
Table 37: System Event Messages (Cont.)

Code
Message
461
462
463
464
465
466
Table 38 lists warning messages that do not interrupt the flow of command
execution. These notify you that you may get unexpected results.
Table 38: Execution Warning Messages EXE Bit 4
318
Code
Message
500
Execution warning
510
String data too long, truncated
525
Parameter underrange
526
Parameter overrange
527
Parameter rounded
528
Parameter out of range
530
Data stop > stop, Values swapped internally
531
Data stop > record length, Curve truncated
532
Curve data too long, Curve truncated
540
Measurement warning
541
Measurement warning, Low signal amplitude
542
Measurement warning, Unstable histogram
543
Measurement warning, Low resolution
544
Measurement warning, Uncertain edge
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
Status and Events
Table 38: Execution Warning Messages EXE Bit 4 (Cont.)

Code
Message
550
InstaVu active deactivate to see change
551
InstaVu active deactivate to use math
Table 39 shows internal errors that indicate an internal fault in the digitizing
oscilloscope.
Table 39: Internal Warning Messages
Code
Message
600
Internal warning
620
Internal warning, Bad thermistor
630
Internal warning, 50 W overload
319
Status and Events
320
The example programs illustrate methods you can use to control the digitizing
oscilloscope from the GPIB interface. The diskettes that come with this manual
contain listings for these programs written in Microsoft QuickBASIC 4.5 and
Microsoft QuickC 2.5.
The programs run on a PC-compatible system equipped with a Tektronix
(National Instruments) GPIB board and associated drivers. For example, the
programs will work with a Tektronix S3FG210 (National Instruments GPIBPCII/IIA) GPIB package (See Figure 41).
GPIB Board
(Tektronix S3FG210 or National

Instruments PCII/IIA)
and
or
PC Compatible
Figure 41: Equipment Needed to Run the Example Programs

All the example programs assume that the GPIB system recognizes the digitizing
oscilloscope as DEV1 and the PC (controller) as GPIB0. You can use the

program to assign these names.
The example software includes:
H
: automatically measures waveform parameters.

: shows communication between controller and oscilloscope.
41
Program Examples
GETWFM: reads a waveform from an oscilloscope and stores it in a file.
CURSOR: uses cursors to measure waveform parameters.
TL: a talker-listener program.
Compiling the Example Programs

The example programs diskette contains programs written in Microsoft
QuickBASIC 4.5 and Microsoft QuickC 2.5.
Executable versions of the programs are in the PROGRAMS directory. Source
versions are in the SOURCES directory. Within this directory, the QuickBASIC
programs are in the Q-BASIC subdirectory and the QuickC programs are in the
QUICK-C subdirectory.
A README file in each directory explains how to build executable code from the
source files provided.
The QuickC directory also comes with sample MAKE files and sample
executable files. These have the suffix .MAK.
If you wish to develop code, you will need to use files that come with the
GPIB system. Specifically, the QuickBASIC programs use QBDECL.BAS
and QBIB.OBJ. The QuickC programs use DECL.H and MCIB.OBJ.
NOTE. The programs you compile in the Sources directory work with the
Tektronix S3FG210 (National Instruments GPIB-PCII-IIA) GPIB system. It may
take extra steps or changes to get them to work with older Tektronix GURU and
other GPIB systems.
Compiling and Linking

Your Example Quick-C
Programs
To make an executable for any example, perform the following:

1. Install QuickC. Select the SMALL memory model. Be sure to set up your
path so DOS can access the QuickC directory.
2. Install the Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB
board and drivers. Remember to identify the GPIB device as DEV1. You can
use the IBCONF.EXE program to do this.
3. Copy the files from the examples diskette to your hard disk. You might also
create a special directory to store them. For example, if the current drive is
hard disk C, you want to store the examples in drive C, and the examples
diskette is in drive B, you might type:
mkdir examples
42
Program Examples
1'*&)*2 +/#%
4. For this installation, you will also want to copy
and
from
your Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB
drivers directory to this directory. For example, if the GPIB drivers are in the
!*#3* directory and you are in the example programs directory, you
would type:
)*2 !*#*&"
)*2 !*#*'#)$
5. To compile and link your TDS sample C programs, simply type: ('%
#& (''%
where <file name> refers to the name of the example program you wish to
compile and link. Specifically:
To compile and link
, type: ('% '-'%
To compile and link

, type: ('% )'''%
To compile and link
, type: ('% !.0 ''%
To compile and link

, type: ('% /,-),'%
To compile and link
, type: ('% .&'%
6. Run the program by simply typing the program name.
To run '-, type: 'To run )'', type: )''
To run !.0 ', type: !.0 '
To run /,-),, type: /,-),
To run .&, type: .&
Compiling and Linking

Your Example
QuickBASIC Programs
To make an executable for any of the following files, perform the following:
1. Install QuickBASIC.
2. Install the Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB
board and drivers. Remember to reboot your PC to initialize the GPIB
drivers.
3. Copy the files from the examples diskette to your hard disk. You might also
create a special directory to store them. For example, if the current drive is
43
Program Examples
hard disk C, you want to store the examples in drive C, and the examples
diskette is in drive B, you might type:
mkdir examples
cd examples
copy b:\q-basic\*.* .
4. For this installation, you will also want to copy QBDECL.BAS and QBIB.OBJ
from your Tektronix S3FG210 (National Instruments GPIB-PCII/IIA) GPIB
drivers directory to the directory your example programs are in. For
example, if the GPIB drivers are in the gpib-pc directory and you are in the
example programs directory, you would type:
copy \gpib-pc\qbdecl.bas .
copy \gpib-pc\qbib.obj .
5. Perform the following two steps for example programs:
a. Compile the program by using the following command:
bc /o <file>.bas;
where <file> is one of the example program names.
To compile MEAS.BAS, type: bc /o meas.bas;
To compile COMM.BAS, type: bc /o comm.bas;
To compile GETWFM.BAS, type: bc /o getwfm.bas;
To compile CURSOR.BAS, type: bc /o cursor.bas;
To compile TL.BAS, type: bc /o tl.bas;
b. Link the compiled program with the qbib.obj module to create the
executable program (file.EXE) by using the following command:
link <file>.obj+qbib.obj;
where <file> is one of the above program names.
To link MEAS.OBJ, type: link meas.obj+qbib.obj;
To link COMM.OBJ, type: link comm.obj+qbib.obj;
To link GETWFM.OBJ, type: link getwfm.obj+qbib.obj;
To link CURSOR.OBJ, type: link cursor.obj+qbib.obj;
To link TL.OBJ, type: link tl.obj+qbib.obj;
44
Program Examples
is a collection of input/output routines used by the other

programs and is included for proper file compilation.
6. Run the program by simply typing the program name.
To run , type:
To run , type:
To run , type:
To run , type:
To run , type:
NOTE. The example programs disable front-panel operation while they are
running and reenable it when they terminate. If your program terminates
prematurely, front-panel operation may remain disabled. To reenable front-panel
operation, do one of the following: cycle power on the digitizing oscilloscope or
send the GPIB command
to unlock the front panel. You can send the

command with the TL program included in your sample programs
disk.
45
Program Examples
46
Appendix A: Character Charts

The characters in Table A1 are available for the digitizing oscilloscope.
Numbers in the lower left corners are character widths in pixels.
Table A1: The TDS Character Set
0
0
NUL
space
12
251
14
2
7
15
W
D
16
17
33
10
11
19
10
10
12
20
10
10
12
21
12
12
12
22
12
10
23
16
24
25
26
27
11
28
29
11
..
10
35
10
36
10
37
10
38
10
39
10
40
10
16
41
10
LF
10
12
42
10
11
11
12
13
11
10
14
10
30
15
10
31
ESC
43
C
D
44
11
45
11
46
11
F
7
47
53
54
55
11
56
13
57
58
59
10
60
61
15
62
13
63
13
67
81
68
10
69
12
70
11
71
15
72
10
73
10
74
10
75
76
77
78
11
79
11
82
11
83
84
10
85
86
87
10
88
11
89
90
91
10
92
93
15
94
11
95
10
100
101
11
102
10
103
14
104
105
10
106
107
123
108
124
109
110
11
126
111
127
s
115
t
116
u
117
v
118
w
119
x
120
y
121
z
122
99
114
98
113
112
10
97
11
p
96
10
>
R
66
80
13
<
12
CR
52
65
10
)
9
51
HT
0
10
10
B
50
P
64
&
12
49
14
2
34
@
48
10
18
0
32
}
125
A1
Appendix A: Character Charts
Table A2: ASCII & GPIB Code Chart

0
B7
0
0
B6
BITS
T
B4 B3 B2 B1
40
NUL
DLE
LA0
SP
LA16
10
16
20
32
30
48
21
LL0
41
LA1
61
LA17
11
17
21
33
31
49
42
LA2
62
LA18
34
32
50
LA3
63
LA19
DC1
22
STX
0 0 1 0
DC2
12
18
23
"
43
ETX
0 0 1 1
22
DC3
35
33
51
SDC
24
DCL
44
LA4
64
LA20
14
20
24
36
34
52
PPC
25
PPU
45
LA5
65
LA21
15
21
25
37
35
53
46
LA6
66
LA22
26
38
36
54
47
LA7
67
LA23
39
37
55
LA8
70
LA24
ENQ
NAK
5
6
ACK
0 1 1 0
SYN
22
27
BEL
0 1 1 1
ETB
7
10
68
54
105
TA5
125
45
69
55
106
TA6
126
46
70
56
107
TA7
127
47
71
57
110
TA8
130
48
72
58
111
TA9
131
73
59
D
E
SPD
51
LA9
71
LA25
19
25
29
41
39
57
52
LA10
72
LA26
2A
42
3A
58
53
LA11
73
LA27
2B
43
3B
59
54
LA12
74
LA28
114
2C
44
3C
60
4C
76
55
LA13
75
LA29
115
TA13
2D
45
3D
61
4D
77
56
LA14
76
LA30
116
TA14
2E
46
3E
62
57
LA15
77
UNL
47
3F
SUB
1A
26
ESC
1B
27
FS
1C
28
35
CR
GS
13
16
29
36
RS
14
17
1E
30
37
SI
US
15
ADDRESSED
COMMANDS
31
UNIVERSAL
COMMANDS
PPC
ENQ
5
2F
TA11
TA12
?
LISTEN
ADDRESSES
GPIB code (with ATN asserted)

ASCII character
decimal
4F
164
64
100
74
145
SA5
165
65
101
75
146
SA6
166
66
102
76
147
SA7
167
67
103
77
TA24
150
SA8
170
68
104
78
TA25
151
SA9
171
105
79
TA26
69
152
TA27
TA28
\
TA29
6C
136
78
TA15
79
137
5F
TALK
ADDRESSES
TA30
SA14
UNT
6E
7C
SA15
6F
124
175
SA29
7D
125
176
SA30
7E
111
126
177
o
95
SA28
~
110
157
123
174
}
109
156
SA27
7B
n
94
SA13
6D
122
173
m
93
5E
108
155
]
5D
SA12
l
92
135
7A
{
107
154
SA26
z
SA11
6B
121
172
k
91
120
SA25
106
153
119
SA24
SA10
6A
118
SA23
j
90
117
SA22
i
89
116
SA21
h
88
115
SA20
g
87
5C
O
63
TA23
134
N
117
SA4
f
86
5B
4E
TA22
SA19
73
e
85
114
163
s
99
144
[
75
>
TA21
133
72
d
84
5A
K
4B
TA20
Z
74
SA3
63
SA18
r
98
143
113
162
c
83
132
J
113
TA19
62
Y
TA10
4A
1F
112
SA2
71
b
82
112
SA17
q
97
142
I
49
<
1D
SO
TA18
61
31
EM
161
70
a
81
SA16
96
160
SA1
TCT
15
hex
44
56
12
octal
124
38
FF
TA4
34
1 1 1 1
104
SA0
141
40
14
53
28
11
1 1 1 0
67
24
CAN
VT
43
18
33
1 1 0 1
123
13
TA3
50
10
1 1 0 0
103
60
SPE
LF
52
30
32
1 0 1 1
66
GET
12
A
42
27
1 0 1 0
122
23
HT
1 0 0 1
TA2
17
8
11
102
80
TA17
140
BS
1 0 0 0
'
51
&
16
65
26
41
23
0 1 0 1
121
19
DC4
50
13
EOT
64
TA16
P
TA1
1
0

120
101
TA0
40
0 1 0 0
100
1
1
GTL
SOH
1
1
1
0

60
0 0 0 1
1
0

20
0 0 0 0
1
1

0
A2
0
1
B5
KEY
0
0
7F
RUBOUT
(DEL)
127
SECONDARY ADDRESSES
OR COMMANDS
Tektronix
REF: ANSI STD X3.4-1977
IEEE STD 488.1-1987
ISO STD 646-2973
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 robost code as the minimum
spelling rules may change over time and from model to model.
*CAL
*CLS
*DDT
*ESE
*ESR
*IDN
*LRN
*OPC
*PSC
*PUD
*RCL
*RST
*SAV
*SRE
*STB
*TRG
*TST
*WAI
ABOrt
ABSolute
AC
ACCept
ACQuire
ACQUISition
ACTivate
ACTUal
ALIas
ALL
ALLEv
ALLOcate
AMPlitude
AND
APPMenu
AREa
ARMed
ASC
ASCIi
AUTO
AUTOSet
AUXiliary
AVErage
BACKGround
BACKWards
BANdwidth
BASe
BAUd
BELl
BIN
BIT_Nr
BLAckman
BMP
BMPCOLOR
BN_Fmt
BOLd
BOTh
BOTTOM1
BOTTOM2
BOTTOM3
BOTTOM4
BOTTOM5
BOTTOM6
BOTTOM7
BOX
BURst
BUSY
BY
BYCONTents
BYT_Nr
BYT_Or
CALibrate
CATalog
CARea
CENtronics
CH1
CH2
CH3
CH4
CHKsm0
CLAss
CLEar
CLEARMenu
CLEARSNapshot
CLEARSpool
CLOCk
CMEan
COLLision
COLOr
COMPARE
CONTRast
CONTROl
COPy
COUNt
COUPling
CPU
CRMs
CROSSHair
CRVchk
CURRent
CURSor
CURSOR1
CURSOR2
CURVe
CUSTom
CWD
DATa
DATE
DC
DEFAult
DEFINE
DELay
DELAYEd
DELEte
DELTa
DELTATime
DELWarn
DESE
DESKJet
DESTination
DIAg
DIR
DIREction
DISplay
DOTs
DPU411
DPU412
DUAl
ECL
EDGE
EDGE1
EDGE2
EITher
ENCdg
ENV
ENVElope
EPSColor
EPSCOLImg
EPSImage
EPSMono
EPSOn
EVEN
EVENT
EVENTS
EVENTSTime
EVMsg
EVQty
EXECute
FACtory
FALL
FALSe
FASTERthan
FASTframe
FFT
FIELD
FIELD1
FIELD2
FIELDEither
FIELDRATE
FIELDS
FIELDType
FIFty
B1
FILEName
FILESystem
FILTer
FIRst
FITtoscreen
FLAg
FLEXformat
FORCe
FORMat
FORWards
FPAnel
FRAme
FREE
FREESpace
FREQuency
FULl
FUNCtion
GATing
GLItch
GND
GPIb
GRAticule
GRAYscale
GRId
HALt
HAMming
HARDCopy
HARDFlagging
HBArs
HDELTA
HDR
HDTv
HEADer
HERtz
HFRej
HIGH
HIGHLimit
HIRes
HIStogram
HOLdoff
HOLDTime
HORizontal
HPGl
HPOS1
HPOS2
HUNdred
ID
IMMed
IMPedance
INDependent
INFInite
INFPersist
INIT
INPut
B2
INStavu
INTENSIFied
INTENSITy
INTERLAce
INTERLeaf
INVert
IRE
LABel
LANdscape
LASERJet
LAYout
LENgth
LESSLimit
LESSThan
LEVel
LFRej
LIMit
LINE
LINES
LINEAr
LIVe
LOCk
LOG
LOGIc
LONG
LOW
LOWLimit
LSB
MAIn
MAP
MATH
MATH1
MATH2
MATH3
MAXimum
MEAN
MEAS1
MEAS2
MEAS3
MEAS4
MEASUrement
MEG
MESSage
METHod
MID
MID2
MINImum
MINMax
MKDir
MODe
MONo
MORELimit
MOREThan
MSB
NAMe
NANd
NDUty
NEGAtive
NEGSynchwidth
NEWpass
NOISErej
NONe
NOR
NORMal
NOVershoot
NR_Pt
NTSc
NUMACq
NUMAVg
NUMEnv
NUMERic
NWIdth
ODD
OFF
OFFSet
ON
ONCe
OR
OPTion
OUTside
OVERAll
OVERWrite
PAIred
PAL
PALEtte
PARity
PARTial
PASSWord
PATtern
PCX
PCXCOLOR
PDUty
PEAKdetect
PERCent
PERIod
PERSistence
PHAse
PK2pk
POLarity
PORT
PORTRait
POSition
POSITION1
POSITION2
POSITIVe
POVershoot
PREView
PRInt
PRObe
PROCessing
PT_Fmt
PT_Off
PULse
PWIdth
RATE1
RATE2
RATE3
RATE4
REAdy
RECAll
RECOrdlength
RECTangular
REF
REF1
REF2
REF3
REF4
REFLevel
REGular
REJect
REM
REName
REPEt
RESET
RESETAll
RESUlt
RI
RIBinary
RIGHT1
RIGHT2
RIGHT3
RIGHT4
RIGHT5
RISe
RLE
RMDir
RMS
RP
RPBinary
RS232
RUN
RUNSAfter
RUNSTop
RUNT
SAMple
SAVe
SCAle
SCAN
SCROLLBAR
SCROLLTEXT
SECAm
SECdiv
SECOnds
SELect
SEQuence
SET
SETHold
SETLevel
SETTime
SETUp
SHORt
SHOW
SINX
SLEWRate
SLOpe
SLOWERthan
SNAp
SNAPShot
SOFTFlagging
SOUrce
SOURCE1
SOURCE2
SPECTral
SRIbinary
SRPbinary
STANdard
STARt
STATE
STOP
STOPAfter
STOPBits
STORe
STYle
SYNc
SYStem
TARget
TEKSecure
TEMPErature
TEMPLate
TEXt
THInkjet
THReshold
TIFf
TIMe
TITLe
TO
TOLerance
TRACk
TRIGAfter
TRIGBar
TRIGger
TRIGT
TRUe
TTL
TWEnty
TWOfifty
TYPe
UNIts
UNLock
VALue
VARpersist
VBArs
VDELTA
VECtors
VERBose
VERTical
VIDeo
VOLts
V1STArttime
V1STOptime
V2STArttime
V2STOptime
WAVEform
WAVFrm
WFId
WFMPre
WHEn
WIDth
WIThin
X
XINcr
XMUlt
XOFf
XUNit
XY
XZEro
Y
YMUlt
YOFf
YT
YUNit
YZEro
ZMUlt
ZOFf
ZONe
ZOOm
ZUNit
ZZEro
B3
B4
Appendix C: Interface Specifications

This appendix describes details of the GPIB remote interface of the digitizing
oscilloscope. Normally, you will not need this information to use the digitizing
oscilloscope, but the information is useful when connecting to controllers of
unusual configuration.
GPIB Function Subsets

The digitizing oscilloscope supports many GPIB function subsets, as listed
below. Some of the listings describe subsets that the digitizing oscilloscope does
not support.
H
SH1 (Source Handshake). The digitizing oscilloscope can transmit multiline

messages across the GPIB.
AH1 (Acceptor Handshake). The digitizing oscilloscope can receive

multiline messages across the GPIB.
T5 (Talker). The digitizing oscilloscope becomes a talker when its talk

address is sent with the ATN (Attention) line asserted. It can send both
response data and status information when responding to a serial poll. It
ceases to be a talker when the talk address if another device is sent with ATN
asserted. The digitizing oscilloscope has talk-only capability for hardcopy
operation.
L4 (Listener). The digitizing oscilloscope becomes a listener when its listen

address is sent with the ATN (Attention) line asserted. The digitizing
oscilloscope does not have listen-only capability.
SR1 (Service Request). The digitizing oscilloscope asserts an SRQ (Service

Request) line to notify the controller when it requires service.
RL1 (Remote/Local). The digitizing oscilloscope responds to both the GTL

(Go To Local) and LLO (Local Lock Out) interface messages.
PP0 (Parallel Poll). The digitizing oscilloscope has no parallel poll capability. It does not respond to the following interface messages: PPC, PPD, PPE,
and PPU. The digitizing oscilloscope does not send out a status message
when the ATN (Attention) and EOI (End or Identify) lines are asserted
simultaneously.
DC1 (Device Clear). The digitizing oscilloscope responds to the DCL

(Device Clear) and, when made a listener, the SDC (Selected Device Clear)
interface messages.
C1
Appendix C: Interface Specifications
DT1 (Device Trigger). When acting as a listener, the digitizing oscilloscope

responds to the GET (Group Execute Trigger) interface message.
C0 (Controller). The digitizing oscilloscope cannot control other devices.
E2 (Electrical). The digitizing oscilloscope uses tristate buffers to provide

optimal high-speed data transfer.
Interface Messages
Table C1 shows the standard interface messages that are supported by the
digitizing oscilloscope.
Table C1: TDS Family Oscilloscope Standard
Interface Message
C2
Message
GPIB
DCL
Yes
GET
Yes
GTL
Yes
LLO
Yes
PPC
No
PPD
No
PPE
No
PPU
No
SDC
Yes
SPD
Yes
SPE
Yes
TCT
No
UNL
Yes
UNT
Yes
Listen Addresses
Yes
Talk Addresses
Yes
Appendix D: Factory Initialization Settings

The factory initialization settings provide you a known state for the digitizing
oscilloscope.
Factory initialization sets values as shown in Table D1.
Table D1: Factory Initialization Settings
Control
Changed by Factory Init to
Acquire mode
Sample
Acquire repetitive signal

(TDS 4XX, 5XXA, & 7XXA)
ON (Enable ET)
Acquire stop after
RUN/STOP button only
Acquire # of averages
16
Acquire # of envelopes
10
Channel selection
Channel 1 on, all others off
Cursor H Bar 1 position
10% of graticule height

(3.2 divs from the center)
Cursor H Bar 2 position
90% of the graticule height

(+3.2 divs from the center)
Cursor V Bar 1 position
10% of the record length
Cursor V Bar 2 position
90% of the record length
Cursor amplitude units

Base
Cursor function
Off
Cursor mode
Independent
Cursor time units
Seconds
Date and time
No change
Delay events,
triggerable after main
Delay time,
delayed runs after main
TDS 4XX: 10 ns
TDS 5XXA, 6XXA, & 7XXA: 16 ns
Delay time,
delayed triggerable after main
TDS 4XX: 60 ns
TDS 5XXA, 6XXA, & 7XXA: 16 ns
Delay trigger average #
16
Delay trigger envelope #
10
Delayed, delay by ...
Delay by Time
D1
Table D1: Factory Initialization Settings (Cont.)
D2
Control
Delayed edge trigger coupling

All except TDS 684A & 7XXA
DC
Main Trigger
Delayed edge trigger level
0V
Delayed edge trigger slope
Rising
Delayed edge trigger source
Channel 1
Delayed, time base mode
Delayed Runs After Main
Display clock
No Change
Display color collision contrast

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Off
Display color map math colors

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Color Math
Display color map reference colors

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Color Ref
Display color palette

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Normal
Display color palette colors

(TDS 524A, 544A, 644A, 684A, & 7XXA)
All palette colors are reset to factory hue,

saturation, and lightness (HLS) values
Display color persistence palette

(TDS 524A, 544A, 644A, 684A, & 7XXA)
Temperature
Display format
YT
Display graticule type
Full
Display instavu persistence
Varpersist
Display instavu style
Vectors
Display instavu varpersist
500 e3
Display intensity contrast

(TDS 4XX, 5X0A, & 6X0A)
150%
Display intensity text
TDS 524A, 544A, 644A, 684A, & 7XXA: 100%

TDS 4XX, 520A, & 540A, 620A, & 640A: 60%
Display intensity waveform
TDS 524A, 544A, 644A, 684A, & 7XXA: 100%

TDS 4XX, 520A, 540A, 620A, & 640A: 75%
Display intensity overall

(TDS 4XX, 5X0A, & 6X0A)
85%
Display interpolation filter
Sin(x)/x
Display mode
Normal
Display style
Vectors
Display trigger bar style
Short

Control
Display trigger T
On
Display variable persistence
500 ms
Edge trigger coupling
DC
Edge trigger level
0.0 V
Edge trigger slope
Rising
Edge trigger source
Channel 1
GPIB parameters
No change
Hardcopy Format
Layout
Palette
Port
Unchanged
Unchanged
Unchanged
Unchanged
Horizontal delay time/division
50 ms
Horizontal delay trigger position
50%
Horizontal delay trigger record length
500 points (10 divs)
Horizontal fit to screen

Off
Horizontal FastFrame
(TDS 520A, 524A, 540A, 544A, & 7XXA)
Off
Horizontal FastFrame, frame count

(TDS 520A, 524A, 540A, 544A, & 7XXA)
Horizontal FastFrame, frame length

(TDS 520A, 524A, 540A, 544A, & 7XXA)
500
Horizontal main time/division
500 ms
Horizontal main trigger position
50%
Horizontal main trigger record length
500 points (10 divs)
Horizontal time base
Main only
Limit template
V Limit
H Limit
40 mdiv
40 mdiv
Limit template destination
Ref1
Limit template source
Ch1
Limit test sources
Ch1 compared to Ref1; all others compared to

none.
Limit Testing
Off
Limit Testing hardcopy if condition met
Off
Limit Testing ring bell if condition met
Off
D3

Control
Logic pattern trigger Ch4 (Ax2) input

X (do not care)
Logic state trigger Ch4 (Ax2) input

Rising edge
Logic trigger input

(pattern and state)
Channel 1 = H (high),
Channels 2 & 3 (Ax1) = X (do not care)
Logic trigger pattern time qualification

Lower limit
Upper limit
5 ns
5 ns
Logic trigger sources and levels

(Setup/Hold)
(TDS 684A & 7XXA)
Data Source = Channel 1 = 1.4 V

Clock Source = Channel 2 = 1.4 V
(Source levels are clipped to 1.2 V at the
default volts/division setting established by
Factory Init)
Clock Edge = Rising
D4
Logic trigger threshold (all channels) (pattern

and state)
1.4 V (when 10X probe attached)
Logic trigger class

Pattern
Logic trigger logic

(pattern and state)
AND
Logic trigger triggers when ...

(pattern and state)
Goes TRUE
Main trigger holdoff
0%
Main trigger mode
Auto
Main trigger type
Edge
Math1 definition
Ch 1 + Ch 2
Math1 extended processing

No extended processing
Math2 definition
Ch 1 Ch 2 (FFT of Ch 1 for instruments with

Option 2F Advanced DSP Math)

Math3 definition
Inv of Ch 1

Control

Measure Delay edges
Both rising and forward searching
Measure Delay to
Channel 1 (Ch1)
Measure Gating
Off
Measure High Ref
90% and 0 V (units)
Measure High-Low Setup
Histogram
Measure Low Ref
10% and 0 V (units)
Measure Mid Ref
50% and 0 V (units)
Measure Mid2 Ref
50% and 0 V (units)
Pulse glitch filter state

On (Accept glitch)
Pulse glitch trigger polarity

Positive
Pulse glitch width

2.0 ns
Pulse runt high threshold

1.2 V
Pulse runt low threshold

0.8 V
Pulse runt trigger polarity

Positive
Pulse slew rate Delta Time
2.0 ns
Pulse slew rate polarity
Positive
Pulse slew rate setting

Pulse slew rate thresholds
Upper
Lower
Trig if faster than

1.80 V
800 mV
Pulse slew rate triggers when ...
Trig if faster than
Pulse trigger class

Glitch
Pulse trigger level

0.0 V
Pulse trigger source

(Glitch, runt, and width)
Channel 1 (Ch1)
D5
D6
Control
Pulse width lower limit

2.0 ns
Pulse width trigger polarity

Positive
Pulse width trigger when ...

Within limits
Pulse width upper limit

2.0 ns
RS-232 parameters
No change
Saved setups
No change
Saved waveforms
No change
Stop after
R/S button
Vertical bandwidth (all channels)
Full
Vertical coupling (all channels)
DC
Vertical impedance (termination) (all channels)
1 MW
Vertical offset (all channels)
0V
Vertical position (all channels)
0 divs.
Vertical volts per division (all channels)
100 mV per division
Zoom dual
Off
Zoom dual offset
5 e3
Zoom graticule
Upper
Zoom horizontal (all channels)
1.0X
Zoom horizontal lock
All
Zoom horizontal position (all channels)
50% = 0.5 (the middle of the display)
Zoom state
Off
Zoom vertical (all channels)
1.0X
Zoom vertical position (all channels)
0 divs.
Glossary
ASCII
Acronym for the American Standard Code for Information Interchange.
Controllers transmit commands to the digitizing oscilloscope using ASCII
character encoding.
Address
A 7-bit code that identifies an instrument on the communication bus. The
digitizing oscilloscope must have a unique address for the controller to
recognize and transmit commands to it.
Backus-Naur Form (BNF)
A standard notation system for command syntax diagrams. The syntax
diagrams in this manual use BNF notation.
Controller
A computer or other device that sends commands to and accepts responses
from the digitizing oscilloscope.
EOI
A mnemonic referring to the control line End or Identify on the GPIB
interface bus. One of the two possible end-of-message terminators.
EOM
A generic acronym referring to the end-of-message terminator. The
end-of-message terminator can be either an EOI or the ASCII code for line
feed (LF).
Equivalent-time sampling (ET)
A sampling mode in which the oscilloscope acquires signals over many
repetitions of the event. The TDS Family Series Digitizing Oscilloscopes use
a type of equivalent time sampling called random equivalent time sampling.
It utilizes an internal clock that runs asynchronously with respect to the input
signal and the signal trigger. The oscilloscope takes samples continuously,
independent of the trigger position, and displays them based on the time
difference between the sample and the trigger. Although the samples are
taken sequentially in time, they are random with respect to the trigger.
Real-time sampling
A sampling mode where the digitizing oscilloscope samples fast enough to
completely fill a waveform record from a single trigger event. Use real-time
sampling to capture single-shot or transient events.
GPIB
Acronym for General Purpose Interface Bus, the common name for the
communications interface system defined in IEEE Std 488.
Glossary1
Glossary
IEEE
Acronym for the Institute for Electrical and Electronic Engineers.
QuickBASIC
A computer language (distributed by Microsoft) that is based on the
Beginners All-Purpose Symbolic Instruction Code.
QuickC
A computer language (distributed by Microsoft) that is based on C.
TEKSecure
A Tektronix custom command that initializes both waveform and setup
memories. This overwrites any previously stored data.
Glossary2
Index
A
Abbreviating, command, 24
ACQUIRE?, 239
ACQUIRE:AUTOSAVE, 239
ACQUIRE:MODE, 240
ACQUIRE:NUMACQ?, 242
ACQUIRE:NUMAVG, 243
ACQUIRE:NUMENV, 243
ACQUIRE:REPET, 244
ACQUIRE:STATE, 245
ACQUIRE:STOPAFTER, 246
Acquisition command group, 211, 212
Acquisition commands
ACQUIRE?, 239
ACQUIRE:AUTOSAVE, 239
ACQUIRE:MODE, 240
ACQUIRE:NUMACQ?, 242
ACQUIRE:NUMAVG, 243
ACQUIRE:NUMENV, 243
ACQUIRE:REPET, 244
ACQUIRE:STATE, 245
ACQUIRE:STOPAFTER, 246
Address, Definition of, Glossary1
ALIAS, 247
Alias commands
ALIAS, 247
ALIAS:CATALOG?, 248
ALIAS:DEFINE, 248
ALIAS:DELETE, 250
ALIAS:DELETE:ALL, 250
ALIAS:DELETE:NAME, 250
ALIAS:STATE, 251
ALIAS:CATALOG?, 248
ALIAS:DEFINE, 248
ALIAS:DELETE, 250
ALIAS:DELETE:ALL, 250
ALIAS:DELETE:NAME, 250
ALIAS:STATE, 251
ALLEV?, 251
ALLOCATE?, 252
ALLOCATE:WAVEFORM?, 253
ALLOCATE:WAVEFORM:FREE?, 253
ALLOCATE:WAVEFORM:REF<x>, 254
Application menu command group, 212
Application menu commands
APPMENU, 254
APPMENU:LABEL, 255
APPMENU:LABEL:BOTTOM, 256
APPMENU:LABEL:RIGHT, 257
APPMENU:LABEL:TITLE, 258
APPMENU, 254
APPMENU:LABEL, 255
APPMENU:LABEL:BOTTOM, 256
APPMENU:LABEL:RIGHT, 257
APPMENU:LABEL:TITLE, 258
Argument, command, 22
ASCII, 21, Glossary1
Audio indicator, 259
AUTOSET, 258
B
Backus-Naur Form, 21
Definition of, Glossary1
BELL, 259
Block, command argument, 29
BNF, Glossary1
BNF (Backus-Naur form), 21
Break, 23
BUSY?, 259
C
*CAL?, 260
Calibration and diagnostic command group, 213
Calibration and diagnostic commands
*CAL?, 260
DIAG:RESULT:FLAG?, 294
DIAG:RESULT:LOG?, 295
DIAG:SELECT:ACQUISITION, 296
DIAG:SELECT:ALL, 296
DIAG:SELECT:CPU, 296
DIAG:SELECT:DISPLAY, 297
DIAG:SELECT:FPANEL, 297
DIAG:STATE, 298
CH<x>?, 261
CH<x>:BANDWIDTH, 261
CH<x>:COUPLING, 262
CH<x>:IMPEDANCE, 263
CH<x>:OFFSET, 264
CH<x>:POSITION, 265
CH<x>:PROBE?, 265
CH<x>:SCALE, 266
CH<x>:VOLTS, 266
Channel, command mnemonic, 27
CH<x>, command mnemonic, 27
Clear Status, 267
CLEARMENU, 267
Index1
Index
*CLS, 267
Command
Abbreviating, 24
Argument, 22
Block argument, 29
Common, 221, 223
Concatenating, 24
Header, 22
Message, 22
Mnemonic, 22
Query, 21
Rules for forming, 21
Separator, 22
Set, 21
Syntax, 21
Command argument
Numeric, 27
Quoted string, 28
Command Descriptions, 11
Command group
Acquisition, 211, 212
Application menu, 212
Calibration and diagnostic, 213
Cursor, 213
Display, 214
File system, 216
Hardcopy, 216
Horizontal, 217
Limit test, 218
Measurement, 219
Miscellaneous, 221
RS-232, 222
Save and recall, 222
Status and error, 223
Trigger, 224
Vertical, 231
Waveform, 232
Zoom, 237
Command Groups, 11
Command mnemonic
Channel, 27
CH<x>, 27
Cursor position, 26
Math waveform, 27
MATH<x>, 27
Measurement specifier, 26
MEAS<x>, 26
POSITION<x>, 26
Reference waveform, 27
REF<x>, 27
Waveform, 27
<wfm>, 27
Index2
Command syntax, 21
Commands, 11
Parts of, 11
Syntax diagrams, 11
Common command, 221, 223
Common GPIB commands
*CAL?, 260
*CLS, 267
Concatenating, command, 24
Configuration, Command query, 2152
Controller, Definition of, Glossary1
Cursor command group, 213
Cursor commands
CURSOR?, 268
CURSOR:FUNCTION, 269
CURSOR:HBARS?, 269
CURSOR:HBARS:DELTA?, 270
CURSOR:HBARS:POSITION<x>, 270
CURSOR:HBARS:SELECT, 271
CURSOR:HBARS:UNITS, 271
CURSOR:MODE, 272
CURSOR:PAIRED, 273
CURSOR:PAIRED:HDELTA, 273
CURSOR:PAIRED:HPOS1, 274
CURSOR:PAIRED:POSITION1, 275
CURSOR:PAIRED:SELECT, 276
CURSOR:PAIRED:UNITS, 277
CURSOR:PAIRED:VDELTA, 277
CURSOR:VBARS, 278
CURSOR:VBARS:DELTA?, 279
CURSOR:VBARS:POSITION<x>, 279
CURSOR:VBARS:SELECT, 280
CURSOR:VBARS:UNITS, 281
Cursor position, command mnemonic, 26
CURSOR?, 268
CURSOR:FUNCTION, 269
CURSOR:HBARS?, 269
CURSOR:HBARS:DELTA?, 270
CURSOR:HBARS:POSITION<x>, 270
CURSOR:HBARS:SELECT, 271
CURSOR:HBARS:UNITS, 271
CURSOR:MODE, 272
CURSOR:PAIRED, 273
CURSOR:PAIRED:HDELTA, 273
CURSOR:PAIRED:SELECT, 276
CURSOR:PAIRED:UNITS, 277
Index
CURSOR:PAIRED:VDELTA, 277
CURSOR:VBARS, 278
CURSOR:VBARS:DELTA?, 279
CURSOR:VBARS:POSITION<x>, 279
CURSOR:VBARS:SELECT, 280
CURSOR:VBARS:UNITS, 281
CURVE, 282
D
DATA, 284
DATA:DESTINATION, 284
DATA:ENCDG, 285
DATA:SOURCE, 287
DATA:START, 288
DATA:STOP, 288
DATA:TARGET, 289
DATA:WIDTH, 290
DATE, 291
DCL, C2
*DDT, 291
Delayed trigger, 2216, 2217, 2218, 2219, 2220,
2221, 2222, 2223
DELETE:SETUP, 292
DELETE:WAVEFORM, 293
DESE command, 293, 33
DESER register, 293, 2198, 33
Device Clear, 23, C2
DIAG:RESULT:FLAG?, 294
DIAG:RESULT:LOG?, 295
DIAG:SELECT:ACQUISITION, 296
DIAG:SELECT:ALL, 296
DIAG:SELECT:CPU, 296
DIAG:SELECT:DISPLAY, 297
DIAG:SELECT:FPANEL, 297
DIAG:STATE, 298
Diagram, syntax, 210
Disks included with this manual, 12
Display command group, 214
Display commands
CLEARMENU, 267
DISPLAY?, 299
DISPLAY:CLOCK, 299
DISPLAY:COLOR:CONTRAST, 2100
DISPLAY:COLOR:MAP:item name:TO, 2102
DISPLAY:COLOR:MAP:item:BYCONTENTS,
2101
DISPLAY:COLOR:PALETTE:palette name:item
name, 2105
DISPLAY:COLOR:PALETTE:palette name:RESET,
2104
DISPLAY:COLOR:PALETTE:PERSISTENCE,
2103
DISPLAY:COLOR:PALETTE:REGULAR, 2103
DISPLAY:COLOR:PALETTE:RESETALL, 2104
DISPLAY:DATE/TIME. See DISPLAY:CLOCK
DISPLAY:FILTER, 2107
DISPLAY:FORMAT, 2108
DISPLAY:GRATICULE, 2109
DISPLAY:INSTAVU:PERSISTENCE, 2110
DISPLAY:INSTAVU:STYLE, 2111
DISPLAY:INSTAVU:VARPERSIST, 2111
DISPLAY:INTENSITY?, 2112
DISPLAY:INTENSITY:CONTRAST, 2112
DISPLAY:INTENSITY:OVERALL, 2113
DISPLAY:INTENSITY:TEXT, 2114
DISPLAY:INTENSITY:WAVEFORM, 2114
DISPLAY:MODE, 2115
DISPLAY:PERSISTENCE, 2115
DISPLAY:STYLE, 2116
DISPLAY:TRIGBAR, 2117
DISPLAY:TRIGT, 2118
MESSAGE, 2192
MESSAGE:BOX, 2192
MESSAGE:SHOW, 2194
MESSAGE:STATE, 2195
DISPLAY?, 299
DISPLAY:CLOCK, 299
DISPLAY:COLOR:CONTRAST, 2100
DISPLAY:COLOR:MAP:item name:TO, 2102
DISPLAY:COLOR:MAP:item:BYCONTENTS, 2101
DISPLAY:COLOR:PALETTE:palette name:item name,
2105
DISPLAY:COLOR:PALETTE:palette name:RESET,
2104
DISPLAY:COLOR:PALETTE:PERSISTENCE, 2103
DISPLAY:COLOR:PALETTE:REGULAR, 2103
DISPLAY:COLOR:PALETTE:RESETALL, 2104
DISPLAY:DATE/TIME. See DISPLAY:CLOCK
DISPLAY:FILTER, 2107
DISPLAY:FORMAT, 2108
DISPLAY:GRATICULE, 2109
DISPLAY:INSTAVU:PERSISTENCE, 2110
DISPLAY:INSTAVU:STYLE, 2111
DISPLAY:INSTAVU:VARPERSIST, 2111
DISPLAY:INTENSITY?, 2112
DISPLAY:INTENSITY:CONTRAST, 2112
DISPLAY:INTENSITY:OVERALL, 2113
DISPLAY:INTENSITY:TEXT, 2114
DISPLAY:INTENSITY:WAVEFORM, 2114
DISPLAY:MODE, 2115
DISPLAY:PERSISTENCE, 2115
Index3
Index
DISPLAY:STYLE, 2116
DISPLAY:TRIGBAR, 2117
DISPLAY:TRIGT, 2118
E
Edge trigger, 2224, 2225, 2261
End or Identify, Glossary1
EOI, Glossary1
EOM, Glossary1
EOM (end of message), 25
Equivalent-time sampling, random, Glossary1
Error message, programming interface, 312
Error messages, 12
*ESE, 2118, 33
ESER register, 2118, 2198, 33
*ESR?, 2119
*ESR? query, 31
Event handling, 31, 36
Event query, 2120
Event queue, 2120, 35
EVENT?, 2120
EVMSG?, 2120
EVQTY?, 2121
Example programs, 12
On disk, 12
F
FACTORY, 2122
Factory initialization settings, D1D6
FASTFRAME, 2142, 2143, 2144
File system command group, 216
File system commands
FILESYSTEM:COPY, 2123
FILESYSTEM:CWD, 2124
FILESYSTEM:DELETE, 2124
FILESYSTEM:DELWARN, 2125
FILESYSTEM:DIR, 2126
FILESYSTEM:FORMAT, 2126
FILESYSTEM:FREESPACE, 2126
FILESYSTEM:MKDIR, 2127
FILESYSTEM:OVERWRITE, 2127
FILESYSTEM:PRINT, 2128
FILESYSTEM:RENAME, 2129
FILESYSTEM:RMDIR, 2129
FILESYSTEM:COPY, 2123
FILESYSTEM:CWD, 2124
FILESYSTEM:DELETE, 2124
FILESYSTEM:DELWARN, 2125
FILESYSTEM:DIR, 2126
FILESYSTEM:FORMAT, 2126
Index4
FILESYSTEM:FREESPACE, 2126
FILESYSTEM:MKDIR, 2127
FILESYSTEM:OVERWRITE, 2127
FILESYSTEM:PRINT, 2128
FILESYSTEM:RENAME, 2129
FILESYSTEM:RMDIR, 2129
FITTOSCREEN, 2145
G
GET, C2
Glitch trigger, 2245, 2246, 2247
Go to local, C2
GPIB, Glossary1
Configurations, 14
Connection rules, 14
EOM (end of message), 25
Function subsets, C1
Group execute trigger, C2
GTL, C2
H
HARDCOPY, 2130
Hardcopy command group, 216
Hardcopy commands
HARDCOPY, 2130
HARDCOPY:FILENAME, 2131
HARDCOPY:FORMAT, 2132
HARDCOPY:LAYOUT, 2134
HARDCOPY:PALETTE, 2134
HARDCOPY:PORT, 2135
HARDCOPY:FILENAME, 2131
HARDCOPY:FORMAT, 2132
HARDCOPY:LAYOUT, 2134
HARDCOPY:PALETTE, 2134
HARDCOPY:PORT, 2135
HDR, 2136
HEADER, 2136
Header
Command, 22, 2136
Included in query response, 2136, 2282
Horizontal command group, 217
Horizontal commands
HORIZONTAL?, 2137
HORIZONTAL:DELAY?, 2138
HORIZONTAL:DELAY:MODE, 2138
HORIZONTAL:DELAY:SCALE, 2139
HORIZONTAL:DELAY:SECDIV, 2140
HORIZONTAL:DELAY:TIME, 2140
HORIZONTAL:DELAY:TIME?, 2141
Index
HORIZONTAL:DELAY:TIME:RUNSAFTER,
2141
HORIZONTAL:DELAY:TIME:TRIGAFTER, 2142
HORIZONTAL:FASTFRAME:COUNT, 2142
HORIZONTAL:FASTFRAME:LENGTH, 2143
HORIZONTAL:FASTFRAME:POSITION, 2144
HORIZONTAL:FASTFRAME:STATE, 2144
HORIZONTAL:FITTOSCREEN, 2145
HORIZONTAL:MAIN?, 2146
HORIZONTAL:MAIN:SCALE, 2146
HORIZONTAL:MAIN:SECDIV, 2147
HORIZONTAL:MODE, 2147
HORIZONTAL:POSITION, 2149
HORIZONTAL:RECORDLENGTH, 2149
HORIZONTAL:SCALE, 2150
HORIZONTAL:SECDIV, 2150
HORIZONTAL:TRIGGER?, 2151
HORIZONTAL:TRIGGER:POSITION, 2151
HORIZONTAL?, 2137
HORIZONTAL:DELAY?, 2138
HORIZONTAL:DELAY:MODE, 2138
HORIZONTAL:DELAY:SCALE, 2139
HORIZONTAL:DELAY:SECDIV, 2140
HORIZONTAL:DELAY:TIME, 2140
HORIZONTAL:DELAY:TIME?, 2141
HORIZONTAL:DELAY:TIME:RUNSAFTER, 2141
HORIZONTAL:DELAY:TIME:TRIGAFTER, 2142
HORIZONTAL:FASTFRAME:COUNT, 2142
HORIZONTAL:FASTFRAME:LENGTH, 2143
HORIZONTAL:FASTFRAME:POSITION, 2144
HORIZONTAL:FASTFRAME:STATE, 2144
HORIZONTAL:FITTOSCREEN, 2145
HORIZONTAL:MAIN?, 2146
HORIZONTAL:MAIN:SCALE, 2146
HORIZONTAL:MAIN:SECDIV, 2147
HORIZONTAL:MODE, 2147
HORIZONTAL:POSITION, 2149
HORIZONTAL:RECORDLENGTH, 2149
HORIZONTAL:SCALE, 2150
HORIZONTAL:SECDIV, 2150
HORIZONTAL:TRIGGER?, 2151
HORIZONTAL:TRIGGER:POSITION, 2151
I
ID?, 2152
*IDN?, 2152
IEEE, Glossary2
IEEE Std 488.2-1987, 13, 21, 221, 223
Instrument setup, 13
Interface message, C2
L
Limit test command group, 218
Limit Test commands
LIMIT:BELL, 2153
LIMIT:COMPARE:CH<x>, 2153
LIMIT:COMPARE:MATH<x>, 2154
LIMIT:HARDCOPY, 2155
LIMIT:STATE, 2156
LIMIT:TEMPLATE, 2157
LIMIT:TEMPLATE:DESTINATION, 2157
LIMIT:TEMPLATE:SOURCE, 2158
LIMIT:TEMPLATE:TOLERANCE: VERTICAL,
2160
LIMIT:TEMPLATE:TOLERANCE:HORIZONTAL,
2159
LIMIT:BELL, 2153
LIMIT:COMPARE:CH<X>, 2153
LIMIT:COMPARE:MATH<X>, 2154
LIMIT:HARDCOPY, 2155
LIMIT:STATE, 2156
LIMIT:TEMPLATE, 2157
LIMIT:TEMPLATE:DESTINATION, 2157
LIMIT:TEMPLATE:SOURCE, 2158
LIMIT:TEMPLATE:TOLERANCE: VERTICAL,
2160
LIMIT:TEMPLATE:TOLERANCE:HORIZONTAL,
2159
LLO, C2
Local lock out, C2
LOCK, 2160
Logic trigger, 2230, 2231, 2232, 2233, 2234,
2235, 2236, 2237, 2238, 2239, 2240,
2241, 2242, 2243, 2261
*LRN?, 2161
M
Manual trigger, Simulation with command, 2281
Math waveform, command mnemonic, 27
MATH<x>?, 2162
MATH<x>:DEFINE, 2162
MATH<x>:NUMAVg, 2164
MATH<x>:PROCessing, 2165
MATH<x>, command mnemonic, 27
Measurement command group, 219
Measurement commands
MEASUREMENT?, 2165
MEASUREMENT:CLEARSNAPSHOT, 2166
MEASUREMENT:GATING, 2166
MEASUREMENT:IMMED?, 2167
Index5
Index
MEASUREMENT:IMMED:DELAY?, 2168
MEASUREMENT:IMMED:DELAY:DIRECTION,
2168
MEASUREMENT:IMMED:DELAY:EDGE1, 2169
MEASUREMENT:IMMED:SOURCE1, 2170
MEASUREMENT:IMMED:TYPE, 2172
MEASUREMENT:IMMED:UNITS?, 2175
MEASUREMENT:IMMED:VALUE?, 2175
MEASUREMENT:MEAS<x>?, 2176
MEASUREMENT:MEAS<x>: DELAY?, 2176
MEASUREMENT:MEAS<x>: DELAY:
DIRECTION?, 2176
MEASUREMENT:MEAS<x>: DELAY:EDGE1,
2177
MEASUREMENT:MEAS<x>: DELAY:EDGE2,
2178
MEASUREMENT:MEAS<x>: DELAY:SOURCE1,
2179
2180
MEASUREMENT:MEAS<x>: STATE, 2180
MEASUREMENT:MEAS<x>: TYPE, 2181
MEASUREMENT:MEAS<x>: UNITS?, 2184
MEASUREMENT:MEAS<x>: VALUES?, 2184
MEASUREMENT:METHOD, 2185
MEASUREMENT:REFLEVEL?, 2185
MEASUREMENT:REFLEVEL:
ABSOLUTE:HIGH, 2186
MEASUREMENT:REFLEVEL: ABSOLUTE:MID,
2187
MEASUREMENT:REFLEVEL:
ABSOLUTE:MID2, 2188
MEASUREMENT:REFLEVEL: METHOD, 2188
MEASUREMENT:REFLEVEL: PERCENT:HIGH,
2189
MEASUREMENT:REFLEVEL: PERCENT:LOW,
2190
MEASUREMENT:REFLEVEL: PERCENT:MID,
2190
MEASUREMENT:REFLEVEL: PERCENT:MID2,
2191
MEASUREMENT:REFLEVEL:ABSOLUTE:LOW,
2186
MEASUREMENT:SNAPSHOT, 2192
Measurement specifier, command mnemonic, 26
MEASUREMENT?, 2165
MEASUREMENT:CLEARSNAPSHOT, 2166
MEASUREMENT:GATING, 2166
MEASUREMENT:IMMED?, 2167
MEASUREMENT:IMMED:DELAY?, 2168
Index6
MEASUREMENT:IMMED:DELAY:DIRECTION,
2168
MEASUREMENT:IMMED:TYPE, 2172
MEASUREMENT:IMMED:UNITS?, 2175
MEASUREMENT:IMMED:VALUE?, 2175
MEASUREMENT:MEAS<x>?, 2176
MEASUREMENT:MEAS<x>: DELAY?, 2176
MEASUREMENT:MEAS<x>: DELAY:DIRECTION?,
2176
MEASUREMENT:MEAS<x>: DELAY:EDGE1, 2177
MEASUREMENT:MEAS<x>: DELAY:EDGE2, 2178
2179
2180
MEASUREMENT:MEAS<x>: STATE, 2180
MEASUREMENT:MEAS<x>: TYPE, 2181
MEASUREMENT:MEAS<x>: UNITS?, 2184
MEASUREMENT:MEAS<x>: VALUES?, 2184
MEASUREMENT:METHOD, 2185
MEASUREMENT:REFLEVEL?, 2185
MEASUREMENT:REFLEVEL:ABSOLUTE:HIGH,
2186
MEASUREMENT:REFLEVEL:ABSOLUTE:LOW,
2186
MEASUREMENT:REFLEVEL:ABSOLUTE:MID,
2187
MEASUREMENT:REFLEVEL:ABSOLUTE:MID2,
2188
MEASUREMENT:REFLEVEL:METHOD, 2188
MEASUREMENT:REFLEVEL:PERCENT:HIGH,
2189
MEASUREMENT:REFLEVEL:PERCENT:LOW,
2190
MEASUREMENT:REFLEVEL:PERCENT:MID,
2190
MEASUREMENT:REFLEVEL:PERCENT:MID2,
2191
MEASUREMENT:SNAPSHOT, 2192
MEAS<x>, command mnemonic, 26
MESSAGE, 2192
Message
Command, 22
Command terminator, 25
Handling, 31
Table of program messages, 312
MESSAGE:BOX, 2192
MESSAGE:SHOW, 2194
Index
MESSAGE:STATE, 2195
Messages, Status and error, 12
Miscellaneous, LOCK, 2160
Miscellaneous command group, 221
Miscellaneous commands
AUTOSET, 258
BELL, 259
DATE, 291
*DDT, 291
FACTORY, 2122
HDR, 2136
HEADER, 2136
*IDN?, 2152
*LRN?, 2161
NEWPASS, 2195
PASSWORD, 2197
*PUD, 2199
REM, 2202
SET, 2212
TEKSECURE, 2214
TIME, 2214
*TRG, 2281
UNLOCK, 2282
VERBOSE, 2282
Mnemonic, command, 22
N
NEWPASS, 2195
Numeric, command argument, 27
O
*OPC, 2196
Operation complete command, 2196
Operation complete wait, 2283
*OPT, 2197
Option Identification Query, 2197
Output queue, 35
P
Parallel poll, C2
Parts of commands, 11
PASSWORD, 2197
Pattern trigger, 2233, 2234, 2235
POSITION<x>, command mnemonic, 26
Power-on status clear command, 2198
PPC, C2
PPD, C2
PPE, C2
PPU, C2
Programming Examples, 12, 41
*PSC, 2198
*PSC command, 34
*PUD, 2199
Pulse trigger, 2244, 2245, 2246, 2247, 2248,
2249, 2250, 2251, 2252, 2253, 2254,
2255, 2256, 2257, 2258, 2259, 2260, 2261
Q
Query, Header in query response, 2136, 2282
Query command, 21
Queue
Event, 35
Output, 35
QuickBASIC, 41, Glossary2
QuickC, 41, Glossary2
Quoted string, command argument, 28
R
*RCL, 2200
Real-time sampling, Glossary1
Recall setting command, 2200
RECALL:SETUP, 2200
RECALL:WAVEFORM, 2201
Reference waveform, command mnemonic, 27
REF<x>, command mnemonic, 27
Register
DESER, 293, 2198, 33
ESER, 2118, 2198, 33
SBR, 2213, 32
SESR, 267, 2119, 2196, 31
SRER, 2198, 2213, 34
REM, 2202
Reset
Command, 2202
Factory, 2122
RS-232 command group, 222
RS-232 commands
RS232?, 2206
RS232:BAUD, 2203
RS232:HARDFLAGGING, 2204
RS232:PARITY, 2204
RS232:SOFTFLAGGING, 2205
RS232:STOPBITS, 2206
RS232?, 2206
RS232: BAUD, 2203
RS232:HARDFLAGGING, 2204
RS232:PARITY, 2204
Index7
Index
RS232:SOFTFLAGGING, 2205
RS232:STOPBITS, 2206
*RST, 2202
Rules, command forming, 21
Runt trigger, 2245, 2248, 2249, 2250, 2251,
2252
S
*SAV, 2207
Save and recall command group, 222
Save and recall commands
ALLOCATE?, 252
ALLOCATE:WAVEFORM?, 253
ALLOCATE:WAVEFORM:FREE?, 253
ALLOCATE:WAVEFORM:REF<x>, 254
DELETE:SETUP, 292
DELETE:WAVEFORM, 293
*RCL, 2200
RECALL:SETUP, 2200
RECALL:WAVEFORM, 2201
*SAV, 2207
SAVE:SETUP, 2207
SAVE:WAVEFORM, 2208
SAVE:WAVEFORM:FILEFORMT, 2209
Save setting command, 2207
SAVE:SETUP, 2207
SAVE:WAVEFORM, 2208
SAVE:WAVEFORM:FILEFORMT, 2209
SBR register, 2213, 32
SDC, C2
SELECT?, 2210
SELECT:<wfm>, 2211
SELECT:CONTROL?, 2211
Selected device clear, C2
Self test, 2281
Separator, command, 22
Serial poll, 32
Disable, C2
Enable, C2
Service request enable command, 2213
Service request enable register, 2213
Service Requests, 12
SESR register, 267, 2119, 2196, 31
Set command, 21
SET?, 2212
Sethold trigger, 2236, 2237, 2238, 2239, 2240
Setting
Command query, 2161
Query, 2161
Recall command, 2200
Save command, 2207
Index8
Setup, Instrument preparation, 13

Slewrate trigger, 2245, 2253, 2254, 2255, 2256,
2257
SPD, C2
SPE, C2
*SRE command, 2213, 34
SRER register, 2198, 2213, 34
SRQ, 12
State trigger, 2241
Status, 31
Status and error command group, 223
Status and error commands
*OPT, 2197
ALLEV?, 251
BUSY?, 259
*CLS, 267
DESE, 293, 33
*ESE, 2118, 33
*ESR?, 2119, 31
EVENT?, 2120
EVMSG?, 2120
EVQTY?, 2121
ID?, 2152
*OPC, 2196
*PSC, 2198, 34
*RST, 2202
*SRE, 2213, 34
*STB?, 2213, 32
*TST?, 2281
*WAI, 2283
Status and Events, 12
*STB?, 2213
*STB? query, 32
Syntax
Command, 21
Diagram, 210
Syntax and Commands, 11
Syntax diagrams, 11
T
Table, programming message, 312
TCT, C2
Tek Standard Codes and Formats 1989, 223
TEKSECURE, 2214
TEKSecure, Glossary2
Terminator, command message, 25
TIME, 2214
Time base, Manual trigger simulation, 2281
*TRG, 2281
TRIGGER, 2215
Index
Trigger command group, 224

Trigger commands
TRIGGER, 2215
TRIGGER:DELAY, 2216
TRIGGER:DELAY:BY, 2217
TRIGGER:DELAY:EDGE?, 2218
TRIGGER:DELAY:EDGE:COUPLING, 2218
TRIGGER:DELAY:EDGE:SLOPE, 2219
TRIGGER:DELAY:EDGE:SOURCE, 2220
TRIGGER:DELAY:EVENTS?, 2220
TRIGGER:DELAY:EVENTS:COUNT, 2221
TRIGGER:DELAY:LEVEL, 2221
TRIGGER:DELAY:TIME, 2222
TRIGGER:DELAY:TYPE, 2223
TRIGGER:MAIN, 2223
TRIGGER:MAIN:EDGE?, 2224
TRIGGER:MAIN:EDGE:COUPLING, 2224
TRIGGER:MAIN:EDGE:SLOPE, 2225
TRIGGER:MAIN:EDGE:SOURCE, 2225
TRIGGER:MAIN:HOLDOFF?, 2226
TRIGGER:MAIN:HOLDOFF:ACTUAL?, 2227
TRIGGER:MAIN:HOLDOFF:BY, 2227
TRIGGER:MAIN:HOLDOFF:TIME, 2228
TRIGGER:MAIN:HOLDOFF:VALUE, 2228
TRIGGER:MAIN:LEVEL, 2229
TRIGGER:MAIN:LOGIC?, 2230
TRIGGER:MAIN:LOGIC:CLASS, 2230
TRIGGER:MAIN:LOGIC:CLOCK:LEVEL, 2237
TRIGGER:MAIN:LOGIC:DATA:LEVEL, 2238
TRIGGER:MAIN:LOGIC:FUNCTION, 2231
TRIGGER:MAIN:LOGIC:INPUT?, 2232
TRIGGER:MAIN:LOGIC:INPUT: CH<x>?, 2232
TRIGGER:MAIN:LOGIC:PATTERN: INPUT:CH4?,
2233
TRIGGER:MAIN:LOGIC:PATTERN: WHEN,
2234
TRIGGER:MAIN:LOGIC:PATTERN:
WHEN:LESSLIMIT, 2235
TRIGGER:MAIN:LOGIC:PATTERN:WHEN:
MORELIMIT, 2235
TRIGGER:MAIN:LOGIC:
SETHOLD:CLOCK:EDGE, 2236
TRIGGER:MAIN:LOGIC:
SETHOLD:CLOCK:SOURCE, 2237
TRIGGER:MAIN:LOGIC:
SETHOLD:DATA:SOURCE, 2239
TRIGGER:MAIN:LOGIC:SETHOLD:HOLDTIME,
2239
TRIGGER:MAIN:LOGIC:SETHOLD:SETTIME,
2240
TRIGGER:MAIN:LOGIC:STATE: INPUT:CH4?,
2241
TRIGGER:MAIN:LOGIC:STATE:WHEN, 2241
TRIGGER:MAIN:LOGIC:THRESHOLD?, 2242
TRIGGER:MAIN:LOGIC:THRESHOLD:CH<x>,
2242
TRIGGER:MAIN:LOGIC:WHEN, 2243
TRIGGER:MAIN:MODE, 2243
TRIGGER:MAIN:PULSE?, 2244
TRIGGER:MAIN:PULSE:CLASS, 2245
TRIGGER:MAIN:PULSE:GLITCH?, 2246
TRIGGER:MAIN:PULSE:GLITCH:FILTER, 2246
TRIGGER:MAIN:PULSE:GLITCH:POLARITY,
2247
TRIGGER:MAIN:PULSE:GLITCH:WIDTH, 2247
TRIGGER:MAIN:PULSE:RUNT?, 2248
TRIGGER:MAIN:PULSE:RUNT:POLARITY,
2248
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD?,
2249
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:BOTH, 2250
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:HIGH, 2250
TRIGGER:MAIN:PULSE:RUNT:
THRESHOLD:LOW, 2251
TRIGGER:MAIN:PULSE:RUNT:WHEN, 2252
TRIGGER:MAIN:PULSE:RUNT:WIDTH, 2252
TRIGGER:MAIN:PULSE:SLEWRATE:
THRESHOLD:HIGH, 2255
DELTATIME, 2253
TRIGGER:MAIN:PULSE:SLEWRATE:POLARITY,
2254
SLEWRATE, 2254
THRESHOLD:BOTH, 2255
THRESHOLD:LOW, 2256
TRIGGER:MAIN:PULSE:SLEWRATE:WHEN,
2257
TRIGGER:MAIN:PULSE:SOURCE, 2257
TRIGGER:MAIN:PULSE:WIDTH?, 2258
TRIGGER:MAIN:PULSE:WIDTH:HIGHLIMIT,
2258
TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT,
2259
TRIGGER:MAIN:PULSE:WIDTH:POLARITY,
2259
TRIGGER:MAIN:PULSE:WIDTH:WHEN, 2260
TRIGGER:MAIN:TYPE, 2261
TRIGGER:MAIN:VIDEO?, 2262
Index9
Index
TRIGGER:MAIN:VIDEO:BY, 2262
TRIGGER:MAIN:VIDEO:FIELD, 2263
TRIGGER:MAIN:VIDEO:FIELDTYPE, 2264
TRIGGER:MAIN:VIDEO:FLEXFORMAT?, 2265
TRIGGER:MAIN:VIDEO:FLEXFORMAT:FIELD,
2266
TRIGGER:MAIN:VIDEO:FLEXFORMAT:
FRAMERATE, 2265
TRIGGER:MAIN:VIDEO:FLEXFORMAT:LINES,
2267
TRIGGER:MAIN:VIDEO:FLEXFORMAT:NEGSYNCWIDTH, 2267
TRIGGER:MAIN:VIDEO:FLEXFORMAT:V1STARTTIME, 2268
TRIGGER:MAIN:VIDEO:FLEXFORMAT:V1STOPTIME, 2269
TRIGGER:MAIN:VIDEO:FLEXFORMAT:V2STARTTIME, 2269
TRIGGER:MAIN:VIDEO:FLEXFORMAT:V2STOPTIME, 2270
TRIGGER:MAIN:VIDEO:HDTV, 2271
TRIGGER:MAIN:VIDEO:HOLDOFF?, 2271
TRIGGER:MAIN:VIDEO:HOLDOFF:VALUE,
2272
TRIGGER:MAIN:VIDEO:LINE, 2273
TRIGGER:MAIN:VIDEO:LINES, 2274
TRIGGER:MAIN:VIDEO:NTSC, 2274
TRIGGER:MAIN:VIDEO:PAL, 2275
TRIGGER:MAIN:VIDEO:SCAN, 2276
TRIGGER:MAIN:VIDEO:SOURCE, 2276
TRIGGER:MAIN:VIDEO:STANDARD, 2277
TRIGGER:MAIN:VIDEO:SYNC, 2278
TRIGGER:MAIN:VIDEO:SYSTEM, 2278
TRIGGER:MAIN:VIDEO:TIME, 2279
TRIGGER:STATE?, 2280
TRIGGER:DELAY, 2216
TRIGGER:DELAY:BY, 2217
TRIGGER:DELAY:EDGE?, 2218
TRIGGER:DELAY:EDGE:COUPLING, 2218
TRIGGER:DELAY:EDGE:SLOPE, 2219
TRIGGER:DELAY:EDGE:SOURCE, 2220
TRIGGER:DELAY:EVENTS?, 2220
TRIGGER:DELAY:EVENTS:COUNT, 2221
TRIGGER:DELAY:LEVEL, 2221
TRIGGER:DELAY:TIME, 2222
TRIGGER:DELAY:TYPE, 2223
TRIGGER:MAIN, 2223
TRIGGER:MAIN:EDGE?, 2224
TRIGGER:MAIN:EDGE:COUPLING, 2224
TRIGGER:MAIN:EDGE:SLOPE, 2225
TRIGGER:MAIN:EDGE:SOURCE, 2225
TRIGGER:MAIN:HOLDOFF?, 2226
Index10
TRIGGER:MAIN:HOLDOFF:ACTUAL?, 2227
TRIGGER:MAIN:HOLDOFF:BY, 2227
TRIGGER:MAIN:HOLDOFF:TIME, 2228
TRIGGER:MAIN:HOLDOFF:VALUE, 2228
TRIGGER:MAIN:LEVEL, 2229
TRIGGER:MAIN:LOGIC?, 2230
TRIGGER:MAIN:LOGIC:CLASS, 2230
TRIGGER:MAIN:LOGIC:FUNCTION, 2231
TRIGGER:MAIN:LOGIC:INPUT?, 2232
TRIGGER:MAIN:LOGIC:INPUT: CH<x>?, 2232
TRIGGER:MAIN:LOGIC:PATTERN: INPUT:CH4?,
2233
TRIGGER:MAIN:LOGIC:PATTERN: WHEN, 2234
TRIGGER:MAIN:LOGIC:PATTERN: WHEN:
LESSLIMIT, 2235
TRIGGER:MAIN:LOGIC:PATTERN: WHEN:
MORELIMIT, 2235
TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:EDGE,
2236
TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:
LEVEL, 2237
TRIGGER:MAIN:LOGIC:SETHOLD:CLOCK:SOURCE, 2237
TRIGGER:MAIN:LOGIC:SETHOLD:DATA:LEVEL,
2238
TRIGGER:MAIN:LOGIC:
SETHOLD:DATA:SOURCE, 2239
TRIGGER:MAIN:LOGIC:SETHOLD:HOLDTIME,
2239
TRIGGER:MAIN:LOGIC:SETHOLD:SETTIME,
2240
TRIGGER:MAIN:LOGIC:STATE: INPUT:CH4?,
2241
TRIGGER:MAIN:LOGIC:STATE:WHEN, 2241
TRIGGER:MAIN:LOGIC:THRESHOLD?, 2242
TRIGGER:MAIN:LOGIC:THRESHOLD<x>, 2242
TRIGGER:MAIN:LOGIC:WHEN, 2243
TRIGGER:MAIN:MODE, 2243
TRIGGER:MAIN:PULSE?, 2244
TRIGGER:MAIN:PULSE:CLASS, 2245
TRIGGER:MAIN:PULSE:GLITCH?, 2246
TRIGGER:MAIN:PULSE:GLITCH:FILTER, 2246
TRIGGER:MAIN:PULSE:GLITCH:POLARITY,
2247
TRIGGER:MAIN:PULSE:GLITCH:WIDTH, 2247
TRIGGER:MAIN:PULSE:RUNT?, 2248
TRIGGER:MAIN:PULSE:RUNT:POLARITY, 2248
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD?,
2249
Index
TRIGGER:MAIN:PULSE:RUNT:THRESHOLD:LOW,
2251
TRIGGER:MAIN:PULSE:RUNT:WHEN, 2252
TRIGGER:MAIN:PULSE:RUNT:WIDTH, 2252
TRIGGER:MAIN:PULSE:SLEWRATE:DELTATIME,
2253
TRIGGER:MAIN:PULSE:SLEWRATE:POLARITY,
2254
TRIGGER:MAIN:PULSE:SLEWRATE:SLEWRATE?,
2254
THRESHOLD:LOW, 2256
TRIGGER:MAIN:PULSE:SLEWRATE:WHEN, 2257
TRIGGER:MAIN:PULSE:SOURCE, 2257
TRIGGER:MAIN:PULSE:WIDTH?, 2258
TRIGGER:MAIN:PULSE:WIDTH:HIGHLIMIT,
2258
TRIGGER:MAIN:PULSE:WIDTH:LOWLIMIT, 2259
TRIGGER:MAIN:PULSE:WIDTH:POLARITY, 2259
TRIGGER:MAIN:PULSE:WIDTH:WHEN, 2260
TRIGGER:MAIN:TYPE, 2261
TRIGGER:MAIN:VIDEO?, 2262
TRIGGER:MAIN:VIDEO:BY, 2262
TRIGGER:MAIN:VIDEO:FIELD, 2263
TRIGGER:MAIN:VIDEO:FIELDTYPE, 2264
TRIGGER:MAIN:VIDEO:FLEXFORMAT?, 2265
TRIGGER:MAIN:VIDEO:FLEXFORMAT:FIELD,
2266
FRAMERATE, 2265
TRIGGER:MAIN:VIDEO:FLEXFORMAT:LINES,
2267
NEGSYNCWIDTH, 2267
V1STARTTIME, 2268
V1STOPTIME, 2269
V2STARTTIME, 2269
V2STOPTIME, 2270
TRIGGER:MAIN:VIDEO:HDTV, 2271
TRIGGER:MAIN:VIDEO:HOLDOFF?, 2271
TRIGGER:MAIN:VIDEO:HOLDOFF:VALUE, 2272
TRIGGER:MAIN:VIDEO:LINE, 2273
TRIGGER:MAIN:VIDEO:LINES, 2274
TRIGGER:MAIN:VIDEO:NTSC, 2274
TRIGGER:MAIN:VIDEO:PAL, 2275
TRIGGER:MAIN:VIDEO:SCAN, 2276
TRIGGER:MAIN:VIDEO:SOURCE, 2276
TRIGGER:MAIN:VIDEO:STANDARD, 2277
TRIGGER:MAIN:VIDEO:SYNC, 2278
TRIGGER:MAIN:VIDEO:SYSTEM, 2278
TRIGGER:MAIN:VIDEO:TIME, 2279
TRIGGER:STATE?, 2280
*TST? query, 2281
U
UNL, C2
Unlisten, C2
UNLOCK, 2282
UNT, C2
Untalk, C2
V
VERBOSE, 2282
Vertical
MATH<x>?, 2162
MATH<x>:DEFINE, 2162
MATH<x>:NUMAVg, 2164
MATH<x>:PROCessing, 2165
Vertical bar cursors, 278
Vertical command group, 231
Vertical commands
CH<x>?, 261
CH<x>:BANDWIDTH, 261
CH<x>:COUPLING, 262
CH<x>:IMPEDANCE, 263
CH<x>:OFFSET, 264
CH<x>:POSITION, 265
CH<x>:PROBE?, 265
CH<x>:SCALE, 266
CH<x>:VOLTS, 266
SELECT?, 2210
SELECT:<wfm>, 2211
SELECT:CONTROL?, 2211
Video trigger, 2261, 2262, 2263, 2264, 2265,
2266, 2267, 2268, 2269, 2270, 2271,
2272, 2273, 2274, 2275, 2276, 2277,
2278, 2279
W
*WAI, 2283
Index11
Index
Wait for operation complete, 2283

Waveform, command mnemonic, 27
Waveform command group, 232
Waveform commands
CURVE, 282
DATA, 284
DATA:DESTINATION, 284
DATA:ENCDG, 285
DATA:SOURCE, 287
DATA:START, 288
DATA:STOP, 288
DATA:TARGET, 289
DATA:WIDTH, 290
WAVFRM?, 2283
WFMPRE?, 2284
WFMPRE:<wfm>?, 2291
WFMPRE:<wfm>:NR_PT, 2292
WFMPRE:<wfm>:PT_FMT, 2293
WFMPRE:<wfm>:PT_OFF, 2294
WFMPRE:<wfm>:WFID, 2294
WFMPRE:<wfm>:XINCR, 2295
WFMPRE:<wfm>:XUNIT, 2295
WFMPRE:<wfm>:YMULT, 2296
WFMPRE:<wfm>:YOFF, 2296
WFMPRE:<wfm>:YUNIT, 2297
WFMPRE:<wfm>:YZERO, 2297
WFMPRE:BIT_NR, 2284
WFMPRE:BN_FMT, 2285
WFMPRE:BYT_NR, 2286
WFMPRE:BYT_OR, 2286
WFMPRE:CRVCHK, 2291
WFMPRE:ENCDG, 2287
WFMPRE:NR_PT, 2291
WFMPRE:PT_FMT, 2288
WFMPRE:PT_OFF, 2289
WFMPRE:WFID, 2291
WFMPRE:XINCR, 2289
WFMPRE:XMULT, 2291
WFMPRE:XOFF, 2291
WFMPRE:XUNIT, 2291
WFMPRE:XZERO, 2291
WFMPRE:YMULT, 2289
WFMPRE:YOFF, 2290
WFMPRE:YUNIT, 2291
WFMPRE:YZERO, 2290
WFMPRE:ZMULT, 2291
WFMPRE:ZOFF, 2291
WFMPRE:ZUNIT, 2291
WFMPRE:ZZERO, 2291
WAVFRM?, 2283
<wfm>, command mnemonic, 27
WFMPRE?, 2284
WFMPRE:<wfm>?, 2291
Index12
WFMPRE:<wfm>:NR_PT, 2292
WFMPRE:<wfm>:PT_FMT, 2293
WFMPRE:<wfm>:PT_OFF, 2294
WFMPRE:<wfm>:WFID, 2294
WFMPRE:<wfm>:XINCR, 2295
WFMPRE:<wfm>:XUNIT, 2295
WFMPRE:<wfm>:YMULT, 2296
WFMPRE:<wfm>:YOFF, 2296
WFMPRE:<wfm>:YUNIT, 2297
WFMPRE:<wfm>:YZERO, 2297
WFMPRE:BIT_NR, 2284
WFMPRE:BN_FMT, 2285
WFMPRE:BYT_NR, 2286
WFMPRE:BYT_OR, 2286
WFMPRE:CRVCHK, 2291
WFMPRE:ENCDG, 2287
WFMPRE:NR_PT, 2291
WFMPRE:PT_FMT, 2288
WFMPRE:PT_OFF, 2289
WFMPRE:WFID, 2291
WFMPRE:XINCR, 2289
WFMPRE:XMULT, 2291
WFMPRE:XOFF, 2291
WFMPRE:XUNIT, 2291
WFMPRE:XZERO, 2291
WFMPRE:YMULT, 2289
WFMPRE:YOFF, 2290
WFMPRE:YUNIT, 2291
WFMPRE:YZERO, 2290
WFMPRE:ZMULT, 2291
WFMPRE:ZOFF, 2291
WFMPRE:ZUNIT, 2291
WFMPRE:ZZERO, 2291
Width trigger, 2245, 2258, 2259, 2260
Z
ZOOM, 2298
Zoom command group, 237
Zoom commands
ZOOM, 2298
ZOOM:DUAL, 2298
ZOOM:DUAL:OFFSET, 2299
ZOOM:GRATICULE, 2300
ZOOM:HORIZONTAL:LOCK, 2300
ZOOM:HORIZONTAL:POSITION, 2301
ZOOM:HORIZONTAL:SCALE, 2302
ZOOM:STATE, 2302
ZOOM:VERTICAL:POSITION, 2303
ZOOM:VERTICAL:SCALE, 2304
ZOOM GRATICULE, 2300
ZOOM:DUAL, 2298
Index
ZOOM:DUAL:OFFSET, 2299
ZOOM:HORIZONTAL:LOCK, 2300
ZOOM:HORIZONTAL:POSITION, 2301
ZOOM:HORIZONTAL:SCALE, 2302
ZOOM:STATE, 2302
ZOOM:VERTICAL:POSITION, 2303
ZOOM:VERTICAL:SCALE, 2304
Index13
Index
Index14

Programming Manual TDS520

Uploaded by

Copyright:

Available Formats

Programming Manual TDS520

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Programming Manual TDS520

Uploaded by

Copyright:

Available Formats

Programmer Manual

TDS Family Digitizing Oscilloscopes

Please check for change information

Syntax and Commands

Status and Events

TDS Family Oscilloscope Programmer Manual

GPIB Function Subsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix D: Factory Initialization Settings . . . . . . . . . . . . . . . . . . . . .

Glossary and Index

TDS Family Oscilloscope Programmer Manual

Figure 21: Command Message Elements . . . . . . . . . . . . . . . . . . . . . .

Figure 31: The Standard Event Status Register (SESR) . . . . . . . . . .

Figure 41: Equipment Needed to Run the Example Programs . . . . .

TDS Family Oscilloscope Programmer Manual

Table 21: BNF Symbols and Meanings . . . . . . . . . . . . . . . . . . . . . . . .

Table 31: SESR Bit Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

TDS Family Oscilloscope Programmer Manual

Table 33: No Event Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table A1: The TDS Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . .

TDS Family Oscilloscope Programmer Manual

TDS Family Oscilloscope Programmer Manual

     

   

TDS Family Oscilloscope Programmer Manual

Table i:Other Documentation(Cont.)

Tek Part Number

   

TDS Family Oscilloscope Programmer Manual

Overview of the Manual summarizes the type of programming information

Setting Up Remote Communications describes how to physically connect

Overview of the Manual

Syntax and Commands

Figure 11: Common Message Elements

TDS Family Oscilloscope Programmer Manual

ACQuire:NUMACq? (Query Only)

Application Menu Commands

ACQuire? (Query Only)

Commands Grouped in Functional Areas

Commands Listed Alphabetically

Figure 12: Functional Groupings and an Alphabetical List of Commands

Status and Events

TDS sends status and event reports.

The Programming Examples section (Section 4) starting on page 41 describes

TDS Family Oscilloscope Programmer Manual

Figure 14: The Disks That Accompany This Manual

Setting Up Remote Communications

Figure 15: GPIB Connector Location

TDS Family Oscilloscope Programmer Manual

If needed, you can stack GPIB connectors as shown in Figure 16.

Figure 16: How to Stack GPIB Connectors

Do not connect more than 15 devices to any one bus.

Connect one device for every 2 meters (6 feet) of cable used.

Connect the devices on the network in a star or linear configuration as shown

TDS Family Oscilloscope Programmer Manual

Figure 17: Typical GPIB Network Configurations

Setting the GPIB

Figure 18: Selecting the I/O System in the Main Menu

TDS Family Oscilloscope Programmer Manual

If you wish to enter a special mode of operation to communicate directly with

TDS Family Oscilloscope Programmer Manual

A channel specifier; is either , , , or .

A math waveform specifier; is , , or .

A reference waveform specifier; is either , , , or .

Can be , or